diff options
Diffstat (limited to 'Master/texmf-dist/doc/eplain')
| -rw-r--r-- | Master/texmf-dist/doc/eplain/ChangeLog | 79 | ||||
| -rw-r--r-- | Master/texmf-dist/doc/eplain/INSTALL | 58 | ||||
| -rw-r--r-- | Master/texmf-dist/doc/eplain/NEWS | 6 | ||||
| -rw-r--r-- | Master/texmf-dist/doc/eplain/README | 22 | ||||
| -rw-r--r-- | Master/texmf-dist/doc/eplain/demo/Makefile | 3 | ||||
| -rw-r--r-- | Master/texmf-dist/doc/eplain/demo/xhyper.tex | 7 | ||||
| -rw-r--r-- | Master/texmf-dist/doc/eplain/eplain.html | 2723 | ||||
| -rw-r--r-- | Master/texmf-dist/doc/eplain/eplain.pdf | bin | 734393 -> 758051 bytes | |||
| -rw-r--r-- | Master/texmf-dist/doc/eplain/lscommnt.jpg | bin | 65795 -> 89453 bytes | |||
| -rw-r--r-- | Master/texmf-dist/doc/eplain/xhyper.jpg | bin | 13812 -> 17721 bytes |
10 files changed, 1343 insertions, 1555 deletions
diff --git a/Master/texmf-dist/doc/eplain/ChangeLog b/Master/texmf-dist/doc/eplain/ChangeLog index 1c91e5b2bfe..ae2413996d3 100644 --- a/Master/texmf-dist/doc/eplain/ChangeLog +++ b/Master/texmf-dist/doc/eplain/ChangeLog @@ -1,3 +1,82 @@ +2022-10-02 Karl Berry <karl@freefriends.org> + + * NEWS, + * Makefile (version): 3.12. + * doc/eplain.texi: 3.12, October 2022. Regenerate. + +2022-10-05 Karl Berry <karl@freefriends.org> + + * xeplain.tex: mailing list is tex-eplain, not bug-eplain. + * README, + * xeplain.tex, + * demo/xrhyper.tex: https not http. + * doc/Makefile (eplain.info, PDF_DEMOS): depend on demo .tex sources. + +2022-10-05 Karl Berry <karl@freefriends.org> + + * xeplain.tex: document bug in double-columns that marks are not + always preserved. See threads: + https://tug.org/pipermail/tex-eplain/2021/001001.html + https://tug.org/pipermail/tex-eplain/2022/001049.html + * doc/userdef.texi: mention mark bug. + + * doc/Makefile (MAKEINFO_HTML): https for TOP_NODE_UP_URL. + +2022-10-03 Karl Berry <karl@freefriends.org> + + * Makefile (fetch, fetch1): new targets. + * texnames.sty: update to current (explicit pd statement). + +2022-10-02 Karl Berry <karl@freefriends.org> + + * doc/*.texi: remove use of @acronym; better to just use capitals. + Also, downcase "url". + +2022-10-02 Karl Berry <karl@freefriends.org> + + * iftex.sty: new file. + * ifpdf.sty: remove. + * util/mkdist-merge: ifpdf.sty -> iftex.sty. + * xeplain.tex: ifpdf.sty -> iftex.sty. + * doc/userdef.texi (Checking for PDF output): now using iftex.sty; + update description. + * Makefile (sources): now iftex.sty. + +2022-10-02 Karl Berry <karl@freefriends.org> + + * README: update urls, mention miniltx and optex. + * doc/userdef.texi (Loading LaTeX packages): mention that + miniltx.tex can usually be used on its own, without Eplain. + + * doc/eplain.texi (Top): remove detailed menu, seems + unnecessary (and Emacs commands for updating aren't working well). + * doc/intro.texi: mention alternatives to Eplain (miniltx, optex). + + * doc/progdef.texi (Scratch registers): new section to describe + standard conventions for register usage. + + * doc/eplain.1, + * doc/install.texi, + * doc/invoke.texi: update to something like current reality. + + * doc/*.texi: use svn $Id$. + * doc/*.texi: use https urls; update urls. + + * doc/texinfo.tex: remove; let's just assume it's available. + + * doc/Makefile (TEXFOT): new definition for quieter TeX runs. + +2022-10-02 Karl Berry <karl@freefriends.org> + + * btxmac.tex (\futurenonspacelet, \@step..., \providecommand): + use \@btxcs instead of \cs, which may be otherwise defined, + e.g., by plain tugboat.sty. Version 0.99q. + +2020-09-19 Karl Berry <karl@freefriends.org> + + * demo/Makefile (ctan_lion_350x350.png): update ctan_lion url. + Report from Van Ly, 19 Sep 2020 15:12:58. + 2020-07-04 Karl Berry <karl@freefriends.org> * README: mailing list is tex-eplain, not bug-eplain diff --git a/Master/texmf-dist/doc/eplain/INSTALL b/Master/texmf-dist/doc/eplain/INSTALL index dcd705281b6..8c726e7c0e9 100644 --- a/Master/texmf-dist/doc/eplain/INSTALL +++ b/Master/texmf-dist/doc/eplain/INSTALL @@ -1,46 +1,38 @@ Installation +Invoking Eplain +Installation +Invoking Eplain +Installation ************ Your TeX installation should already contain a version of Eplain -(`eplain.tex') in its main `texmf' tree (usually under -`/usr/share/texmf/tex/eplain/' on Unix systems). To install a newer -version of Eplain, put the new `eplain.tex' (included in Eplain -distributions) in the `tex/eplain/' subdirectory of your local `texmf' -tree. The newer version you install in the local tree should override -the older one in the main tree. - - The location of the local `texmf' tree obviously depends on your -operating system and TeX installation. On Unix systems the usual -location is `/usr/local/share/texmf/'. If you don't have write -permissions for `/usr/local/share/texmf/', many installations read the -`texmf' tree in the user's home directory; `eplain.tex' then should go -under `~/texmf/tex/eplain/'. For more information about TeX directory -structure, please see -`http://www.tex.ac.uk/cgi-bin/texfaq2html?label=tds'. - - If you prefer to install `eplain.tex' in a non-standard place, set -an environment variable (`TEXINPUTS' for the Web2C port of TeX to Unix) -to tell TeX how to find it. - - If you want, you can also create a format (`.fmt') file for Eplain, -which will eliminate the time spent reading the macro source file with -`\input'. You do this by issuing a sequence of Unix commands something -like this: - - prompt$ touch eplain.aux - prompt$ initex +('eplain.tex') in its main 'texmf' tree; with TeX Live, it's in +'.../texmf-dist/tex/eplain/eplain.tex'. + + Generally, you can just use that version and there is no need to do +anything else. But if you want to use a newer version of Eplain for a +given document, you can put the new 'eplain.tex' in the document's +directory, and it will be found. + + If you want to install a new 'eplain.tex' in some other place, set an +environment variable (commonly, 'TEXINPUTS') to tell TeX how to find it. + + Distributions should also create and maintain the 'eplain.fmt' file +file. But if you want to do it yourself, you can: + + $ touch eplain.aux + $ initex This is TeX, ... **&plain eplain (eplain.tex) *\dump ... MESSAGES ... -You must make sure that `eplain.aux' exists _before_ you run `initex'; +You must make sure that 'eplain.aux' exists _before_ you run 'initex'; otherwise, warning messages about undefined labels will never be issued. - You then have to install the resulting `eplain.fmt' in your local -`texmf' 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 installed -under `/usr/local/share/texmf/web2c/' or `/var/lib/texmf/web2c/'; the -environment variable is `TEXFORMATS'. + You then have to install the resulting 'eplain.fmt' in your local +'texmf' tree or set an environment variable ('TEXFORMATS' to tell TeX +how to find it. You'll need to consult your distribution's documentation +about that. diff --git a/Master/texmf-dist/doc/eplain/NEWS b/Master/texmf-dist/doc/eplain/NEWS index 74813c40a6d..9b144ca60ec 100644 --- a/Master/texmf-dist/doc/eplain/NEWS +++ b/Master/texmf-dist/doc/eplain/NEWS @@ -1,6 +1,10 @@ -$Id: NEWS 50 2020-07-04 16:08:52Z karl $ +$Id: NEWS 61 2022-10-05 22:43:49Z karl $ This file records noteworthy changes. This file is public domain. + 3.12 (5 October 2022) +* btxmac.tex: avoid use of \cs control sequence, conflicts with tugboat.sty. +* iftex.sty: use this instead of the now-obsolete ifpdf.sty. + 3.11 (4 July 2020) * Support YYYY-MM-DD date syntax in \ProvidesPackage. diff --git a/Master/texmf-dist/doc/eplain/README b/Master/texmf-dist/doc/eplain/README index bfff96b2eed..2c5ed6d0669 100644 --- a/Master/texmf-dist/doc/eplain/README +++ b/Master/texmf-dist/doc/eplain/README @@ -1,4 +1,4 @@ -$Id: README 51 2020-07-04 21:01:29Z karl $ +$Id: README 60 2022-10-05 22:42:54Z karl $ (This file is public domain.) This file describes the Eplain (expanded or extended plain, take your @@ -27,9 +27,19 @@ domain. Other pieces are covered by other licenses; see the file headers for specifics. It is entirely free software. Eplain was originally developed for the book TeX for the Impatient, -published by Addison-Wesley in 1990. That book is now freely available, -from http://www.gnu.org/software/teximpatient, along with several -translations. +published by Addison-Wesley in 1990. That book is now freely available, +from https://ctan.org/pkg/impatient, along with several translations. + +Mailing list: https://lists.tug.org/tex-eplain (tex-eplain@tug.org) +The Eplain home page is https://tug.org/eplain. + +P.S. Alternatives to Eplain: +1) If you just want to load the LaTeX color or graphics package, +the LaTeX team's miniltx.tex suffices: + \input miniltx.tex + \input graphicx.tex + +2) If you're interested in a fully-fledged format that shares much of +Eplain's (and plain.tex's) philosophy, check out OpTeX: + https://ctan.org/pkg/optex -Mailing list: http://lists.tug.org/tex-eplain (tex-eplain@tug.org) -The Eplain home page is http://tug.org/eplain. diff --git a/Master/texmf-dist/doc/eplain/demo/Makefile b/Master/texmf-dist/doc/eplain/demo/Makefile index 7a578663f38..dd8a4eaa61d 100644 --- a/Master/texmf-dist/doc/eplain/demo/Makefile +++ b/Master/texmf-dist/doc/eplain/demo/Makefile @@ -1,3 +1,4 @@ +# $Id: Makefile 52 2020-09-19 21:03:24Z karl $ # Makefile for the Eplain demos. This file is public domain. PDFTEX = pdftex @@ -23,7 +24,7 @@ lscommnt.pdf: lscommnt.tex ctan_lion_350x350.png: @echo "Please download" - @echo " ftp://tug.ctan.org/ftpmaint/CTAN_lion/ctan_lion_350x350.png" + @echo " https://www.ctan.org/lion/files/ctan_lion_350x350.png" @echo "and place it in the demo subdirectory." exit 1 diff --git a/Master/texmf-dist/doc/eplain/demo/xhyper.tex b/Master/texmf-dist/doc/eplain/demo/xhyper.tex index 54742cb50b5..6527244fae5 100644 --- a/Master/texmf-dist/doc/eplain/demo/xhyper.tex +++ b/Master/texmf-dist/doc/eplain/demo/xhyper.tex @@ -1,3 +1,4 @@ +% $Id: xhyper.tex 60 2022-10-05 22:42:54Z karl $ % (This file is public domain.) % % This file demonstrates the following features of Eplain: @@ -10,7 +11,7 @@ % % The compiled demo can be downloaded from % -% http://tug.org/eplain/demo +% https://tug.org/eplain/demo % % In order to compile this file yourself, you will need the CTAN lion % drawing by Duane Bibby from @@ -170,7 +171,7 @@ Show me % |url.sty|. Remember that we have customized the color of |url| % hyperlinks, so this one will show up with a different color than the % default dark-red. -Take me to \url{http://tug.org/eplain}. +Take me to \url{https://tug.org/eplain}. % The second approach is to create an explicit URL link. We specify % yet another border highlighting mode, |P|, which means that the @@ -184,7 +185,7 @@ Take me to \url{http://tug.org/eplain}. \definecolor{mycolor}{rgb}{0.4,0.1,0.4} Take me to -\hlstart{url}{hlight=P,colormodel=,color=mycolor}{http://tug.org/eplain} +\hlstart{url}{hlight=P,colormodel=,color=mycolor}{https://tug.org/eplain} Eplain homepage\hlend. \bye diff --git a/Master/texmf-dist/doc/eplain/eplain.html b/Master/texmf-dist/doc/eplain/eplain.html index 15e602336a6..7e7da4278c0 100644 --- a/Master/texmf-dist/doc/eplain/eplain.html +++ b/Master/texmf-dist/doc/eplain/eplain.html @@ -1,7 +1,10 @@ <!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.11, -July 2020. Eplain provides functionality for plain TeX that +<!-- Created by GNU Texinfo 6.8, https://www.gnu.org/software/texinfo/ --> +<head> +<meta http-equiv="Content-Type" content="text/html; charset=utf-8"> +<!-- This manual documents the Eplain macros, version 3.12, +October 2022. Eplain provides functionality for plain TeX that is intended to be useful regardless of how your document is actually formatted. @@ -12,9 +15,6 @@ 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 GNU Texinfo 6.7, 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"> @@ -22,17 +22,20 @@ updates throughout. --> <meta name="resource-type" content="document"> <meta name="distribution" content="global"> <meta name="Generator" content="makeinfo"> +<meta name="viewport" content="width=device-width,initial-scale=1"> + <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"> -<link href="http://tug.org/texinfohtml/" rel="up" title="(dir)"> +<link href="https://tug.org/texinfohtml/" rel="up" title="(dir)"> +<link href="#Introduction" rel="next" title="Introduction"> <style type="text/css"> <!-- +a.copiable-anchor {visibility: hidden; text-decoration: none; line-height: 0em} a.summary-letter {text-decoration: none} blockquote.indentedblock {margin-right: 0em} div.display {margin-left: 3.2em} div.example {margin-left: 3.2em} -div.lisp {margin-left: 3.2em} kbd {font-style: oblique} pre.display {font-family: inherit} pre.format {font-family: inherit} @@ -41,6 +44,7 @@ pre.menu-preformatted {font-family: serif} span.nolinebreak {white-space: nowrap} span.roman {font-family: initial; font-weight: normal} span.sansserif {font-family: sans-serif; font-weight: normal} +span:hover a.copiable-anchor {visibility: visible} ul.no-bullet {list-style: none} --> </style> @@ -58,25 +62,32 @@ ul.no-bullet {list-style: none} -<span id="SEC_Overview"></span> -<h2 class="shortcontents-heading">Short Table of Contents</h2> -<div class="shortcontents"> -<ul class="no-bullet"> -<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" rel="index">Macro index</a></li> -<li><a id="stoc-Concept-index-1" href="#toc-Concept-index-1" rel="index">Concept index</a></li> -</ul> +<div class="top" id="Top"> +<div class="header"> +<p> +Next: <a href="#Introduction" accesskey="n" rel="next">Introduction</a>, Up: <a href="https://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> +<span id="Eplain"></span><h1 class="top">Eplain</h1> + +<p>This manual documents the Eplain macros, version 3.12, +October 2022. Eplain provides functionality for plain TeX that +is intended to be useful regardless of how your document is actually +formatted. +</p> +<p>Most of this manual is in the public domain, like most of the Eplain +code. It was originally written by Karl Berry, starting in 1989. +Steven Smith wrote the documentation for the commutative diagram +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. +</p> +<p>The Eplain home page is <a href="https://tug.org/eplain">https://tug.org/eplain</a>. +</p> + -<span id="SEC_Contents"></span> +<div class="Contents_element" id="SEC_Contents"> <h2 class="contents-heading">Table of Contents</h2> <div class="contents"> @@ -222,7 +233,10 @@ ul.no-bullet {list-style: none} <li><a id="toc-Programming-definitions-1" href="#Programming-definitions">7 Programming definitions</a> <ul class="no-bullet"> <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-Allocation-macros-1" href="#Allocation-macros">7.2 Allocation macros</a> + <ul class="no-bullet"> + <li><a id="toc-Scratch-registers-1" href="#Scratch-registers">7.2.1 Scratch registers</a></li> + </ul></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> @@ -254,376 +268,30 @@ ul.no-bullet {list-style: none} <li><a id="toc-Concept-index-1" href="#Concept-index" rel="index">Concept index</a></li> </ul> </div> - - -<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> -<span id="Eplain"></span><h1 class="top">Eplain</h1> - -<p>This manual documents the Eplain macros, version 3.11, -July 2020. Eplain provides functionality for plain TeX that -is intended to be useful regardless of how your document is actually -formatted. -</p> -<p>Most of this manual is in the public domain, like most of the Eplain -code. It was originally written by Karl Berry, starting in 1989. -Steven Smith wrote the documentation for the commutative diagram -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. -</p> -<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. -</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. -</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. -</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. -</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. -</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. -</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. -</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. -</td></tr> -<tr><td align="left" valign="top">• <a href="#Macro-index" rel="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" rel="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"> - -</pre></th></tr><tr><th colspan="3" align="left" valign="top"><pre class="menu-comment"> — The Detailed Node Listing — - -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. -</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. -</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. -</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. -</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. -</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. -</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. -</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. -</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. -</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. -</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. -</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. -</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. -</td></tr> -<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. -</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. -</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. -</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. -</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. -</td></tr> -<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. -</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. -</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. -</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. -</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. -</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. -</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. -</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"> -</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"> -</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"> -</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"> -</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"> -</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"> -</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"> -</td></tr> -<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. -</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. -</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. -</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. -</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. -</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"> -</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. -</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. -</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. -</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. -</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. -</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"> -</td></tr> -<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"> -</td></tr> -<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"> -</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"> -</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 -</td></tr> -<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 -</td></tr> -<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 -</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 -</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 -</td></tr> -<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 -</td></tr> -<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"> -</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"> -</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"> -</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"> -</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"> -</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"> -</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"> -</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"> -</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"> -</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"> -</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"> -</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"> -</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"> -</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"> -</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"> -</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"> -</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"> -</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"> -</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"> -</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"> -</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"> -</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"> -</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"> -</td></tr> -<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"> -</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"> -</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"> -</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. -</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. -</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. -</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. -</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. -</td></tr> -<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. -</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’. -</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"> -</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. -</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. -</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"> -</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"> -</td></tr> -<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. -</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. -</td></tr> -<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"> -</td></tr> -<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"> -</td></tr> -<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"> -</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"> -</td></tr> -</table> - - +<div class="Overview_element" id="SEC_Overview"> +<h2 class="shortcontents-heading">Short Table of Contents</h2> +<div class="shortcontents"> +<ul class="no-bullet"> +<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" rel="index">Macro index</a></li> +<li><a id="stoc-Concept-index-1" href="#toc-Concept-index-1" rel="index">Concept index</a></li> +</ul> +</div> +</div> <hr> -<span id="Introduction"></span><div class="header"> +<div class="chapter" id="Introduction"> +<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> +Next: <a href="#Installation" accesskey="n" rel="next">Installation</a>, Previous: <a href="#Top" accesskey="p" rel="prev">Eplain</a>, Up: <a href="#Top" accesskey="u" rel="up">Eplain</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="Introduction-1"></span><h2 class="chapter">1 Introduction</h2> @@ -644,7 +312,7 @@ does LaTeX (originally written by Leslie Lamport) <span id="index-Lamport_002c-Leslie"></span> and Texinfo <span id="index-Texinfo"></span> -(Originally written by Richard Stallman). +(originally written by Richard Stallman). <span id="index-Stallman_002c-Richard"></span> <span id="index-rms"></span> Instead, it provides definitions that are intended to be useful @@ -689,18 +357,11 @@ defined as the macro <code>\fmtversion</code> at the end of the source file <samp>eplain.tex</samp>. When corresponding, please refer to it. </p> -<p>To get on this mailing list yourself, email -<a href="mailto:tex-eplain-request@tug.org">tex-eplain-request@tug.org</a> with a message whose body contains -a line -</p> -<div class="example"> -<pre class="example">subscribe <var>you@your.preferred.address</var> -</pre></div> - -<p>or visit <a href="http://lists.tug.org/tex-eplain">http://lists.tug.org/tex-eplain</a>. +<p>To subscribe to this mailing list (anyone can subscribe, and archives +are public), visit <a href="https://lists.tug.org/tex-eplain">https://lists.tug.org/tex-eplain</a>. </p> <span id="index-Walden_002c-David"></span> -<p>David Walden had reported his experience with Eplain as a new user. +<p>David Walden reported his experience with Eplain as a new user. The article is available online at <a href="https://tug.org/pracjourn/2005-4/walden">https://tug.org/pracjourn/2005-4/walden</a>. An introductory article (written for @@ -708,10 +369,30 @@ article (written for <i>TUGboat</i>) is also available online at <a href="https://tug.org/eplain/misc/tb84katsi.pdf">https://tug.org/eplain/misc/tb84katsi.pdf</a>. </p> +<p>Finally, here are two alternatives to Eplain: +</p> +<ol> +<li> If you just want to load the LaTeX color or graphics package, +the LaTeX team’s <samp>miniltx.tex</samp> suffices: + +<div class="example"> +<pre class="example">\input miniltx.tex +\input graphicx.tex +</pre></div> + +</li><li> <span id="index-OpTeX"></span> +If you’re interested in a fully-fledged format that shares much of +Eplain’s (and plain.tex’s) philosophy, check out OpTeX: +<a href="https://ctan.org/pkg/optex">https://ctan.org/pkg/optex</a>. + +</li></ol> + <hr> -<span id="Installation"></span><div class="header"> +</div> +<div class="chapter" id="Installation"> +<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> +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">Eplain</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="Installation-1"></span><h2 class="chapter">2 Installation</h2> @@ -720,38 +401,28 @@ Next: <a href="#Invoking-Eplain" accesskey="n" rel="next">Invoking Eplain</a>, P <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 -newer version of Eplain, put the new <samp>eplain.tex</samp> (included in -Eplain distributions) in the <samp>tex/eplain/</samp> subdirectory of your -local <samp>texmf</samp> tree. The newer version you install in the local -tree should override the older one in the main tree. -</p> -<p>The location of the local <samp>texmf</samp> tree obviously depends on your -operating system and TeX installation. On Unix systems the usual -location is <samp>/usr/local/share/texmf/</samp>. If you don’t have write -permissions for <samp>/usr/local/share/texmf/</samp>, many installations read -the <samp>texmf</samp> tree in the user’s home directory; <samp>eplain.tex</samp> -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>. +(<samp>eplain.tex</samp>) in its main <samp>texmf</samp> tree; with TeX Live, +it’s in <samp>.../texmf-dist/tex/eplain/eplain.tex</samp>. +</p> +<p>Generally, you can just use that version and there is no need to do +anything else. But if you want to use a newer version of Eplain for a +given document, you can put the new <samp>eplain.tex</samp> in the +document’s directory, and it will be found. </p> <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>If you want to install a new <samp>eplain.tex</samp> in some other place, +set an environment variable (commonly, <code>TEXINPUTS</code>) to tell +TeX how to find it. </p> -<p>If you want, you can also create a format (<samp>.fmt</samp>) <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: +<p>Distributions should also create and maintain the <samp>eplain.fmt</samp> +file file. But if you want to do it yourself, you can: </p> <div class="example"> -<pre class="example">prompt$ touch eplain.aux -prompt$ initex +<pre class="example">$ touch eplain.aux +$ initex This is TeX, ... **&plain eplain (eplain.tex) @@ -761,22 +432,22 @@ This is TeX, ... <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>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> <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 -installed under <samp>/usr/local/share/texmf/web2c/</samp> or -<samp>/var/lib/texmf/web2c/</samp>; the environment variable is -<code>TEXFORMATS</code>. +<samp>texmf</samp> tree or set an environment variable (<code>TEXFORMATS</code> to +tell TeX how to find it. You’ll need to consult your +distribution’s documentation about that. </p> <hr> -<span id="Invoking-Eplain"></span><div class="header"> +</div> +<div class="chapter" id="Invoking-Eplain"> +<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> +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">Eplain</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="Invoking-Eplain-1"></span><h2 class="chapter">3 Invoking Eplain</h2> @@ -787,26 +458,25 @@ Next: <a href="#User-definitions" accesskey="n" rel="next">User definitions</a>, <pre class="example">\input eplain </pre></div> -<p>at the beginning of your input file. The macro file is small -enough that reading it does not take an unbearably long time—at least on -contemporary machines. +<p>at the beginning of your (plain TeX) input file. The +macro file is small enough that reading it does not take long. </p> -<p>In addition, if a format (<samp>.fmt</samp>) +<p>However, if a format (<samp>.fmt</samp>) <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 +eliminate even the time spent reading the macro source file. You do this by responding <code>&eplain</code> to TeX’s ‘<samp>**</samp>’ prompt. For example: </p> <div class="example"> -<pre class="example">initex +<pre class="example">$ tex This is TeX, ... **&eplain myfile </pre></div> -<p>Depending on the implementation of TeX which you are using, you might -also be able to invoke TeX as <samp>eplain</samp> and have the format file -automatically read. +<p>In TeX Live and other distributions, a command-line executable +named <samp>eplain</samp> is provided which reads the <samp>eplain.fmt</samp> file +automatically. </p> <p>If you write something which you will be distributing to others, you won’t know if the Eplain format will be loaded already. If it is, then @@ -815,8 +485,8 @@ load it. To solve this, Eplain defines the control sequence <code>\eplain</code> <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: +matter what the definition is, only that the definition exists). +Therefore, you can do the following: </p> <div class="example"> <pre class="example">\ifx\eplain\undefined \input eplain \fi @@ -826,32 +496,32 @@ exists). Therefore, you can do the following: </p> <p>Eplain consists of several source files: </p><dl compact="compact"> -<dt><samp>xeplain.tex</samp></dt> +<dt><span><samp>xeplain.tex</samp></span></dt> <dd><p>most of the macros; </p> </dd> -<dt><samp>arrow.tex</samp></dt> +<dt><span><samp>arrow.tex</samp></span></dt> <dd><p>commutative diagram macros (see <a href="#Arrow-theoretic-diagrams">Arrow theoretic diagrams</a>), written by Steven Smith; </p> </dd> -<dt><samp>btxmac.tex</samp></dt> +<dt><span><samp>btxmac.tex</samp></span></dt> <dd><p>bibliography-related macros (see <a href="#Citations">Citations</a>); </p> </dd> -<dt><samp>ifpdf.sty</samp></dt> -<dd><p>sets the switch <code>\ifpdf</code>, which can be used to detect pdfTeX -in PDF mode (see <a href="#Checking-for-PDF-output">Checking for PDF output</a>), written by Heiko -Oberdiek; +<dt><span><samp>iftex.sty</samp></span></dt> +<dd><p>sets the switch <code>\ifpdf</code> (among other things), which can be used +to detect direct PDF output (see <a href="#Checking-for-PDF-output">Checking for PDF output</a>), +originally written by Heiko Oberdiek; </p> </dd> -<dt><samp>path.sty</samp></dt> +<dt><span><samp>path.sty</samp></span></dt> <dd><p>macro for allowing line breaks at punctuation characters within long pathnames, electronic mail addresses, etc., (see <a href="#Paths">Paths</a>), written by Philip Taylor; </p> </dd> -<dt><samp>texnames.sty</samp></dt> +<dt><span><samp>texnames.sty</samp></span></dt> <dd><p>abbreviations for various TeX-related names (see <a href="#Logos">Logos</a>), edited by Nelson Beebe. </p> @@ -860,7 +530,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> +Eplain source zip archive in your TeX distribution, on CTAN 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, @@ -879,7 +549,7 @@ example, you could start your input file like this: \input eplain </pre></div> -<p>By default, <code>\nobibtex</code> is undefined, and so the +<p>By default, <code>\nobibtex</code> is not defined, and so the bibliography definitions <em>are</em> made. </p> <span id="index-noarrow"></span> @@ -914,26 +584,28 @@ Eplain and before using <code>\ref</code>. <samp>.tex</samp> file in order to produce and typeset indexes, resolve undefined cross-references and/or citations. The shell script <code>texi2dvi</code> from the Texinfo documentation system (see -<a href="http://www.gnu.org/software/texinfo">http://www.gnu.org/software/texinfo</a>) can automate this process: +<a href="https://www.gnu.org/software/texinfo">https://www.gnu.org/software/texinfo</a>) can automate this process: it runs BibTeX, MakeIndex and TeX as many times as needed to complete the compilation process. You will need to set the <code>LATEX</code> environment variable to ‘<samp>tex</samp>’. For example, in a Bourne-compatible shell, the following command will do all the work: </p> <div class="example"> -<pre class="example">prompt$ LATEX=tex texi2dvi file.tex +<pre class="example">$ LATEX=tex texi2dvi file.tex </pre></div> <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>Despite the name, <code>texi2dvi</code> can also produce +<samp>.pdf</samp> output (among other formats); set <code>LATEX=pdftex</code> for +this. See the output from <code>texi2dvi --help</code> for a full list +of options. </p> <hr> -<span id="User-definitions"></span><div class="header"> +</div> +<div class="chapter" id="User-definitions"> +<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> +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">Eplain</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="User-definitions-1"></span><h2 class="chapter">4 User definitions</h2> @@ -941,58 +613,36 @@ Next: <a href="#Hyperlinks" accesskey="n" rel="next">Hyperlinks</a>, Previous: < 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. -</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. -</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. -</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. -</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. -</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. -</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. -</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. -</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. -</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. -</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. -</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. -</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. -</td></tr> -<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. -</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. -</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. -</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. -</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. -</td></tr> -<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. -</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. -</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. -</td></tr> -</table> +<ul class="section-toc"> +<li><a href="#Diagnostics" accesskey="1">Diagnostics</a></li> +<li><a href="#Rules" accesskey="2">Rules</a></li> +<li><a href="#Citations" accesskey="3">Citations</a></li> +<li><a href="#Displays" accesskey="4">Displays</a></li> +<li><a href="#Time-of-day" accesskey="5">Time of day</a></li> +<li><a href="#Lists" accesskey="6">Lists</a></li> +<li><a href="#Verbatim-listing" accesskey="7">Verbatim listing</a></li> +<li><a href="#Contents" accesskey="8">Contents</a></li> +<li><a href="#Cross_002dreferences" accesskey="9">Cross-references</a></li> +<li><a href="#Page-references">Page references</a></li> +<li><a href="#Equation-references">Equation references</a></li> +<li><a href="#Indexing">Indexing</a></li> +<li><a href="#Justification">Justification</a></li> +<li><a href="#Tables">Tables</a></li> +<li><a href="#Margins">Margins</a></li> +<li><a href="#Multiple-columns">Multiple columns</a></li> +<li><a href="#Footnotes">Footnotes</a></li> +<li><a href="#Fractions">Fractions</a></li> +<li><a href="#Paths">Paths</a></li> +<li><a href="#Logos">Logos</a></li> +<li><a href="#Boxes">Boxes</a></li> +<li><a href="#Checking-for-PDF-output">Checking for PDF output</a></li> +<li><a href="#Loading-LaTeX-packages">Loading LaTeX packages</a></li> +</ul> <hr> -<span id="Diagnostics"></span><div class="header"> +<div class="section" id="Diagnostics"> +<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> @@ -1047,7 +697,9 @@ Eplain defines it to be the character <code>^^J</code>. <hr> -<span id="Rules"></span><div class="header"> +</div> +<div class="section" id="Rules"> +<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> @@ -1077,7 +729,9 @@ and <code>\evrule</code>. </p> <hr> -<span id="Citations"></span><div class="header"> +</div> +<div class="section" id="Citations"> +<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> @@ -1150,7 +804,7 @@ which you specify within square brackets, as in LaTeX. This text is simply typeset after the citations. (See the example below.) </p> <p>Eplain can create hypertext links for citations pointing to the relevant -bibliography entries (see <a href="#Citation-hyperlinks">Citation hyperlinks</a>). +bibliography entries (see <a href="#Citation-hyperlinks">Citation hyperlinks: cite, bib</a>). </p> <p>Another command, <code>\nocite</code>, <span id="index-nocite"></span> @@ -1247,18 +901,16 @@ of numbered, the bibliography style is <code>alpha</code>.) <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. -</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. -</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>. -</td></tr> -</table> +<ul class="section-toc"> +<li><a href="#Formatting-citations" accesskey="1">Formatting citations</a></li> +<li><a href="#Formatting-bibliographies" accesskey="2">Formatting bibliographies</a></li> +<li><a href="#Commands-from-LaTeX" accesskey="3">Commands from LaTeX</a></li> +</ul> <hr> -<span id="Formatting-citations"></span><div class="header"> +<div class="subsection" id="Formatting-citations"> +<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> @@ -1274,25 +926,22 @@ 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><span id="index-printcitestart"></span> -<span id="index-printcitefinish"></span> +<dt id='index-printcitestart'><span><code>\printcitestart</code><a href='#index-printcitestart' class='copiable-anchor'> ¶</a></span></dt> +<dt><span><code>\printcitefinish</code></span></dt> +<dd><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><span id="index-printbetweencitations"></span> -<p>If a <code>\cite</code> command has multiple citations, as in +<dt id='index-printbetweencitations'><span><code>\printbetweencitations</code><a href='#index-printbetweencitations' class='copiable-anchor'> ¶</a></span></dt> +<dd><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><span id="index-printcitenote"></span> -<p>This macro takes one argument, which is the optional note to the +<dt id='index-printcitenote'><span><code>\printcitenote</code><a href='#index-printcitenote' class='copiable-anchor'> ¶</a></span></dt> +<dd><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 note is preceded with a comma and a space. @@ -1312,7 +961,9 @@ superscripted labels, with the optional notes in parentheses. <hr> -<span id="Formatting-bibliographies"></span><div class="header"> +</div> +<div class="subsection" id="Formatting-bibliographies"> +<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> @@ -1325,34 +976,30 @@ especially with respect to the fonts that are used. Therefore, Eplain provides the following control sequences: </p> <dl compact="compact"> -<dt><code>\biblabelwidth</code></dt> -<dd><span id="index-biblabelwidth"></span> -<p>This control sequence represents a <code>\dimen</code> register, and its value +<dt id='index-biblabelwidth'><span><code>\biblabelwidth</code><a href='#index-biblabelwidth' class='copiable-anchor'> ¶</a></span></dt> +<dd><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 to use it if you redefine <code>\biblabelprint</code>, below. </p> </dd> -<dt><code>\biblabelprint</code></dt> -<dd><span id="index-biblabelprint"></span> -<p>This macro takes one argument, the label to print. By default, the +<dt id='index-biblabelprint'><span><code>\biblabelprint</code><a href='#index-biblabelprint' class='copiable-anchor'> ¶</a></span></dt> +<dd><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 is the right macro to redefine. </p> </dd> -<dt><code>\biblabelcontents</code></dt> -<dd><span id="index-biblabelcontents"></span> -<p>This macro also takes one argument, the label to print. By default, the +<dt id='index-biblabelcontents'><span><code>\biblabelcontents</code><a href='#index-biblabelcontents' class='copiable-anchor'> ¶</a></span></dt> +<dd><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 the spacing around it, this is the right macro to redefine. </p> </dd> -<dt><code>\biblabelprecontents</code></dt> -<dt><code>\biblabelpostcontents</code></dt> -<dd><span id="index-biblabelprecontents"></span> -<span id="index-biblabelpostcontents"></span> +<dt id='index-biblabelprecontents'><span><code>\biblabelprecontents</code><a href='#index-biblabelprecontents' class='copiable-anchor'> ¶</a></span></dt> +<dt><span><code>\biblabelpostcontents</code></span></dt> +<dd><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): @@ -1363,32 +1010,27 @@ are right-justified by default): </pre></div> </dd> -<dt><code>\bblrm</code></dt> -<dd><span id="index-bblrm"></span> -<span id="index-bibliography-fonts"></span> +<dt id='index-bblrm'><span><code>\bblrm</code><a href='#index-bblrm' class='copiable-anchor'> ¶</a></span></dt> +<dd><span id="index-bibliography-fonts"></span> <p>The default font used for printing the bibliography. </p> </dd> -<dt><code>\bblem</code></dt> -<dd><span id="index-bblem"></span> -<p>The font used for printing the titles and other “emphasized” material. +<dt id='index-bblem'><span><code>\bblem</code><a href='#index-bblem' class='copiable-anchor'> ¶</a></span></dt> +<dd><p>The font used for printing the titles and other “emphasized” material. </p> </dd> -<dt><code>\bblemph</code></dt> -<dd><span id="index-bblemph"></span> -<span id="index-italic-correction"></span> +<dt id='index-bblemph'><span><code>\bblemph</code><a href='#index-bblemph' class='copiable-anchor'> ¶</a></span></dt> +<dd><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><span id="index-bblsc"></span> -<p>In some styles, authors’ names are printed in a caps-and-small-caps +<dt id='index-bblsc'><span><code>\bblsc</code><a href='#index-bblsc' class='copiable-anchor'> ¶</a></span></dt> +<dd><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><span id="index-bblnewblock"></span> -<p>This is invoked between each of the parts of a bibliography entry. The +<dt id='index-bblnewblock'><span><code>\bblnewblock</code><a href='#index-bblnewblock' class='copiable-anchor'> ¶</a></span></dt> +<dd><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 simply a main element of the entry; for example, the author is a part. @@ -1396,17 +1038,15 @@ simply a main element of the entry; for example, the author is a part. concerned) term ‘block’ for this.) </p> </dd> -<dt><code>\biblabelextraspace</code></dt> -<dd><span id="index-biblabelextraspace"></span> -<p>Bibliography entries are typeset with a hanging indentation of +<dt id='index-biblabelextraspace'><span><code>\biblabelextraspace</code><a href='#index-biblabelextraspace' class='copiable-anchor'> ¶</a></span></dt> +<dd><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 this, you should do it inside <code>\bblhook</code>. </p> </dd> -<dt><code>\bblhook</code></dt> -<dd><span id="index-bblhook"></span> -<span id="index-bibliography-items_002c-extra-space-between"></span> +<dt id='index-bblhook'><span><code>\bblhook</code><a href='#index-bblhook' class='copiable-anchor'> ¶</a></span></dt> +<dd><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 @@ -1424,7 +1064,9 @@ file that BibTeX produces to do anything you wish. </p> <hr> -<span id="Commands-from-LaTeX"></span><div class="header"> +</div> +<div class="subsection" id="Commands-from-LaTeX"> +<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> @@ -1441,36 +1083,32 @@ following. In all cases, an existing definition (e.g., from packages</a>) will not be overwritten. Here is the list: </p> <dl compact="compact"> -<dt><code>\newcommand</code></dt> -<dt><code>\renewcommand</code></dt> -<dt><code>\providecommand</code></dt> -<dd><span id="index-newcommand"></span> -<span id="index-renewcommand"></span> +<dt id='index-newcommand'><span><code>\newcommand</code><a href='#index-newcommand' class='copiable-anchor'> ¶</a></span></dt> +<dt><span><code>\renewcommand</code></span></dt> +<dt><span><code>\providecommand</code></span></dt> +<dd><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> </dd> -<dt><code>\em</code></dt> -<dt><code>\emph</code></dt> -<dt><code>\sc</code></dt> -<dt><code>\textbf</code></dt> -<dd><span id="index-em"></span> -<span id="index-emph"></span> +<dt id='index-em'><span><code>\em</code><a href='#index-em' class='copiable-anchor'> ¶</a></span></dt> +<dt><span><code>\emph</code></span></dt> +<dt><span><code>\sc</code></span></dt> +<dt><span><code>\textbf</code></span></dt> +<dd><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><span id="index-mbox"></span> -<p>A horizontal box. +<dt id='index-mbox'><span><code>\mbox</code><a href='#index-mbox' class='copiable-anchor'> ¶</a></span></dt> +<dd><p>A horizontal box. </p> </dd> -<dt><code>\newblock</code></dt> -<dd><span id="index-newblock"></span> -<p>Starts elements of a bibliography entry. +<dt id='index-newblock'><span><code>\newblock</code><a href='#index-newblock' class='copiable-anchor'> ¶</a></span></dt> +<dd><p>Starts elements of a bibliography entry. </p></dd> </dl> @@ -1478,7 +1116,10 @@ support the *-form of these; use <samp>miniltx</samp> for that. </p> <hr> -<span id="Displays"></span><div class="header"> +</div> +</div> +<div class="section" id="Displays"> +<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> @@ -1532,14 +1173,14 @@ up to produce either left-aligned or right-aligned equation numbers. (<code>\leqalignno</code>). Default is <code>\righteqnumbers</code> (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. -</td></tr> -</table> +<ul class="section-toc"> +<li><a href="#Formatting-displays" accesskey="1">Formatting displays</a></li> +</ul> <hr> -<span id="Formatting-displays"></span><div class="header"> +<div class="subsection" id="Formatting-displays"> +<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> @@ -1560,7 +1201,10 @@ the token register <code>\previouseverydisplay</code>. </p> <hr> -<span id="Time-of-day"></span><div class="header"> +</div> +</div> +<div class="section" id="Time-of-day"> +<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> @@ -1596,7 +1240,9 @@ produces the current date, as in ‘23 April 1964’. </p> <hr> -<span id="Lists"></span><div class="header"> +</div> +<div class="section" id="Lists"> +<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> @@ -1613,10 +1259,9 @@ enumerated. Plain TeX defines one macro to help with creating lists, Eplain provides two pairs of commands: </p> <dl compact="compact"> -<dt><code>\numberedlist … \endnumberedlist</code></dt> -<dt><code>\orderedlist … \endorderedlist</code></dt> -<dd><span id="index-numberedlist"></span> -<span id="index-endnumberedlist"></span> +<dt id='index-numberedlist'><span><code>\numberedlist … \endnumberedlist</code><a href='#index-numberedlist' class='copiable-anchor'> ¶</a></span></dt> +<dt><span><code>\orderedlist … \endorderedlist</code></span></dt> +<dd><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 @@ -1626,9 +1271,8 @@ nested <code>\numberedlist</code> labels the items with roman numerals. Yet more deeply nested numbered lists label items with ‘<samp>*</samp>’. </p> </dd> -<dt><code>\unorderedlist … \endunorderedlist</code></dt> -<dd><span id="index-unorderedlist"></span> -<span id="index-endunorderedlist"></span> +<dt id='index-unorderedlist'><span><code>\unorderedlist … \endunorderedlist</code><a href='#index-unorderedlist' class='copiable-anchor'> ¶</a></span></dt> +<dd><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 @@ -1650,7 +1294,7 @@ if the list items are numbered. You can produce the value of the label with <code>\xrefn</code>. See <a href="#Cross_002dreferences">Cross-references</a>. </p> <p>Eplain can create hypertext links for the markers produced by -<code>\xrefn</code> pointing to the relevant list item (see <a href="#List-hyperlinks">List hyperlinks</a>). +<code>\xrefn</code> pointing to the relevant list item (see <a href="#List-hyperlinks">List hyperlinks: li</a>). </p> <p>You can also say <code>\listcompact</code> <span id="index-listcompact"></span> @@ -1670,14 +1314,14 @@ The second paragraph of the second item. \endnumberedlist </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. -</td></tr> -</table> +<ul class="section-toc"> +<li><a href="#Formatting-lists" accesskey="1">Formatting lists</a></li> +</ul> <hr> -<span id="Formatting-lists"></span><div class="header"> +<div class="subsection" id="Formatting-lists"> +<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> @@ -1689,21 +1333,18 @@ Up: <a href="#Lists" accesskey="u" rel="up">Lists</a> [<a href="#SEC_Cont likely that their default values won’t suit your particular layout. </p> <dl compact="compact"> -<dt><code>\abovelistskipamount, \belowlistskipamount</code></dt> -<dd><span id="index-abovelistskipamount"></span> -<span id="index-belowlistskipamount"></span> +<dt id='index-abovelistskipamount'><span><code>\abovelistskipamount, \belowlistskipamount</code><a href='#index-abovelistskipamount' class='copiable-anchor'> ¶</a></span></dt> +<dd><span id="index-belowlistskipamount"></span> <p>The vertical glue inserted before and after every list, respectively. </p> </dd> -<dt><code>\interitemskipamount</code></dt> -<dd><span id="index-interitemskipamount"></span> -<p>The vertical glue inserted before each item except the first. +<dt id='index-interitemskipamount'><span><code>\interitemskipamount</code><a href='#index-interitemskipamount' class='copiable-anchor'> ¶</a></span></dt> +<dd><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><span id="index-listleftindent"></span> -<span id="index-listrightindent"></span> +<dt id='index-listleftindent'><span><code>\listleftindent, \listrightindent</code><a href='#index-listleftindent' class='copiable-anchor'> ¶</a></span></dt> +<dd><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> @@ -1741,15 +1382,13 @@ or <code>\unorderedmarker</code>. The following registers might be useful if you do: </p> <dl compact="compact"> -<dt><code>\numberedlistdepth, \unorderedlistdepth</code></dt> -<dd><span id="index-numberedlistdepth"></span> -<span id="index-unorderedlistdepth"></span> +<dt id='index-numberedlistdepth'><span><code>\numberedlistdepth, \unorderedlistdepth</code><a href='#index-numberedlistdepth' class='copiable-anchor'> ¶</a></span></dt> +<dd><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><span id="index-itemnumber"></span> -<span id="index-itemletter"></span> +<dt id='index-itemnumber'><span><code>\itemnumber, \itemletter</code><a href='#index-itemnumber' class='copiable-anchor'> ¶</a></span></dt> +<dd><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, @@ -1773,7 +1412,10 @@ lists. </p> <hr> -<span id="Verbatim-listing"></span><div class="header"> +</div> +</div> +<div class="section" id="Verbatim-listing"> +<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> @@ -1819,9 +1461,8 @@ consists exclusively of boxes at the top level (i.e., any </p> <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>You can use the form feed control character (ASCII 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>. <span id="index-verbatim"></span> @@ -1887,7 +1528,9 @@ help you (see <a href="#Category-codes">Category codes</a>). </p> <hr> -<span id="Contents"></span><div class="header"> +</div> +<div class="section" id="Contents"> +<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> @@ -1903,22 +1546,19 @@ Eplain uses an auxiliary file with extension <samp>.toc</samp> <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"> -</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"> -</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"> -</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"> -</td></tr> -</table> +<ul class="section-toc"> +<li><a href="#Writing-the-_002etoc-file" accesskey="1">Writing the <tt>.toc</tt> file</a></li> +<li><a href="#Reading-the-_002etoc-file" accesskey="2">Reading the <tt>.toc</tt> file</a></li> +<li><a href="#Changing-the-_002etoc-file_0027s-root-name" accesskey="3">Changing the <tt>.toc</tt> file’s root name</a></li> +<li><a href="#Alternative-contents-files" accesskey="4">Alternative contents files</a></li> +</ul> <hr> -<span id="Writing-the-_002etoc-file"></span><div class="header"> +<div class="subsection" id="Writing-the-_002etoc-file"> +<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> +Next: <a href="#Reading-the-_002etoc-file" accesskey="n" rel="next">Reading the <tt>.toc</tt> 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> <span id="Writing-the-_002etoc-file-1"></span><h4 class="subsection">4.8.1 Writing the <tt>.toc</tt> file</h4> @@ -2012,9 +1652,11 @@ contents. To continue the previous examples: <hr> -<span id="Reading-the-_002etoc-file"></span><div class="header"> +</div> +<div class="subsection" id="Reading-the-_002etoc-file"> +<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> +Next: <a href="#Changing-the-_002etoc-file_0027s-root-name" accesskey="n" rel="next">Changing the <tt>.toc</tt> file’s root name</a>, Previous: <a href="#Writing-the-_002etoc-file" accesskey="p" rel="prev">Writing the <tt>.toc</tt> 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> <span id="Reading-the-_002etoc-file-1"></span><h4 class="subsection">4.8.2 Reading the <tt>.toc</tt> file</h4> @@ -2048,9 +1690,11 @@ manuscript, you can set <code>\rewritetocfilefalse</code>. </p> <hr> -<span id="Changing-the-_002etoc-file_0027s-root-name"></span><div class="header"> +</div> +<div class="subsection" id="Changing-the-_002etoc-file_0027s-root-name"> +<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> +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 <tt>.toc</tt> 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> <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> @@ -2075,9 +1719,11 @@ files from a single TeX job, use <code>\definecontentsfile</code> </p> <hr> -<span id="Alternative-contents-files"></span><div class="header"> +</div> +<div class="subsection" id="Alternative-contents-files"> +<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> +Previous: <a href="#Changing-the-_002etoc-file_0027s-root-name" accesskey="p" rel="prev">Changing the <tt>.toc</tt> 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> <span id="Alternative-contents-files-1"></span><h4 class="subsection">4.8.4 Alternative contents files</h4> @@ -2099,7 +1745,10 @@ the control sequence names. <hr> -<span id="Cross_002dreferences"></span><div class="header"> +</div> +</div> +<div class="section" id="Cross_002dreferences"> +<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> @@ -2133,18 +1782,17 @@ codes of plain TeX), but ‘<samp>%#\{</samp>’ has no valid characters and list items. See <a href="#Citations">Citations</a>, and <a href="#Lists">Lists</a>. </p> <p>Eplain can create hypertext links for the cross-references -(see <a href="#Cross_002dreference-hyperlinks">Cross-reference hyperlinks</a>). +(see <a href="#Cross_002dreference-hyperlinks">Cross-reference hyperlinks: definexref, ref</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"> -</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"> -</td></tr> -</table> +<ul class="section-toc"> +<li><a href="#Defining-generic-references" accesskey="1">Defining generic references</a></li> +<li><a href="#Using-generic-references" accesskey="2">Using generic references</a></li> +</ul> <hr> -<span id="Defining-generic-references"></span><div class="header"> +<div class="subsection" id="Defining-generic-references"> +<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> @@ -2177,7 +1825,9 @@ commands. See the next section. </p> <hr> -<span id="Using-generic-references"></span><div class="header"> +</div> +<div class="subsection" id="Using-generic-references"> +<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> @@ -2194,10 +1844,10 @@ the previous section), Eplain provides the following macros: <dd> <span id="index-refn"></span> </dd> -<dt><code>\refn{<var>label</var>}</code></dt> +<dt><span><code>\refn{<var>label</var>}</code></span></dt> <dd><span id="index-xrefn"></span> </dd> -<dt><code>\xrefn{<var>label</var>}</code></dt> +<dt><span><code>\xrefn{<var>label</var>}</code></span></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 @@ -2206,7 +1856,7 @@ warning isn’t given if <code>\xrefwarningfalse</code>.) </p> <span id="index-ref"></span> </dd> -<dt><code>\ref{<var>label</var>}</code></dt> +<dt><span><code>\ref{<var>label</var>}</code></span></dt> <dd><p>Given the class <var>c</var> for <var>label</var> (see the description of <code>\definexref</code> in the previous section), expand the control sequence <code>\<var>c</var> word</code> (if it’s defined) followed by a tie. Then call @@ -2214,7 +1864,7 @@ warning isn’t given if <code>\xrefwarningfalse</code>.) </p> <span id="index-refs"></span> </dd> -<dt><code>\refs{<var>label</var>}</code></dt> +<dt><span><code>\refs{<var>label</var>}</code></span></dt> <dd><p>Like <code>\ref</code>, but append the letter ‘<samp>s</samp>’ to the <code>\…word</code>. </p> @@ -2238,7 +1888,10 @@ See \refs{sec-intro} and \refn{sec-next} … </p> <hr> -<span id="Page-references"></span><div class="header"> +</div> +</div> +<div class="section" id="Page-references"> +<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> @@ -2248,15 +1901,13 @@ Next: <a href="#Equation-references" accesskey="n" rel="next">Equation reference one for definition and one for use. </p> <dl compact="compact"> -<dt><code>\xrdef{<var>label</var>}</code></dt> -<dd><span id="index-xrdef"></span> -<p>Define <var>label</var> to be the current page number. This produces no +<dt id='index-xrdef'><span><code>\xrdef{<var>label</var>}</code><a href='#index-xrdef' class='copiable-anchor'> ¶</a></span></dt> +<dd><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><span id="index-xref"></span> -<p>Produce the text ‘p. <var>pageno</var>’, which is the usual form for +<dt id='index-xref'><span><code>\xref{<var>label</var>}</code><a href='#index-xref' class='copiable-anchor'> ¶</a></span></dt> +<dd><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>. @@ -2266,11 +1917,13 @@ Its default definition is <code>p.\thinspace</code>. </dd> </dl> -<p>Eplain can create hypertext links for the page references (see <a href="#Page-reference-hyperlinks">Page reference hyperlinks</a>). +<p>Eplain can create hypertext links for the page references (see <a href="#Page-reference-hyperlinks">Page reference hyperlinks: xrdef, xref</a>). </p> <hr> -<span id="Equation-references"></span><div class="header"> +</div> +<div class="section" id="Equation-references"> +<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> @@ -2288,9 +1941,8 @@ numbered equation. <p>Here are the commands to define equation labels and then refer to them: </p> <dl compact="compact"> -<dt><code>\eqdef{<var>label</var>}</code></dt> -<dd><span id="index-eqdef"></span> -<span id="index-eqnum-1"></span> +<dt id='index-eqdef'><span><code>\eqdef{<var>label</var>}</code><a href='#index-eqdef' class='copiable-anchor'> ¶</a></span></dt> +<dd><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 @@ -2318,9 +1970,8 @@ 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><span id="index-eqdefn"></span> -<span id="index-eqnum-2"></span> +<dt id='index-eqdefn'><span><code>\eqdefn{<var>label</var>}</code><a href='#index-eqdefn' class='copiable-anchor'> ¶</a></span></dt> +<dd><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 @@ -2329,16 +1980,14 @@ unusual) circumstance when you want to define an equation label but not print that label. </p> </dd> -<dt><code>\eqref{<var>label</var>}</code></dt> -<dd><span id="index-eqref"></span> -<p>This produces a formatted reference to <var>label</var>. If <var>label</var> is +<dt id='index-eqref'><span><code>\eqref{<var>label</var>}</code><a href='#index-eqref' class='copiable-anchor'> ¶</a></span></dt> +<dd><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><span id="index-eqrefn"></span> -<p>This produces the cross-reference text for <var>label</var>. That is, it +<dt id='index-eqrefn'><span><code>\eqrefn{<var>label</var>}</code><a href='#index-eqrefn' class='copiable-anchor'> ¶</a></span></dt> +<dd><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> @@ -2349,19 +1998,18 @@ is like <code>\eqref</code>, except it doesn’t call <code>\eqprint</code>. general cross-references. </p> <p>Eplain can create hypertext links for the equation references -(see <a href="#Equation-reference-hyperlinks">Equation reference hyperlinks</a>). +(see <a href="#Equation-reference-hyperlinks">Equation reference hyperlinks: eq</a>). </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"> -</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"> -</td></tr> -</table> +<ul class="section-toc"> +<li><a href="#Formatting-equation-references" accesskey="1">Formatting equation references</a></li> +<li><a href="#Subequation-references" accesskey="2">Subequation references</a></li> +</ul> <hr> -<span id="Formatting-equation-references"></span><div class="header"> +<div class="subsection" id="Formatting-equation-references"> +<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> @@ -2475,7 +2123,9 @@ therefore we first put the argument in a box, thus causing </p> <hr> -<span id="Subequation-references"></span><div class="header"> +</div> +<div class="subsection" id="Subequation-references"> +<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> @@ -2530,13 +2180,16 @@ like. For example, this definition makes the labels print as ‘2a’, } </pre></div> -<p>Sadly, we must define a new count register, <code>\subref</code>, +<p>We must define a new count register, <code>\subref</code>, instead of using the scratch count register <code>\count255</code>, because ‘<samp>#1</samp>’ might include other macro calls which use <code>\count255</code>. </p> <hr> -<span id="Indexing"></span><div class="header"> +</div> +</div> +<div class="section" id="Indexing"> +<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> @@ -2551,7 +2204,7 @@ collection and sorting of terms, because TeX itself has no support for sorting. </p> <p>Eplain can create hypertext links pointing from the index to the index -terms (see <a href="#Index-hyperlinks">Index hyperlinks</a>). +terms (see <a href="#Index-hyperlinks">Index hyperlinks: idx</a>). </p> <span id="index-makeindex-1"></span> <p>Eplain’s indexing commands were designed to work with the program @@ -2626,18 +2279,16 @@ will not write index entries there. This may be useful for draft 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. -</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. -</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. -</td></tr> -</table> +<ul class="section-toc"> +<li><a href="#Indexing-terms" accesskey="1">Indexing terms</a></li> +<li><a href="#Typesetting-an-index" accesskey="2">Typesetting an index</a></li> +<li><a href="#Customizing-indexing" accesskey="3">Customizing indexing</a></li> +</ul> <hr> -<span id="Indexing-terms"></span><div class="header"> +<div class="subsection" id="Indexing-terms"> +<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> @@ -2669,20 +2320,17 @@ makes an index entry that will eventually be typeset (by default) as <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. -</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. -</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"> -</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. -</td></tr> -</table> +<ul class="section-toc"> +<li><a href="#Indexing-commands" accesskey="1">Indexing commands</a></li> +<li><a href="#Modifying-index-entries" accesskey="2">Modifying index entries</a></li> +<li><a href="#Index-entries-with-special-characters" accesskey="3">Index entries with special characters</a></li> +<li><a href="#Proofing-index-terms" accesskey="4">Proofing index terms</a></li> +</ul> <hr> -<span id="Indexing-commands"></span><div class="header"> +<div class="subsubsection" id="Indexing-commands"> +<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> @@ -2789,7 +2437,9 @@ could do: <hr> -<span id="Modifying-index-entries"></span><div class="header"> +</div> +<div class="subsubsection" id="Modifying-index-entries"> +<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> @@ -2813,10 +2463,9 @@ is independent of these. <p>Here are the possibilities: </p> <dl compact="compact"> -<dt><code>begin</code></dt> -<dt><code>end</code></dt> -<dd><span id="index-begin-for-index-entries"></span> -<span id="index-end-for-index-entries"></span> +<dt id='index-begin-for-index-entries'><span><code>begin</code><a href='#index-begin-for-index-entries' class='copiable-anchor'> ¶</a></span></dt> +<dt><span><code>end</code></span></dt> +<dd><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 @@ -2837,9 +2486,8 @@ Example: </pre></div> </dd> -<dt><code>see</code></dt> -<dd><span id="index-see-for-index-entries"></span> -<span id="index-see_002c-and-index-entries"></span> +<dt id='index-see-for-index-entries'><span><code>see</code><a href='#index-see-for-index-entries' class='copiable-anchor'> ¶</a></span></dt> +<dd><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 @@ -2859,9 +2507,8 @@ decided not to index. Example: </pre></div> </dd> -<dt><code>seealso</code></dt> -<dd><span id="index-seealso-for-index-entries"></span> -<p>Similar to <code>see</code> (the previous item), but also allows for normal +<dt id='index-seealso-for-index-entries'><span><code>seealso</code><a href='#index-seealso-for-index-entries' class='copiable-anchor'> ¶</a></span></dt> +<dd><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 page number to the index entry. For example, if you have indexed a @@ -2884,7 +2531,7 @@ took these dichotomous examples from is Laurence Berman’s <cite>The Musical Image</cite>, which I happened to co-design and typeset.) </p> </dd> -<dt><code>pagemarkup=<var>cs</var></code></dt> +<dt><span><code>pagemarkup=<var>cs</var></code></span></dt> <dd><p>This puts <code>\<var>cs</var></code> before the page number in the typeset index, thus allowing you to underline definitive entries, italicize examples, and the like. You do <em>not</em> precede the control sequence <var>cs</var> @@ -2907,7 +2554,9 @@ it is up to you to define the control sequences you want to use. Example: <hr> -<span id="Index-entries-with-special-characters"></span><div class="header"> +</div> +<div class="subsubsection" id="Index-entries-with-special-characters"> +<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> @@ -2980,9 +2629,9 @@ processing the above input. now we’ll describe the exceptions. </p> <p>The following characters are reset to their usual meanings because -they are not useful verbatim: multiple consequent spaces are -converted into a single space; <acronym>ASCII</acronym> tab characters are -treated as spaces; <acronym>ASCII</acronym> return is treated as end-of-line +they are not useful verbatim: multiple consecutive spaces are +converted into a single space; ASCII tab characters are +treated as spaces; ASCII return is treated as end-of-line (this means, among other things, that long terms can be broken across several lines). </p> @@ -3031,7 +2680,9 @@ the subentry with the brackets in it: <hr> -<span id="Proofing-index-terms"></span><div class="header"> +</div> +<div class="subsubsection" id="Proofing-index-terms"> +<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> @@ -3088,7 +2739,10 @@ the appropriate time. </p> <hr> -<span id="Typesetting-an-index"></span><div class="header"> +</div> +</div> +<div class="subsection" id="Typesetting-an-index"> +<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> @@ -3125,8 +2779,8 @@ a group, naturally, since there is a primitive <code>\end</code>). <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 +<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.) @@ -3183,7 +2837,9 @@ entries in the <samp>.ind</samp> file. Eplain makes this equivalent to </p> <hr> -<span id="Customizing-indexing"></span><div class="header"> +</div> +<div class="subsection" id="Customizing-indexing"> +<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> @@ -3210,24 +2866,20 @@ delim_2 "\\afterindexterm " <p>You can also change the keywords Eplain recognizes (see <a href="#Modifying-index-entries">Modifying index entries</a>): </p> <dl compact="compact"> -<dt><code>\idxrangebeginword</code></dt> -<dd><span id="index-idxrangebeginword"></span> -<p>‘begin’ +<dt id='index-idxrangebeginword'><span><code>\idxrangebeginword</code><a href='#index-idxrangebeginword' class='copiable-anchor'> ¶</a></span></dt> +<dd><p>‘begin’ </p> </dd> -<dt><code>\idxrangeendword</code></dt> -<dd><span id="index-idxrangeendword"></span> -<p>‘end’ +<dt id='index-idxrangeendword'><span><code>\idxrangeendword</code><a href='#index-idxrangeendword' class='copiable-anchor'> ¶</a></span></dt> +<dd><p>‘end’ </p> </dd> -<dt><code>\idxseecmdword</code></dt> -<dd><span id="index-idxseecmdword"></span> -<p>‘see’ +<dt id='index-idxseecmdword'><span><code>\idxseecmdword</code><a href='#index-idxseecmdword' class='copiable-anchor'> ¶</a></span></dt> +<dd><p>‘see’ </p> </dd> -<dt><code>\idxseealsocmdword</code></dt> -<dd><span id="index-idxseealsocmdword"></span> -<p>‘seealso’ +<dt id='index-idxseealsocmdword'><span><code>\idxseealsocmdword</code><a href='#index-idxseealsocmdword' class='copiable-anchor'> ¶</a></span></dt> +<dd><p>‘seealso’ </p> </dd> </dl> @@ -3236,24 +2888,20 @@ delim_2 "\\afterindexterm " <samp>.idx</samp> file, in case you’ve changed them in the <code>.ist</code> file: </p> <dl compact="compact"> -<dt><code>\idxsubentryseparator</code></dt> -<dd><span id="index-idxsubentryseparator"></span> -<p>‘<samp>!</samp>’ +<dt id='index-idxsubentryseparator'><span><code>\idxsubentryseparator</code><a href='#index-idxsubentryseparator' class='copiable-anchor'> ¶</a></span></dt> +<dd><p>‘<samp>!</samp>’ </p> </dd> -<dt><code>\idxencapoperator</code></dt> -<dd><span id="index-idxencapoperator"></span> -<p>‘<samp>|</samp>’ +<dt id='index-idxencapoperator'><span><code>\idxencapoperator</code><a href='#index-idxencapoperator' class='copiable-anchor'> ¶</a></span></dt> +<dd><p>‘<samp>|</samp>’ </p> </dd> -<dt><code>\idxbeginrangemark</code></dt> -<dd><span id="index-idxbeginrangemark"></span> -<p>‘<samp>(</samp>’ +<dt id='index-idxbeginrangemark'><span><code>\idxbeginrangemark</code><a href='#index-idxbeginrangemark' class='copiable-anchor'> ¶</a></span></dt> +<dd><p>‘<samp>(</samp>’ </p> </dd> -<dt><code>\idxendrangemark</code></dt> -<dd><span id="index-idxendrangemark"></span> -<p>‘<samp>)</samp>’ +<dt id='index-idxendrangemark'><span><code>\idxendrangemark</code><a href='#index-idxendrangemark' class='copiable-anchor'> ¶</a></span></dt> +<dd><p>‘<samp>)</samp>’ </p> </dd> </dl> @@ -3319,7 +2967,7 @@ file (assuming the name of the <samp>.idx</samp> file is <samp>myfile.idx</samp> and the <samp>trimsee</samp> script is placed in the current directory): </p> <div class="example"> -<pre class="example">prompt$ cat myfile.idx | makeindex | ./trimsee > myfile.ind +<pre class="example">$ cat myfile.idx | makeindex | ./trimsee >myfile.ind </pre></div> <p>By default, <samp>trimsee</samp> uses default page list separators and @@ -3330,28 +2978,28 @@ and <code>\indexseealso</code> commands, it is possible to adjust the following: </p> <dl compact="compact"> -<dt><samp>-i <var>is</var></samp></dt> +<dt><span><samp>-i <var>is</var></samp></span></dt> <dd><p>Use <var>is</var> as a regular expression matching separator before “see …” commands in the input (default: ‘<samp>, \+</samp>’). </p> </dd> -<dt><samp>-o <var>os</var></samp></dt> +<dt><span><samp>-o <var>os</var></samp></span></dt> <dd><p>Use <var>os</var> as a separator to replace <var>is</var> before “see …” commands (default: ‘<samp> </samp>’). </p> </dd> -<dt><samp>-s <var>see</var></samp></dt> +<dt><span><samp>-s <var>see</var></samp></span></dt> <dd><p>Use <var>see</var> as a regular expression matching “see …” commands (default: ‘<samp>\\indexsee</samp>’). </p> </dd> -<dt><samp>-h</samp></dt> -<dt><samp>--help</samp></dt> +<dt><span><samp>-h</samp></span></dt> +<dt><span><samp>--help</samp></span></dt> <dd><p>Print a usage message. </p> </dd> -<dt><samp>-v</samp></dt> -<dt><samp>--version</samp></dt> +<dt><span><samp>-v</samp></span></dt> +<dt><span><samp>--version</samp></span></dt> <dd><p>Print version. </p></dd> </dl> @@ -3361,7 +3009,10 @@ output to the standard output. </p> <hr> -<span id="Justification"></span><div class="header"> +</div> +</div> +<div class="section" id="Justification"> +<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> @@ -3463,7 +3114,9 @@ be necessary. <hr> -<span id="Tables"></span><div class="header"> +</div> +<div class="section" id="Tables"> +<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> @@ -3533,7 +3186,9 @@ Text after the table. </p> <hr> -<span id="Margins"></span><div class="header"> +</div> +<div class="section" id="Margins"> +<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> @@ -3548,12 +3203,11 @@ TeX conceive of the page laid out in this way. Therefore, Eplain provides commands to directly assign and increment the margins. </p> <dl compact="compact"> -<dt><code>\topmargin = <var>dimen</var></code></dt> -<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><span id="index-topmargin"></span> -<span id="index-bottommargin"></span> +<dt id='index-topmargin'><span><code>\topmargin = <var>dimen</var></code><a href='#index-topmargin' class='copiable-anchor'> ¶</a></span></dt> +<dt><span><code>\bottommargin = <var>dimen</var></code></span></dt> +<dt><span><code>\leftmargin = <var>dimen</var></code></span></dt> +<dt><span><code>\rightmargin = <var>dimen</var></code></span></dt> +<dd><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. @@ -3563,12 +3217,11 @@ therefore, commands like <code>\showthe\topmargin</code> will not do what you expect. </p> </dd> -<dt><code>\advancetopmargin by <var>dimen</var></code></dt> -<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><span id="index-advancetopmargin"></span> -<span id="index-advancebottommargin"></span> +<dt id='index-advancetopmargin'><span><code>\advancetopmargin by <var>dimen</var></code><a href='#index-advancetopmargin' class='copiable-anchor'> ¶</a></span></dt> +<dt><span><code>\advancebottommargin by <var>dimen</var></code></span></dt> +<dt><span><code>\advanceleftmargin by <var>dimen</var></code></span></dt> +<dt><span><code>\advancerightmargin by <var>dimen</var></code></span></dt> +<dd><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. @@ -3591,14 +3244,12 @@ help: you must tell it the full width and height of the final output page. It defines two new parameters for this: </p> <dl compact="compact"> -<dt><code>\paperheight</code></dt> -<dd><span id="index-paperheight"></span> -<p>The height of the output page; default is 11truein. +<dt id='index-paperheight'><span><code>\paperheight</code><a href='#index-paperheight' class='copiable-anchor'> ¶</a></span></dt> +<dd><p>The height of the output page; default is 11truein. </p> </dd> -<dt><code>\paperwidth</code></dt> -<dd><span id="index-paperwidth"></span> -<p>The width of the output page; default is 8.5truein. +<dt id='index-paperwidth'><span><code>\paperwidth</code><a href='#index-paperwidth' class='copiable-anchor'> ¶</a></span></dt> +<dd><p>The width of the output page; default is 8.5truein. </p></dd> </dl> @@ -3612,7 +3263,9 @@ reassign to these parameters, as in <hr> -<span id="Multiple-columns"></span><div class="header"> +</div> +<div class="section" id="Multiple-columns"> +<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> @@ -3651,7 +3304,7 @@ merely inserts an unbreakable space of (essentially) size multicolumns, Eplain multiplies <code>\vsize</code> itself by the number of 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. +is output). </p> <span id="index-gutter"></span> <p>The columns are separated by the value of the dimen parameter @@ -3666,6 +3319,14 @@ define <pre class="example">\def\gutterbox{\vbox to \dimen0{\vfil\hbox{\vrule height\dimen0}\vfil}}% </pre></div> +<p>There are known bugs in the multiple-column code such that +<code>\topmark</code> and possibly other marks can have an incorrect value +on the last page of multiple-column material when using +<code>\singlecolumn</code> to balance the columns. Unfortunately this is +quite difficult to fix, and at present (volunteers welcome), it’s +going to remain. A suboptimal workaround is to insert +<code>\columnfill</code> at the appropriate place. +</p> <p>The dimension counter <code>\dimen0</code> contains the height of the column. @@ -3690,7 +3351,9 @@ provision for column-width insertions. </p> <hr> -<span id="Footnotes"></span><div class="header"> +</div> +<div class="section" id="Footnotes"> +<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> @@ -3763,12 +3426,14 @@ rule is 0.4 points high, 2 true inches wide, with 2.6 points below it. by the glue register <code>\skip\footins</code>. The default is a plain TeX <code>\bigskip</code>. </p> -<p>Eplain can create hypertext links for the footnote marks (see <a href="#Footnote-hyperlinks">Footnote hyperlinks</a>). +<p>Eplain can create hypertext links for the footnote marks (see <a href="#Footnote-hyperlinks">Footnote hyperlinks: foot, footback</a>). </p> <hr> -<span id="Fractions"></span><div class="header"> +</div> +<div class="section" id="Fractions"> +<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> @@ -3793,7 +3458,9 @@ delimited macro arguments.) </p> <hr> -<span id="Paths"></span><div class="header"> +</div> +<div class="section" id="Paths"> +<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> @@ -3840,14 +3507,16 @@ character for <code>\path</code>, you can set still be used.) TeX then processes the <code>\path</code> argument about four times more slowly. </p> -<span id="index-URL-for-path_002esty"></span> +<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="https://ctan.org/pkg/path">https://ctan.org/pkg/path</a>. </p> <hr> -<span id="Logos"></span><div class="header"> +</div> +<div class="section" id="Logos"> +<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> @@ -3902,12 +3571,14 @@ here.) Some spelling variants of these are also supported. <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://mirror.ctan.org/info/biblio/texnames.sty">http://mirror.ctan.org/info/biblio/texnames.sty</a> +<a href="https://mirror.ctan.org/info/biblio/texnames.sty">https://mirror.ctan.org/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> -<span id="Boxes"></span><div class="header"> +</div> +<div class="section" id="Boxes"> +<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> @@ -3966,49 +3637,46 @@ easily adjust the thicknesses of the box rules. See <a href="#Rules">Rules</a>. </p> <hr> -<span id="Checking-for-PDF-output"></span><div class="header"> +</div> +<div class="section" id="Checking-for-PDF-output"> +<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> <span id="Checking-for-PDF-output-1"></span><h3 class="section">4.22 Checking for PDF output</h3> -<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="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>You might sometimes want to test whether the target format is +<samp>.pdf</samp> or <samp>.dvi</samp>. The <code>\ifpdf</code> conditional can be used +for this: </p> <div class="example"> <pre class="example">\ifpdf - This text is produced when pdfTeX is in PDF mode. + This text is produced when the engine outputs PDF. \else - This text is produced when pdfTeX is in DVI mode, - or when some program other than pdfTeX is used. + This text is produced when the engine outputs DVI (or similar). \fi </pre></div> -<p>Keep in mind that <code>\ifpdf</code> is set based on the value of the -<code>\pdfoutput</code> -<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>At this writing, <code>\ifpdf</code> will be true when running pdfTeX +or LuaTeX with PDF output. It will be false when running XeTeX, +or (of course) original TeX, etc. </p> -<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="https://ctan.org/pkg/ifpdf">https://ctan.org/pkg/ifpdf</a>. +<span id="index-iftex_002esty"></span> +<span id="index-engines_002c-testing-for"></span> +<p>Eplain defines <code>\ifpdf</code> by incorporating <samp>iftex.sty</samp>, a +package now maintained by the LaTeX Project Team. +<samp>iftex.sty</samp>, and therefore Eplain, defines numerous related +conditionals to test for different engines; see its package +documentation for details: <a href="https://ctan.org/pkg/ifpdf">https://ctan.org/pkg/ifpdf</a>. </p> <hr> -<span id="Loading-LaTeX-packages"></span><div class="header"> +</div> +<div class="section" id="Loading-LaTeX-packages"> +<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> @@ -4036,21 +3704,19 @@ the list, please report it to the Eplain mailing list <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. -</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. -</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. -</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. -</td></tr> -</table> +support for package options; in many cases, you can use +<samp>miniltx.tex</samp> directly without loading Eplain at all. +</p> +<ul class="section-toc"> +<li><a href="#The-_005cusepackage-command" accesskey="1">The <code>\usepackage</code> command</a></li> +<li><a href="#Environment-for-loading-packages" accesskey="2">Environment for loading packages</a></li> +<li><a href="#Packages-known-to-work" accesskey="3">Packages known to work</a></li> +<li><a href="#Packages-known-not-to-work" accesskey="4">Packages known not to work</a></li> +</ul> <hr> -<span id="The-_005cusepackage-command"></span><div class="header"> +<div class="subsection" id="The-_005cusepackage-command"> +<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> @@ -4086,9 +3752,11 @@ packages are dated 2005/08/29 or newer. </p> <hr> -<span id="Environment-for-loading-packages"></span><div class="header"> +</div> +<div class="subsection" id="Environment-for-loading-packages"> +<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> +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 <code>\usepackage</code> 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> <span id="Environment-for-loading-packages-1"></span><h4 class="subsection">4.23.2 Environment for loading packages</h4> @@ -4159,7 +3827,9 @@ to <code>\eplaininput</code> before loading each package. For example: <hr> -<span id="Packages-known-to-work"></span><div class="header"> +</div> +<div class="subsection" id="Packages-known-to-work"> +<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> @@ -4173,9 +3843,8 @@ these packages. Some of the short descriptions of the packages were 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><span id="index-autopict_002esty"></span> -<p><a href="https://tug.org/eplain/misc/ltpictur.pdf">https://tug.org/eplain/misc/ltpictur.pdf</a> +<dt id='index-autopict_002esty'><span>autopict (‘<samp>2001/06/04 v1.1j Picture mode autoload file</samp>’)<a href='#index-autopict_002esty' class='copiable-anchor'> ¶</a></span></dt> +<dd><p><a href="https://tug.org/eplain/misc/ltpictur.pdf">https://tug.org/eplain/misc/ltpictur.pdf</a> </p> <span id="index-picture-mode"></span> <span id="index-begin_007bpicture_007d"></span> @@ -4187,15 +3856,14 @@ the LaTeX kernel). It provides commands to draw simple figures 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> +<dt id='index-graphicx_002esty'><span>color (‘<samp>1999/02/16 v1.0i Standard LaTeX Color (DPC)</samp>’)<a href='#index-graphicx_002esty' class='copiable-anchor'> ¶</a></span></dt> <dd><span id="index-color_002esty"></span> </dd> -<dt>graphics (‘<samp>2001/07/07 v1.0n Standard LaTeX Graphics (DPC,SPQR)</samp>’)</dt> +<dt><span>graphics (‘<samp>2001/07/07 v1.0n Standard LaTeX Graphics (DPC,SPQR)</samp>’)</span></dt> <dd><span id="index-graphics_002esty"></span> </dd> -<dt>graphicx (‘<samp>1999/02/16 v1.0f Enhanced LaTeX Graphics (DPC,SPQR)</samp>’)</dt> -<dd><span id="index-graphicx_002esty"></span> -<p><a href="https://ctan.org/pkg/graphics">https://ctan.org/pkg/graphics</a> +<dt><span>graphicx (‘<samp>1999/02/16 v1.0f Enhanced LaTeX Graphics (DPC,SPQR)</samp>’)</span></dt> +<dd><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> @@ -4222,7 +3890,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://mirror.ctan.org/macros/pdftex/graphics">http://mirror.ctan.org/macros/pdftex/graphics</a>. +<a href="https://mirror.ctan.org/macros/pdftex/graphics">https://mirror.ctan.org/macros/pdftex/graphics</a>. To convince TeX to use the new files, you have the following options: </p> @@ -4233,8 +3901,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 <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>); +TeX directory structure, see <a href="https://tug.org/tds/">https://tug.org/tds/</a>); </li><li> upgrade your ConTeXt installation. </li></ol> @@ -4252,7 +3919,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://ctan.org/pkg/pdftex-def">http://ctan.org/pkg/pdftex-def</a>.<br> +<a href="https://ctan.org/pkg/graphics-def">https://ctan.org/pkg/graphics-def</a>.<br> <strong>End of warning 2.</strong> </p> <p>The <code>\fcolorbox</code> macro provided by the <code>color</code> package @@ -4288,7 +3955,7 @@ equivalent to plain TeX’s <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 +<p>See <a href="#Hyperlinks-_0028xhyper_002etex_0029">Hyperlinks (<code>xhyper.tex</code>)</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> @@ -4300,9 +3967,8 @@ packages and different graphics formats. You can download it from </pre></div> </dd> -<dt>epstopdf (‘<samp>2009/07/16 v2.2 Conversion with epstopdf on the fly (HO)</samp>’)</dt> -<dd><span id="index-epstopdf_002esty"></span> -<p><a href="https://ctan.org/pkg/epstopdf-pkg">https://ctan.org/pkg/epstopdf-pkg</a> +<dt id='index-epstopdf_002esty'><span>epstopdf (‘<samp>2009/07/16 v2.2 Conversion with epstopdf on the fly (HO)</samp>’)<a href='#index-epstopdf_002esty' class='copiable-anchor'> ¶</a></span></dt> +<dd><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> @@ -4312,21 +3978,20 @@ packages and different graphics formats. You can download it from <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>) +(EPS) graphics into Portable Document Format (PDF) graphics for inclusion with the <code>\includegraphics</code> command from the <samp>graphics</samp>/<samp>graphicx</samp> packages, so that you do not have to explicitly call the <samp>epstopdf</samp> script. </p> </dd> -<dt>psfrag (‘<samp>1998/04/11 v3.04 PSfrag (MCG)</samp>’)</dt> -<dd><span id="index-psfrag_002esty"></span> -<p><a href="https://ctan.org/pkg/psfrag">https://ctan.org/pkg/psfrag</a> +<dt id='index-psfrag_002esty'><span>psfrag (‘<samp>1998/04/11 v3.04 PSfrag (MCG)</samp>’)<a href='#index-psfrag_002esty' class='copiable-anchor'> ¶</a></span></dt> +<dd><p><a href="https://ctan.org/pkg/psfrag">https://ctan.org/pkg/psfrag</a> </p> <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 +(EPS) files with arbitrary (La)TeX constructions. In order to accomplish this, the user places a simple text “tag” in the graphics file, as a “position marker” of sorts. Then, using simple (La)TeX commands, the user instructs PSfrag to remove that tag from @@ -4334,9 +3999,8 @@ the figure, and replace it with a properly sized, aligned, and rotated (La)TeX equation. </p> </dd> -<dt>soul (‘<samp>2003/11/17 v2.4 letterspacing/underlining (mf)</samp>’)</dt> -<dd><span id="index-soul_002esty"></span> -<p><a href="https://ctan.org/pkg/soul">https://ctan.org/pkg/soul</a> +<dt id='index-soul_002esty'><span>soul (‘<samp>2003/11/17 v2.4 letterspacing/underlining (mf)</samp>’)<a href='#index-soul_002esty' class='copiable-anchor'> ¶</a></span></dt> +<dd><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> @@ -4352,9 +4016,8 @@ soul.sty</code>. If you intend to use the highlighting macros of <samp>soul</samp>, don’t forget to load the <samp>color</samp> package. </p> </dd> -<dt>url (‘<samp>2005/06/27 ver 3.2 Verb mode for urls, etc.</samp>’)</dt> -<dd><span id="index-url_002esty"></span> -<p><a href="https://ctan.org/pkg/url">https://ctan.org/pkg/url</a> +<dt id='index-url_002esty'><span>url (‘<samp>2005/06/27 ver 3.2 Verb mode for urls, etc.</samp>’)<a href='#index-url_002esty' class='copiable-anchor'> ¶</a></span></dt> +<dd><p><a href="https://ctan.org/pkg/url">https://ctan.org/pkg/url</a> </p> <span id="index-pathnames_002c-breaking-1"></span> <span id="index-filenames_002c-breaking-1"></span> @@ -4366,7 +4029,7 @@ another command. It is intended for email addresses, hypertext links, directories/paths, etc., which normally have no spaces. </p> <p>Eplain can create hypertext links with the <code>\url</code> command -(see <a href="#URL-hyperlinks">URL hyperlinks</a>). +(see <a href="#URL-hyperlinks">URL hyperlinks: url</a>). </p> <p>Be sure to get a version dated at least 2005/06/27, as older versions have problems in plain TeX. @@ -4375,7 +4038,9 @@ have problems in plain TeX. <hr> -<span id="Packages-known-not-to-work"></span><div class="header"> +</div> +<div class="subsection" id="Packages-known-not-to-work"> +<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> @@ -4386,35 +4051,35 @@ Previous: <a href="#Packages-known-to-work" accesskey="p" rel="prev">Packages kn <p>The following packages are known not to work with Eplain: </p> <dl compact="compact"> -<dt>hyperref</dt> -<dd><span id="index-hyperref_002esty"></span> -<p><a href="https://ctan.org/pkg/hyperref">https://ctan.org/pkg/hyperref</a> +<dt id='index-hyperref_002esty'><span>hyperref<a href='#index-hyperref_002esty' class='copiable-anchor'> ¶</a></span></dt> +<dd><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 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><span id="index-microtype_002esty"></span> -<p><a href="https://ctan.org/pkg/microtype">https://ctan.org/pkg/microtype</a> +<dt id='index-microtype_002esty'><span>microtype (‘<samp>2013/05/23 v2.51 Micro-typographical refinements (RS)</samp>’)<a href='#index-microtype_002esty' class='copiable-anchor'> ¶</a></span></dt> +<dd><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><span id="index-pict2e_002esty"></span> -<p><a href="https://ctan.org/pkg/pict2e">https://ctan.org/pkg/pict2e</a> +<dt id='index-pict2e_002esty'><span>pict2e (‘<samp>2005/07/15 v0.2r Improved picture commands (HjG,RN)</samp>’)<a href='#index-pict2e_002esty' class='copiable-anchor'> ¶</a></span></dt> +<dd><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><span id="index-xcolor_002esty"></span> -<p><a href="https://ctan.org/pkg/xcolor">https://ctan.org/pkg/xcolor</a> +<dt id='index-xcolor_002esty'><span>xcolor (‘<samp>2005/06/06 v2.03 LaTeX color extensions (UK)</samp>’)<a href='#index-xcolor_002esty' class='copiable-anchor'> ¶</a></span></dt> +<dd><p><a href="https://ctan.org/pkg/xcolor">https://ctan.org/pkg/xcolor</a> </p></dd> </dl> <hr> -<span id="Hyperlinks"></span><div class="header"> +</div> +</div> +</div> +<div class="chapter" id="Hyperlinks"> +<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> +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">Eplain</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="Hyperlinks-1"></span><h2 class="chapter">5 Hyperlinks</h2> @@ -4426,26 +4091,20 @@ implicitly by the cross-reference, indexing and other macros in 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"> -</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"> -</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"> -</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"> -</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"> -</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"> -</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> +<ul class="section-toc"> +<li><a href="#Introduction-to-hyperlinks" accesskey="1">Introduction to hyperlinks</a></li> +<li><a href="#Explicit-hyperlinks" accesskey="2">Explicit hyperlinks</a></li> +<li><a href="#Implicit-hyperlinks" accesskey="3">Implicit hyperlinks</a></li> +<li><a href="#Hyperlink-drivers" accesskey="4">Hyperlink drivers</a></li> +<li><a href="#Setting-hyperlink-types-and-options" accesskey="5">Setting hyperlink types and options</a></li> +<li><a href="#Turning-hyperlinks-on_002foff" accesskey="6">Turning hyperlinks on/off</a></li> +<li><a href="#Making-PDF-outlines" accesskey="7">Making PDF outlines</a></li> +</ul> <hr> -<span id="Introduction-to-hyperlinks"></span><div class="header"> +<div class="section" id="Introduction-to-hyperlinks"> +<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> @@ -4486,10 +4145,10 @@ the set of commands it understands. <p>The knowledge about the commands that the various processors understand is programmed into Eplain’s hyperlink drivers. Eplain provides three drivers: <code>hypertex</code> (implementation of the -HyperTeX standard, see <a href="http://arxiv.org/hypertex">http://arxiv.org/hypertex</a>), and +HyperTeX standard, see <a href="https://arxiv.org/hypertex">https://arxiv.org/hypertex</a>), and <code>pdftex</code> and <code>dvipdfm</code> (named after the programs which process the hyperlink commands, -<span id="index-pdftex-2"></span> +<span id="index-pdftex-1"></span> pdfTeX and <span id="index-dvipdfm"></span> dvipdfm). Therefore, Eplain can only produce HyperTeX commands and @@ -4509,9 +4168,9 @@ are using, use the command </pre></div> <p>instructs Eplain to attempt to automatically detect which -driver to use, as follows: if it detects pdfTeX in <acronym>PDF</acronym> +driver to use, as follows: if it detects pdfTeX in PDF 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. +pdfTeX in PDF mode, the <code>hypertex</code> driver is loaded. The detection is based on the <span id="index-ifpdf-1"></span> <code>\ifpdf</code> switch (see <a href="#Checking-for-PDF-output">Checking for PDF output</a>). @@ -4571,7 +4230,7 @@ displayed. <code>pdftex</code> driver, the usual link type used to refer to destinations in the current document is called ‘<samp>name</samp>’. You can 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>filename</samp>’ link type) or to a url (by using the ‘<samp>url</samp>’ link type). </p> <span id="index-link-options"></span> @@ -4588,7 +4247,9 @@ options supported by the drivers. See <a href="#Setting-hyperlink-types-and-opt </p> <hr> -<span id="Explicit-hyperlinks"></span><div class="header"> +</div> +<div class="section" id="Explicit-hyperlinks"> +<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> @@ -4645,7 +4306,7 @@ see <a href="#Setting-default-types-and-options">Setting default types and optio <p>The <var>label</var> argument of both <code>\hldest</code> and <code>\hlstart</code> can contain special characters (such as ‘<samp>#</samp>’, ‘<samp>%</samp>’, ‘<samp>&</samp>’, ‘<samp>~</samp>’, etc.) without any escaping. This is especially important -for <acronym>URL</acronym> links supported by some drivers (see <a href="#Hyperlink-drivers">Hyperlink drivers</a>). +for url links supported by some drivers (see <a href="#Hyperlink-drivers">Hyperlink drivers</a>). </p> <p>Both <code>\hldest</code> and <code>\hlstart</code> ignore following spaces. </p> @@ -4660,12 +4321,14 @@ pass it for the <var>options</var>. For example: <p>is functionally equivalent to the previous example. </p> -<p>See <a href="#Hyperlinks-_0028xhyper_002etex_0029">Hyperlinks (xhyper.tex)</a>, for a demonstration of the usage of +<p>See <a href="#Hyperlinks-_0028xhyper_002etex_0029">Hyperlinks (<code>xhyper.tex</code>)</a>, for a demonstration of the usage of explicit hyperlinks. </p> <hr> -<span id="Implicit-hyperlinks"></span><div class="header"> +</div> +<div class="section" id="Implicit-hyperlinks"> +<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> @@ -4708,40 +4371,31 @@ set parameters for a group. <pre class="display">bib, li, definexref, xrdef, eq, idx, foot, footback. </pre></div> -<p>See <a href="#Hyperlinks-_0028xhyper_002etex_0029">Hyperlinks (xhyper.tex)</a>, for a demonstration of the usage of +<p>See <a href="#Hyperlinks-_0028xhyper_002etex_0029">Hyperlinks (<code>xhyper.tex</code>)</a>, for a demonstration of the usage of implicit hyperlinks. </p> <p>The following subsections describe each of the linkgroups and destgroups 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 -</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 -</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 -</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 -</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 -</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 -</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 -</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 -</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 -</td></tr> -<tr><td align="left" valign="top">• <a href="#Contents-hyperlinks">Contents hyperlinks</a></td><td> </td><td align="left" valign="top"> -</td></tr> -</table> +<ul class="section-toc"> +<li><a href="#General-hyperlinks" accesskey="1">General hyperlinks: hrefint, hrefext</a></li> +<li><a href="#URL-hyperlinks" accesskey="2">URL hyperlinks: url</a></li> +<li><a href="#Citation-hyperlinks" accesskey="3">Citation hyperlinks: cite, bib</a></li> +<li><a href="#List-hyperlinks" accesskey="4">List hyperlinks: li</a></li> +<li><a href="#Cross_002dreference-hyperlinks" accesskey="5">Cross-reference hyperlinks: definexref, ref</a></li> +<li><a href="#Page-reference-hyperlinks" accesskey="6">Page reference hyperlinks: xrdef, xref</a></li> +<li><a href="#Equation-reference-hyperlinks" accesskey="7">Equation reference hyperlinks: eq</a></li> +<li><a href="#Index-hyperlinks" accesskey="8">Index hyperlinks: idx</a></li> +<li><a href="#Footnote-hyperlinks" accesskey="9">Footnote hyperlinks: foot, footback</a></li> +<li><a href="#Contents-hyperlinks">Contents hyperlinks</a></li> +</ul> <hr> -<span id="General-hyperlinks"></span><div class="header"> +<div class="subsection" id="General-hyperlinks"> +<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> +Next: <a href="#URL-hyperlinks" accesskey="n" rel="next">URL hyperlinks: url</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> <span id="General-hyperlinks_003a-hrefint_002c-hrefext"></span><h4 class="subsection">5.3.1 General hyperlinks: hrefint, hrefext</h4> @@ -4765,15 +4419,15 @@ 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> -<span id="index-URL-hyperlink"></span> -<span id="index-hyperlinks_002c-URL"></span> +<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 +url link. Parameters for these links can be set by customizing the <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: +‘<samp>~</samp>’) in the url don’t need to be escaped. For example: </p> <div class="example"> <pre class="example">\href{https://tug.org/eplain/doc/eplain.html#Hyperlinks}{Hyperlinks @@ -4781,8 +4435,8 @@ customizing the \href{mailto:tex-eplain@tug.org}{Eplain mailing list} </pre></div> -<p>See <a href="#URL-hyperlinks">URL hyperlinks</a>, for another way to create -<acronym>URL</acronym> hyperlinks. +<p>See <a href="#URL-hyperlinks">URL hyperlinks: url</a>, for another way to create +url hyperlinks. </p> <p>The <var>text</var> argument of <code>\href</code> can contain verbatim text (see <a href="#Verbatim-listing">Verbatim listing</a>) or other macros which manipulate character @@ -4800,14 +4454,16 @@ catcodes. For example: </p> <hr> -<span id="URL-hyperlinks"></span><div class="header"> +</div> +<div class="subsection" id="URL-hyperlinks"> +<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> +Next: <a href="#Citation-hyperlinks" accesskey="n" rel="next">Citation hyperlinks: cite, bib</a>, Previous: <a href="#General-hyperlinks" accesskey="p" rel="prev">General hyperlinks: hrefint, hrefext</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> <span id="URL-hyperlinks_003a-url"></span><h4 class="subsection">5.3.2 URL hyperlinks: url</h4> -<span id="index-URL-hyperlink-1"></span> -<span id="index-hyperlinks_002c-URL-1"></span> +<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 @@ -4818,10 +4474,10 @@ Next: <a href="#Citation-hyperlinks" accesskey="n" rel="next">Citation hyperlink <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. ‘<samp>url</samp>’ links use the parameter to the <code>\url</code> command as the -<acronym>URL</acronym> to point to. +url to point to. </p> <p>You may be using the <code>\url</code> command to typeset something other than -a <acronym>URL</acronym>, e.g., a path, for which you do not want a link to be +a url, 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> @@ -4830,7 +4486,7 @@ command <code>\hloff[url]</code> (see <a href="#Turning-hyperlinks-on_002foff-fo <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 +<p>By default, url (and other types of) links are boxed, so that they are visually marked even if you do not load the LaTeX <span id="index-color_002esty-1"></span> ‘color’ package (see <a href="#Loading-LaTeX-packages">Loading LaTeX packages</a>) and therefore link text @@ -4846,7 +4502,7 @@ work in plain TeX; see <a href="#Packages-known-to-work">Packages known to \enablehyperlinks -\url{http://foo/bar} +\url{https://foo/bar} \url{mailto:foobar@example.org} @@ -4867,7 +4523,7 @@ border around them. Try this: \enablehyperlinks \hlopts{bwidth=0} -\url{http://foo/bar} +\url{https://foo/bar} \url{mailto:foobar@example.org} @@ -4877,14 +4533,16 @@ border around them. Try this: <p>The command <code>\hlopts{bwidth=0}</code> sets border width to zero as the default for all links, and loading the <samp>color</samp> package automatically colors links using the default color (see <a href="#Options-supported-by-all-drivers">Options supported by all drivers</a>). If you want the border width setting to -apply to <acronym>URL</acronym> links only, say <code>\hlopts[url]{bwidth=0}</code> +apply to url links only, say <code>\hlopts[url]{bwidth=0}</code> (see <a href="#Setting-hyperlink-types-and-options">Setting hyperlink types and options</a>). </p> <hr> -<span id="Citation-hyperlinks"></span><div class="header"> +</div> +<div class="subsection" id="Citation-hyperlinks"> +<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> +Next: <a href="#List-hyperlinks" accesskey="n" rel="next">List hyperlinks: li</a>, Previous: <a href="#URL-hyperlinks" accesskey="p" rel="prev">URL hyperlinks: url</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> <span id="Citation-hyperlinks_003a-cite_002c-bib"></span><h4 class="subsection">5.3.3 Citation hyperlinks: cite, bib</h4> @@ -4912,9 +4570,11 @@ entries. For each of the entries, a destination is defined. </p> <hr> -<span id="List-hyperlinks"></span><div class="header"> +</div> +<div class="subsection" id="List-hyperlinks"> +<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> +Next: <a href="#Cross_002dreference-hyperlinks" accesskey="n" rel="next">Cross-reference hyperlinks: definexref, ref</a>, Previous: <a href="#Citation-hyperlinks" accesskey="p" rel="prev">Citation hyperlinks: cite, bib</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> <span id="List-hyperlinks_003a-li"></span><h4 class="subsection">5.3.4 List hyperlinks: li</h4> @@ -4930,9 +4590,11 @@ label. </p> <hr> -<span id="Cross_002dreference-hyperlinks"></span><div class="header"> +</div> +<div class="subsection" id="Cross_002dreference-hyperlinks"> +<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> +Next: <a href="#Page-reference-hyperlinks" accesskey="n" rel="next">Page reference hyperlinks: xrdef, xref</a>, Previous: <a href="#List-hyperlinks" accesskey="p" rel="prev">List hyperlinks: li</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> <span id="Cross_002dreference-hyperlinks_003a-definexref_002c-ref"></span><h4 class="subsection">5.3.5 Cross-reference hyperlinks: definexref, ref</h4> @@ -4978,9 +4640,11 @@ its intended use. </p> <hr> -<span id="Page-reference-hyperlinks"></span><div class="header"> +</div> +<div class="subsection" id="Page-reference-hyperlinks"> +<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> +Next: <a href="#Equation-reference-hyperlinks" accesskey="n" rel="next">Equation reference hyperlinks: eq</a>, Previous: <a href="#Cross_002dreference-hyperlinks" accesskey="p" rel="prev">Cross-reference hyperlinks: definexref, ref</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> <span id="Page-reference-hyperlinks_003a-xrdef_002c-xref"></span><h4 class="subsection">5.3.6 Page reference hyperlinks: xrdef, xref</h4> @@ -5005,9 +4669,11 @@ label. </p> <hr> -<span id="Equation-reference-hyperlinks"></span><div class="header"> +</div> +<div class="subsection" id="Equation-reference-hyperlinks"> +<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> +Next: <a href="#Index-hyperlinks" accesskey="n" rel="next">Index hyperlinks: idx</a>, Previous: <a href="#Page-reference-hyperlinks" accesskey="p" rel="prev">Page reference hyperlinks: xrdef, xref</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> <span id="Equation-reference-hyperlinks_003a-eq"></span><h4 class="subsection">5.3.7 Equation reference hyperlinks: eq</h4> @@ -5048,9 +4714,11 @@ label generated for the last empty-labeled equation. </p> <hr> -<span id="Index-hyperlinks"></span><div class="header"> +</div> +<div class="subsection" id="Index-hyperlinks"> +<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> +Next: <a href="#Footnote-hyperlinks" accesskey="n" rel="next">Footnote hyperlinks: foot, footback</a>, Previous: <a href="#Equation-reference-hyperlinks" accesskey="p" rel="prev">Equation reference hyperlinks: eq</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> <span id="Index-hyperlinks_003a-idx"></span><h4 class="subsection">5.3.8 Index hyperlinks: idx</h4> @@ -5097,24 +4765,20 @@ encapsulator, turns the page number into a link. <p>Eplain provides two approaches to linking page numbers in the index to 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"> -</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"> -</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"> -</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"> -</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"> -</td></tr> -</table> +<ul class="section-toc"> +<li><a href="#Exact-destinations-for-index-terms" accesskey="1">Exact destinations for index terms</a></li> +<li><a href="#Page-destinations-for-index-terms" accesskey="2">Page destinations for index terms</a></li> +<li><a href="#Choosing-destination-placement" accesskey="3">Choosing destination placement</a></li> +<li><a href="#Index-page-list-and-page-range-parsers" accesskey="4">Index page list and page range parsers</a></li> +<li><a href="#Hyperlinks-in-see-and-see-also-entries" accesskey="5">Hyperlinks in see and see also entries</a></li> +</ul> <hr> -<span id="Exact-destinations-for-index-terms"></span><div class="header"> +<div class="subsubsection" id="Exact-destinations-for-index-terms"> +<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> +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: idx</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="Exact-destinations-for-index-terms-1"></span><h4 class="subsubsection">5.3.8.1 Exact destinations for index terms</h4> @@ -5170,7 +4834,7 @@ hyperlink label but identical otherwise. You should process the example: </p> <div class="example"> -<pre class="example">prompt$ ./idxuniq file.idx | makeindex > file.ind +<pre class="example">$ ./idxuniq file.idx | makeindex >file.ind </pre></div> <p>Still, this solution is not ideal, as the page-range formation @@ -5181,9 +4845,11 @@ definition; <samp>idxuniq</samp> will not filter out the second entry). </p> <hr> -<span id="Page-destinations-for-index-terms"></span><div class="header"> +</div> +<div class="subsubsection" id="Page-destinations-for-index-terms"> +<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> +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: idx</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="Page-destinations-for-index-terms-1"></span><h4 class="subsubsection">5.3.8.2 Page destinations for index terms</h4> @@ -5252,9 +4918,11 @@ with the commands </p> <hr> -<span id="Choosing-destination-placement"></span><div class="header"> +</div> +<div class="subsubsection" id="Choosing-destination-placement"> +<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> +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: idx</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="Choosing-destination-placement-1"></span><h4 class="subsubsection">5.3.8.3 Choosing destination placement</h4> @@ -5287,9 +4955,11 @@ wrappers into the <samp>.idx</samp> file. The default is <code>idxpage</code>. </p> <hr> -<span id="Index-page-list-and-page-range-parsers"></span><div class="header"> +</div> +<div class="subsubsection" id="Index-page-list-and-page-range-parsers"> +<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> +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: idx</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="Index-page-list-and-page-range-parsers-1"></span><h4 class="subsubsection">5.3.8.4 Index page list and page range parsers</h4> @@ -5300,9 +4970,11 @@ usage. </p> <hr> -<span id="Hyperlinks-in-see-and-see-also-entries"></span><div class="header"> +</div> +<div class="subsubsection" id="Hyperlinks-in-see-and-see-also-entries"> +<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> +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: idx</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="Hyperlinks-in-see-and-see-also-entries-1"></span><h4 class="subsubsection">5.3.8.5 Hyperlinks in see and see also entries</h4> @@ -5330,9 +5002,12 @@ this can be implemented with <code>\hldest</code> and <code>\hlstart</code> <hr> -<span id="Footnote-hyperlinks"></span><div class="header"> +</div> +</div> +<div class="subsection" id="Footnote-hyperlinks"> +<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> +Next: <a href="#Contents-hyperlinks" accesskey="n" rel="next">Contents hyperlinks</a>, Previous: <a href="#Index-hyperlinks" accesskey="p" rel="prev">Index hyperlinks: idx</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> <span id="Footnote-hyperlinks_003a-foot_002c-footback"></span><h4 class="subsection">5.3.9 Footnote hyperlinks: foot, footback</h4> @@ -5377,9 +5052,11 @@ hyperlinks (see <a href="#Turning-hyperlinks-on_002foff-for-a-group">Turning hyp <hr> -<span id="Contents-hyperlinks"></span><div class="header"> +</div> +<div class="subsection" id="Contents-hyperlinks"> +<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> +Previous: <a href="#Footnote-hyperlinks" accesskey="p" rel="prev">Footnote hyperlinks: foot, footback</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> <span id="Contents-hyperlinks-1"></span><h4 class="subsection">5.3.10 Contents hyperlinks</h4> @@ -5393,7 +5070,10 @@ contents (see <a href="#Contents">Contents</a>), but implementing them with the </p> <hr> -<span id="Hyperlink-drivers"></span><div class="header"> +</div> +</div> +<div class="section" id="Hyperlink-drivers"> +<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> @@ -5406,22 +5086,19 @@ you may only want to skim through this section. <p>Some of the descriptions below come from <cite>Portable Document Format 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"> -</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"> -</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"> -</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"> -</td></tr> -</table> +<ul class="section-toc"> +<li><a href="#Options-supported-by-all-drivers" accesskey="1">Options supported by all drivers</a></li> +<li><a href="#Hyperlink-driver-hypertex" accesskey="2">Hyperlink driver <code>hypertex</code></a></li> +<li><a href="#Hyperlink-drivers-pdftex-and-dvipdfm" accesskey="3">Hyperlink drivers <code>pdftex</code> and <code>dvipdfm</code></a></li> +<li><a href="#Hyperlink-driver-nolinks" accesskey="4">Hyperlink driver <code>nolinks</code></a></li> +</ul> <hr> -<span id="Options-supported-by-all-drivers"></span><div class="header"> +<div class="subsection" id="Options-supported-by-all-drivers"> +<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> +Next: <a href="#Hyperlink-driver-hypertex" accesskey="n" rel="next">Hyperlink driver <code>hypertex</code></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> <span id="Options-supported-by-all-drivers-1"></span><h4 class="subsection">5.4.1 Options supported by all drivers</h4> @@ -5435,9 +5112,8 @@ supported by all hyperlink drivers. <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><span id="index-raise-_0028hyperlink-option_0029"></span> -<span id="index-raising-hyperlink-destinations"></span> +<dt id='index-raise-_0028hyperlink-option_0029'><span><code>raise</code><a href='#index-raise-_0028hyperlink-option_0029' class='copiable-anchor'> ¶</a></span></dt> +<dd><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 @@ -5472,10 +5148,9 @@ to accommodate the usual cases of large operators in displayed math. <span id="index-options_002c-link_002c-common"></span> <dl compact="compact"> -<dt><code>colormodel</code></dt> -<dt><code>color</code></dt> -<dd><span id="index-colormodel-_0028hyperlink-option_0029"></span> -<span id="index-color-_0028hyperlink-option_0029"></span> +<dt id='index-colormodel-_0028hyperlink-option_0029'><span><code>colormodel</code><a href='#index-colormodel-_0028hyperlink-option_0029' class='copiable-anchor'> ¶</a></span></dt> +<dt><span><code>color</code></span></dt> +<dd><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> @@ -5511,9 +5186,11 @@ an empty <var>colormodel</var> (see examples below). <hr> -<span id="Hyperlink-driver-hypertex"></span><div class="header"> +</div> +<div class="subsection" id="Hyperlink-driver-hypertex"> +<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> +Next: <a href="#Hyperlink-drivers-pdftex-and-dvipdfm" accesskey="n" rel="next">Hyperlink drivers <code>pdftex</code> and <code>dvipdfm</code></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> <span id="Hyperlink-driver-hypertex-1"></span><h4 class="subsection">5.4.2 Hyperlink driver <code>hypertex</code></h4> @@ -5522,15 +5199,15 @@ Next: <a href="#Hyperlink-drivers-pdftex-and-dvipdfm" accesskey="n" rel="next">H <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>). +TeX (and LaTeX) documents (see <a href="https://arxiv.org/hypertex">https://arxiv.org/hypertex</a>). This standard defines a set of hyperlink tags implemented as -<code>\special</code> commands written into the <acronym>DVI</acronym> file. The +<code>\special</code> commands written into the DVI file. The 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 <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., +<code>xdvi</code>) or converted to other file formats (e.g., PDF) +by any HyperTeX-enabled DVI converter (e.g., <span id="index-dvipdfm-1"></span> <code>dvipdfmx</code> or <span id="index-dvips"></span> @@ -5544,16 +5221,16 @@ Ghostscript’s factor” of other formats supporting hyperlinks, so many features of a particular file format cannot be supported by HyperTeX. Therefore, if you need to use special features of a particular format, HyperTeX -is not a good choice. For the <acronym>PDF</acronym> file format, Eplain +is not a good choice. For the PDF file format, Eplain provides the <code>pdftex</code> and <code>dvipdfm</code> drivers which provide -fine control over the <acronym>PDF</acronym> options (see <a href="#Hyperlink-drivers-pdftex-and-dvipdfm">Hyperlink drivers pdftex and dvipdfm</a>). +fine control over the PDF options (see <a href="#Hyperlink-drivers-pdftex-and-dvipdfm">Hyperlink drivers <code>pdftex</code> and <code>dvipdfm</code></a>). </p> <p>For more information on programs which support the HyperTeX standard, please see </p> <div class="display"> -<pre class="display"><a href="http://arxiv.org/hypertex">http://arxiv.org/hypertex</a> -<a href="http://mirror.ctan.org/support/hypertex/hypertex">http://mirror.ctan.org/support/hypertex/hypertex</a> +<pre class="display"><a href="https://arxiv.org/hypertex">https://arxiv.org/hypertex</a> +<a href="https://mirror.ctan.org/support/hypertex/hypertex">https://mirror.ctan.org/support/hypertex/hypertex</a> </pre></div> <p>For convenience, we list a few HyperTeX-enabled converters: @@ -5561,7 +5238,7 @@ please see <dl compact="compact"> <dd><span id="index-dvips-1"></span> </dd> -<dt><code>dvips</code></dt> +<dt><span><code>dvips</code></span></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 @@ -5572,18 +5249,17 @@ Ghostscript. For example, if <samp>foo.tex</samp> is a TeX file using HyperTeX commands, then </p> <div class="example"> -<pre class="example">prompt$ tex foo.tex -prompt$ dvips -z foo.dvi -o -prompt$ ps2pdf foo.ps +<pre class="example">$ tex foo.tex +$ dvips -z foo.dvi -o +$ ps2pdf foo.ps </pre></div> <p>will produce <samp>foo.pdf</samp> with hyperlinks. </p> </dd> -<dt><code>dvipdfm</code></dt> -<dt><code>dvipdfmx</code></dt> -<dd><span id="index-dvipdfm-2"></span> -<p>No special command line arguments are required, these programs +<dt id='index-dvipdfm-2'><span><code>dvipdfm</code><a href='#index-dvipdfm-2' class='copiable-anchor'> ¶</a></span></dt> +<dt><span><code>dvipdfmx</code></span></dt> +<dd><p>No special command line arguments are required, these programs automatically detect the HyperTeX commands. </p> </dd> @@ -5598,25 +5274,22 @@ destination, so that “exact” linking to destinations is not possible (this was confirmed to be a bug and most probably has already been fixed in later versions of dvips(k)); dvipdfm as of version 0.13.2c and dvipdfmx as of version 20040411 do not correctly parse links to -external local files, and produce a <acronym>URL</acronym> link instead of a +external local files, and produce a url 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"> -</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"> -</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"> -</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"> -</td></tr> -</table> +<ul class="section-toc"> +<li><a href="#Destination-types-for-hypertex" accesskey="1">Destination types for <code>hypertex</code></a></li> +<li><a href="#Destination-options-for-hypertex" accesskey="2">Destination options for <code>hypertex</code></a></li> +<li><a href="#Link-types-for-hypertex" accesskey="3">Link types for <code>hypertex</code></a></li> +<li><a href="#Link-options-for-hypertex" accesskey="4">Link options for <code>hypertex</code></a></li> +</ul> <hr> -<span id="Destination-types-for-hypertex"></span><div class="header"> +<div class="subsubsection" id="Destination-types-for-hypertex"> +<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> +Next: <a href="#Destination-options-for-hypertex" accesskey="n" rel="next">Destination options for <code>hypertex</code></a>, Up: <a href="#Hyperlink-driver-hypertex" accesskey="u" rel="up">Hyperlink driver <code>hypertex</code></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="Destination-types-for-hypertex-1"></span><h4 class="subsubsection">5.4.2.1 Destination types for <code>hypertex</code></h4> @@ -5624,16 +5297,14 @@ Next: <a href="#Destination-options-for-hypertex" accesskey="n" rel="next">Desti <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><span id="index-xyz-_0028destination-type_0029"></span> -<p>“Current position”. This is the default type. +<dt id='index-xyz-_0028destination-type_0029'><span><code>xyz</code><a href='#index-xyz-_0028destination-type_0029' class='copiable-anchor'> ¶</a></span></dt> +<dd><p>“Current position”. This is the default type. </p> <p>Example: <code>\hldest{xyz}{}{dest123}</code> </p> </dd> -<dt><code>raw</code></dt> -<dd><span id="index-raw-_0028destination-type_0029"></span> -<p>The destination specification (in the form of a HyperTeX +<dt id='index-raw-_0028destination-type_0029'><span><code>raw</code><a href='#index-raw-_0028destination-type_0029' class='copiable-anchor'> ¶</a></span></dt> +<dd><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 <span id="index-cmd-_0028destination-option_0029"></span> @@ -5660,9 +5331,11 @@ intended to be used with destgroups (see <a href="#Setting-hyperlink-types-and-o <hr> -<span id="Destination-options-for-hypertex"></span><div class="header"> +</div> +<div class="subsubsection" id="Destination-options-for-hypertex"> +<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> +Next: <a href="#Link-types-for-hypertex" accesskey="n" rel="next">Link types for <code>hypertex</code></a>, Previous: <a href="#Destination-types-for-hypertex" accesskey="p" rel="prev">Destination types for <code>hypertex</code></a>, Up: <a href="#Hyperlink-driver-hypertex" accesskey="u" rel="up">Hyperlink driver <code>hypertex</code></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="Destination-options-for-hypertex-1"></span><h4 class="subsubsection">5.4.2.2 Destination options for <code>hypertex</code></h4> @@ -5670,21 +5343,22 @@ Next: <a href="#Link-types-for-hypertex" accesskey="n" rel="next">Link types for <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><span id="index-cmd-_0028destination-option_0029-1"></span> -<p>Name of the macro (without the leading ‘<samp>\</samp>’) containing a +<dt id='index-cmd-_0028destination-option_0029-1'><span><code>cmd</code><a href='#index-cmd-_0028destination-option_0029-1' class='copiable-anchor'> ¶</a></span></dt> +<dd><p>Name of the macro (without the leading ‘<samp>\</samp>’) containing a HyperTeX <code>\special</code> for the <code>raw</code> destination. </p> -<p>See <a href="#Destination-types-for-hypertex">Destination types for hypertex</a>, the description of the <code>raw</code> +<p>See <a href="#Destination-types-for-hypertex">Destination types for <code>hypertex</code></a>, the description of the <code>raw</code> destination, for an example. </p></dd> </dl> <hr> -<span id="Link-types-for-hypertex"></span><div class="header"> +</div> +<div class="subsubsection" id="Link-types-for-hypertex"> +<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> +Next: <a href="#Link-options-for-hypertex" accesskey="n" rel="next">Link options for <code>hypertex</code></a>, Previous: <a href="#Destination-options-for-hypertex" accesskey="p" rel="prev">Destination options for <code>hypertex</code></a>, Up: <a href="#Hyperlink-driver-hypertex" accesskey="u" rel="up">Hyperlink driver <code>hypertex</code></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="Link-types-for-hypertex-1"></span><h4 class="subsubsection">5.4.2.3 Link types for <code>hypertex</code></h4> @@ -5692,9 +5366,8 @@ Next: <a href="#Link-options-for-hypertex" accesskey="n" rel="next">Link options <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><span id="index-name-_0028hyperlink-type_0029"></span> -<span id="index-named-destination"></span> +<dt id='index-name-_0028hyperlink-type_0029'><span><code>name</code><a href='#index-name-_0028hyperlink-type_0029' class='copiable-anchor'> ¶</a></span></dt> +<dd><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 @@ -5704,12 +5377,11 @@ type. <p>Example: <code>\hlstart{name}{}{dest123}Link to dest123\hlend</code> </p> </dd> -<dt><code>url</code></dt> -<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>. +<dt id='index-url-_0028hyperlink-type_0029'><span><code>url</code><a href='#index-url-_0028hyperlink-type_0029' class='copiable-anchor'> ¶</a></span></dt> +<dd><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 url. The label is the url. </p> <p>Example: </p> @@ -5718,9 +5390,8 @@ type. </pre></div> </dd> -<dt><code>filename</code></dt> -<dd><span id="index-filename-_0028hyperlink-type_0029"></span> -<span id="index-file_002c-hyperlink-to"></span> +<dt id='index-filename-_0028hyperlink-type_0029'><span><code>filename</code><a href='#index-filename-_0028hyperlink-type_0029' class='copiable-anchor'> ¶</a></span></dt> +<dd><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 @@ -5732,8 +5403,8 @@ by the <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 -restricted to any single output format, it can be <acronym>DVI</acronym>, -<acronym>PDF</acronym>, possibly other formats. +restricted to any single output format, it can be DVI, +PDF, possibly other formats. </p> <p>Example: </p> @@ -5744,9 +5415,8 @@ restricted to any single output format, it can be <acronym>DVI</acronym>, </pre></div> </dd> -<dt><code>raw</code></dt> -<dd><span id="index-raw-_0028hyperlink-type_0029"></span> -<p>The link specification (in the form of a HyperTeX <code>\special</code>) is +<dt id='index-raw-_0028hyperlink-type_0029'><span><code>raw</code><a href='#index-raw-_0028hyperlink-type_0029' class='copiable-anchor'> ¶</a></span></dt> +<dd><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 <span id="index-cmd-_0028hyperlink-option_0029"></span> @@ -5775,9 +5445,11 @@ intended to be used with linkgroups (see <a href="#Setting-hyperlink-types-and-o <hr> -<span id="Link-options-for-hypertex"></span><div class="header"> +</div> +<div class="subsubsection" id="Link-options-for-hypertex"> +<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> +Previous: <a href="#Link-types-for-hypertex" accesskey="p" rel="prev">Link types for <code>hypertex</code></a>, Up: <a href="#Hyperlink-driver-hypertex" accesskey="u" rel="up">Hyperlink driver <code>hypertex</code></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="Link-options-for-hypertex-1"></span><h4 class="subsubsection">5.4.2.4 Link options for <code>hypertex</code></h4> @@ -5785,42 +5457,42 @@ Previous: <a href="#Link-types-for-hypertex" accesskey="p" rel="prev">Link types <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><span id="index-cmd-_0028hyperlink-option_0029-1"></span> -<p>Name of the macro (without the leading ‘<samp>\</samp>’) containing a +<dt id='index-cmd-_0028hyperlink-option_0029-1'><span><code>cmd</code><a href='#index-cmd-_0028hyperlink-option_0029-1' class='copiable-anchor'> ¶</a></span></dt> +<dd><p>Name of the macro (without the leading ‘<samp>\</samp>’) containing a HyperTeX <code>\special</code> for the <code>raw</code> link. </p> -<p>See <a href="#Link-types-for-hypertex">Link types for hypertex</a>, the description of the <code>raw</code> link, +<p>See <a href="#Link-types-for-hypertex">Link types for <code>hypertex</code></a>, the description of the <code>raw</code> link, for an example. </p> </dd> -<dt><code>file</code></dt> -<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> +<dt id='index-file-_0028hyperlink-option_0029-1'><span><code>file</code><a href='#index-file-_0028hyperlink-option_0029-1' class='copiable-anchor'> ¶</a></span></dt> +<dd><p>File name for the <code>filename</code> link type. See also the <code>ext</code> option. </p> -<p>See <a href="#Link-types-for-hypertex">Link types for hypertex</a>, the description of the <code>filename</code> +<p>See <a href="#Link-types-for-hypertex">Link types for <code>hypertex</code></a>, the description of the <code>filename</code> link, for an example. </p> </dd> -<dt><code>ext</code></dt> -<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 +<dt id='index-ext-_0028hyperlink-option_0029-1'><span><code>ext</code><a href='#index-ext-_0028hyperlink-option_0029-1' class='copiable-anchor'> ¶</a></span></dt> +<dd><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 link—HyperTeX is not restricted to any single output format, it can -be <acronym>DVI</acronym>, <acronym>PDF</acronym>, possibly other formats. +be DVI, PDF, possibly other formats. </p> -<p>See <a href="#Link-types-for-hypertex">Link types for hypertex</a>, the description of the <code>filename</code> +<p>See <a href="#Link-types-for-hypertex">Link types for <code>hypertex</code></a>, the description of the <code>filename</code> link, for an example. </p></dd> </dl> <hr> -<span id="Hyperlink-drivers-pdftex-and-dvipdfm"></span><div class="header"> +</div> +</div> +<div class="subsection" id="Hyperlink-drivers-pdftex-and-dvipdfm"> +<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> +Next: <a href="#Hyperlink-driver-nolinks" accesskey="n" rel="next">Hyperlink driver <code>nolinks</code></a>, Previous: <a href="#Hyperlink-driver-hypertex" accesskey="p" rel="prev">Hyperlink driver <code>hypertex</code></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> <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> @@ -5837,22 +5509,19 @@ supported by the <code>pdftex</code> and <code>dvipdfm</code> drivers. Many of 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"> -</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"> -</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"> -</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"> -</td></tr> -</table> +<ul class="section-toc"> +<li><a href="#Destination-types-for-pdftex-and-dvipdfm" accesskey="1">Destination types for <code>pdftex</code> and <code>dvipdfm</code></a></li> +<li><a href="#Destination-options-for-pdftex-and-dvipdfm" accesskey="2">Destination options for <code>pdftex</code> and <code>dvipdfm</code></a></li> +<li><a href="#Link-types-for-pdftex-and-dvipdfm" accesskey="3">Link types for <code>pdftex</code> and <code>dvipdfm</code></a></li> +<li><a href="#Link-options-for-pdftex-and-dvipdfm" accesskey="4">Link options for <code>pdftex</code> and <code>dvipdfm</code></a></li> +</ul> <hr> -<span id="Destination-types-for-pdftex-and-dvipdfm"></span><div class="header"> +<div class="subsubsection" id="Destination-types-for-pdftex-and-dvipdfm"> +<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> +Next: <a href="#Destination-options-for-pdftex-and-dvipdfm" accesskey="n" rel="next">Destination options for <code>pdftex</code> and <code>dvipdfm</code></a>, Up: <a href="#Hyperlink-drivers-pdftex-and-dvipdfm" accesskey="u" rel="up">Hyperlink drivers <code>pdftex</code> and <code>dvipdfm</code></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="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> @@ -5863,9 +5532,8 @@ Next: <a href="#Destination-options-for-pdftex-and-dvipdfm" accesskey="n" rel="n <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><span id="index-xyz-_0028destination-type_0029-1"></span> -<p>“Current position”. The option +<dt id='index-xyz-_0028destination-type_0029-1'><span><code>xyz</code><a href='#index-xyz-_0028destination-type_0029-1' class='copiable-anchor'> ¶</a></span></dt> +<dd><p>“Current position”. The option <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 @@ -5881,16 +5549,14 @@ current position coordinate, which is the default). <p>Example: <code>\hldest{xyz}{zoom=2000}{dest123}</code> </p> </dd> -<dt><code>fit</code></dt> -<dd><span id="index-fit-_0028destination-type_0029"></span> -<p>Fit the page to the window. +<dt id='index-fit-_0028destination-type_0029'><span><code>fit</code><a href='#index-fit-_0028destination-type_0029' class='copiable-anchor'> ¶</a></span></dt> +<dd><p>Fit the page to the window. </p> <p>Example: <code>\hldest{fit}{}{dest123}</code> </p> </dd> -<dt><code>fith</code></dt> -<dd><span id="index-fith-_0028destination-type_0029"></span> -<p>Fit the width of the page to the window. +<dt id='index-fith-_0028destination-type_0029'><span><code>fith</code><a href='#index-fith-_0028destination-type_0029' class='copiable-anchor'> ¶</a></span></dt> +<dd><p>Fit the width of the page to the window. </p> <p>For <code>dvipdfm</code>: the <span id="index-top-_0028destination-option_0029-1"></span> @@ -5900,9 +5566,8 @@ current position). <p>Example: <code>\hldest{fith}{}{dest123}</code> </p> </dd> -<dt><code>fitv</code></dt> -<dd><span id="index-fitv-_0028destination-type_0029"></span> -<p>Fit the height of the page to the window. +<dt id='index-fitv-_0028destination-type_0029'><span><code>fitv</code><a href='#index-fitv-_0028destination-type_0029' class='copiable-anchor'> ¶</a></span></dt> +<dd><p>Fit the height of the page to the window. </p> <p>For <code>dvipdfm</code>: The option <span id="index-left-_0028destination-option_0029-1"></span> @@ -5912,16 +5577,14 @@ current position). <p>Example: <code>\hldest{fitv}{}{dest123}</code> </p> </dd> -<dt><code>fitb</code></dt> -<dd><span id="index-fitb-_0028destination-type_0029"></span> -<p>Fit the page’s bounding box to the window. +<dt id='index-fitb-_0028destination-type_0029'><span><code>fitb</code><a href='#index-fitb-_0028destination-type_0029' class='copiable-anchor'> ¶</a></span></dt> +<dd><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><span id="index-fitbh-_0028destination-type_0029"></span> -<p>Fit the width of the page’s bounding box to the window. +<dt id='index-fitbh-_0028destination-type_0029'><span><code>fitbh</code><a href='#index-fitbh-_0028destination-type_0029' class='copiable-anchor'> ¶</a></span></dt> +<dd><p>Fit the width of the page’s bounding box to the window. </p> <p>For <code>dvipdfm</code>: the option <span id="index-top-_0028destination-option_0029-2"></span> @@ -5931,9 +5594,8 @@ current position). <p>Example: <code>\hldest{fitbh}{}{dest123}</code> </p> </dd> -<dt><code>fitbv</code></dt> -<dd><span id="index-fitbv-_0028destination-type_0029"></span> -<p>Fit the height of the page’s bounding box to the window. +<dt id='index-fitbv-_0028destination-type_0029'><span><code>fitbv</code><a href='#index-fitbv-_0028destination-type_0029' class='copiable-anchor'> ¶</a></span></dt> +<dd><p>Fit the height of the page’s bounding box to the window. </p> <p>For <code>dvipdfm</code>: the option <span id="index-left-_0028destination-option_0029-2"></span> @@ -5943,9 +5605,8 @@ current position). <p>Example: <code>\hldest{fitbv}{}{dest123}</code> </p> </dd> -<dt><code>fitr</code></dt> -<dd><span id="index-fitr-_0028destination-type_0029"></span> -<p>For <code>pdftex</code>: fit the rectangle specified by the options +<dt id='index-fitr-_0028destination-type_0029'><span><code>fitr</code><a href='#index-fitr-_0028destination-type_0029' class='copiable-anchor'> ¶</a></span></dt> +<dd><p>For <code>pdftex</code>: fit the rectangle specified by the options <span id="index-width-_0028destination-option_0029"></span> <code>width</code>, <span id="index-height-_0028destination-option_0029"></span> @@ -5984,9 +5645,8 @@ dimensions set to empty, current position coordinate is substituted </pre></div> </dd> -<dt><code>raw</code></dt> -<dd><span id="index-raw-_0028destination-type_0029-1"></span> -<p>The destination specification (in the form of a pdfTeX command or a +<dt id='index-raw-_0028destination-type_0029-1'><span><code>raw</code><a href='#index-raw-_0028destination-type_0029-1' class='copiable-anchor'> ¶</a></span></dt> +<dd><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 <span id="index-cmd-_0028destination-option_0029-2"></span> @@ -6022,9 +5682,11 @@ intended to be used with destgroups (see <a href="#Setting-hyperlink-types-and-o <hr> -<span id="Destination-options-for-pdftex-and-dvipdfm"></span><div class="header"> +</div> +<div class="subsubsection" id="Destination-options-for-pdftex-and-dvipdfm"> +<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> +Next: <a href="#Link-types-for-pdftex-and-dvipdfm" accesskey="n" rel="next">Link types for <code>pdftex</code> and <code>dvipdfm</code></a>, Previous: <a href="#Destination-types-for-pdftex-and-dvipdfm" accesskey="p" rel="prev">Destination types for <code>pdftex</code> and <code>dvipdfm</code></a>, Up: <a href="#Hyperlink-drivers-pdftex-and-dvipdfm" accesskey="u" rel="up">Hyperlink drivers <code>pdftex</code> and <code>dvipdfm</code></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="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> @@ -6043,19 +5705,17 @@ Next: <a href="#Link-types-for-pdftex-and-dvipdfm" accesskey="n" rel="next">Link <span id="Common-destination-options"></span><h4 class="subsubheading">Common destination options</h4> <dl compact="compact"> -<dt><code>cmd</code></dt> -<dd><span id="index-cmd-_0028destination-option_0029-3"></span> -<p>Name of the macro (without the leading ‘<samp>\</samp>’) containing a +<dt id='index-cmd-_0028destination-option_0029-3'><span><code>cmd</code><a href='#index-cmd-_0028destination-option_0029-3' class='copiable-anchor'> ¶</a></span></dt> +<dd><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. </p> -<p>See <a href="#Destination-types-for-pdftex-and-dvipdfm">Destination types for pdftex and dvipdfm</a>, the description of the +<p>See <a href="#Destination-types-for-pdftex-and-dvipdfm">Destination types for <code>pdftex</code> and <code>dvipdfm</code></a>, the description of the <code>raw</code> destination, for an example. </p> </dd> -<dt><code>zoom</code></dt> -<dd><span id="index-zoom-_0028destination-option_0029-1"></span> -<span id="index-destinations_002c-magnification"></span> +<dt id='index-zoom-_0028destination-option_0029-1'><span><code>zoom</code><a href='#index-zoom-_0028destination-option_0029-1' class='copiable-anchor'> ¶</a></span></dt> +<dd><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> @@ -6076,25 +5736,22 @@ of the parent box is used (this is the default for all dimension options). </p> <dl compact="compact"> -<dt><code>depth</code></dt> -<dd><span id="index-depth-_0028destination-option_0029-1"></span> -<span id="index-destinations_002c-dimensions"></span> +<dt id='index-depth-_0028destination-option_0029-1'><span><code>depth</code><a href='#index-depth-_0028destination-option_0029-1' class='copiable-anchor'> ¶</a></span></dt> +<dd><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><span id="index-height-_0028destination-option_0029-1"></span> -<span id="index-destinations_002c-dimensions-1"></span> +<dt id='index-height-_0028destination-option_0029-1'><span><code>height</code><a href='#index-height-_0028destination-option_0029-1' class='copiable-anchor'> ¶</a></span></dt> +<dd><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><span id="index-width-_0028destination-option_0029-1"></span> -<span id="index-destinations_002c-dimensions-2"></span> +<dt id='index-width-_0028destination-option_0029-1'><span><code>width</code><a href='#index-width-_0028destination-option_0029-1' class='copiable-anchor'> ¶</a></span></dt> +<dd><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. @@ -6118,36 +5775,32 @@ PostScript points (72 points per inch), as a number without the coordinate is used (this is the default for all dimension options). </p> <dl compact="compact"> -<dt><code>bottom</code></dt> -<dd><span id="index-bottom-_0028destination-option_0029-1"></span> -<span id="index-destinations_002c-dimensions-3"></span> +<dt id='index-bottom-_0028destination-option_0029-1'><span><code>bottom</code><a href='#index-bottom-_0028destination-option_0029-1' class='copiable-anchor'> ¶</a></span></dt> +<dd><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><span id="index-left-_0028destination-option_0029-4"></span> -<span id="index-destinations_002c-dimensions-4"></span> +<dt id='index-left-_0028destination-option_0029-4'><span><code>left</code><a href='#index-left-_0028destination-option_0029-4' class='copiable-anchor'> ¶</a></span></dt> +<dd><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><span id="index-right-_0028destination-option_0029-1"></span> -<span id="index-destinations_002c-dimensions-5"></span> +<dt id='index-right-_0028destination-option_0029-1'><span><code>right</code><a href='#index-right-_0028destination-option_0029-1' class='copiable-anchor'> ¶</a></span></dt> +<dd><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><span id="index-top-_0028destination-option_0029-4"></span> -<span id="index-destinations_002c-dimensions-6"></span> +<dt id='index-top-_0028destination-option_0029-4'><span><code>top</code><a href='#index-top-_0028destination-option_0029-4' class='copiable-anchor'> ¶</a></span></dt> +<dd><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 @@ -6164,9 +5817,11 @@ destination types. <hr> -<span id="Link-types-for-pdftex-and-dvipdfm"></span><div class="header"> +</div> +<div class="subsubsection" id="Link-types-for-pdftex-and-dvipdfm"> +<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> +Next: <a href="#Link-options-for-pdftex-and-dvipdfm" accesskey="n" rel="next">Link options for <code>pdftex</code> and <code>dvipdfm</code></a>, Previous: <a href="#Destination-options-for-pdftex-and-dvipdfm" accesskey="p" rel="prev">Destination options for <code>pdftex</code> and <code>dvipdfm</code></a>, Up: <a href="#Hyperlink-drivers-pdftex-and-dvipdfm" accesskey="u" rel="up">Hyperlink drivers <code>pdftex</code> and <code>dvipdfm</code></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="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> @@ -6188,9 +5843,8 @@ low-level pdfTeX commands. <span id="Common-link-types"></span><h4 class="subsubheading">Common link types</h4> <dl compact="compact"> -<dt><code>name</code></dt> -<dd><span id="index-name-_0028hyperlink-type_0029-1"></span> -<span id="index-named-destination-1"></span> +<dt id='index-name-_0028hyperlink-type_0029-1'><span><code>name</code><a href='#index-name-_0028hyperlink-type_0029-1' class='copiable-anchor'> ¶</a></span></dt> +<dd><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. @@ -6200,19 +5854,17 @@ All destinations created with <code>\hldest</code> are named destinations <p>Example: <code>\hlstart{name}{}{dest123}Link to dest123\hlend</code> </p> </dd> -<dt><code>url</code></dt> -<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>. +<dt id='index-url-_0028hyperlink-type_0029-1'><span><code>url</code><a href='#index-url-_0028hyperlink-type_0029-1' class='copiable-anchor'> ¶</a></span></dt> +<dd><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 url. The label is the url. </p> <p>Example: <code>\hlstart{url}{}{https://tug.org/eplain/}Eplain home\hlend</code> </p> </dd> -<dt><code>page</code></dt> -<dd><span id="index-page-_0028hyperlink-type_0029"></span> -<span id="index-page-destination"></span> +<dt id='index-page-_0028hyperlink-type_0029'><span><code>page</code><a href='#index-page-_0028hyperlink-type_0029' class='copiable-anchor'> ¶</a></span></dt> +<dd><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). @@ -6228,9 +5880,8 @@ Page fitting is specified by the </pre></div> </dd> -<dt><code>filename</code></dt> -<dd><span id="index-filename-_0028hyperlink-type_0029-1"></span> -<span id="index-file_002c-hyperlink-to-1"></span> +<dt id='index-filename-_0028hyperlink-type_0029-1'><span><code>filename</code><a href='#index-filename-_0028hyperlink-type_0029-1' class='copiable-anchor'> ¶</a></span></dt> +<dd><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 @@ -6251,9 +5902,8 @@ opened in the same window or in a new window. </pre></div> </dd> -<dt><code>filepage</code></dt> -<dd><span id="index-filepage-_0028hyperlink-type_0029"></span> -<span id="index-file_002c-hyperlink-to-2"></span> +<dt id='index-filepage-_0028hyperlink-type_0029'><span><code>filepage</code><a href='#index-filepage-_0028hyperlink-type_0029' class='copiable-anchor'> ¶</a></span></dt> +<dd><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 @@ -6275,9 +5925,8 @@ opened in the same window or in a new window. </pre></div> </dd> -<dt><code>raw</code></dt> -<dd><span id="index-raw-_0028hyperlink-type_0029-1"></span> -<p>The link specification (in the form of a pdfTeX command or a dvipdfm +<dt id='index-raw-_0028hyperlink-type_0029-1'><span><code>raw</code><a href='#index-raw-_0028hyperlink-type_0029-1' class='copiable-anchor'> ¶</a></span></dt> +<dd><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 <span id="index-cmd-_0028hyperlink-option_0029-2"></span> @@ -6312,9 +5961,8 @@ intended to be used with linkgroups (see <a href="#Setting-hyperlink-types-and-o <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><span id="index-num-_0028hyperlink-type_0029"></span> -<span id="index-numbered-destination"></span> +<dt id='index-num-_0028hyperlink-type_0029'><span><code>num</code><a href='#index-num-_0028hyperlink-type_0029' class='copiable-anchor'> ¶</a></span></dt> +<dd><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 @@ -6326,9 +5974,11 @@ number. <hr> -<span id="Link-options-for-pdftex-and-dvipdfm"></span><div class="header"> +</div> +<div class="subsubsection" id="Link-options-for-pdftex-and-dvipdfm"> +<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> +Previous: <a href="#Link-types-for-pdftex-and-dvipdfm" accesskey="p" rel="prev">Link types for <code>pdftex</code> and <code>dvipdfm</code></a>, Up: <a href="#Hyperlink-drivers-pdftex-and-dvipdfm" accesskey="u" rel="up">Hyperlink drivers <code>pdftex</code> and <code>dvipdfm</code></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="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> @@ -6346,9 +5996,8 @@ options to specify link dimensions. <span id="Common-link-options"></span><h4 class="subsubheading">Common link options</h4> <dl compact="compact"> -<dt><code>bcolor</code></dt> -<dd><span id="index-bcolor-_0028hyperlink-option_0029"></span> -<span id="index-hyperlink-border-color"></span> +<dt id='index-bcolor-_0028hyperlink-option_0029'><span><code>bcolor</code><a href='#index-bcolor-_0028hyperlink-option_0029' class='copiable-anchor'> ¶</a></span></dt> +<dd><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, @@ -6357,9 +6006,8 @@ representing a color in DeviceRGB. <p>Example: <code>\hlstart{name}{bcolor=.1 .5 1}{dest123}Link\hlend</code> </p> </dd> -<dt><code>bdash</code></dt> -<dd><span id="index-bdash-_0028hyperlink-option_0029"></span> -<span id="index-dashed-hyperlink-border"></span> +<dt id='index-bdash-_0028hyperlink-option_0029'><span><code>bdash</code><a href='#index-bdash-_0028hyperlink-option_0029' class='copiable-anchor'> ¶</a></span></dt> +<dd><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 @@ -6368,9 +6016,8 @@ dashes. <p>Example: <code>\hlstart{name}{bstyle=D,bdash=2 4}{dest123}Link\hlend</code> </p> </dd> -<dt><code>bstyle</code></dt> -<dd><span id="index-bstyle-_0028hyperlink-option_0029"></span> -<span id="index-solid-hyperlink-border"></span> +<dt id='index-bstyle-_0028hyperlink-option_0029'><span><code>bstyle</code><a href='#index-bstyle-_0028hyperlink-option_0029' class='copiable-anchor'> ¶</a></span></dt> +<dd><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> @@ -6381,26 +6028,26 @@ dashes. <p>Link border style: </p> <dl compact="compact"> -<dt><code>S</code></dt> +<dt><span><code>S</code></span></dt> <dd><p>The border is drawn as a solid line. </p> </dd> -<dt><code>D</code></dt> +<dt><span><code>D</code></span></dt> <dd><p>The border is drawn with a dashed line (the dash pattern is specified by the <span id="index-bdash-_0028hyperlink-option_0029-1"></span> <code>bdash</code> option). </p> </dd> -<dt><code>B</code></dt> +<dt><span><code>B</code></span></dt> <dd><p>The border is drawn in a beveled style. </p> </dd> -<dt><code>I</code></dt> +<dt><span><code>I</code></span></dt> <dd><p>The border is drawn in an inset style. </p> </dd> -<dt><code>U</code></dt> +<dt><span><code>U</code></span></dt> <dd><p>The border is drawn as a line on the bottom of the link rectangle. </p></dd> </dl> @@ -6410,9 +6057,8 @@ by the <p>Example: <code>\hlstart{name}{bstyle=D,bdash=2 4}{dest123}Link\hlend</code> </p> </dd> -<dt><code>bwidth</code></dt> -<dd><span id="index-bwidth-_0028hyperlink-option_0029"></span> -<span id="index-width_002c-hyperlink-border"></span> +<dt id='index-bwidth-_0028hyperlink-option_0029'><span><code>bwidth</code><a href='#index-bwidth-_0028hyperlink-option_0029' class='copiable-anchor'> ¶</a></span></dt> +<dd><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 @@ -6422,43 +6068,40 @@ PostScript points (72 points per inch). The default is 1. <p>Example: <code>\hlstart{name}{bwidth=2}{dest123}Link\hlend</code> </p> </dd> -<dt><code>cmd</code></dt> -<dd><span id="index-cmd-_0028hyperlink-option_0029-3"></span> -<p>Name of the macro (without the leading ‘<samp>\</samp>’) containing a +<dt id='index-cmd-_0028hyperlink-option_0029-3'><span><code>cmd</code><a href='#index-cmd-_0028hyperlink-option_0029-3' class='copiable-anchor'> ¶</a></span></dt> +<dd><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> -<p>See <a href="#Link-types-for-pdftex-and-dvipdfm">Link types for pdftex and dvipdfm</a>, the description of the +<p>See <a href="#Link-types-for-pdftex-and-dvipdfm">Link types for <code>pdftex</code> and <code>dvipdfm</code></a>, the description of the <code>raw</code> link, for an example. </p> </dd> -<dt><code>file</code></dt> -<dd><span id="index-file-_0028hyperlink-option_0029-4"></span> -<p>File name for the <code>filename</code> and <code>filepage</code> link types. +<dt id='index-file-_0028hyperlink-option_0029-4'><span><code>file</code><a href='#index-file-_0028hyperlink-option_0029-4' class='copiable-anchor'> ¶</a></span></dt> +<dd><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 +<p>See <a href="#Link-types-for-pdftex-and-dvipdfm">Link types for <code>pdftex</code> and <code>dvipdfm</code></a>, the descriptions of the <code>filename</code> and <code>filepage</code> links, for an example. </p> </dd> -<dt><code>hlight</code></dt> -<dd><span id="index-hlight-_0028hyperlink-option_0029"></span> -<span id="index-hyperlinks_002c-highlight-mode"></span> +<dt id='index-hlight-_0028hyperlink-option_0029'><span><code>hlight</code><a href='#index-hlight-_0028hyperlink-option_0029' class='copiable-anchor'> ¶</a></span></dt> +<dd><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"> -<dt><code>I</code></dt> +<dt><span><code>I</code></span></dt> <dd><p>The rectangle specified by the bounding box of the link is inverted. </p> </dd> -<dt><code>N</code></dt> +<dt><span><code>N</code></span></dt> <dd><p>No highlighting is done. </p> </dd> -<dt><code>O</code></dt> +<dt><span><code>O</code></span></dt> <dd><p>The border of the link is inverted. </p> </dd> -<dt><code>P</code></dt> +<dt><span><code>P</code></span></dt> <dd><p>The region underneath the bounding box of the link is drawn inset into the page. </p></dd> @@ -6469,39 +6112,37 @@ the page. <p>Example: <code>\hlstart{name}{bstyle=S,hlight=O}{dest123}Link\hlend</code> </p> </dd> -<dt><code>newwin</code></dt> -<dd><span id="index-newwin-_0028hyperlink-option_0029-2"></span> -<span id="index-hyperlinks_002c-opening-in-a-new-window"></span> +<dt id='index-newwin-_0028hyperlink-option_0029-2'><span><code>newwin</code><a href='#index-newwin-_0028hyperlink-option_0029-2' class='copiable-anchor'> ¶</a></span></dt> +<dd><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> <dl compact="compact"> -<dt><code>0</code></dt> +<dt><span><code>0</code></span></dt> <dd><p>Open in the same window. </p></dd> -<dt><code><span class="roman">non-</span>0</code></dt> +<dt><span><code><span class="roman">non-</span>0</code></span></dt> <dd><p>Open in a new window. </p></dd> -<dt><code><span class="roman">empty</span></code></dt> +<dt><span><code><span class="roman">empty</span></code></span></dt> <dd><p>Behavior according to the viewer settings. </p></dd> </dl> <p>The default is empty. </p> -<p>See <a href="#Link-types-for-pdftex-and-dvipdfm">Link types for pdftex and dvipdfm</a>, the descriptions of the +<p>See <a href="#Link-types-for-pdftex-and-dvipdfm">Link types for <code>pdftex</code> and <code>dvipdfm</code></a>, the descriptions of the <code>filename</code> and <code>filepage</code> links, for an example. </p> </dd> -<dt><code>pagefit</code></dt> -<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 +<dt id='index-pagefit-_0028hyperlink-option_0029-3'><span><code>pagefit</code><a href='#index-pagefit-_0028hyperlink-option_0029-3' class='copiable-anchor'> ¶</a></span></dt> +<dd><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 -<acronym>PDF</acronym> standard. +to the PDF file as is, so it must conform to the +PDF standard. </p> -<p>See <a href="#Link-types-for-pdftex-and-dvipdfm">Link types for pdftex and dvipdfm</a>, the descriptions of the +<p>See <a href="#Link-types-for-pdftex-and-dvipdfm">Link types for <code>pdftex</code> and <code>dvipdfm</code></a>, the descriptions of the <code>page</code> and <code>filepage</code> links, for an example. </p></dd> </dl> @@ -6515,23 +6156,20 @@ of the parent box is used (this is the default for all dimension options). </p> <dl compact="compact"> -<dt><code>depth</code></dt> -<dd><span id="index-depth-_0028hyperlink-option_0029"></span> -<span id="index-hyperlink-dimensions"></span> +<dt id='index-depth-_0028hyperlink-option_0029'><span><code>depth</code><a href='#index-depth-_0028hyperlink-option_0029' class='copiable-anchor'> ¶</a></span></dt> +<dd><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><span id="index-height-_0028hyperlink-option_0029"></span> -<span id="index-hyperlink-dimensions-1"></span> +<dt id='index-height-_0028hyperlink-option_0029'><span><code>height</code><a href='#index-height-_0028hyperlink-option_0029' class='copiable-anchor'> ¶</a></span></dt> +<dd><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><span id="index-width-_0028hyperlink-option_0029"></span> -<span id="index-hyperlink-dimensions-2"></span> +<dt id='index-width-_0028hyperlink-option_0029'><span><code>width</code><a href='#index-width-_0028hyperlink-option_0029' class='copiable-anchor'> ¶</a></span></dt> +<dd><span id="index-hyperlink-dimensions-2"></span> <span id="index-dimensions_002c-hyperlink-2"></span> <p>Width of the link. </p> @@ -6546,9 +6184,12 @@ options). <hr> -<span id="Hyperlink-driver-nolinks"></span><div class="header"> +</div> +</div> +<div class="subsection" id="Hyperlink-driver-nolinks"> +<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> +Previous: <a href="#Hyperlink-drivers-pdftex-and-dvipdfm" accesskey="p" rel="prev">Hyperlink drivers <code>pdftex</code> and <code>dvipdfm</code></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> <span id="Hyperlink-driver-nolinks-1"></span><h4 class="subsection">5.4.4 Hyperlink driver <code>nolinks</code></h4> @@ -6611,7 +6252,7 @@ again cause the typesetting to be inconsistent with that with destinations enabled. Here again, the <code>nolinks</code> driver helps by defining <code>\hldest</code> to produce the empty boxes. </p> -<p>So, if you are planning to produce versions of your <acronym>PDF</acronym> +<p>So, if you are planning to produce versions of your PDF document both with and without hyperlinks, here is the recommended way to enable the hyperlinks under pdfTeX: </p> @@ -6626,7 +6267,10 @@ to enable the hyperlinks under pdfTeX: <hr> -<span id="Setting-hyperlink-types-and-options"></span><div class="header"> +</div> +</div> +<div class="section" id="Setting-hyperlink-types-and-options"> +<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> @@ -6668,18 +6312,16 @@ you want to set an option temporarily, you can do so inside a <code>\begingroup…\endgroup</code> block; when the group ends, the 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"> -</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"> -</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"> -</td></tr> -</table> +<ul class="section-toc"> +<li><a href="#Setting-default-types-and-options" accesskey="1">Setting default types and options</a></li> +<li><a href="#Setting-group-types" accesskey="2">Setting group types</a></li> +<li><a href="#Setting-group-options" accesskey="3">Setting group options</a></li> +</ul> <hr> -<span id="Setting-default-types-and-options"></span><div class="header"> +<div class="subsection" id="Setting-default-types-and-options"> +<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> @@ -6735,7 +6377,9 @@ option <code>bwidth</code>; see <a href="#Hyperlink-drivers">Hyperlink drivers</ <hr> -<span id="Setting-group-types"></span><div class="header"> +</div> +<div class="subsection" id="Setting-group-types"> +<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> @@ -6796,7 +6440,9 @@ as well as the default destination type. </p> <hr> -<span id="Setting-group-options"></span><div class="header"> +</div> +<div class="subsection" id="Setting-group-options"> +<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> @@ -6890,7 +6536,10 @@ appear in displayed math. </p> <hr> -<span id="Turning-hyperlinks-on_002foff"></span><div class="header"> +</div> +</div> +<div class="section" id="Turning-hyperlinks-on_002foff"> +<div class="header"> <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> @@ -6908,16 +6557,15 @@ want to enable or disable links/destinations temporarily, you can do so inside a <code>\begingroup…\endgroup</code> block; when the group ends, the 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"> -</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"> -</td></tr> -</table> +<ul class="section-toc"> +<li><a href="#Turning-low_002dlevel-commands-on_002foff" accesskey="1">Turning low-level commands on/off</a></li> +<li><a href="#Turning-hyperlinks-on_002foff-for-a-group" accesskey="2">Turning hyperlinks on/off for a group</a></li> +</ul> <hr> -<span id="Turning-low_002dlevel-commands-on_002foff"></span><div class="header"> +<div class="subsection" id="Turning-low_002dlevel-commands-on_002foff"> +<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> @@ -6937,12 +6585,14 @@ Next: <a href="#Turning-hyperlinks-on_002foff-for-a-group" accesskey="n" rel="ne \hloff </pre></div> -<p>See <a href="#Hyperlink-driver-nolinks">Hyperlink driver nolinks</a>, for the implications of using +<p>See <a href="#Hyperlink-driver-nolinks">Hyperlink driver <code>nolinks</code></a>, for the implications of using these commands to disable hyperlinks for the entire document. </p> <hr> -<span id="Turning-hyperlinks-on_002foff-for-a-group"></span><div class="header"> +</div> +<div class="subsection" id="Turning-hyperlinks-on_002foff-for-a-group"> +<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> @@ -6981,7 +6631,10 @@ 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"> +</div> +</div> +<div class="section" id="Making-PDF-outlines"> +<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> @@ -7084,9 +6737,12 @@ and subsection given above in the outlines. <hr> -<span id="Arrow-theoretic-diagrams"></span><div class="header"> +</div> +</div> +<div class="chapter" id="Arrow-theoretic-diagrams"> +<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> +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">Eplain</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="Arrow-theoretic-diagrams-1"></span><h2 class="chapter">6 Arrow theoretic diagrams</h2> @@ -7094,15 +6750,14 @@ Next: <a href="#Programming-definitions" accesskey="n" rel="next">Programming de </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"> -</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"> -</td></tr> -</table> +<ul class="section-toc"> +<li><a href="#Slanted-lines-and-vectors" accesskey="1">Slanted lines and vectors</a></li> +<li><a href="#Commutative-diagrams" accesskey="2">Commutative diagrams</a></li> +</ul> <hr> -<span id="Slanted-lines-and-vectors"></span><div class="header"> +<div class="section" id="Slanted-lines-and-vectors"> +<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> @@ -7153,7 +6808,9 @@ dotted vectors of various directions. </p> <hr> -<span id="Commutative-diagrams"></span><div class="header"> +</div> +<div class="section" id="Commutative-diagrams"> +<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> @@ -7167,17 +6824,15 @@ macros to facilitate typesetting arrows and morphisms, and (2) macros to 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"> -</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"> -</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"> -</td></tr> -</table> +<ul class="section-toc"> +<li><a href="#Arrows-and-morphisms" accesskey="1">Arrows and morphisms</a></li> +<li><a href="#Construction-of-commutative-diagrams" accesskey="2">Construction of commutative diagrams</a></li> +<li><a href="#Commutative-diagram-parameters" accesskey="3">Commutative diagram parameters</a></li> +</ul> <hr> -<span id="Arrows-and-morphisms"></span><div class="header"> +<div class="subsection" id="Arrows-and-morphisms"> +<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> @@ -7263,46 +6918,38 @@ adjoint arrows. The following macros produce horizontal maps and have the same syntax as <code>\mapright</code>: </p> <dl compact="compact"> -<dt><code>\mapright</code></dt> -<dd><span id="index-mapright-1"></span> -<p><code>$X\mapright Y$</code> +<dt id='index-mapright-1'><span><code>\mapright</code><a href='#index-mapright-1' class='copiable-anchor'> ¶</a></span></dt> +<dd><p><code>$X\mapright Y$</code> = (a right arrow). </p> </dd> -<dt><code>\mapleft</code></dt> -<dd><span id="index-mapleft-1"></span> -<p><code>$X\mapleft Y$</code> +<dt id='index-mapleft-1'><span><code>\mapleft</code><a href='#index-mapleft-1' class='copiable-anchor'> ¶</a></span></dt> +<dd><p><code>$X\mapleft Y$</code> </p> </dd> -<dt><code>\hline</code></dt> -<dd><span id="index-hline"></span> -<p><code>$X\hline Y$</code> +<dt id='index-hline'><span><code>\hline</code><a href='#index-hline' class='copiable-anchor'> ¶</a></span></dt> +<dd><p><code>$X\hline Y$</code> </p> </dd> -<dt><code>\bimapright</code></dt> -<dd><span id="index-bimapright"></span> -<p><code>$X\bimapright Y$</code> +<dt id='index-bimapright'><span><code>\bimapright</code><a href='#index-bimapright' class='copiable-anchor'> ¶</a></span></dt> +<dd><p><code>$X\bimapright Y$</code> </p> </dd> -<dt><code>\bimapleft</code></dt> -<dd><span id="index-bimapleft"></span> -<p><code>$X\bimapleft Y$</code> +<dt id='index-bimapleft'><span><code>\bimapleft</code><a href='#index-bimapleft' class='copiable-anchor'> ¶</a></span></dt> +<dd><p><code>$X\bimapleft Y$</code> </p> </dd> -<dt><code>\adjmapright</code></dt> -<dd><span id="index-adjmapright"></span> -<p><code>$X\adjmapright Y$</code> +<dt id='index-adjmapright'><span><code>\adjmapright</code><a href='#index-adjmapright' class='copiable-anchor'> ¶</a></span></dt> +<dd><p><code>$X\adjmapright Y$</code> </p> </dd> -<dt><code>\adjmapleft</code></dt> -<dd><span id="index-adjmapleft"></span> -<p><code>$X\adjmapleft Y$</code> +<dt id='index-adjmapleft'><span><code>\adjmapleft</code><a href='#index-adjmapleft' class='copiable-anchor'> ¶</a></span></dt> +<dd><p><code>$X\adjmapleft Y$</code> </p> </dd> -<dt><code>\bihline</code></dt> -<dd><span id="index-bihline"></span> -<p><code>$X\bihline Y$</code> +<dt id='index-bihline'><span><code>\bihline</code><a href='#index-bihline' class='copiable-anchor'> ¶</a></span></dt> +<dd><p><code>$X\bihline Y$</code> </p></dd> </dl> @@ -7311,45 +6958,37 @@ adjoint arrows. The following macros produce vertical maps and have the same syntax as <code>\mapdown</code>: </p> <dl compact="compact"> -<dt><code>\mapdown</code></dt> -<dd><span id="index-mapdown-1"></span> -<p>(a down arrow) +<dt id='index-mapdown-1'><span><code>\mapdown</code><a href='#index-mapdown-1' class='copiable-anchor'> ¶</a></span></dt> +<dd><p>(a down arrow) </p> </dd> -<dt><code>\mapup</code></dt> -<dd><span id="index-mapup-1"></span> -<p>(an up arrow) +<dt id='index-mapup-1'><span><code>\mapup</code><a href='#index-mapup-1' class='copiable-anchor'> ¶</a></span></dt> +<dd><p>(an up arrow) </p> </dd> -<dt><code>\vline</code></dt> -<dd><span id="index-vline"></span> -<p>(vertical line) +<dt id='index-vline'><span><code>\vline</code><a href='#index-vline' class='copiable-anchor'> ¶</a></span></dt> +<dd><p>(vertical line) </p> </dd> -<dt><code>\bimapdown</code></dt> -<dd><span id="index-bimapdown"></span> -<p>(two down arrows) +<dt id='index-bimapdown'><span><code>\bimapdown</code><a href='#index-bimapdown' class='copiable-anchor'> ¶</a></span></dt> +<dd><p>(two down arrows) </p> </dd> -<dt><code>\bimapup</code></dt> -<dd><span id="index-bimapup"></span> -<p>(two up arrows) +<dt id='index-bimapup'><span><code>\bimapup</code><a href='#index-bimapup' class='copiable-anchor'> ¶</a></span></dt> +<dd><p>(two up arrows) </p> </dd> -<dt><code>\adjmapdown</code></dt> -<dd><span id="index-adjmapdown"></span> -<p>(two adjoint arrows; down then up) +<dt id='index-adjmapdown'><span><code>\adjmapdown</code><a href='#index-adjmapdown' class='copiable-anchor'> ¶</a></span></dt> +<dd><p>(two adjoint arrows; down then up) </p> </dd> -<dt><code>\adjmapup</code></dt> -<dd><span id="index-adjmapup"></span> -<p>(two adjoint arrows; up then down) +<dt id='index-adjmapup'><span><code>\adjmapup</code><a href='#index-adjmapup' class='copiable-anchor'> ¶</a></span></dt> +<dd><p>(two adjoint arrows; up then down) </p> </dd> -<dt><code>\bivline</code></dt> -<dd><span id="index-bivline"></span> -<p>(two vertical lines) +<dt id='index-bivline'><span><code>\bivline</code><a href='#index-bivline' class='copiable-anchor'> ¶</a></span></dt> +<dd><p>(two vertical lines) </p></dd> </dl> @@ -7358,29 +6997,24 @@ and adjoint arrows. The following macros produce slanted maps and have the same syntax as <code>\arrow</code>: </p> <dl compact="compact"> -<dt><code>\arrow</code></dt> -<dd><span id="index-arrow-1"></span> -<p>(a slanted arrow) +<dt id='index-arrow-1'><span><code>\arrow</code><a href='#index-arrow-1' class='copiable-anchor'> ¶</a></span></dt> +<dd><p>(a slanted arrow) </p> </dd> -<dt><code>\sline</code></dt> -<dd><span id="index-sline-1"></span> -<p>(a slanted line) +<dt id='index-sline-1'><span><code>\sline</code><a href='#index-sline-1' class='copiable-anchor'> ¶</a></span></dt> +<dd><p>(a slanted line) </p> </dd> -<dt><code>\biarrow</code></dt> -<dd><span id="index-biarrow"></span> -<p>(two straight arrows) +<dt id='index-biarrow'><span><code>\biarrow</code><a href='#index-biarrow' class='copiable-anchor'> ¶</a></span></dt> +<dd><p>(two straight arrows) </p> </dd> -<dt><code>\adjarrow</code></dt> -<dd><span id="index-adjarrow"></span> -<p>(two adjoint arrows) +<dt id='index-adjarrow'><span><code>\adjarrow</code><a href='#index-adjarrow' class='copiable-anchor'> ¶</a></span></dt> +<dd><p>(two adjoint arrows) </p> </dd> -<dt><code>\bisline</code></dt> -<dd><span id="index-bisline"></span> -<p>(two straight lines) +<dt id='index-bisline'><span><code>\bisline</code><a href='#index-bisline' class='copiable-anchor'> ¶</a></span></dt> +<dd><p>(two straight lines) </p> </dd> </dl> @@ -7405,7 +7039,9 @@ found in, e.g., the Snake Lemma, by employing a version of the </p> <hr> -<span id="Construction-of-commutative-diagrams"></span><div class="header"> +</div> +<div class="subsection" id="Construction-of-commutative-diagrams"> +<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> @@ -7576,7 +7212,9 @@ Many diagrams may be typeset with the predefined macros that appear here; however, ingenuity is often required to handle special cases. </p> <hr> -<span id="Commutative-diagram-parameters"></span><div class="header"> +</div> +<div class="subsection" id="Commutative-diagram-parameters"> +<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> @@ -7587,25 +7225,21 @@ commutative diagram macros. These dimensions may be changed globally or locally. </p> <dl compact="compact"> -<dt><code>\harrowlength</code></dt> -<dd><span id="index-harrowlength-1"></span> -<p>(Default: 60 pt) The length of right or left arrows. +<dt id='index-harrowlength-1'><span><code>\harrowlength</code><a href='#index-harrowlength-1' class='copiable-anchor'> ¶</a></span></dt> +<dd><p>(Default: 60 pt) The length of right or left arrows. </p> </dd> -<dt><code>\varrowlength</code></dt> -<dd><span id="index-varrowlength-1"></span> -<p>(Default: 0.618<code>\harrowlength</code>) The length of up or down +<dt id='index-varrowlength-1'><span><code>\varrowlength</code><a href='#index-varrowlength-1' class='copiable-anchor'> ¶</a></span></dt> +<dd><p>(Default: 0.618<code>\harrowlength</code>) The length of up or down arrows. </p> </dd> -<dt><code>\sarrowlength</code></dt> -<dd><span id="index-sarrowlength-1"></span> -<p>(Default: 60 pt) The horizontal length of slanted arrows. +<dt id='index-sarrowlength-1'><span><code>\sarrowlength</code><a href='#index-sarrowlength-1' class='copiable-anchor'> ¶</a></span></dt> +<dd><p>(Default: 60 pt) The horizontal length of slanted arrows. </p> </dd> -<dt><code>\hmorphposn</code></dt> -<dd><span id="index-hmorphposn-1"></span> -<p>(Default: 0 pt) The horizontal position of the morphism with +<dt id='index-hmorphposn-1'><span><code>\hmorphposn</code><a href='#index-hmorphposn-1' class='copiable-anchor'> ¶</a></span></dt> +<dd><p>(Default: 0 pt) The horizontal position of the morphism with respect to its default position. There are also the dimensions <code>\hmorphposnup</code>, <span id="index-hmorphposnup-1"></span> @@ -7618,9 +7252,8 @@ and <code>\hmorphposnlft</code> for <code>^</code>/<code>_</code> or <code>\lft</code>/<code>\rt</code> constructions. </p> </dd> -<dt><code>\vmorphposn</code></dt> -<dd><span id="index-vmorphposn-1"></span> -<p>(Default: 0 pt) The vertical position of the morphism with +<dt id='index-vmorphposn-1'><span><code>\vmorphposn</code><a href='#index-vmorphposn-1' class='copiable-anchor'> ¶</a></span></dt> +<dd><p>(Default: 0 pt) The vertical position of the morphism with respect to its default position. There are also the dimensions <code>\vmorphposnup</code>, <span id="index-vmorphposnup-1"></span> @@ -7633,41 +7266,35 @@ and <code>\vmorphposnlft</code> for <code>^</code>/<code>_</code> or <code>\lft</code>/<code>\rt</code> constructions. </p> </dd> -<dt><code>\morphdist</code></dt> -<dd><span id="index-morphdist-1"></span> -<p>(Default: 4 pt) The distance of morphisms from slanted lines +<dt id='index-morphdist-1'><span><code>\morphdist</code><a href='#index-morphdist-1' class='copiable-anchor'> ¶</a></span></dt> +<dd><p>(Default: 4 pt) The distance of morphisms from slanted lines or arrows. </p> </dd> -<dt><code>\channelwidth</code></dt> -<dd><span id="index-channelwidth-1"></span> -<p>(Default: 3 pt) The distance between double lines or arrows. +<dt id='index-channelwidth-1'><span><code>\channelwidth</code><a href='#index-channelwidth-1' class='copiable-anchor'> ¶</a></span></dt> +<dd><p>(Default: 3 pt) The distance between double lines or arrows. </p> </dd> -<dt><code>\hchannel, \vchannel</code></dt> -<dd><span id="index-hchannel"></span> -<span id="index-vchannel"></span> +<dt id='index-hchannel'><span><code>\hchannel, \vchannel</code><a href='#index-hchannel' class='copiable-anchor'> ¶</a></span></dt> +<dd><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><span id="index-commdiagbaselines-1"></span> -<p>(Default: <code>\baselineskip=15pt +<dt id='index-commdiagbaselines-1'><span><code>\commdiagbaselines</code><a href='#index-commdiagbaselines-1' class='copiable-anchor'> ¶</a></span></dt> +<dd><p>(Default: <code>\baselineskip=15pt \lineskip=3pt \lineskiplimit=3pt </code>) The parameters used by <code>\commdiag</code> for setting interline glue. </p> </dd> -<dt><code>\hgrid</code></dt> -<dd><span id="index-hgrid-1"></span> -<p>(Default: 15 pt) The horizontal spacing of the grid used by +<dt id='index-hgrid-1'><span><code>\hgrid</code><a href='#index-hgrid-1' class='copiable-anchor'> ¶</a></span></dt> +<dd><p>(Default: 15 pt) The horizontal spacing of the grid used by <code>\gridcommdiag</code>. </p> </dd> -<dt><code>\vgrid</code></dt> -<dd><span id="index-vgrid-1"></span> -<p>(Default: 15 pt) The vertical spacing of the grid used by +<dt id='index-vgrid-1'><span><code>\vgrid</code><a href='#index-vgrid-1' class='copiable-anchor'> ¶</a></span></dt> +<dd><p>(Default: 15 pt) The vertical spacing of the grid used by <code>\gridcommdiag</code>. </p> </dd> @@ -7675,45 +7302,38 @@ The parameters used by <code>\commdiag</code> for setting interline glue. <hr> -<span id="Programming-definitions"></span><div class="header"> +</div> +</div> +</div> +<div class="chapter" id="Programming-definitions"> +<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> +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">Eplain</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="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. -</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. -</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. -</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. -</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. -</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. -</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. -</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’. -</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"> -</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. -</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. -</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"> -</td></tr> -</table> +<ul class="section-toc"> +<li><a href="#Category-codes" accesskey="1">Category codes</a></li> +<li><a href="#Allocation-macros" accesskey="2">Allocation macros</a></li> +<li><a href="#Iteration" accesskey="3">Iteration</a></li> +<li><a href="#Macro-arguments" accesskey="4">Macro arguments</a></li> +<li><a href="#Converting-to-characters" accesskey="5">Converting to characters</a></li> +<li><a href="#Expansion" accesskey="6">Expansion</a></li> +<li><a href="#Obeying-spaces" accesskey="7">Obeying spaces</a></li> +<li><a href="#Writing-out-numbers" accesskey="8">Writing out numbers</a></li> +<li><a href="#Mode_002dspecific-penalties" accesskey="9">Mode-specific penalties</a></li> +<li><a href="#Auxiliary-files">Auxiliary files</a></li> +<li><a href="#User_002ddefined-environments">User-defined environments</a></li> +<li><a href="#Page-list-and-page-range-parsers">Page list and page range parsers</a></li> +</ul> <hr> -<span id="Category-codes"></span><div class="header"> +<div class="section" id="Category-codes"> +<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> @@ -7811,7 +7431,9 @@ expand similarly. </p> <hr> -<span id="Allocation-macros"></span><div class="header"> +</div> +<div class="section" id="Allocation-macros"> +<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> @@ -7894,8 +7516,50 @@ example, these two calls are equivalent: </pre></div> +<ul class="section-toc"> +<li><a href="#Scratch-registers" accesskey="1">Scratch registers</a></li> +</ul> +<hr> +<div class="subsection" id="Scratch-registers"> +<div class="header"> +<p> +Up: <a href="#Allocation-macros" accesskey="u" rel="up">Allocation macros</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="Scratch-registers-1"></span><h4 class="subsection">7.2.1 Scratch registers</h4> + +<span id="index-scratch-registers"></span> +<span id="index-registers_002c-scratch"></span> + +<p>It seems worth reiterating here the conventions for scratch registers +defined by Knuth for plain TeX, which Eplain inherits and does not +change. +</p> +<ul> +<li> Registers numbered 0 to 9, and 255, are free for any use. Thus their +values must be assumed to be clobbered whenever another macro might +get control. Eplain macros do use the scratch registers. + +</li><li> First exception: the <code>\count</code> registers <code>0..9</code> are +used internally by TeX for page numbering and thus are not +available for any other use. + +</li><li> Second exception: the <code>\box255</code> register is likewise internally +by TeX, to ship out pages. So it’s not available either. + +</li><li> By convention, all assignments to the scratch registers 1, 3, 5, 7, +and 9 should be <code>\global</code>, and assignments to the others should +be non-<code>\global</code>. + +</li></ul> + +<p>For more details on all aspects of register usage, see <cite>The +TeXbook</cite> or any other plain TeX reference. +</p> <hr> -<span id="Iteration"></span><div class="header"> +</div> +</div> +<div class="section" id="Iteration"> +<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> @@ -7991,7 +7655,9 @@ Victor Eijkhout’s </p> <hr> -<span id="Macro-arguments"></span><div class="header"> +</div> +<div class="section" id="Macro-arguments"> +<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> @@ -8101,7 +7767,9 @@ end of the first for the end of the second. </p> <hr> -<span id="Converting-to-characters"></span><div class="header"> +</div> +<div class="section" id="Converting-to-characters"> +<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> @@ -8150,7 +7818,9 @@ has given. <hr> -<span id="Expansion"></span><div class="header"> +</div> +<div class="section" id="Expansion"> +<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> @@ -8158,32 +7828,24 @@ Next: <a href="#Obeying-spaces" accesskey="n" rel="next">Obeying spaces</a>, Pre <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. -</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"> -</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. -</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. -</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"> -</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"> -</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"> -</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"> -</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"> -</td></tr> -</table> +<ul class="section-toc"> +<li><a href="#g_t_005ccsn-and-_005cece" accesskey="1"><code>\csn</code> and <code>\ece</code></a></li> +<li><a href="#g_t_005cedefappend" accesskey="2"><code>\edefappend</code></a></li> +<li><a href="#Hooks" accesskey="3">Hooks</a></li> +<li><a href="#Properties" accesskey="4">Properties</a></li> +<li><a href="#g_t_005cexpandonce" accesskey="5"><code>\expandonce</code></a></li> +<li><a href="#g_t_005cifundefined" accesskey="6"><code>\ifundefined</code></a></li> +<li><a href="#g_t_005cifempty" accesskey="7"><code>\ifempty</code></a></li> +<li><a href="#g_t_005cifinteger-and-_005cisinteger" accesskey="8"><code>\ifinteger</code> and <code>\isinteger</code></a></li> +<li><a href="#g_t_005cfuturenonspacelet" accesskey="9"><code>\futurenonspacelet</code></a></li> +</ul> <hr> -<span id="g_t_005ccsn-and-_005cece"></span><div class="header"> +<div class="subsection" id="g_t_005ccsn-and-_005cece"> +<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> +Next: <a href="#g_t_005cedefappend" accesskey="n" rel="next"><code>\edefappend</code></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> <span id="g_t_005ccsn-and-_005cece-1"></span><h4 class="subsection">7.6.1 <code>\csn</code> and <code>\ece</code></h4> @@ -8211,9 +7873,11 @@ does take some time, though, so I don’t recommend it for an inner loop. </p> <hr> -<span id="g_t_005cedefappend"></span><div class="header"> +</div> +<div class="subsection" id="g_t_005cedefappend"> +<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> +Next: <a href="#Hooks" accesskey="n" rel="next">Hooks</a>, Previous: <a href="#g_t_005ccsn-and-_005cece" accesskey="p" rel="prev"><code>\csn</code> and <code>\ece</code></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> <span id="g_t_005cedefappend-1"></span><h4 class="subsection">7.6.2 <code>\edefappend</code></h4> @@ -8235,9 +7899,11 @@ fully expanded (in the <code>\edef</code> that redefines the control sequence). </p> <hr> -<span id="Hooks"></span><div class="header"> +</div> +<div class="subsection" id="Hooks"> +<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> +Next: <a href="#Properties" accesskey="n" rel="next">Properties</a>, Previous: <a href="#g_t_005cedefappend" accesskey="p" rel="prev"><code>\edefappend</code></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> <span id="Hooks-1"></span><h4 class="subsection">7.6.3 Hooks</h4> @@ -8255,20 +7921,20 @@ take two arguments: the name of the hook and the new actions. <dd> <span id="index-hookaction"></span> </dd> -<dt><code>hookaction <var>name</var> <var>actions</var></code></dt> +<dt><span><code>hookaction <var>name</var> <var>actions</var></code></span></dt> <dd><span id="index-hookappend"></span> </dd> -<dt><code>hookappend <var>name</var> <var>actions</var></code></dt> +<dt><span><code>hookappend <var>name</var> <var>actions</var></code></span></dt> <dd><span id="index-hookprepend"></span> </dd> -<dt><code>hookprepend <var>name</var> <var>actions</var></code></dt> +<dt><span><code>hookprepend <var>name</var> <var>actions</var></code></span></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> <span id="index-hookactiononce"></span> </dd> -<dt><code>hookactiononce <var>name</var> <code>\<var>cs</var></code></code></dt> +<dt><span><code>hookactiononce <var>name</var> <code>\<var>cs</var></code></code></span></dt> <dd><p><code>\hookactiononce</code> adds <var>cs</var> to <var>name</var>, like the macros above, but first it adds </p> @@ -8309,9 +7975,11 @@ other actions (as long as the other actions use <code>\hookprepend</code> and <hr> -<span id="Properties"></span><div class="header"> +</div> +<div class="subsection" id="Properties"> +<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> +Next: <a href="#g_t_005cexpandonce" accesskey="n" rel="next"><code>\expandonce</code></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> <span id="Properties-1"></span><h4 class="subsection">7.6.4 Properties</h4> @@ -8328,14 +7996,14 @@ control sequence names. <dd> <span id="index-setproperty"></span> </dd> -<dt><code>\setproperty <var>atom</var> <var>propname</var> <var>value</var></code></dt> +<dt><span><code>\setproperty <var>atom</var> <var>propname</var> <var>value</var></code></span></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> <span id="index-getproperty"></span> </dd> -<dt><code>\getproperty <var>atom</var> <var>propname</var></code></dt> +<dt><span><code>\getproperty <var>atom</var> <var>propname</var></code></span></dt> <dd><p><code>\getproperty</code> expands to the value stored for <var>propname</var> on <var>atom</var>. If <var>propname</var> is undefined, it expands to nothing (i.e., <code>\empty</code>). @@ -8357,9 +8025,11 @@ conceptual. <hr> -<span id="g_t_005cexpandonce"></span><div class="header"> +</div> +<div class="subsection" id="g_t_005cexpandonce"> +<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> +Next: <a href="#g_t_005cifundefined" accesskey="n" rel="next"><code>\ifundefined</code></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> <span id="g_t_005cexpandonce-1"></span><h4 class="subsection">7.6.5 <code>\expandonce</code></h4> @@ -8380,9 +8050,11 @@ TeX primitives. This is most useful in an <code>\edef</code>. <hr> -<span id="g_t_005cifundefined"></span><div class="header"> +</div> +<div class="subsection" id="g_t_005cifundefined"> +<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> +Next: <a href="#g_t_005cifempty" accesskey="n" rel="next"><code>\ifempty</code></a>, Previous: <a href="#g_t_005cexpandonce" accesskey="p" rel="prev"><code>\expandonce</code></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> <span id="g_t_005cifundefined-1"></span><h4 class="subsection">7.6.6 <code>\ifundefined</code></h4> @@ -8402,9 +8074,11 @@ within another conditional—TeX can’t match up the <code>\if</code>&r </p> <hr> -<span id="g_t_005cifempty"></span><div class="header"> +</div> +<div class="subsection" id="g_t_005cifempty"> +<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> +Next: <a href="#g_t_005cifinteger-and-_005cisinteger" accesskey="n" rel="next"><code>\ifinteger</code> and <code>\isinteger</code></a>, Previous: <a href="#g_t_005cifundefined" accesskey="p" rel="prev"><code>\ifundefined</code></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> <span id="g_t_005cifempty-1"></span><h4 class="subsection">7.6.7 <code>\ifempty</code></h4> @@ -8437,9 +8111,11 @@ within another conditional—TeX can’t match up the <code>\if</code>&r </p> <hr> -<span id="g_t_005cifinteger-and-_005cisinteger"></span><div class="header"> +</div> +<div class="subsection" id="g_t_005cifinteger-and-_005cisinteger"> +<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> +Next: <a href="#g_t_005cfuturenonspacelet" accesskey="n" rel="next"><code>\futurenonspacelet</code></a>, Previous: <a href="#g_t_005cifempty" accesskey="p" rel="prev"><code>\ifempty</code></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> <span id="g_t_005cifinteger-and-_005cisinteger-1"></span><h4 class="subsection">7.6.8 <code>\ifinteger</code> and <code>\isinteger</code></h4> @@ -8477,13 +8153,15 @@ even compile outside math mode). </p> <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>). +(<a href="https://texfaq.org">https://texfaq.org</a>). </p> <hr> -<span id="g_t_005cfuturenonspacelet"></span><div class="header"> +</div> +<div class="subsection" id="g_t_005cfuturenonspacelet"> +<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> +Previous: <a href="#g_t_005cifinteger-and-_005cisinteger" accesskey="p" rel="prev"><code>\ifinteger</code> and <code>\isinteger</code></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> <span id="g_t_005cfuturenonspacelet-1"></span><h4 class="subsection">7.6.9 <code>\futurenonspacelet</code></h4> @@ -8504,7 +8182,10 @@ first, and then expands the second. For example: <hr> -<span id="Obeying-spaces"></span><div class="header"> +</div> +</div> +<div class="section" id="Obeying-spaces"> +<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> @@ -8539,7 +8220,9 @@ program like <i>expand</i> instead.) </p> <hr> -<span id="Writing-out-numbers"></span><div class="header"> +</div> +<div class="section" id="Writing-out-numbers"> +<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> @@ -8553,7 +8236,9 @@ produces the written-out form of its argument, i.e., ‘zero’ through </p> <hr> -<span id="Mode_002dspecific-penalties"></span><div class="header"> +</div> +<div class="section" id="Mode_002dspecific-penalties"> +<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> @@ -8575,7 +8260,9 @@ math mode.) </p> <hr> -<span id="Auxiliary-files"></span><div class="header"> +</div> +<div class="section" id="Auxiliary-files"> +<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> @@ -8614,7 +8301,9 @@ name. For example, if you want to test for the file <hr> -<span id="User_002ddefined-environments"></span><div class="header"> +</div> +<div class="section" id="User_002ddefined-environments"> +<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> @@ -8658,7 +8347,9 @@ environment that should not be nested. </p> <hr> -<span id="Page-list-and-page-range-parsers"></span><div class="header"> +</div> +<div class="section" id="Page-list-and-page-range-parsers"> +<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> @@ -8726,9 +8417,12 @@ 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> -<span id="Demo-files"></span><div class="header"> +</div> +</div> +<div class="chapter" id="Demo-files"> +<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> +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">Eplain</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="Demo-files-1"></span><h2 class="chapter">8 Demo files</h2> @@ -8739,18 +8433,17 @@ 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="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"> -</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"> -</td></tr> -</table> +<ul class="section-toc"> +<li><a href="#Hyperlinks-_0028xhyper_002etex_0029" accesskey="1">Hyperlinks (<code>xhyper.tex</code>)</a></li> +<li><a href="#Highlighting-TeX-comments-in-listings-_0028lscommnt_002etex_0029" accesskey="2">Highlighting TeX comments in listings (<code>lscommnt.tex</code>)</a></li> +</ul> <hr> -<span id="Hyperlinks-_0028xhyper_002etex_0029"></span><div class="header"> +<div class="section" id="Hyperlinks-_0028xhyper_002etex_0029"> +<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> +Next: <a href="#Highlighting-TeX-comments-in-listings-_0028lscommnt_002etex_0029" accesskey="n" rel="next">Highlighting TeX comments in listings (<code>lscommnt.tex</code>)</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> <span id="Hyperlinks-_0028xhyper_002etex_0029-1"></span><h3 class="section">8.1 Hyperlinks (<code>xhyper.tex</code>)</h3> @@ -8799,7 +8492,8 @@ Next: <a href="#Highlighting-TeX-comments-in-listings-_0028lscommnt_002etex_0029 <span id="index-rotatebox"></span> <span id="index-definecolor"></span> <span id="index-url"></span> -<pre class="verbatim">% (This file is public domain.) +<pre class="verbatim">% $Id: xhyper.tex 60 2022-10-05 22:42:54Z karl $ +% (This file is public domain.) % % This file demonstrates the following features of Eplain: % @@ -8811,7 +8505,7 @@ Next: <a href="#Highlighting-TeX-comments-in-listings-_0028lscommnt_002etex_0029 % % The compiled demo can be downloaded from % -% http://tug.org/eplain/demo +% https://tug.org/eplain/demo % % In order to compile this file yourself, you will need the CTAN lion % drawing by Duane Bibby from @@ -8971,7 +8665,7 @@ Show me % |url.sty|. Remember that we have customized the color of |url| % hyperlinks, so this one will show up with a different color than the % default dark-red. -Take me to \url{http://tug.org/eplain}. +Take me to \url{https://tug.org/eplain}. % The second approach is to create an explicit URL link. We specify % yet another border highlighting mode, |P|, which means that the @@ -8985,16 +8679,18 @@ Take me to \url{http://tug.org/eplain}. \definecolor{mycolor}{rgb}{0.4,0.1,0.4} Take me to -\hlstart{url}{hlight=P,colormodel=,color=mycolor}{http://tug.org/eplain} +\hlstart{url}{hlight=P,colormodel=,color=mycolor}{https://tug.org/eplain} Eplain homepage\hlend. \bye </pre> <hr> -<span id="Highlighting-TeX-comments-in-listings-_0028lscommnt_002etex_0029"></span><div class="header"> +</div> +<div class="section" id="Highlighting-TeX-comments-in-listings-_0028lscommnt_002etex_0029"> +<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> +Previous: <a href="#Hyperlinks-_0028xhyper_002etex_0029" accesskey="p" rel="prev">Hyperlinks (<code>xhyper.tex</code>)</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> <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> @@ -9063,9 +8759,12 @@ Previous: <a href="#Hyperlinks-_0028xhyper_002etex_0029" accesskey="p" rel="prev \bye </pre> <hr> -<span id="Macro-index"></span><div class="header"> +</div> +</div> +<div class="unnumbered" id="Macro-index"> +<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> +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">Eplain</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="Macro-index-1"></span><h2 class="unnumbered">Macro index</h2> @@ -9605,7 +9304,6 @@ Next: <a href="#Concept-index" accesskey="n" rel="next">Concept index</a>, Previ <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> <tr><td></td><td valign="top"><a href="#index-phantomeqlabel"><code>phantomeqlabel</code></a>:</td><td> </td><td valign="top"><a href="#Equation-reference-hyperlinks">Equation reference hyperlinks</a></td></tr> @@ -9834,9 +9532,11 @@ Next: <a href="#Concept-index" accesskey="n" rel="next">Concept index</a>, Previ </td></tr></table> <hr> -<span id="Concept-index"></span><div class="header"> +</div> +<div class="unnumbered" id="Concept-index"> +<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> +Previous: <a href="#Macro-index" accesskey="p" rel="prev">Macro index</a>, Up: <a href="#Top" accesskey="u" rel="up">Eplain</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="Concept-index-1"></span><h2 class="unnumbered">Concept index</h2> @@ -10089,8 +9789,8 @@ Previous: <a href="#Macro-index" accesskey="p" rel="prev">Macro index</a>, Up: < <tr><td></td><td valign="top"><a href="#index-destinations_002c-numbered">destinations, numbered</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-destinations_002c-page">destinations, page</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-destinations_002c-raising">destinations, raising</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-destinations_002c-URL">destinations, <acronym>URL</acronym></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-destinations_002c-URL-1">destinations, <acronym>URL</acronym></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-destinations_002c-url">destinations, url</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-destinations_002c-url-1">destinations, url</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-detecting-numbers">detecting 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-diagnostics">diagnostics</a>:</td><td> </td><td valign="top"><a href="#Diagnostics">Diagnostics</a></td></tr> <tr><td></td><td valign="top"><a href="#index-Diagram_002c-macros-for-LaTeX">Diagram, macros for LaTeX</a>:</td><td> </td><td valign="top"><a href="#Construction-of-commutative-diagrams">Construction of commutative diagrams</a></td></tr> @@ -10142,6 +9842,7 @@ Previous: <a href="#Macro-index" accesskey="p" rel="prev">Macro index</a>, Up: < <tr><td></td><td valign="top"><a href="#index-empty-string_002c-checking-for">empty string, checking for</a>:</td><td> </td><td valign="top"><a href="#g_t_005cifempty">\ifempty</a></td></tr> <tr><td></td><td valign="top"><a href="#index-Encapsulated-PostScript">Encapsulated PostScript</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-Encapsulated-PostScript-1">Encapsulated PostScript</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-engines_002c-testing-for">engines, testing for</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-environments_002c-user_002ddefined">environments, user-defined</a>:</td><td> </td><td valign="top"><a href="#User_002ddefined-environments">User-defined environments</a></td></tr> <tr><td></td><td valign="top"><a href="#index-Eplain_002c-installing">Eplain, installing</a>:</td><td> </td><td valign="top"><a href="#Installation">Installation</a></td></tr> <tr><td></td><td valign="top"><a href="#index-Eplain_002c-invoking">Eplain, invoking</a>:</td><td> </td><td valign="top"><a href="#Invoking-Eplain">Invoking Eplain</a></td></tr> @@ -10149,8 +9850,8 @@ Previous: <a href="#Macro-index" accesskey="p" rel="prev">Macro index</a>, Up: < <tr><td></td><td valign="top"><a href="#index-Eplain_002c-upgrading">Eplain, upgrading</a>:</td><td> </td><td valign="top"><a href="#Installation">Installation</a></td></tr> <tr><td></td><td valign="top"><a href="#index-eplain_002eaux"><code>eplain.aux</code></a>:</td><td> </td><td valign="top"><a href="#Installation">Installation</a></td></tr> <tr><td></td><td valign="top"><a href="#index-eplain_002efmt"><code>eplain.fmt</code></a>:</td><td> </td><td valign="top"><a href="#Installation">Installation</a></td></tr> -<tr><td></td><td valign="top"><a href="#index-EPS"><acronym>EPS</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-EPS-1"><acronym>EPS</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-EPS">EPS</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-EPS-1">EPS</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-epstopdf"><code>epstopdf</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-epstopdf_002esty"><code>epstopdf.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-equation-labels_002c-characters-valid-in">equation labels, characters valid in</a>:</td><td> </td><td valign="top"><a href="#Equation-references">Equation references</a></td></tr> @@ -10315,10 +10016,10 @@ Previous: <a href="#Macro-index" accesskey="p" rel="prev">Macro index</a>, Up: < <tr><td></td><td valign="top"><a href="#index-hyperlinks_002c-to-another-file">hyperlinks, to another file</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-hyperlinks_002c-to-another-file-1">hyperlinks, to another file</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-hyperlinks_002c-to-another-file-2">hyperlinks, to another file</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-hyperlinks_002c-URL">hyperlinks, <acronym>URL</acronym></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-hyperlinks_002c-URL-1">hyperlinks, <acronym>URL</acronym></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-hyperlinks_002c-URL-2">hyperlinks, <acronym>URL</acronym></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-hyperlinks_002c-URL-3">hyperlinks, <acronym>URL</acronym></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-hyperlinks_002c-url">hyperlinks, url</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-hyperlinks_002c-url-1">hyperlinks, url</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-hyperlinks_002c-url-2">hyperlinks, url</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-hyperlinks_002c-url-3">hyperlinks, url</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-hyperref_002esty"><code>hyperref.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-hypertex_002c-destination-options"><code>hypertex</code>, destination options</a>:</td><td> </td><td valign="top"><a href="#Destination-options-for-hypertex">Destination options for hypertex</a></td></tr> <tr><td></td><td valign="top"><a href="#index-hypertex_002c-destination-types"><code>hypertex</code>, destination types</a>:</td><td> </td><td valign="top"><a href="#Destination-types-for-hypertex">Destination types for hypertex</a></td></tr> @@ -10330,7 +10031,7 @@ Previous: <a href="#Macro-index" accesskey="p" rel="prev">Macro index</a>, Up: < <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-iftex_002esty"><code>iftex.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> @@ -10491,11 +10192,11 @@ Previous: <a href="#Macro-index" accesskey="p" rel="prev">Macro index</a>, Up: < <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 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> <tr><td></td><td valign="top"><a href="#index-omitting-typesetting-of-graphics">omitting typesetting of 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-open-boxes">open boxes</a>:</td><td> </td><td valign="top"><a href="#Boxes">Boxes</a></td></tr> +<tr><td></td><td valign="top"><a href="#index-OpTeX">OpTeX</a>:</td><td> </td><td valign="top"><a href="#Introduction">Introduction</a></td></tr> <tr><td></td><td valign="top"><a href="#index-option-list_002c-group">option list, group</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-option-list_002c-preserving-for-group">option list, preserving for group</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-options_002c-destination_002c-common">options, destination, common</a>:</td><td> </td><td valign="top"><a href="#Options-supported-by-all-drivers">Options supported by all drivers</a></td></tr> @@ -10525,12 +10226,11 @@ Previous: <a href="#Macro-index" accesskey="p" rel="prev">Macro index</a>, Up: < <tr><td></td><td valign="top"><a href="#index-Patashnik_002c-Oren">Patashnik, Oren</a>:</td><td> </td><td valign="top"><a href="#Citations">Citations</a></td></tr> <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">PDF</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-PDF-output">PDF 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> -<tr><td></td><td valign="top"><a href="#index-pdftex-2"><code>pdftex</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-pdftex-1"><code>pdftex</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-pdftex_002c-destination-options"><code>pdftex</code>, destination options</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-pdftex_002c-destination-types"><code>pdftex</code>, destination types</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-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> @@ -10567,6 +10267,7 @@ Previous: <a href="#Macro-index" accesskey="p" rel="prev">Macro index</a>, Up: < <tr><td></td><td valign="top"><a href="#index-references_002c-defining-general-1">references, defining general</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-references_002c-numbered">references, numbered</a>:</td><td> </td><td valign="top"><a href="#Citations">Citations</a></td></tr> <tr><td></td><td valign="top"><a href="#index-register-allocation">register allocation</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-registers_002c-scratch">registers, scratch</a>:</td><td> </td><td valign="top"><a href="#Scratch-registers">Scratch registers</a></td></tr> <tr><td></td><td valign="top"><a href="#index-restoring-_005cinput_002c-LaTeX-packages">restoring <code>\input</code>, LaTeX packages</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-return-character">return 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-right_002djustification">right-justification</a>:</td><td> </td><td valign="top"><a href="#Justification">Justification</a></td></tr> @@ -10579,6 +10280,7 @@ Previous: <a href="#Macro-index" accesskey="p" rel="prev">Macro index</a>, Up: < <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-scratch-registers">scratch registers</a>:</td><td> </td><td valign="top"><a href="#Scratch-registers">Scratch registers</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> <tr><td></td><td valign="top"><a href="#index-see-also-index-entries-and-hyperlinks">see also index entries and hyperlinks</a>:</td><td> </td><td valign="top"><a href="#Hyperlinks-in-see-and-see-also-entries">Hyperlinks in see and see also entries</a></td></tr> <tr><td></td><td valign="top"><a href="#index-see-also-index-entries-and-sorting">see also index entries and sorting</a>:</td><td> </td><td valign="top"><a href="#Customizing-indexing">Customizing indexing</a></td></tr> @@ -10654,12 +10356,11 @@ 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-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-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> -<tr><td></td><td valign="top"><a href="#index-URL-hyperlink-3"><acronym>URL</acronym> hyperlink</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-url-for-path_002esty">url 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-hyperlink">url 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">url 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">url hyperlink</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-url-hyperlink-3">url hyperlink</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-url_002esty"><code>url.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-url_002esty-1"><code>url.sty</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-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> @@ -10753,8 +10454,8 @@ Previous: <a href="#Macro-index" accesskey="p" rel="prev">Macro index</a>, Up: < </td></tr></table> - -<hr> +</div> +</div> diff --git a/Master/texmf-dist/doc/eplain/eplain.pdf b/Master/texmf-dist/doc/eplain/eplain.pdf Binary files differindex ba475d1420f..6ed7f61624b 100644 --- a/Master/texmf-dist/doc/eplain/eplain.pdf +++ b/Master/texmf-dist/doc/eplain/eplain.pdf diff --git a/Master/texmf-dist/doc/eplain/lscommnt.jpg b/Master/texmf-dist/doc/eplain/lscommnt.jpg Binary files differindex 356fccb23d5..f118a28dbdc 100644 --- a/Master/texmf-dist/doc/eplain/lscommnt.jpg +++ b/Master/texmf-dist/doc/eplain/lscommnt.jpg diff --git a/Master/texmf-dist/doc/eplain/xhyper.jpg b/Master/texmf-dist/doc/eplain/xhyper.jpg Binary files differindex de240435072..15e960e42fa 100644 --- a/Master/texmf-dist/doc/eplain/xhyper.jpg +++ b/Master/texmf-dist/doc/eplain/xhyper.jpg |
