diff options
| author | Norbert Preining <norbert@preining.info> | 2022-10-07 03:03:15 +0000 |
|---|---|---|
| committer | Norbert Preining <norbert@preining.info> | 2022-10-07 03:03:15 +0000 |
| commit | bbbfa0a90645d4da46b1492f6513b28a01eb78da (patch) | |
| tree | dcbf82e9f2bd50ac7596114690ad31ca7a6dbf8c /macros/eplain | |
| parent | 678708e90ffe138885ed8c06b6780d491b80fae5 (diff) | |
CTAN sync 202210070303
Diffstat (limited to 'macros/eplain')
| -rw-r--r-- | macros/eplain/doc/ChangeLog | 79 | ||||
| -rw-r--r-- | macros/eplain/doc/INSTALL | 58 | ||||
| -rw-r--r-- | macros/eplain/doc/NEWS | 6 | ||||
| -rw-r--r-- | macros/eplain/doc/README | 22 | ||||
| -rw-r--r-- | macros/eplain/doc/demo/Makefile | 3 | ||||
| -rw-r--r-- | macros/eplain/doc/demo/xhyper.tex | 7 | ||||
| -rw-r--r-- | macros/eplain/doc/eplain.1 | 19 | ||||
| -rw-r--r-- | macros/eplain/doc/eplain.html | 2723 | ||||
| -rw-r--r-- | macros/eplain/doc/eplain.info | 1027 | ||||
| -rw-r--r-- | macros/eplain/doc/eplain.man1.pdf | bin | 4313 -> 18523 bytes | |||
| -rw-r--r-- | macros/eplain/doc/eplain.pdf | bin | 734393 -> 758051 bytes | |||
| -rw-r--r-- | macros/eplain/doc/lscommnt.jpg | bin | 65795 -> 89453 bytes | |||
| -rw-r--r-- | macros/eplain/doc/xhyper.jpg | bin | 13812 -> 17721 bytes | |||
| -rw-r--r-- | macros/eplain/source/xeplain.tex | 19 | ||||
| -rw-r--r-- | macros/eplain/tex/btxmac.tex | 37 | ||||
| -rw-r--r-- | macros/eplain/tex/eplain.tex | 249 |
16 files changed, 2022 insertions, 2227 deletions
diff --git a/macros/eplain/doc/ChangeLog b/macros/eplain/doc/ChangeLog index 1c91e5b2bf..ae2413996d 100644 --- a/macros/eplain/doc/ChangeLog +++ b/macros/eplain/doc/ChangeLog @@ -1,3 +1,82 @@ +2022-10-02 Karl Berry <karl@freefriends.org> + + * NEWS, + * Makefile (version): 3.12. + * doc/eplain.texi: 3.12, October 2022. Regenerate. + +2022-10-05 Karl Berry <karl@freefriends.org> + + * xeplain.tex: mailing list is tex-eplain, not bug-eplain. + * README, + * xeplain.tex, + * demo/xrhyper.tex: https not http. + * doc/Makefile (eplain.info, PDF_DEMOS): depend on demo .tex sources. + +2022-10-05 Karl Berry <karl@freefriends.org> + + * xeplain.tex: document bug in double-columns that marks are not + always preserved. See threads: + https://tug.org/pipermail/tex-eplain/2021/001001.html + https://tug.org/pipermail/tex-eplain/2022/001049.html + * doc/userdef.texi: mention mark bug. + + * doc/Makefile (MAKEINFO_HTML): https for TOP_NODE_UP_URL. + +2022-10-03 Karl Berry <karl@freefriends.org> + + * Makefile (fetch, fetch1): new targets. + * texnames.sty: update to current (explicit pd statement). + +2022-10-02 Karl Berry <karl@freefriends.org> + + * doc/*.texi: remove use of @acronym; better to just use capitals. + Also, downcase "url". + +2022-10-02 Karl Berry <karl@freefriends.org> + + * iftex.sty: new file. + * ifpdf.sty: remove. + * util/mkdist-merge: ifpdf.sty -> iftex.sty. + * xeplain.tex: ifpdf.sty -> iftex.sty. + * doc/userdef.texi (Checking for PDF output): now using iftex.sty; + update description. + * Makefile (sources): now iftex.sty. + +2022-10-02 Karl Berry <karl@freefriends.org> + + * README: update urls, mention miniltx and optex. + * doc/userdef.texi (Loading LaTeX packages): mention that + miniltx.tex can usually be used on its own, without Eplain. + + * doc/eplain.texi (Top): remove detailed menu, seems + unnecessary (and Emacs commands for updating aren't working well). + * doc/intro.texi: mention alternatives to Eplain (miniltx, optex). + + * doc/progdef.texi (Scratch registers): new section to describe + standard conventions for register usage. + + * doc/eplain.1, + * doc/install.texi, + * doc/invoke.texi: update to something like current reality. + + * doc/*.texi: use svn $Id$. + * doc/*.texi: use https urls; update urls. + + * doc/texinfo.tex: remove; let's just assume it's available. + + * doc/Makefile (TEXFOT): new definition for quieter TeX runs. + +2022-10-02 Karl Berry <karl@freefriends.org> + + * btxmac.tex (\futurenonspacelet, \@step..., \providecommand): + use \@btxcs instead of \cs, which may be otherwise defined, + e.g., by plain tugboat.sty. Version 0.99q. + +2020-09-19 Karl Berry <karl@freefriends.org> + + * demo/Makefile (ctan_lion_350x350.png): update ctan_lion url. + Report from Van Ly, 19 Sep 2020 15:12:58. + 2020-07-04 Karl Berry <karl@freefriends.org> * README: mailing list is tex-eplain, not bug-eplain diff --git a/macros/eplain/doc/INSTALL b/macros/eplain/doc/INSTALL index dcd705281b..8c726e7c0e 100644 --- a/macros/eplain/doc/INSTALL +++ b/macros/eplain/doc/INSTALL @@ -1,46 +1,38 @@ Installation +Invoking Eplain +Installation +Invoking Eplain +Installation ************ Your TeX installation should already contain a version of Eplain -(`eplain.tex') in its main `texmf' tree (usually under -`/usr/share/texmf/tex/eplain/' on Unix systems). To install a newer -version of Eplain, put the new `eplain.tex' (included in Eplain -distributions) in the `tex/eplain/' subdirectory of your local `texmf' -tree. The newer version you install in the local tree should override -the older one in the main tree. - - The location of the local `texmf' tree obviously depends on your -operating system and TeX installation. On Unix systems the usual -location is `/usr/local/share/texmf/'. If you don't have write -permissions for `/usr/local/share/texmf/', many installations read the -`texmf' tree in the user's home directory; `eplain.tex' then should go -under `~/texmf/tex/eplain/'. For more information about TeX directory -structure, please see -`http://www.tex.ac.uk/cgi-bin/texfaq2html?label=tds'. - - If you prefer to install `eplain.tex' in a non-standard place, set -an environment variable (`TEXINPUTS' for the Web2C port of TeX to Unix) -to tell TeX how to find it. - - If you want, you can also create a format (`.fmt') file for Eplain, -which will eliminate the time spent reading the macro source file with -`\input'. You do this by issuing a sequence of Unix commands something -like this: - - prompt$ touch eplain.aux - prompt$ initex +('eplain.tex') in its main 'texmf' tree; with TeX Live, it's in +'.../texmf-dist/tex/eplain/eplain.tex'. + + Generally, you can just use that version and there is no need to do +anything else. But if you want to use a newer version of Eplain for a +given document, you can put the new 'eplain.tex' in the document's +directory, and it will be found. + + If you want to install a new 'eplain.tex' in some other place, set an +environment variable (commonly, 'TEXINPUTS') to tell TeX how to find it. + + Distributions should also create and maintain the 'eplain.fmt' file +file. But if you want to do it yourself, you can: + + $ touch eplain.aux + $ initex This is TeX, ... **&plain eplain (eplain.tex) *\dump ... MESSAGES ... -You must make sure that `eplain.aux' exists _before_ you run `initex'; +You must make sure that 'eplain.aux' exists _before_ you run 'initex'; otherwise, warning messages about undefined labels will never be issued. - You then have to install the resulting `eplain.fmt' in your local -`texmf' tree or set an environment variable to tell TeX how to find it. -For the Web2C port of TeX to Unix, format files are usually installed -under `/usr/local/share/texmf/web2c/' or `/var/lib/texmf/web2c/'; the -environment variable is `TEXFORMATS'. + You then have to install the resulting 'eplain.fmt' in your local +'texmf' tree or set an environment variable ('TEXFORMATS' to tell TeX +how to find it. You'll need to consult your distribution's documentation +about that. diff --git a/macros/eplain/doc/NEWS b/macros/eplain/doc/NEWS index 74813c40a6..9b144ca60e 100644 --- a/macros/eplain/doc/NEWS +++ b/macros/eplain/doc/NEWS @@ -1,6 +1,10 @@ -$Id: NEWS 50 2020-07-04 16:08:52Z karl $ +$Id: NEWS 61 2022-10-05 22:43:49Z karl $ This file records noteworthy changes. This file is public domain. + 3.12 (5 October 2022) +* btxmac.tex: avoid use of \cs control sequence, conflicts with tugboat.sty. +* iftex.sty: use this instead of the now-obsolete ifpdf.sty. + 3.11 (4 July 2020) * Support YYYY-MM-DD date syntax in \ProvidesPackage. diff --git a/macros/eplain/doc/README b/macros/eplain/doc/README index bfff96b2ee..2c5ed6d066 100644 --- a/macros/eplain/doc/README +++ b/macros/eplain/doc/README @@ -1,4 +1,4 @@ -$Id: README 51 2020-07-04 21:01:29Z karl $ +$Id: README 60 2022-10-05 22:42:54Z karl $ (This file is public domain.) This file describes the Eplain (expanded or extended plain, take your @@ -27,9 +27,19 @@ domain. Other pieces are covered by other licenses; see the file headers for specifics. It is entirely free software. Eplain was originally developed for the book TeX for the Impatient, -published by Addison-Wesley in 1990. That book is now freely available, -from http://www.gnu.org/software/teximpatient, along with several -translations. +published by Addison-Wesley in 1990. That book is now freely available, +from https://ctan.org/pkg/impatient, along with several translations. + +Mailing list: https://lists.tug.org/tex-eplain (tex-eplain@tug.org) +The Eplain home page is https://tug.org/eplain. + +P.S. Alternatives to Eplain: +1) If you just want to load the LaTeX color or graphics package, +the LaTeX team's miniltx.tex suffices: + \input miniltx.tex + \input graphicx.tex + +2) If you're interested in a fully-fledged format that shares much of +Eplain's (and plain.tex's) philosophy, check out OpTeX: + https://ctan.org/pkg/optex -Mailing list: http://lists.tug.org/tex-eplain (tex-eplain@tug.org) -The Eplain home page is http://tug.org/eplain. diff --git a/macros/eplain/doc/demo/Makefile b/macros/eplain/doc/demo/Makefile index 7a578663f3..dd8a4eaa61 100644 --- a/macros/eplain/doc/demo/Makefile +++ b/macros/eplain/doc/demo/Makefile @@ -1,3 +1,4 @@ +# $Id: Makefile 52 2020-09-19 21:03:24Z karl $ # Makefile for the Eplain demos. This file is public domain. PDFTEX = pdftex @@ -23,7 +24,7 @@ lscommnt.pdf: lscommnt.tex ctan_lion_350x350.png: @echo "Please download" - @echo " ftp://tug.ctan.org/ftpmaint/CTAN_lion/ctan_lion_350x350.png" + @echo " https://www.ctan.org/lion/files/ctan_lion_350x350.png" @echo "and place it in the demo subdirectory." exit 1 diff --git a/macros/eplain/doc/demo/xhyper.tex b/macros/eplain/doc/demo/xhyper.tex index 54742cb50b..6527244fae 100644 --- a/macros/eplain/doc/demo/xhyper.tex +++ b/macros/eplain/doc/demo/xhyper.tex @@ -1,3 +1,4 @@ +% $Id: xhyper.tex 60 2022-10-05 22:42:54Z karl $ % (This file is public domain.) % % This file demonstrates the following features of Eplain: @@ -10,7 +11,7 @@ % % The compiled demo can be downloaded from % -% http://tug.org/eplain/demo +% https://tug.org/eplain/demo % % In order to compile this file yourself, you will need the CTAN lion % drawing by Duane Bibby from @@ -170,7 +171,7 @@ Show me % |url.sty|. Remember that we have customized the color of |url| % hyperlinks, so this one will show up with a different color than the % default dark-red. -Take me to \url{http://tug.org/eplain}. +Take me to \url{https://tug.org/eplain}. % The second approach is to create an explicit URL link. We specify % yet another border highlighting mode, |P|, which means that the @@ -184,7 +185,7 @@ Take me to \url{http://tug.org/eplain}. \definecolor{mycolor}{rgb}{0.4,0.1,0.4} Take me to -\hlstart{url}{hlight=P,colormodel=,color=mycolor}{http://tug.org/eplain} +\hlstart{url}{hlight=P,colormodel=,color=mycolor}{https://tug.org/eplain} Eplain homepage\hlend. \bye diff --git a/macros/eplain/doc/eplain.1 b/macros/eplain/doc/eplain.1 index b7d0d83fa1..c7c34ba4f3 100644 --- a/macros/eplain/doc/eplain.1 +++ b/macros/eplain/doc/eplain.1 @@ -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,14 +67,20 @@ files produced from .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 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 diff --git a/macros/eplain/doc/eplain.html b/macros/eplain/doc/eplain.html index 15e602336a..7e7da4278c 100644 --- a/macros/eplain/doc/eplain.html +++ b/macros/eplain/doc/eplain.html @@ -1,7 +1,10 @@ <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd"> <html> -<!-- This manual documents the Eplain macros, version 3.11, -July 2020. Eplain provides functionality for plain TeX that +<!-- Created by GNU Texinfo 6.8, https://www.gnu.org/software/texinfo/ --> +<head> +<meta http-equiv="Content-Type" content="text/html; charset=utf-8"> +<!-- This manual documents the Eplain macros, version 3.12, +October 2022. Eplain provides functionality for plain TeX that is intended to be useful regardless of how your document is actually formatted. @@ -12,9 +15,6 @@ macros; this chapter is under the GNU General Public License. Adam Lewenberg has made additions and corrections. Oleg Katsitadze wrote the section on LaTeX packages and the chapter on hyperlinks, and updates throughout. --> -<!-- Created by GNU Texinfo 6.7, http://www.gnu.org/software/texinfo/ --> -<head> -<meta http-equiv="Content-Type" content="text/html; charset=utf-8"> <title>Eplain: Expanded Plain TeX</title> <meta name="description" content="Eplain: Expanded Plain TeX"> @@ -22,17 +22,20 @@ updates throughout. --> <meta name="resource-type" content="document"> <meta name="distribution" content="global"> <meta name="Generator" content="makeinfo"> +<meta name="viewport" content="width=device-width,initial-scale=1"> + <link href="#Top" rel="start" title="Top"> <link href="#Macro-index" rel="index" title="Macro index"> <link href="#SEC_Contents" rel="contents" title="Table of Contents"> -<link href="http://tug.org/texinfohtml/" rel="up" title="(dir)"> +<link href="https://tug.org/texinfohtml/" rel="up" title="(dir)"> +<link href="#Introduction" rel="next" title="Introduction"> <style type="text/css"> <!-- +a.copiable-anchor {visibility: hidden; text-decoration: none; line-height: 0em} a.summary-letter {text-decoration: none} blockquote.indentedblock {margin-right: 0em} div.display {margin-left: 3.2em} div.example {margin-left: 3.2em} -div.lisp {margin-left: 3.2em} kbd {font-style: oblique} pre.display {font-family: inherit} pre.format {font-family: inherit} @@ -41,6 +44,7 @@ pre.menu-preformatted {font-family: serif} span.nolinebreak {white-space: nowrap} span.roman {font-family: initial; font-weight: normal} span.sansserif {font-family: sans-serif; font-weight: normal} +span:hover a.copiable-anchor {visibility: visible} ul.no-bullet {list-style: none} --> </style> @@ -58,25 +62,32 @@ ul.no-bullet {list-style: none} -<span id="SEC_Overview"></span> -<h2 class="shortcontents-heading">Short Table of Contents</h2> -<div class="shortcontents"> -<ul class="no-bullet"> -<li><a id="stoc-Introduction-1" href="#toc-Introduction-1">1 Introduction</a></li> -<li><a id="stoc-Installation-1" href="#toc-Installation-1">2 Installation</a></li> -<li><a id="stoc-Invoking-Eplain-1" href="#toc-Invoking-Eplain-1">3 Invoking Eplain</a></li> -<li><a id="stoc-User-definitions-1" href="#toc-User-definitions-1">4 User definitions</a></li> -<li><a id="stoc-Hyperlinks-1" href="#toc-Hyperlinks-1">5 Hyperlinks</a></li> -<li><a id="stoc-Arrow-theoretic-diagrams-1" href="#toc-Arrow-theoretic-diagrams-1">6 Arrow theoretic diagrams</a></li> -<li><a id="stoc-Programming-definitions-1" href="#toc-Programming-definitions-1">7 Programming definitions</a></li> -<li><a id="stoc-Demo-files-1" href="#toc-Demo-files-1">8 Demo files</a></li> -<li><a id="stoc-Macro-index-1" href="#toc-Macro-index-1" rel="index">Macro index</a></li> -<li><a id="stoc-Concept-index-1" href="#toc-Concept-index-1" rel="index">Concept index</a></li> -</ul> +<div class="top" id="Top"> +<div class="header"> +<p> +Next: <a href="#Introduction" accesskey="n" rel="next">Introduction</a>, Up: <a href="https://tug.org/texinfohtml/" accesskey="u" rel="up">(dir)</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Macro-index" title="Index" rel="index">Index</a>]</p> </div> +<span id="Eplain"></span><h1 class="top">Eplain</h1> + +<p>This manual documents the Eplain macros, version 3.12, +October 2022. Eplain provides functionality for plain TeX that +is intended to be useful regardless of how your document is actually +formatted. +</p> +<p>Most of this manual is in the public domain, like most of the Eplain +code. It was originally written by Karl Berry, starting in 1989. +Steven Smith wrote the documentation for the commutative diagram +macros; this chapter is under the GNU General Public License. Adam +Lewenberg has made additions and corrections. Oleg Katsitadze wrote +the section on LaTeX packages and the chapter on hyperlinks, and +updates throughout. +</p> +<p>The Eplain home page is <a href="https://tug.org/eplain">https://tug.org/eplain</a>. +</p> + -<span id="SEC_Contents"></span> +<div class="Contents_element" id="SEC_Contents"> <h2 class="contents-heading">Table of Contents</h2> <div class="contents"> @@ -222,7 +233,10 @@ ul.no-bullet {list-style: none} <li><a id="toc-Programming-definitions-1" href="#Programming-definitions">7 Programming definitions</a> <ul class="no-bullet"> <li><a id="toc-Category-codes-1" href="#Category-codes">7.1 Category codes</a></li> - <li><a id="toc-Allocation-macros-1" href="#Allocation-macros">7.2 Allocation macros</a></li> + <li><a id="toc-Allocation-macros-1" href="#Allocation-macros">7.2 Allocation macros</a> + <ul class="no-bullet"> + <li><a id="toc-Scratch-registers-1" href="#Scratch-registers">7.2.1 Scratch registers</a></li> + </ul></li> <li><a id="toc-Iteration-1" href="#Iteration">7.3 Iteration</a></li> <li><a id="toc-Macro-arguments-1" href="#Macro-arguments">7.4 Macro arguments</a></li> <li><a id="toc-Converting-to-characters-1" href="#Converting-to-characters">7.5 Converting to characters</a></li> @@ -254,376 +268,30 @@ ul.no-bullet {list-style: none} <li><a id="toc-Concept-index-1" href="#Concept-index" rel="index">Concept index</a></li> </ul> </div> - - -<span id="Top"></span><div class="header"> -<p> -Next: <a href="#Introduction" accesskey="n" rel="next">Introduction</a>, Up: <a href="http://tug.org/texinfohtml/" accesskey="u" rel="up">(dir)</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Macro-index" title="Index" rel="index">Index</a>]</p> </div> -<span id="Eplain"></span><h1 class="top">Eplain</h1> - -<p>This manual documents the Eplain macros, version 3.11, -July 2020. Eplain provides functionality for plain TeX that -is intended to be useful regardless of how your document is actually -formatted. -</p> -<p>Most of this manual is in the public domain, like most of the Eplain -code. It was originally written by Karl Berry, starting in 1989. -Steven Smith wrote the documentation for the commutative diagram -macros; this chapter is under the GNU General Public License. Adam -Lewenberg has made additions and corrections. Oleg Katsitadze wrote -the section on LaTeX packages and the chapter on hyperlinks, and -updates throughout. -</p> -<p>The Eplain home page is <a href="https://tug.org/eplain">https://tug.org/eplain</a>. -</p> -<table class="menu" border="0" cellspacing="0"> -<tr><td align="left" valign="top">• <a href="#Introduction" accesskey="1">Introduction</a></td><td> </td><td align="left" valign="top">Eplain’s purpose and philosophy. -</td></tr> -<tr><td align="left" valign="top">• <a href="#Installation" accesskey="2">Installation</a></td><td> </td><td align="left" valign="top">Installing Eplain. -</td></tr> -<tr><td align="left" valign="top">• <a href="#Invoking-Eplain" accesskey="3">Invoking Eplain</a></td><td> </td><td align="left" valign="top">Using Eplain from a TeX file. -</td></tr> -<tr><td align="left" valign="top">• <a href="#User-definitions" accesskey="4">User definitions</a></td><td> </td><td align="left" valign="top">Macros to be used in a document. -</td></tr> -<tr><td align="left" valign="top">• <a href="#Hyperlinks" accesskey="5">Hyperlinks</a></td><td> </td><td align="left" valign="top">Producing documents with hyperlinks. -</td></tr> -<tr><td align="left" valign="top">• <a href="#Arrow-theoretic-diagrams" accesskey="6">Arrow theoretic diagrams</a></td><td> </td><td align="left" valign="top">Macros for commutative diagrams. -</td></tr> -<tr><td align="left" valign="top">• <a href="#Programming-definitions" accesskey="7">Programming definitions</a></td><td> </td><td align="left" valign="top">Macros to be used in writing other macros. -</td></tr> -<tr><td align="left" valign="top">• <a href="#Demo-files" accesskey="8">Demo files</a></td><td> </td><td align="left" valign="top">Sample documents demonstrating Eplain. -</td></tr> -<tr><td align="left" valign="top">• <a href="#Macro-index" rel="index" accesskey="9">Macro index</a></td><td> </td><td align="left" valign="top">Entries for TeX and Eplain control sequences. -</td></tr> -<tr><td align="left" valign="top">• <a href="#Concept-index" rel="index">Concept index</a></td><td> </td><td align="left" valign="top">General index. -</td></tr> -<tr><th colspan="3" align="left" valign="top"><pre class="menu-comment"> - -</pre></th></tr><tr><th colspan="3" align="left" valign="top"><pre class="menu-comment"> — The Detailed Node Listing — - -User definitions - -</pre></th></tr><tr><td align="left" valign="top">• <a href="#Diagnostics">Diagnostics</a></td><td> </td><td align="left" valign="top">Tracing information. -</td></tr> -<tr><td align="left" valign="top">• <a href="#Rules">Rules</a></td><td> </td><td align="left" valign="top">Changing the default rule dimensions. -</td></tr> -<tr><td align="left" valign="top">• <a href="#Citations">Citations</a></td><td> </td><td align="left" valign="top">Using BibTeX and Eplain to make bibliographies. -</td></tr> -<tr><td align="left" valign="top">• <a href="#Displays">Displays</a></td><td> </td><td align="left" valign="top">Changing the formatting of math displays. -</td></tr> -<tr><td align="left" valign="top">• <a href="#Time-of-day">Time of day</a></td><td> </td><td align="left" valign="top">Producing the time of day. -</td></tr> -<tr><td align="left" valign="top">• <a href="#Lists">Lists</a></td><td> </td><td align="left" valign="top">Producing numbered and unordered lists. -</td></tr> -<tr><td align="left" valign="top">• <a href="#Verbatim-listing">Verbatim listing</a></td><td> </td><td align="left" valign="top">Producing text just as it appears. -</td></tr> -<tr><td align="left" valign="top">• <a href="#Contents">Contents</a></td><td> </td><td align="left" valign="top">Making a table of contents. -</td></tr> -<tr><td align="left" valign="top">• <a href="#Cross_002dreferences">Cross-references</a></td><td> </td><td align="left" valign="top">Symbolically referring to pages or equations. -</td></tr> -<tr><td align="left" valign="top">• <a href="#Page-references">Page references</a></td><td> </td><td align="left" valign="top">Symbolic references to page numbers. -</td></tr> -<tr><td align="left" valign="top">• <a href="#Equation-references">Equation references</a></td><td> </td><td align="left" valign="top">Symbolic references to equation numbers. -</td></tr> -<tr><td align="left" valign="top">• <a href="#Indexing">Indexing</a></td><td> </td><td align="left" valign="top">Creating and typesetting indexes. -</td></tr> -<tr><td align="left" valign="top">• <a href="#Justification">Justification</a></td><td> </td><td align="left" valign="top">Left- or right-justification, or centering. -</td></tr> -<tr><td align="left" valign="top">• <a href="#Tables">Tables</a></td><td> </td><td align="left" valign="top">Producing ordered tables. -</td></tr> -<tr><td align="left" valign="top">• <a href="#Margins">Margins</a></td><td> </td><td align="left" valign="top">Changing the margins directly. -</td></tr> -<tr><td align="left" valign="top">• <a href="#Multiple-columns">Multiple columns</a></td><td> </td><td align="left" valign="top">Getting output in two columns. -</td></tr> -<tr><td align="left" valign="top">• <a href="#Footnotes">Footnotes</a></td><td> </td><td align="left" valign="top">Autonumbered footnotes; changing formatting. -</td></tr> -<tr><td align="left" valign="top">• <a href="#Fractions">Fractions</a></td><td> </td><td align="left" valign="top">A better way to produce fractions in text. -</td></tr> -<tr><td align="left" valign="top">• <a href="#Paths">Paths</a></td><td> </td><td align="left" valign="top">Allowing line breaks in pathnames. -</td></tr> -<tr><td align="left" valign="top">• <a href="#Logos">Logos</a></td><td> </td><td align="left" valign="top">Various logos. -</td></tr> -<tr><td align="left" valign="top">• <a href="#Boxes">Boxes</a></td><td> </td><td align="left" valign="top">Producing filled or open rectangles. -</td></tr> -<tr><td align="left" valign="top">• <a href="#Checking-for-PDF-output">Checking for PDF output</a></td><td> </td><td align="left" valign="top">Checking for pdfTeX in PDF mode. -</td></tr> -<tr><td align="left" valign="top">• <a href="#Loading-LaTeX-packages">Loading LaTeX packages</a></td><td> </td><td align="left" valign="top">Support for LaTeX packages under plain TeX. -</td></tr> -<tr><th colspan="3" align="left" valign="top"><pre class="menu-comment"> - -Citations - -</pre></th></tr><tr><td align="left" valign="top">• <a href="#Formatting-citations">Formatting citations</a></td><td> </td><td align="left" valign="top">Changing the way citations are printed. -</td></tr> -<tr><td align="left" valign="top">• <a href="#Formatting-bibliographies">Formatting bibliographies</a></td><td> </td><td align="left" valign="top">Changing the way bibliographies are printed. -</td></tr> -<tr><th colspan="3" align="left" valign="top"><pre class="menu-comment"> - -Displays - -</pre></th></tr><tr><td align="left" valign="top">• <a href="#Formatting-displays">Formatting displays</a></td><td> </td><td align="left" valign="top">General formatting of displays. -</td></tr> -<tr><th colspan="3" align="left" valign="top"><pre class="menu-comment"> - -Lists - -</pre></th></tr><tr><td align="left" valign="top">• <a href="#Formatting-lists">Formatting lists</a></td><td> </td><td align="left" valign="top">Changing how the lists look. -</td></tr> -<tr><th colspan="3" align="left" valign="top"><pre class="menu-comment"> - -Contents - -</pre></th></tr><tr><td align="left" valign="top">• <a href="#Writing-the-_002etoc-file">Writing the .toc file</a></td><td> </td><td align="left" valign="top"> -</td></tr> -<tr><td align="left" valign="top">• <a href="#Reading-the-_002etoc-file">Reading the .toc file</a></td><td> </td><td align="left" valign="top"> -</td></tr> -<tr><td align="left" valign="top">• <a href="#Changing-the-_002etoc-file_0027s-root-name">Changing the .toc file's root name</a></td><td> </td><td align="left" valign="top"> -</td></tr> -<tr><td align="left" valign="top">• <a href="#Alternative-contents-files">Alternative contents files</a></td><td> </td><td align="left" valign="top"> -</td></tr> -<tr><th colspan="3" align="left" valign="top"><pre class="menu-comment"> - -Cross-references - -</pre></th></tr><tr><td align="left" valign="top">• <a href="#Defining-generic-references">Defining generic references</a></td><td> </td><td align="left" valign="top"> -</td></tr> -<tr><td align="left" valign="top">• <a href="#Using-generic-references">Using generic references</a></td><td> </td><td align="left" valign="top"> -</td></tr> -<tr><th colspan="3" align="left" valign="top"><pre class="menu-comment"> - -Equation references - -</pre></th></tr><tr><td align="left" valign="top">• <a href="#Formatting-equation-references">Formatting equation references</a></td><td> </td><td align="left" valign="top"> -</td></tr> -<tr><td align="left" valign="top">• <a href="#Subequation-references">Subequation references</a></td><td> </td><td align="left" valign="top"> -</td></tr> -<tr><th colspan="3" align="left" valign="top"><pre class="menu-comment"> - -Indexing - -</pre></th></tr><tr><td align="left" valign="top">• <a href="#Indexing-terms">Indexing terms</a></td><td> </td><td align="left" valign="top">Specifying what to index. -</td></tr> -<tr><td align="left" valign="top">• <a href="#Typesetting-an-index">Typesetting an index</a></td><td> </td><td align="left" valign="top">Printing the sorted output. -</td></tr> -<tr><td align="left" valign="top">• <a href="#Customizing-indexing">Customizing indexing</a></td><td> </td><td align="left" valign="top">Creating commands and specifying extra actions. -</td></tr> -<tr><th colspan="3" align="left" valign="top"><pre class="menu-comment"> - -Indexing terms - -</pre></th></tr><tr><td align="left" valign="top">• <a href="#Indexing-commands">Indexing commands</a></td><td> </td><td align="left" valign="top">Making index entries. -</td></tr> -<tr><td align="left" valign="top">• <a href="#Modifying-index-entries">Modifying index entries</a></td><td> </td><td align="left" valign="top">Ranges, see/see also, page number typesetting. -</td></tr> -<tr><td align="left" valign="top">• <a href="#Index-entries-with-special-characters">Index entries with special characters</a></td><td> </td><td align="left" valign="top"> -</td></tr> -<tr><td align="left" valign="top">• <a href="#Proofing-index-terms">Proofing index terms</a></td><td> </td><td align="left" valign="top">Noting index entries in the margins. -</td></tr> -<tr><th colspan="3" align="left" valign="top"><pre class="menu-comment"> - -Loading LaTeX packages - -</pre></th></tr><tr><td align="left" valign="top">• <a href="#The-_005cusepackage-command">The \usepackage command</a></td><td> </td><td align="left" valign="top">Command to load packages. -</td></tr> -<tr><td align="left" valign="top">• <a href="#Environment-for-loading-packages">Environment for loading packages</a></td><td> </td><td align="left" valign="top">Environment for the \usepackage commands. -</td></tr> -<tr><td align="left" valign="top">• <a href="#Packages-known-to-work">Packages known to work</a></td><td> </td><td align="left" valign="top">Supported packages. -</td></tr> -<tr><td align="left" valign="top">• <a href="#Packages-known-not-to-work">Packages known not to work</a></td><td> </td><td align="left" valign="top">Packages known not to work with Eplain. -</td></tr> -<tr><th colspan="3" align="left" valign="top"><pre class="menu-comment"> - -Hyperlinks - -</pre></th></tr><tr><td align="left" valign="top">• <a href="#Introduction-to-hyperlinks">Introduction to hyperlinks</a></td><td> </td><td align="left" valign="top"> -</td></tr> -<tr><td align="left" valign="top">• <a href="#Explicit-hyperlinks">Explicit hyperlinks</a></td><td> </td><td align="left" valign="top"> -</td></tr> -<tr><td align="left" valign="top">• <a href="#Implicit-hyperlinks">Implicit hyperlinks</a></td><td> </td><td align="left" valign="top"> -</td></tr> -<tr><td align="left" valign="top">• <a href="#Hyperlink-drivers">Hyperlink drivers</a></td><td> </td><td align="left" valign="top"> -</td></tr> -<tr><td align="left" valign="top">• <a href="#Setting-hyperlink-types-and-options">Setting hyperlink types and options</a></td><td> </td><td align="left" valign="top"> -</td></tr> -<tr><td align="left" valign="top">• <a href="#Turning-hyperlinks-on_002foff">Turning hyperlinks on/off</a></td><td> </td><td align="left" valign="top"> -</td></tr> -<tr><th colspan="3" align="left" valign="top"><pre class="menu-comment"> - -Implicit hyperlinks - -</pre></th></tr><tr><td align="left" valign="top">• <a href="#General-hyperlinks">General hyperlinks</a></td><td> </td><td align="left" valign="top">hrefint, hrefext -</td></tr> -<tr><td align="left" valign="top">• <a href="#URL-hyperlinks">URL hyperlinks</a></td><td> </td><td align="left" valign="top">url -</td></tr> -<tr><td align="left" valign="top">• <a href="#Citation-hyperlinks">Citation hyperlinks</a></td><td> </td><td align="left" valign="top">cite, bib -</td></tr> -<tr><td align="left" valign="top">• <a href="#List-hyperlinks">List hyperlinks</a></td><td> </td><td align="left" valign="top">li -</td></tr> -<tr><td align="left" valign="top">• <a href="#Cross_002dreference-hyperlinks">Cross-reference hyperlinks</a></td><td> </td><td align="left" valign="top">definexref, ref -</td></tr> -<tr><td align="left" valign="top">• <a href="#Page-reference-hyperlinks">Page reference hyperlinks</a></td><td> </td><td align="left" valign="top">xrdef, xref -</td></tr> -<tr><td align="left" valign="top">• <a href="#Equation-reference-hyperlinks">Equation reference hyperlinks</a></td><td> </td><td align="left" valign="top">eq -</td></tr> -<tr><td align="left" valign="top">• <a href="#Index-hyperlinks">Index hyperlinks</a></td><td> </td><td align="left" valign="top">idx -</td></tr> -<tr><td align="left" valign="top">• <a href="#Footnote-hyperlinks">Footnote hyperlinks</a></td><td> </td><td align="left" valign="top">foot, footback -</td></tr> -<tr><td align="left" valign="top">• <a href="#Contents-hyperlinks">Contents hyperlinks</a></td><td> </td><td align="left" valign="top"> -</td></tr> -<tr><th colspan="3" align="left" valign="top"><pre class="menu-comment"> - -Index hyperlinks - -</pre></th></tr><tr><td align="left" valign="top">• <a href="#Exact-destinations-for-index-terms">Exact destinations for index terms</a></td><td> </td><td align="left" valign="top"> -</td></tr> -<tr><td align="left" valign="top">• <a href="#Page-destinations-for-index-terms">Page destinations for index terms</a></td><td> </td><td align="left" valign="top"> -</td></tr> -<tr><td align="left" valign="top">• <a href="#Choosing-destination-placement">Choosing destination placement</a></td><td> </td><td align="left" valign="top"> -</td></tr> -<tr><td align="left" valign="top">• <a href="#Index-page-list-and-page-range-parsers">Index page list and page range parsers</a></td><td> </td><td align="left" valign="top"> -</td></tr> -<tr><td align="left" valign="top">• <a href="#Hyperlinks-in-see-and-see-also-entries">Hyperlinks in see and see also entries</a></td><td> </td><td align="left" valign="top"> -</td></tr> -<tr><th colspan="3" align="left" valign="top"><pre class="menu-comment"> - -Hyperlink drivers - -</pre></th></tr><tr><td align="left" valign="top">• <a href="#Options-supported-by-all-drivers">Options supported by all drivers</a></td><td> </td><td align="left" valign="top"> -</td></tr> -<tr><td align="left" valign="top">• <a href="#Hyperlink-driver-hypertex">Hyperlink driver hypertex</a></td><td> </td><td align="left" valign="top"> -</td></tr> -<tr><td align="left" valign="top">• <a href="#Hyperlink-drivers-pdftex-and-dvipdfm">Hyperlink drivers pdftex and dvipdfm</a></td><td> </td><td align="left" valign="top"> -</td></tr> -<tr><td align="left" valign="top">• <a href="#Hyperlink-driver-nolinks">Hyperlink driver nolinks</a></td><td> </td><td align="left" valign="top"> -</td></tr> -<tr><th colspan="3" align="left" valign="top"><pre class="menu-comment"> - -Hyperlink driver hypertex:: - -</pre></th></tr><tr><td align="left" valign="top">• <a href="#Destination-types-for-hypertex">Destination types for hypertex</a></td><td> </td><td align="left" valign="top"> -</td></tr> -<tr><td align="left" valign="top">• <a href="#Destination-options-for-hypertex">Destination options for hypertex</a></td><td> </td><td align="left" valign="top"> -</td></tr> -<tr><td align="left" valign="top">• <a href="#Link-types-for-hypertex">Link types for hypertex</a></td><td> </td><td align="left" valign="top"> -</td></tr> -<tr><td align="left" valign="top">• <a href="#Link-options-for-hypertex">Link options for hypertex</a></td><td> </td><td align="left" valign="top"> -</td></tr> -<tr><th colspan="3" align="left" valign="top"><pre class="menu-comment"> - -Hyperlink drivers pdftex and dvipdfm:: - -</pre></th></tr><tr><td align="left" valign="top">• <a href="#Destination-types-for-pdftex-and-dvipdfm">Destination types for pdftex and dvipdfm</a></td><td> </td><td align="left" valign="top"> -</td></tr> -<tr><td align="left" valign="top">• <a href="#Destination-options-for-pdftex-and-dvipdfm">Destination options for pdftex and dvipdfm</a></td><td> </td><td align="left" valign="top"> -</td></tr> -<tr><td align="left" valign="top">• <a href="#Link-types-for-pdftex-and-dvipdfm">Link types for pdftex and dvipdfm</a></td><td> </td><td align="left" valign="top"> -</td></tr> -<tr><td align="left" valign="top">• <a href="#Link-options-for-pdftex-and-dvipdfm">Link options for pdftex and dvipdfm</a></td><td> </td><td align="left" valign="top"> -</td></tr> -<tr><th colspan="3" align="left" valign="top"><pre class="menu-comment"> - -Setting hyperlink types and options - -</pre></th></tr><tr><td align="left" valign="top">• <a href="#Setting-default-types-and-options">Setting default types and options</a></td><td> </td><td align="left" valign="top"> -</td></tr> -<tr><td align="left" valign="top">• <a href="#Setting-group-types">Setting group types</a></td><td> </td><td align="left" valign="top"> -</td></tr> -<tr><td align="left" valign="top">• <a href="#Setting-group-options">Setting group options</a></td><td> </td><td align="left" valign="top"> -</td></tr> -<tr><th colspan="3" align="left" valign="top"><pre class="menu-comment"> - -Turning hyperlinks on/off - -</pre></th></tr><tr><td align="left" valign="top">• <a href="#Turning-low_002dlevel-commands-on_002foff">Turning low-level commands on/off</a></td><td> </td><td align="left" valign="top"> -</td></tr> -<tr><td align="left" valign="top">• <a href="#Turning-hyperlinks-on_002foff-for-a-group">Turning hyperlinks on/off for a group</a></td><td> </td><td align="left" valign="top"> -</td></tr> -<tr><th colspan="3" align="left" valign="top"><pre class="menu-comment"> - -Arrow theoretic diagrams - -</pre></th></tr><tr><td align="left" valign="top">• <a href="#Slanted-lines-and-vectors">Slanted lines and vectors</a></td><td> </td><td align="left" valign="top"> -</td></tr> -<tr><td align="left" valign="top">• <a href="#Commutative-diagrams">Commutative diagrams</a></td><td> </td><td align="left" valign="top"> -</td></tr> -<tr><th colspan="3" align="left" valign="top"><pre class="menu-comment"> - -Commutative diagrams - -</pre></th></tr><tr><td align="left" valign="top">• <a href="#Arrows-and-morphisms">Arrows and morphisms</a></td><td> </td><td align="left" valign="top"> -</td></tr> -<tr><td align="left" valign="top">• <a href="#Construction-of-commutative-diagrams">Construction of commutative diagrams</a></td><td> </td><td align="left" valign="top"> -</td></tr> -<tr><td align="left" valign="top">• <a href="#Commutative-diagram-parameters">Commutative diagram parameters</a></td><td> </td><td align="left" valign="top"> -</td></tr> -<tr><th colspan="3" align="left" valign="top"><pre class="menu-comment"> - -Programming definitions - -</pre></th></tr><tr><td align="left" valign="top">• <a href="#Category-codes">Category codes</a></td><td> </td><td align="left" valign="top">Changing category codes. -</td></tr> -<tr><td align="left" valign="top">• <a href="#Allocation-macros">Allocation macros</a></td><td> </td><td align="left" valign="top">Non-outer versions of \newcount et al. -</td></tr> -<tr><td align="left" valign="top">• <a href="#Iteration">Iteration</a></td><td> </td><td align="left" valign="top">Doing ‘for’ and ‘while’ loops in TeX. -</td></tr> -<tr><td align="left" valign="top">• <a href="#Macro-arguments">Macro arguments</a></td><td> </td><td align="left" valign="top">Reading and ignoring them. -</td></tr> -<tr><td align="left" valign="top">• <a href="#Converting-to-characters">Converting to characters</a></td><td> </td><td align="left" valign="top">Normalizing control sequences and spaces. -</td></tr> -<tr><td align="left" valign="top">• <a href="#Expansion">Expansion</a></td><td> </td><td align="left" valign="top">Controlling expansion. -</td></tr> -<tr><td align="left" valign="top">• <a href="#Obeying-spaces">Obeying spaces</a></td><td> </td><td align="left" valign="top">Making whitespace count anywhere. -</td></tr> -<tr><td align="left" valign="top">• <a href="#Writing-out-numbers">Writing out numbers</a></td><td> </td><td align="left" valign="top">Making ‘1’ into ‘one’. -</td></tr> -<tr><td align="left" valign="top">• <a href="#Mode_002dspecific-penalties">Mode-specific penalties</a></td><td> </td><td align="left" valign="top"> -</td></tr> -<tr><td align="left" valign="top">• <a href="#Auxiliary-files">Auxiliary files</a></td><td> </td><td align="left" valign="top">Testing for their existence. -</td></tr> -<tr><td align="left" valign="top">• <a href="#User_002ddefined-environments">User-defined environments</a></td><td> </td><td align="left" valign="top">User-defined environments. -</td></tr> -<tr><td align="left" valign="top">• <a href="#Page-list-and-page-range-parsers">Page list and page range parsers</a></td><td> </td><td align="left" valign="top"> -</td></tr> -<tr><th colspan="3" align="left" valign="top"><pre class="menu-comment"> - -Expansion - -</pre></th></tr><tr><td align="left" valign="top">• <a href="#g_t_005ccsn-and-_005cece">\csn and \ece</a></td><td> </td><td align="left" valign="top"> -</td></tr> -<tr><td align="left" valign="top">• <a href="#g_t_005cedefappend">\edefappend</a></td><td> </td><td align="left" valign="top"> -</td></tr> -<tr><td align="left" valign="top">• <a href="#Hooks">Hooks</a></td><td> </td><td align="left" valign="top">Manipulating and executing named actions. -</td></tr> -<tr><td align="left" valign="top">• <a href="#Properties">Properties</a></td><td> </td><td align="left" valign="top">Associating information with a csname. -</td></tr> -<tr><td align="left" valign="top">• <a href="#g_t_005cexpandonce">\expandonce</a></td><td> </td><td align="left" valign="top"> -</td></tr> -<tr><td align="left" valign="top">• <a href="#g_t_005cifundefined">\ifundefined</a></td><td> </td><td align="left" valign="top"> -</td></tr> -<tr><td align="left" valign="top">• <a href="#g_t_005cifempty">\ifempty</a></td><td> </td><td align="left" valign="top"> -</td></tr> -<tr><td align="left" valign="top">• <a href="#g_t_005cifinteger-and-_005cisinteger">\ifinteger and \isinteger</a></td><td> </td><td align="left" valign="top"> -</td></tr> -<tr><td align="left" valign="top">• <a href="#g_t_005cfuturenonspacelet">\futurenonspacelet</a></td><td> </td><td align="left" valign="top"> -</td></tr> -<tr><th colspan="3" align="left" valign="top"><pre class="menu-comment"> - -Demo files - -</pre></th></tr><tr><td align="left" valign="top">• <a href="#Hyperlinks-_0028xhyper_002etex_0029">Hyperlinks (xhyper.tex)</a></td><td> </td><td align="left" valign="top"> -</td></tr> -<tr><td align="left" valign="top">• <a href="#Highlighting-TeX-comments-in-listings-_0028lscommnt_002etex_0029">Highlighting TeX comments in listings (lscommnt.tex)</a></td><td> </td><td align="left" valign="top"> -</td></tr> -</table> - - +<div class="Overview_element" id="SEC_Overview"> +<h2 class="shortcontents-heading">Short Table of Contents</h2> +<div class="shortcontents"> +<ul class="no-bullet"> +<li><a id="stoc-Introduction-1" href="#toc-Introduction-1">1 Introduction</a></li> +<li><a id="stoc-Installation-1" href="#toc-Installation-1">2 Installation</a></li> +<li><a id="stoc-Invoking-Eplain-1" href="#toc-Invoking-Eplain-1">3 Invoking Eplain</a></li> +<li><a id="stoc-User-definitions-1" href="#toc-User-definitions-1">4 User definitions</a></li> +<li><a id="stoc-Hyperlinks-1" href="#toc-Hyperlinks-1">5 Hyperlinks</a></li> +<li><a id="stoc-Arrow-theoretic-diagrams-1" href="#toc-Arrow-theoretic-diagrams-1">6 Arrow theoretic diagrams</a></li> +<li><a id="stoc-Programming-definitions-1" href="#toc-Programming-definitions-1">7 Programming definitions</a></li> +<li><a id="stoc-Demo-files-1" href="#toc-Demo-files-1">8 Demo files</a></li> +<li><a id="stoc-Macro-index-1" href="#toc-Macro-index-1" rel="index">Macro index</a></li> +<li><a id="stoc-Concept-index-1" href="#toc-Concept-index-1" rel="index">Concept index</a></li> +</ul> +</div> +</div> <hr> -<span id="Introduction"></span><div class="header"> +<div class="chapter" id="Introduction"> +<div class="header"> <p> -Next: <a href="#Installation" accesskey="n" rel="next">Installation</a>, Previous: <a href="#Top" accesskey="p" rel="prev">Top</a>, Up: <a href="#Top" accesskey="u" rel="up">Top</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Macro-index" title="Index" rel="index">Index</a>]</p> +Next: <a href="#Installation" accesskey="n" rel="next">Installation</a>, Previous: <a href="#Top" accesskey="p" rel="prev">Eplain</a>, Up: <a href="#Top" accesskey="u" rel="up">Eplain</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Macro-index" title="Index" rel="index">Index</a>]</p> </div> <span id="Introduction-1"></span><h2 class="chapter">1 Introduction</h2> @@ -644,7 +312,7 @@ does LaTeX (originally written by Leslie Lamport) <span id="index-Lamport_002c-Leslie"></span> and Texinfo <span id="index-Texinfo"></span> -(Originally written by Richard Stallman). +(originally written by Richard Stallman). <span id="index-Stallman_002c-Richard"></span> <span id="index-rms"></span> Instead, it provides definitions that are intended to be useful @@ -689,18 +357,11 @@ defined as the macro <code>\fmtversion</code> at the end of the source file <samp>eplain.tex</samp>. When corresponding, please refer to it. </p> -<p>To get on this mailing list yourself, email -<a href="mailto:tex-eplain-request@tug.org">tex-eplain-request@tug.org</a> with a message whose body contains -a line -</p> -<div class="example"> -<pre class="example">subscribe <var>you@your.preferred.address</var> -</pre></div> - -<p>or visit <a href="http://lists.tug.org/tex-eplain">http://lists.tug.org/tex-eplain</a>. +<p>To subscribe to this mailing list (anyone can subscribe, and archives +are public), visit <a href="https://lists.tug.org/tex-eplain">https://lists.tug.org/tex-eplain</a>. </p> <span id="index-Walden_002c-David"></span> -<p>David Walden had reported his experience with Eplain as a new user. +<p>David Walden reported his experience with Eplain as a new user. The article is available online at <a href="https://tug.org/pracjourn/2005-4/walden">https://tug.org/pracjourn/2005-4/walden</a>. An introductory article (written for @@ -708,10 +369,30 @@ article (written for <i>TUGboat</i>) is also available online at <a href="https://tug.org/eplain/misc/tb84katsi.pdf">https://tug.org/eplain/misc/tb84katsi.pdf</a>. </p> +<p>Finally, here are two alternatives to Eplain: +</p> +<ol> +<li> If you just want to load the LaTeX color or graphics package, +the LaTeX team’s <samp>miniltx.tex</samp> suffices: + +<div class="example"> +<pre class="example">\input miniltx.tex +\input graphicx.tex +</pre></div> + +</li><li> <span id="index-OpTeX"></span> +If you’re interested in a fully-fledged format that shares much of +Eplain’s (and plain.tex’s) philosophy, check out OpTeX: +<a href="https://ctan.org/pkg/optex">https://ctan.org/pkg/optex</a>. + +</li></ol> + <hr> -<span id="Installation"></span><div class="header"> +</div> +<div class="chapter" id="Installation"> +<div class="header"> <p> -Next: <a href="#Invoking-Eplain" accesskey="n" rel="next">Invoking Eplain</a>, Previous: <a href="#Introduction" accesskey="p" rel="prev">Introduction</a>, Up: <a href="#Top" accesskey="u" rel="up">Top</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Macro-index" title="Index" rel="index">Index</a>]</p> +Next: <a href="#Invoking-Eplain" accesskey="n" rel="next">Invoking Eplain</a>, Previous: <a href="#Introduction" accesskey="p" rel="prev">Introduction</a>, Up: <a href="#Top" accesskey="u" rel="up">Eplain</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Macro-index" title="Index" rel="index">Index</a>]</p> </div> <span id="Installation-1"></span><h2 class="chapter">2 Installation</h2> @@ -720,38 +401,28 @@ Next: <a href="#Invoking-Eplain" accesskey="n" rel="next">Invoking Eplain</a>, P <span id="index-Eplain_002c-upgrading"></span> <span id="index-upgrading"></span> <p>Your TeX installation should already contain a version of Eplain -(<samp>eplain.tex</samp>) in its main <samp>texmf</samp> tree (usually under -<samp>/usr/share/texmf/tex/eplain/</samp> on Unix systems). To install a -newer version of Eplain, put the new <samp>eplain.tex</samp> (included in -Eplain distributions) in the <samp>tex/eplain/</samp> subdirectory of your -local <samp>texmf</samp> tree. The newer version you install in the local -tree should override the older one in the main tree. -</p> -<p>The location of the local <samp>texmf</samp> tree obviously depends on your -operating system and TeX installation. On Unix systems the usual -location is <samp>/usr/local/share/texmf/</samp>. If you don’t have write -permissions for <samp>/usr/local/share/texmf/</samp>, many installations read -the <samp>texmf</samp> tree in the user’s home directory; <samp>eplain.tex</samp> -then should go under <samp>~/texmf/tex/eplain/</samp>. For more information -about TeX directory structure, please see -<a href="http://www.tex.ac.uk/cgi-bin/texfaq2html?label=tds">http://www.tex.ac.uk/cgi-bin/texfaq2html?label=tds</a>. +(<samp>eplain.tex</samp>) in its main <samp>texmf</samp> tree; with TeX Live, +it’s in <samp>.../texmf-dist/tex/eplain/eplain.tex</samp>. +</p> +<p>Generally, you can just use that version and there is no need to do +anything else. But if you want to use a newer version of Eplain for a +given document, you can put the new <samp>eplain.tex</samp> in the +document’s directory, and it will be found. </p> <span id="index-TEXINPUTS"></span> -<p>If you prefer to install <samp>eplain.tex</samp> in a non-standard place, set -an environment variable (<code>TEXINPUTS</code> for the Web2C port of TeX -to Unix) to tell TeX how to find it. +<p>If you want to install a new <samp>eplain.tex</samp> in some other place, +set an environment variable (commonly, <code>TEXINPUTS</code>) to tell +TeX how to find it. </p> -<p>If you want, you can also create a format (<samp>.fmt</samp>) <span id="index-_002efmt-file"></span> <span id="index-format-file"></span> <span id="index-eplain_002efmt"></span> -file for Eplain, which will eliminate the time spent reading the macro -source file with <code>\input</code>. You do this by issuing a sequence of -Unix commands something like this: +<p>Distributions should also create and maintain the <samp>eplain.fmt</samp> +file file. But if you want to do it yourself, you can: </p> <div class="example"> -<pre class="example">prompt$ touch eplain.aux -prompt$ initex +<pre class="example">$ touch eplain.aux +$ initex This is TeX, ... **&plain eplain (eplain.tex) @@ -761,22 +432,22 @@ This is TeX, ... <span id="index-eplain_002eaux"></span> <span id="index-undefined-labels_002c-warnings-about"></span> -<p>You must make sure that <samp>eplain.aux</samp> exists <em>before</em> you -run <samp>initex</samp>; otherwise, warning messages about undefined labels -will never be issued. +<p>You must make sure that <samp>eplain.aux</samp> exists +<em>before</em> you run <samp>initex</samp>; otherwise, warning messages about +undefined labels will never be issued. </p> <span id="index-TEXFORMATS"></span> <p>You then have to install the resulting <samp>eplain.fmt</samp> in your local -<samp>texmf</samp> tree or set an environment variable to tell TeX how to -find it. For the Web2C port of TeX to Unix, format files are usually -installed under <samp>/usr/local/share/texmf/web2c/</samp> or -<samp>/var/lib/texmf/web2c/</samp>; the environment variable is -<code>TEXFORMATS</code>. +<samp>texmf</samp> tree or set an environment variable (<code>TEXFORMATS</code> to +tell TeX how to find it. You’ll need to consult your +distribution’s documentation about that. </p> <hr> -<span id="Invoking-Eplain"></span><div class="header"> +</div> +<div class="chapter" id="Invoking-Eplain"> +<div class="header"> <p> -Next: <a href="#User-definitions" accesskey="n" rel="next">User definitions</a>, Previous: <a href="#Installation" accesskey="p" rel="prev">Installation</a>, Up: <a href="#Top" accesskey="u" rel="up">Top</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Macro-index" title="Index" rel="index">Index</a>]</p> +Next: <a href="#User-definitions" accesskey="n" rel="next">User definitions</a>, Previous: <a href="#Installation" accesskey="p" rel="prev">Installation</a>, Up: <a href="#Top" accesskey="u" rel="up">Eplain</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Macro-index" title="Index" rel="index">Index</a>]</p> </div> <span id="Invoking-Eplain-1"></span><h2 class="chapter">3 Invoking Eplain</h2> @@ -787,26 +458,25 @@ Next: <a href="#User-definitions" accesskey="n" rel="next">User definitions</a>, <pre class="example">\input eplain </pre></div> -<p>at the beginning of your input file. The macro file is small -enough that reading it does not take an unbearably long time—at least on -contemporary machines. +<p>at the beginning of your (plain TeX) input file. The +macro file is small enough that reading it does not take long. </p> -<p>In addition, if a format (<samp>.fmt</samp>) +<p>However, if a format (<samp>.fmt</samp>) <span id="index-_002efmt-file-1"></span> file has been created for Eplain (see the previous section), you can -eliminate the time spent reading the macro source file. You do this +eliminate even the time spent reading the macro source file. You do this by responding <code>&eplain</code> to TeX’s ‘<samp>**</samp>’ prompt. For example: </p> <div class="example"> -<pre class="example">initex +<pre class="example">$ tex This is TeX, ... **&eplain myfile </pre></div> -<p>Depending on the implementation of TeX which you are using, you might -also be able to invoke TeX as <samp>eplain</samp> and have the format file -automatically read. +<p>In TeX Live and other distributions, a command-line executable +named <samp>eplain</samp> is provided which reads the <samp>eplain.fmt</samp> file +automatically. </p> <p>If you write something which you will be distributing to others, you won’t know if the Eplain format will be loaded already. If it is, then @@ -815,8 +485,8 @@ load it. To solve this, Eplain defines the control sequence <code>\eplain</code> <span id="index-eplain"></span> to be the letter <code>t</code> (a convention borrowed from Lisp; it doesn’t -actually matter what the definition is, only that the definition -exists). Therefore, you can do the following: +matter what the definition is, only that the definition exists). +Therefore, you can do the following: </p> <div class="example"> <pre class="example">\ifx\eplain\undefined \input eplain \fi @@ -826,32 +496,32 @@ exists). Therefore, you can do the following: </p> <p>Eplain consists of several source files: </p><dl compact="compact"> -<dt><samp>xeplain.tex</samp></dt> +<dt><span><samp>xeplain.tex</samp></span></dt> <dd><p>most of the macros; </p> </dd> -<dt><samp>arrow.tex</samp></dt> +<dt><span><samp>arrow.tex</samp></span></dt> <dd><p>commutative diagram macros (see <a href="#Arrow-theoretic-diagrams">Arrow theoretic diagrams</a>), written by Steven Smith; </p> </dd> -<dt><samp>btxmac.tex</samp></dt> +<dt><span><samp>btxmac.tex</samp></span></dt> <dd><p>bibliography-related macros (see <a href="#Citations">Citations</a>); </p> </dd> -<dt><samp>ifpdf.sty</samp></dt> -<dd><p>sets the switch <code>\ifpdf</code>, which can be used to detect pdfTeX -in PDF mode (see <a href="#Checking-for-PDF-output">Checking for PDF output</a>), written by Heiko -Oberdiek; +<dt><span><samp>iftex.sty</samp></span></dt> +<dd><p>sets the switch <code>\ifpdf</code> (among other things), which can be used +to detect direct PDF output (see <a href="#Checking-for-PDF-output">Checking for PDF output</a>), +originally written by Heiko Oberdiek; </p> </dd> -<dt><samp>path.sty</samp></dt> +<dt><span><samp>path.sty</samp></span></dt> <dd><p>macro for allowing line breaks at punctuation characters within long pathnames, electronic mail addresses, etc., (see <a href="#Paths">Paths</a>), written by Philip Taylor; </p> </dd> -<dt><samp>texnames.sty</samp></dt> +<dt><span><samp>texnames.sty</samp></span></dt> <dd><p>abbreviations for various TeX-related names (see <a href="#Logos">Logos</a>), edited by Nelson Beebe. </p> @@ -860,7 +530,7 @@ by Nelson Beebe. <p>The file <samp>eplain.tex</samp> is all of these files merged together, with comments removed. The original sources can be found in -Eplain source zip archive in your TeX distribution, on <acronym>CTAN</acronym> +Eplain source zip archive in your TeX distribution, on CTAN or on Eplain’s home page at <a href="https://tug.org/eplain">https://tug.org/eplain</a>. </p> <p>All of these files except <samp>xeplain.tex</samp> can be input individually, @@ -879,7 +549,7 @@ example, you could start your input file like this: \input eplain </pre></div> -<p>By default, <code>\nobibtex</code> is undefined, and so the +<p>By default, <code>\nobibtex</code> is not defined, and so the bibliography definitions <em>are</em> made. </p> <span id="index-noarrow"></span> @@ -914,26 +584,28 @@ Eplain and before using <code>\ref</code>. <samp>.tex</samp> file in order to produce and typeset indexes, resolve undefined cross-references and/or citations. The shell script <code>texi2dvi</code> from the Texinfo documentation system (see -<a href="http://www.gnu.org/software/texinfo">http://www.gnu.org/software/texinfo</a>) can automate this process: +<a href="https://www.gnu.org/software/texinfo">https://www.gnu.org/software/texinfo</a>) can automate this process: it runs BibTeX, MakeIndex and TeX as many times as needed to complete the compilation process. You will need to set the <code>LATEX</code> environment variable to ‘<samp>tex</samp>’. For example, in a Bourne-compatible shell, the following command will do all the work: </p> <div class="example"> -<pre class="example">prompt$ LATEX=tex texi2dvi file.tex +<pre class="example">$ LATEX=tex texi2dvi file.tex </pre></div> <span id="index-pdftex"></span> -<p>(Despite the name, <code>texi2dvi</code> can also produce -<samp>.pdf</samp> files; just set ‘<samp>LATEX=pdftex</samp>’.) See the output from -the command <code>texi2dvi --help</code> for invoking information and a -full list of options. +<p>Despite the name, <code>texi2dvi</code> can also produce +<samp>.pdf</samp> output (among other formats); set <code>LATEX=pdftex</code> for +this. See the output from <code>texi2dvi --help</code> for a full list +of options. </p> <hr> -<span id="User-definitions"></span><div class="header"> +</div> +<div class="chapter" id="User-definitions"> +<div class="header"> <p> -Next: <a href="#Hyperlinks" accesskey="n" rel="next">Hyperlinks</a>, Previous: <a href="#Invoking-Eplain" accesskey="p" rel="prev">Invoking Eplain</a>, Up: <a href="#Top" accesskey="u" rel="up">Top</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Macro-index" title="Index" rel="index">Index</a>]</p> +Next: <a href="#Hyperlinks" accesskey="n" rel="next">Hyperlinks</a>, Previous: <a href="#Invoking-Eplain" accesskey="p" rel="prev">Invoking Eplain</a>, Up: <a href="#Top" accesskey="u" rel="up">Eplain</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Macro-index" title="Index" rel="index">Index</a>]</p> </div> <span id="User-definitions-1"></span><h2 class="chapter">4 User definitions</h2> @@ -941,58 +613,36 @@ Next: <a href="#Hyperlinks" accesskey="n" rel="next">Hyperlinks</a>, Previous: < in a document. When appropriate, ways to change the default formatting are described in subsections. </p> -<table class="menu" border="0" cellspacing="0"> -<tr><td align="left" valign="top">• <a href="#Diagnostics" accesskey="1">Diagnostics</a></td><td> </td><td align="left" valign="top">Tracing information. -</td></tr> -<tr><td align="left" valign="top">• <a href="#Rules" accesskey="2">Rules</a></td><td> </td><td align="left" valign="top">Changing the default rule dimensions. -</td></tr> -<tr><td align="left" valign="top">• <a href="#Citations" accesskey="3">Citations</a></td><td> </td><td align="left" valign="top">Using BibTeX and Eplain to make bibliographies. -</td></tr> -<tr><td align="left" valign="top">• <a href="#Displays" accesskey="4">Displays</a></td><td> </td><td align="left" valign="top">Changing the formatting of math displays. -</td></tr> -<tr><td align="left" valign="top">• <a href="#Time-of-day" accesskey="5">Time of day</a></td><td> </td><td align="left" valign="top">Producing the time of day. -</td></tr> -<tr><td align="left" valign="top">• <a href="#Lists" accesskey="6">Lists</a></td><td> </td><td align="left" valign="top">Producing numbered and unordered lists. -</td></tr> -<tr><td align="left" valign="top">• <a href="#Verbatim-listing" accesskey="7">Verbatim listing</a></td><td> </td><td align="left" valign="top">Producing text just as it appears. -</td></tr> -<tr><td align="left" valign="top">• <a href="#Contents" accesskey="8">Contents</a></td><td> </td><td align="left" valign="top">Making a table of contents. -</td></tr> -<tr><td align="left" valign="top">• <a href="#Cross_002dreferences" accesskey="9">Cross-references</a></td><td> </td><td align="left" valign="top">Symbolic references to equations, figures, etc. -</td></tr> -<tr><td align="left" valign="top">• <a href="#Page-references">Page references</a></td><td> </td><td align="left" valign="top">Symbolic references to page numbers. -</td></tr> -<tr><td align="left" valign="top">• <a href="#Equation-references">Equation references</a></td><td> </td><td align="left" valign="top">Symbolic references to equation numbers. -</td></tr> -<tr><td align="left" valign="top">• <a href="#Indexing">Indexing</a></td><td> </td><td align="left" valign="top">Creating and typesetting indexes. -</td></tr> -<tr><td align="left" valign="top">• <a href="#Justification">Justification</a></td><td> </td><td align="left" valign="top">Ragged left, ragged right, centered. -</td></tr> -<tr><td align="left" valign="top">• <a href="#Tables">Tables</a></td><td> </td><td align="left" valign="top">Producing ordered tables. -</td></tr> -<tr><td align="left" valign="top">• <a href="#Margins">Margins</a></td><td> </td><td align="left" valign="top">Changing the margins directly. -</td></tr> -<tr><td align="left" valign="top">• <a href="#Multiple-columns">Multiple columns</a></td><td> </td><td align="left" valign="top">Getting output in two columns. -</td></tr> -<tr><td align="left" valign="top">• <a href="#Footnotes">Footnotes</a></td><td> </td><td align="left" valign="top">Autonumbered footnotes; changing formatting. -</td></tr> -<tr><td align="left" valign="top">• <a href="#Fractions">Fractions</a></td><td> </td><td align="left" valign="top">A better way to produce fractions in text. -</td></tr> -<tr><td align="left" valign="top">• <a href="#Paths">Paths</a></td><td> </td><td align="left" valign="top">Allowing line breaks in pathnames. -</td></tr> -<tr><td align="left" valign="top">• <a href="#Logos">Logos</a></td><td> </td><td align="left" valign="top">Various logos. -</td></tr> -<tr><td align="left" valign="top">• <a href="#Boxes">Boxes</a></td><td> </td><td align="left" valign="top">Producing filled or open rectangles. -</td></tr> -<tr><td align="left" valign="top">• <a href="#Checking-for-PDF-output">Checking for PDF output</a></td><td> </td><td align="left" valign="top">Checking for pdfTeX in PDF mode. -</td></tr> -<tr><td align="left" valign="top">• <a href="#Loading-LaTeX-packages">Loading LaTeX packages</a></td><td> </td><td align="left" valign="top">Support for LaTeX packages under plain TeX. -</td></tr> -</table> +<ul class="section-toc"> +<li><a href="#Diagnostics" accesskey="1">Diagnostics</a></li> +<li><a href="#Rules" accesskey="2">Rules</a></li> +<li><a href="#Citations" accesskey="3">Citations</a></li> +<li><a href="#Displays" accesskey="4">Displays</a></li> +<li><a href="#Time-of-day" accesskey="5">Time of day</a></li> +<li><a href="#Lists" accesskey="6">Lists</a></li> +<li><a href="#Verbatim-listing" accesskey="7">Verbatim listing</a></li> +<li><a href="#Contents" accesskey="8">Contents</a></li> +<li><a href="#Cross_002dreferences" accesskey="9">Cross-references</a></li> +<li><a href="#Page-references">Page references</a></li> +<li><a href="#Equation-references">Equation references</a></li> +<li><a href="#Indexing">Indexing</a></li> +<li><a href="#Justification">Justification</a></li> +<li><a href="#Tables">Tables</a></li> +<li><a href="#Margins">Margins</a></li> +<li><a href="#Multiple-columns">Multiple columns</a></li> +<li><a href="#Footnotes">Footnotes</a></li> +<li><a href="#Fractions">Fractions</a></li> +<li><a href="#Paths">Paths</a></li> +<li><a href="#Logos">Logos</a></li> +<li><a href="#Boxes">Boxes</a></li> +<li><a href="#Checking-for-PDF-output">Checking for PDF output</a></li> +<li><a href="#Loading-LaTeX-packages">Loading LaTeX packages</a></li> +</ul> <hr> -<span id="Diagnostics"></span><div class="header"> +<div class="section" id="Diagnostics"> +<div class="header"> <p> Next: <a href="#Rules" accesskey="n" rel="next">Rules</a>, Up: <a href="#User-definitions" accesskey="u" rel="up">User definitions</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Macro-index" title="Index" rel="index">Index</a>]</p> </div> @@ -1047,7 +697,9 @@ Eplain defines it to be the character <code>^^J</code>. <hr> -<span id="Rules"></span><div class="header"> +</div> +<div class="section" id="Rules"> +<div class="header"> <p> Next: <a href="#Citations" accesskey="n" rel="next">Citations</a>, Previous: <a href="#Diagnostics" accesskey="p" rel="prev">Diagnostics</a>, Up: <a href="#User-definitions" accesskey="u" rel="up">User definitions</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Macro-index" title="Index" rel="index">Index</a>]</p> </div> @@ -1077,7 +729,9 @@ and <code>\evrule</code>. </p> <hr> -<span id="Citations"></span><div class="header"> +</div> +<div class="section" id="Citations"> +<div class="header"> <p> Next: <a href="#Displays" accesskey="n" rel="next">Displays</a>, Previous: <a href="#Rules" accesskey="p" rel="prev">Rules</a>, Up: <a href="#User-definitions" accesskey="u" rel="up">User definitions</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Macro-index" title="Index" rel="index">Index</a>]</p> </div> @@ -1150,7 +804,7 @@ which you specify within square brackets, as in LaTeX. This text is simply typeset after the citations. (See the example below.) </p> <p>Eplain can create hypertext links for citations pointing to the relevant -bibliography entries (see <a href="#Citation-hyperlinks">Citation hyperlinks</a>). +bibliography entries (see <a href="#Citation-hyperlinks">Citation hyperlinks: cite, bib</a>). </p> <p>Another command, <code>\nocite</code>, <span id="index-nocite"></span> @@ -1247,18 +901,16 @@ of numbered, the bibliography style is <code>alpha</code>.) <span id="index-alphanumeric-references"></span> <span id="index-references_002c-alphanumeric"></span> </p> -<table class="menu" border="0" cellspacing="0"> -<tr><td align="left" valign="top">• <a href="#Formatting-citations" accesskey="1">Formatting citations</a></td><td> </td><td align="left" valign="top">Changing the way citations are printed. -</td></tr> -<tr><td align="left" valign="top">• <a href="#Formatting-bibliographies" accesskey="2">Formatting bibliographies</a></td><td> </td><td align="left" valign="top">Changing the way bibliographies are printed. -</td></tr> -<tr><td align="left" valign="top">• <a href="#Commands-from-LaTeX" accesskey="3">Commands from LaTeX</a></td><td> </td><td align="left" valign="top">LaTeX commands defined by <samp>btxmac</samp>. -</td></tr> -</table> +<ul class="section-toc"> +<li><a href="#Formatting-citations" accesskey="1">Formatting citations</a></li> +<li><a href="#Formatting-bibliographies" accesskey="2">Formatting bibliographies</a></li> +<li><a href="#Commands-from-LaTeX" accesskey="3">Commands from LaTeX</a></li> +</ul> <hr> -<span id="Formatting-citations"></span><div class="header"> +<div class="subsection" id="Formatting-citations"> +<div class="header"> <p> Next: <a href="#Formatting-bibliographies" accesskey="n" rel="next">Formatting bibliographies</a>, Up: <a href="#Citations" accesskey="u" rel="up">Citations</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Macro-index" title="Index" rel="index">Index</a>]</p> </div> @@ -1274,25 +926,22 @@ such as superscripted labels. You can accommodate such formats by redefining the following macros. </p> <dl compact="compact"> -<dt><code>\printcitestart</code></dt> -<dt><code>\printcitefinish</code></dt> -<dd><span id="index-printcitestart"></span> -<span id="index-printcitefinish"></span> +<dt id='index-printcitestart'><span><code>\printcitestart</code><a href='#index-printcitestart' class='copiable-anchor'> ¶</a></span></dt> +<dt><span><code>\printcitefinish</code></span></dt> +<dd><span id="index-printcitefinish"></span> <p>Eplain expands these macros at the beginning and end of the list of citations for each <code>\cite</code> command. By default, they produce a ‘<samp>[</samp>’ and ‘<samp>]</samp>’, respectively. </p> </dd> -<dt><code>\printbetweencitations</code></dt> -<dd><span id="index-printbetweencitations"></span> -<p>If a <code>\cite</code> command has multiple citations, as in +<dt id='index-printbetweencitations'><span><code>\printbetweencitations</code><a href='#index-printbetweencitations' class='copiable-anchor'> ¶</a></span></dt> +<dd><p>If a <code>\cite</code> command has multiple citations, as in <code>\cite{acp,texbook}</code>, Eplain expands this macro in between each pair of citations. By default, it produces a comma followed by a space. </p> </dd> -<dt><code>\printcitenote</code></dt> -<dd><span id="index-printcitenote"></span> -<p>This macro takes one argument, which is the optional note to the +<dt id='index-printcitenote'><span><code>\printcitenote</code><a href='#index-printcitenote' class='copiable-anchor'> ¶</a></span></dt> +<dd><p>This macro takes one argument, which is the optional note to the <code>\cite</code> command. If the <code>\cite</code> command had no note, this macro isn’t used. Otherwise, it should print the note. By default, the note is preceded with a comma and a space. @@ -1312,7 +961,9 @@ superscripted labels, with the optional notes in parentheses. <hr> -<span id="Formatting-bibliographies"></span><div class="header"> +</div> +<div class="subsection" id="Formatting-bibliographies"> +<div class="header"> <p> Next: <a href="#Commands-from-LaTeX" accesskey="n" rel="next">Commands from LaTeX</a>, Previous: <a href="#Formatting-citations" accesskey="p" rel="prev">Formatting citations</a>, Up: <a href="#Citations" accesskey="u" rel="up">Citations</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Macro-index" title="Index" rel="index">Index</a>]</p> </div> @@ -1325,34 +976,30 @@ especially with respect to the fonts that are used. Therefore, Eplain provides the following control sequences: </p> <dl compact="compact"> -<dt><code>\biblabelwidth</code></dt> -<dd><span id="index-biblabelwidth"></span> -<p>This control sequence represents a <code>\dimen</code> register, and its value +<dt id='index-biblabelwidth'><span><code>\biblabelwidth</code><a href='#index-biblabelwidth' class='copiable-anchor'> ¶</a></span></dt> +<dd><p>This control sequence represents a <code>\dimen</code> register, and its value is the width of the widest label in the bibliography. Although it is unlikely you will ever want to redefine it, you might want to use it if you redefine <code>\biblabelprint</code>, below. </p> </dd> -<dt><code>\biblabelprint</code></dt> -<dd><span id="index-biblabelprint"></span> -<p>This macro takes one argument, the label to print. By default, the +<dt id='index-biblabelprint'><span><code>\biblabelprint</code><a href='#index-biblabelprint' class='copiable-anchor'> ¶</a></span></dt> +<dd><p>This macro takes one argument, the label to print. By default, the label is put in a box of width <code>\biblabelwidth</code>, and is followed by an enspace. When you want to change the spacing around the labels, this is the right macro to redefine. </p> </dd> -<dt><code>\biblabelcontents</code></dt> -<dd><span id="index-biblabelcontents"></span> -<p>This macro also takes one argument, the label to print. By default, the +<dt id='index-biblabelcontents'><span><code>\biblabelcontents</code><a href='#index-biblabelcontents' class='copiable-anchor'> ¶</a></span></dt> +<dd><p>This macro also takes one argument, the label to print. By default, the label is printed using the font <code>\bblrm</code> (below), and enclosed in brackets. When you want to change the appearance of the label, but not the spacing around it, this is the right macro to redefine. </p> </dd> -<dt><code>\biblabelprecontents</code></dt> -<dt><code>\biblabelpostcontents</code></dt> -<dd><span id="index-biblabelprecontents"></span> -<span id="index-biblabelpostcontents"></span> +<dt id='index-biblabelprecontents'><span><code>\biblabelprecontents</code><a href='#index-biblabelprecontents' class='copiable-anchor'> ¶</a></span></dt> +<dt><span><code>\biblabelpostcontents</code></span></dt> +<dd><span id="index-biblabelpostcontents"></span> <p>Macros expanded before and after <code>\biblabelcontents</code>, respectively. For example, to get left-justified numeric labels (they are right-justified by default): @@ -1363,32 +1010,27 @@ are right-justified by default): </pre></div> </dd> -<dt><code>\bblrm</code></dt> -<dd><span id="index-bblrm"></span> -<span id="index-bibliography-fonts"></span> +<dt id='index-bblrm'><span><code>\bblrm</code><a href='#index-bblrm' class='copiable-anchor'> ¶</a></span></dt> +<dd><span id="index-bibliography-fonts"></span> <p>The default font used for printing the bibliography. </p> </dd> -<dt><code>\bblem</code></dt> -<dd><span id="index-bblem"></span> -<p>The font used for printing the titles and other “emphasized” material. +<dt id='index-bblem'><span><code>\bblem</code><a href='#index-bblem' class='copiable-anchor'> ¶</a></span></dt> +<dd><p>The font used for printing the titles and other “emphasized” material. </p> </dd> -<dt><code>\bblemph</code></dt> -<dd><span id="index-bblemph"></span> -<span id="index-italic-correction"></span> +<dt id='index-bblemph'><span><code>\bblemph</code><a href='#index-bblemph' class='copiable-anchor'> ¶</a></span></dt> +<dd><span id="index-italic-correction"></span> <p>Typesets its argument using <code>\bblem</code>, then inserts an italic correction. </p> </dd> -<dt><code>\bblsc</code></dt> -<dd><span id="index-bblsc"></span> -<p>In some styles, authors’ names are printed in a caps-and-small-caps +<dt id='index-bblsc'><span><code>\bblsc</code><a href='#index-bblsc' class='copiable-anchor'> ¶</a></span></dt> +<dd><p>In some styles, authors’ names are printed in a caps-and-small-caps font. In those cases, this font is used. </p> </dd> -<dt><code>\bblnewblock</code></dt> -<dd><span id="index-bblnewblock"></span> -<p>This is invoked between each of the parts of a bibliography entry. The +<dt id='index-bblnewblock'><span><code>\bblnewblock</code><a href='#index-bblnewblock' class='copiable-anchor'> ¶</a></span></dt> +<dd><p>This is invoked between each of the parts of a bibliography entry. The default is to leave some extra space between the parts; you could redefine it to start each part on a new line (for example). A part is simply a main element of the entry; for example, the author is a part. @@ -1396,17 +1038,15 @@ simply a main element of the entry; for example, the author is a part. concerned) term ‘block’ for this.) </p> </dd> -<dt><code>\biblabelextraspace</code></dt> -<dd><span id="index-biblabelextraspace"></span> -<p>Bibliography entries are typeset with a hanging indentation of +<dt id='index-biblabelextraspace'><span><code>\biblabelextraspace</code><a href='#index-biblabelextraspace' class='copiable-anchor'> ¶</a></span></dt> +<dd><p>Bibliography entries are typeset with a hanging indentation of <code>\biblabelwidth</code> plus this. The default is <code>.5em</code>, where the em width is taken from the <code>\bblrm</code> font. If you want to change this, you should do it inside <code>\bblhook</code>. </p> </dd> -<dt><code>\bblhook</code></dt> -<dd><span id="index-bblhook"></span> -<span id="index-bibliography-items_002c-extra-space-between"></span> +<dt id='index-bblhook'><span><code>\bblhook</code><a href='#index-bblhook' class='copiable-anchor'> ¶</a></span></dt> +<dd><span id="index-bibliography-items_002c-extra-space-between"></span> <p>This is expanded before reading the <tt>.bbl</tt> file. By default, it does nothing. You could, for example, define it to set the bibliography fonts, or produce the heading for the references. Two @@ -1424,7 +1064,9 @@ file that BibTeX produces to do anything you wish. </p> <hr> -<span id="Commands-from-LaTeX"></span><div class="header"> +</div> +<div class="subsection" id="Commands-from-LaTeX"> +<div class="header"> <p> Previous: <a href="#Formatting-bibliographies" accesskey="p" rel="prev">Formatting bibliographies</a>, Up: <a href="#Citations" accesskey="u" rel="up">Citations</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Macro-index" title="Index" rel="index">Index</a>]</p> </div> @@ -1441,36 +1083,32 @@ following. In all cases, an existing definition (e.g., from packages</a>) will not be overwritten. Here is the list: </p> <dl compact="compact"> -<dt><code>\newcommand</code></dt> -<dt><code>\renewcommand</code></dt> -<dt><code>\providecommand</code></dt> -<dd><span id="index-newcommand"></span> -<span id="index-renewcommand"></span> +<dt id='index-newcommand'><span><code>\newcommand</code><a href='#index-newcommand' class='copiable-anchor'> ¶</a></span></dt> +<dt><span><code>\renewcommand</code></span></dt> +<dt><span><code>\providecommand</code></span></dt> +<dd><span id="index-renewcommand"></span> <span id="index-providecommand"></span> <span id="index-_002a_002dform-of-LaTeX-commands"></span> <p>Defining new commands in various ways. The Eplain versions do not support the *-form of these; use <samp>miniltx</samp> for that. </p> </dd> -<dt><code>\em</code></dt> -<dt><code>\emph</code></dt> -<dt><code>\sc</code></dt> -<dt><code>\textbf</code></dt> -<dd><span id="index-em"></span> -<span id="index-emph"></span> +<dt id='index-em'><span><code>\em</code><a href='#index-em' class='copiable-anchor'> ¶</a></span></dt> +<dt><span><code>\emph</code></span></dt> +<dt><span><code>\sc</code></span></dt> +<dt><span><code>\textbf</code></span></dt> +<dd><span id="index-emph"></span> <span id="index-sc"></span> <span id="index-textbf"></span> <p>Selecting fonts. </p> </dd> -<dt><code>\mbox</code></dt> -<dd><span id="index-mbox"></span> -<p>A horizontal box. +<dt id='index-mbox'><span><code>\mbox</code><a href='#index-mbox' class='copiable-anchor'> ¶</a></span></dt> +<dd><p>A horizontal box. </p> </dd> -<dt><code>\newblock</code></dt> -<dd><span id="index-newblock"></span> -<p>Starts elements of a bibliography entry. +<dt id='index-newblock'><span><code>\newblock</code><a href='#index-newblock' class='copiable-anchor'> ¶</a></span></dt> +<dd><p>Starts elements of a bibliography entry. </p></dd> </dl> @@ -1478,7 +1116,10 @@ support the *-form of these; use <samp>miniltx</samp> for that. </p> <hr> -<span id="Displays"></span><div class="header"> +</div> +</div> +<div class="section" id="Displays"> +<div class="header"> <p> Next: <a href="#Time-of-day" accesskey="n" rel="next">Time of day</a>, Previous: <a href="#Citations" accesskey="p" rel="prev">Citations</a>, Up: <a href="#User-definitions" accesskey="u" rel="up">User definitions</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Macro-index" title="Index" rel="index">Index</a>]</p> </div> @@ -1532,14 +1173,14 @@ up to produce either left-aligned or right-aligned equation numbers. (<code>\leqalignno</code>). Default is <code>\righteqnumbers</code> (right-aligned equation numbers). </p> -<table class="menu" border="0" cellspacing="0"> -<tr><td align="left" valign="top">• <a href="#Formatting-displays" accesskey="1">Formatting displays</a></td><td> </td><td align="left" valign="top">General formatting of displays. -</td></tr> -</table> +<ul class="section-toc"> +<li><a href="#Formatting-displays" accesskey="1">Formatting displays</a></li> +</ul> <hr> -<span id="Formatting-displays"></span><div class="header"> +<div class="subsection" id="Formatting-displays"> +<div class="header"> <p> Up: <a href="#Displays" accesskey="u" rel="up">Displays</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Macro-index" title="Index" rel="index">Index</a>]</p> </div> @@ -1560,7 +1201,10 @@ the token register <code>\previouseverydisplay</code>. </p> <hr> -<span id="Time-of-day"></span><div class="header"> +</div> +</div> +<div class="section" id="Time-of-day"> +<div class="header"> <p> Next: <a href="#Lists" accesskey="n" rel="next">Lists</a>, Previous: <a href="#Displays" accesskey="p" rel="prev">Displays</a>, Up: <a href="#User-definitions" accesskey="u" rel="up">User definitions</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Macro-index" title="Index" rel="index">Index</a>]</p> </div> @@ -1596,7 +1240,9 @@ produces the current date, as in ‘23 April 1964’. </p> <hr> -<span id="Lists"></span><div class="header"> +</div> +<div class="section" id="Lists"> +<div class="header"> <p> Next: <a href="#Verbatim-listing" accesskey="n" rel="next">Verbatim listing</a>, Previous: <a href="#Time-of-day" accesskey="p" rel="prev">Time of day</a>, Up: <a href="#User-definitions" accesskey="u" rel="up">User definitions</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Macro-index" title="Index" rel="index">Index</a>]</p> </div> @@ -1613,10 +1259,9 @@ enumerated. Plain TeX defines one macro to help with creating lists, Eplain provides two pairs of commands: </p> <dl compact="compact"> -<dt><code>\numberedlist … \endnumberedlist</code></dt> -<dt><code>\orderedlist … \endorderedlist</code></dt> -<dd><span id="index-numberedlist"></span> -<span id="index-endnumberedlist"></span> +<dt id='index-numberedlist'><span><code>\numberedlist … \endnumberedlist</code><a href='#index-numberedlist' class='copiable-anchor'> ¶</a></span></dt> +<dt><span><code>\orderedlist … \endorderedlist</code></span></dt> +<dd><span id="index-endnumberedlist"></span> <span id="index-orderedlist"></span> <span id="index-endorderedlist"></span> <p>These commands (they are synonyms) produce a list with the items @@ -1626,9 +1271,8 @@ nested <code>\numberedlist</code> labels the items with roman numerals. Yet more deeply nested numbered lists label items with ‘<samp>*</samp>’. </p> </dd> -<dt><code>\unorderedlist … \endunorderedlist</code></dt> -<dd><span id="index-unorderedlist"></span> -<span id="index-endunorderedlist"></span> +<dt id='index-unorderedlist'><span><code>\unorderedlist … \endunorderedlist</code><a href='#index-unorderedlist' class='copiable-anchor'> ¶</a></span></dt> +<dd><span id="index-endunorderedlist"></span> <p>This produces a list with the items labelled with small black boxes (“square bullets”). A nested <code>\unorderedlist</code> labels items with em-dashes. Doubly (and deeper) nested unordered lists label items with @@ -1650,7 +1294,7 @@ if the list items are numbered. You can produce the value of the label with <code>\xrefn</code>. See <a href="#Cross_002dreferences">Cross-references</a>. </p> <p>Eplain can create hypertext links for the markers produced by -<code>\xrefn</code> pointing to the relevant list item (see <a href="#List-hyperlinks">List hyperlinks</a>). +<code>\xrefn</code> pointing to the relevant list item (see <a href="#List-hyperlinks">List hyperlinks: li</a>). </p> <p>You can also say <code>\listcompact</code> <span id="index-listcompact"></span> @@ -1670,14 +1314,14 @@ The second paragraph of the second item. \endnumberedlist </pre></div> -<table class="menu" border="0" cellspacing="0"> -<tr><td align="left" valign="top">• <a href="#Formatting-lists" accesskey="1">Formatting lists</a></td><td> </td><td align="left" valign="top">Changing how the lists look. -</td></tr> -</table> +<ul class="section-toc"> +<li><a href="#Formatting-lists" accesskey="1">Formatting lists</a></li> +</ul> <hr> -<span id="Formatting-lists"></span><div class="header"> +<div class="subsection" id="Formatting-lists"> +<div class="header"> <p> Up: <a href="#Lists" accesskey="u" rel="up">Lists</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Macro-index" title="Index" rel="index">Index</a>]</p> </div> @@ -1689,21 +1333,18 @@ Up: <a href="#Lists" accesskey="u" rel="up">Lists</a> [<a href="#SEC_Cont likely that their default values won’t suit your particular layout. </p> <dl compact="compact"> -<dt><code>\abovelistskipamount, \belowlistskipamount</code></dt> -<dd><span id="index-abovelistskipamount"></span> -<span id="index-belowlistskipamount"></span> +<dt id='index-abovelistskipamount'><span><code>\abovelistskipamount, \belowlistskipamount</code><a href='#index-abovelistskipamount' class='copiable-anchor'> ¶</a></span></dt> +<dd><span id="index-belowlistskipamount"></span> <p>The vertical glue inserted before and after every list, respectively. </p> </dd> -<dt><code>\interitemskipamount</code></dt> -<dd><span id="index-interitemskipamount"></span> -<p>The vertical glue inserted before each item except the first. +<dt id='index-interitemskipamount'><span><code>\interitemskipamount</code><a href='#index-interitemskipamount' class='copiable-anchor'> ¶</a></span></dt> +<dd><p>The vertical glue inserted before each item except the first. <code>\listcompact</code> resets this to zero, as mentioned above. </p> </dd> -<dt><code>\listleftindent, \listrightindent</code></dt> -<dd><span id="index-listleftindent"></span> -<span id="index-listrightindent"></span> +<dt id='index-listleftindent'><span><code>\listleftindent, \listrightindent</code><a href='#index-listleftindent' class='copiable-anchor'> ¶</a></span></dt> +<dd><span id="index-listrightindent"></span> <p><code>\listrightindent</code> is the amount of space by which the list is indented on the right; i.e., it is added to <code>\rightskip</code>. <code>\listleftindent</code> is the amount of space, <em>relative to</em> @@ -1741,15 +1382,13 @@ or <code>\unorderedmarker</code>. The following registers might be useful if you do: </p> <dl compact="compact"> -<dt><code>\numberedlistdepth, \unorderedlistdepth</code></dt> -<dd><span id="index-numberedlistdepth"></span> -<span id="index-unorderedlistdepth"></span> +<dt id='index-numberedlistdepth'><span><code>\numberedlistdepth, \unorderedlistdepth</code><a href='#index-numberedlistdepth' class='copiable-anchor'> ¶</a></span></dt> +<dd><span id="index-unorderedlistdepth"></span> <p>These keep track of the depth of nesting of the two kinds of lists. </p> </dd> -<dt><code>\itemnumber, \itemletter</code></dt> -<dd><span id="index-itemnumber"></span> -<span id="index-itemletter"></span> +<dt id='index-itemnumber'><span><code>\itemnumber, \itemletter</code><a href='#index-itemnumber' class='copiable-anchor'> ¶</a></span></dt> +<dd><span id="index-itemletter"></span> <p>These keep track of the number of items that have been seen in the current numbered list. They are both integer registers. The difference is that <code>\itemnumber</code> starts at one, and <code>\itemletter</code> starts at 97, @@ -1773,7 +1412,10 @@ lists. </p> <hr> -<span id="Verbatim-listing"></span><div class="header"> +</div> +</div> +<div class="section" id="Verbatim-listing"> +<div class="header"> <p> Next: <a href="#Contents" accesskey="n" rel="next">Contents</a>, Previous: <a href="#Lists" accesskey="p" rel="prev">Lists</a>, Up: <a href="#User-definitions" accesskey="u" rel="up">User definitions</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Macro-index" title="Index" rel="index">Index</a>]</p> </div> @@ -1819,9 +1461,8 @@ consists exclusively of boxes at the top level (i.e., any </p> <span id="index-form-feed-character_002c-and-verbatim-listing"></span> <span id="index-CTRL_002dL_002c-and-verbatim-listing"></span> -<p>You can use the form feed control character (<acronym>ASCII</acronym> -code 12, typed as <kbd>CTRL-L</kbd>) in the file to force a page break -in the output. +<p>You can use the form feed control character (ASCII code 12, typed +as <kbd>CTRL-L</kbd>) in the file to force a page break in the output. </p> <p>You can produce in-line verbatim text in your document with <code>\verbatim</code>. <span id="index-verbatim"></span> @@ -1887,7 +1528,9 @@ help you (see <a href="#Category-codes">Category codes</a>). </p> <hr> -<span id="Contents"></span><div class="header"> +</div> +<div class="section" id="Contents"> +<div class="header"> <p> Next: <a href="#Cross_002dreferences" accesskey="n" rel="next">Cross-references</a>, Previous: <a href="#Verbatim-listing" accesskey="p" rel="prev">Verbatim listing</a>, Up: <a href="#User-definitions" accesskey="u" rel="up">User definitions</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Macro-index" title="Index" rel="index">Index</a>]</p> </div> @@ -1903,22 +1546,19 @@ Eplain uses an auxiliary file with extension <samp>.toc</samp> <span id="index-_002etoc-file"></span> (and the same root name as your document) to save the information. </p> -<table class="menu" border="0" cellspacing="0"> -<tr><td align="left" valign="top">• <a href="#Writing-the-_002etoc-file" accesskey="1">Writing the .toc file</a></td><td> </td><td align="left" valign="top"> -</td></tr> -<tr><td align="left" valign="top">• <a href="#Reading-the-_002etoc-file" accesskey="2">Reading the .toc file</a></td><td> </td><td align="left" valign="top"> -</td></tr> -<tr><td align="left" valign="top">• <a href="#Changing-the-_002etoc-file_0027s-root-name" accesskey="3">Changing the .toc file's root name</a></td><td> </td><td align="left" valign="top"> -</td></tr> -<tr><td align="left" valign="top">• <a href="#Alternative-contents-files" accesskey="4">Alternative contents files</a></td><td> </td><td align="left" valign="top"> -</td></tr> -</table> +<ul class="section-toc"> +<li><a href="#Writing-the-_002etoc-file" accesskey="1">Writing the <tt>.toc</tt> file</a></li> +<li><a href="#Reading-the-_002etoc-file" accesskey="2">Reading the <tt>.toc</tt> file</a></li> +<li><a href="#Changing-the-_002etoc-file_0027s-root-name" accesskey="3">Changing the <tt>.toc</tt> file’s root name</a></li> +<li><a href="#Alternative-contents-files" accesskey="4">Alternative contents files</a></li> +</ul> <hr> -<span id="Writing-the-_002etoc-file"></span><div class="header"> +<div class="subsection" id="Writing-the-_002etoc-file"> +<div class="header"> <p> -Next: <a href="#Reading-the-_002etoc-file" accesskey="n" rel="next">Reading the .toc file</a>, Up: <a href="#Contents" accesskey="u" rel="up">Contents</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Macro-index" title="Index" rel="index">Index</a>]</p> +Next: <a href="#Reading-the-_002etoc-file" accesskey="n" rel="next">Reading the <tt>.toc</tt> file</a>, Up: <a href="#Contents" accesskey="u" rel="up">Contents</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Macro-index" title="Index" rel="index">Index</a>]</p> </div> <span id="Writing-the-_002etoc-file-1"></span><h4 class="subsection">4.8.1 Writing the <tt>.toc</tt> file</h4> @@ -2012,9 +1652,11 @@ contents. To continue the previous examples: <hr> -<span id="Reading-the-_002etoc-file"></span><div class="header"> +</div> +<div class="subsection" id="Reading-the-_002etoc-file"> +<div class="header"> <p> -Next: <a href="#Changing-the-_002etoc-file_0027s-root-name" accesskey="n" rel="next">Changing the .toc file's root name</a>, Previous: <a href="#Writing-the-_002etoc-file" accesskey="p" rel="prev">Writing the .toc file</a>, Up: <a href="#Contents" accesskey="u" rel="up">Contents</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Macro-index" title="Index" rel="index">Index</a>]</p> +Next: <a href="#Changing-the-_002etoc-file_0027s-root-name" accesskey="n" rel="next">Changing the <tt>.toc</tt> file’s root name</a>, Previous: <a href="#Writing-the-_002etoc-file" accesskey="p" rel="prev">Writing the <tt>.toc</tt> file</a>, Up: <a href="#Contents" accesskey="u" rel="up">Contents</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Macro-index" title="Index" rel="index">Index</a>]</p> </div> <span id="Reading-the-_002etoc-file-1"></span><h4 class="subsection">4.8.2 Reading the <tt>.toc</tt> file</h4> @@ -2048,9 +1690,11 @@ manuscript, you can set <code>\rewritetocfilefalse</code>. </p> <hr> -<span id="Changing-the-_002etoc-file_0027s-root-name"></span><div class="header"> +</div> +<div class="subsection" id="Changing-the-_002etoc-file_0027s-root-name"> +<div class="header"> <p> -Next: <a href="#Alternative-contents-files" accesskey="n" rel="next">Alternative contents files</a>, Previous: <a href="#Reading-the-_002etoc-file" accesskey="p" rel="prev">Reading the .toc file</a>, Up: <a href="#Contents" accesskey="u" rel="up">Contents</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Macro-index" title="Index" rel="index">Index</a>]</p> +Next: <a href="#Alternative-contents-files" accesskey="n" rel="next">Alternative contents files</a>, Previous: <a href="#Reading-the-_002etoc-file" accesskey="p" rel="prev">Reading the <tt>.toc</tt> file</a>, Up: <a href="#Contents" accesskey="u" rel="up">Contents</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Macro-index" title="Index" rel="index">Index</a>]</p> </div> <span id="Changing-the-_002etoc-file_0027s-root-name-1"></span><h4 class="subsection">4.8.3 Changing the <tt>.toc</tt> file’s root name</h4> @@ -2075,9 +1719,11 @@ files from a single TeX job, use <code>\definecontentsfile</code> </p> <hr> -<span id="Alternative-contents-files"></span><div class="header"> +</div> +<div class="subsection" id="Alternative-contents-files"> +<div class="header"> <p> -Previous: <a href="#Changing-the-_002etoc-file_0027s-root-name" accesskey="p" rel="prev">Changing the .toc file's root name</a>, Up: <a href="#Contents" accesskey="u" rel="up">Contents</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Macro-index" title="Index" rel="index">Index</a>]</p> +Previous: <a href="#Changing-the-_002etoc-file_0027s-root-name" accesskey="p" rel="prev">Changing the <tt>.toc</tt> file’s root name</a>, Up: <a href="#Contents" accesskey="u" rel="up">Contents</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Macro-index" title="Index" rel="index">Index</a>]</p> </div> <span id="Alternative-contents-files-1"></span><h4 class="subsection">4.8.4 Alternative contents files</h4> @@ -2099,7 +1745,10 @@ the control sequence names. <hr> -<span id="Cross_002dreferences"></span><div class="header"> +</div> +</div> +<div class="section" id="Cross_002dreferences"> +<div class="header"> <p> Next: <a href="#Page-references" accesskey="n" rel="next">Page references</a>, Previous: <a href="#Contents" accesskey="p" rel="prev">Contents</a>, Up: <a href="#User-definitions" accesskey="u" rel="up">User definitions</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Macro-index" title="Index" rel="index">Index</a>]</p> </div> @@ -2133,18 +1782,17 @@ codes of plain TeX), but ‘<samp>%#\{</samp>’ has no valid characters and list items. See <a href="#Citations">Citations</a>, and <a href="#Lists">Lists</a>. </p> <p>Eplain can create hypertext links for the cross-references -(see <a href="#Cross_002dreference-hyperlinks">Cross-reference hyperlinks</a>). +(see <a href="#Cross_002dreference-hyperlinks">Cross-reference hyperlinks: definexref, ref</a>). </p> -<table class="menu" border="0" cellspacing="0"> -<tr><td align="left" valign="top">• <a href="#Defining-generic-references" accesskey="1">Defining generic references</a></td><td> </td><td align="left" valign="top"> -</td></tr> -<tr><td align="left" valign="top">• <a href="#Using-generic-references" accesskey="2">Using generic references</a></td><td> </td><td align="left" valign="top"> -</td></tr> -</table> +<ul class="section-toc"> +<li><a href="#Defining-generic-references" accesskey="1">Defining generic references</a></li> +<li><a href="#Using-generic-references" accesskey="2">Using generic references</a></li> +</ul> <hr> -<span id="Defining-generic-references"></span><div class="header"> +<div class="subsection" id="Defining-generic-references"> +<div class="header"> <p> Next: <a href="#Using-generic-references" accesskey="n" rel="next">Using generic references</a>, Up: <a href="#Cross_002dreferences" accesskey="u" rel="up">Cross-references</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Macro-index" title="Index" rel="index">Index</a>]</p> </div> @@ -2177,7 +1825,9 @@ commands. See the next section. </p> <hr> -<span id="Using-generic-references"></span><div class="header"> +</div> +<div class="subsection" id="Using-generic-references"> +<div class="header"> <p> Previous: <a href="#Defining-generic-references" accesskey="p" rel="prev">Defining generic references</a>, Up: <a href="#Cross_002dreferences" accesskey="u" rel="up">Cross-references</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Macro-index" title="Index" rel="index">Index</a>]</p> </div> @@ -2194,10 +1844,10 @@ the previous section), Eplain provides the following macros: <dd> <span id="index-refn"></span> </dd> -<dt><code>\refn{<var>label</var>}</code></dt> +<dt><span><code>\refn{<var>label</var>}</code></span></dt> <dd><span id="index-xrefn"></span> </dd> -<dt><code>\xrefn{<var>label</var>}</code></dt> +<dt><span><code>\xrefn{<var>label</var>}</code></span></dt> <dd><p><code>\refn</code> and <code>\xrefn</code> (they are synonyms) produce the bare definition of <var>label</var>. If <var>label</var> isn’t defined, issue a warning, and produce <var>label</var> itself instead, in typewriter. (The @@ -2206,7 +1856,7 @@ warning isn’t given if <code>\xrefwarningfalse</code>.) </p> <span id="index-ref"></span> </dd> -<dt><code>\ref{<var>label</var>}</code></dt> +<dt><span><code>\ref{<var>label</var>}</code></span></dt> <dd><p>Given the class <var>c</var> for <var>label</var> (see the description of <code>\definexref</code> in the previous section), expand the control sequence <code>\<var>c</var> word</code> (if it’s defined) followed by a tie. Then call @@ -2214,7 +1864,7 @@ warning isn’t given if <code>\xrefwarningfalse</code>.) </p> <span id="index-refs"></span> </dd> -<dt><code>\refs{<var>label</var>}</code></dt> +<dt><span><code>\refs{<var>label</var>}</code></span></dt> <dd><p>Like <code>\ref</code>, but append the letter ‘<samp>s</samp>’ to the <code>\…word</code>. </p> @@ -2238,7 +1888,10 @@ See \refs{sec-intro} and \refn{sec-next} … </p> <hr> -<span id="Page-references"></span><div class="header"> +</div> +</div> +<div class="section" id="Page-references"> +<div class="header"> <p> Next: <a href="#Equation-references" accesskey="n" rel="next">Equation references</a>, Previous: <a href="#Cross_002dreferences" accesskey="p" rel="prev">Cross-references</a>, Up: <a href="#User-definitions" accesskey="u" rel="up">User definitions</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Macro-index" title="Index" rel="index">Index</a>]</p> </div> @@ -2248,15 +1901,13 @@ Next: <a href="#Equation-references" accesskey="n" rel="next">Equation reference one for definition and one for use. </p> <dl compact="compact"> -<dt><code>\xrdef{<var>label</var>}</code></dt> -<dd><span id="index-xrdef"></span> -<p>Define <var>label</var> to be the current page number. This produces no +<dt id='index-xrdef'><span><code>\xrdef{<var>label</var>}</code><a href='#index-xrdef' class='copiable-anchor'> ¶</a></span></dt> +<dd><p>Define <var>label</var> to be the current page number. This produces no printed output, and ignores following spaces. </p> </dd> -<dt><code>\xref{<var>label</var>}</code></dt> -<dd><span id="index-xref"></span> -<p>Produce the text ‘p. <var>pageno</var>’, which is the usual form for +<dt id='index-xref'><span><code>\xref{<var>label</var>}</code><a href='#index-xref' class='copiable-anchor'> ¶</a></span></dt> +<dd><p>Produce the text ‘p. <var>pageno</var>’, which is the usual form for cross-references. The <var>pageno</var> is actually <var>label</var>’s definition; if <var>label</var> isn’t defined, the text of the label itself is printed. The ‘p. ’ prefix is defined by <code>\xrefpageword</code>. @@ -2266,11 +1917,13 @@ Its default definition is <code>p.\thinspace</code>. </dd> </dl> -<p>Eplain can create hypertext links for the page references (see <a href="#Page-reference-hyperlinks">Page reference hyperlinks</a>). +<p>Eplain can create hypertext links for the page references (see <a href="#Page-reference-hyperlinks">Page reference hyperlinks: xrdef, xref</a>). </p> <hr> -<span id="Equation-references"></span><div class="header"> +</div> +<div class="section" id="Equation-references"> +<div class="header"> <p> Next: <a href="#Indexing" accesskey="n" rel="next">Indexing</a>, Previous: <a href="#Page-references" accesskey="p" rel="prev">Page references</a>, Up: <a href="#User-definitions" accesskey="u" rel="up">User definitions</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Macro-index" title="Index" rel="index">Index</a>]</p> </div> @@ -2288,9 +1941,8 @@ numbered equation. <p>Here are the commands to define equation labels and then refer to them: </p> <dl compact="compact"> -<dt><code>\eqdef{<var>label</var>}</code></dt> -<dd><span id="index-eqdef"></span> -<span id="index-eqnum-1"></span> +<dt id='index-eqdef'><span><code>\eqdef{<var>label</var>}</code><a href='#index-eqdef' class='copiable-anchor'> ¶</a></span></dt> +<dd><span id="index-eqnum-1"></span> <p>This defines <var>label</var> to be the current value of <code>\eqnumber</code>, and, if the current context is not inner, then produces a <code>\eqnum</code> command (see <a href="#Displays">Displays</a>). (The condition makes it possible to use @@ -2318,9 +1970,8 @@ definition between the original definition and the reference, the reference will start to refer to the new empty-labeled equation. </p> </dd> -<dt><code>\eqdefn{<var>label</var>}</code></dt> -<dd><span id="index-eqdefn"></span> -<span id="index-eqnum-2"></span> +<dt id='index-eqdefn'><span><code>\eqdefn{<var>label</var>}</code><a href='#index-eqdefn' class='copiable-anchor'> ¶</a></span></dt> +<dd><span id="index-eqnum-2"></span> <p>This is like <code>\eqdef</code>, except it always omits the <code>\eqnum</code> command. It can therefore be used in places where <code>\eqdef</code> can’t; for example, in a non-displayed equation. The text of the equation @@ -2329,16 +1980,14 @@ unusual) circumstance when you want to define an equation label but not print that label. </p> </dd> -<dt><code>\eqref{<var>label</var>}</code></dt> -<dd><span id="index-eqref"></span> -<p>This produces a formatted reference to <var>label</var>. If <var>label</var> is +<dt id='index-eqref'><span><code>\eqref{<var>label</var>}</code><a href='#index-eqref' class='copiable-anchor'> ¶</a></span></dt> +<dd><p>This produces a formatted reference to <var>label</var>. If <var>label</var> is undefined (perhaps because it is a forward reference), it just produces the text of the label itself. Otherwise, it calls <code>\eqprint</code>. </p> </dd> -<dt><code>\eqrefn{<var>label</var>}</code></dt> -<dd><span id="index-eqrefn"></span> -<p>This produces the cross-reference text for <var>label</var>. That is, it +<dt id='index-eqrefn'><span><code>\eqrefn{<var>label</var>}</code><a href='#index-eqrefn' class='copiable-anchor'> ¶</a></span></dt> +<dd><p>This produces the cross-reference text for <var>label</var>. That is, it is like <code>\eqref</code>, except it doesn’t call <code>\eqprint</code>. </p> </dd> @@ -2349,19 +1998,18 @@ is like <code>\eqref</code>, except it doesn’t call <code>\eqprint</code>. general cross-references. </p> <p>Eplain can create hypertext links for the equation references -(see <a href="#Equation-reference-hyperlinks">Equation reference hyperlinks</a>). +(see <a href="#Equation-reference-hyperlinks">Equation reference hyperlinks: eq</a>). </p> -<table class="menu" border="0" cellspacing="0"> -<tr><td align="left" valign="top">• <a href="#Formatting-equation-references" accesskey="1">Formatting equation references</a></td><td> </td><td align="left" valign="top"> -</td></tr> -<tr><td align="left" valign="top">• <a href="#Subequation-references" accesskey="2">Subequation references</a></td><td> </td><td align="left" valign="top"> -</td></tr> -</table> +<ul class="section-toc"> +<li><a href="#Formatting-equation-references" accesskey="1">Formatting equation references</a></li> +<li><a href="#Subequation-references" accesskey="2">Subequation references</a></li> +</ul> <hr> -<span id="Formatting-equation-references"></span><div class="header"> +<div class="subsection" id="Formatting-equation-references"> +<div class="header"> <p> Next: <a href="#Subequation-references" accesskey="n" rel="next">Subequation references</a>, Up: <a href="#Equation-references" accesskey="u" rel="up">Equation references</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Macro-index" title="Index" rel="index">Index</a>]</p> </div> @@ -2475,7 +2123,9 @@ therefore we first put the argument in a box, thus causing </p> <hr> -<span id="Subequation-references"></span><div class="header"> +</div> +<div class="subsection" id="Subequation-references"> +<div class="header"> <p> Previous: <a href="#Formatting-equation-references" accesskey="p" rel="prev">Formatting equation references</a>, Up: <a href="#Equation-references" accesskey="u" rel="up">Equation references</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Macro-index" title="Index" rel="index">Index</a>]</p> </div> @@ -2530,13 +2180,16 @@ like. For example, this definition makes the labels print as ‘2a’, } </pre></div> -<p>Sadly, we must define a new count register, <code>\subref</code>, +<p>We must define a new count register, <code>\subref</code>, instead of using the scratch count register <code>\count255</code>, because ‘<samp>#1</samp>’ might include other macro calls which use <code>\count255</code>. </p> <hr> -<span id="Indexing"></span><div class="header"> +</div> +</div> +<div class="section" id="Indexing"> +<div class="header"> <p> Next: <a href="#Justification" accesskey="n" rel="next">Justification</a>, Previous: <a href="#Equation-references" accesskey="p" rel="prev">Equation references</a>, Up: <a href="#User-definitions" accesskey="u" rel="up">User definitions</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Macro-index" title="Index" rel="index">Index</a>]</p> </div> @@ -2551,7 +2204,7 @@ collection and sorting of terms, because TeX itself has no support for sorting. </p> <p>Eplain can create hypertext links pointing from the index to the index -terms (see <a href="#Index-hyperlinks">Index hyperlinks</a>). +terms (see <a href="#Index-hyperlinks">Index hyperlinks: idx</a>). </p> <span id="index-makeindex-1"></span> <p>Eplain’s indexing commands were designed to work with the program @@ -2626,18 +2279,16 @@ will not write index entries there. This may be useful for draft compilations of a manuscript, e.g., to avoid the overhead of index file input/output. </p> -<table class="menu" border="0" cellspacing="0"> -<tr><td align="left" valign="top">• <a href="#Indexing-terms" accesskey="1">Indexing terms</a></td><td> </td><td align="left" valign="top">Specifying what to index. -</td></tr> -<tr><td align="left" valign="top">• <a href="#Typesetting-an-index" accesskey="2">Typesetting an index</a></td><td> </td><td align="left" valign="top">Printing the sorted output. -</td></tr> -<tr><td align="left" valign="top">• <a href="#Customizing-indexing" accesskey="3">Customizing indexing</a></td><td> </td><td align="left" valign="top">Creating commands and specifying extra actions. -</td></tr> -</table> +<ul class="section-toc"> +<li><a href="#Indexing-terms" accesskey="1">Indexing terms</a></li> +<li><a href="#Typesetting-an-index" accesskey="2">Typesetting an index</a></li> +<li><a href="#Customizing-indexing" accesskey="3">Customizing indexing</a></li> +</ul> <hr> -<span id="Indexing-terms"></span><div class="header"> +<div class="subsection" id="Indexing-terms"> +<div class="header"> <p> Next: <a href="#Typesetting-an-index" accesskey="n" rel="next">Typesetting an index</a>, Up: <a href="#Indexing" accesskey="u" rel="up">Indexing</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Macro-index" title="Index" rel="index">Index</a>]</p> </div> @@ -2669,20 +2320,17 @@ makes an index entry that will eventually be typeset (by default) as <span id="index-indexing-and-trailing-spaces"></span> <p>Also, the silent commands ignore trailing spaces. The non-silent ones do not. </p> -<table class="menu" border="0" cellspacing="0"> -<tr><td align="left" valign="top">• <a href="#Indexing-commands" accesskey="1">Indexing commands</a></td><td> </td><td align="left" valign="top">Making index entries. -</td></tr> -<tr><td align="left" valign="top">• <a href="#Modifying-index-entries" accesskey="2">Modifying index entries</a></td><td> </td><td align="left" valign="top">Ranges, see/see also, page number typesetting. -</td></tr> -<tr><td align="left" valign="top">• <a href="#Index-entries-with-special-characters" accesskey="3">Index entries with special characters</a></td><td> </td><td align="left" valign="top"> -</td></tr> -<tr><td align="left" valign="top">• <a href="#Proofing-index-terms" accesskey="4">Proofing index terms</a></td><td> </td><td align="left" valign="top">Noting index entries in the margins. -</td></tr> -</table> +<ul class="section-toc"> +<li><a href="#Indexing-commands" accesskey="1">Indexing commands</a></li> +<li><a href="#Modifying-index-entries" accesskey="2">Modifying index entries</a></li> +<li><a href="#Index-entries-with-special-characters" accesskey="3">Index entries with special characters</a></li> +<li><a href="#Proofing-index-terms" accesskey="4">Proofing index terms</a></li> +</ul> <hr> -<span id="Indexing-commands"></span><div class="header"> +<div class="subsubsection" id="Indexing-commands"> +<div class="header"> <p> Next: <a href="#Modifying-index-entries" accesskey="n" rel="next">Modifying index entries</a>, Up: <a href="#Indexing-terms" accesskey="u" rel="up">Indexing terms</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Macro-index" title="Index" rel="index">Index</a>]</p> </div> @@ -2789,7 +2437,9 @@ could do: <hr> -<span id="Modifying-index-entries"></span><div class="header"> +</div> +<div class="subsubsection" id="Modifying-index-entries"> +<div class="header"> <p> Next: <a href="#Index-entries-with-special-characters" accesskey="n" rel="next">Index entries with special characters</a>, Previous: <a href="#Indexing-commands" accesskey="p" rel="prev">Indexing commands</a>, Up: <a href="#Indexing-terms" accesskey="u" rel="up">Indexing terms</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Macro-index" title="Index" rel="index">Index</a>]</p> </div> @@ -2813,10 +2463,9 @@ is independent of these. <p>Here are the possibilities: </p> <dl compact="compact"> -<dt><code>begin</code></dt> -<dt><code>end</code></dt> -<dd><span id="index-begin-for-index-entries"></span> -<span id="index-end-for-index-entries"></span> +<dt id='index-begin-for-index-entries'><span><code>begin</code><a href='#index-begin-for-index-entries' class='copiable-anchor'> ¶</a></span></dt> +<dt><span><code>end</code></span></dt> +<dd><span id="index-end-for-index-entries"></span> <span id="index-index-entries-and-ranges"></span> <span id="index-ranges-and-index-entry"></span> <p>These mark an index entry as the beginning or end of a range. The index @@ -2837,9 +2486,8 @@ Example: </pre></div> </dd> -<dt><code>see</code></dt> -<dd><span id="index-see-for-index-entries"></span> -<span id="index-see_002c-and-index-entries"></span> +<dt id='index-see-for-index-entries'><span><code>see</code><a href='#index-see-for-index-entries' class='copiable-anchor'> ¶</a></span></dt> +<dd><span id="index-see_002c-and-index-entries"></span> <span id="index-cross_002dreferencing-index-entries"></span> <span id="index-index-entries_002c-and-cross_002dreferencing"></span> <p>This marks an index entry as pointing to another; the real index term is @@ -2859,9 +2507,8 @@ decided not to index. Example: </pre></div> </dd> -<dt><code>seealso</code></dt> -<dd><span id="index-seealso-for-index-entries"></span> -<p>Similar to <code>see</code> (the previous item), but also allows for normal +<dt id='index-seealso-for-index-entries'><span><code>seealso</code><a href='#index-seealso-for-index-entries' class='copiable-anchor'> ¶</a></span></dt> +<dd><p>Similar to <code>see</code> (the previous item), but also allows for normal index entries of the referencing term. The normal index entries have to be created separately—<code>seealso</code> does <em>not</em> contribute a page number to the index entry. For example, if you have indexed a @@ -2884,7 +2531,7 @@ took these dichotomous examples from is Laurence Berman’s <cite>The Musical Image</cite>, which I happened to co-design and typeset.) </p> </dd> -<dt><code>pagemarkup=<var>cs</var></code></dt> +<dt><span><code>pagemarkup=<var>cs</var></code></span></dt> <dd><p>This puts <code>\<var>cs</var></code> before the page number in the typeset index, thus allowing you to underline definitive entries, italicize examples, and the like. You do <em>not</em> precede the control sequence <var>cs</var> @@ -2907,7 +2554,9 @@ it is up to you to define the control sequences you want to use. Example: <hr> -<span id="Index-entries-with-special-characters"></span><div class="header"> +</div> +<div class="subsubsection" id="Index-entries-with-special-characters"> +<div class="header"> <p> Next: <a href="#Proofing-index-terms" accesskey="n" rel="next">Proofing index terms</a>, Previous: <a href="#Modifying-index-entries" accesskey="p" rel="prev">Modifying index entries</a>, Up: <a href="#Indexing-terms" accesskey="u" rel="up">Indexing terms</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Macro-index" title="Index" rel="index">Index</a>]</p> </div> @@ -2980,9 +2629,9 @@ processing the above input. now we’ll describe the exceptions. </p> <p>The following characters are reset to their usual meanings because -they are not useful verbatim: multiple consequent spaces are -converted into a single space; <acronym>ASCII</acronym> tab characters are -treated as spaces; <acronym>ASCII</acronym> return is treated as end-of-line +they are not useful verbatim: multiple consecutive spaces are +converted into a single space; ASCII tab characters are +treated as spaces; ASCII return is treated as end-of-line (this means, among other things, that long terms can be broken across several lines). </p> @@ -3031,7 +2680,9 @@ the subentry with the brackets in it: <hr> -<span id="Proofing-index-terms"></span><div class="header"> +</div> +<div class="subsubsection" id="Proofing-index-terms"> +<div class="header"> <p> Previous: <a href="#Index-entries-with-special-characters" accesskey="p" rel="prev">Index entries with special characters</a>, Up: <a href="#Indexing-terms" accesskey="u" rel="up">Indexing terms</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Macro-index" title="Index" rel="index">Index</a>]</p> </div> @@ -3088,7 +2739,10 @@ the appropriate time. </p> <hr> -<span id="Typesetting-an-index"></span><div class="header"> +</div> +</div> +<div class="subsection" id="Typesetting-an-index"> +<div class="header"> <p> Next: <a href="#Customizing-indexing" accesskey="n" rel="next">Customizing indexing</a>, Previous: <a href="#Indexing-terms" accesskey="p" rel="prev">Indexing terms</a>, Up: <a href="#Indexing" accesskey="u" rel="up">Indexing</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Macro-index" title="Index" rel="index">Index</a>]</p> </div> @@ -3125,8 +2779,8 @@ a group, naturally, since there is a primitive <code>\end</code>). <span id="index-index-fonts"></span> <span id="index-indexfonts"></span> <span id="index-double-columns-in-indexes"></span> -<p>Eplain calls <code>\indexfonts</code>, sets <code>\parindent = 0pt</code>, and does -<code>\doublecolumns</code> (see <a href="#Multiple-columns">Multiple columns</a>) at the +<p>Eplain calls <code>\indexfonts</code>, sets <code>\parindent = 0pt</code>, and +does <code>\doublecolumns</code> (see <a href="#Multiple-columns">Multiple columns</a>) at the <code>\begin{theindex}</code>. <code>\indexfonts</code> does nothing by default; it’s just there for you to override. (Indexes are usually typeset in smaller type than the main text.) @@ -3183,7 +2837,9 @@ entries in the <samp>.ind</samp> file. Eplain makes this equivalent to </p> <hr> -<span id="Customizing-indexing"></span><div class="header"> +</div> +<div class="subsection" id="Customizing-indexing"> +<div class="header"> <p> Previous: <a href="#Typesetting-an-index" accesskey="p" rel="prev">Typesetting an index</a>, Up: <a href="#Indexing" accesskey="u" rel="up">Indexing</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Macro-index" title="Index" rel="index">Index</a>]</p> </div> @@ -3210,24 +2866,20 @@ delim_2 "\\afterindexterm " <p>You can also change the keywords Eplain recognizes (see <a href="#Modifying-index-entries">Modifying index entries</a>): </p> <dl compact="compact"> -<dt><code>\idxrangebeginword</code></dt> -<dd><span id="index-idxrangebeginword"></span> -<p>‘begin’ +<dt id='index-idxrangebeginword'><span><code>\idxrangebeginword</code><a href='#index-idxrangebeginword' class='copiable-anchor'> ¶</a></span></dt> +<dd><p>‘begin’ </p> </dd> -<dt><code>\idxrangeendword</code></dt> -<dd><span id="index-idxrangeendword"></span> -<p>‘end’ +<dt id='index-idxrangeendword'><span><code>\idxrangeendword</code><a href='#index-idxrangeendword' class='copiable-anchor'> ¶</a></span></dt> +<dd><p>‘end’ </p> </dd> -<dt><code>\idxseecmdword</code></dt> -<dd><span id="index-idxseecmdword"></span> -<p>‘see’ +<dt id='index-idxseecmdword'><span><code>\idxseecmdword</code><a href='#index-idxseecmdword' class='copiable-anchor'> ¶</a></span></dt> +<dd><p>‘see’ </p> </dd> -<dt><code>\idxseealsocmdword</code></dt> -<dd><span id="index-idxseealsocmdword"></span> -<p>‘seealso’ +<dt id='index-idxseealsocmdword'><span><code>\idxseealsocmdword</code><a href='#index-idxseealsocmdword' class='copiable-anchor'> ¶</a></span></dt> +<dd><p>‘seealso’ </p> </dd> </dl> @@ -3236,24 +2888,20 @@ delim_2 "\\afterindexterm " <samp>.idx</samp> file, in case you’ve changed them in the <code>.ist</code> file: </p> <dl compact="compact"> -<dt><code>\idxsubentryseparator</code></dt> -<dd><span id="index-idxsubentryseparator"></span> -<p>‘<samp>!</samp>’ +<dt id='index-idxsubentryseparator'><span><code>\idxsubentryseparator</code><a href='#index-idxsubentryseparator' class='copiable-anchor'> ¶</a></span></dt> +<dd><p>‘<samp>!</samp>’ </p> </dd> -<dt><code>\idxencapoperator</code></dt> -<dd><span id="index-idxencapoperator"></span> -<p>‘<samp>|</samp>’ +<dt id='index-idxencapoperator'><span><code>\idxencapoperator</code><a href='#index-idxencapoperator' class='copiable-anchor'> ¶</a></span></dt> +<dd><p>‘<samp>|</samp>’ </p> </dd> -<dt><code>\idxbeginrangemark</code></dt> -<dd><span id="index-idxbeginrangemark"></span> -<p>‘<samp>(</samp>’ +<dt id='index-idxbeginrangemark'><span><code>\idxbeginrangemark</code><a href='#index-idxbeginrangemark' class='copiable-anchor'> ¶</a></span></dt> +<dd><p>‘<samp>(</samp>’ </p> </dd> -<dt><code>\idxendrangemark</code></dt> -<dd><span id="index-idxendrangemark"></span> -<p>‘<samp>)</samp>’ +<dt id='index-idxendrangemark'><span><code>\idxendrangemark</code><a href='#index-idxendrangemark' class='copiable-anchor'> ¶</a></span></dt> +<dd><p>‘<samp>)</samp>’ </p> </dd> </dl> @@ -3319,7 +2967,7 @@ file (assuming the name of the <samp>.idx</samp> file is <samp>myfile.idx</samp> and the <samp>trimsee</samp> script is placed in the current directory): </p> <div class="example"> -<pre class="example">prompt$ cat myfile.idx | makeindex | ./trimsee > myfile.ind +<pre class="example">$ cat myfile.idx | makeindex | ./trimsee >myfile.ind </pre></div> <p>By default, <samp>trimsee</samp> uses default page list separators and @@ -3330,28 +2978,28 @@ and <code>\indexseealso</code> commands, it is possible to adjust the following: </p> <dl compact="compact"> -<dt><samp>-i <var>is</var></samp></dt> +<dt><span><samp>-i <var>is</var></samp></span></dt> <dd><p>Use <var>is</var> as a regular expression matching separator before “see …” commands in the input (default: ‘<samp>, \+</samp>’). </p> </dd> -<dt><samp>-o <var>os</var></samp></dt> +<dt><span><samp>-o <var>os</var></samp></span></dt> <dd><p>Use <var>os</var> as a separator to replace <var>is</var> before “see …” commands (default: ‘<samp> </samp>’). </p> </dd> -<dt><samp>-s <var>see</var></samp></dt> +<dt><span><samp>-s <var>see</var></samp></span></dt> <dd><p>Use <var>see</var> as a regular expression matching “see …” commands (default: ‘<samp>\\indexsee</samp>’). </p> </dd> -<dt><samp>-h</samp></dt> -<dt><samp>--help</samp></dt> +<dt><span><samp>-h</samp></span></dt> +<dt><span><samp>--help</samp></span></dt> <dd><p>Print a usage message. </p> </dd> -<dt><samp>-v</samp></dt> -<dt><samp>--version</samp></dt> +<dt><span><samp>-v</samp></span></dt> +<dt><span><samp>--version</samp></span></dt> <dd><p>Print version. </p></dd> </dl> @@ -3361,7 +3009,10 @@ output to the standard output. </p> <hr> -<span id="Justification"></span><div class="header"> +</div> +</div> +<div class="section" id="Justification"> +<div class="header"> <p> Next: <a href="#Tables" accesskey="n" rel="next">Tables</a>, Previous: <a href="#Indexing" accesskey="p" rel="prev">Indexing</a>, Up: <a href="#User-definitions" accesskey="u" rel="up">User definitions</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Macro-index" title="Index" rel="index">Index</a>]</p> </div> @@ -3463,7 +3114,9 @@ be necessary. <hr> -<span id="Tables"></span><div class="header"> +</div> +<div class="section" id="Tables"> +<div class="header"> <p> Next: <a href="#Margins" accesskey="n" rel="next">Margins</a>, Previous: <a href="#Justification" accesskey="p" rel="prev">Justification</a>, Up: <a href="#User-definitions" accesskey="u" rel="up">User definitions</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Macro-index" title="Index" rel="index">Index</a>]</p> </div> @@ -3533,7 +3186,9 @@ Text after the table. </p> <hr> -<span id="Margins"></span><div class="header"> +</div> +<div class="section" id="Margins"> +<div class="header"> <p> Next: <a href="#Multiple-columns" accesskey="n" rel="next">Multiple columns</a>, Previous: <a href="#Tables" accesskey="p" rel="prev">Tables</a>, Up: <a href="#User-definitions" accesskey="u" rel="up">User definitions</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Macro-index" title="Index" rel="index">Index</a>]</p> </div> @@ -3548,12 +3203,11 @@ TeX conceive of the page laid out in this way. Therefore, Eplain provides commands to directly assign and increment the margins. </p> <dl compact="compact"> -<dt><code>\topmargin = <var>dimen</var></code></dt> -<dt><code>\bottommargin = <var>dimen</var></code></dt> -<dt><code>\leftmargin = <var>dimen</var></code></dt> -<dt><code>\rightmargin = <var>dimen</var></code></dt> -<dd><span id="index-topmargin"></span> -<span id="index-bottommargin"></span> +<dt id='index-topmargin'><span><code>\topmargin = <var>dimen</var></code><a href='#index-topmargin' class='copiable-anchor'> ¶</a></span></dt> +<dt><span><code>\bottommargin = <var>dimen</var></code></span></dt> +<dt><span><code>\leftmargin = <var>dimen</var></code></span></dt> +<dt><span><code>\rightmargin = <var>dimen</var></code></span></dt> +<dd><span id="index-bottommargin"></span> <span id="index-leftmargin"></span> <span id="index-rightmargin"></span> <p>These commands set the specified margin to the <var>dimen</var> given. @@ -3563,12 +3217,11 @@ therefore, commands like <code>\showthe\topmargin</code> will not do what you expect. </p> </dd> -<dt><code>\advancetopmargin by <var>dimen</var></code></dt> -<dt><code>\advancebottommargin by <var>dimen</var></code></dt> -<dt><code>\advanceleftmargin by <var>dimen</var></code></dt> -<dt><code>\advancerightmargin by <var>dimen</var></code></dt> -<dd><span id="index-advancetopmargin"></span> -<span id="index-advancebottommargin"></span> +<dt id='index-advancetopmargin'><span><code>\advancetopmargin by <var>dimen</var></code><a href='#index-advancetopmargin' class='copiable-anchor'> ¶</a></span></dt> +<dt><span><code>\advancebottommargin by <var>dimen</var></code></span></dt> +<dt><span><code>\advanceleftmargin by <var>dimen</var></code></span></dt> +<dt><span><code>\advancerightmargin by <var>dimen</var></code></span></dt> +<dd><span id="index-advancebottommargin"></span> <span id="index-advanceleftmargin"></span> <span id="index-advancerightmargin"></span> <p>These commands change the specified margin by the <var>dimen</var> given. @@ -3591,14 +3244,12 @@ help: you must tell it the full width and height of the final output page. It defines two new parameters for this: </p> <dl compact="compact"> -<dt><code>\paperheight</code></dt> -<dd><span id="index-paperheight"></span> -<p>The height of the output page; default is 11truein. +<dt id='index-paperheight'><span><code>\paperheight</code><a href='#index-paperheight' class='copiable-anchor'> ¶</a></span></dt> +<dd><p>The height of the output page; default is 11truein. </p> </dd> -<dt><code>\paperwidth</code></dt> -<dd><span id="index-paperwidth"></span> -<p>The width of the output page; default is 8.5truein. +<dt id='index-paperwidth'><span><code>\paperwidth</code><a href='#index-paperwidth' class='copiable-anchor'> ¶</a></span></dt> +<dd><p>The width of the output page; default is 8.5truein. </p></dd> </dl> @@ -3612,7 +3263,9 @@ reassign to these parameters, as in <hr> -<span id="Multiple-columns"></span><div class="header"> +</div> +<div class="section" id="Multiple-columns"> +<div class="header"> <p> Next: <a href="#Footnotes" accesskey="n" rel="next">Footnotes</a>, Previous: <a href="#Margins" accesskey="p" rel="prev">Margins</a>, Up: <a href="#User-definitions" accesskey="u" rel="up">User definitions</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Macro-index" title="Index" rel="index">Index</a>]</p> </div> @@ -3651,7 +3304,7 @@ merely inserts an unbreakable space of (essentially) size multicolumns, Eplain multiplies <code>\vsize</code> itself by the number of columns). In most circumstances, a column break will be forced after this space (during the column splitting operation when the whole page -is output). Bugs are easily possible, unfortunately. +is output). </p> <span id="index-gutter"></span> <p>The columns are separated by the value of the dimen parameter @@ -3666,6 +3319,14 @@ define <pre class="example">\def\gutterbox{\vbox to \dimen0{\vfil\hbox{\vrule height\dimen0}\vfil}}% </pre></div> +<p>There are known bugs in the multiple-column code such that +<code>\topmark</code> and possibly other marks can have an incorrect value +on the last page of multiple-column material when using +<code>\singlecolumn</code> to balance the columns. Unfortunately this is +quite difficult to fix, and at present (volunteers welcome), it’s +going to remain. A suboptimal workaround is to insert +<code>\columnfill</code> at the appropriate place. +</p> <p>The dimension counter <code>\dimen0</code> contains the height of the column. @@ -3690,7 +3351,9 @@ provision for column-width insertions. </p> <hr> -<span id="Footnotes"></span><div class="header"> +</div> +<div class="section" id="Footnotes"> +<div class="header"> <p> Next: <a href="#Fractions" accesskey="n" rel="next">Fractions</a>, Previous: <a href="#Multiple-columns" accesskey="p" rel="prev">Multiple columns</a>, Up: <a href="#User-definitions" accesskey="u" rel="up">User definitions</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Macro-index" title="Index" rel="index">Index</a>]</p> </div> @@ -3763,12 +3426,14 @@ rule is 0.4 points high, 2 true inches wide, with 2.6 points below it. by the glue register <code>\skip\footins</code>. The default is a plain TeX <code>\bigskip</code>. </p> -<p>Eplain can create hypertext links for the footnote marks (see <a href="#Footnote-hyperlinks">Footnote hyperlinks</a>). +<p>Eplain can create hypertext links for the footnote marks (see <a href="#Footnote-hyperlinks">Footnote hyperlinks: foot, footback</a>). </p> <hr> -<span id="Fractions"></span><div class="header"> +</div> +<div class="section" id="Fractions"> +<div class="header"> <p> Next: <a href="#Paths" accesskey="n" rel="next">Paths</a>, Previous: <a href="#Footnotes" accesskey="p" rel="prev">Footnotes</a>, Up: <a href="#User-definitions" accesskey="u" rel="up">User definitions</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Macro-index" title="Index" rel="index">Index</a>]</p> </div> @@ -3793,7 +3458,9 @@ delimited macro arguments.) </p> <hr> -<span id="Paths"></span><div class="header"> +</div> +<div class="section" id="Paths"> +<div class="header"> <p> Next: <a href="#Logos" accesskey="n" rel="next">Logos</a>, Previous: <a href="#Fractions" accesskey="p" rel="prev">Fractions</a>, Up: <a href="#User-definitions" accesskey="u" rel="up">User definitions</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Macro-index" title="Index" rel="index">Index</a>]</p> </div> @@ -3840,14 +3507,16 @@ character for <code>\path</code>, you can set still be used.) TeX then processes the <code>\path</code> argument about four times more slowly. </p> -<span id="index-URL-for-path_002esty"></span> +<span id="index-url-for-path_002esty"></span> <p>The <code>\path</code> macro comes from <samp>path.sty</samp>, written by Nelson Beebe and Philip Taylor, and available at <a href="https://ctan.org/pkg/path">https://ctan.org/pkg/path</a>. </p> <hr> -<span id="Logos"></span><div class="header"> +</div> +<div class="section" id="Logos"> +<div class="header"> <p> Next: <a href="#Boxes" accesskey="n" rel="next">Boxes</a>, Previous: <a href="#Paths" accesskey="p" rel="prev">Paths</a>, Up: <a href="#User-definitions" accesskey="u" rel="up">User definitions</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Macro-index" title="Index" rel="index">Index</a>]</p> </div> @@ -3902,12 +3571,14 @@ here.) Some spelling variants of these are also supported. <span id="index-texnames_002esty"></span> <p>Most of these macros come from <samp>texnames.sty</samp>, compiled by Nelson Beebe and available at -<a href="http://mirror.ctan.org/info/biblio/texnames.sty">http://mirror.ctan.org/info/biblio/texnames.sty</a> +<a href="https://mirror.ctan.org/info/biblio/texnames.sty">https://mirror.ctan.org/info/biblio/texnames.sty</a> (part of the <code>biblio</code> package, <a href="https://ctan.org/pkg/biblio">https://ctan.org/pkg/biblio</a>). </p> <hr> -<span id="Boxes"></span><div class="header"> +</div> +<div class="section" id="Boxes"> +<div class="header"> <p> Next: <a href="#Checking-for-PDF-output" accesskey="n" rel="next">Checking for PDF output</a>, Previous: <a href="#Logos" accesskey="p" rel="prev">Logos</a>, Up: <a href="#User-definitions" accesskey="u" rel="up">User definitions</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Macro-index" title="Index" rel="index">Index</a>]</p> </div> @@ -3966,49 +3637,46 @@ easily adjust the thicknesses of the box rules. See <a href="#Rules">Rules</a>. </p> <hr> -<span id="Checking-for-PDF-output"></span><div class="header"> +</div> +<div class="section" id="Checking-for-PDF-output"> +<div class="header"> <p> Next: <a href="#Loading-LaTeX-packages" accesskey="n" rel="next">Loading LaTeX packages</a>, Previous: <a href="#Boxes" accesskey="p" rel="prev">Boxes</a>, Up: <a href="#User-definitions" accesskey="u" rel="up">User definitions</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Macro-index" title="Index" rel="index">Index</a>]</p> </div> <span id="Checking-for-PDF-output-1"></span><h3 class="section">4.22 Checking for PDF output</h3> -<span id="index-URL-for-pdfTeX"></span> <span id="index-PDF-output"></span> -<span id="index-pdftex-1"></span> <span id="index-_002epdf-files"></span> -<p>pdfTeX is an extended TeX that can output both <samp>.dvi</samp> and -<samp>.pdf</samp> (Adobe’s Portable Document Format) files (see -<a href="https://ctan.org/pkg/pdftex">https://ctan.org/pkg/pdftex</a>). You might sometimes want to know -whether the target format is <samp>.pdf</samp> or <samp>.dvi</samp>. The -<code>\ifpdf</code> <span id="index-ifpdf"></span> -switch can be used to detect pdfTeX in PDF mode: +<p>You might sometimes want to test whether the target format is +<samp>.pdf</samp> or <samp>.dvi</samp>. The <code>\ifpdf</code> conditional can be used +for this: </p> <div class="example"> <pre class="example">\ifpdf - This text is produced when pdfTeX is in PDF mode. + This text is produced when the engine outputs PDF. \else - This text is produced when pdfTeX is in DVI mode, - or when some program other than pdfTeX is used. + This text is produced when the engine outputs DVI (or similar). \fi </pre></div> -<p>Keep in mind that <code>\ifpdf</code> is set based on the value of the -<code>\pdfoutput</code> -<span id="index-pdfoutput"></span> -primitive of pdfTeX at the time Eplain is loaded. If you change -the value of <code>\pdfoutput</code> after you load Eplain, <code>\ifpdf</code> -will not reflect the change. +<p>At this writing, <code>\ifpdf</code> will be true when running pdfTeX +or LuaTeX with PDF output. It will be false when running XeTeX, +or (of course) original TeX, etc. </p> -<span id="index-ifpdf_002esty"></span> -<span id="index-Oberdiek_002c-Heiko"></span> -<p>Eplain defines <code>\ifpdf</code> by incorporating Heiko Oberdiek’s -<samp>ifpdf.sty</samp>, which is available at -<a href="https://ctan.org/pkg/ifpdf">https://ctan.org/pkg/ifpdf</a>. +<span id="index-iftex_002esty"></span> +<span id="index-engines_002c-testing-for"></span> +<p>Eplain defines <code>\ifpdf</code> by incorporating <samp>iftex.sty</samp>, a +package now maintained by the LaTeX Project Team. +<samp>iftex.sty</samp>, and therefore Eplain, defines numerous related +conditionals to test for different engines; see its package +documentation for details: <a href="https://ctan.org/pkg/ifpdf">https://ctan.org/pkg/ifpdf</a>. </p> <hr> -<span id="Loading-LaTeX-packages"></span><div class="header"> +</div> +<div class="section" id="Loading-LaTeX-packages"> +<div class="header"> <p> Previous: <a href="#Checking-for-PDF-output" accesskey="p" rel="prev">Checking for PDF output</a>, Up: <a href="#User-definitions" accesskey="u" rel="up">User definitions</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Macro-index" title="Index" rel="index">Index</a>]</p> </div> @@ -4036,21 +3704,19 @@ the list, please report it to the Eplain mailing list <samp>miniltx.tex</samp> (<a href="https://ctan.org/pkg/miniltx">https://ctan.org/pkg/miniltx</a>) from the LaTeX graphics collection, written by David Carlisle and Sebastian Rahtz. Eplain extends <samp>miniltx.tex</samp> to provide (primarily) -support for package options. -</p> -<table class="menu" border="0" cellspacing="0"> -<tr><td align="left" valign="top">• <a href="#The-_005cusepackage-command" accesskey="1">The \usepackage command</a></td><td> </td><td align="left" valign="top">Command to load packages. -</td></tr> -<tr><td align="left" valign="top">• <a href="#Environment-for-loading-packages" accesskey="2">Environment for loading packages</a></td><td> </td><td align="left" valign="top">Environment for the \usepackage commands. -</td></tr> -<tr><td align="left" valign="top">• <a href="#Packages-known-to-work" accesskey="3">Packages known to work</a></td><td> </td><td align="left" valign="top">Packages supported with Eplain. -</td></tr> -<tr><td align="left" valign="top">• <a href="#Packages-known-not-to-work" accesskey="4">Packages known not to work</a></td><td> </td><td align="left" valign="top">Packages known not to work with Eplain. -</td></tr> -</table> +support for package options; in many cases, you can use +<samp>miniltx.tex</samp> directly without loading Eplain at all. +</p> +<ul class="section-toc"> +<li><a href="#The-_005cusepackage-command" accesskey="1">The <code>\usepackage</code> command</a></li> +<li><a href="#Environment-for-loading-packages" accesskey="2">Environment for loading packages</a></li> +<li><a href="#Packages-known-to-work" accesskey="3">Packages known to work</a></li> +<li><a href="#Packages-known-not-to-work" accesskey="4">Packages known not to work</a></li> +</ul> <hr> -<span id="The-_005cusepackage-command"></span><div class="header"> +<div class="subsection" id="The-_005cusepackage-command"> +<div class="header"> <p> Next: <a href="#Environment-for-loading-packages" accesskey="n" rel="next">Environment for loading packages</a>, Up: <a href="#Loading-LaTeX-packages" accesskey="u" rel="up">Loading LaTeX packages</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Macro-index" title="Index" rel="index">Index</a>]</p> </div> @@ -4086,9 +3752,11 @@ packages are dated 2005/08/29 or newer. </p> <hr> -<span id="Environment-for-loading-packages"></span><div class="header"> +</div> +<div class="subsection" id="Environment-for-loading-packages"> +<div class="header"> <p> -Next: <a href="#Packages-known-to-work" accesskey="n" rel="next">Packages known to work</a>, Previous: <a href="#The-_005cusepackage-command" accesskey="p" rel="prev">The \usepackage command</a>, Up: <a href="#Loading-LaTeX-packages" accesskey="u" rel="up">Loading LaTeX packages</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Macro-index" title="Index" rel="index">Index</a>]</p> +Next: <a href="#Packages-known-to-work" accesskey="n" rel="next">Packages known to work</a>, Previous: <a href="#The-_005cusepackage-command" accesskey="p" rel="prev">The <code>\usepackage</code> command</a>, Up: <a href="#Loading-LaTeX-packages" accesskey="u" rel="up">Loading LaTeX packages</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Macro-index" title="Index" rel="index">Index</a>]</p> </div> <span id="Environment-for-loading-packages-1"></span><h4 class="subsection">4.23.2 Environment for loading packages</h4> @@ -4159,7 +3827,9 @@ to <code>\eplaininput</code> before loading each package. For example: <hr> -<span id="Packages-known-to-work"></span><div class="header"> +</div> +<div class="subsection" id="Packages-known-to-work"> +<div class="header"> <p> Next: <a href="#Packages-known-not-to-work" accesskey="n" rel="next">Packages known not to work</a>, Previous: <a href="#Environment-for-loading-packages" accesskey="p" rel="prev">Environment for loading packages</a>, Up: <a href="#Loading-LaTeX-packages" accesskey="u" rel="up">Loading LaTeX packages</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Macro-index" title="Index" rel="index">Index</a>]</p> </div> @@ -4173,9 +3843,8 @@ these packages. Some of the short descriptions of the packages were taken from the documentation for those packages. </p> <dl compact="compact"> -<dt>autopict (‘<samp>2001/06/04 v1.1j Picture mode autoload file</samp>’)</dt> -<dd><span id="index-autopict_002esty"></span> -<p><a href="https://tug.org/eplain/misc/ltpictur.pdf">https://tug.org/eplain/misc/ltpictur.pdf</a> +<dt id='index-autopict_002esty'><span>autopict (‘<samp>2001/06/04 v1.1j Picture mode autoload file</samp>’)<a href='#index-autopict_002esty' class='copiable-anchor'> ¶</a></span></dt> +<dd><p><a href="https://tug.org/eplain/misc/ltpictur.pdf">https://tug.org/eplain/misc/ltpictur.pdf</a> </p> <span id="index-picture-mode"></span> <span id="index-begin_007bpicture_007d"></span> @@ -4187,15 +3856,14 @@ the LaTeX kernel). It provides commands to draw simple figures inside your document without resorting to any external tools. </p> </dd> -<dt>color (‘<samp>1999/02/16 v1.0i Standard LaTeX Color (DPC)</samp>’)</dt> +<dt id='index-graphicx_002esty'><span>color (‘<samp>1999/02/16 v1.0i Standard LaTeX Color (DPC)</samp>’)<a href='#index-graphicx_002esty' class='copiable-anchor'> ¶</a></span></dt> <dd><span id="index-color_002esty"></span> </dd> -<dt>graphics (‘<samp>2001/07/07 v1.0n Standard LaTeX Graphics (DPC,SPQR)</samp>’)</dt> +<dt><span>graphics (‘<samp>2001/07/07 v1.0n Standard LaTeX Graphics (DPC,SPQR)</samp>’)</span></dt> <dd><span id="index-graphics_002esty"></span> </dd> -<dt>graphicx (‘<samp>1999/02/16 v1.0f Enhanced LaTeX Graphics (DPC,SPQR)</samp>’)</dt> -<dd><span id="index-graphicx_002esty"></span> -<p><a href="https://ctan.org/pkg/graphics">https://ctan.org/pkg/graphics</a> +<dt><span>graphicx (‘<samp>1999/02/16 v1.0f Enhanced LaTeX Graphics (DPC,SPQR)</samp>’)</span></dt> +<dd><p><a href="https://ctan.org/pkg/graphics">https://ctan.org/pkg/graphics</a> </p> <span id="index-graphics-collection_002c-LaTeX-1"></span> <span id="index-LaTeX-graphics-collection-1"></span> @@ -4222,7 +3890,7 @@ TeX) installed on your system. The problem was fixed in <samp>supp-mis.tex</samp> version 2004.10.26. You can obtain up-to-date versions of <samp>supp-mis.tex</samp> and the accompanying <samp>supp-pdf.tex</samp> from -<a href="http://mirror.ctan.org/macros/pdftex/graphics">http://mirror.ctan.org/macros/pdftex/graphics</a>. +<a href="https://mirror.ctan.org/macros/pdftex/graphics">https://mirror.ctan.org/macros/pdftex/graphics</a>. To convince TeX to use the new files, you have the following options: </p> @@ -4233,8 +3901,7 @@ options: </li><li> install the new <samp>supp-mis.tex</samp> and <samp>supp-pdf.tex</samp> files in the relevant subdirectory of your local <samp>texmf</samp> tree (for info on -TeX directory structure see <a href="https://tug.org/tds/">https://tug.org/tds/</a> and -<a href="http://www.tex.ac.uk/cgi-bin/texfaq2html?label=tds">http://www.tex.ac.uk/cgi-bin/texfaq2html?label=tds</a>); +TeX directory structure, see <a href="https://tug.org/tds/">https://tug.org/tds/</a>); </li><li> upgrade your ConTeXt installation. </li></ol> @@ -4252,7 +3919,7 @@ the system <samp>texmf</samp> tree.<br> <strong>End of warning 1.</strong> pdfTeX, the cause may be an outdated pdfTeX color and graphics driver <samp>pdftex.def</samp>. The problem was fixed in <samp>pdftex.def</samp> version 0.03p. You can obtain an up-to-date version from -<a href="http://ctan.org/pkg/pdftex-def">http://ctan.org/pkg/pdftex-def</a>.<br> +<a href="https://ctan.org/pkg/graphics-def">https://ctan.org/pkg/graphics-def</a>.<br> <strong>End of warning 2.</strong> </p> <p>The <code>\fcolorbox</code> macro provided by the <code>color</code> package @@ -4288,7 +3955,7 @@ equivalent to plain TeX’s <span id="index-tt"></span> <code>\tt</code>. </p> -<p>See <a href="#Hyperlinks-_0028xhyper_002etex_0029">Hyperlinks (xhyper.tex)</a>, for the demonstration of text rotation and +<p>See <a href="#Hyperlinks-_0028xhyper_002etex_0029">Hyperlinks (<code>xhyper.tex</code>)</a>, for the demonstration of text rotation and graphics inclusion using the <samp>graphicx</samp> package, and using the <samp>color</samp> package to colorize hypertext links. </p> @@ -4300,9 +3967,8 @@ packages and different graphics formats. You can download it from </pre></div> </dd> -<dt>epstopdf (‘<samp>2009/07/16 v2.2 Conversion with epstopdf on the fly (HO)</samp>’)</dt> -<dd><span id="index-epstopdf_002esty"></span> -<p><a href="https://ctan.org/pkg/epstopdf-pkg">https://ctan.org/pkg/epstopdf-pkg</a> +<dt id='index-epstopdf_002esty'><span>epstopdf (‘<samp>2009/07/16 v2.2 Conversion with epstopdf on the fly (HO)</samp>’)<a href='#index-epstopdf_002esty' class='copiable-anchor'> ¶</a></span></dt> +<dd><p><a href="https://ctan.org/pkg/epstopdf-pkg">https://ctan.org/pkg/epstopdf-pkg</a> </p> <span id="index-Encapsulated-PostScript"></span> <span id="index-EPS"></span> @@ -4312,21 +3978,20 @@ packages and different graphics formats. You can download it from <span id="index-_002epdf-files-1"></span> <span id="index-epstopdf"></span> <p>This package does on-the-fly conversion of Encapsulated PostScript -(<acronym>EPS</acronym>) graphics into Portable Document Format (<acronym>PDF</acronym>) +(EPS) graphics into Portable Document Format (PDF) graphics for inclusion with the <code>\includegraphics</code> command from the <samp>graphics</samp>/<samp>graphicx</samp> packages, so that you do not have to explicitly call the <samp>epstopdf</samp> script. </p> </dd> -<dt>psfrag (‘<samp>1998/04/11 v3.04 PSfrag (MCG)</samp>’)</dt> -<dd><span id="index-psfrag_002esty"></span> -<p><a href="https://ctan.org/pkg/psfrag">https://ctan.org/pkg/psfrag</a> +<dt id='index-psfrag_002esty'><span>psfrag (‘<samp>1998/04/11 v3.04 PSfrag (MCG)</samp>’)<a href='#index-psfrag_002esty' class='copiable-anchor'> ¶</a></span></dt> +<dd><p><a href="https://ctan.org/pkg/psfrag">https://ctan.org/pkg/psfrag</a> </p> <span id="index-Encapsulated-PostScript-1"></span> <span id="index-EPS-1"></span> <span id="index-_002eeps-files-1"></span> <p>PSfrag allows the user to precisely overlay Encapsulated PostScript -(<acronym>EPS</acronym>) files with arbitrary (La)TeX constructions. In order to +(EPS) files with arbitrary (La)TeX constructions. In order to accomplish this, the user places a simple text “tag” in the graphics file, as a “position marker” of sorts. Then, using simple (La)TeX commands, the user instructs PSfrag to remove that tag from @@ -4334,9 +3999,8 @@ the figure, and replace it with a properly sized, aligned, and rotated (La)TeX equation. </p> </dd> -<dt>soul (‘<samp>2003/11/17 v2.4 letterspacing/underlining (mf)</samp>’)</dt> -<dd><span id="index-soul_002esty"></span> -<p><a href="https://ctan.org/pkg/soul">https://ctan.org/pkg/soul</a> +<dt id='index-soul_002esty'><span>soul (‘<samp>2003/11/17 v2.4 letterspacing/underlining (mf)</samp>’)<a href='#index-soul_002esty' class='copiable-anchor'> ¶</a></span></dt> +<dd><p><a href="https://ctan.org/pkg/soul">https://ctan.org/pkg/soul</a> </p> <span id="index-letterspacing"></span> <span id="index-spacing-out"></span> @@ -4352,9 +4016,8 @@ soul.sty</code>. If you intend to use the highlighting macros of <samp>soul</samp>, don’t forget to load the <samp>color</samp> package. </p> </dd> -<dt>url (‘<samp>2005/06/27 ver 3.2 Verb mode for urls, etc.</samp>’)</dt> -<dd><span id="index-url_002esty"></span> -<p><a href="https://ctan.org/pkg/url">https://ctan.org/pkg/url</a> +<dt id='index-url_002esty'><span>url (‘<samp>2005/06/27 ver 3.2 Verb mode for urls, etc.</samp>’)<a href='#index-url_002esty' class='copiable-anchor'> ¶</a></span></dt> +<dd><p><a href="https://ctan.org/pkg/url">https://ctan.org/pkg/url</a> </p> <span id="index-pathnames_002c-breaking-1"></span> <span id="index-filenames_002c-breaking-1"></span> @@ -4366,7 +4029,7 @@ another command. It is intended for email addresses, hypertext links, directories/paths, etc., which normally have no spaces. </p> <p>Eplain can create hypertext links with the <code>\url</code> command -(see <a href="#URL-hyperlinks">URL hyperlinks</a>). +(see <a href="#URL-hyperlinks">URL hyperlinks: url</a>). </p> <p>Be sure to get a version dated at least 2005/06/27, as older versions have problems in plain TeX. @@ -4375,7 +4038,9 @@ have problems in plain TeX. <hr> -<span id="Packages-known-not-to-work"></span><div class="header"> +</div> +<div class="subsection" id="Packages-known-not-to-work"> +<div class="header"> <p> Previous: <a href="#Packages-known-to-work" accesskey="p" rel="prev">Packages known to work</a>, Up: <a href="#Loading-LaTeX-packages" accesskey="u" rel="up">Loading LaTeX packages</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Macro-index" title="Index" rel="index">Index</a>]</p> </div> @@ -4386,35 +4051,35 @@ Previous: <a href="#Packages-known-to-work" accesskey="p" rel="prev">Packages kn <p>The following packages are known not to work with Eplain: </p> <dl compact="compact"> -<dt>hyperref</dt> -<dd><span id="index-hyperref_002esty"></span> -<p><a href="https://ctan.org/pkg/hyperref">https://ctan.org/pkg/hyperref</a> +<dt id='index-hyperref_002esty'><span>hyperref<a href='#index-hyperref_002esty' class='copiable-anchor'> ¶</a></span></dt> +<dd><p><a href="https://ctan.org/pkg/hyperref">https://ctan.org/pkg/hyperref</a> </p> <p>This package depends heavily on LaTeX, so that it is essentially unusable outside of LaTeX. Eplain provides its own macros for creating hyperlinks; see <a href="#Hyperlinks">Hyperlinks</a>. </p> </dd> -<dt>microtype (‘<samp>2013/05/23 v2.51 Micro-typographical refinements (RS)</samp>’)</dt> -<dd><span id="index-microtype_002esty"></span> -<p><a href="https://ctan.org/pkg/microtype">https://ctan.org/pkg/microtype</a> +<dt id='index-microtype_002esty'><span>microtype (‘<samp>2013/05/23 v2.51 Micro-typographical refinements (RS)</samp>’)<a href='#index-microtype_002esty' class='copiable-anchor'> ¶</a></span></dt> +<dd><p><a href="https://ctan.org/pkg/microtype">https://ctan.org/pkg/microtype</a> </p> </dd> -<dt>pict2e (‘<samp>2005/07/15 v0.2r Improved picture commands (HjG,RN)</samp>’)</dt> -<dd><span id="index-pict2e_002esty"></span> -<p><a href="https://ctan.org/pkg/pict2e">https://ctan.org/pkg/pict2e</a> +<dt id='index-pict2e_002esty'><span>pict2e (‘<samp>2005/07/15 v0.2r Improved picture commands (HjG,RN)</samp>’)<a href='#index-pict2e_002esty' class='copiable-anchor'> ¶</a></span></dt> +<dd><p><a href="https://ctan.org/pkg/pict2e">https://ctan.org/pkg/pict2e</a> </p> </dd> -<dt>xcolor (‘<samp>2005/06/06 v2.03 LaTeX color extensions (UK)</samp>’)</dt> -<dd><span id="index-xcolor_002esty"></span> -<p><a href="https://ctan.org/pkg/xcolor">https://ctan.org/pkg/xcolor</a> +<dt id='index-xcolor_002esty'><span>xcolor (‘<samp>2005/06/06 v2.03 LaTeX color extensions (UK)</samp>’)<a href='#index-xcolor_002esty' class='copiable-anchor'> ¶</a></span></dt> +<dd><p><a href="https://ctan.org/pkg/xcolor">https://ctan.org/pkg/xcolor</a> </p></dd> </dl> <hr> -<span id="Hyperlinks"></span><div class="header"> +</div> +</div> +</div> +<div class="chapter" id="Hyperlinks"> +<div class="header"> <p> -Next: <a href="#Arrow-theoretic-diagrams" accesskey="n" rel="next">Arrow theoretic diagrams</a>, Previous: <a href="#User-definitions" accesskey="p" rel="prev">User definitions</a>, Up: <a href="#Top" accesskey="u" rel="up">Top</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Macro-index" title="Index" rel="index">Index</a>]</p> +Next: <a href="#Arrow-theoretic-diagrams" accesskey="n" rel="next">Arrow theoretic diagrams</a>, Previous: <a href="#User-definitions" accesskey="p" rel="prev">User definitions</a>, Up: <a href="#Top" accesskey="u" rel="up">Eplain</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Macro-index" title="Index" rel="index">Index</a>]</p> </div> <span id="Hyperlinks-1"></span><h2 class="chapter">5 Hyperlinks</h2> @@ -4426,26 +4091,20 @@ implicitly by the cross-reference, indexing and other macros in Eplain. Macros for constructing explicit hyperlinks are also provided. </p> -<table class="menu" border="0" cellspacing="0"> -<tr><td align="left" valign="top">• <a href="#Introduction-to-hyperlinks" accesskey="1">Introduction to hyperlinks</a></td><td> </td><td align="left" valign="top"> -</td></tr> -<tr><td align="left" valign="top">• <a href="#Explicit-hyperlinks" accesskey="2">Explicit hyperlinks</a></td><td> </td><td align="left" valign="top"> -</td></tr> -<tr><td align="left" valign="top">• <a href="#Implicit-hyperlinks" accesskey="3">Implicit hyperlinks</a></td><td> </td><td align="left" valign="top"> -</td></tr> -<tr><td align="left" valign="top">• <a href="#Hyperlink-drivers" accesskey="4">Hyperlink drivers</a></td><td> </td><td align="left" valign="top"> -</td></tr> -<tr><td align="left" valign="top">• <a href="#Setting-hyperlink-types-and-options" accesskey="5">Setting hyperlink types and options</a></td><td> </td><td align="left" valign="top"> -</td></tr> -<tr><td align="left" valign="top">• <a href="#Turning-hyperlinks-on_002foff" accesskey="6">Turning hyperlinks on/off</a></td><td> </td><td align="left" valign="top"> -</td></tr> -<tr><td align="left" valign="top">• <a href="#Making-PDF-outlines" accesskey="7">Making PDF outlines</a></td><td> </td><td align="left" valign="top">Also known as bookmarks. -</td></tr> -</table> +<ul class="section-toc"> +<li><a href="#Introduction-to-hyperlinks" accesskey="1">Introduction to hyperlinks</a></li> +<li><a href="#Explicit-hyperlinks" accesskey="2">Explicit hyperlinks</a></li> +<li><a href="#Implicit-hyperlinks" accesskey="3">Implicit hyperlinks</a></li> +<li><a href="#Hyperlink-drivers" accesskey="4">Hyperlink drivers</a></li> +<li><a href="#Setting-hyperlink-types-and-options" accesskey="5">Setting hyperlink types and options</a></li> +<li><a href="#Turning-hyperlinks-on_002foff" accesskey="6">Turning hyperlinks on/off</a></li> +<li><a href="#Making-PDF-outlines" accesskey="7">Making PDF outlines</a></li> +</ul> <hr> -<span id="Introduction-to-hyperlinks"></span><div class="header"> +<div class="section" id="Introduction-to-hyperlinks"> +<div class="header"> <p> Next: <a href="#Explicit-hyperlinks" accesskey="n" rel="next">Explicit hyperlinks</a>, Up: <a href="#Hyperlinks" accesskey="u" rel="up">Hyperlinks</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Macro-index" title="Index" rel="index">Index</a>]</p> </div> @@ -4486,10 +4145,10 @@ the set of commands it understands. <p>The knowledge about the commands that the various processors understand is programmed into Eplain’s hyperlink drivers. Eplain provides three drivers: <code>hypertex</code> (implementation of the -HyperTeX standard, see <a href="http://arxiv.org/hypertex">http://arxiv.org/hypertex</a>), and +HyperTeX standard, see <a href="https://arxiv.org/hypertex">https://arxiv.org/hypertex</a>), and <code>pdftex</code> and <code>dvipdfm</code> (named after the programs which process the hyperlink commands, -<span id="index-pdftex-2"></span> +<span id="index-pdftex-1"></span> pdfTeX and <span id="index-dvipdfm"></span> dvipdfm). Therefore, Eplain can only produce HyperTeX commands and @@ -4509,9 +4168,9 @@ are using, use the command </pre></div> <p>instructs Eplain to attempt to automatically detect which -driver to use, as follows: if it detects pdfTeX in <acronym>PDF</acronym> +driver to use, as follows: if it detects pdfTeX in PDF mode, it loads the <code>pdftex</code> driver. If it does not detect -pdfTeX in <acronym>PDF</acronym> mode, the <code>hypertex</code> driver is loaded. +pdfTeX in PDF mode, the <code>hypertex</code> driver is loaded. The detection is based on the <span id="index-ifpdf-1"></span> <code>\ifpdf</code> switch (see <a href="#Checking-for-PDF-output">Checking for PDF output</a>). @@ -4571,7 +4230,7 @@ displayed. <code>pdftex</code> driver, the usual link type used to refer to destinations in the current document is called ‘<samp>name</samp>’. You can also create a link pointing to another local document (by using the -‘<samp>filename</samp>’ link type) or to a <acronym>URL</acronym> (by using the +‘<samp>filename</samp>’ link type) or to a url (by using the ‘<samp>url</samp>’ link type). </p> <span id="index-link-options"></span> @@ -4588,7 +4247,9 @@ options supported by the drivers. See <a href="#Setting-hyperlink-types-and-opt </p> <hr> -<span id="Explicit-hyperlinks"></span><div class="header"> +</div> +<div class="section" id="Explicit-hyperlinks"> +<div class="header"> <p> Next: <a href="#Implicit-hyperlinks" accesskey="n" rel="next">Implicit hyperlinks</a>, Previous: <a href="#Introduction-to-hyperlinks" accesskey="p" rel="prev">Introduction to hyperlinks</a>, Up: <a href="#Hyperlinks" accesskey="u" rel="up">Hyperlinks</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Macro-index" title="Index" rel="index">Index</a>]</p> </div> @@ -4645,7 +4306,7 @@ see <a href="#Setting-default-types-and-options">Setting default types and optio <p>The <var>label</var> argument of both <code>\hldest</code> and <code>\hlstart</code> can contain special characters (such as ‘<samp>#</samp>’, ‘<samp>%</samp>’, ‘<samp>&</samp>’, ‘<samp>~</samp>’, etc.) without any escaping. This is especially important -for <acronym>URL</acronym> links supported by some drivers (see <a href="#Hyperlink-drivers">Hyperlink drivers</a>). +for url links supported by some drivers (see <a href="#Hyperlink-drivers">Hyperlink drivers</a>). </p> <p>Both <code>\hldest</code> and <code>\hlstart</code> ignore following spaces. </p> @@ -4660,12 +4321,14 @@ pass it for the <var>options</var>. For example: <p>is functionally equivalent to the previous example. </p> -<p>See <a href="#Hyperlinks-_0028xhyper_002etex_0029">Hyperlinks (xhyper.tex)</a>, for a demonstration of the usage of +<p>See <a href="#Hyperlinks-_0028xhyper_002etex_0029">Hyperlinks (<code>xhyper.tex</code>)</a>, for a demonstration of the usage of explicit hyperlinks. </p> <hr> -<span id="Implicit-hyperlinks"></span><div class="header"> +</div> +<div class="section" id="Implicit-hyperlinks"> +<div class="header"> <p> Next: <a href="#Hyperlink-drivers" accesskey="n" rel="next">Hyperlink drivers</a>, Previous: <a href="#Explicit-hyperlinks" accesskey="p" rel="prev">Explicit hyperlinks</a>, Up: <a href="#Hyperlinks" accesskey="u" rel="up">Hyperlinks</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Macro-index" title="Index" rel="index">Index</a>]</p> </div> @@ -4708,40 +4371,31 @@ set parameters for a group. <pre class="display">bib, li, definexref, xrdef, eq, idx, foot, footback. </pre></div> -<p>See <a href="#Hyperlinks-_0028xhyper_002etex_0029">Hyperlinks (xhyper.tex)</a>, for a demonstration of the usage of +<p>See <a href="#Hyperlinks-_0028xhyper_002etex_0029">Hyperlinks (<code>xhyper.tex</code>)</a>, for a demonstration of the usage of implicit hyperlinks. </p> <p>The following subsections describe each of the linkgroups and destgroups and the hyperlink support provided. </p> -<table class="menu" border="0" cellspacing="0"> -<tr><td align="left" valign="top">• <a href="#General-hyperlinks" accesskey="1">General hyperlinks</a></td><td> </td><td align="left" valign="top">hrefint, hrefext -</td></tr> -<tr><td align="left" valign="top">• <a href="#URL-hyperlinks" accesskey="2">URL hyperlinks</a></td><td> </td><td align="left" valign="top">url -</td></tr> -<tr><td align="left" valign="top">• <a href="#Citation-hyperlinks" accesskey="3">Citation hyperlinks</a></td><td> </td><td align="left" valign="top">cite, bib -</td></tr> -<tr><td align="left" valign="top">• <a href="#List-hyperlinks" accesskey="4">List hyperlinks</a></td><td> </td><td align="left" valign="top">li -</td></tr> -<tr><td align="left" valign="top">• <a href="#Cross_002dreference-hyperlinks" accesskey="5">Cross-reference hyperlinks</a></td><td> </td><td align="left" valign="top">definexref, ref -</td></tr> -<tr><td align="left" valign="top">• <a href="#Page-reference-hyperlinks" accesskey="6">Page reference hyperlinks</a></td><td> </td><td align="left" valign="top">xrdef, xref -</td></tr> -<tr><td align="left" valign="top">• <a href="#Equation-reference-hyperlinks" accesskey="7">Equation reference hyperlinks</a></td><td> </td><td align="left" valign="top">eq -</td></tr> -<tr><td align="left" valign="top">• <a href="#Index-hyperlinks" accesskey="8">Index hyperlinks</a></td><td> </td><td align="left" valign="top">idx -</td></tr> -<tr><td align="left" valign="top">• <a href="#Footnote-hyperlinks" accesskey="9">Footnote hyperlinks</a></td><td> </td><td align="left" valign="top">foot, footback -</td></tr> -<tr><td align="left" valign="top">• <a href="#Contents-hyperlinks">Contents hyperlinks</a></td><td> </td><td align="left" valign="top"> -</td></tr> -</table> +<ul class="section-toc"> +<li><a href="#General-hyperlinks" accesskey="1">General hyperlinks: hrefint, hrefext</a></li> +<li><a href="#URL-hyperlinks" accesskey="2">URL hyperlinks: url</a></li> +<li><a href="#Citation-hyperlinks" accesskey="3">Citation hyperlinks: cite, bib</a></li> +<li><a href="#List-hyperlinks" accesskey="4">List hyperlinks: li</a></li> +<li><a href="#Cross_002dreference-hyperlinks" accesskey="5">Cross-reference hyperlinks: definexref, ref</a></li> +<li><a href="#Page-reference-hyperlinks" accesskey="6">Page reference hyperlinks: xrdef, xref</a></li> +<li><a href="#Equation-reference-hyperlinks" accesskey="7">Equation reference hyperlinks: eq</a></li> +<li><a href="#Index-hyperlinks" accesskey="8">Index hyperlinks: idx</a></li> +<li><a href="#Footnote-hyperlinks" accesskey="9">Footnote hyperlinks: foot, footback</a></li> +<li><a href="#Contents-hyperlinks">Contents hyperlinks</a></li> +</ul> <hr> -<span id="General-hyperlinks"></span><div class="header"> +<div class="subsection" id="General-hyperlinks"> +<div class="header"> <p> -Next: <a href="#URL-hyperlinks" accesskey="n" rel="next">URL hyperlinks</a>, Up: <a href="#Implicit-hyperlinks" accesskey="u" rel="up">Implicit hyperlinks</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Macro-index" title="Index" rel="index">Index</a>]</p> +Next: <a href="#URL-hyperlinks" accesskey="n" rel="next">URL hyperlinks: url</a>, Up: <a href="#Implicit-hyperlinks" accesskey="u" rel="up">Implicit hyperlinks</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Macro-index" title="Index" rel="index">Index</a>]</p> </div> <span id="General-hyperlinks_003a-hrefint_002c-hrefext"></span><h4 class="subsection">5.3.1 General hyperlinks: hrefint, hrefext</h4> @@ -4765,15 +4419,15 @@ document). Parameters for these links can be set by customizing the <p>will make ‘Introduction’ into an internal link, which might have been created, e.g., with <code>\xrdef{intro}</code>. </p> -<span id="index-URL-hyperlink"></span> -<span id="index-hyperlinks_002c-URL"></span> +<span id="index-url-hyperlink"></span> +<span id="index-hyperlinks_002c-url"></span> <p>If <var>url</var> does not start with ‘<samp>#</samp>’, it is assumed to be a -<acronym>URL</acronym> link. Parameters for these links can be set by +url link. Parameters for these links can be set by customizing the <span id="index-group-_0060hrefext_0027"></span> <span id="index-linkgroup-_0060hrefext_0027"></span> ‘hrefext’ linkgroup. The special characters (such as ‘<samp>#</samp>’ and -‘<samp>~</samp>’) in the <acronym>URL</acronym> don’t need to be escaped. For example: +‘<samp>~</samp>’) in the url don’t need to be escaped. For example: </p> <div class="example"> <pre class="example">\href{https://tug.org/eplain/doc/eplain.html#Hyperlinks}{Hyperlinks @@ -4781,8 +4435,8 @@ customizing the \href{mailto:tex-eplain@tug.org}{Eplain mailing list} </pre></div> -<p>See <a href="#URL-hyperlinks">URL hyperlinks</a>, for another way to create -<acronym>URL</acronym> hyperlinks. +<p>See <a href="#URL-hyperlinks">URL hyperlinks: url</a>, for another way to create +url hyperlinks. </p> <p>The <var>text</var> argument of <code>\href</code> can contain verbatim text (see <a href="#Verbatim-listing">Verbatim listing</a>) or other macros which manipulate character @@ -4800,14 +4454,16 @@ catcodes. For example: </p> <hr> -<span id="URL-hyperlinks"></span><div class="header"> +</div> +<div class="subsection" id="URL-hyperlinks"> +<div class="header"> <p> -Next: <a href="#Citation-hyperlinks" accesskey="n" rel="next">Citation hyperlinks</a>, Previous: <a href="#General-hyperlinks" accesskey="p" rel="prev">General hyperlinks</a>, Up: <a href="#Implicit-hyperlinks" accesskey="u" rel="up">Implicit hyperlinks</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Macro-index" title="Index" rel="index">Index</a>]</p> +Next: <a href="#Citation-hyperlinks" accesskey="n" rel="next">Citation hyperlinks: cite, bib</a>, Previous: <a href="#General-hyperlinks" accesskey="p" rel="prev">General hyperlinks: hrefint, hrefext</a>, Up: <a href="#Implicit-hyperlinks" accesskey="u" rel="up">Implicit hyperlinks</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Macro-index" title="Index" rel="index">Index</a>]</p> </div> <span id="URL-hyperlinks_003a-url"></span><h4 class="subsection">5.3.2 URL hyperlinks: url</h4> -<span id="index-URL-hyperlink-1"></span> -<span id="index-hyperlinks_002c-URL-1"></span> +<span id="index-url-hyperlink-1"></span> +<span id="index-hyperlinks_002c-url-1"></span> <span id="index-group-_0060url_0027"></span> <span id="index-linkgroup-_0060url_0027"></span> <p>The ‘url’ linkgroup covers the @@ -4818,10 +4474,10 @@ Next: <a href="#Citation-hyperlinks" accesskey="n" rel="next">Citation hyperlink <code>\url</code>-like commands you define. The type for this linkgroup is set to ‘<samp>url</samp>’ by the drivers which support this link type. ‘<samp>url</samp>’ links use the parameter to the <code>\url</code> command as the -<acronym>URL</acronym> to point to. +url to point to. </p> <p>You may be using the <code>\url</code> command to typeset something other than -a <acronym>URL</acronym>, e.g., a path, for which you do not want a link to be +a url, e.g., a path, for which you do not want a link to be created; in that case, you can disable the ‘url’ linkgroup with the command <code>\hloff[url]</code> (see <a href="#Turning-hyperlinks-on_002foff-for-a-group">Turning hyperlinks on/off for a group</a>). </p> @@ -4830,7 +4486,7 @@ command <code>\hloff[url]</code> (see <a href="#Turning-hyperlinks-on_002foff-fo <span id="index-color_002c-hyperlinks"></span> <span id="index-colored-links"></span> <span id="index-hyperlink-color"></span> -<p>By default, <acronym>URL</acronym> (and other types of) links are boxed, so +<p>By default, url (and other types of) links are boxed, so that they are visually marked even if you do not load the LaTeX <span id="index-color_002esty-1"></span> ‘color’ package (see <a href="#Loading-LaTeX-packages">Loading LaTeX packages</a>) and therefore link text @@ -4846,7 +4502,7 @@ work in plain TeX; see <a href="#Packages-known-to-work">Packages known to \enablehyperlinks -\url{http://foo/bar} +\url{https://foo/bar} \url{mailto:foobar@example.org} @@ -4867,7 +4523,7 @@ border around them. Try this: \enablehyperlinks \hlopts{bwidth=0} -\url{http://foo/bar} +\url{https://foo/bar} \url{mailto:foobar@example.org} @@ -4877,14 +4533,16 @@ border around them. Try this: <p>The command <code>\hlopts{bwidth=0}</code> sets border width to zero as the default for all links, and loading the <samp>color</samp> package automatically colors links using the default color (see <a href="#Options-supported-by-all-drivers">Options supported by all drivers</a>). If you want the border width setting to -apply to <acronym>URL</acronym> links only, say <code>\hlopts[url]{bwidth=0}</code> +apply to url links only, say <code>\hlopts[url]{bwidth=0}</code> (see <a href="#Setting-hyperlink-types-and-options">Setting hyperlink types and options</a>). </p> <hr> -<span id="Citation-hyperlinks"></span><div class="header"> +</div> +<div class="subsection" id="Citation-hyperlinks"> +<div class="header"> <p> -Next: <a href="#List-hyperlinks" accesskey="n" rel="next">List hyperlinks</a>, Previous: <a href="#URL-hyperlinks" accesskey="p" rel="prev">URL hyperlinks</a>, Up: <a href="#Implicit-hyperlinks" accesskey="u" rel="up">Implicit hyperlinks</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Macro-index" title="Index" rel="index">Index</a>]</p> +Next: <a href="#List-hyperlinks" accesskey="n" rel="next">List hyperlinks: li</a>, Previous: <a href="#URL-hyperlinks" accesskey="p" rel="prev">URL hyperlinks: url</a>, Up: <a href="#Implicit-hyperlinks" accesskey="u" rel="up">Implicit hyperlinks</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Macro-index" title="Index" rel="index">Index</a>]</p> </div> <span id="Citation-hyperlinks_003a-cite_002c-bib"></span><h4 class="subsection">5.3.3 Citation hyperlinks: cite, bib</h4> @@ -4912,9 +4570,11 @@ entries. For each of the entries, a destination is defined. </p> <hr> -<span id="List-hyperlinks"></span><div class="header"> +</div> +<div class="subsection" id="List-hyperlinks"> +<div class="header"> <p> -Next: <a href="#Cross_002dreference-hyperlinks" accesskey="n" rel="next">Cross-reference hyperlinks</a>, Previous: <a href="#Citation-hyperlinks" accesskey="p" rel="prev">Citation hyperlinks</a>, Up: <a href="#Implicit-hyperlinks" accesskey="u" rel="up">Implicit hyperlinks</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Macro-index" title="Index" rel="index">Index</a>]</p> +Next: <a href="#Cross_002dreference-hyperlinks" accesskey="n" rel="next">Cross-reference hyperlinks: definexref, ref</a>, Previous: <a href="#Citation-hyperlinks" accesskey="p" rel="prev">Citation hyperlinks: cite, bib</a>, Up: <a href="#Implicit-hyperlinks" accesskey="u" rel="up">Implicit hyperlinks</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Macro-index" title="Index" rel="index">Index</a>]</p> </div> <span id="List-hyperlinks_003a-li"></span><h4 class="subsection">5.3.4 List hyperlinks: li</h4> @@ -4930,9 +4590,11 @@ label. </p> <hr> -<span id="Cross_002dreference-hyperlinks"></span><div class="header"> +</div> +<div class="subsection" id="Cross_002dreference-hyperlinks"> +<div class="header"> <p> -Next: <a href="#Page-reference-hyperlinks" accesskey="n" rel="next">Page reference hyperlinks</a>, Previous: <a href="#List-hyperlinks" accesskey="p" rel="prev">List hyperlinks</a>, Up: <a href="#Implicit-hyperlinks" accesskey="u" rel="up">Implicit hyperlinks</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Macro-index" title="Index" rel="index">Index</a>]</p> +Next: <a href="#Page-reference-hyperlinks" accesskey="n" rel="next">Page reference hyperlinks: xrdef, xref</a>, Previous: <a href="#List-hyperlinks" accesskey="p" rel="prev">List hyperlinks: li</a>, Up: <a href="#Implicit-hyperlinks" accesskey="u" rel="up">Implicit hyperlinks</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Macro-index" title="Index" rel="index">Index</a>]</p> </div> <span id="Cross_002dreference-hyperlinks_003a-definexref_002c-ref"></span><h4 class="subsection">5.3.5 Cross-reference hyperlinks: definexref, ref</h4> @@ -4978,9 +4640,11 @@ its intended use. </p> <hr> -<span id="Page-reference-hyperlinks"></span><div class="header"> +</div> +<div class="subsection" id="Page-reference-hyperlinks"> +<div class="header"> <p> -Next: <a href="#Equation-reference-hyperlinks" accesskey="n" rel="next">Equation reference hyperlinks</a>, Previous: <a href="#Cross_002dreference-hyperlinks" accesskey="p" rel="prev">Cross-reference hyperlinks</a>, Up: <a href="#Implicit-hyperlinks" accesskey="u" rel="up">Implicit hyperlinks</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Macro-index" title="Index" rel="index">Index</a>]</p> +Next: <a href="#Equation-reference-hyperlinks" accesskey="n" rel="next">Equation reference hyperlinks: eq</a>, Previous: <a href="#Cross_002dreference-hyperlinks" accesskey="p" rel="prev">Cross-reference hyperlinks: definexref, ref</a>, Up: <a href="#Implicit-hyperlinks" accesskey="u" rel="up">Implicit hyperlinks</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Macro-index" title="Index" rel="index">Index</a>]</p> </div> <span id="Page-reference-hyperlinks_003a-xrdef_002c-xref"></span><h4 class="subsection">5.3.6 Page reference hyperlinks: xrdef, xref</h4> @@ -5005,9 +4669,11 @@ label. </p> <hr> -<span id="Equation-reference-hyperlinks"></span><div class="header"> +</div> +<div class="subsection" id="Equation-reference-hyperlinks"> +<div class="header"> <p> -Next: <a href="#Index-hyperlinks" accesskey="n" rel="next">Index hyperlinks</a>, Previous: <a href="#Page-reference-hyperlinks" accesskey="p" rel="prev">Page reference hyperlinks</a>, Up: <a href="#Implicit-hyperlinks" accesskey="u" rel="up">Implicit hyperlinks</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Macro-index" title="Index" rel="index">Index</a>]</p> +Next: <a href="#Index-hyperlinks" accesskey="n" rel="next">Index hyperlinks: idx</a>, Previous: <a href="#Page-reference-hyperlinks" accesskey="p" rel="prev">Page reference hyperlinks: xrdef, xref</a>, Up: <a href="#Implicit-hyperlinks" accesskey="u" rel="up">Implicit hyperlinks</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Macro-index" title="Index" rel="index">Index</a>]</p> </div> <span id="Equation-reference-hyperlinks_003a-eq"></span><h4 class="subsection">5.3.7 Equation reference hyperlinks: eq</h4> @@ -5048,9 +4714,11 @@ label generated for the last empty-labeled equation. </p> <hr> -<span id="Index-hyperlinks"></span><div class="header"> +</div> +<div class="subsection" id="Index-hyperlinks"> +<div class="header"> <p> -Next: <a href="#Footnote-hyperlinks" accesskey="n" rel="next">Footnote hyperlinks</a>, Previous: <a href="#Equation-reference-hyperlinks" accesskey="p" rel="prev">Equation reference hyperlinks</a>, Up: <a href="#Implicit-hyperlinks" accesskey="u" rel="up">Implicit hyperlinks</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Macro-index" title="Index" rel="index">Index</a>]</p> +Next: <a href="#Footnote-hyperlinks" accesskey="n" rel="next">Footnote hyperlinks: foot, footback</a>, Previous: <a href="#Equation-reference-hyperlinks" accesskey="p" rel="prev">Equation reference hyperlinks: eq</a>, Up: <a href="#Implicit-hyperlinks" accesskey="u" rel="up">Implicit hyperlinks</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Macro-index" title="Index" rel="index">Index</a>]</p> </div> <span id="Index-hyperlinks_003a-idx"></span><h4 class="subsection">5.3.8 Index hyperlinks: idx</h4> @@ -5097,24 +4765,20 @@ encapsulator, turns the page number into a link. <p>Eplain provides two approaches to linking page numbers in the index to locations of index terms in the text. </p> -<table class="menu" border="0" cellspacing="0"> -<tr><td align="left" valign="top">• <a href="#Exact-destinations-for-index-terms" accesskey="1">Exact destinations for index terms</a></td><td> </td><td align="left" valign="top"> -</td></tr> -<tr><td align="left" valign="top">• <a href="#Page-destinations-for-index-terms" accesskey="2">Page destinations for index terms</a></td><td> </td><td align="left" valign="top"> -</td></tr> -<tr><td align="left" valign="top">• <a href="#Choosing-destination-placement" accesskey="3">Choosing destination placement</a></td><td> </td><td align="left" valign="top"> -</td></tr> -<tr><td align="left" valign="top">• <a href="#Index-page-list-and-page-range-parsers" accesskey="4">Index page list and page range parsers</a></td><td> </td><td align="left" valign="top"> -</td></tr> -<tr><td align="left" valign="top">• <a href="#Hyperlinks-in-see-and-see-also-entries" accesskey="5">Hyperlinks in see and see also entries</a></td><td> </td><td align="left" valign="top"> -</td></tr> -</table> +<ul class="section-toc"> +<li><a href="#Exact-destinations-for-index-terms" accesskey="1">Exact destinations for index terms</a></li> +<li><a href="#Page-destinations-for-index-terms" accesskey="2">Page destinations for index terms</a></li> +<li><a href="#Choosing-destination-placement" accesskey="3">Choosing destination placement</a></li> +<li><a href="#Index-page-list-and-page-range-parsers" accesskey="4">Index page list and page range parsers</a></li> +<li><a href="#Hyperlinks-in-see-and-see-also-entries" accesskey="5">Hyperlinks in see and see also entries</a></li> +</ul> <hr> -<span id="Exact-destinations-for-index-terms"></span><div class="header"> +<div class="subsubsection" id="Exact-destinations-for-index-terms"> +<div class="header"> <p> -Next: <a href="#Page-destinations-for-index-terms" accesskey="n" rel="next">Page destinations for index terms</a>, Up: <a href="#Index-hyperlinks" accesskey="u" rel="up">Index hyperlinks</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Macro-index" title="Index" rel="index">Index</a>]</p> +Next: <a href="#Page-destinations-for-index-terms" accesskey="n" rel="next">Page destinations for index terms</a>, Up: <a href="#Index-hyperlinks" accesskey="u" rel="up">Index hyperlinks: idx</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Macro-index" title="Index" rel="index">Index</a>]</p> </div> <span id="Exact-destinations-for-index-terms-1"></span><h4 class="subsubsection">5.3.8.1 Exact destinations for index terms</h4> @@ -5170,7 +4834,7 @@ hyperlink label but identical otherwise. You should process the example: </p> <div class="example"> -<pre class="example">prompt$ ./idxuniq file.idx | makeindex > file.ind +<pre class="example">$ ./idxuniq file.idx | makeindex >file.ind </pre></div> <p>Still, this solution is not ideal, as the page-range formation @@ -5181,9 +4845,11 @@ definition; <samp>idxuniq</samp> will not filter out the second entry). </p> <hr> -<span id="Page-destinations-for-index-terms"></span><div class="header"> +</div> +<div class="subsubsection" id="Page-destinations-for-index-terms"> +<div class="header"> <p> -Next: <a href="#Choosing-destination-placement" accesskey="n" rel="next">Choosing destination placement</a>, Previous: <a href="#Exact-destinations-for-index-terms" accesskey="p" rel="prev">Exact destinations for index terms</a>, Up: <a href="#Index-hyperlinks" accesskey="u" rel="up">Index hyperlinks</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Macro-index" title="Index" rel="index">Index</a>]</p> +Next: <a href="#Choosing-destination-placement" accesskey="n" rel="next">Choosing destination placement</a>, Previous: <a href="#Exact-destinations-for-index-terms" accesskey="p" rel="prev">Exact destinations for index terms</a>, Up: <a href="#Index-hyperlinks" accesskey="u" rel="up">Index hyperlinks: idx</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Macro-index" title="Index" rel="index">Index</a>]</p> </div> <span id="Page-destinations-for-index-terms-1"></span><h4 class="subsubsection">5.3.8.2 Page destinations for index terms</h4> @@ -5252,9 +4918,11 @@ with the commands </p> <hr> -<span id="Choosing-destination-placement"></span><div class="header"> +</div> +<div class="subsubsection" id="Choosing-destination-placement"> +<div class="header"> <p> -Next: <a href="#Index-page-list-and-page-range-parsers" accesskey="n" rel="next">Index page list and page range parsers</a>, Previous: <a href="#Page-destinations-for-index-terms" accesskey="p" rel="prev">Page destinations for index terms</a>, Up: <a href="#Index-hyperlinks" accesskey="u" rel="up">Index hyperlinks</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Macro-index" title="Index" rel="index">Index</a>]</p> +Next: <a href="#Index-page-list-and-page-range-parsers" accesskey="n" rel="next">Index page list and page range parsers</a>, Previous: <a href="#Page-destinations-for-index-terms" accesskey="p" rel="prev">Page destinations for index terms</a>, Up: <a href="#Index-hyperlinks" accesskey="u" rel="up">Index hyperlinks: idx</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Macro-index" title="Index" rel="index">Index</a>]</p> </div> <span id="Choosing-destination-placement-1"></span><h4 class="subsubsection">5.3.8.3 Choosing destination placement</h4> @@ -5287,9 +4955,11 @@ wrappers into the <samp>.idx</samp> file. The default is <code>idxpage</code>. </p> <hr> -<span id="Index-page-list-and-page-range-parsers"></span><div class="header"> +</div> +<div class="subsubsection" id="Index-page-list-and-page-range-parsers"> +<div class="header"> <p> -Next: <a href="#Hyperlinks-in-see-and-see-also-entries" accesskey="n" rel="next">Hyperlinks in see and see also entries</a>, Previous: <a href="#Choosing-destination-placement" accesskey="p" rel="prev">Choosing destination placement</a>, Up: <a href="#Index-hyperlinks" accesskey="u" rel="up">Index hyperlinks</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Macro-index" title="Index" rel="index">Index</a>]</p> +Next: <a href="#Hyperlinks-in-see-and-see-also-entries" accesskey="n" rel="next">Hyperlinks in see and see also entries</a>, Previous: <a href="#Choosing-destination-placement" accesskey="p" rel="prev">Choosing destination placement</a>, Up: <a href="#Index-hyperlinks" accesskey="u" rel="up">Index hyperlinks: idx</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Macro-index" title="Index" rel="index">Index</a>]</p> </div> <span id="Index-page-list-and-page-range-parsers-1"></span><h4 class="subsubsection">5.3.8.4 Index page list and page range parsers</h4> @@ -5300,9 +4970,11 @@ usage. </p> <hr> -<span id="Hyperlinks-in-see-and-see-also-entries"></span><div class="header"> +</div> +<div class="subsubsection" id="Hyperlinks-in-see-and-see-also-entries"> +<div class="header"> <p> -Previous: <a href="#Index-page-list-and-page-range-parsers" accesskey="p" rel="prev">Index page list and page range parsers</a>, Up: <a href="#Index-hyperlinks" accesskey="u" rel="up">Index hyperlinks</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Macro-index" title="Index" rel="index">Index</a>]</p> +Previous: <a href="#Index-page-list-and-page-range-parsers" accesskey="p" rel="prev">Index page list and page range parsers</a>, Up: <a href="#Index-hyperlinks" accesskey="u" rel="up">Index hyperlinks: idx</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Macro-index" title="Index" rel="index">Index</a>]</p> </div> <span id="Hyperlinks-in-see-and-see-also-entries-1"></span><h4 class="subsubsection">5.3.8.5 Hyperlinks in see and see also entries</h4> @@ -5330,9 +5002,12 @@ this can be implemented with <code>\hldest</code> and <code>\hlstart</code> <hr> -<span id="Footnote-hyperlinks"></span><div class="header"> +</div> +</div> +<div class="subsection" id="Footnote-hyperlinks"> +<div class="header"> <p> -Next: <a href="#Contents-hyperlinks" accesskey="n" rel="next">Contents hyperlinks</a>, Previous: <a href="#Index-hyperlinks" accesskey="p" rel="prev">Index hyperlinks</a>, Up: <a href="#Implicit-hyperlinks" accesskey="u" rel="up">Implicit hyperlinks</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Macro-index" title="Index" rel="index">Index</a>]</p> +Next: <a href="#Contents-hyperlinks" accesskey="n" rel="next">Contents hyperlinks</a>, Previous: <a href="#Index-hyperlinks" accesskey="p" rel="prev">Index hyperlinks: idx</a>, Up: <a href="#Implicit-hyperlinks" accesskey="u" rel="up">Implicit hyperlinks</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Macro-index" title="Index" rel="index">Index</a>]</p> </div> <span id="Footnote-hyperlinks_003a-foot_002c-footback"></span><h4 class="subsection">5.3.9 Footnote hyperlinks: foot, footback</h4> @@ -5377,9 +5052,11 @@ hyperlinks (see <a href="#Turning-hyperlinks-on_002foff-for-a-group">Turning hyp <hr> -<span id="Contents-hyperlinks"></span><div class="header"> +</div> +<div class="subsection" id="Contents-hyperlinks"> +<div class="header"> <p> -Previous: <a href="#Footnote-hyperlinks" accesskey="p" rel="prev">Footnote hyperlinks</a>, Up: <a href="#Implicit-hyperlinks" accesskey="u" rel="up">Implicit hyperlinks</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Macro-index" title="Index" rel="index">Index</a>]</p> +Previous: <a href="#Footnote-hyperlinks" accesskey="p" rel="prev">Footnote hyperlinks: foot, footback</a>, Up: <a href="#Implicit-hyperlinks" accesskey="u" rel="up">Implicit hyperlinks</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Macro-index" title="Index" rel="index">Index</a>]</p> </div> <span id="Contents-hyperlinks-1"></span><h4 class="subsection">5.3.10 Contents hyperlinks</h4> @@ -5393,7 +5070,10 @@ contents (see <a href="#Contents">Contents</a>), but implementing them with the </p> <hr> -<span id="Hyperlink-drivers"></span><div class="header"> +</div> +</div> +<div class="section" id="Hyperlink-drivers"> +<div class="header"> <p> Next: <a href="#Setting-hyperlink-types-and-options" accesskey="n" rel="next">Setting hyperlink types and options</a>, Previous: <a href="#Implicit-hyperlinks" accesskey="p" rel="prev">Implicit hyperlinks</a>, Up: <a href="#Hyperlinks" accesskey="u" rel="up">Hyperlinks</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Macro-index" title="Index" rel="index">Index</a>]</p> </div> @@ -5406,22 +5086,19 @@ you may only want to skim through this section. <p>Some of the descriptions below come from <cite>Portable Document Format Reference Manual Version 1.3</cite>, March 11, 1999. </p> -<table class="menu" border="0" cellspacing="0"> -<tr><td align="left" valign="top">• <a href="#Options-supported-by-all-drivers" accesskey="1">Options supported by all drivers</a></td><td> </td><td align="left" valign="top"> -</td></tr> -<tr><td align="left" valign="top">• <a href="#Hyperlink-driver-hypertex" accesskey="2">Hyperlink driver hypertex</a></td><td> </td><td align="left" valign="top"> -</td></tr> -<tr><td align="left" valign="top">• <a href="#Hyperlink-drivers-pdftex-and-dvipdfm" accesskey="3">Hyperlink drivers pdftex and dvipdfm</a></td><td> </td><td align="left" valign="top"> -</td></tr> -<tr><td align="left" valign="top">• <a href="#Hyperlink-driver-nolinks" accesskey="4">Hyperlink driver nolinks</a></td><td> </td><td align="left" valign="top"> -</td></tr> -</table> +<ul class="section-toc"> +<li><a href="#Options-supported-by-all-drivers" accesskey="1">Options supported by all drivers</a></li> +<li><a href="#Hyperlink-driver-hypertex" accesskey="2">Hyperlink driver <code>hypertex</code></a></li> +<li><a href="#Hyperlink-drivers-pdftex-and-dvipdfm" accesskey="3">Hyperlink drivers <code>pdftex</code> and <code>dvipdfm</code></a></li> +<li><a href="#Hyperlink-driver-nolinks" accesskey="4">Hyperlink driver <code>nolinks</code></a></li> +</ul> <hr> -<span id="Options-supported-by-all-drivers"></span><div class="header"> +<div class="subsection" id="Options-supported-by-all-drivers"> +<div class="header"> <p> -Next: <a href="#Hyperlink-driver-hypertex" accesskey="n" rel="next">Hyperlink driver hypertex</a>, Up: <a href="#Hyperlink-drivers" accesskey="u" rel="up">Hyperlink drivers</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Macro-index" title="Index" rel="index">Index</a>]</p> +Next: <a href="#Hyperlink-driver-hypertex" accesskey="n" rel="next">Hyperlink driver <code>hypertex</code></a>, Up: <a href="#Hyperlink-drivers" accesskey="u" rel="up">Hyperlink drivers</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Macro-index" title="Index" rel="index">Index</a>]</p> </div> <span id="Options-supported-by-all-drivers-1"></span><h4 class="subsection">5.4.1 Options supported by all drivers</h4> @@ -5435,9 +5112,8 @@ supported by all hyperlink drivers. <span id="index-destination-options_002c-common"></span> <span id="index-options_002c-destination_002c-common"></span> <dl compact="compact"> -<dt><code>raise</code></dt> -<dd><span id="index-raise-_0028hyperlink-option_0029"></span> -<span id="index-raising-hyperlink-destinations"></span> +<dt id='index-raise-_0028hyperlink-option_0029'><span><code>raise</code><a href='#index-raise-_0028hyperlink-option_0029' class='copiable-anchor'> ¶</a></span></dt> +<dd><span id="index-raising-hyperlink-destinations"></span> <span id="index-hyperlink-destination_002c-raising"></span> <span id="index-destinations_002c-raising"></span> <p>Specifies how much to raise destinations above the baseline. When set @@ -5472,10 +5148,9 @@ to accommodate the usual cases of large operators in displayed math. <span id="index-options_002c-link_002c-common"></span> <dl compact="compact"> -<dt><code>colormodel</code></dt> -<dt><code>color</code></dt> -<dd><span id="index-colormodel-_0028hyperlink-option_0029"></span> -<span id="index-color-_0028hyperlink-option_0029"></span> +<dt id='index-colormodel-_0028hyperlink-option_0029'><span><code>colormodel</code><a href='#index-colormodel-_0028hyperlink-option_0029' class='copiable-anchor'> ¶</a></span></dt> +<dt><span><code>color</code></span></dt> +<dd><span id="index-color-_0028hyperlink-option_0029"></span> <span id="index-color_002c-hyperlinks-1"></span> <span id="index-colored-links-1"></span> <span id="index-hyperlink-color-1"></span> @@ -5511,9 +5186,11 @@ an empty <var>colormodel</var> (see examples below). <hr> -<span id="Hyperlink-driver-hypertex"></span><div class="header"> +</div> +<div class="subsection" id="Hyperlink-driver-hypertex"> +<div class="header"> <p> -Next: <a href="#Hyperlink-drivers-pdftex-and-dvipdfm" accesskey="n" rel="next">Hyperlink drivers pdftex and dvipdfm</a>, Previous: <a href="#Options-supported-by-all-drivers" accesskey="p" rel="prev">Options supported by all drivers</a>, Up: <a href="#Hyperlink-drivers" accesskey="u" rel="up">Hyperlink drivers</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Macro-index" title="Index" rel="index">Index</a>]</p> +Next: <a href="#Hyperlink-drivers-pdftex-and-dvipdfm" accesskey="n" rel="next">Hyperlink drivers <code>pdftex</code> and <code>dvipdfm</code></a>, Previous: <a href="#Options-supported-by-all-drivers" accesskey="p" rel="prev">Options supported by all drivers</a>, Up: <a href="#Hyperlink-drivers" accesskey="u" rel="up">Hyperlink drivers</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Macro-index" title="Index" rel="index">Index</a>]</p> </div> <span id="Hyperlink-driver-hypertex-1"></span><h4 class="subsection">5.4.2 Hyperlink driver <code>hypertex</code></h4> @@ -5522,15 +5199,15 @@ Next: <a href="#Hyperlink-drivers-pdftex-and-dvipdfm" accesskey="n" rel="next">H <span id="index-driver-hypertex"></span> <span id="index-hyperlink-driver-hypertex"></span> <p>HyperTeX is a standard for inclusion of hyperlink information in -TeX (and LaTeX) documents (see <a href="http://arxiv.org/hypertex">http://arxiv.org/hypertex</a>). +TeX (and LaTeX) documents (see <a href="https://arxiv.org/hypertex">https://arxiv.org/hypertex</a>). This standard defines a set of hyperlink tags implemented as -<code>\special</code> commands written into the <acronym>DVI</acronym> file. The +<code>\special</code> commands written into the DVI file. The major advantage of such standard is that a single <samp>.dvi</samp> file containing HyperTeX commands can be viewed by any HyperTeX-enabled viewer (e.g., any more or less modern version of <span id="index-xdvi"></span> -<code>xdvi</code>) or converted to other file formats (e.g., <acronym>PDF</acronym>) -by any HyperTeX-enabled <acronym>DVI</acronym> converter (e.g., +<code>xdvi</code>) or converted to other file formats (e.g., PDF) +by any HyperTeX-enabled DVI converter (e.g., <span id="index-dvipdfm-1"></span> <code>dvipdfmx</code> or <span id="index-dvips"></span> @@ -5544,16 +5221,16 @@ Ghostscript’s factor” of other formats supporting hyperlinks, so many features of a particular file format cannot be supported by HyperTeX. Therefore, if you need to use special features of a particular format, HyperTeX -is not a good choice. For the <acronym>PDF</acronym> file format, Eplain +is not a good choice. For the PDF file format, Eplain provides the <code>pdftex</code> and <code>dvipdfm</code> drivers which provide -fine control over the <acronym>PDF</acronym> options (see <a href="#Hyperlink-drivers-pdftex-and-dvipdfm">Hyperlink drivers pdftex and dvipdfm</a>). +fine control over the PDF options (see <a href="#Hyperlink-drivers-pdftex-and-dvipdfm">Hyperlink drivers <code>pdftex</code> and <code>dvipdfm</code></a>). </p> <p>For more information on programs which support the HyperTeX standard, please see </p> <div class="display"> -<pre class="display"><a href="http://arxiv.org/hypertex">http://arxiv.org/hypertex</a> -<a href="http://mirror.ctan.org/support/hypertex/hypertex">http://mirror.ctan.org/support/hypertex/hypertex</a> +<pre class="display"><a href="https://arxiv.org/hypertex">https://arxiv.org/hypertex</a> +<a href="https://mirror.ctan.org/support/hypertex/hypertex">https://mirror.ctan.org/support/hypertex/hypertex</a> </pre></div> <p>For convenience, we list a few HyperTeX-enabled converters: @@ -5561,7 +5238,7 @@ please see <dl compact="compact"> <dd><span id="index-dvips-1"></span> </dd> -<dt><code>dvips</code></dt> +<dt><span><code>dvips</code></span></dt> <dd><p>Note that you need to pass the <samp>-z</samp> option to <code>dvips</code> to tell it to preserve the information about the hyperlinks. To generate a <samp>.pdf</samp> file with hyperlinks, you can use the @@ -5572,18 +5249,17 @@ Ghostscript. For example, if <samp>foo.tex</samp> is a TeX file using HyperTeX commands, then </p> <div class="example"> -<pre class="example">prompt$ tex foo.tex -prompt$ dvips -z foo.dvi -o -prompt$ ps2pdf foo.ps +<pre class="example">$ tex foo.tex +$ dvips -z foo.dvi -o +$ ps2pdf foo.ps </pre></div> <p>will produce <samp>foo.pdf</samp> with hyperlinks. </p> </dd> -<dt><code>dvipdfm</code></dt> -<dt><code>dvipdfmx</code></dt> -<dd><span id="index-dvipdfm-2"></span> -<p>No special command line arguments are required, these programs +<dt id='index-dvipdfm-2'><span><code>dvipdfm</code><a href='#index-dvipdfm-2' class='copiable-anchor'> ¶</a></span></dt> +<dt><span><code>dvipdfmx</code></span></dt> +<dd><p>No special command line arguments are required, these programs automatically detect the HyperTeX commands. </p> </dd> @@ -5598,25 +5274,22 @@ destination, so that “exact” linking to destinations is not possible (this was confirmed to be a bug and most probably has already been fixed in later versions of dvips(k)); dvipdfm as of version 0.13.2c and dvipdfmx as of version 20040411 do not correctly parse links to -external local files, and produce a <acronym>URL</acronym> link instead of a +external local files, and produce a url link instead of a file link. </p> -<table class="menu" border="0" cellspacing="0"> -<tr><td align="left" valign="top">• <a href="#Destination-types-for-hypertex" accesskey="1">Destination types for hypertex</a></td><td> </td><td align="left" valign="top"> -</td></tr> -<tr><td align="left" valign="top">• <a href="#Destination-options-for-hypertex" accesskey="2">Destination options for hypertex</a></td><td> </td><td align="left" valign="top"> -</td></tr> -<tr><td align="left" valign="top">• <a href="#Link-types-for-hypertex" accesskey="3">Link types for hypertex</a></td><td> </td><td align="left" valign="top"> -</td></tr> -<tr><td align="left" valign="top">• <a href="#Link-options-for-hypertex" accesskey="4">Link options for hypertex</a></td><td> </td><td align="left" valign="top"> -</td></tr> -</table> +<ul class="section-toc"> +<li><a href="#Destination-types-for-hypertex" accesskey="1">Destination types for <code>hypertex</code></a></li> +<li><a href="#Destination-options-for-hypertex" accesskey="2">Destination options for <code>hypertex</code></a></li> +<li><a href="#Link-types-for-hypertex" accesskey="3">Link types for <code>hypertex</code></a></li> +<li><a href="#Link-options-for-hypertex" accesskey="4">Link options for <code>hypertex</code></a></li> +</ul> <hr> -<span id="Destination-types-for-hypertex"></span><div class="header"> +<div class="subsubsection" id="Destination-types-for-hypertex"> +<div class="header"> <p> -Next: <a href="#Destination-options-for-hypertex" accesskey="n" rel="next">Destination options for hypertex</a>, Up: <a href="#Hyperlink-driver-hypertex" accesskey="u" rel="up">Hyperlink driver hypertex</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Macro-index" title="Index" rel="index">Index</a>]</p> +Next: <a href="#Destination-options-for-hypertex" accesskey="n" rel="next">Destination options for <code>hypertex</code></a>, Up: <a href="#Hyperlink-driver-hypertex" accesskey="u" rel="up">Hyperlink driver <code>hypertex</code></a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Macro-index" title="Index" rel="index">Index</a>]</p> </div> <span id="Destination-types-for-hypertex-1"></span><h4 class="subsubsection">5.4.2.1 Destination types for <code>hypertex</code></h4> @@ -5624,16 +5297,14 @@ Next: <a href="#Destination-options-for-hypertex" accesskey="n" rel="next">Desti <span id="index-types_002c-destination_002c-hypertex"></span> <span id="index-hypertex_002c-destination-types"></span> <dl compact="compact"> -<dt><code>xyz</code></dt> -<dd><span id="index-xyz-_0028destination-type_0029"></span> -<p>“Current position”. This is the default type. +<dt id='index-xyz-_0028destination-type_0029'><span><code>xyz</code><a href='#index-xyz-_0028destination-type_0029' class='copiable-anchor'> ¶</a></span></dt> +<dd><p>“Current position”. This is the default type. </p> <p>Example: <code>\hldest{xyz}{}{dest123}</code> </p> </dd> -<dt><code>raw</code></dt> -<dd><span id="index-raw-_0028destination-type_0029"></span> -<p>The destination specification (in the form of a HyperTeX +<dt id='index-raw-_0028destination-type_0029'><span><code>raw</code><a href='#index-raw-_0028destination-type_0029' class='copiable-anchor'> ¶</a></span></dt> +<dd><p>The destination specification (in the form of a HyperTeX <code>\special</code>) is taken from the command sequence <code>\<var>cs</var></code>, where <var>cs</var> is the value of the <span id="index-cmd-_0028destination-option_0029"></span> @@ -5660,9 +5331,11 @@ intended to be used with destgroups (see <a href="#Setting-hyperlink-types-and-o <hr> -<span id="Destination-options-for-hypertex"></span><div class="header"> +</div> +<div class="subsubsection" id="Destination-options-for-hypertex"> +<div class="header"> <p> -Next: <a href="#Link-types-for-hypertex" accesskey="n" rel="next">Link types for hypertex</a>, Previous: <a href="#Destination-types-for-hypertex" accesskey="p" rel="prev">Destination types for hypertex</a>, Up: <a href="#Hyperlink-driver-hypertex" accesskey="u" rel="up">Hyperlink driver hypertex</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Macro-index" title="Index" rel="index">Index</a>]</p> +Next: <a href="#Link-types-for-hypertex" accesskey="n" rel="next">Link types for <code>hypertex</code></a>, Previous: <a href="#Destination-types-for-hypertex" accesskey="p" rel="prev">Destination types for <code>hypertex</code></a>, Up: <a href="#Hyperlink-driver-hypertex" accesskey="u" rel="up">Hyperlink driver <code>hypertex</code></a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Macro-index" title="Index" rel="index">Index</a>]</p> </div> <span id="Destination-options-for-hypertex-1"></span><h4 class="subsubsection">5.4.2.2 Destination options for <code>hypertex</code></h4> @@ -5670,21 +5343,22 @@ Next: <a href="#Link-types-for-hypertex" accesskey="n" rel="next">Link types for <span id="index-options_002c-destination_002c-hypertex"></span> <span id="index-hypertex_002c-destination-options"></span> <dl compact="compact"> -<dt><code>cmd</code></dt> -<dd><span id="index-cmd-_0028destination-option_0029-1"></span> -<p>Name of the macro (without the leading ‘<samp>\</samp>’) containing a +<dt id='index-cmd-_0028destination-option_0029-1'><span><code>cmd</code><a href='#index-cmd-_0028destination-option_0029-1' class='copiable-anchor'> ¶</a></span></dt> +<dd><p>Name of the macro (without the leading ‘<samp>\</samp>’) containing a HyperTeX <code>\special</code> for the <code>raw</code> destination. </p> -<p>See <a href="#Destination-types-for-hypertex">Destination types for hypertex</a>, the description of the <code>raw</code> +<p>See <a href="#Destination-types-for-hypertex">Destination types for <code>hypertex</code></a>, the description of the <code>raw</code> destination, for an example. </p></dd> </dl> <hr> -<span id="Link-types-for-hypertex"></span><div class="header"> +</div> +<div class="subsubsection" id="Link-types-for-hypertex"> +<div class="header"> <p> -Next: <a href="#Link-options-for-hypertex" accesskey="n" rel="next">Link options for hypertex</a>, Previous: <a href="#Destination-options-for-hypertex" accesskey="p" rel="prev">Destination options for hypertex</a>, Up: <a href="#Hyperlink-driver-hypertex" accesskey="u" rel="up">Hyperlink driver hypertex</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Macro-index" title="Index" rel="index">Index</a>]</p> +Next: <a href="#Link-options-for-hypertex" accesskey="n" rel="next">Link options for <code>hypertex</code></a>, Previous: <a href="#Destination-options-for-hypertex" accesskey="p" rel="prev">Destination options for <code>hypertex</code></a>, Up: <a href="#Hyperlink-driver-hypertex" accesskey="u" rel="up">Hyperlink driver <code>hypertex</code></a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Macro-index" title="Index" rel="index">Index</a>]</p> </div> <span id="Link-types-for-hypertex-1"></span><h4 class="subsubsection">5.4.2.3 Link types for <code>hypertex</code></h4> @@ -5692,9 +5366,8 @@ Next: <a href="#Link-options-for-hypertex" accesskey="n" rel="next">Link options <span id="index-types_002c-link_002c-hypertex"></span> <span id="index-hypertex_002c-link-types"></span> <dl compact="compact"> -<dt><code>name</code></dt> -<dd><span id="index-name-_0028hyperlink-type_0029"></span> -<span id="index-named-destination"></span> +<dt id='index-name-_0028hyperlink-type_0029'><span><code>name</code><a href='#index-name-_0028hyperlink-type_0029' class='copiable-anchor'> ¶</a></span></dt> +<dd><span id="index-named-destination"></span> <span id="index-destinations_002c-named"></span> <span id="index-hyperlink-destination_002c-named"></span> <p>Go to a “named destination”. The label is the destination name. All @@ -5704,12 +5377,11 @@ type. <p>Example: <code>\hlstart{name}{}{dest123}Link to dest123\hlend</code> </p> </dd> -<dt><code>url</code></dt> -<dd><span id="index-url-_0028hyperlink-type_0029"></span> -<span id="index-URL-hyperlink-2"></span> -<span id="index-destinations_002c-URL"></span> -<span id="index-hyperlinks_002c-URL-2"></span> -<p>Go to a <acronym>URL</acronym>. The label is the <acronym>URL</acronym>. +<dt id='index-url-_0028hyperlink-type_0029'><span><code>url</code><a href='#index-url-_0028hyperlink-type_0029' class='copiable-anchor'> ¶</a></span></dt> +<dd><span id="index-url-hyperlink-2"></span> +<span id="index-destinations_002c-url"></span> +<span id="index-hyperlinks_002c-url-2"></span> +<p>Go to a url. The label is the url. </p> <p>Example: </p> @@ -5718,9 +5390,8 @@ type. </pre></div> </dd> -<dt><code>filename</code></dt> -<dd><span id="index-filename-_0028hyperlink-type_0029"></span> -<span id="index-file_002c-hyperlink-to"></span> +<dt id='index-filename-_0028hyperlink-type_0029'><span><code>filename</code><a href='#index-filename-_0028hyperlink-type_0029' class='copiable-anchor'> ¶</a></span></dt> +<dd><span id="index-file_002c-hyperlink-to"></span> <span id="index-destinations_002c-in-another-file"></span> <span id="index-hyperlinks_002c-to-another-file"></span> <p>Go to a named destination in another file. The label is the @@ -5732,8 +5403,8 @@ by the <code>ext</code> option. The idea is to set the <code>ext</code> option globally at the beginning of the document to avoid hard-coding the extension together with the file name within each link—HyperTeX is not -restricted to any single output format, it can be <acronym>DVI</acronym>, -<acronym>PDF</acronym>, possibly other formats. +restricted to any single output format, it can be DVI, +PDF, possibly other formats. </p> <p>Example: </p> @@ -5744,9 +5415,8 @@ restricted to any single output format, it can be <acronym>DVI</acronym>, </pre></div> </dd> -<dt><code>raw</code></dt> -<dd><span id="index-raw-_0028hyperlink-type_0029"></span> -<p>The link specification (in the form of a HyperTeX <code>\special</code>) is +<dt id='index-raw-_0028hyperlink-type_0029'><span><code>raw</code><a href='#index-raw-_0028hyperlink-type_0029' class='copiable-anchor'> ¶</a></span></dt> +<dd><p>The link specification (in the form of a HyperTeX <code>\special</code>) is taken from the command sequence <code>\<var>cs</var></code>, where <var>cs</var> is the value of the <span id="index-cmd-_0028hyperlink-option_0029"></span> @@ -5775,9 +5445,11 @@ intended to be used with linkgroups (see <a href="#Setting-hyperlink-types-and-o <hr> -<span id="Link-options-for-hypertex"></span><div class="header"> +</div> +<div class="subsubsection" id="Link-options-for-hypertex"> +<div class="header"> <p> -Previous: <a href="#Link-types-for-hypertex" accesskey="p" rel="prev">Link types for hypertex</a>, Up: <a href="#Hyperlink-driver-hypertex" accesskey="u" rel="up">Hyperlink driver hypertex</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Macro-index" title="Index" rel="index">Index</a>]</p> +Previous: <a href="#Link-types-for-hypertex" accesskey="p" rel="prev">Link types for <code>hypertex</code></a>, Up: <a href="#Hyperlink-driver-hypertex" accesskey="u" rel="up">Hyperlink driver <code>hypertex</code></a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Macro-index" title="Index" rel="index">Index</a>]</p> </div> <span id="Link-options-for-hypertex-1"></span><h4 class="subsubsection">5.4.2.4 Link options for <code>hypertex</code></h4> @@ -5785,42 +5457,42 @@ Previous: <a href="#Link-types-for-hypertex" accesskey="p" rel="prev">Link types <span id="index-options_002c-link_002c-hypertex"></span> <span id="index-hypertex_002c-link-options"></span> <dl compact="compact"> -<dt><code>cmd</code></dt> -<dd><span id="index-cmd-_0028hyperlink-option_0029-1"></span> -<p>Name of the macro (without the leading ‘<samp>\</samp>’) containing a +<dt id='index-cmd-_0028hyperlink-option_0029-1'><span><code>cmd</code><a href='#index-cmd-_0028hyperlink-option_0029-1' class='copiable-anchor'> ¶</a></span></dt> +<dd><p>Name of the macro (without the leading ‘<samp>\</samp>’) containing a HyperTeX <code>\special</code> for the <code>raw</code> link. </p> -<p>See <a href="#Link-types-for-hypertex">Link types for hypertex</a>, the description of the <code>raw</code> link, +<p>See <a href="#Link-types-for-hypertex">Link types for <code>hypertex</code></a>, the description of the <code>raw</code> link, for an example. </p> </dd> -<dt><code>file</code></dt> -<dd><span id="index-file-_0028hyperlink-option_0029-1"></span> -<p>File name for the <code>filename</code> link type. See also the <code>ext</code> +<dt id='index-file-_0028hyperlink-option_0029-1'><span><code>file</code><a href='#index-file-_0028hyperlink-option_0029-1' class='copiable-anchor'> ¶</a></span></dt> +<dd><p>File name for the <code>filename</code> link type. See also the <code>ext</code> option. </p> -<p>See <a href="#Link-types-for-hypertex">Link types for hypertex</a>, the description of the <code>filename</code> +<p>See <a href="#Link-types-for-hypertex">Link types for <code>hypertex</code></a>, the description of the <code>filename</code> link, for an example. </p> </dd> -<dt><code>ext</code></dt> -<dd><span id="index-ext-_0028hyperlink-option_0029-1"></span> -<p>File name extension for the <code>filename</code> link type. The idea is to +<dt id='index-ext-_0028hyperlink-option_0029-1'><span><code>ext</code><a href='#index-ext-_0028hyperlink-option_0029-1' class='copiable-anchor'> ¶</a></span></dt> +<dd><p>File name extension for the <code>filename</code> link type. The idea is to set the <code>ext</code> option globally at the beginning of the document to avoid hard-coding the extension together with the file name within each link—HyperTeX is not restricted to any single output format, it can -be <acronym>DVI</acronym>, <acronym>PDF</acronym>, possibly other formats. +be DVI, PDF, possibly other formats. </p> -<p>See <a href="#Link-types-for-hypertex">Link types for hypertex</a>, the description of the <code>filename</code> +<p>See <a href="#Link-types-for-hypertex">Link types for <code>hypertex</code></a>, the description of the <code>filename</code> link, for an example. </p></dd> </dl> <hr> -<span id="Hyperlink-drivers-pdftex-and-dvipdfm"></span><div class="header"> +</div> +</div> +<div class="subsection" id="Hyperlink-drivers-pdftex-and-dvipdfm"> +<div class="header"> <p> -Next: <a href="#Hyperlink-driver-nolinks" accesskey="n" rel="next">Hyperlink driver nolinks</a>, Previous: <a href="#Hyperlink-driver-hypertex" accesskey="p" rel="prev">Hyperlink driver hypertex</a>, Up: <a href="#Hyperlink-drivers" accesskey="u" rel="up">Hyperlink drivers</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Macro-index" title="Index" rel="index">Index</a>]</p> +Next: <a href="#Hyperlink-driver-nolinks" accesskey="n" rel="next">Hyperlink driver <code>nolinks</code></a>, Previous: <a href="#Hyperlink-driver-hypertex" accesskey="p" rel="prev">Hyperlink driver <code>hypertex</code></a>, Up: <a href="#Hyperlink-drivers" accesskey="u" rel="up">Hyperlink drivers</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Macro-index" title="Index" rel="index">Index</a>]</p> </div> <span id="Hyperlink-drivers-pdftex-and-dvipdfm-1"></span><h4 class="subsection">5.4.3 Hyperlink drivers <code>pdftex</code> and <code>dvipdfm</code></h4> @@ -5837,22 +5509,19 @@ supported by the <code>pdftex</code> and <code>dvipdfm</code> drivers. Many of hyperlink types and options are common to both drivers, so we describe them together. </p> -<table class="menu" border="0" cellspacing="0"> -<tr><td align="left" valign="top">• <a href="#Destination-types-for-pdftex-and-dvipdfm" accesskey="1">Destination types for pdftex and dvipdfm</a></td><td> </td><td align="left" valign="top"> -</td></tr> -<tr><td align="left" valign="top">• <a href="#Destination-options-for-pdftex-and-dvipdfm" accesskey="2">Destination options for pdftex and dvipdfm</a></td><td> </td><td align="left" valign="top"> -</td></tr> -<tr><td align="left" valign="top">• <a href="#Link-types-for-pdftex-and-dvipdfm" accesskey="3">Link types for pdftex and dvipdfm</a></td><td> </td><td align="left" valign="top"> -</td></tr> -<tr><td align="left" valign="top">• <a href="#Link-options-for-pdftex-and-dvipdfm" accesskey="4">Link options for pdftex and dvipdfm</a></td><td> </td><td align="left" valign="top"> -</td></tr> -</table> +<ul class="section-toc"> +<li><a href="#Destination-types-for-pdftex-and-dvipdfm" accesskey="1">Destination types for <code>pdftex</code> and <code>dvipdfm</code></a></li> +<li><a href="#Destination-options-for-pdftex-and-dvipdfm" accesskey="2">Destination options for <code>pdftex</code> and <code>dvipdfm</code></a></li> +<li><a href="#Link-types-for-pdftex-and-dvipdfm" accesskey="3">Link types for <code>pdftex</code> and <code>dvipdfm</code></a></li> +<li><a href="#Link-options-for-pdftex-and-dvipdfm" accesskey="4">Link options for <code>pdftex</code> and <code>dvipdfm</code></a></li> +</ul> <hr> -<span id="Destination-types-for-pdftex-and-dvipdfm"></span><div class="header"> +<div class="subsubsection" id="Destination-types-for-pdftex-and-dvipdfm"> +<div class="header"> <p> -Next: <a href="#Destination-options-for-pdftex-and-dvipdfm" accesskey="n" rel="next">Destination options for pdftex and dvipdfm</a>, Up: <a href="#Hyperlink-drivers-pdftex-and-dvipdfm" accesskey="u" rel="up">Hyperlink drivers pdftex and dvipdfm</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Macro-index" title="Index" rel="index">Index</a>]</p> +Next: <a href="#Destination-options-for-pdftex-and-dvipdfm" accesskey="n" rel="next">Destination options for <code>pdftex</code> and <code>dvipdfm</code></a>, Up: <a href="#Hyperlink-drivers-pdftex-and-dvipdfm" accesskey="u" rel="up">Hyperlink drivers <code>pdftex</code> and <code>dvipdfm</code></a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Macro-index" title="Index" rel="index">Index</a>]</p> </div> <span id="Destination-types-for-pdftex-and-dvipdfm-1"></span><h4 class="subsubsection">5.4.3.1 Destination types for <code>pdftex</code> and <code>dvipdfm</code></h4> @@ -5863,9 +5532,8 @@ Next: <a href="#Destination-options-for-pdftex-and-dvipdfm" accesskey="n" rel="n <span id="index-pdftex_002c-destination-types"></span> <span id="index-dvipdfm_002c-destination-types"></span> <dl compact="compact"> -<dt><code>xyz</code></dt> -<dd><span id="index-xyz-_0028destination-type_0029-1"></span> -<p>“Current position”. The option +<dt id='index-xyz-_0028destination-type_0029-1'><span><code>xyz</code><a href='#index-xyz-_0028destination-type_0029-1' class='copiable-anchor'> ¶</a></span></dt> +<dd><p>“Current position”. The option <span id="index-zoom-_0028destination-option_0029"></span> <code>zoom</code> specifies magnification to use (zero or empty means leave magnification unchanged, which is the default). This is the default @@ -5881,16 +5549,14 @@ current position coordinate, which is the default). <p>Example: <code>\hldest{xyz}{zoom=2000}{dest123}</code> </p> </dd> -<dt><code>fit</code></dt> -<dd><span id="index-fit-_0028destination-type_0029"></span> -<p>Fit the page to the window. +<dt id='index-fit-_0028destination-type_0029'><span><code>fit</code><a href='#index-fit-_0028destination-type_0029' class='copiable-anchor'> ¶</a></span></dt> +<dd><p>Fit the page to the window. </p> <p>Example: <code>\hldest{fit}{}{dest123}</code> </p> </dd> -<dt><code>fith</code></dt> -<dd><span id="index-fith-_0028destination-type_0029"></span> -<p>Fit the width of the page to the window. +<dt id='index-fith-_0028destination-type_0029'><span><code>fith</code><a href='#index-fith-_0028destination-type_0029' class='copiable-anchor'> ¶</a></span></dt> +<dd><p>Fit the width of the page to the window. </p> <p>For <code>dvipdfm</code>: the <span id="index-top-_0028destination-option_0029-1"></span> @@ -5900,9 +5566,8 @@ current position). <p>Example: <code>\hldest{fith}{}{dest123}</code> </p> </dd> -<dt><code>fitv</code></dt> -<dd><span id="index-fitv-_0028destination-type_0029"></span> -<p>Fit the height of the page to the window. +<dt id='index-fitv-_0028destination-type_0029'><span><code>fitv</code><a href='#index-fitv-_0028destination-type_0029' class='copiable-anchor'> ¶</a></span></dt> +<dd><p>Fit the height of the page to the window. </p> <p>For <code>dvipdfm</code>: The option <span id="index-left-_0028destination-option_0029-1"></span> @@ -5912,16 +5577,14 @@ current position). <p>Example: <code>\hldest{fitv}{}{dest123}</code> </p> </dd> -<dt><code>fitb</code></dt> -<dd><span id="index-fitb-_0028destination-type_0029"></span> -<p>Fit the page’s bounding box to the window. +<dt id='index-fitb-_0028destination-type_0029'><span><code>fitb</code><a href='#index-fitb-_0028destination-type_0029' class='copiable-anchor'> ¶</a></span></dt> +<dd><p>Fit the page’s bounding box to the window. </p> <p>Example: <code>\hldest{fitb}{}{dest123}</code> </p> </dd> -<dt><code>fitbh</code></dt> -<dd><span id="index-fitbh-_0028destination-type_0029"></span> -<p>Fit the width of the page’s bounding box to the window. +<dt id='index-fitbh-_0028destination-type_0029'><span><code>fitbh</code><a href='#index-fitbh-_0028destination-type_0029' class='copiable-anchor'> ¶</a></span></dt> +<dd><p>Fit the width of the page’s bounding box to the window. </p> <p>For <code>dvipdfm</code>: the option <span id="index-top-_0028destination-option_0029-2"></span> @@ -5931,9 +5594,8 @@ current position). <p>Example: <code>\hldest{fitbh}{}{dest123}</code> </p> </dd> -<dt><code>fitbv</code></dt> -<dd><span id="index-fitbv-_0028destination-type_0029"></span> -<p>Fit the height of the page’s bounding box to the window. +<dt id='index-fitbv-_0028destination-type_0029'><span><code>fitbv</code><a href='#index-fitbv-_0028destination-type_0029' class='copiable-anchor'> ¶</a></span></dt> +<dd><p>Fit the height of the page’s bounding box to the window. </p> <p>For <code>dvipdfm</code>: the option <span id="index-left-_0028destination-option_0029-2"></span> @@ -5943,9 +5605,8 @@ current position). <p>Example: <code>\hldest{fitbv}{}{dest123}</code> </p> </dd> -<dt><code>fitr</code></dt> -<dd><span id="index-fitr-_0028destination-type_0029"></span> -<p>For <code>pdftex</code>: fit the rectangle specified by the options +<dt id='index-fitr-_0028destination-type_0029'><span><code>fitr</code><a href='#index-fitr-_0028destination-type_0029' class='copiable-anchor'> ¶</a></span></dt> +<dd><p>For <code>pdftex</code>: fit the rectangle specified by the options <span id="index-width-_0028destination-option_0029"></span> <code>width</code>, <span id="index-height-_0028destination-option_0029"></span> @@ -5984,9 +5645,8 @@ dimensions set to empty, current position coordinate is substituted </pre></div> </dd> -<dt><code>raw</code></dt> -<dd><span id="index-raw-_0028destination-type_0029-1"></span> -<p>The destination specification (in the form of a pdfTeX command or a +<dt id='index-raw-_0028destination-type_0029-1'><span><code>raw</code><a href='#index-raw-_0028destination-type_0029-1' class='copiable-anchor'> ¶</a></span></dt> +<dd><p>The destination specification (in the form of a pdfTeX command or a dvipdfm <code>\special</code>) is taken from the command sequence <code>\<var>cs</var></code>, where <var>cs</var> is the value of the <span id="index-cmd-_0028destination-option_0029-2"></span> @@ -6022,9 +5682,11 @@ intended to be used with destgroups (see <a href="#Setting-hyperlink-types-and-o <hr> -<span id="Destination-options-for-pdftex-and-dvipdfm"></span><div class="header"> +</div> +<div class="subsubsection" id="Destination-options-for-pdftex-and-dvipdfm"> +<div class="header"> <p> -Next: <a href="#Link-types-for-pdftex-and-dvipdfm" accesskey="n" rel="next">Link types for pdftex and dvipdfm</a>, Previous: <a href="#Destination-types-for-pdftex-and-dvipdfm" accesskey="p" rel="prev">Destination types for pdftex and dvipdfm</a>, Up: <a href="#Hyperlink-drivers-pdftex-and-dvipdfm" accesskey="u" rel="up">Hyperlink drivers pdftex and dvipdfm</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Macro-index" title="Index" rel="index">Index</a>]</p> +Next: <a href="#Link-types-for-pdftex-and-dvipdfm" accesskey="n" rel="next">Link types for <code>pdftex</code> and <code>dvipdfm</code></a>, Previous: <a href="#Destination-types-for-pdftex-and-dvipdfm" accesskey="p" rel="prev">Destination types for <code>pdftex</code> and <code>dvipdfm</code></a>, Up: <a href="#Hyperlink-drivers-pdftex-and-dvipdfm" accesskey="u" rel="up">Hyperlink drivers <code>pdftex</code> and <code>dvipdfm</code></a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Macro-index" title="Index" rel="index">Index</a>]</p> </div> <span id="Destination-options-for-pdftex-and-dvipdfm-1"></span><h4 class="subsubsection">5.4.3.2 Destination options for <code>pdftex</code> and <code>dvipdfm</code></h4> @@ -6043,19 +5705,17 @@ Next: <a href="#Link-types-for-pdftex-and-dvipdfm" accesskey="n" rel="next">Link <span id="Common-destination-options"></span><h4 class="subsubheading">Common destination options</h4> <dl compact="compact"> -<dt><code>cmd</code></dt> -<dd><span id="index-cmd-_0028destination-option_0029-3"></span> -<p>Name of the macro (without the leading ‘<samp>\</samp>’) containing a +<dt id='index-cmd-_0028destination-option_0029-3'><span><code>cmd</code><a href='#index-cmd-_0028destination-option_0029-3' class='copiable-anchor'> ¶</a></span></dt> +<dd><p>Name of the macro (without the leading ‘<samp>\</samp>’) containing a pdfTeX command or a dvipdfm <code>\special</code> for the <code>raw</code> destination. </p> -<p>See <a href="#Destination-types-for-pdftex-and-dvipdfm">Destination types for pdftex and dvipdfm</a>, the description of the +<p>See <a href="#Destination-types-for-pdftex-and-dvipdfm">Destination types for <code>pdftex</code> and <code>dvipdfm</code></a>, the description of the <code>raw</code> destination, for an example. </p> </dd> -<dt><code>zoom</code></dt> -<dd><span id="index-zoom-_0028destination-option_0029-1"></span> -<span id="index-destinations_002c-magnification"></span> +<dt id='index-zoom-_0028destination-option_0029-1'><span><code>zoom</code><a href='#index-zoom-_0028destination-option_0029-1' class='copiable-anchor'> ¶</a></span></dt> +<dd><span id="index-destinations_002c-magnification"></span> <span id="index-hyperlink-destination_002c-magnification"></span> <span id="index-magnification_002c-hyperlink-destination"></span> <span id="index-zooming_002c-hyperlink-destination"></span> @@ -6076,25 +5736,22 @@ of the parent box is used (this is the default for all dimension options). </p> <dl compact="compact"> -<dt><code>depth</code></dt> -<dd><span id="index-depth-_0028destination-option_0029-1"></span> -<span id="index-destinations_002c-dimensions"></span> +<dt id='index-depth-_0028destination-option_0029-1'><span><code>depth</code><a href='#index-depth-_0028destination-option_0029-1' class='copiable-anchor'> ¶</a></span></dt> +<dd><span id="index-destinations_002c-dimensions"></span> <span id="index-hyperlink-destination_002c-dimensions"></span> <span id="index-dimensions_002c-hyperlink-destination"></span> <p>Depth of the fit rectangle for the <code>fitr</code> destination. </p> </dd> -<dt><code>height</code></dt> -<dd><span id="index-height-_0028destination-option_0029-1"></span> -<span id="index-destinations_002c-dimensions-1"></span> +<dt id='index-height-_0028destination-option_0029-1'><span><code>height</code><a href='#index-height-_0028destination-option_0029-1' class='copiable-anchor'> ¶</a></span></dt> +<dd><span id="index-destinations_002c-dimensions-1"></span> <span id="index-hyperlink-destination_002c-dimensions-1"></span> <span id="index-dimensions_002c-hyperlink-destination-1"></span> <p>Height of the fit rectangle for the <code>fitr</code> destination. </p> </dd> -<dt><code>width</code></dt> -<dd><span id="index-width-_0028destination-option_0029-1"></span> -<span id="index-destinations_002c-dimensions-2"></span> +<dt id='index-width-_0028destination-option_0029-1'><span><code>width</code><a href='#index-width-_0028destination-option_0029-1' class='copiable-anchor'> ¶</a></span></dt> +<dd><span id="index-destinations_002c-dimensions-2"></span> <span id="index-hyperlink-destination_002c-dimensions-2"></span> <span id="index-dimensions_002c-hyperlink-destination-2"></span> <p>Width of the fit rectangle for the <code>fitr</code> destination. @@ -6118,36 +5775,32 @@ PostScript points (72 points per inch), as a number without the coordinate is used (this is the default for all dimension options). </p> <dl compact="compact"> -<dt><code>bottom</code></dt> -<dd><span id="index-bottom-_0028destination-option_0029-1"></span> -<span id="index-destinations_002c-dimensions-3"></span> +<dt id='index-bottom-_0028destination-option_0029-1'><span><code>bottom</code><a href='#index-bottom-_0028destination-option_0029-1' class='copiable-anchor'> ¶</a></span></dt> +<dd><span id="index-destinations_002c-dimensions-3"></span> <span id="index-hyperlink-destination_002c-dimensions-3"></span> <span id="index-dimensions_002c-hyperlink-destination-3"></span> <p>Bottom position coordinate of a box specification for the various destination types. </p> </dd> -<dt><code>left</code></dt> -<dd><span id="index-left-_0028destination-option_0029-4"></span> -<span id="index-destinations_002c-dimensions-4"></span> +<dt id='index-left-_0028destination-option_0029-4'><span><code>left</code><a href='#index-left-_0028destination-option_0029-4' class='copiable-anchor'> ¶</a></span></dt> +<dd><span id="index-destinations_002c-dimensions-4"></span> <span id="index-hyperlink-destination_002c-dimensions-4"></span> <span id="index-dimensions_002c-hyperlink-destination-4"></span> <p>Left position coordinate of a box specification for the various destination types. </p> </dd> -<dt><code>right</code></dt> -<dd><span id="index-right-_0028destination-option_0029-1"></span> -<span id="index-destinations_002c-dimensions-5"></span> +<dt id='index-right-_0028destination-option_0029-1'><span><code>right</code><a href='#index-right-_0028destination-option_0029-1' class='copiable-anchor'> ¶</a></span></dt> +<dd><span id="index-destinations_002c-dimensions-5"></span> <span id="index-hyperlink-destination_002c-dimensions-5"></span> <span id="index-dimensions_002c-hyperlink-destination-5"></span> <p>Right position coordinate of a box specification for the various destination types. </p> </dd> -<dt><code>top</code></dt> -<dd><span id="index-top-_0028destination-option_0029-4"></span> -<span id="index-destinations_002c-dimensions-6"></span> +<dt id='index-top-_0028destination-option_0029-4'><span><code>top</code><a href='#index-top-_0028destination-option_0029-4' class='copiable-anchor'> ¶</a></span></dt> +<dd><span id="index-destinations_002c-dimensions-6"></span> <span id="index-hyperlink-destination_002c-dimensions-6"></span> <span id="index-dimensions_002c-hyperlink-destination-6"></span> <p>Top position coordinate of a box specification for the various @@ -6164,9 +5817,11 @@ destination types. <hr> -<span id="Link-types-for-pdftex-and-dvipdfm"></span><div class="header"> +</div> +<div class="subsubsection" id="Link-types-for-pdftex-and-dvipdfm"> +<div class="header"> <p> -Next: <a href="#Link-options-for-pdftex-and-dvipdfm" accesskey="n" rel="next">Link options for pdftex and dvipdfm</a>, Previous: <a href="#Destination-options-for-pdftex-and-dvipdfm" accesskey="p" rel="prev">Destination options for pdftex and dvipdfm</a>, Up: <a href="#Hyperlink-drivers-pdftex-and-dvipdfm" accesskey="u" rel="up">Hyperlink drivers pdftex and dvipdfm</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Macro-index" title="Index" rel="index">Index</a>]</p> +Next: <a href="#Link-options-for-pdftex-and-dvipdfm" accesskey="n" rel="next">Link options for <code>pdftex</code> and <code>dvipdfm</code></a>, Previous: <a href="#Destination-options-for-pdftex-and-dvipdfm" accesskey="p" rel="prev">Destination options for <code>pdftex</code> and <code>dvipdfm</code></a>, Up: <a href="#Hyperlink-drivers-pdftex-and-dvipdfm" accesskey="u" rel="up">Hyperlink drivers <code>pdftex</code> and <code>dvipdfm</code></a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Macro-index" title="Index" rel="index">Index</a>]</p> </div> <span id="Link-types-for-pdftex-and-dvipdfm-1"></span><h4 class="subsubsection">5.4.3.3 Link types for <code>pdftex</code> and <code>dvipdfm</code></h4> @@ -6188,9 +5843,8 @@ low-level pdfTeX commands. <span id="Common-link-types"></span><h4 class="subsubheading">Common link types</h4> <dl compact="compact"> -<dt><code>name</code></dt> -<dd><span id="index-name-_0028hyperlink-type_0029-1"></span> -<span id="index-named-destination-1"></span> +<dt id='index-name-_0028hyperlink-type_0029-1'><span><code>name</code><a href='#index-name-_0028hyperlink-type_0029-1' class='copiable-anchor'> ¶</a></span></dt> +<dd><span id="index-named-destination-1"></span> <span id="index-destinations_002c-named-1"></span> <span id="index-hyperlink-destination_002c-named-1"></span> <p>Go to a “named destination”. The label is the destination name. @@ -6200,19 +5854,17 @@ All destinations created with <code>\hldest</code> are named destinations <p>Example: <code>\hlstart{name}{}{dest123}Link to dest123\hlend</code> </p> </dd> -<dt><code>url</code></dt> -<dd><span id="index-url-_0028hyperlink-type_0029-1"></span> -<span id="index-URL-hyperlink-3"></span> -<span id="index-destinations_002c-URL-1"></span> -<span id="index-hyperlinks_002c-URL-3"></span> -<p>Go to a <acronym>URL</acronym>. The label is the <acronym>URL</acronym>. +<dt id='index-url-_0028hyperlink-type_0029-1'><span><code>url</code><a href='#index-url-_0028hyperlink-type_0029-1' class='copiable-anchor'> ¶</a></span></dt> +<dd><span id="index-url-hyperlink-3"></span> +<span id="index-destinations_002c-url-1"></span> +<span id="index-hyperlinks_002c-url-3"></span> +<p>Go to a url. The label is the url. </p> <p>Example: <code>\hlstart{url}{}{https://tug.org/eplain/}Eplain home\hlend</code> </p> </dd> -<dt><code>page</code></dt> -<dd><span id="index-page-_0028hyperlink-type_0029"></span> -<span id="index-page-destination"></span> +<dt id='index-page-_0028hyperlink-type_0029'><span><code>page</code><a href='#index-page-_0028hyperlink-type_0029' class='copiable-anchor'> ¶</a></span></dt> +<dd><span id="index-page-destination"></span> <span id="index-destinations_002c-page"></span> <span id="index-hyperlink-destination_002c-page"></span> <p>Go to a page. The label is the page number (counting from 1). @@ -6228,9 +5880,8 @@ Page fitting is specified by the </pre></div> </dd> -<dt><code>filename</code></dt> -<dd><span id="index-filename-_0028hyperlink-type_0029-1"></span> -<span id="index-file_002c-hyperlink-to-1"></span> +<dt id='index-filename-_0028hyperlink-type_0029-1'><span><code>filename</code><a href='#index-filename-_0028hyperlink-type_0029-1' class='copiable-anchor'> ¶</a></span></dt> +<dd><span id="index-file_002c-hyperlink-to-1"></span> <span id="index-destinations_002c-in-another-file-1"></span> <span id="index-hyperlinks_002c-to-another-file-1"></span> <p>Go to a named destination in another file. The label is the @@ -6251,9 +5902,8 @@ opened in the same window or in a new window. </pre></div> </dd> -<dt><code>filepage</code></dt> -<dd><span id="index-filepage-_0028hyperlink-type_0029"></span> -<span id="index-file_002c-hyperlink-to-2"></span> +<dt id='index-filepage-_0028hyperlink-type_0029'><span><code>filepage</code><a href='#index-filepage-_0028hyperlink-type_0029' class='copiable-anchor'> ¶</a></span></dt> +<dd><span id="index-file_002c-hyperlink-to-2"></span> <span id="index-destinations_002c-in-another-file-2"></span> <span id="index-hyperlinks_002c-to-another-file-2"></span> <p>Go to a page in another file. The label is the page number (counting @@ -6275,9 +5925,8 @@ opened in the same window or in a new window. </pre></div> </dd> -<dt><code>raw</code></dt> -<dd><span id="index-raw-_0028hyperlink-type_0029-1"></span> -<p>The link specification (in the form of a pdfTeX command or a dvipdfm +<dt id='index-raw-_0028hyperlink-type_0029-1'><span><code>raw</code><a href='#index-raw-_0028hyperlink-type_0029-1' class='copiable-anchor'> ¶</a></span></dt> +<dd><p>The link specification (in the form of a pdfTeX command or a dvipdfm <code>\special</code> primitive) is taken from the command sequence <code>\<var>cs</var></code>, where <var>cs</var> is the value of the <span id="index-cmd-_0028hyperlink-option_0029-2"></span> @@ -6312,9 +5961,8 @@ intended to be used with linkgroups (see <a href="#Setting-hyperlink-types-and-o <span id="pdftex_002dspecific-link-types"></span><h4 class="subsubheading"><code>pdftex</code>-specific link types</h4> <dl compact="compact"> -<dt><code>num</code></dt> -<dd><span id="index-num-_0028hyperlink-type_0029"></span> -<span id="index-numbered-destination"></span> +<dt id='index-num-_0028hyperlink-type_0029'><span><code>num</code><a href='#index-num-_0028hyperlink-type_0029' class='copiable-anchor'> ¶</a></span></dt> +<dd><span id="index-numbered-destination"></span> <span id="index-destinations_002c-numbered"></span> <span id="index-hyperlink-destination_002c-numbered"></span> <p>Go to a “numbered destination”. The label is the destination @@ -6326,9 +5974,11 @@ number. <hr> -<span id="Link-options-for-pdftex-and-dvipdfm"></span><div class="header"> +</div> +<div class="subsubsection" id="Link-options-for-pdftex-and-dvipdfm"> +<div class="header"> <p> -Previous: <a href="#Link-types-for-pdftex-and-dvipdfm" accesskey="p" rel="prev">Link types for pdftex and dvipdfm</a>, Up: <a href="#Hyperlink-drivers-pdftex-and-dvipdfm" accesskey="u" rel="up">Hyperlink drivers pdftex and dvipdfm</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Macro-index" title="Index" rel="index">Index</a>]</p> +Previous: <a href="#Link-types-for-pdftex-and-dvipdfm" accesskey="p" rel="prev">Link types for <code>pdftex</code> and <code>dvipdfm</code></a>, Up: <a href="#Hyperlink-drivers-pdftex-and-dvipdfm" accesskey="u" rel="up">Hyperlink drivers <code>pdftex</code> and <code>dvipdfm</code></a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Macro-index" title="Index" rel="index">Index</a>]</p> </div> <span id="Link-options-for-pdftex-and-dvipdfm-1"></span><h4 class="subsubsection">5.4.3.4 Link options for <code>pdftex</code> and <code>dvipdfm</code></h4> @@ -6346,9 +5996,8 @@ options to specify link dimensions. <span id="Common-link-options"></span><h4 class="subsubheading">Common link options</h4> <dl compact="compact"> -<dt><code>bcolor</code></dt> -<dd><span id="index-bcolor-_0028hyperlink-option_0029"></span> -<span id="index-hyperlink-border-color"></span> +<dt id='index-bcolor-_0028hyperlink-option_0029'><span><code>bcolor</code><a href='#index-bcolor-_0028hyperlink-option_0029' class='copiable-anchor'> ¶</a></span></dt> +<dd><span id="index-hyperlink-border-color"></span> <span id="index-border-color_002c-hyperlink"></span> <span id="index-color_002c-hyperlink-border"></span> <p>Border color. An array of three numbers in the range 0 to 1, @@ -6357,9 +6006,8 @@ representing a color in DeviceRGB. <p>Example: <code>\hlstart{name}{bcolor=.1 .5 1}{dest123}Link\hlend</code> </p> </dd> -<dt><code>bdash</code></dt> -<dd><span id="index-bdash-_0028hyperlink-option_0029"></span> -<span id="index-dashed-hyperlink-border"></span> +<dt id='index-bdash-_0028hyperlink-option_0029'><span><code>bdash</code><a href='#index-bdash-_0028hyperlink-option_0029' class='copiable-anchor'> ¶</a></span></dt> +<dd><span id="index-dashed-hyperlink-border"></span> <span id="index-hyperlinks_002c-border-style"></span> <span id="index-border-style_002c-hyperlink"></span> <p>Array of numbers representing on and off stroke lengths for drawing @@ -6368,9 +6016,8 @@ dashes. <p>Example: <code>\hlstart{name}{bstyle=D,bdash=2 4}{dest123}Link\hlend</code> </p> </dd> -<dt><code>bstyle</code></dt> -<dd><span id="index-bstyle-_0028hyperlink-option_0029"></span> -<span id="index-solid-hyperlink-border"></span> +<dt id='index-bstyle-_0028hyperlink-option_0029'><span><code>bstyle</code><a href='#index-bstyle-_0028hyperlink-option_0029' class='copiable-anchor'> ¶</a></span></dt> +<dd><span id="index-solid-hyperlink-border"></span> <span id="index-dashed-hyperlink-border-1"></span> <span id="index-beveled-hyperlink-border"></span> <span id="index-inset-hyperlink-border"></span> @@ -6381,26 +6028,26 @@ dashes. <p>Link border style: </p> <dl compact="compact"> -<dt><code>S</code></dt> +<dt><span><code>S</code></span></dt> <dd><p>The border is drawn as a solid line. </p> </dd> -<dt><code>D</code></dt> +<dt><span><code>D</code></span></dt> <dd><p>The border is drawn with a dashed line (the dash pattern is specified by the <span id="index-bdash-_0028hyperlink-option_0029-1"></span> <code>bdash</code> option). </p> </dd> -<dt><code>B</code></dt> +<dt><span><code>B</code></span></dt> <dd><p>The border is drawn in a beveled style. </p> </dd> -<dt><code>I</code></dt> +<dt><span><code>I</code></span></dt> <dd><p>The border is drawn in an inset style. </p> </dd> -<dt><code>U</code></dt> +<dt><span><code>U</code></span></dt> <dd><p>The border is drawn as a line on the bottom of the link rectangle. </p></dd> </dl> @@ -6410,9 +6057,8 @@ by the <p>Example: <code>\hlstart{name}{bstyle=D,bdash=2 4}{dest123}Link\hlend</code> </p> </dd> -<dt><code>bwidth</code></dt> -<dd><span id="index-bwidth-_0028hyperlink-option_0029"></span> -<span id="index-width_002c-hyperlink-border"></span> +<dt id='index-bwidth-_0028hyperlink-option_0029'><span><code>bwidth</code><a href='#index-bwidth-_0028hyperlink-option_0029' class='copiable-anchor'> ¶</a></span></dt> +<dd><span id="index-width_002c-hyperlink-border"></span> <span id="index-hyperlinks_002c-border-width"></span> <span id="index-border-width_002c-hyperlink"></span> <p>Border width in @@ -6422,43 +6068,40 @@ PostScript points (72 points per inch). The default is 1. <p>Example: <code>\hlstart{name}{bwidth=2}{dest123}Link\hlend</code> </p> </dd> -<dt><code>cmd</code></dt> -<dd><span id="index-cmd-_0028hyperlink-option_0029-3"></span> -<p>Name of the macro (without the leading ‘<samp>\</samp>’) containing a +<dt id='index-cmd-_0028hyperlink-option_0029-3'><span><code>cmd</code><a href='#index-cmd-_0028hyperlink-option_0029-3' class='copiable-anchor'> ¶</a></span></dt> +<dd><p>Name of the macro (without the leading ‘<samp>\</samp>’) containing a pdfTeX command or a dvipdfm <code>\special</code> for the <code>raw</code> link. </p> -<p>See <a href="#Link-types-for-pdftex-and-dvipdfm">Link types for pdftex and dvipdfm</a>, the description of the +<p>See <a href="#Link-types-for-pdftex-and-dvipdfm">Link types for <code>pdftex</code> and <code>dvipdfm</code></a>, the description of the <code>raw</code> link, for an example. </p> </dd> -<dt><code>file</code></dt> -<dd><span id="index-file-_0028hyperlink-option_0029-4"></span> -<p>File name for the <code>filename</code> and <code>filepage</code> link types. +<dt id='index-file-_0028hyperlink-option_0029-4'><span><code>file</code><a href='#index-file-_0028hyperlink-option_0029-4' class='copiable-anchor'> ¶</a></span></dt> +<dd><p>File name for the <code>filename</code> and <code>filepage</code> link types. </p> -<p>See <a href="#Link-types-for-pdftex-and-dvipdfm">Link types for pdftex and dvipdfm</a>, the descriptions of the +<p>See <a href="#Link-types-for-pdftex-and-dvipdfm">Link types for <code>pdftex</code> and <code>dvipdfm</code></a>, the descriptions of the <code>filename</code> and <code>filepage</code> links, for an example. </p> </dd> -<dt><code>hlight</code></dt> -<dd><span id="index-hlight-_0028hyperlink-option_0029"></span> -<span id="index-hyperlinks_002c-highlight-mode"></span> +<dt id='index-hlight-_0028hyperlink-option_0029'><span><code>hlight</code><a href='#index-hlight-_0028hyperlink-option_0029' class='copiable-anchor'> ¶</a></span></dt> +<dd><span id="index-hyperlinks_002c-highlight-mode"></span> <span id="index-highlight-modes_002c-hyperlink"></span> <p>Link border highlight modes: </p> <dl compact="compact"> -<dt><code>I</code></dt> +<dt><span><code>I</code></span></dt> <dd><p>The rectangle specified by the bounding box of the link is inverted. </p> </dd> -<dt><code>N</code></dt> +<dt><span><code>N</code></span></dt> <dd><p>No highlighting is done. </p> </dd> -<dt><code>O</code></dt> +<dt><span><code>O</code></span></dt> <dd><p>The border of the link is inverted. </p> </dd> -<dt><code>P</code></dt> +<dt><span><code>P</code></span></dt> <dd><p>The region underneath the bounding box of the link is drawn inset into the page. </p></dd> @@ -6469,39 +6112,37 @@ the page. <p>Example: <code>\hlstart{name}{bstyle=S,hlight=O}{dest123}Link\hlend</code> </p> </dd> -<dt><code>newwin</code></dt> -<dd><span id="index-newwin-_0028hyperlink-option_0029-2"></span> -<span id="index-hyperlinks_002c-opening-in-a-new-window"></span> +<dt id='index-newwin-_0028hyperlink-option_0029-2'><span><code>newwin</code><a href='#index-newwin-_0028hyperlink-option_0029-2' class='copiable-anchor'> ¶</a></span></dt> +<dd><span id="index-hyperlinks_002c-opening-in-a-new-window"></span> <span id="index-new-window_002c-opening-hyperlink-in"></span> <p>For the <code>filename</code> and <code>filepage</code> links, specifies whether the destination document is opened in the same window or in a new window. The settings are: </p> <dl compact="compact"> -<dt><code>0</code></dt> +<dt><span><code>0</code></span></dt> <dd><p>Open in the same window. </p></dd> -<dt><code><span class="roman">non-</span>0</code></dt> +<dt><span><code><span class="roman">non-</span>0</code></span></dt> <dd><p>Open in a new window. </p></dd> -<dt><code><span class="roman">empty</span></code></dt> +<dt><span><code><span class="roman">empty</span></code></span></dt> <dd><p>Behavior according to the viewer settings. </p></dd> </dl> <p>The default is empty. </p> -<p>See <a href="#Link-types-for-pdftex-and-dvipdfm">Link types for pdftex and dvipdfm</a>, the descriptions of the +<p>See <a href="#Link-types-for-pdftex-and-dvipdfm">Link types for <code>pdftex</code> and <code>dvipdfm</code></a>, the descriptions of the <code>filename</code> and <code>filepage</code> links, for an example. </p> </dd> -<dt><code>pagefit</code></dt> -<dd><span id="index-pagefit-_0028hyperlink-option_0029-3"></span> -<p>For the <code>page</code> and <code>filepage links</code>, specifies how the page +<dt id='index-pagefit-_0028hyperlink-option_0029-3'><span><code>pagefit</code><a href='#index-pagefit-_0028hyperlink-option_0029-3' class='copiable-anchor'> ¶</a></span></dt> +<dd><p>For the <code>page</code> and <code>filepage links</code>, specifies how the page must be fitted to the window. <code>pagefit</code> specification is written -to the <acronym>PDF</acronym> file as is, so it must conform to the -<acronym>PDF</acronym> standard. +to the PDF file as is, so it must conform to the +PDF standard. </p> -<p>See <a href="#Link-types-for-pdftex-and-dvipdfm">Link types for pdftex and dvipdfm</a>, the descriptions of the +<p>See <a href="#Link-types-for-pdftex-and-dvipdfm">Link types for <code>pdftex</code> and <code>dvipdfm</code></a>, the descriptions of the <code>page</code> and <code>filepage</code> links, for an example. </p></dd> </dl> @@ -6515,23 +6156,20 @@ of the parent box is used (this is the default for all dimension options). </p> <dl compact="compact"> -<dt><code>depth</code></dt> -<dd><span id="index-depth-_0028hyperlink-option_0029"></span> -<span id="index-hyperlink-dimensions"></span> +<dt id='index-depth-_0028hyperlink-option_0029'><span><code>depth</code><a href='#index-depth-_0028hyperlink-option_0029' class='copiable-anchor'> ¶</a></span></dt> +<dd><span id="index-hyperlink-dimensions"></span> <span id="index-dimensions_002c-hyperlink"></span> <p>Depth of the link. </p> </dd> -<dt><code>height</code></dt> -<dd><span id="index-height-_0028hyperlink-option_0029"></span> -<span id="index-hyperlink-dimensions-1"></span> +<dt id='index-height-_0028hyperlink-option_0029'><span><code>height</code><a href='#index-height-_0028hyperlink-option_0029' class='copiable-anchor'> ¶</a></span></dt> +<dd><span id="index-hyperlink-dimensions-1"></span> <span id="index-dimensions_002c-hyperlink-1"></span> <p>Height of the link. </p> </dd> -<dt><code>width</code></dt> -<dd><span id="index-width-_0028hyperlink-option_0029"></span> -<span id="index-hyperlink-dimensions-2"></span> +<dt id='index-width-_0028hyperlink-option_0029'><span><code>width</code><a href='#index-width-_0028hyperlink-option_0029' class='copiable-anchor'> ¶</a></span></dt> +<dd><span id="index-hyperlink-dimensions-2"></span> <span id="index-dimensions_002c-hyperlink-2"></span> <p>Width of the link. </p> @@ -6546,9 +6184,12 @@ options). <hr> -<span id="Hyperlink-driver-nolinks"></span><div class="header"> +</div> +</div> +<div class="subsection" id="Hyperlink-driver-nolinks"> +<div class="header"> <p> -Previous: <a href="#Hyperlink-drivers-pdftex-and-dvipdfm" accesskey="p" rel="prev">Hyperlink drivers pdftex and dvipdfm</a>, Up: <a href="#Hyperlink-drivers" accesskey="u" rel="up">Hyperlink drivers</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Macro-index" title="Index" rel="index">Index</a>]</p> +Previous: <a href="#Hyperlink-drivers-pdftex-and-dvipdfm" accesskey="p" rel="prev">Hyperlink drivers <code>pdftex</code> and <code>dvipdfm</code></a>, Up: <a href="#Hyperlink-drivers" accesskey="u" rel="up">Hyperlink drivers</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Macro-index" title="Index" rel="index">Index</a>]</p> </div> <span id="Hyperlink-driver-nolinks-1"></span><h4 class="subsection">5.4.4 Hyperlink driver <code>nolinks</code></h4> @@ -6611,7 +6252,7 @@ again cause the typesetting to be inconsistent with that with destinations enabled. Here again, the <code>nolinks</code> driver helps by defining <code>\hldest</code> to produce the empty boxes. </p> -<p>So, if you are planning to produce versions of your <acronym>PDF</acronym> +<p>So, if you are planning to produce versions of your PDF document both with and without hyperlinks, here is the recommended way to enable the hyperlinks under pdfTeX: </p> @@ -6626,7 +6267,10 @@ to enable the hyperlinks under pdfTeX: <hr> -<span id="Setting-hyperlink-types-and-options"></span><div class="header"> +</div> +</div> +<div class="section" id="Setting-hyperlink-types-and-options"> +<div class="header"> <p> Next: <a href="#Turning-hyperlinks-on_002foff" accesskey="n" rel="next">Turning hyperlinks on/off</a>, Previous: <a href="#Hyperlink-drivers" accesskey="p" rel="prev">Hyperlink drivers</a>, Up: <a href="#Hyperlinks" accesskey="u" rel="up">Hyperlinks</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Macro-index" title="Index" rel="index">Index</a>]</p> </div> @@ -6668,18 +6312,16 @@ you want to set an option temporarily, you can do so inside a <code>\begingroup…\endgroup</code> block; when the group ends, the previous settings are restored. </p> -<table class="menu" border="0" cellspacing="0"> -<tr><td align="left" valign="top">• <a href="#Setting-default-types-and-options" accesskey="1">Setting default types and options</a></td><td> </td><td align="left" valign="top"> -</td></tr> -<tr><td align="left" valign="top">• <a href="#Setting-group-types" accesskey="2">Setting group types</a></td><td> </td><td align="left" valign="top"> -</td></tr> -<tr><td align="left" valign="top">• <a href="#Setting-group-options" accesskey="3">Setting group options</a></td><td> </td><td align="left" valign="top"> -</td></tr> -</table> +<ul class="section-toc"> +<li><a href="#Setting-default-types-and-options" accesskey="1">Setting default types and options</a></li> +<li><a href="#Setting-group-types" accesskey="2">Setting group types</a></li> +<li><a href="#Setting-group-options" accesskey="3">Setting group options</a></li> +</ul> <hr> -<span id="Setting-default-types-and-options"></span><div class="header"> +<div class="subsection" id="Setting-default-types-and-options"> +<div class="header"> <p> Next: <a href="#Setting-group-types" accesskey="n" rel="next">Setting group types</a>, Up: <a href="#Setting-hyperlink-types-and-options" accesskey="u" rel="up">Setting hyperlink types and options</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Macro-index" title="Index" rel="index">Index</a>]</p> </div> @@ -6735,7 +6377,9 @@ option <code>bwidth</code>; see <a href="#Hyperlink-drivers">Hyperlink drivers</ <hr> -<span id="Setting-group-types"></span><div class="header"> +</div> +<div class="subsection" id="Setting-group-types"> +<div class="header"> <p> Next: <a href="#Setting-group-options" accesskey="n" rel="next">Setting group options</a>, Previous: <a href="#Setting-default-types-and-options" accesskey="p" rel="prev">Setting default types and options</a>, Up: <a href="#Setting-hyperlink-types-and-options" accesskey="u" rel="up">Setting hyperlink types and options</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Macro-index" title="Index" rel="index">Index</a>]</p> </div> @@ -6796,7 +6440,9 @@ as well as the default destination type. </p> <hr> -<span id="Setting-group-options"></span><div class="header"> +</div> +<div class="subsection" id="Setting-group-options"> +<div class="header"> <p> Previous: <a href="#Setting-group-types" accesskey="p" rel="prev">Setting group types</a>, Up: <a href="#Setting-hyperlink-types-and-options" accesskey="u" rel="up">Setting hyperlink types and options</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Macro-index" title="Index" rel="index">Index</a>]</p> </div> @@ -6890,7 +6536,10 @@ appear in displayed math. </p> <hr> -<span id="Turning-hyperlinks-on_002foff"></span><div class="header"> +</div> +</div> +<div class="section" id="Turning-hyperlinks-on_002foff"> +<div class="header"> <p> Next: <a href="#Making-PDF-outlines" accesskey="n" rel="next">Making PDF outlines</a>, Previous: <a href="#Setting-hyperlink-types-and-options" accesskey="p" rel="prev">Setting hyperlink types and options</a>, Up: <a href="#Hyperlinks" accesskey="u" rel="up">Hyperlinks</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Macro-index" title="Index" rel="index">Index</a>]</p> </div> @@ -6908,16 +6557,15 @@ want to enable or disable links/destinations temporarily, you can do so inside a <code>\begingroup…\endgroup</code> block; when the group ends, the previous settings are restored. </p> -<table class="menu" border="0" cellspacing="0"> -<tr><td align="left" valign="top">• <a href="#Turning-low_002dlevel-commands-on_002foff" accesskey="1">Turning low-level commands on/off</a></td><td> </td><td align="left" valign="top"> -</td></tr> -<tr><td align="left" valign="top">• <a href="#Turning-hyperlinks-on_002foff-for-a-group" accesskey="2">Turning hyperlinks on/off for a group</a></td><td> </td><td align="left" valign="top"> -</td></tr> -</table> +<ul class="section-toc"> +<li><a href="#Turning-low_002dlevel-commands-on_002foff" accesskey="1">Turning low-level commands on/off</a></li> +<li><a href="#Turning-hyperlinks-on_002foff-for-a-group" accesskey="2">Turning hyperlinks on/off for a group</a></li> +</ul> <hr> -<span id="Turning-low_002dlevel-commands-on_002foff"></span><div class="header"> +<div class="subsection" id="Turning-low_002dlevel-commands-on_002foff"> +<div class="header"> <p> Next: <a href="#Turning-hyperlinks-on_002foff-for-a-group" accesskey="n" rel="next">Turning hyperlinks on/off for a group</a>, Up: <a href="#Turning-hyperlinks-on_002foff" accesskey="u" rel="up">Turning hyperlinks on/off</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Macro-index" title="Index" rel="index">Index</a>]</p> </div> @@ -6937,12 +6585,14 @@ Next: <a href="#Turning-hyperlinks-on_002foff-for-a-group" accesskey="n" rel="ne \hloff </pre></div> -<p>See <a href="#Hyperlink-driver-nolinks">Hyperlink driver nolinks</a>, for the implications of using +<p>See <a href="#Hyperlink-driver-nolinks">Hyperlink driver <code>nolinks</code></a>, for the implications of using these commands to disable hyperlinks for the entire document. </p> <hr> -<span id="Turning-hyperlinks-on_002foff-for-a-group"></span><div class="header"> +</div> +<div class="subsection" id="Turning-hyperlinks-on_002foff-for-a-group"> +<div class="header"> <p> Previous: <a href="#Turning-low_002dlevel-commands-on_002foff" accesskey="p" rel="prev">Turning low-level commands on/off</a>, Up: <a href="#Turning-hyperlinks-on_002foff" accesskey="u" rel="up">Turning hyperlinks on/off</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Macro-index" title="Index" rel="index">Index</a>]</p> </div> @@ -6981,7 +6631,10 @@ assume that all links are on; after the following sequence of commands: <p>all links are on except for the ‘eq’ linkgroup. </p> <hr> -<span id="Making-PDF-outlines"></span><div class="header"> +</div> +</div> +<div class="section" id="Making-PDF-outlines"> +<div class="header"> <p> Previous: <a href="#Turning-hyperlinks-on_002foff" accesskey="p" rel="prev">Turning hyperlinks on/off</a>, Up: <a href="#Hyperlinks" accesskey="u" rel="up">Hyperlinks</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Macro-index" title="Index" rel="index">Index</a>]</p> </div> @@ -7084,9 +6737,12 @@ and subsection given above in the outlines. <hr> -<span id="Arrow-theoretic-diagrams"></span><div class="header"> +</div> +</div> +<div class="chapter" id="Arrow-theoretic-diagrams"> +<div class="header"> <p> -Next: <a href="#Programming-definitions" accesskey="n" rel="next">Programming definitions</a>, Previous: <a href="#Hyperlinks" accesskey="p" rel="prev">Hyperlinks</a>, Up: <a href="#Top" accesskey="u" rel="up">Top</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Macro-index" title="Index" rel="index">Index</a>]</p> +Next: <a href="#Programming-definitions" accesskey="n" rel="next">Programming definitions</a>, Previous: <a href="#Hyperlinks" accesskey="p" rel="prev">Hyperlinks</a>, Up: <a href="#Top" accesskey="u" rel="up">Eplain</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Macro-index" title="Index" rel="index">Index</a>]</p> </div> <span id="Arrow-theoretic-diagrams-1"></span><h2 class="chapter">6 Arrow theoretic diagrams</h2> @@ -7094,15 +6750,14 @@ Next: <a href="#Programming-definitions" accesskey="n" rel="next">Programming de </p> <p>Steven Smith wrote this documentation (and the macros). </p> -<table class="menu" border="0" cellspacing="0"> -<tr><td align="left" valign="top">• <a href="#Slanted-lines-and-vectors" accesskey="1">Slanted lines and vectors</a></td><td> </td><td align="left" valign="top"> -</td></tr> -<tr><td align="left" valign="top">• <a href="#Commutative-diagrams" accesskey="2">Commutative diagrams</a></td><td> </td><td align="left" valign="top"> -</td></tr> -</table> +<ul class="section-toc"> +<li><a href="#Slanted-lines-and-vectors" accesskey="1">Slanted lines and vectors</a></li> +<li><a href="#Commutative-diagrams" accesskey="2">Commutative diagrams</a></li> +</ul> <hr> -<span id="Slanted-lines-and-vectors"></span><div class="header"> +<div class="section" id="Slanted-lines-and-vectors"> +<div class="header"> <p> Next: <a href="#Commutative-diagrams" accesskey="n" rel="next">Commutative diagrams</a>, Up: <a href="#Arrow-theoretic-diagrams" accesskey="u" rel="up">Arrow theoretic diagrams</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Macro-index" title="Index" rel="index">Index</a>]</p> </div> @@ -7153,7 +6808,9 @@ dotted vectors of various directions. </p> <hr> -<span id="Commutative-diagrams"></span><div class="header"> +</div> +<div class="section" id="Commutative-diagrams"> +<div class="header"> <p> Previous: <a href="#Slanted-lines-and-vectors" accesskey="p" rel="prev">Slanted lines and vectors</a>, Up: <a href="#Arrow-theoretic-diagrams" accesskey="u" rel="up">Arrow theoretic diagrams</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Macro-index" title="Index" rel="index">Index</a>]</p> </div> @@ -7167,17 +6824,15 @@ macros to facilitate typesetting arrows and morphisms, and (2) macros to facilitate the construction of commutative diagrams. All macros described in this section must be used in math mode. </p> -<table class="menu" border="0" cellspacing="0"> -<tr><td align="left" valign="top">• <a href="#Arrows-and-morphisms" accesskey="1">Arrows and morphisms</a></td><td> </td><td align="left" valign="top"> -</td></tr> -<tr><td align="left" valign="top">• <a href="#Construction-of-commutative-diagrams" accesskey="2">Construction of commutative diagrams</a></td><td> </td><td align="left" valign="top"> -</td></tr> -<tr><td align="left" valign="top">• <a href="#Commutative-diagram-parameters" accesskey="3">Commutative diagram parameters</a></td><td> </td><td align="left" valign="top"> -</td></tr> -</table> +<ul class="section-toc"> +<li><a href="#Arrows-and-morphisms" accesskey="1">Arrows and morphisms</a></li> +<li><a href="#Construction-of-commutative-diagrams" accesskey="2">Construction of commutative diagrams</a></li> +<li><a href="#Commutative-diagram-parameters" accesskey="3">Commutative diagram parameters</a></li> +</ul> <hr> -<span id="Arrows-and-morphisms"></span><div class="header"> +<div class="subsection" id="Arrows-and-morphisms"> +<div class="header"> <p> Next: <a href="#Construction-of-commutative-diagrams" accesskey="n" rel="next">Construction of commutative diagrams</a>, Up: <a href="#Commutative-diagrams" accesskey="u" rel="up">Commutative diagrams</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Macro-index" title="Index" rel="index">Index</a>]</p> </div> @@ -7263,46 +6918,38 @@ adjoint arrows. The following macros produce horizontal maps and have the same syntax as <code>\mapright</code>: </p> <dl compact="compact"> -<dt><code>\mapright</code></dt> -<dd><span id="index-mapright-1"></span> -<p><code>$X\mapright Y$</code> +<dt id='index-mapright-1'><span><code>\mapright</code><a href='#index-mapright-1' class='copiable-anchor'> ¶</a></span></dt> +<dd><p><code>$X\mapright Y$</code> = (a right arrow). </p> </dd> -<dt><code>\mapleft</code></dt> -<dd><span id="index-mapleft-1"></span> -<p><code>$X\mapleft Y$</code> +<dt id='index-mapleft-1'><span><code>\mapleft</code><a href='#index-mapleft-1' class='copiable-anchor'> ¶</a></span></dt> +<dd><p><code>$X\mapleft Y$</code> </p> </dd> -<dt><code>\hline</code></dt> -<dd><span id="index-hline"></span> -<p><code>$X\hline Y$</code> +<dt id='index-hline'><span><code>\hline</code><a href='#index-hline' class='copiable-anchor'> ¶</a></span></dt> +<dd><p><code>$X\hline Y$</code> </p> </dd> -<dt><code>\bimapright</code></dt> -<dd><span id="index-bimapright"></span> -<p><code>$X\bimapright Y$</code> +<dt id='index-bimapright'><span><code>\bimapright</code><a href='#index-bimapright' class='copiable-anchor'> ¶</a></span></dt> +<dd><p><code>$X\bimapright Y$</code> </p> </dd> -<dt><code>\bimapleft</code></dt> -<dd><span id="index-bimapleft"></span> -<p><code>$X\bimapleft Y$</code> +<dt id='index-bimapleft'><span><code>\bimapleft</code><a href='#index-bimapleft' class='copiable-anchor'> ¶</a></span></dt> +<dd><p><code>$X\bimapleft Y$</code> </p> </dd> -<dt><code>\adjmapright</code></dt> -<dd><span id="index-adjmapright"></span> -<p><code>$X\adjmapright Y$</code> +<dt id='index-adjmapright'><span><code>\adjmapright</code><a href='#index-adjmapright' class='copiable-anchor'> ¶</a></span></dt> +<dd><p><code>$X\adjmapright Y$</code> </p> </dd> -<dt><code>\adjmapleft</code></dt> -<dd><span id="index-adjmapleft"></span> -<p><code>$X\adjmapleft Y$</code> +<dt id='index-adjmapleft'><span><code>\adjmapleft</code><a href='#index-adjmapleft' class='copiable-anchor'> ¶</a></span></dt> +<dd><p><code>$X\adjmapleft Y$</code> </p> </dd> -<dt><code>\bihline</code></dt> -<dd><span id="index-bihline"></span> -<p><code>$X\bihline Y$</code> +<dt id='index-bihline'><span><code>\bihline</code><a href='#index-bihline' class='copiable-anchor'> ¶</a></span></dt> +<dd><p><code>$X\bihline Y$</code> </p></dd> </dl> @@ -7311,45 +6958,37 @@ adjoint arrows. The following macros produce vertical maps and have the same syntax as <code>\mapdown</code>: </p> <dl compact="compact"> -<dt><code>\mapdown</code></dt> -<dd><span id="index-mapdown-1"></span> -<p>(a down arrow) +<dt id='index-mapdown-1'><span><code>\mapdown</code><a href='#index-mapdown-1' class='copiable-anchor'> ¶</a></span></dt> +<dd><p>(a down arrow) </p> </dd> -<dt><code>\mapup</code></dt> -<dd><span id="index-mapup-1"></span> -<p>(an up arrow) +<dt id='index-mapup-1'><span><code>\mapup</code><a href='#index-mapup-1' class='copiable-anchor'> ¶</a></span></dt> +<dd><p>(an up arrow) </p> </dd> -<dt><code>\vline</code></dt> -<dd><span id="index-vline"></span> -<p>(vertical line) +<dt id='index-vline'><span><code>\vline</code><a href='#index-vline' class='copiable-anchor'> ¶</a></span></dt> +<dd><p>(vertical line) </p> </dd> -<dt><code>\bimapdown</code></dt> -<dd><span id="index-bimapdown"></span> -<p>(two down arrows) +<dt id='index-bimapdown'><span><code>\bimapdown</code><a href='#index-bimapdown' class='copiable-anchor'> ¶</a></span></dt> +<dd><p>(two down arrows) </p> </dd> -<dt><code>\bimapup</code></dt> -<dd><span id="index-bimapup"></span> -<p>(two up arrows) +<dt id='index-bimapup'><span><code>\bimapup</code><a href='#index-bimapup' class='copiable-anchor'> ¶</a></span></dt> +<dd><p>(two up arrows) </p> </dd> -<dt><code>\adjmapdown</code></dt> -<dd><span id="index-adjmapdown"></span> -<p>(two adjoint arrows; down then up) +<dt id='index-adjmapdown'><span><code>\adjmapdown</code><a href='#index-adjmapdown' class='copiable-anchor'> ¶</a></span></dt> +<dd><p>(two adjoint arrows; down then up) </p> </dd> -<dt><code>\adjmapup</code></dt> -<dd><span id="index-adjmapup"></span> -<p>(two adjoint arrows; up then down) +<dt id='index-adjmapup'><span><code>\adjmapup</code><a href='#index-adjmapup' class='copiable-anchor'> ¶</a></span></dt> +<dd><p>(two adjoint arrows; up then down) </p> </dd> -<dt><code>\bivline</code></dt> -<dd><span id="index-bivline"></span> -<p>(two vertical lines) +<dt id='index-bivline'><span><code>\bivline</code><a href='#index-bivline' class='copiable-anchor'> ¶</a></span></dt> +<dd><p>(two vertical lines) </p></dd> </dl> @@ -7358,29 +6997,24 @@ and adjoint arrows. The following macros produce slanted maps and have the same syntax as <code>\arrow</code>: </p> <dl compact="compact"> -<dt><code>\arrow</code></dt> -<dd><span id="index-arrow-1"></span> -<p>(a slanted arrow) +<dt id='index-arrow-1'><span><code>\arrow</code><a href='#index-arrow-1' class='copiable-anchor'> ¶</a></span></dt> +<dd><p>(a slanted arrow) </p> </dd> -<dt><code>\sline</code></dt> -<dd><span id="index-sline-1"></span> -<p>(a slanted line) +<dt id='index-sline-1'><span><code>\sline</code><a href='#index-sline-1' class='copiable-anchor'> ¶</a></span></dt> +<dd><p>(a slanted line) </p> </dd> -<dt><code>\biarrow</code></dt> -<dd><span id="index-biarrow"></span> -<p>(two straight arrows) +<dt id='index-biarrow'><span><code>\biarrow</code><a href='#index-biarrow' class='copiable-anchor'> ¶</a></span></dt> +<dd><p>(two straight arrows) </p> </dd> -<dt><code>\adjarrow</code></dt> -<dd><span id="index-adjarrow"></span> -<p>(two adjoint arrows) +<dt id='index-adjarrow'><span><code>\adjarrow</code><a href='#index-adjarrow' class='copiable-anchor'> ¶</a></span></dt> +<dd><p>(two adjoint arrows) </p> </dd> -<dt><code>\bisline</code></dt> -<dd><span id="index-bisline"></span> -<p>(two straight lines) +<dt id='index-bisline'><span><code>\bisline</code><a href='#index-bisline' class='copiable-anchor'> ¶</a></span></dt> +<dd><p>(two straight lines) </p> </dd> </dl> @@ -7405,7 +7039,9 @@ found in, e.g., the Snake Lemma, by employing a version of the </p> <hr> -<span id="Construction-of-commutative-diagrams"></span><div class="header"> +</div> +<div class="subsection" id="Construction-of-commutative-diagrams"> +<div class="header"> <p> Next: <a href="#Commutative-diagram-parameters" accesskey="n" rel="next">Commutative diagram parameters</a>, Previous: <a href="#Arrows-and-morphisms" accesskey="p" rel="prev">Arrows and morphisms</a>, Up: <a href="#Commutative-diagrams" accesskey="u" rel="up">Commutative diagrams</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Macro-index" title="Index" rel="index">Index</a>]</p> </div> @@ -7576,7 +7212,9 @@ Many diagrams may be typeset with the predefined macros that appear here; however, ingenuity is often required to handle special cases. </p> <hr> -<span id="Commutative-diagram-parameters"></span><div class="header"> +</div> +<div class="subsection" id="Commutative-diagram-parameters"> +<div class="header"> <p> Previous: <a href="#Construction-of-commutative-diagrams" accesskey="p" rel="prev">Construction of commutative diagrams</a>, Up: <a href="#Commutative-diagrams" accesskey="u" rel="up">Commutative diagrams</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Macro-index" title="Index" rel="index">Index</a>]</p> </div> @@ -7587,25 +7225,21 @@ commutative diagram macros. These dimensions may be changed globally or locally. </p> <dl compact="compact"> -<dt><code>\harrowlength</code></dt> -<dd><span id="index-harrowlength-1"></span> -<p>(Default: 60 pt) The length of right or left arrows. +<dt id='index-harrowlength-1'><span><code>\harrowlength</code><a href='#index-harrowlength-1' class='copiable-anchor'> ¶</a></span></dt> +<dd><p>(Default: 60 pt) The length of right or left arrows. </p> </dd> -<dt><code>\varrowlength</code></dt> -<dd><span id="index-varrowlength-1"></span> -<p>(Default: 0.618<code>\harrowlength</code>) The length of up or down +<dt id='index-varrowlength-1'><span><code>\varrowlength</code><a href='#index-varrowlength-1' class='copiable-anchor'> ¶</a></span></dt> +<dd><p>(Default: 0.618<code>\harrowlength</code>) The length of up or down arrows. </p> </dd> -<dt><code>\sarrowlength</code></dt> -<dd><span id="index-sarrowlength-1"></span> -<p>(Default: 60 pt) The horizontal length of slanted arrows. +<dt id='index-sarrowlength-1'><span><code>\sarrowlength</code><a href='#index-sarrowlength-1' class='copiable-anchor'> ¶</a></span></dt> +<dd><p>(Default: 60 pt) The horizontal length of slanted arrows. </p> </dd> -<dt><code>\hmorphposn</code></dt> -<dd><span id="index-hmorphposn-1"></span> -<p>(Default: 0 pt) The horizontal position of the morphism with +<dt id='index-hmorphposn-1'><span><code>\hmorphposn</code><a href='#index-hmorphposn-1' class='copiable-anchor'> ¶</a></span></dt> +<dd><p>(Default: 0 pt) The horizontal position of the morphism with respect to its default position. There are also the dimensions <code>\hmorphposnup</code>, <span id="index-hmorphposnup-1"></span> @@ -7618,9 +7252,8 @@ and <code>\hmorphposnlft</code> for <code>^</code>/<code>_</code> or <code>\lft</code>/<code>\rt</code> constructions. </p> </dd> -<dt><code>\vmorphposn</code></dt> -<dd><span id="index-vmorphposn-1"></span> -<p>(Default: 0 pt) The vertical position of the morphism with +<dt id='index-vmorphposn-1'><span><code>\vmorphposn</code><a href='#index-vmorphposn-1' class='copiable-anchor'> ¶</a></span></dt> +<dd><p>(Default: 0 pt) The vertical position of the morphism with respect to its default position. There are also the dimensions <code>\vmorphposnup</code>, <span id="index-vmorphposnup-1"></span> @@ -7633,41 +7266,35 @@ and <code>\vmorphposnlft</code> for <code>^</code>/<code>_</code> or <code>\lft</code>/<code>\rt</code> constructions. </p> </dd> -<dt><code>\morphdist</code></dt> -<dd><span id="index-morphdist-1"></span> -<p>(Default: 4 pt) The distance of morphisms from slanted lines +<dt id='index-morphdist-1'><span><code>\morphdist</code><a href='#index-morphdist-1' class='copiable-anchor'> ¶</a></span></dt> +<dd><p>(Default: 4 pt) The distance of morphisms from slanted lines or arrows. </p> </dd> -<dt><code>\channelwidth</code></dt> -<dd><span id="index-channelwidth-1"></span> -<p>(Default: 3 pt) The distance between double lines or arrows. +<dt id='index-channelwidth-1'><span><code>\channelwidth</code><a href='#index-channelwidth-1' class='copiable-anchor'> ¶</a></span></dt> +<dd><p>(Default: 3 pt) The distance between double lines or arrows. </p> </dd> -<dt><code>\hchannel, \vchannel</code></dt> -<dd><span id="index-hchannel"></span> -<span id="index-vchannel"></span> +<dt id='index-hchannel'><span><code>\hchannel, \vchannel</code><a href='#index-hchannel' class='copiable-anchor'> ¶</a></span></dt> +<dd><span id="index-vchannel"></span> <p>(Defaults: 0 pt) Overrides <code>\channelwidth</code>. The horizontal and vertical shifts between double lines or arrows. </p> </dd> -<dt><code>\commdiagbaselines</code></dt> -<dd><span id="index-commdiagbaselines-1"></span> -<p>(Default: <code>\baselineskip=15pt +<dt id='index-commdiagbaselines-1'><span><code>\commdiagbaselines</code><a href='#index-commdiagbaselines-1' class='copiable-anchor'> ¶</a></span></dt> +<dd><p>(Default: <code>\baselineskip=15pt \lineskip=3pt \lineskiplimit=3pt </code>) The parameters used by <code>\commdiag</code> for setting interline glue. </p> </dd> -<dt><code>\hgrid</code></dt> -<dd><span id="index-hgrid-1"></span> -<p>(Default: 15 pt) The horizontal spacing of the grid used by +<dt id='index-hgrid-1'><span><code>\hgrid</code><a href='#index-hgrid-1' class='copiable-anchor'> ¶</a></span></dt> +<dd><p>(Default: 15 pt) The horizontal spacing of the grid used by <code>\gridcommdiag</code>. </p> </dd> -<dt><code>\vgrid</code></dt> -<dd><span id="index-vgrid-1"></span> -<p>(Default: 15 pt) The vertical spacing of the grid used by +<dt id='index-vgrid-1'><span><code>\vgrid</code><a href='#index-vgrid-1' class='copiable-anchor'> ¶</a></span></dt> +<dd><p>(Default: 15 pt) The vertical spacing of the grid used by <code>\gridcommdiag</code>. </p> </dd> @@ -7675,45 +7302,38 @@ The parameters used by <code>\commdiag</code> for setting interline glue. <hr> -<span id="Programming-definitions"></span><div class="header"> +</div> +</div> +</div> +<div class="chapter" id="Programming-definitions"> +<div class="header"> <p> -Next: <a href="#Demo-files" accesskey="n" rel="next">Demo files</a>, Previous: <a href="#Arrow-theoretic-diagrams" accesskey="p" rel="prev">Arrow theoretic diagrams</a>, Up: <a href="#Top" accesskey="u" rel="up">Top</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Macro-index" title="Index" rel="index">Index</a>]</p> +Next: <a href="#Demo-files" accesskey="n" rel="next">Demo files</a>, Previous: <a href="#Arrow-theoretic-diagrams" accesskey="p" rel="prev">Arrow theoretic diagrams</a>, Up: <a href="#Top" accesskey="u" rel="up">Eplain</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Macro-index" title="Index" rel="index">Index</a>]</p> </div> <span id="Programming-definitions-1"></span><h2 class="chapter">7 Programming definitions</h2> <p>The definitions in this section are only likely to be useful when you are writing nontrivial macros, not when writing a document. </p> -<table class="menu" border="0" cellspacing="0"> -<tr><td align="left" valign="top">• <a href="#Category-codes" accesskey="1">Category codes</a></td><td> </td><td align="left" valign="top">Changing category codes. -</td></tr> -<tr><td align="left" valign="top">• <a href="#Allocation-macros" accesskey="2">Allocation macros</a></td><td> </td><td align="left" valign="top">Non-outer versions of \newcount et al. -</td></tr> -<tr><td align="left" valign="top">• <a href="#Iteration" accesskey="3">Iteration</a></td><td> </td><td align="left" valign="top">Doing ‘for’ and ‘while’ loops in TeX. -</td></tr> -<tr><td align="left" valign="top">• <a href="#Macro-arguments" accesskey="4">Macro arguments</a></td><td> </td><td align="left" valign="top">Reading and ignoring them. -</td></tr> -<tr><td align="left" valign="top">• <a href="#Converting-to-characters" accesskey="5">Converting to characters</a></td><td> </td><td align="left" valign="top">Normalizing control sequences and spaces. -</td></tr> -<tr><td align="left" valign="top">• <a href="#Expansion" accesskey="6">Expansion</a></td><td> </td><td align="left" valign="top">Controlling expansion. -</td></tr> -<tr><td align="left" valign="top">• <a href="#Obeying-spaces" accesskey="7">Obeying spaces</a></td><td> </td><td align="left" valign="top">Making whitespace count anywhere. -</td></tr> -<tr><td align="left" valign="top">• <a href="#Writing-out-numbers" accesskey="8">Writing out numbers</a></td><td> </td><td align="left" valign="top">Making ‘1’ into ‘one’. -</td></tr> -<tr><td align="left" valign="top">• <a href="#Mode_002dspecific-penalties" accesskey="9">Mode-specific penalties</a></td><td> </td><td align="left" valign="top"> -</td></tr> -<tr><td align="left" valign="top">• <a href="#Auxiliary-files">Auxiliary files</a></td><td> </td><td align="left" valign="top">Testing for their existence. -</td></tr> -<tr><td align="left" valign="top">• <a href="#User_002ddefined-environments">User-defined environments</a></td><td> </td><td align="left" valign="top">User-defined environments. -</td></tr> -<tr><td align="left" valign="top">• <a href="#Page-list-and-page-range-parsers">Page list and page range parsers</a></td><td> </td><td align="left" valign="top"> -</td></tr> -</table> +<ul class="section-toc"> +<li><a href="#Category-codes" accesskey="1">Category codes</a></li> +<li><a href="#Allocation-macros" accesskey="2">Allocation macros</a></li> +<li><a href="#Iteration" accesskey="3">Iteration</a></li> +<li><a href="#Macro-arguments" accesskey="4">Macro arguments</a></li> +<li><a href="#Converting-to-characters" accesskey="5">Converting to characters</a></li> +<li><a href="#Expansion" accesskey="6">Expansion</a></li> +<li><a href="#Obeying-spaces" accesskey="7">Obeying spaces</a></li> +<li><a href="#Writing-out-numbers" accesskey="8">Writing out numbers</a></li> +<li><a href="#Mode_002dspecific-penalties" accesskey="9">Mode-specific penalties</a></li> +<li><a href="#Auxiliary-files">Auxiliary files</a></li> +<li><a href="#User_002ddefined-environments">User-defined environments</a></li> +<li><a href="#Page-list-and-page-range-parsers">Page list and page range parsers</a></li> +</ul> <hr> -<span id="Category-codes"></span><div class="header"> +<div class="section" id="Category-codes"> +<div class="header"> <p> Next: <a href="#Allocation-macros" accesskey="n" rel="next">Allocation macros</a>, Up: <a href="#Programming-definitions" accesskey="u" rel="up">Programming definitions</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Macro-index" title="Index" rel="index">Index</a>]</p> </div> @@ -7811,7 +7431,9 @@ expand similarly. </p> <hr> -<span id="Allocation-macros"></span><div class="header"> +</div> +<div class="section" id="Allocation-macros"> +<div class="header"> <p> Next: <a href="#Iteration" accesskey="n" rel="next">Iteration</a>, Previous: <a href="#Category-codes" accesskey="p" rel="prev">Category codes</a>, Up: <a href="#Programming-definitions" accesskey="u" rel="up">Programming definitions</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Macro-index" title="Index" rel="index">Index</a>]</p> </div> @@ -7894,8 +7516,50 @@ example, these two calls are equivalent: </pre></div> +<ul class="section-toc"> +<li><a href="#Scratch-registers" accesskey="1">Scratch registers</a></li> +</ul> +<hr> +<div class="subsection" id="Scratch-registers"> +<div class="header"> +<p> +Up: <a href="#Allocation-macros" accesskey="u" rel="up">Allocation macros</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Macro-index" title="Index" rel="index">Index</a>]</p> +</div> +<span id="Scratch-registers-1"></span><h4 class="subsection">7.2.1 Scratch registers</h4> + +<span id="index-scratch-registers"></span> +<span id="index-registers_002c-scratch"></span> + +<p>It seems worth reiterating here the conventions for scratch registers +defined by Knuth for plain TeX, which Eplain inherits and does not +change. +</p> +<ul> +<li> Registers numbered 0 to 9, and 255, are free for any use. Thus their +values must be assumed to be clobbered whenever another macro might +get control. Eplain macros do use the scratch registers. + +</li><li> First exception: the <code>\count</code> registers <code>0..9</code> are +used internally by TeX for page numbering and thus are not +available for any other use. + +</li><li> Second exception: the <code>\box255</code> register is likewise internally +by TeX, to ship out pages. So it’s not available either. + +</li><li> By convention, all assignments to the scratch registers 1, 3, 5, 7, +and 9 should be <code>\global</code>, and assignments to the others should +be non-<code>\global</code>. + +</li></ul> + +<p>For more details on all aspects of register usage, see <cite>The +TeXbook</cite> or any other plain TeX reference. +</p> <hr> -<span id="Iteration"></span><div class="header"> +</div> +</div> +<div class="section" id="Iteration"> +<div class="header"> <p> Next: <a href="#Macro-arguments" accesskey="n" rel="next">Macro arguments</a>, Previous: <a href="#Allocation-macros" accesskey="p" rel="prev">Allocation macros</a>, Up: <a href="#Programming-definitions" accesskey="u" rel="up">Programming definitions</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Macro-index" title="Index" rel="index">Index</a>]</p> </div> @@ -7991,7 +7655,9 @@ Victor Eijkhout’s </p> <hr> -<span id="Macro-arguments"></span><div class="header"> +</div> +<div class="section" id="Macro-arguments"> +<div class="header"> <p> Next: <a href="#Converting-to-characters" accesskey="n" rel="next">Converting to characters</a>, Previous: <a href="#Iteration" accesskey="p" rel="prev">Iteration</a>, Up: <a href="#Programming-definitions" accesskey="u" rel="up">Programming definitions</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Macro-index" title="Index" rel="index">Index</a>]</p> </div> @@ -8101,7 +7767,9 @@ end of the first for the end of the second. </p> <hr> -<span id="Converting-to-characters"></span><div class="header"> +</div> +<div class="section" id="Converting-to-characters"> +<div class="header"> <p> Next: <a href="#Expansion" accesskey="n" rel="next">Expansion</a>, Previous: <a href="#Macro-arguments" accesskey="p" rel="prev">Macro arguments</a>, Up: <a href="#Programming-definitions" accesskey="u" rel="up">Programming definitions</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Macro-index" title="Index" rel="index">Index</a>]</p> </div> @@ -8150,7 +7818,9 @@ has given. <hr> -<span id="Expansion"></span><div class="header"> +</div> +<div class="section" id="Expansion"> +<div class="header"> <p> Next: <a href="#Obeying-spaces" accesskey="n" rel="next">Obeying spaces</a>, Previous: <a href="#Converting-to-characters" accesskey="p" rel="prev">Converting to characters</a>, Up: <a href="#Programming-definitions" accesskey="u" rel="up">Programming definitions</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Macro-index" title="Index" rel="index">Index</a>]</p> </div> @@ -8158,32 +7828,24 @@ Next: <a href="#Obeying-spaces" accesskey="n" rel="next">Obeying spaces</a>, Pre <p>This section describes some miscellanous macros for expansion, etc. </p> -<table class="menu" border="0" cellspacing="0"> -<tr><td align="left" valign="top">• <a href="#g_t_005ccsn-and-_005cece" accesskey="1">\csn and \ece</a></td><td> </td><td align="left" valign="top">Abbreviations for \csname expansions. -</td></tr> -<tr><td align="left" valign="top">• <a href="#g_t_005cedefappend" accesskey="2">\edefappend</a></td><td> </td><td align="left" valign="top"> -</td></tr> -<tr><td align="left" valign="top">• <a href="#Hooks" accesskey="3">Hooks</a></td><td> </td><td align="left" valign="top">Manipulating and executing named actions. -</td></tr> -<tr><td align="left" valign="top">• <a href="#Properties" accesskey="4">Properties</a></td><td> </td><td align="left" valign="top">Associating information with a csname. -</td></tr> -<tr><td align="left" valign="top">• <a href="#g_t_005cexpandonce" accesskey="5">\expandonce</a></td><td> </td><td align="left" valign="top"> -</td></tr> -<tr><td align="left" valign="top">• <a href="#g_t_005cifundefined" accesskey="6">\ifundefined</a></td><td> </td><td align="left" valign="top"> -</td></tr> -<tr><td align="left" valign="top">• <a href="#g_t_005cifempty" accesskey="7">\ifempty</a></td><td> </td><td align="left" valign="top"> -</td></tr> -<tr><td align="left" valign="top">• <a href="#g_t_005cifinteger-and-_005cisinteger" accesskey="8">\ifinteger and \isinteger</a></td><td> </td><td align="left" valign="top"> -</td></tr> -<tr><td align="left" valign="top">• <a href="#g_t_005cfuturenonspacelet" accesskey="9">\futurenonspacelet</a></td><td> </td><td align="left" valign="top"> -</td></tr> -</table> +<ul class="section-toc"> +<li><a href="#g_t_005ccsn-and-_005cece" accesskey="1"><code>\csn</code> and <code>\ece</code></a></li> +<li><a href="#g_t_005cedefappend" accesskey="2"><code>\edefappend</code></a></li> +<li><a href="#Hooks" accesskey="3">Hooks</a></li> +<li><a href="#Properties" accesskey="4">Properties</a></li> +<li><a href="#g_t_005cexpandonce" accesskey="5"><code>\expandonce</code></a></li> +<li><a href="#g_t_005cifundefined" accesskey="6"><code>\ifundefined</code></a></li> +<li><a href="#g_t_005cifempty" accesskey="7"><code>\ifempty</code></a></li> +<li><a href="#g_t_005cifinteger-and-_005cisinteger" accesskey="8"><code>\ifinteger</code> and <code>\isinteger</code></a></li> +<li><a href="#g_t_005cfuturenonspacelet" accesskey="9"><code>\futurenonspacelet</code></a></li> +</ul> <hr> -<span id="g_t_005ccsn-and-_005cece"></span><div class="header"> +<div class="subsection" id="g_t_005ccsn-and-_005cece"> +<div class="header"> <p> -Next: <a href="#g_t_005cedefappend" accesskey="n" rel="next">\edefappend</a>, Up: <a href="#Expansion" accesskey="u" rel="up">Expansion</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Macro-index" title="Index" rel="index">Index</a>]</p> +Next: <a href="#g_t_005cedefappend" accesskey="n" rel="next"><code>\edefappend</code></a>, Up: <a href="#Expansion" accesskey="u" rel="up">Expansion</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Macro-index" title="Index" rel="index">Index</a>]</p> </div> <span id="g_t_005ccsn-and-_005cece-1"></span><h4 class="subsection">7.6.1 <code>\csn</code> and <code>\ece</code></h4> @@ -8211,9 +7873,11 @@ does take some time, though, so I don’t recommend it for an inner loop. </p> <hr> -<span id="g_t_005cedefappend"></span><div class="header"> +</div> +<div class="subsection" id="g_t_005cedefappend"> +<div class="header"> <p> -Next: <a href="#Hooks" accesskey="n" rel="next">Hooks</a>, Previous: <a href="#g_t_005ccsn-and-_005cece" accesskey="p" rel="prev">\csn and \ece</a>, Up: <a href="#Expansion" accesskey="u" rel="up">Expansion</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Macro-index" title="Index" rel="index">Index</a>]</p> +Next: <a href="#Hooks" accesskey="n" rel="next">Hooks</a>, Previous: <a href="#g_t_005ccsn-and-_005cece" accesskey="p" rel="prev"><code>\csn</code> and <code>\ece</code></a>, Up: <a href="#Expansion" accesskey="u" rel="up">Expansion</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Macro-index" title="Index" rel="index">Index</a>]</p> </div> <span id="g_t_005cedefappend-1"></span><h4 class="subsection">7.6.2 <code>\edefappend</code></h4> @@ -8235,9 +7899,11 @@ fully expanded (in the <code>\edef</code> that redefines the control sequence). </p> <hr> -<span id="Hooks"></span><div class="header"> +</div> +<div class="subsection" id="Hooks"> +<div class="header"> <p> -Next: <a href="#Properties" accesskey="n" rel="next">Properties</a>, Previous: <a href="#g_t_005cedefappend" accesskey="p" rel="prev">\edefappend</a>, Up: <a href="#Expansion" accesskey="u" rel="up">Expansion</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Macro-index" title="Index" rel="index">Index</a>]</p> +Next: <a href="#Properties" accesskey="n" rel="next">Properties</a>, Previous: <a href="#g_t_005cedefappend" accesskey="p" rel="prev"><code>\edefappend</code></a>, Up: <a href="#Expansion" accesskey="u" rel="up">Expansion</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Macro-index" title="Index" rel="index">Index</a>]</p> </div> <span id="Hooks-1"></span><h4 class="subsection">7.6.3 Hooks</h4> @@ -8255,20 +7921,20 @@ take two arguments: the name of the hook and the new actions. <dd> <span id="index-hookaction"></span> </dd> -<dt><code>hookaction <var>name</var> <var>actions</var></code></dt> +<dt><span><code>hookaction <var>name</var> <var>actions</var></code></span></dt> <dd><span id="index-hookappend"></span> </dd> -<dt><code>hookappend <var>name</var> <var>actions</var></code></dt> +<dt><span><code>hookappend <var>name</var> <var>actions</var></code></span></dt> <dd><span id="index-hookprepend"></span> </dd> -<dt><code>hookprepend <var>name</var> <var>actions</var></code></dt> +<dt><span><code>hookprepend <var>name</var> <var>actions</var></code></span></dt> <dd><p>Each of these adds <var>actions</var> to the hook <var>name</var>. (Any previously-defined actions are retained.) <var>name</var> is not a control sequence, but rather the characters of the name. </p> <span id="index-hookactiononce"></span> </dd> -<dt><code>hookactiononce <var>name</var> <code>\<var>cs</var></code></code></dt> +<dt><span><code>hookactiononce <var>name</var> <code>\<var>cs</var></code></code></span></dt> <dd><p><code>\hookactiononce</code> adds <var>cs</var> to <var>name</var>, like the macros above, but first it adds </p> @@ -8309,9 +7975,11 @@ other actions (as long as the other actions use <code>\hookprepend</code> and <hr> -<span id="Properties"></span><div class="header"> +</div> +<div class="subsection" id="Properties"> +<div class="header"> <p> -Next: <a href="#g_t_005cexpandonce" accesskey="n" rel="next">\expandonce</a>, Previous: <a href="#Hooks" accesskey="p" rel="prev">Hooks</a>, Up: <a href="#Expansion" accesskey="u" rel="up">Expansion</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Macro-index" title="Index" rel="index">Index</a>]</p> +Next: <a href="#g_t_005cexpandonce" accesskey="n" rel="next"><code>\expandonce</code></a>, Previous: <a href="#Hooks" accesskey="p" rel="prev">Hooks</a>, Up: <a href="#Expansion" accesskey="u" rel="up">Expansion</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Macro-index" title="Index" rel="index">Index</a>]</p> </div> <span id="Properties-1"></span><h4 class="subsection">7.6.4 Properties</h4> @@ -8328,14 +7996,14 @@ control sequence names. <dd> <span id="index-setproperty"></span> </dd> -<dt><code>\setproperty <var>atom</var> <var>propname</var> <var>value</var></code></dt> +<dt><span><code>\setproperty <var>atom</var> <var>propname</var> <var>value</var></code></span></dt> <dd><p><code>\setproperty</code> defines the property <var>property</var> on the atom <var>atom</var> to be <var>value</var>. <var>atom</var> and <var>propname</var> can be anything acceptable to <code>\csname</code>. <var>value</var> can be anything. </p> <span id="index-getproperty"></span> </dd> -<dt><code>\getproperty <var>atom</var> <var>propname</var></code></dt> +<dt><span><code>\getproperty <var>atom</var> <var>propname</var></code></span></dt> <dd><p><code>\getproperty</code> expands to the value stored for <var>propname</var> on <var>atom</var>. If <var>propname</var> is undefined, it expands to nothing (i.e., <code>\empty</code>). @@ -8357,9 +8025,11 @@ conceptual. <hr> -<span id="g_t_005cexpandonce"></span><div class="header"> +</div> +<div class="subsection" id="g_t_005cexpandonce"> +<div class="header"> <p> -Next: <a href="#g_t_005cifundefined" accesskey="n" rel="next">\ifundefined</a>, Previous: <a href="#Properties" accesskey="p" rel="prev">Properties</a>, Up: <a href="#Expansion" accesskey="u" rel="up">Expansion</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Macro-index" title="Index" rel="index">Index</a>]</p> +Next: <a href="#g_t_005cifundefined" accesskey="n" rel="next"><code>\ifundefined</code></a>, Previous: <a href="#Properties" accesskey="p" rel="prev">Properties</a>, Up: <a href="#Expansion" accesskey="u" rel="up">Expansion</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Macro-index" title="Index" rel="index">Index</a>]</p> </div> <span id="g_t_005cexpandonce-1"></span><h4 class="subsection">7.6.5 <code>\expandonce</code></h4> @@ -8380,9 +8050,11 @@ TeX primitives. This is most useful in an <code>\edef</code>. <hr> -<span id="g_t_005cifundefined"></span><div class="header"> +</div> +<div class="subsection" id="g_t_005cifundefined"> +<div class="header"> <p> -Next: <a href="#g_t_005cifempty" accesskey="n" rel="next">\ifempty</a>, Previous: <a href="#g_t_005cexpandonce" accesskey="p" rel="prev">\expandonce</a>, Up: <a href="#Expansion" accesskey="u" rel="up">Expansion</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Macro-index" title="Index" rel="index">Index</a>]</p> +Next: <a href="#g_t_005cifempty" accesskey="n" rel="next"><code>\ifempty</code></a>, Previous: <a href="#g_t_005cexpandonce" accesskey="p" rel="prev"><code>\expandonce</code></a>, Up: <a href="#Expansion" accesskey="u" rel="up">Expansion</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Macro-index" title="Index" rel="index">Index</a>]</p> </div> <span id="g_t_005cifundefined-1"></span><h4 class="subsection">7.6.6 <code>\ifundefined</code></h4> @@ -8402,9 +8074,11 @@ within another conditional—TeX can’t match up the <code>\if</code>&r </p> <hr> -<span id="g_t_005cifempty"></span><div class="header"> +</div> +<div class="subsection" id="g_t_005cifempty"> +<div class="header"> <p> -Next: <a href="#g_t_005cifinteger-and-_005cisinteger" accesskey="n" rel="next">\ifinteger and \isinteger</a>, Previous: <a href="#g_t_005cifundefined" accesskey="p" rel="prev">\ifundefined</a>, Up: <a href="#Expansion" accesskey="u" rel="up">Expansion</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Macro-index" title="Index" rel="index">Index</a>]</p> +Next: <a href="#g_t_005cifinteger-and-_005cisinteger" accesskey="n" rel="next"><code>\ifinteger</code> and <code>\isinteger</code></a>, Previous: <a href="#g_t_005cifundefined" accesskey="p" rel="prev"><code>\ifundefined</code></a>, Up: <a href="#Expansion" accesskey="u" rel="up">Expansion</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Macro-index" title="Index" rel="index">Index</a>]</p> </div> <span id="g_t_005cifempty-1"></span><h4 class="subsection">7.6.7 <code>\ifempty</code></h4> @@ -8437,9 +8111,11 @@ within another conditional—TeX can’t match up the <code>\if</code>&r </p> <hr> -<span id="g_t_005cifinteger-and-_005cisinteger"></span><div class="header"> +</div> +<div class="subsection" id="g_t_005cifinteger-and-_005cisinteger"> +<div class="header"> <p> -Next: <a href="#g_t_005cfuturenonspacelet" accesskey="n" rel="next">\futurenonspacelet</a>, Previous: <a href="#g_t_005cifempty" accesskey="p" rel="prev">\ifempty</a>, Up: <a href="#Expansion" accesskey="u" rel="up">Expansion</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Macro-index" title="Index" rel="index">Index</a>]</p> +Next: <a href="#g_t_005cfuturenonspacelet" accesskey="n" rel="next"><code>\futurenonspacelet</code></a>, Previous: <a href="#g_t_005cifempty" accesskey="p" rel="prev"><code>\ifempty</code></a>, Up: <a href="#Expansion" accesskey="u" rel="up">Expansion</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Macro-index" title="Index" rel="index">Index</a>]</p> </div> <span id="g_t_005cifinteger-and-_005cisinteger-1"></span><h4 class="subsection">7.6.8 <code>\ifinteger</code> and <code>\isinteger</code></h4> @@ -8477,13 +8153,15 @@ even compile outside math mode). </p> <span id="index-TeX-Frequently-Asked-Questions"></span> <p>These macros come from the TeX Frequently Asked Questions -(<a href="http://www.tex.ac.uk/cgi-bin/texfaq2html">http://www.tex.ac.uk/cgi-bin/texfaq2html</a>). +(<a href="https://texfaq.org">https://texfaq.org</a>). </p> <hr> -<span id="g_t_005cfuturenonspacelet"></span><div class="header"> +</div> +<div class="subsection" id="g_t_005cfuturenonspacelet"> +<div class="header"> <p> -Previous: <a href="#g_t_005cifinteger-and-_005cisinteger" accesskey="p" rel="prev">\ifinteger and \isinteger</a>, Up: <a href="#Expansion" accesskey="u" rel="up">Expansion</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Macro-index" title="Index" rel="index">Index</a>]</p> +Previous: <a href="#g_t_005cifinteger-and-_005cisinteger" accesskey="p" rel="prev"><code>\ifinteger</code> and <code>\isinteger</code></a>, Up: <a href="#Expansion" accesskey="u" rel="up">Expansion</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Macro-index" title="Index" rel="index">Index</a>]</p> </div> <span id="g_t_005cfuturenonspacelet-1"></span><h4 class="subsection">7.6.9 <code>\futurenonspacelet</code></h4> @@ -8504,7 +8182,10 @@ first, and then expands the second. For example: <hr> -<span id="Obeying-spaces"></span><div class="header"> +</div> +</div> +<div class="section" id="Obeying-spaces"> +<div class="header"> <p> Next: <a href="#Writing-out-numbers" accesskey="n" rel="next">Writing out numbers</a>, Previous: <a href="#Expansion" accesskey="p" rel="prev">Expansion</a>, Up: <a href="#Programming-definitions" accesskey="u" rel="up">Programming definitions</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Macro-index" title="Index" rel="index">Index</a>]</p> </div> @@ -8539,7 +8220,9 @@ program like <i>expand</i> instead.) </p> <hr> -<span id="Writing-out-numbers"></span><div class="header"> +</div> +<div class="section" id="Writing-out-numbers"> +<div class="header"> <p> Next: <a href="#Mode_002dspecific-penalties" accesskey="n" rel="next">Mode-specific penalties</a>, Previous: <a href="#Obeying-spaces" accesskey="p" rel="prev">Obeying spaces</a>, Up: <a href="#Programming-definitions" accesskey="u" rel="up">Programming definitions</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Macro-index" title="Index" rel="index">Index</a>]</p> </div> @@ -8553,7 +8236,9 @@ produces the written-out form of its argument, i.e., ‘zero’ through </p> <hr> -<span id="Mode_002dspecific-penalties"></span><div class="header"> +</div> +<div class="section" id="Mode_002dspecific-penalties"> +<div class="header"> <p> Next: <a href="#Auxiliary-files" accesskey="n" rel="next">Auxiliary files</a>, Previous: <a href="#Writing-out-numbers" accesskey="p" rel="prev">Writing out numbers</a>, Up: <a href="#Programming-definitions" accesskey="u" rel="up">Programming definitions</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Macro-index" title="Index" rel="index">Index</a>]</p> </div> @@ -8575,7 +8260,9 @@ math mode.) </p> <hr> -<span id="Auxiliary-files"></span><div class="header"> +</div> +<div class="section" id="Auxiliary-files"> +<div class="header"> <p> Next: <a href="#User_002ddefined-environments" accesskey="n" rel="next">User-defined environments</a>, Previous: <a href="#Mode_002dspecific-penalties" accesskey="p" rel="prev">Mode-specific penalties</a>, Up: <a href="#Programming-definitions" accesskey="u" rel="up">Programming definitions</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Macro-index" title="Index" rel="index">Index</a>]</p> </div> @@ -8614,7 +8301,9 @@ name. For example, if you want to test for the file <hr> -<span id="User_002ddefined-environments"></span><div class="header"> +</div> +<div class="section" id="User_002ddefined-environments"> +<div class="header"> <p> Next: <a href="#Page-list-and-page-range-parsers" accesskey="n" rel="next">Page list and page range parsers</a>, Previous: <a href="#Auxiliary-files" accesskey="p" rel="prev">Auxiliary files</a>, Up: <a href="#Programming-definitions" accesskey="u" rel="up">Programming definitions</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Macro-index" title="Index" rel="index">Index</a>]</p> </div> @@ -8658,7 +8347,9 @@ environment that should not be nested. </p> <hr> -<span id="Page-list-and-page-range-parsers"></span><div class="header"> +</div> +<div class="section" id="Page-list-and-page-range-parsers"> +<div class="header"> <p> Previous: <a href="#User_002ddefined-environments" accesskey="p" rel="prev">User-defined environments</a>, Up: <a href="#Programming-definitions" accesskey="u" rel="up">Programming definitions</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Macro-index" title="Index" rel="index">Index</a>]</p> </div> @@ -8726,9 +8417,12 @@ need to design a macro which also takes care of the lists, you can extend <code>\ituline</code> with an additional call to <code>\idxparselist</code>. </p> <hr> -<span id="Demo-files"></span><div class="header"> +</div> +</div> +<div class="chapter" id="Demo-files"> +<div class="header"> <p> -Next: <a href="#Macro-index" accesskey="n" rel="next">Macro index</a>, Previous: <a href="#Programming-definitions" accesskey="p" rel="prev">Programming definitions</a>, Up: <a href="#Top" accesskey="u" rel="up">Top</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Macro-index" title="Index" rel="index">Index</a>]</p> +Next: <a href="#Macro-index" accesskey="n" rel="next">Macro index</a>, Previous: <a href="#Programming-definitions" accesskey="p" rel="prev">Programming definitions</a>, Up: <a href="#Top" accesskey="u" rel="up">Eplain</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Macro-index" title="Index" rel="index">Index</a>]</p> </div> <span id="Demo-files-1"></span><h2 class="chapter">8 Demo files</h2> @@ -8739,18 +8433,17 @@ Eplain. The files can be found in the <code>demo</code> subdirectory of Eplain distribution. These demos, both the sources and the compiled PDF and PS files, are also available from <a href="https://tug.org/eplain/demo">https://tug.org/eplain/demo</a>. </p> -<table class="menu" border="0" cellspacing="0"> -<tr><td align="left" valign="top">• <a href="#Hyperlinks-_0028xhyper_002etex_0029" accesskey="1">Hyperlinks (xhyper.tex)</a></td><td> </td><td align="left" valign="top"> -</td></tr> -<tr><td align="left" valign="top">• <a href="#Highlighting-TeX-comments-in-listings-_0028lscommnt_002etex_0029" accesskey="2">Highlighting TeX comments in listings (lscommnt.tex)</a></td><td> </td><td align="left" valign="top"> -</td></tr> -</table> +<ul class="section-toc"> +<li><a href="#Hyperlinks-_0028xhyper_002etex_0029" accesskey="1">Hyperlinks (<code>xhyper.tex</code>)</a></li> +<li><a href="#Highlighting-TeX-comments-in-listings-_0028lscommnt_002etex_0029" accesskey="2">Highlighting TeX comments in listings (<code>lscommnt.tex</code>)</a></li> +</ul> <hr> -<span id="Hyperlinks-_0028xhyper_002etex_0029"></span><div class="header"> +<div class="section" id="Hyperlinks-_0028xhyper_002etex_0029"> +<div class="header"> <p> -Next: <a href="#Highlighting-TeX-comments-in-listings-_0028lscommnt_002etex_0029" accesskey="n" rel="next">Highlighting TeX comments in listings (lscommnt.tex)</a>, Up: <a href="#Demo-files" accesskey="u" rel="up">Demo files</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Macro-index" title="Index" rel="index">Index</a>]</p> +Next: <a href="#Highlighting-TeX-comments-in-listings-_0028lscommnt_002etex_0029" accesskey="n" rel="next">Highlighting TeX comments in listings (<code>lscommnt.tex</code>)</a>, Up: <a href="#Demo-files" accesskey="u" rel="up">Demo files</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Macro-index" title="Index" rel="index">Index</a>]</p> </div> <span id="Hyperlinks-_0028xhyper_002etex_0029-1"></span><h3 class="section">8.1 Hyperlinks (<code>xhyper.tex</code>)</h3> @@ -8799,7 +8492,8 @@ Next: <a href="#Highlighting-TeX-comments-in-listings-_0028lscommnt_002etex_0029 <span id="index-rotatebox"></span> <span id="index-definecolor"></span> <span id="index-url"></span> -<pre class="verbatim">% (This file is public domain.) +<pre class="verbatim">% $Id: xhyper.tex 60 2022-10-05 22:42:54Z karl $ +% (This file is public domain.) % % This file demonstrates the following features of Eplain: % @@ -8811,7 +8505,7 @@ Next: <a href="#Highlighting-TeX-comments-in-listings-_0028lscommnt_002etex_0029 % % The compiled demo can be downloaded from % -% http://tug.org/eplain/demo +% https://tug.org/eplain/demo % % In order to compile this file yourself, you will need the CTAN lion % drawing by Duane Bibby from @@ -8971,7 +8665,7 @@ Show me % |url.sty|. Remember that we have customized the color of |url| % hyperlinks, so this one will show up with a different color than the % default dark-red. -Take me to \url{http://tug.org/eplain}. +Take me to \url{https://tug.org/eplain}. % The second approach is to create an explicit URL link. We specify % yet another border highlighting mode, |P|, which means that the @@ -8985,16 +8679,18 @@ Take me to \url{http://tug.org/eplain}. \definecolor{mycolor}{rgb}{0.4,0.1,0.4} Take me to -\hlstart{url}{hlight=P,colormodel=,color=mycolor}{http://tug.org/eplain} +\hlstart{url}{hlight=P,colormodel=,color=mycolor}{https://tug.org/eplain} Eplain homepage\hlend. \bye </pre> <hr> -<span id="Highlighting-TeX-comments-in-listings-_0028lscommnt_002etex_0029"></span><div class="header"> +</div> +<div class="section" id="Highlighting-TeX-comments-in-listings-_0028lscommnt_002etex_0029"> +<div class="header"> <p> -Previous: <a href="#Hyperlinks-_0028xhyper_002etex_0029" accesskey="p" rel="prev">Hyperlinks (xhyper.tex)</a>, Up: <a href="#Demo-files" accesskey="u" rel="up">Demo files</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Macro-index" title="Index" rel="index">Index</a>]</p> +Previous: <a href="#Hyperlinks-_0028xhyper_002etex_0029" accesskey="p" rel="prev">Hyperlinks (<code>xhyper.tex</code>)</a>, Up: <a href="#Demo-files" accesskey="u" rel="up">Demo files</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Macro-index" title="Index" rel="index">Index</a>]</p> </div> <span id="Highlighting-TeX-comments-in-listings-_0028lscommnt_002etex_0029-1"></span><h3 class="section">8.2 Highlighting TeX comments in listings (<code>lscommnt.tex</code>)</h3> @@ -9063,9 +8759,12 @@ Previous: <a href="#Hyperlinks-_0028xhyper_002etex_0029" accesskey="p" rel="prev \bye </pre> <hr> -<span id="Macro-index"></span><div class="header"> +</div> +</div> +<div class="unnumbered" id="Macro-index"> +<div class="header"> <p> -Next: <a href="#Concept-index" accesskey="n" rel="next">Concept index</a>, Previous: <a href="#Demo-files" accesskey="p" rel="prev">Demo files</a>, Up: <a href="#Top" accesskey="u" rel="up">Top</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Macro-index" title="Index" rel="index">Index</a>]</p> +Next: <a href="#Concept-index" accesskey="n" rel="next">Concept index</a>, Previous: <a href="#Demo-files" accesskey="p" rel="prev">Demo files</a>, Up: <a href="#Top" accesskey="u" rel="up">Eplain</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Macro-index" title="Index" rel="index">Index</a>]</p> </div> <span id="Macro-index-1"></span><h2 class="unnumbered">Macro index</h2> @@ -9605,7 +9304,6 @@ Next: <a href="#Concept-index" accesskey="n" rel="next">Concept index</a>, Previ <tr><td></td><td valign="top"><a href="#index-pdfescapestring-pdfTeX-primitive"><code>pdfescapestring <span class="roman">pdfTeX primitive</span></code></a>:</td><td> </td><td valign="top"><a href="#Making-PDF-outlines">Making PDF outlines</a></td></tr> <tr><td></td><td valign="top"><a href="#index-pdfmark-_0028PDF-language-primitive_0029"><code>pdfmark <span class="roman">(PDF language primitive)</span></code></a>:</td><td> </td><td valign="top"><a href="#Making-PDF-outlines">Making PDF outlines</a></td></tr> <tr><td></td><td valign="top"><a href="#index-pdfoutline-_0028pdftex-primitive_0029"><code>pdfoutline <span class="roman">(<code>pdftex</code> primitive)</span></code></a>:</td><td> </td><td valign="top"><a href="#Making-PDF-outlines">Making PDF outlines</a></td></tr> -<tr><td></td><td valign="top"><a href="#index-pdfoutput"><code>pdfoutput</code></a>:</td><td> </td><td valign="top"><a href="#Checking-for-PDF-output">Checking for PDF output</a></td></tr> <tr><td></td><td valign="top"><a href="#index-pdftex-_0028hyperlink-driver_0029"><code>pdftex <span class="roman">(hyperlink driver)</span></code></a>:</td><td> </td><td valign="top"><a href="#Hyperlink-drivers-pdftex-and-dvipdfm">Hyperlink drivers pdftex and dvipdfm</a></td></tr> <tr><td></td><td valign="top"><a href="#index-percentchar"><code>percentchar</code></a>:</td><td> </td><td valign="top"><a href="#Category-codes">Category codes</a></td></tr> <tr><td></td><td valign="top"><a href="#index-phantomeqlabel"><code>phantomeqlabel</code></a>:</td><td> </td><td valign="top"><a href="#Equation-reference-hyperlinks">Equation reference hyperlinks</a></td></tr> @@ -9834,9 +9532,11 @@ Next: <a href="#Concept-index" accesskey="n" rel="next">Concept index</a>, Previ </td></tr></table> <hr> -<span id="Concept-index"></span><div class="header"> +</div> +<div class="unnumbered" id="Concept-index"> +<div class="header"> <p> -Previous: <a href="#Macro-index" accesskey="p" rel="prev">Macro index</a>, Up: <a href="#Top" accesskey="u" rel="up">Top</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Macro-index" title="Index" rel="index">Index</a>]</p> +Previous: <a href="#Macro-index" accesskey="p" rel="prev">Macro index</a>, Up: <a href="#Top" accesskey="u" rel="up">Eplain</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Macro-index" title="Index" rel="index">Index</a>]</p> </div> <span id="Concept-index-1"></span><h2 class="unnumbered">Concept index</h2> @@ -10089,8 +9789,8 @@ Previous: <a href="#Macro-index" accesskey="p" rel="prev">Macro index</a>, Up: < <tr><td></td><td valign="top"><a href="#index-destinations_002c-numbered">destinations, numbered</a>:</td><td> </td><td valign="top"><a href="#Link-types-for-pdftex-and-dvipdfm">Link types for pdftex and dvipdfm</a></td></tr> <tr><td></td><td valign="top"><a href="#index-destinations_002c-page">destinations, page</a>:</td><td> </td><td valign="top"><a href="#Link-types-for-pdftex-and-dvipdfm">Link types for pdftex and dvipdfm</a></td></tr> <tr><td></td><td valign="top"><a href="#index-destinations_002c-raising">destinations, raising</a>:</td><td> </td><td valign="top"><a href="#Options-supported-by-all-drivers">Options supported by all drivers</a></td></tr> -<tr><td></td><td valign="top"><a href="#index-destinations_002c-URL">destinations, <acronym>URL</acronym></a>:</td><td> </td><td valign="top"><a href="#Link-types-for-hypertex">Link types for hypertex</a></td></tr> -<tr><td></td><td valign="top"><a href="#index-destinations_002c-URL-1">destinations, <acronym>URL</acronym></a>:</td><td> </td><td valign="top"><a href="#Link-types-for-pdftex-and-dvipdfm">Link types for pdftex and dvipdfm</a></td></tr> +<tr><td></td><td valign="top"><a href="#index-destinations_002c-url">destinations, url</a>:</td><td> </td><td valign="top"><a href="#Link-types-for-hypertex">Link types for hypertex</a></td></tr> +<tr><td></td><td valign="top"><a href="#index-destinations_002c-url-1">destinations, url</a>:</td><td> </td><td valign="top"><a href="#Link-types-for-pdftex-and-dvipdfm">Link types for pdftex and dvipdfm</a></td></tr> <tr><td></td><td valign="top"><a href="#index-detecting-numbers">detecting numbers</a>:</td><td> </td><td valign="top"><a href="#g_t_005cifinteger-and-_005cisinteger">\ifinteger and \isinteger</a></td></tr> <tr><td></td><td valign="top"><a href="#index-diagnostics">diagnostics</a>:</td><td> </td><td valign="top"><a href="#Diagnostics">Diagnostics</a></td></tr> <tr><td></td><td valign="top"><a href="#index-Diagram_002c-macros-for-LaTeX">Diagram, macros for LaTeX</a>:</td><td> </td><td valign="top"><a href="#Construction-of-commutative-diagrams">Construction of commutative diagrams</a></td></tr> @@ -10142,6 +9842,7 @@ Previous: <a href="#Macro-index" accesskey="p" rel="prev">Macro index</a>, Up: < <tr><td></td><td valign="top"><a href="#index-empty-string_002c-checking-for">empty string, checking for</a>:</td><td> </td><td valign="top"><a href="#g_t_005cifempty">\ifempty</a></td></tr> <tr><td></td><td valign="top"><a href="#index-Encapsulated-PostScript">Encapsulated PostScript</a>:</td><td> </td><td valign="top"><a href="#Packages-known-to-work">Packages known to work</a></td></tr> <tr><td></td><td valign="top"><a href="#index-Encapsulated-PostScript-1">Encapsulated PostScript</a>:</td><td> </td><td valign="top"><a href="#Packages-known-to-work">Packages known to work</a></td></tr> +<tr><td></td><td valign="top"><a href="#index-engines_002c-testing-for">engines, testing for</a>:</td><td> </td><td valign="top"><a href="#Checking-for-PDF-output">Checking for PDF output</a></td></tr> <tr><td></td><td valign="top"><a href="#index-environments_002c-user_002ddefined">environments, user-defined</a>:</td><td> </td><td valign="top"><a href="#User_002ddefined-environments">User-defined environments</a></td></tr> <tr><td></td><td valign="top"><a href="#index-Eplain_002c-installing">Eplain, installing</a>:</td><td> </td><td valign="top"><a href="#Installation">Installation</a></td></tr> <tr><td></td><td valign="top"><a href="#index-Eplain_002c-invoking">Eplain, invoking</a>:</td><td> </td><td valign="top"><a href="#Invoking-Eplain">Invoking Eplain</a></td></tr> @@ -10149,8 +9850,8 @@ Previous: <a href="#Macro-index" accesskey="p" rel="prev">Macro index</a>, Up: < <tr><td></td><td valign="top"><a href="#index-Eplain_002c-upgrading">Eplain, upgrading</a>:</td><td> </td><td valign="top"><a href="#Installation">Installation</a></td></tr> <tr><td></td><td valign="top"><a href="#index-eplain_002eaux"><code>eplain.aux</code></a>:</td><td> </td><td valign="top"><a href="#Installation">Installation</a></td></tr> <tr><td></td><td valign="top"><a href="#index-eplain_002efmt"><code>eplain.fmt</code></a>:</td><td> </td><td valign="top"><a href="#Installation">Installation</a></td></tr> -<tr><td></td><td valign="top"><a href="#index-EPS"><acronym>EPS</acronym></a>:</td><td> </td><td valign="top"><a href="#Packages-known-to-work">Packages known to work</a></td></tr> -<tr><td></td><td valign="top"><a href="#index-EPS-1"><acronym>EPS</acronym></a>:</td><td> </td><td valign="top"><a href="#Packages-known-to-work">Packages known to work</a></td></tr> +<tr><td></td><td valign="top"><a href="#index-EPS">EPS</a>:</td><td> </td><td valign="top"><a href="#Packages-known-to-work">Packages known to work</a></td></tr> +<tr><td></td><td valign="top"><a href="#index-EPS-1">EPS</a>:</td><td> </td><td valign="top"><a href="#Packages-known-to-work">Packages known to work</a></td></tr> <tr><td></td><td valign="top"><a href="#index-epstopdf"><code>epstopdf</code></a>:</td><td> </td><td valign="top"><a href="#Packages-known-to-work">Packages known to work</a></td></tr> <tr><td></td><td valign="top"><a href="#index-epstopdf_002esty"><code>epstopdf.sty</code></a>:</td><td> </td><td valign="top"><a href="#Packages-known-to-work">Packages known to work</a></td></tr> <tr><td></td><td valign="top"><a href="#index-equation-labels_002c-characters-valid-in">equation labels, characters valid in</a>:</td><td> </td><td valign="top"><a href="#Equation-references">Equation references</a></td></tr> @@ -10315,10 +10016,10 @@ Previous: <a href="#Macro-index" accesskey="p" rel="prev">Macro index</a>, Up: < <tr><td></td><td valign="top"><a href="#index-hyperlinks_002c-to-another-file">hyperlinks, to another file</a>:</td><td> </td><td valign="top"><a href="#Link-types-for-hypertex">Link types for hypertex</a></td></tr> <tr><td></td><td valign="top"><a href="#index-hyperlinks_002c-to-another-file-1">hyperlinks, to another file</a>:</td><td> </td><td valign="top"><a href="#Link-types-for-pdftex-and-dvipdfm">Link types for pdftex and dvipdfm</a></td></tr> <tr><td></td><td valign="top"><a href="#index-hyperlinks_002c-to-another-file-2">hyperlinks, to another file</a>:</td><td> </td><td valign="top"><a href="#Link-types-for-pdftex-and-dvipdfm">Link types for pdftex and dvipdfm</a></td></tr> -<tr><td></td><td valign="top"><a href="#index-hyperlinks_002c-URL">hyperlinks, <acronym>URL</acronym></a>:</td><td> </td><td valign="top"><a href="#General-hyperlinks">General hyperlinks</a></td></tr> -<tr><td></td><td valign="top"><a href="#index-hyperlinks_002c-URL-1">hyperlinks, <acronym>URL</acronym></a>:</td><td> </td><td valign="top"><a href="#URL-hyperlinks">URL hyperlinks</a></td></tr> -<tr><td></td><td valign="top"><a href="#index-hyperlinks_002c-URL-2">hyperlinks, <acronym>URL</acronym></a>:</td><td> </td><td valign="top"><a href="#Link-types-for-hypertex">Link types for hypertex</a></td></tr> -<tr><td></td><td valign="top"><a href="#index-hyperlinks_002c-URL-3">hyperlinks, <acronym>URL</acronym></a>:</td><td> </td><td valign="top"><a href="#Link-types-for-pdftex-and-dvipdfm">Link types for pdftex and dvipdfm</a></td></tr> +<tr><td></td><td valign="top"><a href="#index-hyperlinks_002c-url">hyperlinks, url</a>:</td><td> </td><td valign="top"><a href="#General-hyperlinks">General hyperlinks</a></td></tr> +<tr><td></td><td valign="top"><a href="#index-hyperlinks_002c-url-1">hyperlinks, url</a>:</td><td> </td><td valign="top"><a href="#URL-hyperlinks">URL hyperlinks</a></td></tr> +<tr><td></td><td valign="top"><a href="#index-hyperlinks_002c-url-2">hyperlinks, url</a>:</td><td> </td><td valign="top"><a href="#Link-types-for-hypertex">Link types for hypertex</a></td></tr> +<tr><td></td><td valign="top"><a href="#index-hyperlinks_002c-url-3">hyperlinks, url</a>:</td><td> </td><td valign="top"><a href="#Link-types-for-pdftex-and-dvipdfm">Link types for pdftex and dvipdfm</a></td></tr> <tr><td></td><td valign="top"><a href="#index-hyperref_002esty"><code>hyperref.sty</code></a>:</td><td> </td><td valign="top"><a href="#Packages-known-not-to-work">Packages known not to work</a></td></tr> <tr><td></td><td valign="top"><a href="#index-hypertex_002c-destination-options"><code>hypertex</code>, destination options</a>:</td><td> </td><td valign="top"><a href="#Destination-options-for-hypertex">Destination options for hypertex</a></td></tr> <tr><td></td><td valign="top"><a href="#index-hypertex_002c-destination-types"><code>hypertex</code>, destination types</a>:</td><td> </td><td valign="top"><a href="#Destination-types-for-hypertex">Destination types for hypertex</a></td></tr> @@ -10330,7 +10031,7 @@ Previous: <a href="#Macro-index" accesskey="p" rel="prev">Macro index</a>, Up: < <tr><th id="Concept-index_cp_letter-I">I</th><td></td><td></td></tr> <tr><td></td><td valign="top"><a href="#index-identifying-numbers">identifying numbers</a>:</td><td> </td><td valign="top"><a href="#g_t_005cifinteger-and-_005cisinteger">\ifinteger and \isinteger</a></td></tr> <tr><td></td><td valign="top"><a href="#index-idxuniq"><code>idxuniq</code></a>:</td><td> </td><td valign="top"><a href="#Exact-destinations-for-index-terms">Exact destinations for index terms</a></td></tr> -<tr><td></td><td valign="top"><a href="#index-ifpdf_002esty"><code>ifpdf.sty</code></a>:</td><td> </td><td valign="top"><a href="#Checking-for-PDF-output">Checking for PDF output</a></td></tr> +<tr><td></td><td valign="top"><a href="#index-iftex_002esty"><code>iftex.sty</code></a>:</td><td> </td><td valign="top"><a href="#Checking-for-PDF-output">Checking for PDF output</a></td></tr> <tr><td></td><td valign="top"><a href="#index-ignoring-arguments">ignoring arguments</a>:</td><td> </td><td valign="top"><a href="#Macro-arguments">Macro arguments</a></td></tr> <tr><td></td><td valign="top"><a href="#index-implicit-hyperlinks">implicit hyperlinks</a>:</td><td> </td><td valign="top"><a href="#Implicit-hyperlinks">Implicit hyperlinks</a></td></tr> <tr><td></td><td valign="top"><a href="#index-implicit-hyperlinks_002c-demo">implicit hyperlinks, demo</a>:</td><td> </td><td valign="top"><a href="#Hyperlinks-_0028xhyper_002etex_0029">Hyperlinks (xhyper.tex)</a></td></tr> @@ -10491,11 +10192,11 @@ Previous: <a href="#Macro-index" accesskey="p" rel="prev">Macro index</a>, Up: < <tr><td></td><td valign="top"><a href="#index-numbers_002c-written-form-of">numbers, written form of</a>:</td><td> </td><td valign="top"><a href="#Writing-out-numbers">Writing out numbers</a></td></tr> <tr><td colspan="4"> <hr></td></tr> <tr><th id="Concept-index_cp_letter-O">O</th><td></td><td></td></tr> -<tr><td></td><td valign="top"><a href="#index-Oberdiek_002c-Heiko">Oberdiek, Heiko</a>:</td><td> </td><td valign="top"><a href="#Checking-for-PDF-output">Checking for PDF output</a></td></tr> <tr><td></td><td valign="top"><a href="#index-omitting-hyperlinks">omitting hyperlinks</a>:</td><td> </td><td valign="top"><a href="#Hyperlink-driver-nolinks">Hyperlink driver nolinks</a></td></tr> <tr><td></td><td valign="top"><a href="#index-omitting-hyperlinks-1">omitting hyperlinks</a>:</td><td> </td><td valign="top"><a href="#Turning-hyperlinks-on_002foff">Turning hyperlinks on/off</a></td></tr> <tr><td></td><td valign="top"><a href="#index-omitting-typesetting-of-graphics">omitting typesetting of graphics</a>:</td><td> </td><td valign="top"><a href="#Packages-known-to-work">Packages known to work</a></td></tr> <tr><td></td><td valign="top"><a href="#index-open-boxes">open boxes</a>:</td><td> </td><td valign="top"><a href="#Boxes">Boxes</a></td></tr> +<tr><td></td><td valign="top"><a href="#index-OpTeX">OpTeX</a>:</td><td> </td><td valign="top"><a href="#Introduction">Introduction</a></td></tr> <tr><td></td><td valign="top"><a href="#index-option-list_002c-group">option list, group</a>:</td><td> </td><td valign="top"><a href="#Setting-group-options">Setting group options</a></td></tr> <tr><td></td><td valign="top"><a href="#index-option-list_002c-preserving-for-group">option list, preserving for group</a>:</td><td> </td><td valign="top"><a href="#Setting-group-options">Setting group options</a></td></tr> <tr><td></td><td valign="top"><a href="#index-options_002c-destination_002c-common">options, destination, common</a>:</td><td> </td><td valign="top"><a href="#Options-supported-by-all-drivers">Options supported by all drivers</a></td></tr> @@ -10525,12 +10226,11 @@ Previous: <a href="#Macro-index" accesskey="p" rel="prev">Macro index</a>, Up: < <tr><td></td><td valign="top"><a href="#index-Patashnik_002c-Oren">Patashnik, Oren</a>:</td><td> </td><td valign="top"><a href="#Citations">Citations</a></td></tr> <tr><td></td><td valign="top"><a href="#index-pathnames_002c-breaking">pathnames, breaking</a>:</td><td> </td><td valign="top"><a href="#Paths">Paths</a></td></tr> <tr><td></td><td valign="top"><a href="#index-pathnames_002c-breaking-1">pathnames, breaking</a>:</td><td> </td><td valign="top"><a href="#Packages-known-to-work">Packages known to work</a></td></tr> -<tr><td></td><td valign="top"><a href="#index-PDF"><acronym>PDF</acronym></a>:</td><td> </td><td valign="top"><a href="#Packages-known-to-work">Packages known to work</a></td></tr> +<tr><td></td><td valign="top"><a href="#index-PDF">PDF</a>:</td><td> </td><td valign="top"><a href="#Packages-known-to-work">Packages known to work</a></td></tr> <tr><td></td><td valign="top"><a href="#index-PDF-outlines-_0028a_002ek_002ea_002e-bookmarks_0029">PDF outlines (a.k.a. bookmarks)</a>:</td><td> </td><td valign="top"><a href="#Making-PDF-outlines">Making PDF outlines</a></td></tr> -<tr><td></td><td valign="top"><a href="#index-PDF-output"><acronym>PDF</acronym> output</a>:</td><td> </td><td valign="top"><a href="#Checking-for-PDF-output">Checking for PDF output</a></td></tr> +<tr><td></td><td valign="top"><a href="#index-PDF-output">PDF output</a>:</td><td> </td><td valign="top"><a href="#Checking-for-PDF-output">Checking for PDF output</a></td></tr> <tr><td></td><td valign="top"><a href="#index-pdftex"><code>pdftex</code></a>:</td><td> </td><td valign="top"><a href="#Invoking-Eplain">Invoking Eplain</a></td></tr> -<tr><td></td><td valign="top"><a href="#index-pdftex-1"><code>pdftex</code></a>:</td><td> </td><td valign="top"><a href="#Checking-for-PDF-output">Checking for PDF output</a></td></tr> -<tr><td></td><td valign="top"><a href="#index-pdftex-2"><code>pdftex</code></a>:</td><td> </td><td valign="top"><a href="#Introduction-to-hyperlinks">Introduction to hyperlinks</a></td></tr> +<tr><td></td><td valign="top"><a href="#index-pdftex-1"><code>pdftex</code></a>:</td><td> </td><td valign="top"><a href="#Introduction-to-hyperlinks">Introduction to hyperlinks</a></td></tr> <tr><td></td><td valign="top"><a href="#index-pdftex_002c-destination-options"><code>pdftex</code>, destination options</a>:</td><td> </td><td valign="top"><a href="#Destination-options-for-pdftex-and-dvipdfm">Destination options for pdftex and dvipdfm</a></td></tr> <tr><td></td><td valign="top"><a href="#index-pdftex_002c-destination-types"><code>pdftex</code>, destination types</a>:</td><td> </td><td valign="top"><a href="#Destination-types-for-pdftex-and-dvipdfm">Destination types for pdftex and dvipdfm</a></td></tr> <tr><td></td><td valign="top"><a href="#index-pdftex_002c-hyperlink-driver"><code>pdftex</code>, hyperlink driver</a>:</td><td> </td><td valign="top"><a href="#Hyperlink-drivers-pdftex-and-dvipdfm">Hyperlink drivers pdftex and dvipdfm</a></td></tr> @@ -10567,6 +10267,7 @@ Previous: <a href="#Macro-index" accesskey="p" rel="prev">Macro index</a>, Up: < <tr><td></td><td valign="top"><a href="#index-references_002c-defining-general-1">references, defining general</a>:</td><td> </td><td valign="top"><a href="#Using-generic-references">Using generic references</a></td></tr> <tr><td></td><td valign="top"><a href="#index-references_002c-numbered">references, numbered</a>:</td><td> </td><td valign="top"><a href="#Citations">Citations</a></td></tr> <tr><td></td><td valign="top"><a href="#index-register-allocation">register allocation</a>:</td><td> </td><td valign="top"><a href="#Allocation-macros">Allocation macros</a></td></tr> +<tr><td></td><td valign="top"><a href="#index-registers_002c-scratch">registers, scratch</a>:</td><td> </td><td valign="top"><a href="#Scratch-registers">Scratch registers</a></td></tr> <tr><td></td><td valign="top"><a href="#index-restoring-_005cinput_002c-LaTeX-packages">restoring <code>\input</code>, LaTeX packages</a>:</td><td> </td><td valign="top"><a href="#Environment-for-loading-packages">Environment for loading packages</a></td></tr> <tr><td></td><td valign="top"><a href="#index-return-character">return character</a>:</td><td> </td><td valign="top"><a href="#Category-codes">Category codes</a></td></tr> <tr><td></td><td valign="top"><a href="#index-right_002djustification">right-justification</a>:</td><td> </td><td valign="top"><a href="#Justification">Justification</a></td></tr> @@ -10579,6 +10280,7 @@ Previous: <a href="#Macro-index" accesskey="p" rel="prev">Macro index</a>, Up: < <tr><th id="Concept-index_cp_letter-S">S</th><td></td><td></td></tr> <tr><td></td><td valign="top"><a href="#index-scaling">scaling</a>:</td><td> </td><td valign="top"><a href="#Packages-known-to-work">Packages known to work</a></td></tr> <tr><td></td><td valign="top"><a href="#index-scaling_002c-demo">scaling, demo</a>:</td><td> </td><td valign="top"><a href="#Hyperlinks-_0028xhyper_002etex_0029">Hyperlinks (xhyper.tex)</a></td></tr> +<tr><td></td><td valign="top"><a href="#index-scratch-registers">scratch registers</a>:</td><td> </td><td valign="top"><a href="#Scratch-registers">Scratch registers</a></td></tr> <tr><td></td><td valign="top"><a href="#index-sed"><code>sed</code></a>:</td><td> </td><td valign="top"><a href="#Customizing-indexing">Customizing indexing</a></td></tr> <tr><td></td><td valign="top"><a href="#index-see-also-index-entries-and-hyperlinks">see also index entries and hyperlinks</a>:</td><td> </td><td valign="top"><a href="#Hyperlinks-in-see-and-see-also-entries">Hyperlinks in see and see also entries</a></td></tr> <tr><td></td><td valign="top"><a href="#index-see-also-index-entries-and-sorting">see also index entries and sorting</a>:</td><td> </td><td valign="top"><a href="#Customizing-indexing">Customizing indexing</a></td></tr> @@ -10654,12 +10356,11 @@ Previous: <a href="#Macro-index" accesskey="p" rel="prev">Macro index</a>, Up: < <tr><td></td><td valign="top"><a href="#index-universal-mapping-property">universal mapping property</a>:</td><td> </td><td valign="top"><a href="#Construction-of-commutative-diagrams">Construction of commutative diagrams</a></td></tr> <tr><td></td><td valign="top"><a href="#index-unordered-lists">unordered lists</a>:</td><td> </td><td valign="top"><a href="#Lists">Lists</a></td></tr> <tr><td></td><td valign="top"><a href="#index-upgrading">upgrading</a>:</td><td> </td><td valign="top"><a href="#Installation">Installation</a></td></tr> -<tr><td></td><td valign="top"><a href="#index-URL-for-path_002esty"><acronym>URL</acronym> for <samp>path.sty</samp></a>:</td><td> </td><td valign="top"><a href="#Paths">Paths</a></td></tr> -<tr><td></td><td valign="top"><a href="#index-URL-for-pdfTeX"><acronym>URL</acronym> for pdfTeX</a>:</td><td> </td><td valign="top"><a href="#Checking-for-PDF-output">Checking for PDF output</a></td></tr> -<tr><td></td><td valign="top"><a href="#index-URL-hyperlink"><acronym>URL</acronym> hyperlink</a>:</td><td> </td><td valign="top"><a href="#General-hyperlinks">General hyperlinks</a></td></tr> -<tr><td></td><td valign="top"><a href="#index-URL-hyperlink-1"><acronym>URL</acronym> hyperlink</a>:</td><td> </td><td valign="top"><a href="#URL-hyperlinks">URL hyperlinks</a></td></tr> -<tr><td></td><td valign="top"><a href="#index-URL-hyperlink-2"><acronym>URL</acronym> hyperlink</a>:</td><td> </td><td valign="top"><a href="#Link-types-for-hypertex">Link types for hypertex</a></td></tr> -<tr><td></td><td valign="top"><a href="#index-URL-hyperlink-3"><acronym>URL</acronym> hyperlink</a>:</td><td> </td><td valign="top"><a href="#Link-types-for-pdftex-and-dvipdfm">Link types for pdftex and dvipdfm</a></td></tr> +<tr><td></td><td valign="top"><a href="#index-url-for-path_002esty">url for <samp>path.sty</samp></a>:</td><td> </td><td valign="top"><a href="#Paths">Paths</a></td></tr> +<tr><td></td><td valign="top"><a href="#index-url-hyperlink">url hyperlink</a>:</td><td> </td><td valign="top"><a href="#General-hyperlinks">General hyperlinks</a></td></tr> +<tr><td></td><td valign="top"><a href="#index-url-hyperlink-1">url hyperlink</a>:</td><td> </td><td valign="top"><a href="#URL-hyperlinks">URL hyperlinks</a></td></tr> +<tr><td></td><td valign="top"><a href="#index-url-hyperlink-2">url hyperlink</a>:</td><td> </td><td valign="top"><a href="#Link-types-for-hypertex">Link types for hypertex</a></td></tr> +<tr><td></td><td valign="top"><a href="#index-url-hyperlink-3">url hyperlink</a>:</td><td> </td><td valign="top"><a href="#Link-types-for-pdftex-and-dvipdfm">Link types for pdftex and dvipdfm</a></td></tr> <tr><td></td><td valign="top"><a href="#index-url_002esty"><code>url.sty</code></a>:</td><td> </td><td valign="top"><a href="#Packages-known-to-work">Packages known to work</a></td></tr> <tr><td></td><td valign="top"><a href="#index-url_002esty-1"><code>url.sty</code></a>:</td><td> </td><td valign="top"><a href="#URL-hyperlinks">URL hyperlinks</a></td></tr> <tr><td></td><td valign="top"><a href="#index-url_002esty-2"><code>url.sty</code></a>:</td><td> </td><td valign="top"><a href="#Hyperlinks-_0028xhyper_002etex_0029">Hyperlinks (xhyper.tex)</a></td></tr> @@ -10753,8 +10454,8 @@ Previous: <a href="#Macro-index" accesskey="p" rel="prev">Macro index</a>, Up: < </td></tr></table> - -<hr> +</div> +</div> diff --git a/macros/eplain/doc/eplain.info b/macros/eplain/doc/eplain.info index 878aa858ee..e08f2e2cdf 100644 --- a/macros/eplain/doc/eplain.info +++ b/macros/eplain/doc/eplain.info @@ -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 @@ File: eplain.info, Node: Top, Next: Introduction, Up: (dir) 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 @@ on LaTeX packages and the chapter on hyperlinks, and updates throughout. * 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 @@ implementation; see comments in the source code ('xeplain.tex') for 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 @@ current version number of Eplain is defined as the macro '\fmtversion' 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@tug.org> with a message whose body contains a line - - subscribe YOU@YOUR.PREFERRED.ADDRESS - -or visit <http://lists.tug.org/tex-eplain>. + To subscribe to this mailing list (anyone can subscribe, and archives +are public), visit <https://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 @@ File: eplain.info, Node: Installation, Next: Invoking Eplain, Prev: Introduct ************** Your TeX installation should already contain a version of Eplain -('eplain.tex') in its main 'texmf' tree (usually under -'/usr/share/texmf/tex/eplain/' on Unix systems). To install a newer -version of Eplain, put the new 'eplain.tex' (included in Eplain -distributions) in the 'tex/eplain/' subdirectory of your local 'texmf' -tree. The newer version you install in the local tree should override -the older one in the main tree. - - The location of the local 'texmf' tree obviously depends on your -operating system and TeX installation. On Unix systems the usual -location is '/usr/local/share/texmf/'. If you don't have write -permissions for '/usr/local/share/texmf/', many installations read the -'texmf' tree in the user's home directory; 'eplain.tex' then should go -under '~/texmf/tex/eplain/'. For more information about TeX directory -structure, please see -<http://www.tex.ac.uk/cgi-bin/texfaq2html?label=tds>. - - If you prefer to install 'eplain.tex' in a non-standard place, set an -environment variable ('TEXINPUTS' for the Web2C port of TeX to Unix) to -tell TeX how to find it. - - If you want, you can also create a format ('.fmt') file for Eplain, -which will eliminate the time spent reading the macro source file with -'\input'. You do this by issuing a sequence of Unix commands something -like this: - - prompt$ touch eplain.aux - prompt$ initex +('eplain.tex') in its main 'texmf' tree; with TeX Live, it's in +'.../texmf-dist/tex/eplain/eplain.tex'. + + Generally, you can just use that version and there is no need to do +anything else. But if you want to use a newer version of Eplain for a +given document, you can put the new 'eplain.tex' in the document's +directory, and it will be found. + + If you want to install a new 'eplain.tex' in some other place, set an +environment variable (commonly, 'TEXINPUTS') to tell TeX how to find it. + + Distributions should also create and maintain the 'eplain.fmt' file +file. But if you want to do it yourself, you can: + + $ touch eplain.aux + $ initex This is TeX, ... **&plain eplain (eplain.tex) @@ -340,10 +154,9 @@ 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'. +'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 @@ The simplest way to use Eplain is simply to put: \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 @@ where '\undefined' must never acquire a definition. '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 @@ this: \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 @@ warning on your terminal. If you want to use the AMSTeX '\ref', do 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 @@ this definition makes the labels print as '2a', '2b', and so on. #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 @@ resulting from processing the above input. 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 @@ running the following command to produce the '.ind' file (assuming the 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 @@ inserts an unbreakable space of (essentially) size '\@normalvsize' minus 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 @@ vertical line between columns, define '\gutterbox' as \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 @@ produce their respective logos. (Sorry, the logos are not shown here.) 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 @@ File: eplain.info, Node: Checking for PDF output, Next: Loading LaTeX packages 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 @@ mailing list (*note Introduction::). '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 @@ graphicx ('1999/02/16 v1.0f Enhanced LaTeX Graphics (DPC,SPQR)') system for TeX) installed on your system. The problem was fixed in 'supp-mis.tex' version 2004.10.26. You can obtain up-to-date versions of 'supp-mis.tex' and the accompanying 'supp-pdf.tex' from - <http://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 @@ graphicx ('1999/02/16 v1.0f Enhanced LaTeX Graphics (DPC,SPQR)') 3. install the new 'supp-mis.tex' and 'supp-pdf.tex' files in the relevant subdirectory of your local 'texmf' tree (for info on - TeX directory structure see <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 @@ graphicx ('1999/02/16 v1.0f Enhanced LaTeX Graphics (DPC,SPQR)') command from the 'color.sty' package under pdfTeX, the cause may be an outdated pdfTeX color and graphics driver 'pdftex.def'. The problem was fixed in 'pdftex.def' version 0.03p. You can obtain an - up-to-date version from <http://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 @@ of commands it understands. 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 @@ the window in which the document is displayed. '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 @@ types and options::). 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,16 +2934,16 @@ linkgroup. For example: 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 in Eplain} \href{mailto:tex-eplain@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 @@ The 'url' linkgroup covers the '\url' command from the LaTeX package '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 @@ to get a modern 'url.sty', older versions do not work in plain TeX; \enablehyperlinks - \url{http://foo/bar} + \url{https://foo/bar} \url{mailto:foobar@example.org} @@ -3186,7 +3004,7 @@ border around them. Try this: \enablehyperlinks \hlopts{bwidth=0} - \url{http://foo/bar} + \url{https://foo/bar} \url{mailto:foobar@example.org} @@ -3195,7 +3013,7 @@ border around them. Try this: 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 @@ directory. This script filters out '\indexentry' lines differing only in 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 @@ File: eplain.info, Node: Hyperlink driver hypertex, Next: Hyperlink drivers pd --------------------------------- 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 @@ Hyperlink drivers pdftex and dvipdfm::). 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 @@ For convenience, we list a few HyperTeX-enabled converters: 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 @@ destination, so that "exact" linking to destinations is not possible (this was confirmed to be a bug and most probably has already been fixed in later versions of dvips(k)); dvipdfm as of version 0.13.2c and dvipdfmx as of version 20040411 do not correctly parse links to external -local files, and produce a URL link instead of a file link. +local files, and produce a url link instead of a file link. * Menu: @@ -3736,7 +3554,7 @@ File: eplain.info, Node: Link types for hypertex, Next: Link options for hyper 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 @@ Common link types 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,6 +4956,38 @@ are equivalent: \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 @@ -5555,7 +5405,7 @@ will expand to 'ab_integer' (and thus would not even compile outside 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 @@ File: eplain.info, Node: Hyperlinks (xhyper.tex), Next: Highlighting TeX comme + +% $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 @@ File: eplain.info, Node: Hyperlinks (xhyper.tex), Next: Highlighting TeX comme % % 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 @@ Show me % |url.sty|. Remember that we have customized the color of |url| % hyperlinks, so this one will show up with a different color than the % default dark-red. -Take me to \url{http://tug.org/eplain}. +Take me to \url{https://tug.org/eplain}. % The second approach is to create an explicit URL link. We specify % yet another border highlighting mode, |P|, which means that the @@ -5946,7 +5798,7 @@ Take me to \url{http://tug.org/eplain}. \definecolor{mycolor}{rgb}{0.4,0.1,0.4} Take me to -\hlstart{url}{hlight=P,colormodel=,color=mycolor}{http://tug.org/eplain} +\hlstart{url}{hlight=P,colormodel=,color=mycolor}{https://tug.org/eplain} Eplain homepage\hlend. \bye @@ -5959,6 +5811,7 @@ File: eplain.info, Node: Highlighting TeX comments in listings (lscommnt.tex), + % (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 @@ Macro index (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,16 +5931,16 @@ Macro index (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. (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 @@ Macro index * 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,14 +6026,14 @@ Macro index (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) * 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 @@ Macro index * 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 @@ Macro index (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 @@ Macro index (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 @@ Macro index * 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 @@ Macro index (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 @@ Macro index * 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 @@ Macro index * 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 @@ Macro index * 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 @@ Macro index * 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 @@ Macro index * 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 @@ Macro index * 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 @@ Macro index (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 @@ Macro index * 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 @@ Macro index * 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 @@ Macro index * 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 @@ Macro index * 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 @@ Macro index * 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 @@ Macro index * 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 @@ Macro index (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 @@ Macro index * 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 @@ Macro index * 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 @@ Macro index * 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 @@ Macro index * 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 @@ Macro index * 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 @@ Macro index (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 @@ Concept index * .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 @@ Concept index * .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 @@ Concept index * 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 @@ Concept index * 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 @@ Concept index * 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 @@ Concept index * 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 @@ Concept index * 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 @@ Concept index * 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 @@ Concept index * 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 @@ Concept index * 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 @@ Concept index (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 @@ Concept index * 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 @@ Concept index (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,31 +7198,33 @@ Concept index * 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) * 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 @@ Concept index * 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 @@ Concept index * 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 @@ Concept index * 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 @@ Concept index * 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 @@ Concept index * 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 @@ Concept index * 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 @@ Concept index (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 @@ Concept index * 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 @@ Concept index (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 @@ Concept index (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 @@ Concept index * 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 @@ Concept index (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 @@ Concept index (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 @@ Concept index (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 @@ Concept index * 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 @@ Concept index (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 @@ Concept index * 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 @@ Concept index * 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 @@ Concept index * 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 @@ Concept index * 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 @@ Concept index (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 @@ Concept index * 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 @@ Concept index (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 @@ Concept index * 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 @@ Concept index * 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 @@ Concept index * 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 @@ Concept index * 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 @@ Concept index * 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 @@ Concept index (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 @@ Concept index * 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,14 +7907,14 @@ Concept index * 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) * 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 @@ Concept index (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 @@ Concept index * 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 @@ Concept index * 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,43 +7981,41 @@ Concept index * 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. (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 @@ Concept index * 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 @@ Concept index 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 diff --git a/macros/eplain/doc/eplain.man1.pdf b/macros/eplain/doc/eplain.man1.pdf Binary files differindex 60011f4721..802e7af2ae 100644 --- a/macros/eplain/doc/eplain.man1.pdf +++ b/macros/eplain/doc/eplain.man1.pdf diff --git a/macros/eplain/doc/eplain.pdf b/macros/eplain/doc/eplain.pdf Binary files differindex ba475d1420..6ed7f61624 100644 --- a/macros/eplain/doc/eplain.pdf +++ b/macros/eplain/doc/eplain.pdf diff --git a/macros/eplain/doc/lscommnt.jpg b/macros/eplain/doc/lscommnt.jpg Binary files differindex 356fccb23d..f118a28dbd 100644 --- a/macros/eplain/doc/lscommnt.jpg +++ b/macros/eplain/doc/lscommnt.jpg diff --git a/macros/eplain/doc/xhyper.jpg b/macros/eplain/doc/xhyper.jpg Binary files differindex de24043507..15e960e42f 100644 --- a/macros/eplain/doc/xhyper.jpg +++ b/macros/eplain/doc/xhyper.jpg diff --git a/macros/eplain/source/xeplain.tex b/macros/eplain/source/xeplain.tex index 1b0e75ee4f..c30fb6c01d 100644 --- a/macros/eplain/source/xeplain.tex +++ b/macros/eplain/source/xeplain.tex @@ -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@tug.org", +%% email = "tex-eplain@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. % diff --git a/macros/eplain/tex/btxmac.tex b/macros/eplain/tex/btxmac.tex index 9fd3e20415..a402744947 100644 --- a/macros/eplain/tex/btxmac.tex +++ b/macros/eplain/tex/btxmac.tex @@ -1,15 +1,15 @@ %% @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@tug.org", %% supported = "yes", %% 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 % diff --git a/macros/eplain/tex/eplain.tex b/macros/eplain/tex/eplain.tex index 6cff16a9eb..4a9a775e0f 100644 --- a/macros/eplain/tex/eplain.tex +++ b/macros/eplain/tex/eplain.tex @@ -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@tug.org", -%% checksum = "4139 9298 134361", +%% email = "tex-eplain@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@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@protected\relax \else - \ifx\pdftrue\undefined - \ifx\PackageError\undefined - \begingroup\def\PackageError#1#2#3{\endgroup\errmessage{#2}} + \let\IFTEX@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@protected\def\RequireeTeX{\IFTEX@Require\ifetex{eTeX}\fi} +\IFTEX@protected\def\RequirePDFTeX{\IFTEX@Require\ifpdftex{pdfTeX}\fi} +\IFTEX@protected\def\RequireXeTeX{\IFTEX@Require\ifxetex{XeTeX}\fi} +\IFTEX@protected\def\RequireLuaTeX{\IFTEX@Require\ifluatex{LuaTeX}\fi} +\IFTEX@protected\def\RequireLuaHBTeX{\IFTEX@Require\ifluahbtex{LuaHBTeX}\fi} +\IFTEX@protected\def\RequirepTeX{\IFTEX@Require\ifptex{pTeX}\fi} +\IFTEX@protected\def\RequireupTeX{\IFTEX@Require\ifuptex{upTeX}\fi} +\IFTEX@protected\def\RequirepTeXng{\IFTEX@Require\ifptexng{pTeX-ng}\fi} +\IFTEX@protected\def\RequireVTeX{\IFTEX@Require\ifvtex{VTeX}\fi} +\IFTEX@protected\def\RequireAlephTeX{\IFTEX@Require\ifalephtex{Aleph}\fi} +\IFTEX@protected\def\RequireTUTeX{\IFTEX@Require\iftutex{LuaTeX or XeTeX}\fi} +\IFTEX@protected\def\RequireTexpadTeX{\IFTEX@Require\iftexpadtex{TexpadTeX}\fi} +\IFTEX@protected\def\RequireHINT{\IFTEX@Require\ifhint{HINT}\fi} +\def\IFTEX@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@let{etex}{false} +\else + \IFTEX@let{etex}{true} \fi -\let\ifpdf\iffalse -\ifx\directlua\undefined +\IFTEX@let{eTeX}{etex} \begingroup\expandafter\expandafter\expandafter\endgroup -\expandafter\ifx\csname pdfoutput\endcsname\relax +\expandafter\ifx\csname pdftexversion\endcsname\relax + \IFTEX@let{pdftex}{false} \else - \ifnum\pdfoutput>0 % - \pdftrue + \IFTEX@let{pdftex}{true} +\fi +\IFTEX@let{PDFTeX}{pdftex} +\begingroup\expandafter\expandafter\expandafter\endgroup +\expandafter\ifx\csname XeTeXrevision\endcsname\relax + \IFTEX@let{xetex}{false} +\else + \IFTEX@let{xetex}{true} +\fi +\IFTEX@let{XeTeX}{xetex} +\begingroup\expandafter\expandafter\expandafter\endgroup +\expandafter\ifx\csname directlua\endcsname\relax + \IFTEX@let{luatex}{false} +\else + \IFTEX@let{luatex}{true} +\fi +\IFTEX@let{LuaTeX}{luatex} +\IFTEX@let{luahbtex}{false} +\begingroup\expandafter\expandafter\expandafter\endgroup +\expandafter\ifx\csname directlua\endcsname\relax +\else + \directlua{\IFTEX@detokenize{ + if(pcall(require, 'luaharfbuzz')) then + tex.print("\\let\\ifluahbtex\\iftrue ") + end + }} +\fi +\IFTEX@let{LuaHBTeX}{luahbtex} +\begingroup\expandafter\expandafter\expandafter\endgroup +\expandafter\ifx\csname kanjiskip\endcsname\relax + \IFTEX@let{ptex}{false} +\else + \IFTEX@let{ptex}{true} +\fi +\IFTEX@let{pTeX}{ptex} +\ifx\enablecjktoken \@undefined + \IFTEX@let{uptex}{false} +\else + \IFTEX@let{uptex}{true} +\fi +\IFTEX@let{upTeX}{uptex} +\begingroup\expandafter\expandafter\expandafter\endgroup +\expandafter\ifx\csname ngbanner\endcsname\relax + \IFTEX@let{ptexng}{false} +\else + \IFTEX@let{ptexng}{true} +\fi +\IFTEX@let{pTeXng}{ptexng} +\begingroup\expandafter\expandafter\expandafter\endgroup +\expandafter\ifx\csname VTeXversion\endcsname\relax + \IFTEX@let{vtex}{false} +\else + \IFTEX@let{vtex}{true} +\fi +\IFTEX@let{VTeX}{vtex} +\IFTEX@let{alephtex}{false} +\ifptex\else +\begingroup\expandafter\expandafter\expandafter\endgroup +\expandafter\ifx\csname omathchardef\endcsname\relax +\else + \IFTEX@let{alephtex}{true} +\fi +\fi +\IFTEX@let{AlephTeX}{alephtex} +\begingroup\expandafter\expandafter\expandafter\endgroup +\expandafter\ifx\csname Umathchardef\endcsname\relax + \IFTEX@let{tutex}{false} +\else + \IFTEX@let{tutex}{true} +\fi +\IFTEX@let{TUTeX}{tutex} +\begingroup\expandafter\expandafter\expandafter\endgroup +\expandafter\ifx\csname TexpadTeXMode\endcsname\relax + \IFTEX@let{texpadtex}{false} +\else + \IFTEX@let{texpadtex}{true} + \ifcase\TexpadTeXMode\relax + \or + \IFTEX@let{tutex}{true} \fi \fi +\IFTEX@let{TexpadTeX}{texpadtex} +\begingroup\expandafter\expandafter\expandafter\endgroup +\expandafter\ifx\csname HINTversion\endcsname\relax + \IFTEX@let{hint}{false} \else -\directlua{% + \IFTEX@let{hint}{true} +\fi +\IFTEX@let{HINT}{hint} +\def\pdftrue{\let\ifpdf\iftrue} +\def\pdffalse{\let\ifpdf\iffalse} +\pdffalse +\ifluatex +\directlua{\IFTEX@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@atcatcode \def\makeactive#1{\catcode`#1 = \active \ignorespaces}% \chardef\letter = 11 \chardef\other = 12 @@ -102,7 +253,6 @@ end \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 @@ end \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@tug.org", %% supported = "yes", @@ -207,15 +357,15 @@ end \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 `\\'. \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 @@ end \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 @@ end %%% USA %%% Tel: (801) 581-5254 %%% FAX: (801) 581-4148", -%%% checksum = "27723 296 1385 12423", +%%% checksum = "39776 297 1390 12466", %%% email = "beebe@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 @@ end \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)}% }% |
