texlive[64637] Master/texmf-dist: eplain (6oct22)
commits+karl at tug.org
commits+karl at tug.org
Thu Oct 6 21:59:53 CEST 2022
Revision: 64637
http://tug.org/svn/texlive?view=revision&revision=64637
Author: karl
Date: 2022-10-06 21:59:53 +0200 (Thu, 06 Oct 2022)
Log Message:
-----------
eplain (6oct22)
Modified Paths:
--------------
trunk/Master/texmf-dist/doc/eplain/ChangeLog
trunk/Master/texmf-dist/doc/eplain/INSTALL
trunk/Master/texmf-dist/doc/eplain/NEWS
trunk/Master/texmf-dist/doc/eplain/README
trunk/Master/texmf-dist/doc/eplain/demo/Makefile
trunk/Master/texmf-dist/doc/eplain/demo/xhyper.tex
trunk/Master/texmf-dist/doc/eplain/eplain.html
trunk/Master/texmf-dist/doc/eplain/eplain.pdf
trunk/Master/texmf-dist/doc/eplain/lscommnt.jpg
trunk/Master/texmf-dist/doc/eplain/xhyper.jpg
trunk/Master/texmf-dist/doc/info/eplain.info
trunk/Master/texmf-dist/doc/man/man1/eplain.1
trunk/Master/texmf-dist/doc/man/man1/eplain.man1.pdf
trunk/Master/texmf-dist/source/eplain/xeplain.tex
trunk/Master/texmf-dist/tex/eplain/btxmac.tex
trunk/Master/texmf-dist/tex/eplain/eplain.tex
Added Paths:
-----------
trunk/Master/texmf-dist/source/eplain/eplain-source-3.12.zip
Removed Paths:
-------------
trunk/Master/texmf-dist/source/eplain/eplain-source-3.11.zip
Modified: trunk/Master/texmf-dist/doc/eplain/ChangeLog
===================================================================
--- trunk/Master/texmf-dist/doc/eplain/ChangeLog 2022-10-06 19:59:20 UTC (rev 64636)
+++ trunk/Master/texmf-dist/doc/eplain/ChangeLog 2022-10-06 19:59:53 UTC (rev 64637)
@@ -1,3 +1,82 @@
+2022-10-02 Karl Berry <karl at freefriends.org>
+
+ * NEWS,
+ * Makefile (version): 3.12.
+ * doc/eplain.texi: 3.12, October 2022. Regenerate.
+
+2022-10-05 Karl Berry <karl at 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 at 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 at freefriends.org>
+
+ * Makefile (fetch, fetch1): new targets.
+ * texnames.sty: update to current (explicit pd statement).
+
+2022-10-02 Karl Berry <karl at freefriends.org>
+
+ * doc/*.texi: remove use of @acronym; better to just use capitals.
+ Also, downcase "url".
+
+2022-10-02 Karl Berry <karl at 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 at 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 at 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 at 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 at freefriends.org>
* README: mailing list is tex-eplain, not bug-eplain
Modified: trunk/Master/texmf-dist/doc/eplain/INSTALL
===================================================================
--- trunk/Master/texmf-dist/doc/eplain/INSTALL 2022-10-06 19:59:20 UTC (rev 64636)
+++ trunk/Master/texmf-dist/doc/eplain/INSTALL 2022-10-06 19:59:53 UTC (rev 64637)
@@ -1,34 +1,27 @@
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.
+('eplain.tex') in its main 'texmf' tree; with TeX Live, it's in
+'.../texmf-dist/tex/eplain/eplain.tex'.
- 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'.
+ 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 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 to install a new 'eplain.tex' in some other place, set an
+environment variable (commonly, 'TEXINPUTS') 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:
+ Distributions should also create and maintain the 'eplain.fmt' file
+file. But if you want to do it yourself, you can:
- prompt$ touch eplain.aux
- prompt$ initex
+ $ touch eplain.aux
+ $ initex
This is TeX, ...
**&plain eplain
(eplain.tex)
@@ -35,12 +28,11 @@
*\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.
Modified: trunk/Master/texmf-dist/doc/eplain/NEWS
===================================================================
--- trunk/Master/texmf-dist/doc/eplain/NEWS 2022-10-06 19:59:20 UTC (rev 64636)
+++ trunk/Master/texmf-dist/doc/eplain/NEWS 2022-10-06 19:59:53 UTC (rev 64637)
@@ -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.
Modified: trunk/Master/texmf-dist/doc/eplain/README
===================================================================
--- trunk/Master/texmf-dist/doc/eplain/README 2022-10-06 19:59:20 UTC (rev 64636)
+++ trunk/Master/texmf-dist/doc/eplain/README 2022-10-06 19:59:53 UTC (rev 64637)
@@ -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 @@
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: http://lists.tug.org/tex-eplain (tex-eplain at tug.org)
-The Eplain home page is http://tug.org/eplain.
+Mailing list: https://lists.tug.org/tex-eplain (tex-eplain at 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
+
Modified: trunk/Master/texmf-dist/doc/eplain/demo/Makefile
===================================================================
--- trunk/Master/texmf-dist/doc/eplain/demo/Makefile 2022-10-06 19:59:20 UTC (rev 64636)
+++ trunk/Master/texmf-dist/doc/eplain/demo/Makefile 2022-10-06 19:59:53 UTC (rev 64637)
@@ -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 @@
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
Modified: trunk/Master/texmf-dist/doc/eplain/demo/xhyper.tex
===================================================================
--- trunk/Master/texmf-dist/doc/eplain/demo/xhyper.tex 2022-10-06 19:59:20 UTC (rev 64636)
+++ trunk/Master/texmf-dist/doc/eplain/demo/xhyper.tex 2022-10-06 19:59:53 UTC (rev 64637)
@@ -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 @@
% |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 @@
\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
Modified: trunk/Master/texmf-dist/doc/eplain/eplain.html
===================================================================
--- trunk/Master/texmf-dist/doc/eplain/eplain.html 2022-10-06 19:59:20 UTC (rev 64636)
+++ trunk/Master/texmf-dist/doc/eplain/eplain.html 2022-10-06 19:59:53 UTC (rev 64637)
@@ -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 @@
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 @@
<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 @@
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 @@
-<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>
-<span id="SEC_Contents"></span>
+<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>
+
+
+<div class="Contents_element" id="SEC_Contents">
<h2 class="contents-heading">Table of Contents</h2>
<div class="contents">
@@ -222,7 +233,10 @@
<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 @@
<li><a id="toc-Concept-index-1" href="#Concept-index" rel="index">Concept index</a></li>
</ul>
</div>
+</div>
+<div class="Overview_element" id="SEC_Overview">
+<h2 class="shortcontents-heading">Short Table of Contents</h2>
-
-<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 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>
-<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>
<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 @@
<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 @@
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 at tug.org">tex-eplain-request at tug.org</a> with a message whose body contains
-a line
+<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>
-<div class="example">
-<pre class="example">subscribe <var>you at 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>
<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 @@
<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 @@
<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.
+(<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>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>.
+<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 @@
<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 @@
<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 @@
<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 @@
</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 @@
<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 @@
\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,7 +584,7 @@
<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
@@ -921,19 +591,21 @@
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 @@
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 @@
<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 @@
</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 @@
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 @@
<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 @@
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 @@
<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 @@
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 @@
</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 @@
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 @@
</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,11 +1083,10 @@
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
@@ -1452,25 +1093,22 @@
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 @@
</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 @@
(<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 @@
</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 @@
</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 @@
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 @@
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 @@
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 @@
\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 @@
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 @@
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 @@
</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 @@
</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 @@
</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 @@
<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 @@
<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 @@
</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 @@
</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 @@
<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 @@
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 @@
</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 @@
<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 @@
</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 @@
</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 @@
</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 @@
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 @@
</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 @@
<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 @@
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 @@
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 @@
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 @@
</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 @@
}
</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 @@
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 @@
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 @@
<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 @@
<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 @@
<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 @@
</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 @@
</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 @@
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 @@
<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 @@
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 @@
<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 @@
</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 @@
<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 @@
</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 @@
<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 @@
<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 @@
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 @@
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 @@
</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 @@
<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 @@
</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 @@
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 @@
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 @@
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 @@
<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 @@
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 @@
<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 @@
</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 @@
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 @@
</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,7 +3507,7 @@
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>.
@@ -3847,7 +3514,9 @@
</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 @@
<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 @@
</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 @@
<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.
+support for package options; in many cases, you can use
+<samp>miniltx.tex</samp> directly without loading Eplain at all.
</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>
+<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 @@
</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 @@
<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 @@
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 @@
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 @@
<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 @@
</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 @@
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 @@
<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 @@
</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 @@
<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 @@
(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 @@
<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 @@
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 @@
<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,9 +4051,8 @@
<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
@@ -4395,26 +4059,27 @@
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 @@
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 @@
<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 @@
</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 @@
<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 @@
</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 @@
<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 @@
<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 @@
<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 @@
<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 @@
\href{mailto:tex-eplain at 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 @@
</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 @@
<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 @@
<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 @@
\enablehyperlinks
-\url{http://foo/bar}
+\url{https://foo/bar}
\url{mailto:foobar at example.org}
@@ -4867,7 +4523,7 @@
\enablehyperlinks
\hlopts{bwidth=0}
-\url{http://foo/bar}
+\url{https://foo/bar}
\url{mailto:foobar at example.org}
@@ -4877,14 +4533,16 @@
<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 @@
</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 @@
</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 @@
</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 @@
</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 @@
</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 @@
<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 @@
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 @@
</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 @@
</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 @@
</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 @@
</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 @@
<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 @@
<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 @@
</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 @@
<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 @@
<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 @@
<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 @@
<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 @@
<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 @@
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 @@
<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 @@
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 @@
(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 @@
<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 @@
<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,12 +5343,11 @@
<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>
@@ -5682,9 +5354,11 @@
<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 @@
<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 @@
<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 @@
</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 @@
<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 @@
</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 @@
<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,33 +5457,30 @@
<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>
@@ -5818,9 +5487,12 @@
<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 @@
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 @@
<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 @@
<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 @@
<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 @@
<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 @@
<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 @@
<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 @@
</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 @@
<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 @@
<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 @@
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,9 +5775,8 @@
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
@@ -6127,9 +5783,8 @@
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
@@ -6136,9 +5791,8 @@
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
@@ -6145,9 +5799,8 @@
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 @@
<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 @@
<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 @@
<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 @@
</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 @@
</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 @@
</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 @@
<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 @@
<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 @@
<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 @@
<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 @@
<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,11 +6028,11 @@
<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>
@@ -6392,15 +6039,15 @@
<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 @@
<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 @@
<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,21 +6112,20 @@
<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>
@@ -6490,18 +6132,17 @@
<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 @@
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 @@
<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 @@
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 @@
<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 @@
<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 @@
<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 @@
</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 @@
</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 @@
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 @@
\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 @@
<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 @@
<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 @@
</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 @@
</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 @@
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 @@
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 @@
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 @@
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 @@
</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 @@
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 @@
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 @@
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 @@
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,9 +7302,13 @@
<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>
@@ -7684,36 +7315,25 @@
<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 @@
</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,9 +7516,51 @@
</pre></div>
+<ul class="section-toc">
+<li><a href="#Scratch-registers" accesskey="1">Scratch registers</a></li>
+</ul>
<hr>
-<span id="Iteration"></span><div class="header">
+<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>
+</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>
<span id="Iteration-1"></span><h3 class="section">7.3 Iteration</h3>
@@ -7991,7 +7655,9 @@
</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 @@
</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 @@
<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 @@
<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 @@
</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 @@
</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,13 +7921,13 @@
<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.
@@ -8268,7 +7934,7 @@
</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 @@
<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,7 +7996,7 @@
<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.
@@ -8335,7 +8003,7 @@
</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 @@
<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 @@
<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 @@
</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 @@
</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 @@
</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 @@
<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 @@
</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 @@
</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 @@
</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 @@
<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 @@
</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 @@
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 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 @@
<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 @@
%
% 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 @@
% |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,7 +8679,7 @@
\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
@@ -8992,9 +8686,11 @@
</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 @@
\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 @@
<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 @@
</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 @@
<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 @@
<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 @@
<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 @@
<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 @@
<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 @@
<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 @@
<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 @@
<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 @@
<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 @@
<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,10 +10454,10 @@
</td></tr></table>
+</div>
+</div>
-<hr>
-
</body>
</html>
Modified: trunk/Master/texmf-dist/doc/eplain/eplain.pdf
===================================================================
(Binary files differ)
Modified: trunk/Master/texmf-dist/doc/eplain/lscommnt.jpg
===================================================================
(Binary files differ)
Modified: trunk/Master/texmf-dist/doc/eplain/xhyper.jpg
===================================================================
(Binary files differ)
Modified: trunk/Master/texmf-dist/doc/info/eplain.info
===================================================================
--- trunk/Master/texmf-dist/doc/info/eplain.info 2022-10-06 19:59:20 UTC (rev 64636)
+++ trunk/Master/texmf-dist/doc/info/eplain.info 2022-10-06 19:59:53 UTC (rev 64637)
@@ -1,8 +1,8 @@
-This is eplain.info, produced by makeinfo version 6.7 from eplain.texi.
+This is eplain.info, produced by makeinfo version 6.8 from eplain.texi.
-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.
+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.
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
@@ -21,7 +21,7 @@
Eplain
******
-This manual documents the Eplain macros, version 3.11, July 2020.
+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.
@@ -47,189 +47,6 @@
* Macro index:: Entries for TeX and Eplain control sequences.
* Concept index:: General index.
- -- The Detailed Node Listing --
-
-User definitions
-
-* Diagnostics:: Tracing information.
-* Rules:: Changing the default rule dimensions.
-* Citations:: Using BibTeX and Eplain to make bibliographies.
-* Displays:: Changing the formatting of math displays.
-* Time of day:: Producing the time of day.
-* Lists:: Producing numbered and unordered lists.
-* Verbatim listing:: Producing text just as it appears.
-* Contents:: Making a table of contents.
-* Cross-references:: Symbolically referring to pages or equations.
-* Page references:: Symbolic references to page numbers.
-* Equation references:: Symbolic references to equation numbers.
-* Indexing:: Creating and typesetting indexes.
-* Justification:: Left- or right-justification, or centering.
-* Tables:: Producing ordered tables.
-* Margins:: Changing the margins directly.
-* Multiple columns:: Getting output in two columns.
-* Footnotes:: Autonumbered footnotes; changing formatting.
-* Fractions:: A better way to produce fractions in text.
-* Paths:: Allowing line breaks in pathnames.
-* Logos:: Various logos.
-* Boxes:: Producing filled or open rectangles.
-* Checking for PDF output:: Checking for pdfTeX in PDF mode.
-* Loading LaTeX packages:: Support for LaTeX packages under plain TeX.
-
-Citations
-
-* Formatting citations:: Changing the way citations are printed.
-* Formatting bibliographies:: Changing the way bibliographies are printed.
-
-Displays
-
-* Formatting displays:: General formatting of displays.
-
-Lists
-
-* Formatting lists:: Changing how the lists look.
-
-Contents
-
-* Writing the .toc file::
-* Reading the .toc file::
-* Changing the .toc file's root name::
-* Alternative contents files::
-
-Cross-references
-
-* Defining generic references::
-* Using generic references::
-
-Equation references
-
-* Formatting equation references::
-* Subequation references::
-
-Indexing
-
-* Indexing terms:: Specifying what to index.
-* Typesetting an index:: Printing the sorted output.
-* Customizing indexing:: Creating commands and specifying extra actions.
-
-Indexing terms
-
-* Indexing commands:: Making index entries.
-* Modifying index entries:: Ranges, see/see also, page number typesetting.
-* Index entries with special characters::
-* Proofing index terms:: Noting index entries in the margins.
-
-Loading LaTeX packages
-
-* The \usepackage command:: Command to load packages.
-* Environment for loading packages:: Environment for the \usepackage commands.
-* Packages known to work:: Supported packages.
-* Packages known not to work:: Packages known not to work with Eplain.
-
-Hyperlinks
-
-* Introduction to hyperlinks::
-* Explicit hyperlinks::
-* Implicit hyperlinks::
-* Hyperlink drivers::
-* Setting hyperlink types and options::
-* Turning hyperlinks on/off::
-
-Implicit hyperlinks
-
-* General hyperlinks:: hrefint, hrefext
-* URL hyperlinks:: url
-* Citation hyperlinks:: cite, bib
-* List hyperlinks:: li
-* Cross-reference hyperlinks:: definexref, ref
-* Page reference hyperlinks:: xrdef, xref
-* Equation reference hyperlinks:: eq
-* Index hyperlinks:: idx
-* Footnote hyperlinks:: foot, footback
-* Contents hyperlinks::
-
-Index hyperlinks
-
-* Exact destinations for index terms::
-* Page destinations for index terms::
-* Choosing destination placement::
-* Index page list and page range parsers::
-* Hyperlinks in see and see also entries::
-
-Hyperlink drivers
-
-* Options supported by all drivers::
-* Hyperlink driver hypertex::
-* Hyperlink drivers pdftex and dvipdfm::
-* Hyperlink driver nolinks::
-
-Hyperlink driver hypertex::
-
-* Destination types for hypertex::
-* Destination options for hypertex::
-* Link types for hypertex::
-* Link options for hypertex::
-
-Hyperlink drivers pdftex and dvipdfm::
-
-* Destination types for pdftex and dvipdfm::
-* Destination options for pdftex and dvipdfm::
-* Link types for pdftex and dvipdfm::
-* Link options for pdftex and dvipdfm::
-
-Setting hyperlink types and options
-
-* Setting default types and options::
-* Setting group types::
-* Setting group options::
-
-Turning hyperlinks on/off
-
-* Turning low-level commands on/off::
-* Turning hyperlinks on/off for a group::
-
-Arrow theoretic diagrams
-
-* Slanted lines and vectors::
-* Commutative diagrams::
-
-Commutative diagrams
-
-* Arrows and morphisms::
-* Construction of commutative diagrams::
-* Commutative diagram parameters::
-
-Programming definitions
-
-* Category codes:: Changing category codes.
-* Allocation macros:: Non-outer versions of \newcount et al.
-* Iteration:: Doing 'for' and 'while' loops in TeX.
-* Macro arguments:: Reading and ignoring them.
-* Converting to characters:: Normalizing control sequences and spaces.
-* Expansion:: Controlling expansion.
-* Obeying spaces:: Making whitespace count anywhere.
-* Writing out numbers:: Making '1' into 'one'.
-* Mode-specific penalties::
-* Auxiliary files:: Testing for their existence.
-* User-defined environments:: User-defined environments.
-* Page list and page range parsers::
-
-Expansion
-
-* \csn and \ece::
-* \edefappend::
-* Hooks:: Manipulating and executing named actions.
-* Properties:: Associating information with a csname.
-* \expandonce::
-* \ifundefined::
-* \ifempty::
-* \ifinteger and \isinteger::
-* \futurenonspacelet::
-
-Demo files
-
-* Hyperlinks (xhyper.tex)::
-* Highlighting TeX comments in listings (lscommnt.tex)::
-
File: eplain.info, Node: Introduction, Next: Installation, Prev: Top, Up: Top
@@ -245,7 +62,7 @@
that.
Eplain is not intended to provide typesetting capabilities, as does
-LaTeX (originally written by Leslie Lamport) and Texinfo (Originally
+LaTeX (originally written by Leslie Lamport) and Texinfo (originally
written by Richard Stallman). Instead, it provides definitions that are
intended to be useful regardless of the high-level commands that you use
when you actually prepare your manuscript.
@@ -283,19 +100,27 @@
at the end of the source file 'eplain.tex'. When corresponding, please
refer to it.
- To get on this mailing list yourself, email
-<tex-eplain-request at tug.org> with a message whose body contains a line
+ To subscribe to this mailing list (anyone can subscribe, and archives
+are public), visit <https://lists.tug.org/tex-eplain>.
- subscribe YOU at YOUR.PREFERRED.ADDRESS
-
-or visit <http://lists.tug.org/tex-eplain>.
-
- David Walden had reported his experience with Eplain as a new user.
-The article is available online at
+ David Walden reported his experience with Eplain as a new user. The
+article is available online at
<https://tug.org/pracjourn/2005-4/walden>. An introductory article
(written for TUGboat) is also available online at
<https://tug.org/eplain/misc/tb84katsi.pdf>.
+ Finally, here are two 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>.
+
File: eplain.info, Node: Installation, Next: Invoking Eplain, Prev: Introduction, Up: Top
@@ -303,33 +128,22 @@
**************
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.
+('eplain.tex') in its main 'texmf' tree; with TeX Live, it's in
+'.../texmf-dist/tex/eplain/eplain.tex'.
- 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>.
+ 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 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 to install a new 'eplain.tex' in some other place, set an
+environment variable (commonly, 'TEXINPUTS') 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:
+ Distributions should also create and maintain the 'eplain.fmt' file
+file. But if you want to do it yourself, you can:
- prompt$ touch eplain.aux
- prompt$ initex
+ $ touch eplain.aux
+ $ initex
This is TeX, ...
**&plain eplain
(eplain.tex)
@@ -340,10 +154,9 @@
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'.
+'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.
File: eplain.info, Node: Invoking Eplain, Next: User definitions, Prev: Installation, Up: Top
@@ -355,30 +168,28 @@
\input eplain
-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.
+at the beginning of your (plain TeX) input file. The macro file is
+small enough that reading it does not take long.
- In addition, if a format ('.fmt') file has been created for Eplain
-(see the previous section), you can eliminate the time spent reading the
+ However, if a format ('.fmt') file has been created for Eplain (see
+the previous section), you can eliminate even the time spent reading the
macro source file. You do this by responding '&eplain' to TeX's '**'
prompt. For example:
- initex
+ $ tex
This is TeX, ...
**&eplain myfile
- Depending on the implementation of TeX which you are using, you might
-also be able to invoke TeX as 'eplain' and have the format file
-automatically read.
+ In TeX Live and other distributions, a command-line executable named
+'eplain' is provided which reads the 'eplain.fmt' file automatically.
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
doing '\input eplain' will waste time; if it isn't, then you must load
it. To solve this, Eplain defines the control sequence '\eplain' to be
-the letter 't' (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:
+the letter 't' (a convention borrowed from Lisp; it doesn't matter what
+the definition is, only that the definition exists). Therefore, you can
+do the following:
\ifx\eplain\undefined \input eplain \fi
@@ -395,9 +206,10 @@
'btxmac.tex'
bibliography-related macros (*note Citations::);
-'ifpdf.sty'
- sets the switch '\ifpdf', which can be used to detect pdfTeX in PDF
- mode (*note Checking for PDF output::), written by Heiko Oberdiek;
+'iftex.sty'
+ sets the switch '\ifpdf' (among other things), which can be used to
+ detect direct PDF output (*note Checking for PDF output::),
+ originally written by Heiko Oberdiek;
'path.sty'
macro for allowing line breaks at punctuation characters within
@@ -426,7 +238,7 @@
\let\nobibtex = t
\input eplain
-By default, '\nobibtex' is undefined, and so the bibliography
+By default, '\nobibtex' is not defined, and so the bibliography
definitions _are_ made.
Likewise, define '\noarrow' if you don't want to include the
@@ -451,17 +263,18 @@
Sometimes you may need to run TeX more then once on your '.tex' file
in order to produce and typeset indexes, resolve undefined
cross-references and/or citations. The shell script 'texi2dvi' from the
-Texinfo documentation system (see <http://www.gnu.org/software/texinfo>)
-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 'LATEX' environment variable to 'tex'. For example, in a
-Bourne-compatible shell, the following command will do all the work:
+Texinfo documentation system (see
+<https://www.gnu.org/software/texinfo>) 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 'LATEX' environment
+variable to 'tex'. For example, in a Bourne-compatible shell, the
+following command will do all the work:
- prompt$ LATEX=tex texi2dvi file.tex
+ $ LATEX=tex texi2dvi file.tex
-(Despite the name, 'texi2dvi' can also produce '.pdf' files; just set
-'LATEX=pdftex'.) See the output from the command 'texi2dvi --help' for
-invoking information and a full list of options.
+Despite the name, 'texi2dvi' can also produce '.pdf' output (among other
+formats); set 'LATEX=pdftex' for this. See the output from 'texi2dvi
+--help' for a full list of options.
File: eplain.info, Node: User definitions, Next: Hyperlinks, Prev: Invoking Eplain, Up: Top
@@ -1582,8 +1395,8 @@
#1\char\subref
}
-Sadly, we must define a new count register, '\subref', instead of using
-the scratch count register '\count255', because '#1' might include other
+We must define a new count register, '\subref', instead of using the
+scratch count register '\count255', because '#1' might include other
macro calls which use '\count255'.
@@ -1898,7 +1711,7 @@
now we'll describe the exceptions.
The following characters are reset to their usual meanings because
-they are not useful verbatim: multiple consequent spaces are converted
+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).
@@ -2109,7 +1922,7 @@
name of the '.idx' file is 'myfile.idx' and the 'trimsee' script is
placed in the current directory):
- prompt$ cat myfile.idx | makeindex | ./trimsee > myfile.ind
+ $ cat myfile.idx | makeindex | ./trimsee >myfile.ind
By default, 'trimsee' uses default page list separators and default
"see ..." command names. If you set up MakeIndex to use different page
@@ -2347,7 +2160,7 @@
implement multicolumns, Eplain multiplies '\vsize' 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.
+output).
The columns are separated by the value of the dimen parameter
'\gutter'. Default value is two picas. If you want to add vertical
@@ -2356,6 +2169,13 @@
\def\gutterbox{\vbox to \dimen0{\vfil\hbox{\vrule height\dimen0}\vfil}}%
+ There are known bugs in the multiple-column code such that '\topmark'
+and possibly other marks can have an incorrect value on the last page of
+multiple-column material when using '\singlecolumn' 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 '\columnfill' at the appropriate place.
+
The dimension counter '\dimen0' contains the height of the column.
All the '\...columns' macros insert the value of the glue parameter
@@ -2502,8 +2322,9 @@
Some spelling variants of these are also supported.
Most of these macros come from 'texnames.sty', compiled by Nelson
-Beebe and available at <http://mirror.ctan.org/info/biblio/texnames.sty>
-(part of the 'biblio' package, <https://ctan.org/pkg/biblio>).
+Beebe and available at
+<https://mirror.ctan.org/info/biblio/texnames.sty> (part of the 'biblio'
+package, <https://ctan.org/pkg/biblio>).
File: eplain.info, Node: Boxes, Next: Checking for PDF output, Prev: Logos, Up: User definitions
@@ -2555,26 +2376,23 @@
4.22 Checking for PDF output
============================
-pdfTeX is an extended TeX that can output both '.dvi' and '.pdf'
-(Adobe's Portable Document Format) files (see
-<https://ctan.org/pkg/pdftex>). You might sometimes want to know whether
-the target format is '.pdf' or '.dvi'. The '\ifpdf' switch can be used
-to detect pdfTeX in PDF mode:
+You might sometimes want to test whether the target format is '.pdf' or
+'.dvi'. The '\ifpdf' conditional can be used for this:
\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
- Keep in mind that '\ifpdf' is set based on the value of the
-'\pdfoutput' primitive of pdfTeX at the time Eplain is loaded. If you
-change the value of '\pdfoutput' after you load Eplain, '\ifpdf' will
-not reflect the change.
+ At this writing, '\ifpdf' will be true when running pdfTeX or LuaTeX
+with PDF output. It will be false when running XeTeX, or (of course)
+original TeX, etc.
- Eplain defines '\ifpdf' by incorporating Heiko Oberdiek's
-'ifpdf.sty', which is available at <https://ctan.org/pkg/ifpdf>.
+ Eplain defines '\ifpdf' by incorporating 'iftex.sty', a package now
+maintained by the LaTeX Project Team. 'iftex.sty', and therefore Eplain,
+defines numerous related conditionals to test for different engines; see
+its package documentation for details: <https://ctan.org/pkg/ifpdf>.
File: eplain.info, Node: Loading LaTeX packages, Prev: Checking for PDF output, Up: User definitions
@@ -2594,7 +2412,8 @@
'miniltx.tex' (<https://ctan.org/pkg/miniltx>) from the LaTeX graphics
collection, written by David Carlisle and Sebastian Rahtz. Eplain
extends 'miniltx.tex' to provide (primarily) support for package
-options.
+options; in many cases, you can use 'miniltx.tex' directly without
+loading Eplain at all.
* Menu:
@@ -2720,8 +2539,8 @@
system for TeX) installed on your system. The problem was fixed in
'supp-mis.tex' version 2004.10.26. You can obtain up-to-date
versions of 'supp-mis.tex' and the accompanying 'supp-pdf.tex' from
- <http://mirror.ctan.org/macros/pdftex/graphics>. To convince TeX to
- use the new files, you have the following options:
+ <https://mirror.ctan.org/macros/pdftex/graphics>. To convince TeX
+ to use the new files, you have the following options:
1. put the new files in the same directory with your document;
@@ -2730,8 +2549,7 @@
3. install the new 'supp-mis.tex' and 'supp-pdf.tex' files in the
relevant subdirectory of your local 'texmf' tree (for info on
- TeX directory structure see <https://tug.org/tds/> and
- <http://www.tex.ac.uk/cgi-bin/texfaq2html?label=tds>);
+ TeX directory structure, see <https://tug.org/tds/>);
4. upgrade your ConTeXt installation.
@@ -2747,7 +2565,7 @@
command from the 'color.sty' package under pdfTeX, the cause may be
an outdated pdfTeX color and graphics driver 'pdftex.def'. The
problem was fixed in 'pdftex.def' version 0.03p. You can obtain an
- up-to-date version from <http://ctan.org/pkg/pdftex-def>.
+ up-to-date version from <https://ctan.org/pkg/graphics-def>.
*End of warning 2.*
The '\fcolorbox' macro provided by the 'color' package requires the
@@ -2906,7 +2724,7 @@
The knowledge about the commands that the various processors
understand is programmed into Eplain's hyperlink drivers. Eplain
provides three drivers: 'hypertex' (implementation of the HyperTeX
-standard, see <http://arxiv.org/hypertex>), and 'pdftex' and 'dvipdfm'
+standard, see <https://arxiv.org/hypertex>), and 'pdftex' and 'dvipdfm'
(named after the programs which process the hyperlink commands, pdfTeX
and dvipdfm). Therefore, Eplain can only produce HyperTeX commands and
hyperlink commands for one of these two programs--except that the
@@ -2975,7 +2793,7 @@
'pdftex' driver, the usual link type used to refer to destinations in
the current document is called 'name'. You can also create a link
pointing to another local document (by using the 'filename' link type)
-or to a URL (by using the 'url' link type).
+or to a url (by using the 'url' link type).
In addition, each hyperlink driver supports a number of destination
and link "options". By setting these options you can customize hyperlink
@@ -3030,7 +2848,7 @@
The LABEL argument of both '\hldest' and '\hlstart' can contain
special characters (such as '#', '%', '&', '~', etc.) without any
-escaping. This is especially important for URL links supported by some
+escaping. This is especially important for url links supported by some
drivers (*note Hyperlink drivers::).
Both '\hldest' and '\hlstart' ignore following spaces.
@@ -3116,9 +2934,9 @@
will make 'Introduction' into an internal link, which might have been
created, e.g., with '\xrdef{intro}'.
- If URL does not start with '#', it is assumed to be a URL link.
+ If URL does not start with '#', it is assumed to be a url link.
Parameters for these links can be set by customizing the 'hrefext'
-linkgroup. The special characters (such as '#' and '~') in the URL don't
+linkgroup. The special characters (such as '#' and '~') in the url don't
need to be escaped. For example:
\href{https://tug.org/eplain/doc/eplain.html#Hyperlinks}{Hyperlinks
@@ -3125,7 +2943,7 @@
in Eplain}
\href{mailto:tex-eplain at tug.org}{Eplain mailing list}
-*Note URL hyperlinks::, for another way to create URL hyperlinks.
+*Note URL hyperlinks::, for another way to create url hyperlinks.
The TEXT argument of '\href' can contain verbatim text (*note
Verbatim listing::) or other macros which manipulate character catcodes.
@@ -3146,14 +2964,14 @@
'url' (*note Packages known to work::), as well as any new '\url'-like
commands you define. The type for this linkgroup is set to 'url' by the
drivers which support this link type. 'url' links use the parameter to
-the '\url' command as the URL to point to.
+the '\url' command as the url to point to.
You may be using the '\url' command to typeset something other than a
-URL, e.g., a path, for which you do not want a link to be created; in
+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
'\hloff[url]' (*note Turning hyperlinks on/off for a group::).
- By default, URL (and other types of) links are boxed, so that they
+ By default, url (and other types of) links are boxed, so that they
are visually marked even if you do not load the LaTeX 'color' package
(*note Loading LaTeX packages::) and therefore link text is not colored.
You can see the effect by compiling the following code snippet (be sure
@@ -3167,7 +2985,7 @@
\enablehyperlinks
- \url{http://foo/bar}
+ \url{https://foo/bar}
\url{mailto:foobar at example.org}
@@ -3186,7 +3004,7 @@
\enablehyperlinks
\hlopts{bwidth=0}
- \url{http://foo/bar}
+ \url{https://foo/bar}
\url{mailto:foobar at example.org}
@@ -3195,7 +3013,7 @@
The command '\hlopts{bwidth=0}' sets border width to zero as the default
for all links, and loading the 'color' package automatically colors
links using the default color (*note Options supported by all
-drivers::). If you want the border width setting to apply to URL links
+drivers::). If you want the border width setting to apply to url links
only, say '\hlopts[url]{bwidth=0}' (*note Setting hyperlink types and
options::).
@@ -3378,7 +3196,7 @@
the hyperlink label but identical otherwise. You should process the
'.idx' with this script before passing it on to MakeIndex. For example:
- prompt$ ./idxuniq file.idx | makeindex > file.ind
+ $ ./idxuniq file.idx | makeindex >file.ind
Still, this solution is not ideal, as the page-range formation ability
of MakeIndex will not work, and there will be problems of apparently
@@ -3619,7 +3437,7 @@
---------------------------------
HyperTeX is a standard for inclusion of hyperlink information in TeX
-(and LaTeX) documents (see <http://arxiv.org/hypertex>). This standard
+(and LaTeX) documents (see <https://arxiv.org/hypertex>). This standard
defines a set of hyperlink tags implemented as '\special' commands
written into the DVI file. The major advantage of such standard is that
a single '.dvi' file containing HyperTeX commands can be viewed by any
@@ -3639,8 +3457,8 @@
For more information on programs which support the HyperTeX standard,
please see
- <http://arxiv.org/hypertex>
- <http://mirror.ctan.org/support/hypertex/hypertex>
+ <https://arxiv.org/hypertex>
+ <https://mirror.ctan.org/support/hypertex/hypertex>
For convenience, we list a few HyperTeX-enabled converters:
@@ -3651,9 +3469,9 @@
Ghostscript. For example, if 'foo.tex' is a TeX file using HyperTeX
commands, then
- prompt$ tex foo.tex
- prompt$ dvips -z foo.dvi -o
- prompt$ ps2pdf foo.ps
+ $ tex foo.tex
+ $ dvips -z foo.dvi -o
+ $ ps2pdf foo.ps
will produce 'foo.pdf' with hyperlinks.
@@ -3671,7 +3489,7 @@
(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 URL link instead of a file link.
+local files, and produce a url link instead of a file link.
* Menu:
@@ -3736,7 +3554,7 @@
Example: '\hlstart{name}{}{dest123}Link to dest123\hlend'
'url'
- Go to a URL. The label is the URL.
+ Go to a url. The label is the url.
Example:
@@ -4030,7 +3848,7 @@
Example: '\hlstart{name}{}{dest123}Link to dest123\hlend'
'url'
- Go to a URL. The label is the URL.
+ Go to a url. The label is the url.
Example: '\hlstart{url}{}{https://tug.org/eplain/}Eplain
home\hlend'
@@ -5138,7 +4956,39 @@
\innerdef\innerproclaim{proclaim}
\innerinnerdef{proclaim}
+* Menu:
+
+* Scratch registers::
+
+File: eplain.info, Node: Scratch registers, Up: Allocation macros
+
+7.2.1 Scratch registers
+-----------------------
+
+It seems worth reiterating here the conventions for scratch registers
+defined by Knuth for plain TeX, which Eplain inherits and does not
+change.
+
+ * 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.
+
+ * First exception: the '\count' registers '0..9' are used internally
+ by TeX for page numbering and thus are not available for any other
+ use.
+
+ * Second exception: the '\box255' register is likewise internally by
+ TeX, to ship out pages. So it's not available either.
+
+ * By convention, all assignments to the scratch registers 1, 3, 5, 7,
+ and 9 should be '\global', and assignments to the others should be
+ non-'\global'.
+
+ For more details on all aspects of register usage, see 'The TeXbook'
+or any other plain TeX reference.
+
+
File: eplain.info, Node: Iteration, Next: Macro arguments, Prev: Allocation macros, Up: Programming definitions
7.3 Iteration
@@ -5555,7 +5405,7 @@
math mode).
These macros come from the TeX Frequently Asked Questions
-(<http://www.tex.ac.uk/cgi-bin/texfaq2html>).
+(<https://texfaq.org>).
File: eplain.info, Node: \futurenonspacelet, Prev: \ifinteger and \isinteger, Up: Expansion
@@ -5760,6 +5610,8 @@
[image src="xhyper.jpg" ]
+
+% $Id: xhyper.tex 60 2022-10-05 22:42:54Z karl $
% (This file is public domain.)
%
% This file demonstrates the following features of Eplain:
@@ -5772,7 +5624,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
@@ -5932,7 +5784,7 @@
% |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
@@ -5946,7 +5798,7 @@
\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
@@ -5959,6 +5811,7 @@
[image src="lscommnt.jpg" ]
+
% (This file is public domain.)
% Demonstrate how Eplain can be used to include a TeX source file
% verbatim, typesetting comments in colored italic typewriter type.
@@ -6027,10 +5880,10 @@
(line 68)
* @indexproof insertion class: Proofing index terms.
(line 28)
-* abovecolumnskip: Multiple columns. (line 33)
+* abovecolumnskip: Multiple columns. (line 40)
* abovecolumnspenalty: Tables. (line 30)
-* abovelistpenalty: Formatting lists. (line 29)
-* abovelistskip: Formatting lists. (line 29)
+* abovelistpenalty: Formatting lists. (line 28)
+* abovelistskip: Formatting lists. (line 28)
* abovelistskipamount: Formatting lists. (line 10)
* adjarrow: Arrows and morphisms.
(line 113)
@@ -6078,7 +5931,7 @@
(line 22)
* beginindex hook: Typesetting an index.
(line 30)
-* beginlist: Formatting lists. (line 50)
+* beginlist: Formatting lists. (line 49)
* beginpackages: Environment for loading packages.
(line 6)
* begin{picture}: Packages known to work.
@@ -6085,9 +5938,9 @@
(line 14)
* begin{theindex}: Typesetting an index.
(line 17)
-* belowcolumnskip: Multiple columns. (line 34)
+* belowcolumnskip: Multiple columns. (line 41)
* belowfootnoterulespace: Footnotes. (line 46)
-* belowlistskip: Formatting lists. (line 30)
+* belowlistskip: Formatting lists. (line 29)
* belowlistskipamount: Formatting lists. (line 10)
* biarrow: Arrows and morphisms.
(line 110)
@@ -6159,7 +6012,7 @@
* cmd (hyperlink option) <2>: Link types for pdftex and dvipdfm.
(line 67)
* cmd (hyperlink option) <3>: Link options for pdftex and dvipdfm.
- (line 56)
+ (line 55)
* color (hyperlink option): Options supported by all drivers.
(line 37)
* colormodel (hyperlink option): Options supported by all drivers.
@@ -6173,7 +6026,7 @@
(line 43)
* csn: \csn and \ece. (line 6)
* definecolor: Hyperlinks (xhyper.tex).
- (line 7)
+ (line 8)
* definecontentsfile: Alternative contents files.
(line 6)
* defineindex: Indexing. (line 35)
@@ -6180,7 +6033,7 @@
* definexref: Defining generic references.
(line 6)
* definexref <1>: Hyperlinks (xhyper.tex).
- (line 7)
+ (line 8)
* definexref (hyperlinks): Cross-reference hyperlinks.
(line 6)
* depth (destination option): Destination types for pdftex and dvipdfm.
@@ -6188,7 +6041,7 @@
* depth (destination option) <1>: Destination options for pdftex and dvipdfm.
(line 34)
* depth (hyperlink option): Link options for pdftex and dvipdfm.
- (line 122)
+ (line 121)
* discretionaries: Paths. (line 20)
* displaylines: Displays. (line 18)
* DOCVIEW pdfmark: Making PDF outlines. (line 37)
@@ -6214,7 +6067,7 @@
(line 48)
* end for index entries: Modifying index entries.
(line 22)
-* endlist: Formatting lists. (line 52)
+* endlist: Formatting lists. (line 51)
* endnumberedlist: Lists. (line 13)
* endorderedlist: Lists. (line 13)
* endpackages: Environment for loading packages.
@@ -6224,7 +6077,7 @@
(line 14)
* end{theindex}: Typesetting an index.
(line 17)
-* eplain: Invoking Eplain. (line 30)
+* eplain: Invoking Eplain. (line 28)
* eplaininput: Environment for loading packages.
(line 24)
* eqalignno: Displays. (line 18)
@@ -6279,7 +6132,7 @@
* file (hyperlink option) <3>: Link types for pdftex and dvipdfm.
(line 53)
* file (hyperlink option) <4>: Link options for pdftex and dvipdfm.
- (line 63)
+ (line 62)
* fileexists (conditional): Auxiliary files. (line 10)
* filename (hyperlink type): Link types for hypertex.
(line 21)
@@ -6303,7 +6156,7 @@
(line 31)
* flushleft: Justification. (line 7)
* flushright: Justification. (line 7)
-* fmtversion: Introduction. (line 51)
+* fmtversion: Introduction. (line 49)
* footnote (hyperlinks): Footnote hyperlinks. (line 7)
* footnotemarkseparation: Footnotes. (line 25)
* footnoteruleheight: Footnotes. (line 44)
@@ -6335,7 +6188,7 @@
* height (destination option) <1>: Destination options for pdftex and dvipdfm.
(line 37)
* height (hyperlink option): Link options for pdftex and dvipdfm.
- (line 125)
+ (line 124)
* hgrid: Construction of commutative diagrams.
(line 108)
* hgrid <1>: Commutative diagram parameters.
@@ -6358,15 +6211,15 @@
* hldestopts <1>: Setting group options.
(line 10)
* hldestopts <2>: Hyperlinks (xhyper.tex).
- (line 7)
+ (line 8)
* hldesttype: Setting default types and options.
(line 6)
* hldesttype <1>: Setting group types. (line 6)
* hldesttype <2>: Hyperlinks (xhyper.tex).
- (line 7)
+ (line 8)
* hlend: Explicit hyperlinks. (line 25)
* hlend <1>: Hyperlinks (xhyper.tex).
- (line 7)
+ (line 8)
* hlfootbacklabel: Footnote hyperlinks. (line 12)
* hlfootlabel: Footnote hyperlinks. (line 12)
* hlfootlabelnumber: Footnote hyperlinks. (line 15)
@@ -6383,9 +6236,9 @@
* hlidxpagelabel: Page destinations for index terms.
(line 11)
* hlight (hyperlink option): Link options for pdftex and dvipdfm.
- (line 69)
+ (line 68)
* hlightcommentslisting: Highlighting TeX comments in listings (lscommnt.tex).
- (line 7)
+ (line 8)
* hline: Arrows and morphisms.
(line 54)
* hloff: Hyperlink driver nolinks.
@@ -6399,7 +6252,7 @@
* hlopts <1>: Setting group options.
(line 10)
* hlopts <2>: Hyperlinks (xhyper.tex).
- (line 7)
+ (line 8)
* hlstart: Explicit hyperlinks. (line 25)
* hlstart <1>: Link types for hypertex.
(line 43)
@@ -6408,7 +6261,7 @@
* hlstart <3>: Setting hyperlink types and options.
(line 7)
* hlstart <4>: Hyperlinks (xhyper.tex).
- (line 7)
+ (line 8)
* hltype: Setting default types and options.
(line 6)
* hltype <1>: Setting group types. (line 6)
@@ -6507,7 +6360,7 @@
* ifinteger: \ifinteger and \isinteger.
(line 6)
* ifpdf: Checking for PDF output.
- (line 9)
+ (line 6)
* ifpdf <1>: Introduction to hyperlinks.
(line 51)
* ifpdf <2>: Making PDF outlines. (line 16)
@@ -6515,7 +6368,7 @@
(line 26)
* ifundefined: \ifundefined. (line 6)
* includegraphics: Hyperlinks (xhyper.tex).
- (line 7)
+ (line 8)
* indexfilebasename: Typesetting an index.
(line 11)
* indexfonts: Typesetting an index.
@@ -6567,14 +6420,14 @@
* insidemargin: Proofing index terms.
(line 21)
* interfootnoteskip: Footnotes. (line 29)
-* interitemskip: Formatting lists. (line 30)
+* interitemskip: Formatting lists. (line 29)
* interitemskipamount: Formatting lists. (line 14)
* isinteger: \ifinteger and \isinteger.
(line 13)
* item in indexes: Typesetting an index.
(line 35)
-* itemletter: Formatting lists. (line 44)
-* itemnumber: Formatting lists. (line 44)
+* itemletter: Formatting lists. (line 43)
+* itemnumber: Formatting lists. (line 43)
* ituline: Page list and page range parsers.
(line 26)
* jobname: Citations. (line 17)
@@ -6611,14 +6464,14 @@
* li (hyperlinks): List hyperlinks. (line 6)
* linenumberedlisting: Verbatim listing. (line 17)
* linenumberedlisting <1>: Highlighting TeX comments in listings (lscommnt.tex).
- (line 7)
+ (line 8)
* listcompact: Lists. (line 38)
* listing: Verbatim listing. (line 7)
* listing <1>: Highlighting TeX comments in listings (lscommnt.tex).
- (line 7)
+ (line 8)
* listingfont: Verbatim listing. (line 10)
* listleftindent: Formatting lists. (line 18)
-* listmarkerspace: Formatting lists. (line 33)
+* listmarkerspace: Formatting lists. (line 32)
* listrightindent: Formatting lists. (line 18)
* loggingall: Diagnostics. (line 11)
* loop: Iteration. (line 40)
@@ -6665,15 +6518,15 @@
* newwin (hyperlink option) <1>: Link types for pdftex and dvipdfm.
(line 54)
* newwin (hyperlink option) <2>: Link options for pdftex and dvipdfm.
- (line 90)
+ (line 89)
* new...: Allocation macros. (line 8)
-* noarrow: Invoking Eplain. (line 84)
-* noauxfile: Invoking Eplain. (line 89)
-* nobibtex: Invoking Eplain. (line 73)
+* noarrow: Invoking Eplain. (line 83)
+* noauxfile: Invoking Eplain. (line 88)
+* nobibtex: Invoking Eplain. (line 72)
* nocite: Citations. (line 58)
* nolastlinelisting: Verbatim listing. (line 25)
* nolastlinelisting <1>: Highlighting TeX comments in listings (lscommnt.tex).
- (line 7)
+ (line 8)
* nolinks (hyperlink driver): Hyperlink driver nolinks.
(line 6)
* normalbaselineskip: Options supported by all drivers.
@@ -6683,8 +6536,8 @@
* numberedfootnote: Footnotes. (line 7)
* numberedfootnote (hyperlinks): Footnote hyperlinks. (line 6)
* numberedlist: Lists. (line 13)
-* numberedlistdepth: Formatting lists. (line 41)
-* numberedmarker: Formatting lists. (line 37)
+* numberedlistdepth: Formatting lists. (line 40)
+* numberedmarker: Formatting lists. (line 36)
* numbername: Writing out numbers. (line 6)
* obeywhitespace: Obeying spaces. (line 6)
* orderedlist: Lists. (line 13)
@@ -6701,7 +6554,7 @@
* pagefit (hyperlink option) <2>: Link types for pdftex and dvipdfm.
(line 54)
* pagefit (hyperlink option) <3>: Link options for pdftex and dvipdfm.
- (line 107)
+ (line 106)
* pageno: Proofing index terms.
(line 21)
* pagetotal: Multiple columns. (line 14)
@@ -6714,8 +6567,6 @@
* pdfescapestring pdfTeX primitive: Making PDF outlines. (line 60)
* pdfmark (PDF language primitive): Making PDF outlines. (line 31)
* pdfoutline (pdftex primitive): Making PDF outlines. (line 19)
-* pdfoutput: Checking for PDF output.
- (line 20)
* pdftex (hyperlink driver): Hyperlink drivers pdftex and dvipdfm.
(line 6)
* percentchar: Category codes. (line 54)
@@ -6732,7 +6583,7 @@
(line 26)
* printcitestart: Formatting citations.
(line 15)
-* printitem: Formatting lists. (line 51)
+* printitem: Formatting lists. (line 50)
* printlistinglineno: Verbatim listing. (line 19)
* printlistinglineno <1>: Verbatim listing. (line 27)
* providecommand: Commands from LaTeX. (line 18)
@@ -6763,7 +6614,7 @@
* ref: Using generic references.
(line 16)
* ref <1>: Hyperlinks (xhyper.tex).
- (line 7)
+ (line 8)
* ref (hyperlinks): Cross-reference hyperlinks.
(line 19)
* refn: Using generic references.
@@ -6798,7 +6649,7 @@
* righteqnumbers: Displays. (line 23)
* rightmargin: Margins. (line 17)
* rotatebox: Hyperlinks (xhyper.tex).
- (line 7)
+ (line 8)
* rt: Arrows and morphisms.
(line 14)
* sanitize: Converting to characters.
@@ -6823,7 +6674,7 @@
* setproperty: Properties. (line 13)
* setuplistinghook: Verbatim listing. (line 13)
* setuplistinghook <1>: Highlighting TeX comments in listings (lscommnt.tex).
- (line 7)
+ (line 8)
* sidx: Indexing commands. (line 8)
* sidxmarked: Indexing commands. (line 29)
* sidxname: Indexing commands. (line 19)
@@ -6873,16 +6724,16 @@
* tracingoff: Diagnostics. (line 18)
* triplecolumns: Multiple columns. (line 7)
* tt: Packages known to work.
- (line 90)
+ (line 87)
* ttfamily: Packages known to work.
- (line 86)
+ (line 84)
* uncatcodespecials: Verbatim listing. (line 57)
* uncatcodespecials <1>: Category codes. (line 49)
* unorderedlist: Lists. (line 20)
-* unorderedlistdepth: Formatting lists. (line 41)
-* unorderedmarker: Formatting lists. (line 37)
+* unorderedlistdepth: Formatting lists. (line 40)
+* unorderedmarker: Formatting lists. (line 36)
* url: Hyperlinks (xhyper.tex).
- (line 7)
+ (line 8)
* url (hyperlink type): Link types for hypertex.
(line 14)
* url (hyperlink type) <1>: Link types for pdftex and dvipdfm.
@@ -6932,7 +6783,7 @@
* width (destination option) <1>: Destination options for pdftex and dvipdfm.
(line 40)
* width (hyperlink option): Link options for pdftex and dvipdfm.
- (line 128)
+ (line 127)
* writenumberedtocentry: Writing the .toc file.
(line 13)
* writenumberedtocline: Writing the .toc file.
@@ -6951,7 +6802,7 @@
(line 10)
* xrefn (hyperlinks): Cross-reference hyperlinks.
(line 14)
-* xrefpageword: Page references. (line 18)
+* xrefpageword: Page references. (line 17)
* xrefpageword <1>: Page reference hyperlinks.
(line 10)
* xrefwarning conditional: Using generic references.
@@ -6987,11 +6838,11 @@
* .cls files: Loading LaTeX packages.
(line 6)
* .eps files: Packages known to work.
- (line 103)
+ (line 100)
* .eps files <1>: Packages known to work.
- (line 112)
-* .fmt file: Installation. (line 27)
-* .fmt file <1>: Invoking Eplain. (line 14)
+ (line 109)
+* .fmt file: Installation. (line 18)
+* .fmt file <1>: Invoking Eplain. (line 13)
* .idx files: Indexing. (line 22)
* .idx files <1>: Index hyperlinks. (line 14)
* .ind files: Indexing. (line 26)
@@ -6999,7 +6850,7 @@
* .pdf files: Checking for PDF output.
(line 6)
* .pdf files <1>: Packages known to work.
- (line 103)
+ (line 100)
* .pdf files <2>: Introduction to hyperlinks.
(line 13)
* .ps files: Introduction to hyperlinks.
@@ -7015,9 +6866,9 @@
* allocation macros: Allocation macros. (line 6)
* alphanumeric references: Citations. (line 128)
* AMSLaTeX: Logos. (line 10)
-* amsppt.sty: Invoking Eplain. (line 92)
+* amsppt.sty: Invoking Eplain. (line 91)
* AMSTeX: Logos. (line 10)
-* AMSTeX conflicts: Invoking Eplain. (line 92)
+* AMSTeX conflicts: Invoking Eplain. (line 91)
* arguments, ignoring: Macro arguments. (line 6)
* arrows: Arrows and morphisms.
(line 6)
@@ -7041,7 +6892,7 @@
* bibliography, formatting the: Formatting bibliographies.
(line 6)
* bibliography, hyperlinks: Citation hyperlinks. (line 11)
-* bibtex: Invoking Eplain. (line 103)
+* bibtex: Invoking Eplain. (line 102)
* BibTeX: Citations. (line 9)
* BibTeX <1>: Logos. (line 10)
* black boxes: Boxes. (line 6)
@@ -7089,7 +6940,7 @@
* color: Packages known to work.
(line 25)
* color, demo: Hyperlinks (xhyper.tex).
- (line 7)
+ (line 8)
* color, hyperlink border: Link options for pdftex and dvipdfm.
(line 13)
* color, hyperlinks: URL hyperlinks. (line 17)
@@ -7107,7 +6958,7 @@
* color.sty <3>: Setting default types and options.
(line 27)
* color.sty <4>: Hyperlinks (xhyper.tex).
- (line 7)
+ (line 8)
* colored links: URL hyperlinks. (line 17)
* colored links <1>: Options supported by all drivers.
(line 37)
@@ -7120,7 +6971,7 @@
* commas in cross-referencing index entries: Customizing indexing.
(line 62)
* comments, highlighting in listings: Highlighting TeX comments in listings (lscommnt.tex).
- (line 7)
+ (line 8)
* commutative diagrams: Commutative diagrams.
(line 6)
* contents: Contents. (line 6)
@@ -7139,7 +6990,7 @@
* cross-references, defining general <1>: Using generic references.
(line 6)
* cross-references, demo: Hyperlinks (xhyper.tex).
- (line 7)
+ (line 8)
* cross-references, hyperlinks: Cross-reference hyperlinks.
(line 6)
* cross-referencing index entries: Modifying index entries.
@@ -7174,12 +7025,12 @@
* destgroup options <1>: Setting group options.
(line 6)
* destgroup options, demo: Hyperlinks (xhyper.tex).
- (line 7)
+ (line 8)
* destgroup type: Setting hyperlink types and options.
(line 12)
* destgroup type <1>: Setting group types. (line 6)
* destgroup type, demo: Hyperlinks (xhyper.tex).
- (line 7)
+ (line 8)
* destgroup 'bib': Citation hyperlinks. (line 11)
* destgroup 'definexref': Cross-reference hyperlinks.
(line 6)
@@ -7239,12 +7090,12 @@
* destinations, group options <1>: Setting group options.
(line 6)
* destinations, group options, demo: Hyperlinks (xhyper.tex).
- (line 7)
+ (line 8)
* destinations, group type: Setting hyperlink types and options.
(line 12)
* destinations, group type <1>: Setting group types. (line 6)
* destinations, group type, demo: Hyperlinks (xhyper.tex).
- (line 7)
+ (line 8)
* destinations, in another file: Link types for hypertex.
(line 21)
* destinations, in another file <1>: Link types for pdftex and dvipdfm.
@@ -7267,9 +7118,9 @@
(line 31)
* destinations, raising: Options supported by all drivers.
(line 13)
-* destinations, URL: Link types for hypertex.
+* destinations, url: Link types for hypertex.
(line 14)
-* destinations, URL <1>: Link types for pdftex and dvipdfm.
+* destinations, url <1>: Link types for pdftex and dvipdfm.
(line 25)
* detecting numbers: \ifinteger and \isinteger.
(line 6)
@@ -7277,11 +7128,11 @@
* Diagram, macros for LaTeX: Construction of commutative diagrams.
(line 79)
* dimensions, hyperlink: Link options for pdftex and dvipdfm.
- (line 122)
+ (line 121)
* dimensions, hyperlink <1>: Link options for pdftex and dvipdfm.
- (line 125)
+ (line 124)
* dimensions, hyperlink <2>: Link options for pdftex and dvipdfm.
- (line 128)
+ (line 127)
* dimensions, hyperlink destination: Destination options for pdftex and dvipdfm.
(line 34)
* dimensions, hyperlink destination <1>: Destination options for pdftex and dvipdfm.
@@ -7311,7 +7162,7 @@
(line 24)
* do...while loops: Iteration. (line 6)
* draft, option for graphics.sty: Packages known to work.
- (line 82)
+ (line 80)
* driver dvipdfm: Hyperlink drivers pdftex and dvipdfm.
(line 6)
* driver hypertex: Hyperlink driver hypertex.
@@ -7347,15 +7198,17 @@
* eject in multicolumns: Multiple columns. (line 14)
* electronic mail addresses, breaking: Paths. (line 6)
* electronic mail addresses, breaking <1>: Packages known to work.
- (line 133)
+ (line 130)
* empty argument, checking for: \ifempty. (line 6)
* empty equation labels: Equation references. (line 22)
* empty equation labels, referring to: Equation references. (line 27)
* empty string, checking for: \ifempty. (line 6)
* Encapsulated PostScript: Packages known to work.
- (line 103)
+ (line 100)
* Encapsulated PostScript <1>: Packages known to work.
- (line 112)
+ (line 109)
+* engines, testing for: Checking for PDF output.
+ (line 19)
* environments, user-defined: User-defined environments.
(line 6)
* Eplain, installing: Installation. (line 6)
@@ -7362,16 +7215,16 @@
* Eplain, invoking: Invoking Eplain. (line 6)
* Eplain, purpose of: Introduction. (line 6)
* Eplain, upgrading: Installation. (line 6)
-* eplain.aux: Installation. (line 40)
-* eplain.fmt: Installation. (line 27)
+* eplain.aux: Installation. (line 29)
+* eplain.fmt: Installation. (line 18)
* EPS: Packages known to work.
- (line 103)
+ (line 100)
* EPS <1>: Packages known to work.
- (line 112)
+ (line 109)
* epstopdf: Packages known to work.
- (line 103)
+ (line 100)
* epstopdf.sty: Packages known to work.
- (line 101)
+ (line 98)
* equation labels, characters valid in: Equation references. (line 54)
* equation numbers, formatting of: Formatting equation references.
(line 6)
@@ -7393,7 +7246,7 @@
* expansion, one-level: \expandonce. (line 6)
* explicit hyperlinks: Explicit hyperlinks. (line 6)
* explicit hyperlinks, demo: Hyperlinks (xhyper.tex).
- (line 7)
+ (line 8)
* ExTeX: Logos. (line 10)
* file, hyperlink to: Link types for hypertex.
(line 21)
@@ -7404,10 +7257,10 @@
* file: links: General hyperlinks. (line 37)
* filenames, breaking: Paths. (line 6)
* filenames, breaking <1>: Packages known to work.
- (line 133)
+ (line 130)
* files, verbatim listing of: Verbatim listing. (line 6)
* files, verbatim listing of, demo: Highlighting TeX comments in listings (lscommnt.tex).
- (line 7)
+ (line 8)
* filtering index entries with hyperlinks: Exact destinations for index terms.
(line 33)
* footnotes, hyperlinks: Footnote hyperlinks. (line 6)
@@ -7415,7 +7268,7 @@
* for loops: Iteration. (line 6)
* form feed character, and verbatim listing: Verbatim listing.
(line 30)
-* format file: Installation. (line 27)
+* format file: Installation. (line 18)
* formatting index entries: Typesetting an index.
(line 35)
* fractions: Fractions. (line 6)
@@ -7436,9 +7289,9 @@
* graphics collection, LaTeX <2>: Hyperlink driver nolinks.
(line 34)
* graphics collection, LaTeX, demo: Hyperlinks (xhyper.tex).
- (line 7)
+ (line 8)
* graphics, omitting typesetting of: Packages known to work.
- (line 82)
+ (line 80)
* graphics, problems with pdfTeX: Packages known to work.
(line 30)
* graphics.sty: Packages known to work.
@@ -7446,7 +7299,7 @@
* graphicx.sty: Packages known to work.
(line 23)
* graphicx.sty <1>: Hyperlinks (xhyper.tex).
- (line 7)
+ (line 8)
* grid: Construction of commutative diagrams.
(line 79)
* group option list: Setting group options.
@@ -7456,12 +7309,12 @@
* group options, hyperlink <1>: Setting group options.
(line 6)
* group options, hyperlink, demo: Hyperlinks (xhyper.tex).
- (line 7)
+ (line 8)
* group type, hyperlink: Setting hyperlink types and options.
(line 12)
* group type, hyperlink <1>: Setting group types. (line 6)
* group type, hyperlink, demo: Hyperlinks (xhyper.tex).
- (line 7)
+ (line 8)
* group '' (empty): Setting group types. (line 17)
* group '*': Setting group types. (line 26)
* group 'bib': Citation hyperlinks. (line 11)
@@ -7498,11 +7351,11 @@
(line 41)
* help messages: Diagnostics. (line 24)
* highlight modes, hyperlink: Link options for pdftex and dvipdfm.
- (line 69)
+ (line 68)
* highlighting: Packages known to work.
- (line 123)
+ (line 120)
* highlighting, in listings: Highlighting TeX comments in listings (lscommnt.tex).
- (line 7)
+ (line 8)
* hooks: Hooks. (line 6)
* hyperlink border color: Link options for pdftex and dvipdfm.
(line 13)
@@ -7538,11 +7391,11 @@
* hyperlink destination, raising: Options supported by all drivers.
(line 13)
* hyperlink dimensions: Link options for pdftex and dvipdfm.
- (line 122)
+ (line 121)
* hyperlink dimensions <1>: Link options for pdftex and dvipdfm.
- (line 125)
+ (line 124)
* hyperlink dimensions <2>: Link options for pdftex and dvipdfm.
- (line 128)
+ (line 127)
* hyperlink driver dvipdfm: Hyperlink drivers pdftex and dvipdfm.
(line 6)
* hyperlink driver hypertex: Hyperlink driver hypertex.
@@ -7576,7 +7429,7 @@
(line 6)
* hyperlinks, default type <1>: Setting group types. (line 17)
* hyperlinks, demo: Hyperlinks (xhyper.tex).
- (line 7)
+ (line 8)
* hyperlinks, disabling: Hyperlink driver nolinks.
(line 6)
* hyperlinks, disabling <1>: Turning hyperlinks on/off.
@@ -7585,7 +7438,7 @@
(line 6)
* hyperlinks, explicit: Explicit hyperlinks. (line 6)
* hyperlinks, explicit, demo: Hyperlinks (xhyper.tex).
- (line 7)
+ (line 8)
* hyperlinks, filtering index entries: Exact destinations for index terms.
(line 33)
* hyperlinks, footnotes: Footnote hyperlinks. (line 6)
@@ -7596,15 +7449,15 @@
* hyperlinks, group options <1>: Setting group options.
(line 6)
* hyperlinks, group options, demo: Hyperlinks (xhyper.tex).
- (line 7)
+ (line 8)
* hyperlinks, group type: Setting hyperlink types and options.
(line 12)
* hyperlinks, group type <1>: Setting group types. (line 6)
* hyperlinks, highlight mode: Link options for pdftex and dvipdfm.
- (line 69)
+ (line 68)
* hyperlinks, implicit: Implicit hyperlinks. (line 6)
* hyperlinks, implicit, demo: Hyperlinks (xhyper.tex).
- (line 7)
+ (line 8)
* hyperlinks, index: Index hyperlinks. (line 6)
* hyperlinks, index destination placement: Choosing destination placement.
(line 6)
@@ -7616,7 +7469,7 @@
(line 33)
* hyperlinks, lists: List hyperlinks. (line 6)
* hyperlinks, opening in a new window: Link options for pdftex and dvipdfm.
- (line 90)
+ (line 89)
* hyperlinks, page references: Page reference hyperlinks.
(line 6)
* hyperlinks, preserving page-breaking: Hyperlink driver nolinks.
@@ -7632,11 +7485,11 @@
(line 40)
* hyperlinks, to another file <2>: Link types for pdftex and dvipdfm.
(line 52)
-* hyperlinks, URL: General hyperlinks. (line 20)
-* hyperlinks, URL <1>: URL hyperlinks. (line 6)
-* hyperlinks, URL <2>: Link types for hypertex.
+* hyperlinks, url: General hyperlinks. (line 20)
+* hyperlinks, url <1>: URL hyperlinks. (line 6)
+* hyperlinks, url <2>: Link types for hypertex.
(line 14)
-* hyperlinks, URL <3>: Link types for pdftex and dvipdfm.
+* hyperlinks, url <3>: Link types for pdftex and dvipdfm.
(line 25)
* hyperref.sty: Packages known not to work.
(line 9)
@@ -7652,17 +7505,17 @@
(line 6)
* hypertext links: Hyperlinks. (line 6)
* Höppner, Klaus: Packages known to work.
- (line 96)
+ (line 93)
* identifying numbers: \ifinteger and \isinteger.
(line 6)
* idxuniq: Exact destinations for index terms.
(line 33)
-* ifpdf.sty: Checking for PDF output.
- (line 24)
+* iftex.sty: Checking for PDF output.
+ (line 19)
* ignoring arguments: Macro arguments. (line 6)
* implicit hyperlinks: Implicit hyperlinks. (line 6)
* implicit hyperlinks, demo: Hyperlinks (xhyper.tex).
- (line 7)
+ (line 8)
* inaccessible macros: Category codes. (line 19)
* index entries and ranges: Modifying index entries.
(line 22)
@@ -7718,7 +7571,7 @@
* indexing and trailing spaces: Indexing terms. (line 20)
* indexing commands: Indexing commands. (line 6)
* indexing terms: Indexing terms. (line 6)
-* insertion classes: Multiple columns. (line 38)
+* insertion classes: Multiple columns. (line 45)
* inset hyperlink border: Link options for pdftex and dvipdfm.
(line 25)
* installation: Installation. (line 6)
@@ -7726,12 +7579,12 @@
(line 6)
* italic correction: Formatting bibliographies.
(line 45)
-* item labels, changing: Formatting lists. (line 53)
+* item labels, changing: Formatting lists. (line 52)
* iteration: Iteration. (line 6)
* justification: Justification. (line 6)
* Knuth, Donald Ervin: Citations. (line 91)
* Knuth, Donald Ervin <1>: Category codes. (line 7)
-* labels on items, changing: Formatting lists. (line 53)
+* labels on items, changing: Formatting lists. (line 52)
* labels, characters valid in: Cross-references. (line 20)
* labels, empty equation: Equation references. (line 22)
* labels, empty equation, referring to: Equation references. (line 27)
@@ -7758,7 +7611,7 @@
* LaTeX graphics collection <2>: Hyperlink driver nolinks.
(line 34)
* LaTeX graphics collection, demo: Hyperlinks (xhyper.tex).
- (line 7)
+ (line 8)
* LaTeX packages: Loading LaTeX packages.
(line 6)
* LaTeX packages <1>: Packages known to work.
@@ -7771,7 +7624,7 @@
* left-justification: Justification. (line 6)
* left-justification of displays: Displays. (line 6)
* letterspacing: Packages known to work.
- (line 123)
+ (line 120)
* linear systems theory: Construction of commutative diagrams.
(line 38)
* lines: Slanted lines and vectors.
@@ -7800,7 +7653,7 @@
* link, group options <1>: Setting group options.
(line 6)
* link, group options, demo: Hyperlinks (xhyper.tex).
- (line 7)
+ (line 8)
* link, group type: Setting hyperlink types and options.
(line 12)
* link, group type <1>: Setting group types. (line 6)
@@ -7810,7 +7663,7 @@
* linkgroup options <1>: Setting group options.
(line 6)
* linkgroup options, demo: Hyperlinks (xhyper.tex).
- (line 7)
+ (line 8)
* linkgroup type: Setting hyperlink types and options.
(line 12)
* linkgroup type <1>: Setting group types. (line 6)
@@ -7836,7 +7689,7 @@
(line 6)
* listing files: Verbatim listing. (line 6)
* listing files, demo: Highlighting TeX comments in listings (lscommnt.tex).
- (line 7)
+ (line 8)
* lists: Lists. (line 6)
* lists, formatting: Formatting lists. (line 6)
* lists, hyperlinks: List hyperlinks. (line 6)
@@ -7846,10 +7699,10 @@
* lookahead without spaces: \futurenonspacelet. (line 6)
* loops: Iteration. (line 6)
* lscommnt.tex: Highlighting TeX comments in listings (lscommnt.tex).
- (line 7)
+ (line 8)
* magnification, hyperlink destination: Destination options for pdftex and dvipdfm.
(line 21)
-* makeindex: Invoking Eplain. (line 103)
+* makeindex: Invoking Eplain. (line 102)
* makeindex <1>: Indexing. (line 14)
* makeindex <2>: Index hyperlinks. (line 12)
* margins, changing: Margins. (line 6)
@@ -7879,7 +7732,7 @@
(line 18)
* names, of TeX variants: Logos. (line 6)
* new window, opening hyperlink in: Link options for pdftex and dvipdfm.
- (line 90)
+ (line 89)
* newlinechar: Diagnostics. (line 26)
* newlines, obeying: Obeying spaces. (line 6)
* nolinks, hyperlink driver: Hyperlink driver nolinks.
@@ -7891,15 +7744,14 @@
* numbers, detecting: \ifinteger and \isinteger.
(line 6)
* numbers, written form of: Writing out numbers. (line 6)
-* Oberdiek, Heiko: Checking for PDF output.
- (line 24)
* omitting hyperlinks: Hyperlink driver nolinks.
(line 6)
* omitting hyperlinks <1>: Turning hyperlinks on/off.
(line 6)
* omitting typesetting of graphics: Packages known to work.
- (line 82)
+ (line 80)
* open boxes: Boxes. (line 12)
+* OpTeX: Introduction. (line 70)
* option list, group: Setting group options.
(line 48)
* option list, preserving for group: Setting group options.
@@ -7927,7 +7779,7 @@
* output routine and index proofing: Proofing index terms.
(line 28)
* overstriking: Packages known to work.
- (line 123)
+ (line 120)
* packages, LaTeX: Loading LaTeX packages.
(line 6)
* packages, LaTeX <1>: Packages known to work.
@@ -7949,16 +7801,14 @@
* Patashnik, Oren: Citations. (line 9)
* pathnames, breaking: Paths. (line 6)
* pathnames, breaking <1>: Packages known to work.
- (line 133)
+ (line 130)
* PDF: Packages known to work.
- (line 103)
+ (line 100)
* PDF outlines (a.k.a. bookmarks): Making PDF outlines. (line 6)
* PDF output: Checking for PDF output.
(line 6)
* pdftex: Invoking Eplain. (line 114)
-* pdftex <1>: Checking for PDF output.
- (line 6)
-* pdftex <2>: Introduction to hyperlinks.
+* pdftex <1>: Introduction to hyperlinks.
(line 35)
* pdftex, destination options: Destination options for pdftex and dvipdfm.
(line 6)
@@ -7982,7 +7832,7 @@
* picture mode <1>: Slanted lines and vectors.
(line 7)
* Portable Document Format: Packages known to work.
- (line 103)
+ (line 100)
* PostScript point: Destination types for pdftex and dvipdfm.
(line 66)
* PostScript point <1>: Destination options for pdftex and dvipdfm.
@@ -7997,7 +7847,7 @@
* ps2pdf <1>: Hyperlink driver hypertex.
(line 35)
* psfrag.sty: Packages known to work.
- (line 110)
+ (line 107)
* quadruple column output: Multiple columns. (line 6)
* Rahtz, Sebastian: Loading LaTeX packages.
(line 14)
@@ -8017,6 +7867,7 @@
(line 6)
* references, numbered: Citations. (line 91)
* register allocation: Allocation macros. (line 6)
+* registers, scratch: Scratch registers. (line 6)
* restoring \input, LaTeX packages: Environment for loading packages.
(line 24)
* return character: Category codes. (line 40)
@@ -8025,13 +7876,14 @@
* rotation: Packages known to work.
(line 25)
* rotation, demo: Hyperlinks (xhyper.tex).
- (line 7)
+ (line 8)
* rule thickness: Rules. (line 7)
* run: links: General hyperlinks. (line 38)
* scaling: Packages known to work.
(line 25)
* scaling, demo: Hyperlinks (xhyper.tex).
- (line 7)
+ (line 8)
+* scratch registers: Scratch registers. (line 6)
* sed: Customizing indexing.
(line 64)
* see also index entries and hyperlinks: Hyperlinks in see and see also entries.
@@ -8055,7 +7907,7 @@
* sorting an index: Indexing. (line 6)
* sorting of index entries: Indexing commands. (line 50)
* soul.sty: Packages known to work.
- (line 121)
+ (line 118)
* space above index entries: Typesetting an index.
(line 35)
* spaces, ignoring: \futurenonspacelet. (line 6)
@@ -8062,7 +7914,7 @@
* spaces, obeying: Obeying spaces. (line 6)
* spaces, trailing and indexing commands: Indexing terms. (line 20)
* spacing out: Packages known to work.
- (line 123)
+ (line 120)
* spacing, preserving with hyperlinks: Hyperlink driver nolinks.
(line 6)
* special characters: Verbatim listing. (line 57)
@@ -8072,7 +7924,7 @@
(line 49)
* Stallman, Richard: Introduction. (line 16)
* striking out: Packages known to work.
- (line 123)
+ (line 120)
* style, hyperlink border: Link options for pdftex and dvipdfm.
(line 25)
* subequations, referring to: Subequation references.
@@ -8094,12 +7946,12 @@
* TeX by Topic: Iteration. (line 61)
* TeX Frequently Asked Questions: \ifinteger and \isinteger.
(line 26)
-* TEXFORMATS: Installation. (line 43)
-* texi2dvi: Invoking Eplain. (line 103)
+* TEXFORMATS: Installation. (line 32)
+* texi2dvi: Invoking Eplain. (line 102)
* texi2dvi <1>: Citations. (line 102)
* texi2dvi <2>: Indexing. (line 32)
* Texinfo: Introduction. (line 15)
-* TEXINPUTS: Installation. (line 23)
+* TEXINPUTS: Installation. (line 15)
* texnames.sty: Logos. (line 15)
* time of day: Time of day. (line 6)
* toc files, writing several: Changing the .toc file's root name.
@@ -8111,7 +7963,7 @@
* triple column output: Multiple columns. (line 6)
* Tu, Loring W.: Construction of commutative diagrams.
(line 13)
-* TUGboat: Introduction. (line 65)
+* TUGboat: Introduction. (line 59)
* type, link and destination: Introduction to hyperlinks.
(line 88)
* types, destination, dvipdfm: Destination types for pdftex and dvipdfm.
@@ -8129,11 +7981,11 @@
* typesetting an index: Typesetting an index.
(line 6)
* undefined control sequence, checking for: \ifundefined. (line 10)
-* undefined labels, warnings about: Installation. (line 40)
+* undefined labels, warnings about: Installation. (line 29)
* underline hyperlink border: Link options for pdftex and dvipdfm.
(line 25)
* underlining: Packages known to work.
- (line 123)
+ (line 120)
* underlining page numbers in index: Page list and page range parsers.
(line 26)
* universal mapping property: Construction of commutative diagrams.
@@ -8140,32 +7992,30 @@
(line 25)
* unordered lists: Lists. (line 6)
* upgrading: Installation. (line 6)
-* URL for path.sty: Paths. (line 33)
-* URL for pdfTeX: Checking for PDF output.
- (line 6)
-* URL hyperlink: General hyperlinks. (line 20)
-* URL hyperlink <1>: URL hyperlinks. (line 6)
-* URL hyperlink <2>: Link types for hypertex.
+* url for path.sty: Paths. (line 33)
+* url hyperlink: General hyperlinks. (line 20)
+* url hyperlink <1>: URL hyperlinks. (line 6)
+* url hyperlink <2>: Link types for hypertex.
(line 14)
-* URL hyperlink <3>: Link types for pdftex and dvipdfm.
+* url hyperlink <3>: Link types for pdftex and dvipdfm.
(line 25)
* url.sty: Packages known to work.
- (line 131)
+ (line 128)
* url.sty <1>: URL hyperlinks. (line 6)
* url.sty <2>: Hyperlinks (xhyper.tex).
- (line 7)
+ (line 8)
* user-inaccessible macros: Category codes. (line 19)
* vectors: Slanted lines and vectors.
(line 15)
* verbatim listing: Verbatim listing. (line 6)
* verbatim listing, demo: Highlighting TeX comments in listings (lscommnt.tex).
- (line 7)
+ (line 8)
* verbatim text, in index: Index entries with special characters.
(line 40)
* verbatim text, in table of contents: Writing the .toc file.
(line 49)
-* version number: Introduction. (line 51)
-* Walden, David: Introduction. (line 62)
+* version number: Introduction. (line 49)
+* Walden, David: Introduction. (line 56)
* Warner, Frank W.: Construction of commutative diagrams.
(line 25)
* whatsits made by hyperlinks: Hyperlink driver nolinks.
@@ -8185,7 +8035,7 @@
* xeplain.tex: Introduction. (line 6)
* XeTeX: Logos. (line 11)
* xhyper.tex: Hyperlinks (xhyper.tex).
- (line 7)
+ (line 8)
* Zassenhaus, Hans: Construction of commutative diagrams.
(line 121)
* zooming, hyperlink destination: Destination options for pdftex and dvipdfm.
@@ -8194,131 +8044,132 @@
Tag Table:
-Node: Top798
-Node: Introduction8129
-Node: Installation11170
-Node: Invoking Eplain13222
-Node: User definitions17820
-Node: Diagnostics19647
-Node: Rules21212
-Node: Citations22043
-Node: Formatting citations28471
-Node: Formatting bibliographies30010
-Node: Commands from LaTeX33246
-Node: Displays34220
-Node: Formatting displays35607
-Node: Time of day36240
-Node: Lists36999
-Node: Formatting lists39139
-Node: Verbatim listing41422
-Node: Contents44642
-Node: Writing the .toc file45311
-Node: Reading the .toc file48173
-Node: Changing the .toc file's root name49576
-Node: Alternative contents files50592
-Node: Cross-references51156
-Node: Defining generic references52636
-Node: Using generic references53512
-Node: Page references54796
-Node: Equation references55615
-Node: Formatting equation references58367
-Node: Subequation references62717
-Node: Indexing64633
-Node: Indexing terms67655
-Node: Indexing commands68767
-Node: Modifying index entries71728
-Node: Index entries with special characters74696
-Node: Proofing index terms78938
-Node: Typesetting an index80751
-Node: Customizing indexing83217
-Node: Justification86913
-Node: Tables90008
-Node: Margins92499
-Node: Multiple columns94652
-Node: Footnotes96689
-Node: Fractions99264
-Node: Paths100047
-Node: Logos101603
-Node: Boxes102386
-Node: Checking for PDF output104172
-Node: Loading LaTeX packages105198
-Node: The \usepackage command106400
-Node: Environment for loading packages107486
-Node: Packages known to work109826
-Node: Packages known not to work116576
-Node: Hyperlinks117349
-Node: Introduction to hyperlinks117998
-Node: Explicit hyperlinks123535
-Node: Implicit hyperlinks125820
-Node: General hyperlinks127641
-Node: URL hyperlinks129164
-Node: Citation hyperlinks131264
-Node: List hyperlinks131991
-Node: Cross-reference hyperlinks132382
-Node: Page reference hyperlinks133753
-Node: Equation reference hyperlinks134414
-Node: Index hyperlinks135804
-Node: Exact destinations for index terms137562
-Node: Page destinations for index terms139729
-Node: Choosing destination placement142347
-Node: Index page list and page range parsers143136
-Node: Hyperlinks in see and see also entries143688
-Node: Footnote hyperlinks144486
-Node: Contents hyperlinks145680
-Node: Hyperlink drivers146063
-Node: Options supported by all drivers146697
-Node: Hyperlink driver hypertex149493
-Node: Destination types for hypertex152429
-Node: Destination options for hypertex153463
-Node: Link types for hypertex153945
-Node: Link options for hypertex155953
-Node: Hyperlink drivers pdftex and dvipdfm156975
-Node: Destination types for pdftex and dvipdfm157620
-Node: Destination options for pdftex and dvipdfm161099
-Node: Link types for pdftex and dvipdfm163550
-Node: Link options for pdftex and dvipdfm167070
-Node: Hyperlink driver nolinks170708
-Node: Setting hyperlink types and options173111
-Node: Setting default types and options174112
-Node: Setting group types175538
-Node: Setting group options176727
-Node: Turning hyperlinks on/off179208
-Node: Turning low-level commands on/off179874
-Node: Turning hyperlinks on/off for a group180387
-Node: Making PDF outlines181540
-Node: Arrow theoretic diagrams184425
-Node: Slanted lines and vectors184792
-Node: Commutative diagrams186866
-Node: Arrows and morphisms187463
-Node: Construction of commutative diagrams191918
-Node: Commutative diagram parameters199083
-Node: Programming definitions200899
-Node: Category codes201900
-Node: Allocation macros204545
-Node: Iteration206680
-Node: Macro arguments208332
-Node: Converting to characters211707
-Node: Expansion213092
-Node: \csn and \ece213655
-Node: \edefappend214220
-Node: Hooks214767
-Node: Properties216941
-Node: \expandonce218020
-Node: \ifundefined218468
-Node: \ifempty219032
-Node: \ifinteger and \isinteger219774
-Node: \futurenonspacelet220814
-Node: Obeying spaces221415
-Node: Writing out numbers222439
-Node: Mode-specific penalties222762
-Node: Auxiliary files223491
-Node: User-defined environments224410
-Node: Page list and page range parsers225623
-Node: Demo files227755
-Node: Hyperlinks (xhyper.tex)228322
-Node: Highlighting TeX comments in listings (lscommnt.tex)236671
-Node: Macro index239127
-Node: Concept index307988
+Node: Top801
+Node: Introduction2219
+Node: Installation5572
+Node: Invoking Eplain6888
+Node: User definitions11442
+Node: Diagnostics13269
+Node: Rules14834
+Node: Citations15665
+Node: Formatting citations22093
+Node: Formatting bibliographies23632
+Node: Commands from LaTeX26868
+Node: Displays27842
+Node: Formatting displays29229
+Node: Time of day29862
+Node: Lists30621
+Node: Formatting lists32761
+Node: Verbatim listing35044
+Node: Contents38264
+Node: Writing the .toc file38933
+Node: Reading the .toc file41795
+Node: Changing the .toc file's root name43198
+Node: Alternative contents files44214
+Node: Cross-references44778
+Node: Defining generic references46258
+Node: Using generic references47134
+Node: Page references48418
+Node: Equation references49237
+Node: Formatting equation references51989
+Node: Subequation references56339
+Node: Indexing58248
+Node: Indexing terms61270
+Node: Indexing commands62382
+Node: Modifying index entries65343
+Node: Index entries with special characters68311
+Node: Proofing index terms72554
+Node: Typesetting an index74367
+Node: Customizing indexing76833
+Node: Justification80522
+Node: Tables83617
+Node: Margins86108
+Node: Multiple columns88261
+Node: Footnotes90662
+Node: Fractions93237
+Node: Paths94020
+Node: Logos95576
+Node: Boxes96360
+Node: Checking for PDF output98146
+Node: Loading LaTeX packages99066
+Node: The \usepackage command100349
+Node: Environment for loading packages101435
+Node: Packages known to work103775
+Node: Packages known not to work110463
+Node: Hyperlinks111236
+Node: Introduction to hyperlinks111885
+Node: Explicit hyperlinks117423
+Node: Implicit hyperlinks119708
+Node: General hyperlinks121529
+Node: URL hyperlinks123052
+Node: Citation hyperlinks125154
+Node: List hyperlinks125881
+Node: Cross-reference hyperlinks126272
+Node: Page reference hyperlinks127643
+Node: Equation reference hyperlinks128304
+Node: Index hyperlinks129694
+Node: Exact destinations for index terms131452
+Node: Page destinations for index terms133612
+Node: Choosing destination placement136230
+Node: Index page list and page range parsers137019
+Node: Hyperlinks in see and see also entries137571
+Node: Footnote hyperlinks138369
+Node: Contents hyperlinks139563
+Node: Hyperlink drivers139946
+Node: Options supported by all drivers140580
+Node: Hyperlink driver hypertex143376
+Node: Destination types for hypertex146297
+Node: Destination options for hypertex147331
+Node: Link types for hypertex147813
+Node: Link options for hypertex149821
+Node: Hyperlink drivers pdftex and dvipdfm150843
+Node: Destination types for pdftex and dvipdfm151488
+Node: Destination options for pdftex and dvipdfm154967
+Node: Link types for pdftex and dvipdfm157418
+Node: Link options for pdftex and dvipdfm160938
+Node: Hyperlink driver nolinks164576
+Node: Setting hyperlink types and options166979
+Node: Setting default types and options167980
+Node: Setting group types169406
+Node: Setting group options170595
+Node: Turning hyperlinks on/off173076
+Node: Turning low-level commands on/off173742
+Node: Turning hyperlinks on/off for a group174255
+Node: Making PDF outlines175408
+Node: Arrow theoretic diagrams178293
+Node: Slanted lines and vectors178660
+Node: Commutative diagrams180734
+Node: Arrows and morphisms181331
+Node: Construction of commutative diagrams185786
+Node: Commutative diagram parameters192951
+Node: Programming definitions194767
+Node: Category codes195768
+Node: Allocation macros198413
+Node: Scratch registers200580
+Node: Iteration201616
+Node: Macro arguments203268
+Node: Converting to characters206643
+Node: Expansion208028
+Node: \csn and \ece208591
+Node: \edefappend209156
+Node: Hooks209703
+Node: Properties211877
+Node: \expandonce212956
+Node: \ifundefined213404
+Node: \ifempty213968
+Node: \ifinteger and \isinteger214710
+Node: \futurenonspacelet215728
+Node: Obeying spaces216329
+Node: Writing out numbers217353
+Node: Mode-specific penalties217676
+Node: Auxiliary files218405
+Node: User-defined environments219324
+Node: Page list and page range parsers220537
+Node: Demo files222669
+Node: Hyperlinks (xhyper.tex)223236
+Node: Highlighting TeX comments in listings (lscommnt.tex)231638
+Node: Macro index234095
+Node: Concept index302817
End Tag Table
Modified: trunk/Master/texmf-dist/doc/man/man1/eplain.1
===================================================================
--- trunk/Master/texmf-dist/doc/man/man1/eplain.1 2022-10-06 19:59:20 UTC (rev 64636)
+++ trunk/Master/texmf-dist/doc/man/man1/eplain.1 2022-10-06 19:59:53 UTC (rev 64637)
@@ -1,4 +1,4 @@
-.TH EPLAIN 1 "30 September 2013" "Eplain 3.6"
+.TH EPLAIN 1 "2 October 2022" "Eplain 3.12"
.\"=====================================================================
.if t .ds TX \fRT\\h'-0.1667m'\\v'0.20v'E\\v'-0.20v'\\h'-0.125m'X\fP
.if n .ds TX TeX
@@ -8,13 +8,6 @@
.\" BX definition must follow TX so BX can use TX
.if t .ds BX \fRB\s-2IB\s0\fP\*(TX
.if n .ds BX BibTeX
-.\" LX definition must follow TX so LX can use TX
-.if t .ds LX \fRL\\h'-0.36m'\\v'-0.15v'\s-2A\s0\\h'-0.15m'\\v'0.15v'\fP\*(TX
-.if n .ds LX LaTeX
-.if t .ds AX \fRA\\h'-0.1667m'\\v'0.20v'M\\v'-0.20v'\\h'-0.125m'S\fP\*(TX
-.if n .ds AX AmSTeX
-.if t .ds AY \fRA\\h'-0.1667m'\\v'0.20v'M\\v'-0.20v'\\h'-0.125m'S\fP\*(LX
-.if n .ds AY AmSLaTeX
.\"=====================================================================
.SH NAME
eplain \- expanded plain TeX
@@ -74,6 +67,12 @@
.IR eplain.texi .
.\"=====================================================================
.SH "SEE ALSO"
+https://tug.org/eplain/
+.br
+https://ctan.org/pkg/graphics-pln
+.br
+https://ctan.org/pkg/optex
+.PP
.BR texinfo (5),
.BR tex (1),
.br
@@ -80,8 +79,8 @@
Karl Berry,
.IR eplain ,
TUGboat 11(4), 571--572, 1990,
-http://tug.org/TUGboat/tb11-4/tb30resources.pdf.
+https://tug.org/TUGboat/tb11-4/tb30resources.pdf
.br
Paul W. Abrahams with Karl Berry and Kathryn A. Hargreaves,
.IR "\*(OX for the Impatient" ,
-http://www.gnu.org/software/teximpatient.
+https://ctan.org/pkg/impatient
Modified: trunk/Master/texmf-dist/doc/man/man1/eplain.man1.pdf
===================================================================
(Binary files differ)
Deleted: trunk/Master/texmf-dist/source/eplain/eplain-source-3.11.zip
===================================================================
(Binary files differ)
Added: trunk/Master/texmf-dist/source/eplain/eplain-source-3.12.zip
===================================================================
(Binary files differ)
Index: trunk/Master/texmf-dist/source/eplain/eplain-source-3.12.zip
===================================================================
--- trunk/Master/texmf-dist/source/eplain/eplain-source-3.12.zip 2022-10-06 19:59:20 UTC (rev 64636)
+++ trunk/Master/texmf-dist/source/eplain/eplain-source-3.12.zip 2022-10-06 19:59:53 UTC (rev 64637)
Property changes on: trunk/Master/texmf-dist/source/eplain/eplain-source-3.12.zip
___________________________________________________________________
Added: svn:mime-type
## -0,0 +1 ##
+application/octet-stream
\ No newline at end of property
Modified: trunk/Master/texmf-dist/source/eplain/xeplain.tex
===================================================================
--- trunk/Master/texmf-dist/source/eplain/xeplain.tex 2022-10-06 19:59:20 UTC (rev 64636)
+++ trunk/Master/texmf-dist/source/eplain/xeplain.tex 2022-10-06 19:59:53 UTC (rev 64637)
@@ -1,3 +1,4 @@
+% $Id: xeplain.tex 60 2022-10-05 22:42:54Z karl $
% xeplain.tex: macros for nonformatting. Written 1989--94 by (mostly)
% Karl Berry. Some additions/changes 1997--98 by Adam Lewenberg,
% with subsequent contributions from many people.
@@ -20,7 +21,7 @@
%% version = "REPLACE-WITH-VERSION",
%% date = "REPLACE-WITH-DATE",
%% filename = "xeplain.tex",
-%% email = "bug-eplain at tug.org",
+%% email = "tex-eplain at tug.org",
%% checksum = "REPLACE-WITH-CHECKSUM",
%% codetable = "ASCII",
%% supported = "yes",
@@ -30,7 +31,7 @@
%% files for author credits, etc. The original sources
%% can be found in Eplain sources in your TeX
%% distribution, on CTAN or on Eplain's home page at
-%% http://tug.org/eplain. Please base diffs or
+%% https://tug.org/eplain. Please base diffs or
%% other contributions on xeplain.tex, not the
%% stripped-down eplain.tex.",
%% }
@@ -49,10 +50,9 @@
\expandafter\let\expandafter\next\csname endinput\endcsname
\fi
\next
-% The ifpdf.sty file included below was written by Heiko Oberdiek.
-% See the complete source file (e.g., in this distribution) for
-% comments.
-%% [[[include ifpdf.sty]]]
+% The iftex.sty file included below was mainly written by Heiko Oberdiek
+% and is now maintained by the LaTeX Project.
+%% [[[include iftex.sty]]]
%
%
% Category codes, etc.
@@ -125,8 +125,7 @@
\def\@@ifempty#1#2\@emptymarkB{\ifx #1\@emptymarkA}%
%
% True if #1 is an integer. From the UK List of TeX Frequently Asked
-% Questions, http://www.tex.ac.uk/cgi-bin/texfaq2html.
-\def\@gobbleminus#1{\ifx-#1\else#1\fi}%
+% Questions, https://texfaq.org.\def\@gobbleminus#1{\ifx-#1\else#1\fi}%
\def\ifinteger#1{\ifcat_\ifnum9<1\@gobbleminus#1 _\else A\fi}%
% This is a convenience to be used in places where TeX might be
% skipping tokens, e.g., in conditionals. Usage:
@@ -3443,6 +3442,10 @@
% The basic approach is that of Appendix E of the TeXbook, p.417.
% David Guichard made significant improvements to my original implementation.
%
+% A fundamental bug is that marks are not always preserved. See:
+% https://tug.org/pipermail/tex-eplain/2021/001001.html
+% https://tug.org/pipermail/tex-eplain/2022/001049.html
+%
% The glue here (the default is intended to be one linespace) is inserted
% before double columns start, and after they end.
%
Modified: trunk/Master/texmf-dist/tex/eplain/btxmac.tex
===================================================================
--- trunk/Master/texmf-dist/tex/eplain/btxmac.tex 2022-10-06 19:59:20 UTC (rev 64636)
+++ trunk/Master/texmf-dist/tex/eplain/btxmac.tex 2022-10-06 19:59:53 UTC (rev 64637)
@@ -1,7 +1,7 @@
%% @texfile{
%% author = "Karl Berry and Oren Patashnik",
-%% version = "0.99p",
-%% date = "30 May 2019",
+%% version = "0.99q",
+%% date = "2 October 2022",
%% filename = "btxmac.tex",
%% address = "tex-eplain at tug.org",
%% supported = "yes",
@@ -8,8 +8,8 @@
%% docstring = "Defines macros that make BibTeX work with plain TeX",
%% }
% BibTeX-for-TeX macros for BibTeX 0.99c, TeX 3.0 or later.
-% Copyright 1990, 1991, 1992, 1995, 2005, 2007, 2013, 2016, 2019 Karl Berry &
-% Oren Patashnik.
+% Copyright 1990, 1991, 1992, 1995, 2005, 2007, 2013, 2016, 2019, 2022
+% Karl Berry & Oren Patashnik.
%
% Unlimited copying and redistribution of this file are permitted as
% long as this file is not modified. Modifications (and redistribution
@@ -158,7 +158,9 @@
% conflict with Babel's file plain.def.
% 30-May-19 0.99p, one missed rename of \@continuenewcommand to \@btx...,
% that made \providecommand fail.
-%
+% 02-Oct-22 0.99q, avoid using unprefixed control sequence \cs,
+% which conflicts with TUGboat's \cs. Doc updates.
+%
% The LaTeX-related commands defined in this file include
% (a) the four commands that a user types (\bibliography,
% \bibliographystyle, \cite, and \nocite);
@@ -211,10 +213,10 @@
%
% \biblabelwidth
%
-% There are fifteen other control sequences (explained later in more detail)
+% There are sixteen other control sequences (explained later in more detail)
% that the macros of this file will use if you define them---you should
% define them after the \input btxmac command but before the \bibliography
-% command. The first six begin with `\bbl' and affect fonts, spacing,
+% command. The first seven begin with `\bbl' and affect fonts, spacing,
% perhaps other characteristics of the bibliography, and which .bbl files
% get read; the next five begin with `\biblabel' and determine how labels
% are formatted in the bibliography; and the last four begin with `\print'
@@ -223,6 +225,7 @@
% \bblem
% \bblfilebasename
% \bblhook
+% \bblitemhook
% \bblnewblock
% \bblrm
% \bblsc
@@ -275,10 +278,10 @@
%
% Make an outer definition into an inner one (due to Chris Thompson).
% The arguments should be the control sequence to be defined, and the
-% new of the \outer control sequence, as characters; the control
+% name of the \outer control sequence, as characters; the control
% sequence #1 is defined to be just the same as \csname#2\endcsname, but
-% not \outer. For example, \@innerdef\innernewcount{newcount} would
-% define \innernewcount to be a non-outer version of \newcount.
+% not \outer. For example, \@innerdef\innernewcount{newcount}
+% defines \innernewcount to be a non-outer version of \newcountb.
%
\def\@innerdef#1#2{\edef#1{\expandafter\noexpand\csname #2\endcsname}}%
%
@@ -307,11 +310,11 @@
\fi
%
%
-% The following macro \@futurenonspacelet (from the TeXbook) behaves
+% The following macro \@futurenonspacelet (from The TeXbook) behaves
% essentially like \futurelet except that it discards any implicit or
% explicit space tokens that intervene before a nonspace is scanned:
%
-\long\def\@futurenonspacelet#1{\def\cs{#1}%
+\long\def\@futurenonspacelet#1{\def\@btxcs{#1}%
\afterassignment\@stepone\let\@nexttoken=
}%
\begingroup % The grouping here avoids stepping on an outside use of `\\'.
@@ -319,8 +322,8 @@
\\ % now \@stoken is a space token (\\ is a control symbol, so that
% space after it is seen).
\endgroup
-\def\@stepone{\expandafter\futurelet\cs\@steptwo}%
-\def\@steptwo{\expandafter\ifx\cs\@stoken\let\@@next=\@stepthree
+\def\@stepone{\expandafter\futurelet\@btxcs\@steptwo}%
+\def\@steptwo{\expandafter\ifx\@btxcs\@stoken\let\@@next=\@stepthree
\else\let\@@next=\@nexttoken\fi \@@next}%
\def\@stepthree{\afterassignment\@stepone\let\@@next= }%
%
@@ -796,11 +799,11 @@
\def\@btxcommandname{#1}%
%
\expandafter\ifx\@btxcommandname \@undefined
- \let\cs=\@btxcontinuenewcommand % undefined, so we'll define it
+ \let\@btxcs=\@btxcontinuenewcommand % undefined, so we'll define it
\else
- \let\cs=\@gobble % already defined, so ignore it
+ \let\@btxcs=\@gobble % already defined, so ignore it
\fi
- \@getoptionalarg\cs
+ \@getoptionalarg\@btxcs
}%
\fi
%
Modified: trunk/Master/texmf-dist/tex/eplain/eplain.tex
===================================================================
--- trunk/Master/texmf-dist/tex/eplain/eplain.tex 2022-10-06 19:59:20 UTC (rev 64636)
+++ trunk/Master/texmf-dist/tex/eplain/eplain.tex 2022-10-06 19:59:53 UTC (rev 64637)
@@ -1,10 +1,10 @@
%% @texfile{
%% author = "Karl Berry, Steven Smith, Oleg Katsitadze, and others",
-%% version = "3.11",
-%% date = "Sat Jul 4 08:41:11 PDT 2020",
+%% version = "3.12",
+%% date = "Wed Oct 5 15:43:01 PDT 2022",
%% filename = "eplain.tex",
-%% email = "bug-eplain at tug.org",
-%% checksum = "4139 9298 134361",
+%% email = "tex-eplain at tug.org",
+%% checksum = "4290 9524 139018",
%% codetable = "ASCII",
%% supported = "yes",
%% docstring = "This file defines macros that extend and expand on
@@ -13,7 +13,7 @@
%% files for author credits, etc. The original sources
%% can be found in Eplain sources in your TeX
%% distribution, on CTAN or on Eplain's home page at
-%% http://tug.org/eplain. Please base diffs or
+%% https://tug.org/eplain. Please base diffs or
%% other contributions on xeplain.tex, not the
%% stripped-down eplain.tex.",
%% }
@@ -23,53 +23,204 @@
\expandafter\let\expandafter\next\csname endinput\endcsname
\fi
\next
+%% iftex TeX engine tests
+%% LaTeX3 Project
%%
-%% This is file `ifpdf.sty',
-%% generated with the docstrip utility.
+%% This work may be distributed and/or modified under the
+%% conditions of the LaTeX Project Public License, either
+%% version 1.3c of this license or (at your option) any later
+%% version.
%%
-%% The original source files were:
+%% Using ideas from:
%%
-%% ifpdf.dtx (with options: `package')
-%%
-%% Source File: ifpdf.dtx
-%% Copyright 2016 Heiko Oberdiek and LaTeX3 project
-%%
-%% This file may be distributed under the terms of the LPPL.
-%% See README for details.
-\ifx\ProvidesPackage\undefined
-\def\next#1#2[#3]{\wlog{#2 #3}}
-\expandafter\next\fi
-\ProvidesPackage{ifpdf}
-[2016/04/04 v3.0 Provides the ifpdf switch]
-\expandafter\ifx\csname ifpdf\endcsname\relax
- \csname newif\expandafter\endcsname\csname ifpdf\endcsname
+%% ifetex Martin Scharrer
+%% ifxetex Will Robertson
+%% iftex 0.2 Persian TeX Group / Vafa Khalighi
+%% ifluatex ifvtex Heiko Oberdiek
+%% ifptex Takayuki YATO
+%% ifpdf Heiko Oberdiek and LaTeX3 Project
+\csname IFTEX\string @loaded\endcsname
+\catcode123=1
+\catcode125=2
+\catcode35=6
+\begingroup\expandafter\expandafter\expandafter\endgroup
+\expandafter\ifx\csname ProvidesPackage\endcsname\relax\else
+ \ProvidesPackage{iftex}[2022/02/03 v1.0f TeX engine tests]
+\fi
+\expandafter\chardef\csname IFTEX\string @atcatcode\endcsname\catcode64
+\catcode 64 11
+\def\IFTEX at Require#1#2#3{%
+ #1\else
+ \newlinechar 64\relax
+ \errorcontextlines -1\relax
+ \immediate\write20{@
+ ********************************************@
+ * #2 is required to compile this document.@
+ * Sorry!@
+ ********************************************}%
+ \batchmode\read -1 to \@tempa
+ #3%
+}
+\begingroup\expandafter\expandafter\expandafter\endgroup
+\expandafter\ifx\csname protected\endcsname\relax
+ \let\IFTEX at protected\relax
\else
- \ifx\pdftrue\undefined
- \ifx\PackageError\undefined
- \begingroup\def\PackageError#1#2#3{\endgroup\errmessage{#2}}
+ \let\IFTEX at protected\protected
+\fi
+ {
+ \catcode34 12 % "
+ \catcode40 12 % (
+ \catcode41 12 % )
+ \catcode44 12 % ,
+ \catcode46 12 % .
+ \expandafter\ifx\csname directlua\endcsname\relax\else
+ \directlua{tex.enableprimitives("IFTEX@", {"detokenize","protected"})}
\fi
- \PackageError{ifpdf}{incompatible ifpdf definition}{}
- \expandafter\expandafter\expandafter
- \fi
+ }
+\IFTEX at protected\def\RequireeTeX{\IFTEX at Require\ifetex{eTeX}\fi}
+\IFTEX at protected\def\RequirePDFTeX{\IFTEX at Require\ifpdftex{pdfTeX}\fi}
+\IFTEX at protected\def\RequireXeTeX{\IFTEX at Require\ifxetex{XeTeX}\fi}
+\IFTEX at protected\def\RequireLuaTeX{\IFTEX at Require\ifluatex{LuaTeX}\fi}
+\IFTEX at protected\def\RequireLuaHBTeX{\IFTEX at Require\ifluahbtex{LuaHBTeX}\fi}
+\IFTEX at protected\def\RequirepTeX{\IFTEX at Require\ifptex{pTeX}\fi}
+\IFTEX at protected\def\RequireupTeX{\IFTEX at Require\ifuptex{upTeX}\fi}
+\IFTEX at protected\def\RequirepTeXng{\IFTEX at Require\ifptexng{pTeX-ng}\fi}
+\IFTEX at protected\def\RequireVTeX{\IFTEX at Require\ifvtex{VTeX}\fi}
+\IFTEX at protected\def\RequireAlephTeX{\IFTEX at Require\ifalephtex{Aleph}\fi}
+\IFTEX at protected\def\RequireTUTeX{\IFTEX at Require\iftutex{LuaTeX or XeTeX}\fi}
+\IFTEX at protected\def\RequireTexpadTeX{\IFTEX at Require\iftexpadtex{TexpadTeX}\fi}
+\IFTEX at protected\def\RequireHINT{\IFTEX at Require\ifhint{HINT}\fi}
+\def\IFTEX at let#1#2{%
+ \expandafter\let\csname if#1\expandafter\endcsname
+ \csname if#2\endcsname}
+\begingroup\expandafter\expandafter\expandafter\endgroup
+\expandafter\ifx\csname numexpr\endcsname\relax
+ \IFTEX at let{etex}{false}
+\else
+ \IFTEX at let{etex}{true}
\fi
-\let\ifpdf\iffalse
-\ifx\directlua\undefined
+\IFTEX at let{eTeX}{etex}
\begingroup\expandafter\expandafter\expandafter\endgroup
-\expandafter\ifx\csname pdfoutput\endcsname\relax
+\expandafter\ifx\csname pdftexversion\endcsname\relax
+ \IFTEX at let{pdftex}{false}
\else
- \ifnum\pdfoutput>0 %
- \pdftrue
+ \IFTEX at let{pdftex}{true}
+\fi
+\IFTEX at let{PDFTeX}{pdftex}
+\begingroup\expandafter\expandafter\expandafter\endgroup
+\expandafter\ifx\csname XeTeXrevision\endcsname\relax
+ \IFTEX at let{xetex}{false}
+\else
+ \IFTEX at let{xetex}{true}
+\fi
+\IFTEX at let{XeTeX}{xetex}
+\begingroup\expandafter\expandafter\expandafter\endgroup
+\expandafter\ifx\csname directlua\endcsname\relax
+ \IFTEX at let{luatex}{false}
+\else
+ \IFTEX at let{luatex}{true}
+\fi
+\IFTEX at let{LuaTeX}{luatex}
+\IFTEX at let{luahbtex}{false}
+\begingroup\expandafter\expandafter\expandafter\endgroup
+\expandafter\ifx\csname directlua\endcsname\relax
+\else
+ \directlua{\IFTEX at detokenize{
+ if(pcall(require, 'luaharfbuzz')) then
+ tex.print("\\let\\ifluahbtex\\iftrue ")
+ end
+ }}
+\fi
+\IFTEX at let{LuaHBTeX}{luahbtex}
+\begingroup\expandafter\expandafter\expandafter\endgroup
+\expandafter\ifx\csname kanjiskip\endcsname\relax
+ \IFTEX at let{ptex}{false}
+\else
+ \IFTEX at let{ptex}{true}
+\fi
+\IFTEX at let{pTeX}{ptex}
+\ifx\enablecjktoken \@undefined
+ \IFTEX at let{uptex}{false}
+\else
+ \IFTEX at let{uptex}{true}
+\fi
+\IFTEX at let{upTeX}{uptex}
+\begingroup\expandafter\expandafter\expandafter\endgroup
+\expandafter\ifx\csname ngbanner\endcsname\relax
+ \IFTEX at let{ptexng}{false}
+\else
+ \IFTEX at let{ptexng}{true}
+\fi
+\IFTEX at let{pTeXng}{ptexng}
+\begingroup\expandafter\expandafter\expandafter\endgroup
+\expandafter\ifx\csname VTeXversion\endcsname\relax
+ \IFTEX at let{vtex}{false}
+\else
+ \IFTEX at let{vtex}{true}
+\fi
+\IFTEX at let{VTeX}{vtex}
+\IFTEX at let{alephtex}{false}
+\ifptex\else
+\begingroup\expandafter\expandafter\expandafter\endgroup
+\expandafter\ifx\csname omathchardef\endcsname\relax
+\else
+ \IFTEX at let{alephtex}{true}
+\fi
+\fi
+\IFTEX at let{AlephTeX}{alephtex}
+\begingroup\expandafter\expandafter\expandafter\endgroup
+\expandafter\ifx\csname Umathchardef\endcsname\relax
+ \IFTEX at let{tutex}{false}
+\else
+ \IFTEX at let{tutex}{true}
+\fi
+\IFTEX at let{TUTeX}{tutex}
+\begingroup\expandafter\expandafter\expandafter\endgroup
+\expandafter\ifx\csname TexpadTeXMode\endcsname\relax
+ \IFTEX at let{texpadtex}{false}
+\else
+ \IFTEX at let{texpadtex}{true}
+ \ifcase\TexpadTeXMode\relax
+ \or
+ \IFTEX at let{tutex}{true}
\fi
\fi
+\IFTEX at let{TexpadTeX}{texpadtex}
+\begingroup\expandafter\expandafter\expandafter\endgroup
+\expandafter\ifx\csname HINTversion\endcsname\relax
+ \IFTEX at let{hint}{false}
\else
-\directlua{%
+ \IFTEX at let{hint}{true}
+\fi
+\IFTEX at let{HINT}{hint}
+\def\pdftrue{\let\ifpdf\iftrue}
+\def\pdffalse{\let\ifpdf\iffalse}
+\pdffalse
+\ifluatex
+\directlua{\IFTEX at detokenize{
if (tex.outputmode or tex.pdfoutput or 0) > 0 then
- tex.print('\string\\pdftrue')
+ tex.print('\\pdftrue')
end
-}
+}}
+\else
+\begingroup\expandafter\expandafter\expandafter\endgroup
+\expandafter\ifx\csname pdfoutput\endcsname\relax
+\ifvtex
+ \ifnum\OpMode=3 %
+ \pdftrue
+ \fi
+\else
+ \iftexpadtex
+ \pdftrue
+ \fi
\fi
-%%
-%% End of file `ifpdf.sty'.
+\else
+ \ifnum\pdfoutput>0 %
+ \pdftrue
+ \fi
+\fi
+\fi
+\catcode64 \IFTEX at atcatcode
\def\makeactive#1{\catcode`#1 = \active \ignorespaces}%
\chardef\letter = 11
\chardef\other = 12
@@ -102,7 +253,6 @@
\def\@emptymarkA{\@emptymarkB}
\def\ifempty#1{\@@ifempty #1\@emptymarkA\@emptymarkB}%
\def\@@ifempty#1#2\@emptymarkB{\ifx #1\@emptymarkA}%
-\def\@gobbleminus#1{\ifx-#1\else#1\fi}%
\def\ifinteger#1{\ifcat_\ifnum9<1\@gobbleminus#1 _\else A\fi}%
\def\isinteger{TT\fi\ifinteger}%
\def\@gobblemeaning#1:->{}%
@@ -184,8 +334,8 @@
\fi
%% @texfile{
%% author = "Karl Berry and Oren Patashnik",
-%% version = "0.99p",
-%% date = "30 May 2019",
+%% version = "0.99q",
+%% date = "2 October 2022",
%% filename = "btxmac.tex",
%% address = "tex-eplain at tug.org",
%% supported = "yes",
@@ -207,7 +357,7 @@
\else
\def\@linenumber{\the\inputlineno:\space}%
\fi
-\long\def\@futurenonspacelet#1{\def\cs{#1}%
+\long\def\@futurenonspacelet#1{\def\@btxcs{#1}%
\afterassignment\@stepone\let\@nexttoken=
}%
\begingroup % The grouping here avoids stepping on an outside use of `\\'.
@@ -214,8 +364,8 @@
\def\\{\global\let\@stoken= }%
\\ % now \@stoken is a space token (\\ is a control symbol, so that
\endgroup
-\def\@stepone{\expandafter\futurelet\cs\@steptwo}%
-\def\@steptwo{\expandafter\ifx\cs\@stoken\let\@@next=\@stepthree
+\def\@stepone{\expandafter\futurelet\@btxcs\@steptwo}%
+\def\@steptwo{\expandafter\ifx\@btxcs\@stoken\let\@@next=\@stepthree
\else\let\@@next=\@nexttoken\fi \@@next}%
\def\@stepthree{\afterassignment\@stepone\let\@@next= }%
\def\@getoptionalarg#1{%
@@ -441,11 +591,11 @@
\long\def\providecommand#1{%
\def\@btxcommandname{#1}%
\expandafter\ifx\@btxcommandname \@undefined
- \let\cs=\@btxcontinuenewcommand % undefined, so we'll define it
+ \let\@btxcs=\@btxcontinuenewcommand % undefined, so we'll define it
\else
- \let\cs=\@gobble % already defined, so ignore it
+ \let\@btxcs=\@gobble % already defined, so ignore it
\fi
- \@getoptionalarg\cs
+ \@getoptionalarg\@btxcs
}%
\fi
\def\@btxcontinuenewcommand{%
@@ -665,10 +815,11 @@
%%% USA
%%% Tel: (801) 581-5254
%%% FAX: (801) 581-4148",
-%%% checksum = "27723 296 1385 12423",
+%%% checksum = "39776 297 1390 12466",
%%% email = "beebe at magna.math.utah.edu (Internet)",
%%% codetable = "ISO/ASCII",
%%% keywords = "TeX names",
+%%% license = "public domain",
%%% supported = "yes",
%%% docstring = "This style file for AmSTeX, LaTeX, and TeX
%%% defines macros for the names of TeX
@@ -4135,5 +4286,5 @@
\def\fmtname{eplain}%
\def\eplain{t}%
{\edef\plainversion{\fmtversion}%
- \xdef\fmtversion{3.11: 4 July 2020 (and plain \plainversion)}%
+ \xdef\fmtversion{3.12: 5 October 2022 (and plain \plainversion)}%
}%
More information about the tex-live-commits
mailing list.