summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/web2c/web2c.html
diff options
context:
space:
mode:
authorKarl Berry <karl@freefriends.org>2022-03-04 16:00:29 +0000
committerKarl Berry <karl@freefriends.org>2022-03-04 16:00:29 +0000
commit5027858830867ff20c7eca53eed6f8b798c5ad9c (patch)
tree842f07fed6d88920a1bcdc035157bb20e17e7904 /Master/texmf-dist/doc/web2c/web2c.html
parentf23f3a09677e44ad094dcf2aa3ac0c3dc3893238 (diff)
2022 doc (+sync) update
git-svn-id: svn://tug.org/texlive/trunk@62387 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/doc/web2c/web2c.html')
-rw-r--r--Master/texmf-dist/doc/web2c/web2c.html1835
1 files changed, 916 insertions, 919 deletions
diff --git a/Master/texmf-dist/doc/web2c/web2c.html b/Master/texmf-dist/doc/web2c/web2c.html
index 19a32fb57dc..719e5679d72 100644
--- a/Master/texmf-dist/doc/web2c/web2c.html
+++ b/Master/texmf-dist/doc/web2c/web2c.html
@@ -1,10 +1,13 @@
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<html>
+<!-- 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 file documents the installation and use of the programs in Web2c,
an implementation of Donald Knuth's TeX system.
Copyright (C) 1996, 1997, 1998, 1999, 2000, 2001, 2002, 2003,
-2004, 2005, 2007, 2008, 2009, 2010-2021 Karl Berry & Olaf Weber.
+2004, 2005, 2007, 2008, 2009, 2010-2022 Karl Berry & Olaf Weber.
Permission is granted to make and distribute verbatim copies of this
manual provided the copyright notice and this permission notice are
@@ -19,9 +22,6 @@ permission notice identical to this one.
Permission is granted to copy and distribute translations of this manual
into another language, under the above conditions for modified versions,
except that this permission notice may be stated in a translation -->
-<!-- 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>Web2c: A TeX implementation</title>
<meta name="description" content="Web2c: A TeX implementation">
@@ -29,17 +29,20 @@ except that this permission notice may be stated in a translation -->
<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="#Index" rel="index" title="Index">
<link href="#SEC_Contents" rel="contents" title="Table of Contents">
<link href="http://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}
@@ -48,6 +51,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>
@@ -66,7 +70,22 @@ ul.no-bullet {list-style: none}
-<span id="SEC_Contents"></span>
+
+<div class="top" id="Top">
+<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> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
+</div>
+<span id="Web2c"></span><h1 class="top">Web2c</h1>
+
+<p>This document describes how to install and use the programs in the Web2c
+implementation of the TeX system, especially for Unix systems. It
+corresponds to Web2c version 2022, released in
+January 2022.
+</p>
+
+
+<div class="Contents_element" id="SEC_Contents">
<h2 class="contents-heading">Table of Contents</h2>
<div class="contents">
@@ -176,75 +195,32 @@ ul.no-bullet {list-style: none}
<li><a id="toc-Index-1" href="#Index" rel="index">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> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<span id="Web2c"></span><h1 class="top">Web2c</h1>
-
-<p>This document describes how to install and use the programs in the Web2c
-implementation of the TeX system, especially for Unix systems. It
-corresponds to Web2c version 2021, released in
-February 2021.
-</p>
-<table class="menu" border="0" cellspacing="0">
-<tr><td align="left" valign="top">&bull; <a href="#Introduction" accesskey="1">Introduction</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top">A brief introduction.
-</td></tr>
-<tr><td align="left" valign="top">&bull; <a href="#Installation" accesskey="2">Installation</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top">How to compile and install Web2c.
-</td></tr>
-<tr><td align="left" valign="top">&bull; <a href="#Commonalities" accesskey="3">Commonalities</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top">Option syntax, standard options, memory dumps.
-</td></tr>
-<tr><td align="left" valign="top">&bull; <a href="#Three-programs" accesskey="4">Three programs</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top">TeX, Metafont, MetaPost have much in common.
-</td></tr>
-<tr><td align="left" valign="top">&bull; <a href="#TeX" accesskey="5">TeX</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top">Typesetting.
-</td></tr>
-<tr><td align="left" valign="top">&bull; <a href="#Metafont" accesskey="6">Metafont</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top">Typeface design.
-</td></tr>
-<tr><td align="left" valign="top">&bull; <a href="#MetaPost" accesskey="7">MetaPost</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top">Technical illustrations.
-</td></tr>
-<tr><td align="left" valign="top">&bull; <a href="#BibTeX" accesskey="8">BibTeX</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top">Reusable bibliographies.
-</td></tr>
-<tr><td align="left" valign="top">&bull; <a href="#WEB" accesskey="9">WEB</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top">Literate programming.
-</td></tr>
-<tr><td align="left" valign="top">&bull; <a href="#DVI-utilities">DVI utilities</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top">DVI expansion.
-</td></tr>
-<tr><td align="left" valign="top">&bull; <a href="#Font-utilities">Font utilities</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top">Font format conversion.
-</td></tr>
-<tr><td align="left" valign="top">&bull; <a href="#Legalisms">Legalisms</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top">Blah blah blah.
-</td></tr>
-<tr><td align="left" valign="top">&bull; <a href="#References">References</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top">Books and such.
-</td></tr>
-<tr><td align="left" valign="top">&bull; <a href="#Index" rel="index">Index</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top">General index.
-</td></tr>
-</table>
-
-
<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> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#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">Web2c</a>, Up: <a href="#Top" accesskey="u" rel="up">Web2c</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
<span id="Introduction-1"></span><h2 class="chapter">1 Introduction</h2>
<span id="index-introduction"></span>
-<p>This manual corresponds to version 2021 of Web2c, released in
-February 2021.
+<p>This manual corresponds to version 2022 of Web2c, released in
+January 2022.
</p>
<span id="index-Knuth_002c-Donald-E_002e"></span>
<span id="index-TeX_002c-Web2c-implementation-of"></span>
<span id="index-Hobby_002c-John"></span>
<span id="index-Breitenlohner_002c-Peter"></span>
-<p><em>Web2c</em> is the name of a TeX implementation, originally for
-Unix, but now also running under various operating systems. By
-<em>TeX implementation</em>, we mean all of the standard programs
-developed by the Stanford TeX project directed by Donald E. Knuth:
-Metafont, DVItype, GFtoDVI, BibTeX, Tangle, etc., as well as TeX
-itself. Other programs are also included: DVIcopy, written by Peter
-Breitenlohner, MetaPost and its utilities (derived from Metafont), by
-John Hobby, etc.
+<p><em>Web2c</em> (also spelled Web2C) is the name of a TeX
+implementation, originally for Unix, but now also running under
+Windows and other operating systems. By <em>TeX implementation</em>,
+we mean all of the standard programs developed by the Stanford TeX
+project led by Donald&nbsp;E. Knuth: Metafont, DVItype, GFtoDVI,
+BibTeX, Tangle, etc., as well as TeX itself. Other programs are
+also included: DVIcopy, written by Peter Breitenlohner, MetaPost and
+its utilities (derived from Metafont), by John Hobby, and many more.
</p>
<span id="index-translation-from-WEB-to-C"></span>
<span id="index-strategy_002c-overall"></span>
@@ -259,7 +235,7 @@ Therefore, it will not work without change on an arbitrary WEB program.
<span id="index-ice-cream"></span>
<p>Availability: All of Web2c is freely available&mdash;&ldquo;free&rdquo; both in the
sense of no cost (free ice cream) and of having the source code to
-modify and/or redistribute (free speech). See <a href="https://tug.org/texinfohtml/kpathsea.html#unixtex_002eftp">unixtex.ftp</a> in <cite>Kpathsea</cite>, for the practical details of how to obtain Web2c.
+modify and/or redistribute (free speech). See <a data-manual="kpathsea" href="https://tug.org/texinfohtml/kpathsea.html#unixtex_002eftp">unixtex.ftp</a> in <cite>Kpathsea</cite>, for the practical details of how to obtain Web2c.
</p>
<p>Different parts of the Web2c distribution have different licensing
terms, however, reflecting the different circumstances of their
@@ -268,7 +244,7 @@ practical implication for redistributors of Web2c is that most of the
executables are covered by the GNU General Public License or GNU
Lesser General Public License, and therefore anyone who gets a binary
distribution must also be able to get the sources, as explained by the
-terms of the GPL (<a href="https://gnu.org/licenses/">https://gnu.org/licenses/</a>. The GPL covers the
+terms of the GPL (<a href="https://gnu.org/licenses/">https://gnu.org/licenses/</a>). The GPL covers the
Web2c executables, including <code>tex</code>, because the Free Software
Foundation sponsored the initial development of the Kpathsea library
that Web2c uses. The basic source files from Stanford, however, have
@@ -290,9 +266,17 @@ changed to Web-to-C somewhere in there. In 1990, Karl Berry became
the maintainer. He made many changes to the original sources, and
started using the shorter name Web2c. In 1997, Olaf Weber took over,
and then in 2006, Karl started taking care of it again. No
-significant development or changes have been needed for many
-years. Dozens of other people have contributed; their names are listed
-in the <samp>ChangeLog</samp> files.
+significant development or changes have been needed for many years,
+though dozens of other people have contributed in many ways; their
+names are listed in the <samp>ChangeLog</samp> files.
+</p>
+<span id="index-teTeX-distribution"></span>
+<p>Originally, Web2c was distributed as its own package, alongside the
+original web programs from Stanford and other components. It was also
+the basis for the teTeX distribution (now discontinued). Around
+2004, the packaging focus shifted entirely to the TeX Live
+distribution (<a href="https://tug.org/texlive/">https://tug.org/texlive/</a>), though the same Web2c
+is at the heart of the release.
</p>
<span id="index-acknowledgements"></span>
<span id="index-Martin_002c-Rick"></span>
@@ -304,7 +288,7 @@ access to me for many years. Richard Stallman at the Free Software
Foundation employed me while I wrote the original path searching library
(for the GNU font utilities). (rms also gave us Emacs, GDB, and GCC,
without which I cannot imagine developing Web2c.) And, of course,
-TeX would not exist in the first place without Donald E. Knuth.
+TeX would not exist in the first place without Donald&nbsp;E. Knuth.
</p>
<span id="index-reading_002c-additional"></span>
<p>Further reading: See <a href="#References">References</a>.
@@ -312,9 +296,11 @@ TeX would not exist in the first place without Donald E. Knuth.
<hr>
-<span id="Installation"></span><div class="header">
+</div>
+<div class="chapter" id="Installation">
+<div class="header">
<p>
-Next: <a href="#Commonalities" accesskey="n" rel="next">Commonalities</a>, Previous: <a href="#Introduction" accesskey="p" rel="prev">Introduction</a>, Up: <a href="#Top" accesskey="u" rel="up">Top</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
+Next: <a href="#Commonalities" accesskey="n" rel="next">Commonalities</a>, Previous: <a href="#Introduction" accesskey="p" rel="prev">Introduction</a>, Up: <a href="#Top" accesskey="u" rel="up">Web2c</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
<span id="Installation-1"></span><h2 class="chapter">2 Installation</h2>
@@ -326,14 +312,14 @@ Next: <a href="#Commonalities" accesskey="n" rel="next">Commonalities</a>, Previ
</p>
<p>Installing Web2c is mostly the same as installing any other
Kpathsea-using program. Therefore, for the basic steps involved,
-see <a href="https://tug.org/texinfohtml/kpathsea.html#Installation">Installation</a> in <cite>Kpathsea</cite>. (A copy is in the file
+see <a data-manual="kpathsea" href="https://tug.org/texinfohtml/kpathsea.html#Installation">Installation</a> in <cite>Kpathsea</cite>. (A copy is in the file
<samp>kpathsea/INSTALL</samp>.)
</p>
<p>One peculiarity to Web2c is that the source distribution comes in two
files: <samp>web.tar.gz</samp> and <samp>web2c.tar.gz</samp>. You must retrieve and
unpack them both. (We have two because the former archive contains the
very large and seldom-changing original WEB source files.)
-See <a href="https://tug.org/texinfohtml/kpathsea.html#unixtex_002eftp">unixtex.ftp</a> in <cite>Kpathsea</cite>.
+See <a data-manual="kpathsea" href="https://tug.org/texinfohtml/kpathsea.html#unixtex_002eftp">unixtex.ftp</a> in <cite>Kpathsea</cite>.
</p>
<span id="index-mpost_002c-reason-for-name-change"></span>
<p>Another peculiarity is the MetaPost program. Although it has been
@@ -345,7 +331,7 @@ available under its shorter name as well, you will have to set up a link
or some such yourself. And of course individual users can do the same.
</p>
<p>For solutions to common installation problems and information on how to
-report a bug, see the file <samp>kpathsea/BUGS</samp> (see <a href="https://tug.org/texinfohtml/kpathsea.html#Bugs">Bugs</a> in <cite>Kpathsea</cite>). See also the Web2c home page,
+report a bug, see the file <samp>kpathsea/BUGS</samp> (see <a data-manual="kpathsea" href="https://tug.org/texinfohtml/kpathsea.html#Bugs">Bugs</a> in <cite>Kpathsea</cite>). See also the Web2c home page,
<a href="http://www.tug.org/web2c">http://www.tug.org/web2c</a>.
</p>
<p>Points worth repeating:
@@ -357,9 +343,9 @@ report a bug, see the file <samp>kpathsea/BUGS</samp> (see <a href="https://tug.
<span id="index-macros_002c-basic"></span>
Before starting the standard compilation and installation you must
install the basic fonts, macros, and other library files.
-See <a href="https://tug.org/texinfohtml/kpathsea.html#Installation">Installation</a> in <cite>Kpathsea</cite>.
+See <a data-manual="kpathsea" href="https://tug.org/texinfohtml/kpathsea.html#Installation">Installation</a> in <cite>Kpathsea</cite>.
-</li><li> If you do not wish to use the standard file locations, see <a href="https://tug.org/texinfohtml/kpathsea.html#Changing-search-paths">Changing
+</li><li> If you do not wish to use the standard file locations, see <a data-manual="kpathsea" href="https://tug.org/texinfohtml/kpathsea.html#Changing-search-paths">Changing
search paths</a> in <cite>Kpathsea</cite>.
</li><li> Some Web2c features are enabled or disabled at <code>configure</code> time,
@@ -367,20 +353,17 @@ as described in the first section below.
</li></ul>
-<table class="menu" border="0" cellspacing="0">
-<tr><td align="left" valign="top">&bull; <a href="#configure-options" accesskey="1">configure options</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top">Especially &ndash;with and &ndash;enable.
-</td></tr>
-<tr><td align="left" valign="top">&bull; <a href="#Compile_002dtime-options" accesskey="2">Compile-time options</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top">Unusual -D&rsquo;s.
-</td></tr>
-<tr><td align="left" valign="top">&bull; <a href="#Additional-targets" accesskey="3">Additional targets</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top">Breaking down the task.
-</td></tr>
-<tr><td align="left" valign="top">&bull; <a href="#Triptrap" accesskey="4">Triptrap</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top">Running the torture tests.
-</td></tr>
-</table>
+<ul class="section-toc">
+<li><a href="#configure-options" accesskey="1"><code>configure</code> options</a></li>
+<li><a href="#Compile_002dtime-options" accesskey="2">Compile-time options</a></li>
+<li><a href="#Additional-targets" accesskey="3">Additional targets</a></li>
+<li><a href="#Triptrap" accesskey="4">Trip, trap, and mptrap: Torture tests</a></li>
+</ul>
<hr>
-<span id="configure-options"></span><div class="header">
+<div class="section" id="configure-options">
+<div class="header">
<p>
Next: <a href="#Compile_002dtime-options" accesskey="n" rel="next">Compile-time options</a>, Up: <a href="#Installation" accesskey="u" rel="up">Installation</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
@@ -399,60 +382,62 @@ package-specific options come last.
</p>
<p>For a description of the generic options (which mainly allow you to
specify installation directories) and basic <code>configure</code> usage,
-see <a href="https://www.gnu.org/software/autoconf/manual/autoconf.html#Invoking-configure">Running <code>configure</code> scripts</a> in <cite>Autoconf</cite>, a copy is in the file <samp>kpathsea/CONFIGURE</samp>.
+see <a data-manual="autoconf" href="https://www.gnu.org/software/autoconf/manual/autoconf.html#Invoking-configure">Running <code>configure</code> scripts</a> in <cite>Autoconf</cite>, a copy is in the file <samp>kpathsea/CONFIGURE</samp>.
</p>
<dl compact="compact">
-<dt>&lsquo;<samp>--disable-dump-share</samp>&rsquo;</dt>
+<dt><span>&lsquo;<samp>--disable-dump-share</samp>&rsquo;</span></dt>
<dd><p>Do not make fmt/base/mem files sharable across different endian
architectures. See <a href="#Hardware-and-memory-dumps">Hardware and memory dumps</a>.
</p>
</dd>
-<dt>&lsquo;<samp>--without-maketexmf-default</samp>&rsquo;</dt>
-<dt>&lsquo;<samp>--without-maketexpk-default</samp>&rsquo;</dt>
-<dt>&lsquo;<samp>--without-maketextfm-default</samp>&rsquo;</dt>
-<dt>&lsquo;<samp>--with-maketextex-default</samp>&rsquo;</dt>
-<dd><p>Enable or disable the dynamic generation programs. See <a href="https://tug.org/texinfohtml/kpathsea.html#mktex-configuration">mktex
+<dt><span>&lsquo;<samp>--without-maketexmf-default</samp>&rsquo;</span></dt>
+<dt><span>&lsquo;<samp>--without-maketexpk-default</samp>&rsquo;</span></dt>
+<dt><span>&lsquo;<samp>--without-maketextfm-default</samp>&rsquo;</span></dt>
+<dt><span>&lsquo;<samp>--with-maketextex-default</samp>&rsquo;</span></dt>
+<dd><p>Enable or disable the dynamic generation programs. See <a data-manual="kpathsea" href="https://tug.org/texinfohtml/kpathsea.html#mktex-configuration">mktex
configuration</a> in <cite>Kpathsea</cite>. The defaults are the inverse of
the options, i.e., everything is enabled except <code>mktextex</code>.
</p>
</dd>
-<dt>&lsquo;<samp>--enable-shared</samp>&rsquo;</dt>
-<dd><p>Build Kpathsea as a shared library. See <a href="https://tug.org/texinfohtml/kpathsea.html#Shared-library">Shared library</a> in <cite>Kpathsea</cite>.
+<dt><span>&lsquo;<samp>--enable-shared</samp>&rsquo;</span></dt>
+<dd><p>Build Kpathsea as a shared library. See <a data-manual="kpathsea" href="https://tug.org/texinfohtml/kpathsea.html#Shared-library">Shared library</a> in <cite>Kpathsea</cite>.
</p>
</dd>
-<dt>&lsquo;<samp>--with-editor=<var>cmd</var></samp>&rsquo;</dt>
+<dt><span>&lsquo;<samp>--with-editor=<var>cmd</var></samp>&rsquo;</span></dt>
<dd><p>Change the default editor invoked by the &lsquo;<samp>e</samp>&rsquo; interactive command.
See <a href="#Editor-invocation">Editor invocation</a>.
</p>
</dd>
-<dt>&lsquo;<samp>--with-epsfwin</samp>&rsquo;</dt>
-<dt>&lsquo;<samp>--with-hp2627win</samp>&rsquo;</dt>
-<dt>&lsquo;<samp>--with-mftalkwin</samp>&rsquo;</dt>
-<dt>&lsquo;<samp>--with-nextwin</samp>&rsquo;</dt>
-<dt>&lsquo;<samp>--with-regiswin</samp>&rsquo;</dt>
-<dt>&lsquo;<samp>--with-suntoolswin</samp>&rsquo;</dt>
-<dt>&lsquo;<samp>--with-tektronixwin</samp>&rsquo;</dt>
-<dt>&lsquo;<samp>--with-unitermwin</samp>&rsquo;</dt>
-<dt>&lsquo;<samp>--with-x</samp>&rsquo;</dt>
-<dt>&lsquo;<samp>--with-x-toolkit=KIT</samp>&rsquo;</dt>
-<dt>&lsquo;<samp>--with-x11win</samp>&rsquo;</dt>
-<dt>&lsquo;<samp>--with-x11</samp>&rsquo;</dt>
+<dt><span>&lsquo;<samp>--with-epsfwin</samp>&rsquo;</span></dt>
+<dt><span>&lsquo;<samp>--with-hp2627win</samp>&rsquo;</span></dt>
+<dt><span>&lsquo;<samp>--with-mftalkwin</samp>&rsquo;</span></dt>
+<dt><span>&lsquo;<samp>--with-nextwin</samp>&rsquo;</span></dt>
+<dt><span>&lsquo;<samp>--with-regiswin</samp>&rsquo;</span></dt>
+<dt><span>&lsquo;<samp>--with-suntoolswin</samp>&rsquo;</span></dt>
+<dt><span>&lsquo;<samp>--with-tektronixwin</samp>&rsquo;</span></dt>
+<dt><span>&lsquo;<samp>--with-unitermwin</samp>&rsquo;</span></dt>
+<dt><span>&lsquo;<samp>--with-x</samp>&rsquo;</span></dt>
+<dt><span>&lsquo;<samp>--with-x-toolkit=KIT</samp>&rsquo;</span></dt>
+<dt><span>&lsquo;<samp>--with-x11win</samp>&rsquo;</span></dt>
+<dt><span>&lsquo;<samp>--with-x11</samp>&rsquo;</span></dt>
<dd><p>Define Metafont graphics support; by default, no graphics support is
enabled. See <a href="#Online-Metafont-graphics">Online Metafont graphics</a>.
</p>
</dd>
-<dt>&lsquo;<samp>--x-includes=<var>dir</var></samp>&rsquo;</dt>
-<dt>&lsquo;<samp>--x-libraries=<var>dir</var></samp>&rsquo;</dt>
+<dt><span>&lsquo;<samp>--x-includes=<var>dir</var></samp>&rsquo;</span></dt>
+<dt><span>&lsquo;<samp>--x-libraries=<var>dir</var></samp>&rsquo;</span></dt>
<dd><p>Define the locations of the X11 include files and libraries; by default,
-<code>configure</code> does its best to guess). See <a href="https://www.gnu.org/software/autoconf/manual/autoconf.html#Optional-Features">Optional Features</a> in <cite>Autoconf</cite>. A copy is in <samp>kpathsea/CONFIGURE</samp>.
+<code>configure</code> does its best to guess). See <a data-manual="autoconf" href="https://www.gnu.org/software/autoconf/manual/autoconf.html#Optional-Features">Optional Features</a> in <cite>Autoconf</cite>. A copy is in <samp>kpathsea/CONFIGURE</samp>.
</p></dd>
</dl>
<hr>
-<span id="Compile_002dtime-options"></span><div class="header">
+</div>
+<div class="section" id="Compile_002dtime-options">
+<div class="header">
<p>
-Next: <a href="#Additional-targets" accesskey="n" rel="next">Additional targets</a>, Previous: <a href="#configure-options" accesskey="p" rel="prev">configure options</a>, Up: <a href="#Installation" accesskey="u" rel="up">Installation</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
+Next: <a href="#Additional-targets" accesskey="n" rel="next">Additional targets</a>, Previous: <a href="#configure-options" accesskey="p" rel="prev"><code>configure</code> options</a>, Up: <a href="#Installation" accesskey="u" rel="up">Installation</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
<span id="Compile_002dtime-options-1"></span><h3 class="section">2.2 Compile-time options</h3>
@@ -470,15 +455,14 @@ simplest thing to do is:
<pre class="example">make XCFLAGS=&quot;<var>ccoptions</var>&quot;
</pre></div>
<p>You can also set the <code>CFLAGS</code> environment variable before
-running <code>configure</code>. See <a href="https://tug.org/texinfohtml/kpathsea.html#configure-environment">configure environment</a> in <cite>Kpathsea</cite>.
+running <code>configure</code>. See <a data-manual="kpathsea" href="https://tug.org/texinfohtml/kpathsea.html#configure-environment">configure environment</a> in <cite>Kpathsea</cite>.
</p>
<p>Anyway, here are the possibilities:
</p>
<dl compact="compact">
-<dt>&lsquo;<samp>-DFIXPT</samp>&rsquo;</dt>
-<dt>&lsquo;<samp>-DNO_MF_ASM</samp>&rsquo;</dt>
-<dd><span id="index-FIXPT"></span>
-<span id="index-fixed_002dpoint-arithmetic"></span>
+<dt id='index-FIXPT'><span>&lsquo;<samp>-DFIXPT</samp>&rsquo;<a href='#index-FIXPT' class='copiable-anchor'> &para;</a></span></dt>
+<dt><span>&lsquo;<samp>-DNO_MF_ASM</samp>&rsquo;</span></dt>
+<dd><span id="index-fixed_002dpoint-arithmetic"></span>
<span id="index-floating_002dpoint-arithmetic"></span>
<span id="index-assembly-language-routines"></span>
<span id="index-fraction-routines"></span>
@@ -489,17 +473,18 @@ assembly-language routines are used on x86 hardware with GNU C (unless
otherwise.
</p>
</dd>
-<dt>&lsquo;<samp>-DIPC_DEBUG</samp>&rsquo;</dt>
-<dd><span id="index-IPC_005fDEBUG"></span>
-<p>Report on various interprocess communication activities. See <a href="#IPC-and-TeX">IPC and TeX</a>.
+<dt id='index-IPC_005fDEBUG'><span>&lsquo;<samp>-DIPC_DEBUG</samp>&rsquo;<a href='#index-IPC_005fDEBUG' class='copiable-anchor'> &para;</a></span></dt>
+<dd><p>Report on various interprocess communication activities. See <a href="#IPC-and-TeX">IPC and TeX</a>.
</p></dd>
</dl>
<hr>
-<span id="Additional-targets"></span><div class="header">
+</div>
+<div class="section" id="Additional-targets">
+<div class="header">
<p>
-Next: <a href="#Triptrap" accesskey="n" rel="next">Triptrap</a>, Previous: <a href="#Compile_002dtime-options" accesskey="p" rel="prev">Compile-time options</a>, Up: <a href="#Installation" accesskey="u" rel="up">Installation</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
+Next: <a href="#Triptrap" accesskey="n" rel="next">Trip, trap, and mptrap: Torture tests</a>, Previous: <a href="#Compile_002dtime-options" accesskey="p" rel="prev">Compile-time options</a>, Up: <a href="#Installation" accesskey="u" rel="up">Installation</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
<span id="Additional-targets-1"></span><h3 class="section">2.3 Additional targets</h3>
@@ -513,17 +498,15 @@ one containing <samp>kpathsea/</samp> and <samp>web2c/</samp>), or in the
<samp>web2c/</samp> directory.
</p>
<dl compact="compact">
-<dt>&lsquo;<samp>c-sources</samp>&rsquo;</dt>
-<dd><span id="index-c_002dsources-Makefile-target"></span>
-<span id="index-non_002dUnix-system_002c-compiling-on"></span>
+<dt id='index-c_002dsources-Makefile-target'><span>&lsquo;<samp>c-sources</samp>&rsquo;<a href='#index-c_002dsources-Makefile-target' class='copiable-anchor'> &para;</a></span></dt>
+<dd><span id="index-non_002dUnix-system_002c-compiling-on"></span>
<p>Make only the C files, translated from the Web sources, presumably
because you want to take them to a non-Unix machine.
</p>
</dd>
-<dt>&lsquo;<samp>formats</samp>&rsquo;</dt>
-<dt>&lsquo;<samp>install-formats</samp>&rsquo;</dt>
-<dd><span id="index-formats-Make-target"></span>
-<span id="index-install_002dformats-Make-target"></span>
+<dt id='index-formats-Make-target'><span>&lsquo;<samp>formats</samp>&rsquo;<a href='#index-formats-Make-target' class='copiable-anchor'> &para;</a></span></dt>
+<dt><span>&lsquo;<samp>install-formats</samp>&rsquo;</span></dt>
+<dd><span id="index-install_002dformats-Make-target"></span>
<p>Make or install all the memory dumps (see <a href="#Memory-dumps">Memory dumps</a>). By
default, the standard plain formats plus <samp>latex.fmt</samp> are made. You
can add other formats by redefining the <code>fmts</code>, <code>bases</code>, and
@@ -531,34 +514,30 @@ can add other formats by redefining the <code>fmts</code>, <code>bases</code>, a
possibilities.
</p>
</dd>
-<dt>&lsquo;<samp>fmts</samp>&rsquo;</dt>
-<dt>&lsquo;<samp>install-fmts</samp>&rsquo;</dt>
-<dd><span id="index-fmts-Make-target"></span>
-<span id="index-install_002dfmts-Make-target"></span>
+<dt id='index-fmts-Make-target'><span>&lsquo;<samp>fmts</samp>&rsquo;<a href='#index-fmts-Make-target' class='copiable-anchor'> &para;</a></span></dt>
+<dt><span>&lsquo;<samp>install-fmts</samp>&rsquo;</span></dt>
+<dd><span id="index-install_002dfmts-Make-target"></span>
<p>Make or install the TeX <samp>.fmt</samp> files. See <a href="#Initial-TeX">Initial TeX</a>.
</p>
</dd>
-<dt>&lsquo;<samp>bases</samp>&rsquo;</dt>
-<dt>&lsquo;<samp>install-bases</samp>&rsquo;</dt>
-<dd><span id="index-bases-Make-target"></span>
-<span id="index-install_002dbases-Make-target"></span>
+<dt id='index-bases-Make-target'><span>&lsquo;<samp>bases</samp>&rsquo;<a href='#index-bases-Make-target' class='copiable-anchor'> &para;</a></span></dt>
+<dt><span>&lsquo;<samp>install-bases</samp>&rsquo;</span></dt>
+<dd><span id="index-install_002dbases-Make-target"></span>
<p>Make or install the Metafont <samp>.base</samp> files. See <a href="#Initial-Metafont">Initial Metafont</a>.
</p>
</dd>
-<dt>&lsquo;<samp>mems</samp>&rsquo;</dt>
-<dt>&lsquo;<samp>install-mems</samp>&rsquo;</dt>
-<dd><span id="index-mems-Make-target"></span>
-<span id="index-install_002dmems-Make-target"></span>
+<dt id='index-mems-Make-target'><span>&lsquo;<samp>mems</samp>&rsquo;<a href='#index-mems-Make-target' class='copiable-anchor'> &para;</a></span></dt>
+<dt><span>&lsquo;<samp>install-mems</samp>&rsquo;</span></dt>
+<dd><span id="index-install_002dmems-Make-target"></span>
<p>Make or install the MetaPost <samp>.mem</samp> files. See <a href="#Initial-MetaPost">Initial MetaPost</a>.
</p>
</dd>
-<dt>&lsquo;<samp>triptrap</samp>&rsquo;</dt>
-<dt>&lsquo;<samp>trip</samp>&rsquo;</dt>
-<dt>&lsquo;<samp>trap</samp>&rsquo;</dt>
-<dt>&lsquo;<samp>mptrap</samp>&rsquo;</dt>
-<dd><span id="index-triptrap-Make-target"></span>
-<span id="index-trip-Make-target"></span>
+<dt id='index-triptrap-Make-target'><span>&lsquo;<samp>triptrap</samp>&rsquo;<a href='#index-triptrap-Make-target' class='copiable-anchor'> &para;</a></span></dt>
+<dt><span>&lsquo;<samp>trip</samp>&rsquo;</span></dt>
+<dt><span>&lsquo;<samp>trap</samp>&rsquo;</span></dt>
+<dt><span>&lsquo;<samp>mptrap</samp>&rsquo;</span></dt>
+<dd><span id="index-trip-Make-target"></span>
<span id="index-trap-Make-target"></span>
<span id="index-mptrap-Make-target"></span>
<p>To run the torture tests for TeX, Metafont, and MetaPost
@@ -569,7 +548,9 @@ possibilities.
<hr>
-<span id="Triptrap"></span><div class="header">
+</div>
+<div class="section" id="Triptrap">
+<div class="header">
<p>
Previous: <a href="#Additional-targets" accesskey="p" rel="prev">Additional targets</a>, Up: <a href="#Installation" accesskey="u" rel="up">Installation</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
@@ -603,7 +584,7 @@ all acceptable) are:
<p>Any other differences are trouble. The most common culprit in
the past has been compiler bugs, especially when optimizing.
-See <a href="https://tug.org/texinfohtml/kpathsea.html#TeX-or-Metafont-failing">TeX or Metafont failing</a> in <cite>Kpathsea</cite>.
+See <a data-manual="kpathsea" href="https://tug.org/texinfohtml/kpathsea.html#TeX-or-Metafont-failing">TeX or Metafont failing</a> in <cite>Kpathsea</cite>.
</p>
<p>The files <samp>trip.diffs</samp>, <samp>mftrap.diffs</samp>, and
<samp>mptrap.diffs</samp> in the <samp>triptrap</samp> directory show the standard
@@ -623,9 +604,12 @@ file <samp>tests/check.log</samp> if you like.
</p>
<hr>
-<span id="Commonalities"></span><div class="header">
+</div>
+</div>
+<div class="chapter" id="Commonalities">
+<div class="header">
<p>
-Next: <a href="#Three-programs" accesskey="n" rel="next">Three programs</a>, Previous: <a href="#Installation" accesskey="p" rel="prev">Installation</a>, Up: <a href="#Top" accesskey="u" rel="up">Top</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
+Next: <a href="#Three-programs" accesskey="n" rel="next">Three programs: Metafont, MetaPost, and TeX</a>, Previous: <a href="#Installation" accesskey="p" rel="prev">Installation</a>, Up: <a href="#Top" accesskey="u" rel="up">Web2c</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
<span id="Commonalities-1"></span><h2 class="chapter">3 Commonalities</h2>
@@ -634,20 +618,20 @@ Next: <a href="#Three-programs" accesskey="n" rel="next">Three programs</a>, Pre
<p>Many aspects of the TeX system are the same among more than one
program, so we describe those pieces together, here.
</p>
-<table class="menu" border="0" cellspacing="0">
-<tr><td align="left" valign="top">&bull; <a href="#Option-conventions" accesskey="1">Option conventions</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top">&ndash; or -, = or &lsquo; &rsquo; for values.
-</td></tr>
-<tr><td align="left" valign="top">&bull; <a href="#Common-options" accesskey="2">Common options</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top">&ndash;help &ndash;version &ndash;verbose, and TeX/MF/MP options.
-</td></tr>
-<tr><td align="left" valign="top">&bull; <a href="#Path-searching" accesskey="3">Path searching</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top">Features of the common path searching library.
-</td></tr>
-<tr><td align="left" valign="top">&bull; <a href="#Output-file-location" accesskey="4">Output file location</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top">TEXMFOUTPUT allows output in places other than &lsquo;.&rsquo;.
-</td></tr>
-</table>
+<p>Another kind of commonality is the extensions to TeX that are
+available across all the engines; see <a href="#TeX-extensions">Extended TeX engines</a>.
+</p>
+<ul class="section-toc">
+<li><a href="#Option-conventions" accesskey="1">Option conventions</a></li>
+<li><a href="#Common-options" accesskey="2">Common options</a></li>
+<li><a href="#Path-searching" accesskey="3">Path searching</a></li>
+<li><a href="#Output-file-location" accesskey="4">Output file location</a></li>
+</ul>
<hr>
-<span id="Option-conventions"></span><div class="header">
+<div class="section" id="Option-conventions">
+<div class="header">
<p>
Next: <a href="#Common-options" accesskey="n" rel="next">Common options</a>, Up: <a href="#Commonalities" accesskey="u" rel="up">Commonalities</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
@@ -696,7 +680,9 @@ option; and specifies the filename <samp>-myfile-</samp>.
<hr>
-<span id="Common-options"></span><div class="header">
+</div>
+<div class="section" id="Common-options">
+<div class="header">
<p>
Next: <a href="#Path-searching" accesskey="n" rel="next">Path searching</a>, Previous: <a href="#Option-conventions" accesskey="p" rel="prev">Option conventions</a>, Up: <a href="#Commonalities" accesskey="u" rel="up">Commonalities</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
@@ -709,22 +695,19 @@ Next: <a href="#Path-searching" accesskey="n" rel="next">Path searching</a>, Pre
every program, they are described here.
</p>
<dl compact="compact">
-<dt>&lsquo;<samp>--help</samp>&rsquo;</dt>
-<dd><span id="index-_002d_002dhelp-common-option"></span>
-<span id="index-help_002c-online"></span>
+<dt id='index-_002d_002dhelp-common-option'><span>&lsquo;<samp>--help</samp>&rsquo;<a href='#index-_002d_002dhelp-common-option' class='copiable-anchor'> &para;</a></span></dt>
+<dd><span id="index-help_002c-online"></span>
<p>Print a usage message listing basic usage and all available options to
standard output, then exit successfully.
</p>
</dd>
-<dt>&lsquo;<samp>--verbose</samp>&rsquo;</dt>
-<dd><span id="index-_002d_002dverbose-common-option"></span>
-<span id="index-verbosity_002c-enabling"></span>
+<dt id='index-_002d_002dverbose-common-option'><span>&lsquo;<samp>--verbose</samp>&rsquo;<a href='#index-_002d_002dverbose-common-option' class='copiable-anchor'> &para;</a></span></dt>
+<dd><span id="index-verbosity_002c-enabling"></span>
<p>Print progress reports to standard output.
</p>
</dd>
-<dt>&lsquo;<samp>--version</samp>&rsquo;</dt>
-<dd><span id="index-_002d_002dversion-common-option"></span>
-<span id="index-version-number_002c-finding"></span>
+<dt id='index-_002d_002dversion-common-option'><span>&lsquo;<samp>--version</samp>&rsquo;<a href='#index-_002d_002dversion-common-option' class='copiable-anchor'> &para;</a></span></dt>
+<dd><span id="index-version-number_002c-finding"></span>
<p>Print the version number to standard output, then exit successfully.
</p></dd>
</dl>
@@ -733,19 +716,17 @@ standard output, then exit successfully.
common:
</p>
<dl compact="compact">
-<dt>&lsquo;<samp>-cnf-line=<var>str</var></samp>&rsquo;</dt>
-<dd><span id="index-_002dcnf_002dline"></span>
-<p>Parse <var>str</var> as if it were a line in the <samp>texmf.cnf</samp>
-configuration file, overriding all other settings. See <a href="https://tug.org/texinfohtml/kpathsea.html#Path-searching-options">Path
+<dt id='index-_002dcnf_002dline'><span>&lsquo;<samp>-cnf-line=<var>str</var></samp>&rsquo;<a href='#index-_002dcnf_002dline' class='copiable-anchor'> &para;</a></span></dt>
+<dd><p>Parse <var>str</var> as if it were a line in the <samp>texmf.cnf</samp>
+configuration file, overriding all other settings. See <a data-manual="kpathsea" href="https://tug.org/texinfohtml/kpathsea.html#Path-searching-options">Path
searching options</a> in <cite>Kpathsea</cite>.
</p>
</dd>
-<dt>&lsquo;<samp>-file-line-error</samp>&rsquo;</dt>
+<dt id='index-_002dno_002dfile_002dline_002derror'><span>&lsquo;<samp>-file-line-error</samp>&rsquo;<a href='#index-_002dno_002dfile_002dline_002derror' class='copiable-anchor'> &para;</a></span></dt>
<dd><span id="index-_002dfile_002dline_002derror"></span>
</dd>
-<dt>&lsquo;<samp>-no-file-line-error</samp>&rsquo;</dt>
-<dd><span id="index-_002dno_002dfile_002dline_002derror"></span>
-<span id="index-_002dfile_002dline_002derror_002dstyle"></span>
+<dt><span>&lsquo;<samp>-no-file-line-error</samp>&rsquo;</span></dt>
+<dd><span id="index-_002dfile_002dline_002derror_002dstyle"></span>
<span id="index-changing-error-messages-style"></span>
<p>Change (or do not change) the way error messages are printed. The
alternate style looks like error messages from many compilers and is
@@ -753,11 +734,10 @@ easier to parse for some editors that invoke TeX. This option used
to be called &lsquo;<samp>-file-line-error-style</samp>&rsquo;.
</p>
</dd>
-<dt>&lsquo;<samp>-fmt=<var>dumpname</var></samp>&rsquo;</dt>
-<dt>&lsquo;<samp>-base=<var>dumpname</var></samp>&rsquo;</dt>
-<dt>&lsquo;<samp>-mem=<var>dumpname</var></samp>&rsquo;</dt>
-<dd><span id="index-_002dfmt_003ddumpname"></span>
-<span id="index-_002dbase_003ddumpname"></span>
+<dt id='index-_002dfmt_003ddumpname'><span>&lsquo;<samp>-fmt=<var>dumpname</var></samp>&rsquo;<a href='#index-_002dfmt_003ddumpname' class='copiable-anchor'> &para;</a></span></dt>
+<dt><span>&lsquo;<samp>-base=<var>dumpname</var></samp>&rsquo;</span></dt>
+<dt><span>&lsquo;<samp>-mem=<var>dumpname</var></samp>&rsquo;</span></dt>
+<dd><span id="index-_002dbase_003ddumpname"></span>
<span id="index-_002dmem_003ddumpname"></span>
<span id="index-dump-file"></span>
<p>Use <var>dumpname</var> instead of the program name or a &lsquo;<samp>%&amp;</samp>&rsquo; line to
@@ -766,81 +746,72 @@ determine the name of the memory dump file read (&lsquo;<samp>fmt</samp>&rsquo;
&lsquo;<samp>-progname</samp>&rsquo; option was given.
</p>
</dd>
-<dt>&lsquo;<samp>-halt-on-error</samp>&rsquo;</dt>
-<dd><span id="index-_002dhalt_002don_002derror"></span>
-<span id="index-stopping-at-the-first-error"></span>
+<dt id='index-_002dhalt_002don_002derror'><span>&lsquo;<samp>-halt-on-error</samp>&rsquo;<a href='#index-_002dhalt_002don_002derror' class='copiable-anchor'> &para;</a></span></dt>
+<dd><span id="index-stopping-at-the-first-error"></span>
<p>Stop processing and exit when an error occurs, as opposed to the normal
process of trying to recover and continue.
</p>
</dd>
-<dt>&lsquo;<samp>-ini</samp>&rsquo;</dt>
-<dd><span id="index-_002dini"></span>
-<span id="index-program-names_002c-special"></span>
+<dt id='index-_002dini'><span>&lsquo;<samp>-ini</samp>&rsquo;<a href='#index-_002dini' class='copiable-anchor'> &para;</a></span></dt>
+<dd><span id="index-program-names_002c-special"></span>
<span id="index-initial-form_002c-enabling"></span>
<p>Enable the &ldquo;initial&rdquo; form of the program (see <a href="#Initial-and-virgin">Initial and virgin</a>). This is implicitly set if the program name is <code>initex</code>
resp. <code>inimf</code>.
</p>
</dd>
-<dt>&lsquo;<samp>-interaction=<var>string</var></samp>&rsquo;</dt>
-<dd><span id="index-_002dinteraction_003dstring"></span>
-<span id="index-interaction-mode"></span>
+<dt id='index-_002dinteraction_003dstring'><span>&lsquo;<samp>-interaction=<var>string</var></samp>&rsquo;<a href='#index-_002dinteraction_003dstring' class='copiable-anchor'> &para;</a></span></dt>
+<dd><span id="index-interaction-mode"></span>
<p>Set the interaction mode from the command line. The <var>string</var> must
be one of &lsquo;<samp>batchmode</samp>&rsquo;, &lsquo;<samp>nonstopmode</samp>&rsquo;, &lsquo;<samp>scrollmode</samp>&rsquo;, or
&lsquo;<samp>errorstopmode</samp>&rsquo;.
</p>
</dd>
-<dt>&lsquo;<samp>-jobname=<var>string</var></samp>&rsquo;</dt>
-<dd><span id="index-_002djobname_003dstring"></span>
-<span id="index-job-name"></span>
+<dt id='index-_002djobname_003dstring'><span>&lsquo;<samp>-jobname=<var>string</var></samp>&rsquo;<a href='#index-_002djobname_003dstring' class='copiable-anchor'> &para;</a></span></dt>
+<dd><span id="index-job-name"></span>
<p>Set the job name to <var>string</var>, instead of deriving it from the name
of the input file.
</p>
</dd>
-<dt>&lsquo;<samp>-kpathsea-debug=<var>number</var></samp>&rsquo;</dt>
-<dd><span id="index-_002dkpathsea_002ddebug_003dnumber"></span>
-<span id="index-KPATHSEA_005fDEBUG"></span>
+<dt id='index-_002dkpathsea_002ddebug_003dnumber'><span>&lsquo;<samp>-kpathsea-debug=<var>number</var></samp>&rsquo;<a href='#index-_002dkpathsea_002ddebug_003dnumber' class='copiable-anchor'> &para;</a></span></dt>
+<dd><span id="index-KPATHSEA_005fDEBUG"></span>
<span id="index-debugging-flags_002c-specifying"></span>
<span id="index-path-searching-debugging"></span>
<p>Set path searching debugging flags according to the bits of <var>number</var>
-(see <a href="https://tug.org/texinfohtml/kpathsea.html#Debugging">Debugging</a> in <cite>Kpathsea</cite>). You can also specify this in
+(see <a data-manual="kpathsea" href="https://tug.org/texinfohtml/kpathsea.html#Debugging">Debugging</a> in <cite>Kpathsea</cite>). You can also specify this in
<code>KPATHSEA_DEBUG</code> environment variable (for all Web2c programs).
(The command line value overrides.) The most useful value is &lsquo;<samp>-1</samp>&rsquo;,
to get all available output.
</p>
</dd>
-<dt>&lsquo;<samp>-output-directory=<var>dirname</var></samp>&rsquo;</dt>
-<dd><span id="index-_002doutput_002ddirectory"></span>
-<span id="index-output-directory_002c-specifying"></span>
+<dt id='index-_002doutput_002ddirectory'><span>&lsquo;<samp>-output-directory=<var>dirname</var></samp>&rsquo;<a href='#index-_002doutput_002ddirectory' class='copiable-anchor'> &para;</a></span></dt>
+<dd><span id="index-output-directory_002c-specifying"></span>
<p>Specify the directory <var>dirname</var> to which output files are written.
Also look for input files in <var>dirname</var> first, before looking along
the normal search path. See <a href="#Output-file-location">Output file location</a>.
</p>
</dd>
-<dt>&lsquo;<samp>-parse-first-line</samp>&rsquo;</dt>
+<dt id='index-_002dno_002dparse_002dfirst_002dline'><span>&lsquo;<samp>-parse-first-line</samp>&rsquo;<a href='#index-_002dno_002dparse_002dfirst_002dline' class='copiable-anchor'> &para;</a></span></dt>
<dd><span id="index-_002dparse_002dfirst_002dline"></span>
</dd>
-<dt>&lsquo;<samp>-no-parse-first-line</samp>&rsquo;</dt>
-<dd><span id="index-_002dno_002dparse_002dfirst_002dline"></span>
-<span id="index-parsing-the-first-line"></span>
+<dt><span>&lsquo;<samp>-no-parse-first-line</samp>&rsquo;</span></dt>
+<dd><span id="index-parsing-the-first-line"></span>
<p>Check or disable checking whether the first line of the main input
file starts with &lsquo;<samp>%&amp;</samp>&rsquo;, and parse it if it does. This line can be
used specify the format and/or a TCX file.
</p>
</dd>
-<dt>&lsquo;<samp>-progname=<var>string</var></samp>&rsquo;</dt>
-<dd><span id="index-_002dprogname_003dstring"></span>
-<span id="index-binaries_002c-linking"></span>
+<dt id='index-_002dprogname_003dstring'><span>&lsquo;<samp>-progname=<var>string</var></samp>&rsquo;<a href='#index-_002dprogname_003dstring' class='copiable-anchor'> &para;</a></span></dt>
+<dd><span id="index-binaries_002c-linking"></span>
<span id="index-linking-binaries"></span>
<span id="index-program-names_002c-special-1"></span>
<p>Set program (and memory dump) name to <var>string</var>. This may affect the
-search paths and other values used (see <a href="https://tug.org/texinfohtml/kpathsea.html#Config-files">Config files</a> in <cite>Kpathsea</cite>). Using this option is equivalent to making a link named
+search paths and other values used (see <a data-manual="kpathsea" href="https://tug.org/texinfohtml/kpathsea.html#Config-files">Config files</a> in <cite>Kpathsea</cite>). Using this option is equivalent to making a link named
<var>string</var> to the binary and then invoking the binary under that
name. See <a href="#Memory-dumps">Memory dumps</a>.
</p>
</dd>
-<dt>&lsquo;<samp>-recorder</samp>&rsquo;</dt>
-<dd><span id="index-_002drecorder"></span>
-<span id="index-file-recorder"></span>
+<dt id='index-_002drecorder'><span>&lsquo;<samp>-recorder</samp>&rsquo;<a href='#index-_002drecorder' class='copiable-anchor'> &para;</a></span></dt>
+<dd><span id="index-file-recorder"></span>
<p>Enable the filename recorder. This makes the program save a list of the
opened files into a file with (by default) extension &lsquo;<samp>.fls</samp>&rsquo;. For
Aleph, this option is always on, and the file has extension &lsquo;<samp>.ofl</samp>&rsquo;.
@@ -854,9 +825,8 @@ pid), as in <samp>texput1234.fls</samp>. You can use <samp>-jobname</samp> to
explicitly set the basename.
</p>
</dd>
-<dt>&lsquo;<samp>-translate-file=<var>tcxfile</var></samp>&rsquo;</dt>
-<dd><span id="index-_002dtranslate_002dfile_003dtcxfile"></span>
-<span id="index-translation-file-for-TeX_002c-specifying"></span>
+<dt id='index-_002dtranslate_002dfile_003dtcxfile'><span>&lsquo;<samp>-translate-file=<var>tcxfile</var></samp>&rsquo;<a href='#index-_002dtranslate_002dfile_003dtcxfile' class='copiable-anchor'> &para;</a></span></dt>
+<dd><span id="index-translation-file-for-TeX_002c-specifying"></span>
<span id="index-_002etcx-character-translation-files"></span>
<span id="index-first-line-of-the-main-input-file"></span>
<p>Use <var>tcxfile</var> to define which characters are printable and translations
@@ -864,12 +834,11 @@ between the internal and external character sets. Moreover,
<var>tcxfile</var> can be explicitly declared in the first line of the main
input file &lsquo;<samp>%&amp; -translate-file=<var>tcxfile</var></samp>&rsquo;.
This is the recommended method for portability reasons.
-See <a href="#TCX-files">TCX files</a>.
+See <a href="#TCX-files">TCX files: Character translations</a>.
</p>
</dd>
-<dt>&lsquo;<samp>-8bit</samp>&rsquo;</dt>
-<dd><span id="index-_002d8bit"></span>
-<span id="index-8-bit-clean"></span>
+<dt id='index-_002d8bit'><span>&lsquo;<samp>-8bit</samp>&rsquo;<a href='#index-_002d8bit' class='copiable-anchor'> &para;</a></span></dt>
+<dd><span id="index-8-bit-clean"></span>
<span id="index-8-bit-clean-output_002c-specifying"></span>
<p>This option specifies that by default all characters should be
considered printable. If &lsquo;<samp>-translate-file</samp>&rsquo; was given as well,
@@ -881,7 +850,9 @@ no-op in engines natively supporting Unicode.
<hr>
-<span id="Path-searching"></span><div class="header">
+</div>
+<div class="section" id="Path-searching">
+<div class="header">
<p>
Next: <a href="#Output-file-location" accesskey="n" rel="next">Output file location</a>, Previous: <a href="#Common-options" accesskey="p" rel="prev">Common options</a>, Up: <a href="#Commonalities" accesskey="u" rel="up">Commonalities</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
@@ -895,9 +866,9 @@ Next: <a href="#Output-file-location" accesskey="n" rel="next">Output file locat
the Kpathsea routines to do so. The precise names of the environment
and configuration file variables which get searched for particular file
formatted are therefore documented in the Kpathsea manual
-(see <a href="https://tug.org/texinfohtml/kpathsea.html#Supported-file-formats">Supported file formats</a> in <cite>Kpathsea</cite>). Reading
-<samp>texmf.cnf</samp> (see <a href="https://tug.org/texinfohtml/kpathsea.html#Config-files">Config files</a> in <cite>Kpathsea</cite>), invoking
-<code>mktex&hellip;</code> scripts (see <a href="https://tug.org/texinfohtml/kpathsea.html#mktex-scripts">mktex scripts</a> in <cite>Kpathsea</cite>), and so on are all handled by Kpathsea.
+(see <a data-manual="kpathsea" href="https://tug.org/texinfohtml/kpathsea.html#Supported-file-formats">Supported file formats</a> in <cite>Kpathsea</cite>). Reading
+<samp>texmf.cnf</samp> (see <a data-manual="kpathsea" href="https://tug.org/texinfohtml/kpathsea.html#Config-files">Config files</a> in <cite>Kpathsea</cite>), invoking
+<code>mktex&hellip;</code> scripts (see <a data-manual="kpathsea" href="https://tug.org/texinfohtml/kpathsea.html#mktex-scripts">mktex scripts</a> in <cite>Kpathsea</cite>), and so on are all handled by Kpathsea.
</p>
<span id="index-font-aliases"></span>
<span id="index-aliases-for-fonts"></span>
@@ -911,7 +882,9 @@ names.
</p>
<hr>
-<span id="Output-file-location"></span><div class="header">
+</div>
+<div class="section" id="Output-file-location">
+<div class="header">
<p>
Previous: <a href="#Path-searching" accesskey="p" rel="prev">Path searching</a>, Up: <a href="#Commonalities" accesskey="u" rel="up">Commonalities</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
@@ -953,9 +926,12 @@ simply checked as given.
</p>
<hr>
-<span id="Three-programs"></span><div class="header">
+</div>
+</div>
+<div class="chapter" id="Three-programs">
+<div class="header">
<p>
-Next: <a href="#TeX" accesskey="n" rel="next">TeX</a>, Previous: <a href="#Commonalities" accesskey="p" rel="prev">Commonalities</a>, Up: <a href="#Top" accesskey="u" rel="up">Top</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
+Next: <a href="#TeX" accesskey="n" rel="next">TeX: Typesetting</a>, Previous: <a href="#Commonalities" accesskey="p" rel="prev">Commonalities</a>, Up: <a href="#Top" accesskey="u" rel="up">Web2c</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
<span id="Three-programs_003a-Metafont_002c-MetaPost_002c-and-TeX"></span><h2 class="chapter">4 Three programs: Metafont, MetaPost, and TeX</h2>
@@ -968,24 +944,20 @@ Next: <a href="#TeX" accesskey="n" rel="next">TeX</a>, Previous: <a href="#Commo
Besides the ones here, command-line options and other commonalities
are described in the previous section.
</p>
-<table class="menu" border="0" cellspacing="0">
-<tr><td align="left" valign="top">&bull; <a href="#Runtime-options" accesskey="1">Runtime options</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top">The <samp>texmf.cnf</samp> configuration file.
-</td></tr>
-<tr><td align="left" valign="top">&bull; <a href="#Initial-and-virgin" accesskey="2">Initial and virgin</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top">Making memory dumps vs. production runs.
-</td></tr>
-<tr><td align="left" valign="top">&bull; <a href="#Memory-dumps" accesskey="3">Memory dumps</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top">.fmt/.base files for fast startup.
-</td></tr>
-<tr><td align="left" valign="top">&bull; <a href="#Editor-invocation" accesskey="4">Editor invocation</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top">The &lsquo;e&rsquo; response at errors.
-</td></tr>
-<tr><td align="left" valign="top">&bull; <a href="#g_t_005cinput-filenames" accesskey="5">\input filenames</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top">Filename delimiters and Kpathsea expansion.
-</td></tr>
-</table>
+<ul class="section-toc">
+<li><a href="#Runtime-options" accesskey="1">Runtime options</a></li>
+<li><a href="#Initial-and-virgin" accesskey="2">Initial and virgin</a></li>
+<li><a href="#Memory-dumps" accesskey="3">Memory dumps</a></li>
+<li><a href="#Editor-invocation" accesskey="4">Editor invocation</a></li>
+<li><a href="#g_t_005cinput-filenames" accesskey="5"><code>\input</code> filenames</a></li>
+</ul>
<hr>
-<span id="Runtime-options"></span><div class="header">
+<div class="section" id="Runtime-options">
+<div class="header">
<p>
-Next: <a href="#Initial-and-virgin" accesskey="n" rel="next">Initial and virgin</a>, Up: <a href="#Three-programs" accesskey="u" rel="up">Three programs</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
+Next: <a href="#Initial-and-virgin" accesskey="n" rel="next">Initial and virgin</a>, Up: <a href="#Three-programs" accesskey="u" rel="up">Three programs: Metafont, MetaPost, and TeX</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
<span id="Runtime-options-1"></span><h3 class="section">4.1 Runtime options</h3>
@@ -997,23 +969,19 @@ Next: <a href="#Initial-and-virgin" accesskey="n" rel="next">Initial and virgin<
<p>Besides the configure- and compile-time options described in the
installation section (see <a href="#Installation">Installation</a>), you can control a number
of parameters in the <samp>texmf.cnf</samp> runtime file read by Kpathsea
-(see <a href="https://tug.org/texinfohtml/kpathsea.html#Config-files">Config files</a> in <cite>Kpathsea</cite>).
+(see <a data-manual="kpathsea" href="https://tug.org/texinfohtml/kpathsea.html#Config-files">Config files</a> in <cite>Kpathsea</cite>).
</p>
<p>The main purpose of <samp>texmf.cnf</samp> is to specify search paths, but
array sizes and other options are also set there. Most are rather
obscure. Here are a few of the more interesting values:
</p>
<dl compact="compact">
-<dt>&lsquo;<samp>main_memory</samp>&rsquo;
-<span id="index-main_005fmemory"></span>
-</dt>
+<dt id='index-main_005fmemory'><span>&lsquo;<samp>main_memory</samp>&rsquo;<a href='#index-main_005fmemory' class='copiable-anchor'> &para;</a></span></dt>
<dd><p>Total words of memory available, for TeX, Metafont, and MetaPost.
Must remake the format file after changing.
</p>
</dd>
-<dt>&lsquo;<samp>extra_mem_bot</samp>&rsquo;
-<span id="index-extra_005fmem_005fbot"></span>
-</dt>
+<dt id='index-extra_005fmem_005fbot'><span>&lsquo;<samp>extra_mem_bot</samp>&rsquo;<a href='#index-extra_005fmem_005fbot' class='copiable-anchor'> &para;</a></span></dt>
<dd><span id="index-boxes_002c-memory-for"></span>
<span id="index-glue_002c-memory-for"></span>
<span id="index-breakpoints_002c-memory-for"></span>
@@ -1023,9 +991,7 @@ glue, breakpoints, et al. If you use PiCTeX, you may well want to
set this.
</p>
</dd>
-<dt>&lsquo;<samp>expand_depth</samp>&rsquo;
-<span id="index-expand_005fdepth"></span>
-</dt>
+<dt id='index-expand_005fdepth'><span>&lsquo;<samp>expand_depth</samp>&rsquo;<a href='#index-expand_005fdepth' class='copiable-anchor'> &para;</a></span></dt>
<dd><span id="index-recursive-expansion-limit"></span>
<span id="index-expansion-limit_002c-recursive"></span>
<span id="index-runtime-stack-overflow"></span>
@@ -1051,10 +1017,8 @@ using the libsigsegv library (<a href="https://gnu.org/s/libsigsegv">https://gnu
not seem worth the effort.
</p>
</dd>
-<dt>&lsquo;<samp>texmf_casefold_search</samp>&rsquo;
-<span id="index-texmf_005fcasefold_005fsearch"></span>
-</dt>
-<dd><p>See <a href="https://tug.org/texinfohtml/kpathsea.html#Casefolding-search">Casefolding search</a> in <cite>Kpathsea</cite>.
+<dt id='index-texmf_005fcasefold_005fsearch'><span>&lsquo;<samp>texmf_casefold_search</samp>&rsquo;<a href='#index-texmf_005fcasefold_005fsearch' class='copiable-anchor'> &para;</a></span></dt>
+<dd><p>See <a data-manual="kpathsea" href="https://tug.org/texinfohtml/kpathsea.html#Casefolding-search">Casefolding search</a> in <cite>Kpathsea</cite>.
</p>
</dd>
</dl>
@@ -1090,9 +1054,11 @@ affecting your local values.
</p>
<hr>
-<span id="Initial-and-virgin"></span><div class="header">
+</div>
+<div class="section" id="Initial-and-virgin">
+<div class="header">
<p>
-Next: <a href="#Memory-dumps" accesskey="n" rel="next">Memory dumps</a>, Previous: <a href="#Runtime-options" accesskey="p" rel="prev">Runtime options</a>, Up: <a href="#Three-programs" accesskey="u" rel="up">Three programs</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
+Next: <a href="#Memory-dumps" accesskey="n" rel="next">Memory dumps</a>, Previous: <a href="#Runtime-options" accesskey="p" rel="prev">Runtime options</a>, Up: <a href="#Three-programs" accesskey="u" rel="up">Three programs: Metafont, MetaPost, and TeX</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
<span id="Initial-and-virgin-1"></span><h3 class="section">4.2 Initial and virgin</h3>
@@ -1124,9 +1090,11 @@ memory dump file.
</p>
<hr>
-<span id="Memory-dumps"></span><div class="header">
+</div>
+<div class="section" id="Memory-dumps">
+<div class="header">
<p>
-Next: <a href="#Editor-invocation" accesskey="n" rel="next">Editor invocation</a>, Previous: <a href="#Initial-and-virgin" accesskey="p" rel="prev">Initial and virgin</a>, Up: <a href="#Three-programs" accesskey="u" rel="up">Three programs</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
+Next: <a href="#Editor-invocation" accesskey="n" rel="next">Editor invocation</a>, Previous: <a href="#Initial-and-virgin" accesskey="p" rel="prev">Initial and virgin</a>, Up: <a href="#Three-programs" accesskey="u" rel="up">Three programs: Metafont, MetaPost, and TeX</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
<span id="Memory-dumps-1"></span><h3 class="section">4.3 Memory dumps</h3>
@@ -1140,18 +1108,16 @@ macros to be predefined; therefore, they support <em>memory dump</em>
files, which can be read much more efficiently than ordinary source
code.
</p>
-<table class="menu" border="0" cellspacing="0">
-<tr><td align="left" valign="top">&bull; <a href="#Creating-memory-dumps" accesskey="1">Creating memory dumps</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
-</td></tr>
-<tr><td align="left" valign="top">&bull; <a href="#Determining-the-memory-dump-to-use" accesskey="2">Determining the memory dump to use</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
-</td></tr>
-<tr><td align="left" valign="top">&bull; <a href="#Hardware-and-memory-dumps" accesskey="3">Hardware and memory dumps</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
-</td></tr>
-</table>
+<ul class="section-toc">
+<li><a href="#Creating-memory-dumps" accesskey="1">Creating memory dumps</a></li>
+<li><a href="#Determining-the-memory-dump-to-use" accesskey="2">Determining the memory dump to use</a></li>
+<li><a href="#Hardware-and-memory-dumps" accesskey="3">Hardware and memory dumps</a></li>
+</ul>
<hr>
-<span id="Creating-memory-dumps"></span><div class="header">
+<div class="subsection" id="Creating-memory-dumps">
+<div class="header">
<p>
Next: <a href="#Determining-the-memory-dump-to-use" accesskey="n" rel="next">Determining the memory dump to use</a>, Up: <a href="#Memory-dumps" accesskey="u" rel="up">Memory dumps</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
@@ -1176,11 +1142,11 @@ example).
creating memory dumps:
</p>
<dl compact="compact">
-<dt>TeX</dt>
+<dt><span>TeX</span></dt>
<dd><p>(&lsquo;<samp>.fmt</samp>&rsquo;) See <a href="#Initial-TeX">Initial TeX</a>.
</p>
</dd>
-<dt>Metafont</dt>
+<dt><span>Metafont</span></dt>
<dd><p>(&lsquo;<samp>.base</samp>&rsquo;) See <a href="#Initial-Metafont">Initial Metafont</a>.
</p></dd>
</dl>
@@ -1193,7 +1159,9 @@ difficulties.
</p>
<hr>
-<span id="Determining-the-memory-dump-to-use"></span><div class="header">
+</div>
+<div class="subsection" id="Determining-the-memory-dump-to-use">
+<div class="header">
<p>
Next: <a href="#Hardware-and-memory-dumps" accesskey="n" rel="next">Hardware and memory dumps</a>, Previous: <a href="#Creating-memory-dumps" accesskey="p" rel="prev">Creating memory dumps</a>, Up: <a href="#Memory-dumps" accesskey="u" rel="up">Memory dumps</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
@@ -1230,7 +1198,7 @@ command line, not in response to &lsquo;<samp>**</samp>&rsquo;) is <code>%&amp;<
<p>The first line of the main input file can also specify which character
translation file is to be used: <code>%&amp;-translate-file=<var>tcxfile</var></code>
-(see <a href="#TCX-files">TCX files</a>).
+(see <a href="#TCX-files">TCX files: Character translations</a>).
</p>
<p>These two roles can be combined: <code>%&amp;<var>dump</var>
-translate-file=<var>tcxfile</var></code>. If this is done, the name of the dump
@@ -1247,7 +1215,9 @@ will be used.
<hr>
-<span id="Hardware-and-memory-dumps"></span><div class="header">
+</div>
+<div class="subsection" id="Hardware-and-memory-dumps">
+<div class="header">
<p>
Previous: <a href="#Determining-the-memory-dump-to-use" accesskey="p" rel="prev">Determining the memory dump to use</a>, Up: <a href="#Memory-dumps" accesskey="u" rel="up">Memory dumps</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
@@ -1266,24 +1236,34 @@ Previous: <a href="#Determining-the-memory-dump-to-use" accesskey="p" rel="prev"
<span id="index-machine-dependencies"></span>
<span id="index-architecture-dependencies"></span>
<span id="index-dependencies_002c-hardware"></span>
-<span id="index-_002d_002ddisable_002ddump_002dshare-configure-option"></span>
-<p>By default, memory dump files are generally sharable between
-architectures of different types; specifically, on machines of different
-endianness (see <a href="https://www.gnu.org/software/libc/manual/html_mono/libc.html#Byte-order">Byte order</a> in <cite>GNU C Library</cite>). (This is a
+<span id="index-32_002dbit-architecture"></span>
+<span id="index-64_002dbit-architecture"></span>
+<span id="index-long-data-type_002c-size-of"></span>
+<p>By default, memory dump files are sharable between architectures of
+different types; specifically, on machines of different endianness
+(see <a data-manual="libc" href="https://www.gnu.org/software/libc/manual/html_mono/libc.html#Byte-order">Byte order</a> in <cite>GNU C Library</cite>) and with different word
+sizes (4-byte <code>long</code> vs. 8-byte <code>long</code>). This is a
feature of the Web2c implementation, and is not true of all TeX
-implementations.) If you specify &lsquo;<samp>--disable-dump-share</samp>&rsquo; to
-<code>configure</code>, however, memory dumps will be endian-dependent.
+implementations.
+</p>
+<span id="index-tl_002dcheck_002dfmtshare"></span>
+<p>The script <code>tl-check-fmtshare</code> in the TeX Live source tree
+(<samp>Master/tlpkg/bin</samp>) provides a relatively easy way to test that
+a <samp>.fmt</samp> built on the local host can be loaded by a TeX engine
+built on some remote host.
</p>
<span id="index-byte-swapping"></span>
<span id="index-swapping-bytes"></span>
-<p>The reason to do this is speed. To achieve endian-independence, the
-reading of memory dumps on LittleEndian architectures, such as PC&rsquo;s and
-DEC architectures, is somewhat slowed (all the multibyte values have to
-be swapped). Usually, this is not noticeable, and the advantage of
-being able to share memory dumps across all platforms at a site far
-outweighs the speed loss. But if you&rsquo;re installing Web2c for use on
-LittleEndian machines only, perhaps on a PC being used only by you, you
-may wish to get maximum speed.
+<span id="index-_002d_002ddisable_002ddump_002dshare-configure-option"></span>
+<p>If you specify &lsquo;<samp>--disable-dump-share</samp>&rsquo; to <code>configure</code>,
+however, memory dumps will be endian-dependent. The reason to do this
+is speed. To achieve endian-independence, the reading of memory dumps
+on LittleEndian architectures, such as PC&rsquo;s and DEC architectures, is
+somewhat slowed (all the multibyte values have to be swapped).
+Usually, this is not noticeable, and the advantage of being able to
+share memory dumps across all platforms at a site far outweighs the
+speed loss. But if you&rsquo;re trying to squeeze out every possible bit of
+performance, you may wish to do this.
</p>
<span id="index-floating_002dpoint-values"></span>
<span id="index-glue-ratio-representations"></span>
@@ -1291,8 +1271,8 @@ may wish to get maximum speed.
<samp>.fmt</samp> files cannot be guaranteed to work. Floating-point values
are always written in native format, and hence will generally not be
readable across platforms. Fortunately, TeX uses floating point
-only to represent glue ratios, and all common formats (plain,
-LaTeX, AMSTeX, &hellip;) do not do any glue setting at
+only to represent glue ratios, and none of the common formats (plain,
+LaTeX, AMSTeX, &hellip;) do any glue setting at
<samp>.fmt</samp>-creation time. Metafont does not use floating point in
any dumped value at all.
</p>
@@ -1300,8 +1280,8 @@ any dumped value at all.
<span id="index-time-and-date_002c-in-memory-dumps"></span>
<span id="index-memory-dumps_002c-contain-date-and-time"></span>
<p>Incidentally, different memory dump files will never compare equal
-byte-for-byte, because the program always dumps the current date and
-time. So don&rsquo;t be alarmed by just a few bytes difference.
+byte-for-byte, because the programs dump the current date and time. So
+don&rsquo;t be alarmed by a few bytes difference.
</p>
<span id="index-Harbison_002c-Samuel-P_002e"></span>
<span id="index-Steele-Jr_002e_002c-Guy-L_002e"></span>
@@ -1332,11 +1312,17 @@ Jr. (see <a href="#References">References</a>).
}
</pre></div>
+<p>You can add <code>printf(&quot;long %d\n&quot;, sizeof(long));</code> to see the size
+of the <code>long</code> data type.
+</p>
<hr>
-<span id="Editor-invocation"></span><div class="header">
+</div>
+</div>
+<div class="section" id="Editor-invocation">
+<div class="header">
<p>
-Next: <a href="#g_t_005cinput-filenames" accesskey="n" rel="next">\input filenames</a>, Previous: <a href="#Memory-dumps" accesskey="p" rel="prev">Memory dumps</a>, Up: <a href="#Three-programs" accesskey="u" rel="up">Three programs</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
+Next: <a href="#g_t_005cinput-filenames" accesskey="n" rel="next"><code>\input</code> filenames</a>, Previous: <a href="#Memory-dumps" accesskey="p" rel="prev">Memory dumps</a>, Up: <a href="#Three-programs" accesskey="u" rel="up">Three programs: Metafont, MetaPost, and TeX</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
<span id="Editor-invocation-1"></span><h3 class="section">4.4 Editor invocation</h3>
@@ -1366,9 +1352,11 @@ and &lsquo;<samp>%s</samp>&rsquo; is replaced by the name of the current input f
</p>
<hr>
-<span id="g_t_005cinput-filenames"></span><div class="header">
+</div>
+<div class="section" id="g_t_005cinput-filenames">
+<div class="header">
<p>
-Previous: <a href="#Editor-invocation" accesskey="p" rel="prev">Editor invocation</a>, Up: <a href="#Three-programs" accesskey="u" rel="up">Three programs</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
+Previous: <a href="#Editor-invocation" accesskey="p" rel="prev">Editor invocation</a>, Up: <a href="#Three-programs" accesskey="u" rel="up">Three programs: Metafont, MetaPost, and TeX</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
<span id="g_t_005cinput-filenames-1"></span><h3 class="section">4.5 <code>\input</code> filenames</h3>
@@ -1394,7 +1382,7 @@ with the primitive operation.)
</p>
<p>As (allowed) extensions to standard TeX, Web2c also supports
specifying the filename in double quotes (<code>&quot;some name&quot;</code>) and in
-braces (<code>{&quot;some name&quot;}</code>), which is convenient for filenames
+braces (<code>{some name}</code>), which is convenient for filenames
containing spaces or other special characters, as described in the
sections below.
</p>
@@ -1412,20 +1400,18 @@ most one &lsquo;<samp>.</samp>&rsquo;. Do not use anything but simple filenames
directory separators vary among systems; instead, add the necessary
directories to the appropriate search path.
</p>
-<table class="menu" border="0" cellspacing="0">
-<tr><td align="left" valign="top">&bull; <a href="#g_t_005cinput-quoted-filename" accesskey="1">Quotes</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top">\input &quot;some name&quot;
-</td></tr>
-<tr><td align="left" valign="top">&bull; <a href="#g_t_005cinput-braced-filename" accesskey="2">Braces</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top">\input {some name}
-</td></tr>
-<tr><td align="left" valign="top">&bull; <a href="#g_t_005cinput-filename-caveats" accesskey="3">Caveats</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top">Tokenization, nulls, Kpathsea expansion.
-</td></tr>
-</table>
+<ul class="section-toc">
+<li><a href="#g_t_005cinput-quoted-filename" accesskey="1"><code>\input</code> quoted filename: <code>\input &quot;some name&quot;</code></a></li>
+<li><a href="#g_t_005cinput-braced-filename" accesskey="2"><code>\input</code> braced filename: <code>\input{some name}</code></a></li>
+<li><a href="#g_t_005cinput-filename-caveats" accesskey="3"><code>\input</code> filename caveats</a></li>
+</ul>
<hr>
-<span id="g_t_005cinput-quoted-filename"></span><div class="header">
+<div class="subsection" id="g_t_005cinput-quoted-filename">
+<div class="header">
<p>
-Next: <a href="#g_t_005cinput-braced-filename" accesskey="n" rel="next">\input braced filename</a>, Up: <a href="#g_t_005cinput-filenames" accesskey="u" rel="up">\input filenames</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
+Next: <a href="#g_t_005cinput-braced-filename" accesskey="n" rel="next"><code>\input</code> braced filename: <code>\input{some name}</code></a>, Up: <a href="#g_t_005cinput-filenames" accesskey="u" rel="up"><code>\input</code> filenames</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
<span id="g_t_005cinput-quoted-filename_003a-_005cinput-_0022some-name_0022"></span><h4 class="subsection">4.5.1 <code>\input</code> quoted filename: <code>\input &quot;some name&quot;</code></h4>
@@ -1456,9 +1442,11 @@ of its <code>\input</code> macro, thus:
</p>
<hr>
-<span id="g_t_005cinput-braced-filename"></span><div class="header">
+</div>
+<div class="subsection" id="g_t_005cinput-braced-filename">
+<div class="header">
<p>
-Next: <a href="#g_t_005cinput-filename-caveats" accesskey="n" rel="next">\input filename caveats</a>, Previous: <a href="#g_t_005cinput-quoted-filename" accesskey="p" rel="prev">\input quoted filename</a>, Up: <a href="#g_t_005cinput-filenames" accesskey="u" rel="up">\input filenames</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
+Next: <a href="#g_t_005cinput-filename-caveats" accesskey="n" rel="next"><code>\input</code> filename caveats</a>, Previous: <a href="#g_t_005cinput-quoted-filename" accesskey="p" rel="prev"><code>\input</code> quoted filename: <code>\input &quot;some name&quot;</code></a>, Up: <a href="#g_t_005cinput-filenames" accesskey="u" rel="up"><code>\input</code> filenames</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
<span id="g_t_005cinput-braced-filename_003a-_005cinput_007bsome-name_007d"></span><h4 class="subsection">4.5.2 <code>\input</code> braced filename: <code>\input{some name}</code></h4>
@@ -1487,9 +1475,11 @@ within the filename.
</p>
<hr>
-<span id="g_t_005cinput-filename-caveats"></span><div class="header">
+</div>
+<div class="subsection" id="g_t_005cinput-filename-caveats">
+<div class="header">
<p>
-Previous: <a href="#g_t_005cinput-braced-filename" accesskey="p" rel="prev">\input braced filename</a>, Up: <a href="#g_t_005cinput-filenames" accesskey="u" rel="up">\input filenames</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
+Previous: <a href="#g_t_005cinput-braced-filename" accesskey="p" rel="prev"><code>\input</code> braced filename: <code>\input{some name}</code></a>, Up: <a href="#g_t_005cinput-filenames" accesskey="u" rel="up"><code>\input</code> filenames</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
<span id="g_t_005cinput-filename-caveats-1"></span><h4 class="subsection">4.5.3 <code>\input</code> filename caveats</h4>
@@ -1538,9 +1528,13 @@ change their catcodes or use <code>\string</code>.
</p>
<hr>
-<span id="TeX"></span><div class="header">
+</div>
+</div>
+</div>
+<div class="chapter" id="TeX">
+<div class="header">
<p>
-Next: <a href="#Metafont" accesskey="n" rel="next">Metafont</a>, Previous: <a href="#Three-programs" accesskey="p" rel="prev">Three programs</a>, Up: <a href="#Top" accesskey="u" rel="up">Top</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
+Next: <a href="#Metafont" accesskey="n" rel="next">Metafont: Creating typeface families</a>, Previous: <a href="#Three-programs" accesskey="p" rel="prev">Three programs: Metafont, MetaPost, and TeX</a>, Up: <a href="#Top" accesskey="u" rel="up">Web2c</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
<span id="TeX_003a-Typesetting"></span><h2 class="chapter">5 TeX: Typesetting</h2>
@@ -1562,28 +1556,22 @@ description of the TeX language, see <cite>The TeXbook</cite>
(see <a href="#References">References</a>). Many other books on TeX, introductory and
otherwise, are available.
</p>
-<table class="menu" border="0" cellspacing="0">
-<tr><td align="left" valign="top">&bull; <a href="#tex-invocation" accesskey="1">tex invocation</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top">Invoking TeX.
-</td></tr>
-<tr><td align="left" valign="top">&bull; <a href="#Initial-TeX" accesskey="2">Initial TeX</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top">Making format files.
-</td></tr>
-<tr><td align="left" valign="top">&bull; <a href="#Formats" accesskey="3">Formats</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top">Major TeX macro packages.
-</td></tr>
-<tr><td align="left" valign="top">&bull; <a href="#Languages-and-hyphenation" accesskey="4">Languages and hyphenation</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top">TeX supports many human languages.
-</td></tr>
-<tr><td align="left" valign="top">&bull; <a href="#Shell-escapes" accesskey="5">Shell escapes</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top">Running subprograms from TeX.
-</td></tr>
-<tr><td align="left" valign="top">&bull; <a href="#IPC-and-TeX" accesskey="6">IPC and TeX</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top">DVI output to a socket.
-</td></tr>
-<tr><td align="left" valign="top">&bull; <a href="#TeX-extensions" accesskey="7">TeX extensions</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top">Additional engines with additional features.
-</td></tr>
-</table>
+<ul class="section-toc">
+<li><a href="#tex-invocation" accesskey="1"><code>tex</code> invocation</a></li>
+<li><a href="#Initial-TeX" accesskey="2">Initial TeX</a></li>
+<li><a href="#Formats" accesskey="3">Formats</a></li>
+<li><a href="#Languages-and-hyphenation" accesskey="4">Languages and hyphenation</a></li>
+<li><a href="#Shell-escapes" accesskey="5">Shell escapes</a></li>
+<li><a href="#IPC-and-TeX" accesskey="6">IPC and TeX</a></li>
+<li><a href="#TeX-extensions" accesskey="7">Extended TeX engines</a></li>
+</ul>
<hr>
-<span id="tex-invocation"></span><div class="header">
+<div class="section" id="tex-invocation">
+<div class="header">
<p>
-Next: <a href="#Initial-TeX" accesskey="n" rel="next">Initial TeX</a>, Up: <a href="#TeX" accesskey="u" rel="up">TeX</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
+Next: <a href="#Initial-TeX" accesskey="n" rel="next">Initial TeX</a>, Up: <a href="#TeX" accesskey="u" rel="up">TeX: Typesetting</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
<span id="tex-invocation-1"></span><h3 class="section">5.1 <code>tex</code> invocation</h3>
@@ -1610,7 +1598,7 @@ tex [<var>option</var>]&hellip; &amp;<var>fmt</var> <var>args</var>
<span id="index-_002etex"></span>
<span id="index-TeX_002c-input-files-found"></span>
<p>TeX searches the usual places for the main input file <var>texname</var>
-(see <a href="https://tug.org/texinfohtml/kpathsea.html#Supported-file-formats">Supported file formats</a> in <cite>Kpathsea</cite>), extending
+(see <a data-manual="kpathsea" href="https://tug.org/texinfohtml/kpathsea.html#Supported-file-formats">Supported file formats</a> in <cite>Kpathsea</cite>), extending
<var>texname</var> with <samp>.tex</samp> if necessary. To see all the
relevant paths, set the environment variable <code>KPATHSEA_DEBUG</code> to
&lsquo;<samp>-1</samp>&rsquo; before running the program.
@@ -1632,7 +1620,7 @@ file is a device-independent binary representation of your TeX
document. The idea is that after running TeX, you translate the DVI
file using a separate program to the commands for a particular output
device, such as a PostScript printer
-(see <a href="https://tug.org/texinfohtml/dvips.html#Top">Introduction</a> in <cite>Dvips</cite>) or an X Window System display
+(see <a data-manual="dvips" href="https://tug.org/texinfohtml/dvips.html#Top">Introduction</a> in <cite>Dvips</cite>) or an X Window System display
(see xdvi(1)).
</p>
<span id="index-EC-fonts"></span>
@@ -1641,7 +1629,7 @@ device, such as a PostScript printer
<p>TeX also reads TFM files for any fonts you load in your document with
the <code>\font</code> primitive. By default, it runs an external program
named <samp>mktextfm</samp> to create any nonexistent TFM files. You can
-disable this at configure-time or runtime (see <a href="https://tug.org/texinfohtml/kpathsea.html#mktex-configuration">mktex
+disable this at configure-time or runtime (see <a data-manual="kpathsea" href="https://tug.org/texinfohtml/kpathsea.html#mktex-configuration">mktex
configuration</a> in <cite>Kpathsea</cite>). This is enabled mostly for the
sake of the EC fonts, which can be generated at any size.
</p>
@@ -1656,7 +1644,7 @@ a security hole vulnerable to Trojan horse attack: an unwitting user could
run a TeX program that overwrites, say, <samp>~/.rhosts</samp>. (MetaPost has
a <code>write</code> primitive with similar implications). To alleviate this and
similar problems the functions <code>kpathsea_out_name_ok</code> and
-<code>kpathsea_in_name_ok</code> from the Kpathse library (see <a href="https://tug.org/texinfohtml/kpathsea.html#Calling-sequence">Calling
+<code>kpathsea_in_name_ok</code> from the Kpathsea library (see <a data-manual="kpathsea" href="https://tug.org/texinfohtml/kpathsea.html#Calling-sequence">Calling
sequence</a> in <cite>Kpathsea</cite>) are used to determine if a given filename
is acceptable to be opened for output or input, depending on the setting of
the configuration variables <code>openout_any</code> and <code>openin_any</code>:
@@ -1671,29 +1659,28 @@ the log file has not yet been opened.
<p>The program accepts the following options, as well as the standard
&lsquo;<samp>-help</samp>&rsquo; and &lsquo;<samp>-version</samp>&rsquo; (see <a href="#Common-options">Common options</a>):
</p><dl compact="compact">
-<dt>&lsquo;<samp>-enc</samp>&rsquo;</dt>
-<dt>&lsquo;<samp>-[no]-file-line-error</samp>&rsquo;</dt>
-<dt>&lsquo;<samp>-fmt=<var>fmtname</var></samp>&rsquo;</dt>
-<dt>&lsquo;<samp>-halt-on-error</samp>&rsquo;</dt>
-<dt>&lsquo;<samp>-ini</samp>&rsquo;</dt>
-<dt>&lsquo;<samp>-interaction=<var>string</var></samp>&rsquo;</dt>
-<dt>&lsquo;<samp>-ipc</samp>&rsquo;</dt>
-<dt>&lsquo;<samp>-ipc-start</samp>&rsquo;</dt>
-<dt>&lsquo;<samp>-jobname=<var>string</var></samp>&rsquo;</dt>
-<dt>&lsquo;<samp>-kpathsea-debug=<var>number</var></samp>&rsquo;</dt>
-<dt>&lsquo;<samp>-[no]parse-first-line</samp>&rsquo;</dt>
-<dt>&lsquo;<samp>-output-directory</samp>&rsquo;</dt>
-<dt>&lsquo;<samp>-progname=<var>string</var></samp>&rsquo;</dt>
-<dt>&lsquo;<samp>-recorder</samp>&rsquo;</dt>
-<dt>&lsquo;<samp>-translate-file=<var>tcxfile</var></samp>&rsquo;</dt>
-<dt>&lsquo;<samp>-8bit</samp>&rsquo;</dt>
+<dt><span>&lsquo;<samp>-enc</samp>&rsquo;</span></dt>
+<dt><span>&lsquo;<samp>-[no]-file-line-error</samp>&rsquo;</span></dt>
+<dt><span>&lsquo;<samp>-fmt=<var>fmtname</var></samp>&rsquo;</span></dt>
+<dt><span>&lsquo;<samp>-halt-on-error</samp>&rsquo;</span></dt>
+<dt><span>&lsquo;<samp>-ini</samp>&rsquo;</span></dt>
+<dt><span>&lsquo;<samp>-interaction=<var>string</var></samp>&rsquo;</span></dt>
+<dt><span>&lsquo;<samp>-ipc</samp>&rsquo;</span></dt>
+<dt><span>&lsquo;<samp>-ipc-start</samp>&rsquo;</span></dt>
+<dt><span>&lsquo;<samp>-jobname=<var>string</var></samp>&rsquo;</span></dt>
+<dt><span>&lsquo;<samp>-kpathsea-debug=<var>number</var></samp>&rsquo;</span></dt>
+<dt><span>&lsquo;<samp>-[no]parse-first-line</samp>&rsquo;</span></dt>
+<dt><span>&lsquo;<samp>-output-directory</samp>&rsquo;</span></dt>
+<dt><span>&lsquo;<samp>-progname=<var>string</var></samp>&rsquo;</span></dt>
+<dt><span>&lsquo;<samp>-recorder</samp>&rsquo;</span></dt>
+<dt><span>&lsquo;<samp>-translate-file=<var>tcxfile</var></samp>&rsquo;</span></dt>
+<dt><span>&lsquo;<samp>-8bit</samp>&rsquo;</span></dt>
<dd><p>These options are common to TeX, Metafont, and MetaPost.
See <a href="#Common-options">Common options</a>.
</p>
</dd>
-<dt>&lsquo;<samp>-enc</samp>&rsquo;</dt>
-<dd><span id="index-_002denc"></span>
-<span id="index-Unicode-input"></span>
+<dt id='index-_002denc'><span>&lsquo;<samp>-enc</samp>&rsquo;<a href='#index-_002denc' class='copiable-anchor'> &para;</a></span></dt>
+<dd><span id="index-Unicode-input"></span>
<span id="index-UTF_002d8-input"></span>
<p>Enable encTeX extensions, such as <code>\mubyte</code>. This can be used
to support the Unicode UTF-8 input encoding, although using an engine
@@ -1701,10 +1688,9 @@ with native Unicode support is more common nowadays.
<a href="http://www.olsak.net/enctex.html">http://www.olsak.net/enctex.html</a>.
</p>
</dd>
-<dt>&lsquo;<samp>-ipc</samp>&rsquo;</dt>
-<dt>&lsquo;<samp>-ipc-start</samp>&rsquo;</dt>
-<dd><span id="index-_002dipc"></span>
-<span id="index-_002dipc_002dstart"></span>
+<dt id='index-_002dipc'><span>&lsquo;<samp>-ipc</samp>&rsquo;<a href='#index-_002dipc' class='copiable-anchor'> &para;</a></span></dt>
+<dt><span>&lsquo;<samp>-ipc-start</samp>&rsquo;</span></dt>
+<dd><span id="index-_002dipc_002dstart"></span>
<span id="index-_002d_002denable_002dipc-configure-option"></span>
<p>With either option, TeX writes its DVI output to a socket as well as
to the usual <samp>.dvi</samp> file. With &lsquo;<samp>-ipc-start</samp>&rsquo;, TeX also
@@ -1714,27 +1700,24 @@ opens a server program at the other end to read the output. See <a href="#IPC-a
specified to <code>configure</code> during installation of Web2c.
</p>
</dd>
-<dt>&lsquo;<samp>-mktex=<var>filetype</var></samp>&rsquo;</dt>
-<dt>&lsquo;<samp>-no-mktex=<var>filetype</var></samp>&rsquo;</dt>
-<dd><span id="index-_002dmktex_003dfiletype"></span>
-<span id="index-_002dno_002dmktex_003dfiletype"></span>
+<dt id='index-_002dmktex_003dfiletype'><span>&lsquo;<samp>-mktex=<var>filetype</var></samp>&rsquo;<a href='#index-_002dmktex_003dfiletype' class='copiable-anchor'> &para;</a></span></dt>
+<dt><span>&lsquo;<samp>-no-mktex=<var>filetype</var></samp>&rsquo;</span></dt>
+<dd><span id="index-_002dno_002dmktex_003dfiletype"></span>
<p>Turn on or off the &lsquo;<samp>mktex</samp>&rsquo; script associated with <var>filetype</var>.
For TeX proper, <var>filetype</var> can only be &lsquo;<samp>tex</samp>&rsquo; and
&lsquo;<samp>tfm</samp>&rsquo;, but for pdfTeX and luaTeX, it can also be &lsquo;<samp>pk</samp>&rsquo;.
</p>
</dd>
-<dt>&lsquo;<samp>-mltex</samp>&rsquo;</dt>
-<dd><span id="index-_002dmltex"></span>
-<span id="index-MLTeX_002c-enabling"></span>
+<dt id='index-_002dmltex'><span>&lsquo;<samp>-mltex</samp>&rsquo;<a href='#index-_002dmltex' class='copiable-anchor'> &para;</a></span></dt>
+<dd><span id="index-MLTeX_002c-enabling"></span>
<span id="index-program-names_002c-special-2"></span>
<p>If we are <code>INITEX</code> (see <a href="#Initial-and-virgin">Initial and virgin</a>), enable MLTeX
extensions such as <code>\charsubdef</code>. Implicitly set if the program
name is <code>mltex</code>. See <a href="#MLTeX">MLTeX</a>.
</p>
</dd>
-<dt>&lsquo;<samp>-output-comment=<var>string</var></samp>&rsquo;</dt>
-<dd><span id="index-_002doutput_002dcomment_003dstring"></span>
-<span id="index-output_005fcomment-for-DVI-files"></span>
+<dt id='index-_002doutput_002dcomment_003dstring'><span>&lsquo;<samp>-output-comment=<var>string</var></samp>&rsquo;<a href='#index-_002doutput_002dcomment_003dstring' class='copiable-anchor'> &para;</a></span></dt>
+<dd><span id="index-output_005fcomment-for-DVI-files"></span>
<span id="index-DVI-comment_002c-specifying"></span>
<span id="index-regression-testing"></span>
<p>Use <var>string</var> as the DVI file comment. Ordinarily, this comment
@@ -1744,33 +1727,30 @@ difference. This is also taken from the environment variable and
config file value &lsquo;<samp>output_comment</samp>&rsquo;.
</p>
</dd>
-<dt>&lsquo;<samp>-shell-escape</samp>&rsquo;</dt>
+<dt id='index-_002dshell_002drestricted'><span>&lsquo;<samp>-shell-escape</samp>&rsquo;<a href='#index-_002dshell_002drestricted' class='copiable-anchor'> &para;</a></span></dt>
<dd><span id="index-_002dshell_002descape"></span>
</dd>
-<dt>&lsquo;<samp>-no-shell-escape</samp>&rsquo;</dt>
+<dt><span>&lsquo;<samp>-no-shell-escape</samp>&rsquo;</span></dt>
<dd><span id="index-_002dno_002dshell_002descape"></span>
</dd>
-<dt>&lsquo;<samp>-shell-restricted</samp>&rsquo;</dt>
-<dd><span id="index-_002dshell_002drestricted"></span>
-<p>Enable, or disable, or enable with restrictions the
+<dt><span>&lsquo;<samp>-shell-restricted</samp>&rsquo;</span></dt>
+<dd><p>Enable, or disable, or enable with restrictions the
<code>\write18{<var>shell-command</var>}</code> feature for external executing
shell commands. See <a href="#Shell-escapes">Shell escapes</a>.
</p>
</dd>
-<dt>&lsquo;<samp>-enable-write18</samp>&rsquo;</dt>
+<dt id='index-_002ddisable_002dwrite18'><span>&lsquo;<samp>-enable-write18</samp>&rsquo;<a href='#index-_002ddisable_002dwrite18' class='copiable-anchor'> &para;</a></span></dt>
<dd><span id="index-_002denable_002dwrite18"></span>
</dd>
-<dt>&lsquo;<samp>-disable-write18</samp>&rsquo;</dt>
-<dd><span id="index-_002ddisable_002dwrite18"></span>
-<p>Synonyms for <samp>-shell-escape</samp> and <samp>-no-shell-escape</samp>, for
+<dt><span>&lsquo;<samp>-disable-write18</samp>&rsquo;</span></dt>
+<dd><p>Synonyms for <samp>-shell-escape</samp> and <samp>-no-shell-escape</samp>, for
compatibility with MiKTeX. (MiKTeX also accepts both pairs of
options.) See <a href="#Shell-escapes">Shell escapes</a>.
</p>
</dd>
-<dt>&lsquo;<samp>-src-specials</samp>&rsquo;</dt>
-<dt>&lsquo;<samp>-src-specials=<var>string</var></samp>&rsquo;</dt>
-<dd><span id="index-generating-source-specials"></span>
-<p>This option makes TeX output specific source information using
+<dt id='index-generating-source-specials'><span>&lsquo;<samp>-src-specials</samp>&rsquo;<a href='#index-generating-source-specials' class='copiable-anchor'> &para;</a></span></dt>
+<dt><span>&lsquo;<samp>-src-specials=<var>string</var></samp>&rsquo;</span></dt>
+<dd><p>This option makes TeX output specific source information using
&lsquo;<samp>\special</samp>&rsquo; commands in the DVI file. These &lsquo;<samp>\special</samp>&rsquo; track
the current file name and line number.
</p>
@@ -1807,9 +1787,11 @@ hard-coded to always use the &lsquo;<samp>\special</samp>&rsquo; primitive.
<hr>
-<span id="Initial-TeX"></span><div class="header">
+</div>
+<div class="section" id="Initial-TeX">
+<div class="header">
<p>
-Next: <a href="#Formats" accesskey="n" rel="next">Formats</a>, Previous: <a href="#tex-invocation" accesskey="p" rel="prev">tex invocation</a>, Up: <a href="#TeX" accesskey="u" rel="up">TeX</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
+Next: <a href="#Formats" accesskey="n" rel="next">Formats</a>, Previous: <a href="#tex-invocation" accesskey="p" rel="prev"><code>tex</code> invocation</a>, Up: <a href="#TeX" accesskey="u" rel="up">TeX: Typesetting</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
<span id="Initial-TeX-1"></span><h3 class="section">5.2 Initial TeX</h3>
@@ -1823,7 +1805,7 @@ does lengthy initializations avoided by the &ldquo;virgin&rdquo; (<code>vir</cod
form, so as to be capable of dumping &lsquo;<samp>.fmt</samp>&rsquo; files (see <a href="#Memory-dumps">Memory dumps</a>). For a detailed comparison of virgin and initial forms,
see <a href="#Initial-and-virgin">Initial and virgin</a>.
</p>
-<p>For a list of options and other information, see <a href="#tex-invocation">tex invocation</a>.
+<p>For a list of options and other information, see <a href="#tex-invocation"><code>tex</code> invocation</a>.
</p>
<span id="index-plain_002efmt"></span>
<span id="index-tex_002efmt"></span>
@@ -1850,9 +1832,11 @@ more details on TeX formats.
</p>
<hr>
-<span id="Formats"></span><div class="header">
+</div>
+<div class="section" id="Formats">
+<div class="header">
<p>
-Next: <a href="#Languages-and-hyphenation" accesskey="n" rel="next">Languages and hyphenation</a>, Previous: <a href="#Initial-TeX" accesskey="p" rel="prev">Initial TeX</a>, Up: <a href="#TeX" accesskey="u" rel="up">TeX</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
+Next: <a href="#Languages-and-hyphenation" accesskey="n" rel="next">Languages and hyphenation</a>, Previous: <a href="#Initial-TeX" accesskey="p" rel="prev">Initial TeX</a>, Up: <a href="#TeX" accesskey="u" rel="up">TeX: Typesetting</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
<span id="Formats-1"></span><h3 class="section">5.3 Formats</h3>
@@ -1873,9 +1857,8 @@ larger TeX distribution, such as TeX Live
(<a href="https://tug.org/texlive">https://tug.org/texlive</a>).
</p>
<dl compact="compact">
-<dt><tt>latex</tt></dt>
-<dd><span id="index-LaTeX"></span>
-<p>The most widely used format. The current release is named
+<dt id='index-LaTeX'><span><tt>latex</tt><a href='#index-LaTeX' class='copiable-anchor'> &para;</a></span></dt>
+<dd><p>The most widely used format. The current release is named
&lsquo;LaTeX2e&rsquo;; new versions are released approximately every six
months, with patches issued as needed. The old release was called
&lsquo;LaTeX 2.09&rsquo;, and is no longer maintained or supported. LaTeX
@@ -1885,18 +1868,16 @@ attempts to provide generic markup instructions, such as
page: <a href="https://www.latex-project.org">https://www.latex-project.org</a>.
</p>
</dd>
-<dt><tt>context</tt></dt>
-<dd><span id="index-ConTeXt"></span>
-<p>ConTeXt is an independent macro package which has a basic document
+<dt id='index-ConTeXt'><span><tt>context</tt><a href='#index-ConTeXt' class='copiable-anchor'> &para;</a></span></dt>
+<dd><p>ConTeXt is an independent macro package which has a basic document
structuring approach similar to LaTeX. It also supports creating
interactive PDF files and has integrated MetaPost support, among many
other interesting features. The ConTeXt home page:
<a href="http://www.pragma-ade.com">http://www.pragma-ade.com</a>.
</p>
</dd>
-<dt><tt>amstex</tt></dt>
-<dd><span id="index-AMSTeX"></span>
-<span id="index-American-Mathematical-Society_002c-typesetting-system"></span>
+<dt id='index-AMSTeX'><span><tt>amstex</tt><a href='#index-AMSTeX' class='copiable-anchor'> &para;</a></span></dt>
+<dd><span id="index-American-Mathematical-Society_002c-typesetting-system"></span>
<span id="index-Mathematical-Reviews"></span>
<p>The official typesetting system of the American Mathematical Society.
Like LaTeX, it encourages generic markup commands. The AMS also
@@ -1906,9 +1887,8 @@ together, they are used to produce nearly all AMS publications, e.g.,
<a href="https://www.ams.org/tex">https://www.ams.org/tex</a>.
</p>
</dd>
-<dt><tt>texinfo</tt></dt>
-<dd><span id="index-Texinfo"></span>
-<span id="index-Info-format"></span>
+<dt id='index-Texinfo'><span><tt>texinfo</tt><a href='#index-Texinfo' class='copiable-anchor'> &para;</a></span></dt>
+<dd><span id="index-Info-format"></span>
<span id="index-Free-Software-Foundation-documentation-system"></span>
<p>The documentation system developed and maintained by the Free Software
Foundation for their software manuals. It can be automatically
@@ -1917,9 +1897,8 @@ converted into plain text, a machine-readable on-line format called
<a href="https://www.gnu.org/software/texinfo">https://www.gnu.org/software/texinfo</a>.
</p>
</dd>
-<dt><tt>eplain</tt></dt>
-<dd><span id="index-Eplain"></span>
-<span id="index-expanded-plain-format"></span>
+<dt id='index-Eplain'><span><tt>eplain</tt><a href='#index-Eplain' class='copiable-anchor'> &para;</a></span></dt>
+<dd><span id="index-expanded-plain-format"></span>
<p>The &ldquo;expanded plain&rdquo; format provides various common features (e.g.,
symbolic cross-referencing, tables of contents, indexing, citations
using BibTeX), for those authors who prefer to handle their own
@@ -1927,9 +1906,8 @@ high-level formatting. The Eplain home page:
<a href="https://tug.org/eplain">https://tug.org/eplain</a>.
</p>
</dd>
-<dt><tt>slitex</tt></dt>
-<dd><span id="index-SliTeX"></span>
-<span id="index-slides_002c-producing"></span>
+<dt id='index-SliTeX'><span><tt>slitex</tt><a href='#index-SliTeX' class='copiable-anchor'> &para;</a></span></dt>
+<dd><span id="index-slides_002c-producing"></span>
<span id="index-beamer_002c-package"></span>
<p>An obsolete LaTeX 2.09 format for making slides. It is replaced by
the &lsquo;<samp>slides</samp>&rsquo; document class, although the &lsquo;<samp>beamer</samp>&rsquo; package
@@ -1941,9 +1919,11 @@ page on CTAN: <a href="https://ctan.org/pkg/beamer">https://ctan.org/pkg/beamer<
<hr>
-<span id="Languages-and-hyphenation"></span><div class="header">
+</div>
+<div class="section" id="Languages-and-hyphenation">
+<div class="header">
<p>
-Next: <a href="#Shell-escapes" accesskey="n" rel="next">Shell escapes</a>, Previous: <a href="#Formats" accesskey="p" rel="prev">Formats</a>, Up: <a href="#TeX" accesskey="u" rel="up">TeX</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
+Next: <a href="#Shell-escapes" accesskey="n" rel="next">Shell escapes</a>, Previous: <a href="#Formats" accesskey="p" rel="prev">Formats</a>, Up: <a href="#TeX" accesskey="u" rel="up">TeX: Typesetting</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
<span id="Languages-and-hyphenation-1"></span><h3 class="section">5.4 Languages and hyphenation</h3>
@@ -1953,20 +1933,18 @@ Next: <a href="#Shell-escapes" accesskey="n" rel="next">Shell escapes</a>, Previ
<p>TeX supports most natural languages. See also <a href="#TeX-extensions">TeX extensions</a>.
</p>
-<table class="menu" border="0" cellspacing="0">
-<tr><td align="left" valign="top">&bull; <a href="#MLTeX" accesskey="1">MLTeX</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top">Multi-lingual TeX.
-</td></tr>
-<tr><td align="left" valign="top">&bull; <a href="#TCX-files" accesskey="2">TCX files</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top">Support for different character sets &amp; fonts.
-</td></tr>
-<tr><td align="left" valign="top">&bull; <a href="#patgen-invocation" accesskey="3">patgen invocation</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top">Creating hyphenation patterns.
-</td></tr>
-</table>
+<ul class="section-toc">
+<li><a href="#MLTeX" accesskey="1">MLTeX: Multi-lingual TeX</a></li>
+<li><a href="#TCX-files" accesskey="2">TCX files: Character translations</a></li>
+<li><a href="#patgen-invocation" accesskey="3">Patgen: Creating hyphenation patterns</a></li>
+</ul>
<hr>
-<span id="MLTeX"></span><div class="header">
+<div class="subsection" id="MLTeX">
+<div class="header">
<p>
-Next: <a href="#TCX-files" accesskey="n" rel="next">TCX files</a>, Up: <a href="#Languages-and-hyphenation" accesskey="u" rel="up">Languages and hyphenation</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
+Next: <a href="#TCX-files" accesskey="n" rel="next">TCX files: Character translations</a>, Up: <a href="#Languages-and-hyphenation" accesskey="u" rel="up">Languages and hyphenation</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
<span id="MLTeX_003a-Multi_002dlingual-TeX"></span><h4 class="subsection">5.4.1 MLTeX: Multi-lingual TeX</h4>
@@ -2006,18 +1984,17 @@ file.
<p>The sections below describe the two new primitives that MLTeX defines.
Aside from these, MLTeX is completely compatible with standard TeX.
</p>
-<table class="menu" border="0" cellspacing="0">
-<tr><td align="left" valign="top">&bull; <a href="#g_t_005ccharsubdef" accesskey="1">\charsubdef</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top">Character substitution definitions.
-</td></tr>
-<tr><td align="left" valign="top">&bull; <a href="#g_t_005ctracingcharsubdef" accesskey="2">\tracingcharsubdef</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top">Tracing substitutions.
-</td></tr>
-</table>
+<ul class="section-toc">
+<li><a href="#g_t_005ccharsubdef" accesskey="1"><code>\charsubdef</code>: Character substitutions</a></li>
+<li><a href="#g_t_005ctracingcharsubdef" accesskey="2"><code>\tracingcharsubdef</code>: Substitution diagnostics</a></li>
+</ul>
<hr>
-<span id="g_t_005ccharsubdef"></span><div class="header">
+<div class="subsubsection" id="g_t_005ccharsubdef">
+<div class="header">
<p>
-Next: <a href="#g_t_005ctracingcharsubdef" accesskey="n" rel="next">\tracingcharsubdef</a>, Up: <a href="#MLTeX" accesskey="u" rel="up">MLTeX</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
+Next: <a href="#g_t_005ctracingcharsubdef" accesskey="n" rel="next"><code>\tracingcharsubdef</code>: Substitution diagnostics</a>, Up: <a href="#MLTeX" accesskey="u" rel="up">MLTeX: Multi-lingual TeX</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
<span id="g_t_005ccharsubdef_003a-Character-substitutions"></span><h4 class="subsubsection">5.4.1.1 <code>\charsubdef</code>: Character substitutions</h4>
@@ -2079,9 +2056,11 @@ accessed often, so changing it is not desirable, nor generally useful.)
</p>
<hr>
-<span id="g_t_005ctracingcharsubdef"></span><div class="header">
+</div>
+<div class="subsubsection" id="g_t_005ctracingcharsubdef">
+<div class="header">
<p>
-Previous: <a href="#g_t_005ccharsubdef" accesskey="p" rel="prev">\charsubdef</a>, Up: <a href="#MLTeX" accesskey="u" rel="up">MLTeX</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
+Previous: <a href="#g_t_005ccharsubdef" accesskey="p" rel="prev"><code>\charsubdef</code>: Character substitutions</a>, Up: <a href="#MLTeX" accesskey="u" rel="up">MLTeX: Multi-lingual TeX</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
<span id="g_t_005ctracingcharsubdef_003a-Substitution-diagnostics"></span><h4 class="subsubsection">5.4.1.2 <code>\tracingcharsubdef</code>: Substitution diagnostics</h4>
@@ -2099,9 +2078,12 @@ more, the character substitutions actually performed at
</p>
<hr>
-<span id="TCX-files"></span><div class="header">
+</div>
+</div>
+<div class="subsection" id="TCX-files">
+<div class="header">
<p>
-Next: <a href="#patgen-invocation" accesskey="n" rel="next">patgen invocation</a>, Previous: <a href="#MLTeX" accesskey="p" rel="prev">MLTeX</a>, Up: <a href="#Languages-and-hyphenation" accesskey="u" rel="up">Languages and hyphenation</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
+Next: <a href="#patgen-invocation" accesskey="n" rel="next">Patgen: Creating hyphenation patterns</a>, Previous: <a href="#MLTeX" accesskey="p" rel="prev">MLTeX: Multi-lingual TeX</a>, Up: <a href="#Languages-and-hyphenation" accesskey="u" rel="up">Languages and hyphenation</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
<span id="TCX-files_003a-Character-translations"></span><h4 class="subsection">5.4.2 TCX files: Character translations</h4>
@@ -2135,7 +2117,7 @@ the worst case, failure to do so correctly may result in subtle errors
in the typeset output. But we feel the benefits outweigh these
disadvantages.
</p>
-<p>This is entirely independent of the MLTeX extension (see <a href="#MLTeX">MLTeX</a>):
+<p>This is entirely independent of the MLTeX extension (see <a href="#MLTeX">MLTeX: Multi-lingual TeX</a>):
whereas a TCX file defines how an input keyboard character is mapped to
TeX&rsquo;s internal code, MLTeX defines substitutions for a
non-existing character glyph in a font with a <code>\accent</code>
@@ -2261,9 +2243,11 @@ the dump is ignored and the data from the file used instead.
</p>
<hr>
-<span id="patgen-invocation"></span><div class="header">
+</div>
+<div class="subsection" id="patgen-invocation">
+<div class="header">
<p>
-Previous: <a href="#TCX-files" accesskey="p" rel="prev">TCX files</a>, Up: <a href="#Languages-and-hyphenation" accesskey="u" rel="up">Languages and hyphenation</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
+Previous: <a href="#TCX-files" accesskey="p" rel="prev">TCX files: Character translations</a>, Up: <a href="#Languages-and-hyphenation" accesskey="u" rel="up">Languages and hyphenation</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
<span id="Patgen_003a-Creating-hyphenation-patterns"></span><h4 class="subsection">5.4.3 Patgen: Creating hyphenation patterns</h4>
@@ -2284,16 +2268,19 @@ written to the file <var>output</var>.
<p>In addition, Patgen prompts interactively for other values.
</p>
-<p>For more information, see <cite>Word hy-phen-a-tion by com-puter</cite> by
+<p>For more information, see <cite>Word hy-phen-a-tion by com-put-er</cite> by
Frank Liang (see <a href="#References">References</a>), and also the <samp>patgen.web</samp> source file.
</p>
<p>The only options are &lsquo;<samp>-help</samp>&rsquo; and &lsquo;<samp>-version</samp>&rsquo; (see <a href="#Common-options">Common options</a>).
</p>
<hr>
-<span id="Shell-escapes"></span><div class="header">
+</div>
+</div>
+<div class="section" id="Shell-escapes">
+<div class="header">
<p>
-Next: <a href="#IPC-and-TeX" accesskey="n" rel="next">IPC and TeX</a>, Previous: <a href="#Languages-and-hyphenation" accesskey="p" rel="prev">Languages and hyphenation</a>, Up: <a href="#TeX" accesskey="u" rel="up">TeX</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
+Next: <a href="#IPC-and-TeX" accesskey="n" rel="next">IPC and TeX</a>, Previous: <a href="#Languages-and-hyphenation" accesskey="p" rel="prev">Languages and hyphenation</a>, Up: <a href="#TeX" accesskey="u" rel="up">TeX: Typesetting</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
<span id="Shell-escapes-1"></span><h3 class="section">5.5 Shell escapes</h3>
@@ -2399,9 +2386,11 @@ considered untrustworthy, shell escapes should be completely disabled.
</p>
<hr>
-<span id="IPC-and-TeX"></span><div class="header">
+</div>
+<div class="section" id="IPC-and-TeX">
+<div class="header">
<p>
-Next: <a href="#TeX-extensions" accesskey="n" rel="next">TeX extensions</a>, Previous: <a href="#Shell-escapes" accesskey="p" rel="prev">Shell escapes</a>, Up: <a href="#TeX" accesskey="u" rel="up">TeX</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
+Next: <a href="#TeX-extensions" accesskey="n" rel="next">Extended TeX engines</a>, Previous: <a href="#Shell-escapes" accesskey="p" rel="prev">Shell escapes</a>, Up: <a href="#TeX" accesskey="u" rel="up">TeX: Typesetting</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
<span id="IPC-and-TeX-1"></span><h3 class="section">5.6 IPC and TeX</h3>
@@ -2422,39 +2411,51 @@ debugging.
</p>
<hr>
-<span id="TeX-extensions"></span><div class="header">
+</div>
+<div class="section" id="TeX-extensions">
+<div class="header">
<p>
-Previous: <a href="#IPC-and-TeX" accesskey="p" rel="prev">IPC and TeX</a>, Up: <a href="#TeX" accesskey="u" rel="up">TeX</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
+Previous: <a href="#IPC-and-TeX" accesskey="p" rel="prev">IPC and TeX</a>, Up: <a href="#TeX" accesskey="u" rel="up">TeX: Typesetting</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
<span id="Extended-TeX-engines"></span><h3 class="section">5.7 Extended TeX engines</h3>
<span id="index-extensions-to-TeX"></span>
<span id="index-TeX_002c-extensions-to"></span>
-<p>The base TeX program has been extended in many ways. Here&rsquo;s a
-partial list.
+<p>The base TeX program has been extended in many ways.
+</p>
+<span id="index-cross_002dengine-functionality"></span>
+<p>There has been a substantial effort to make a set of extended
+functionality available across all actively-updated engines, so that
+formats, notably LaTeX, can rely on it. A list of this common
+extended functionality is in a <cite>LaTeX News</cite> article,
+<a href="https://www.latex-project.org/news/latex2e-news/ltnews31.pdf">https://www.latex-project.org/news/latex2e-news/ltnews31.pdf</a>.
+For engines in TeX Live, the detailed documentation for these
+primitives is mostly in the pdfTeX manual
+(<a href="http://pdftex.org">http://pdftex.org</a>).
+</p>
+<p>In addition, each engine (naturally) has its own particular features,
+described in its own manual. Here&rsquo;s a partial list of the engines.
</p>
<dl compact="compact">
-<dt>e-TeX</dt>
-<dd><span id="index-e_002dTeX"></span>
-<span id="index-primitives_002c-new"></span>
+<dt id='index-e_002dTeX'><span>e-TeX<a href='#index-e_002dTeX' class='copiable-anchor'> &para;</a></span></dt>
+<dd><span id="index-primitives_002c-new"></span>
<p>Adds many new primitives, including right-to-left typesetting and more
-registers. Now frozen. More info: <a href="https://ctan.org/pkg/etex">https://ctan.org/pkg/etex</a>.
+registers. Now frozen. More info: <a href="https://ctan.org/pkg/etex">https://ctan.org/pkg/etex</a>.
</p>
</dd>
-<dt>Aleph</dt>
-<dd><span id="index-Aleph"></span>
-<span id="index-Omega"></span>
+<dt id='index-Aleph'><span>Aleph<a href='#index-Aleph' class='copiable-anchor'> &para;</a></span></dt>
+<dd><span id="index-Omega"></span>
<span id="index-Unicode"></span>
-<p>This adds Unicode support, right-to-left typesetting, and more. Omega
-was the original program. Aleph is an updated version with a variety
-of bug fixes, and includes e-TeX. Aleph is not actively maintained.
-More info: <a href="https://ctan.org/pkg/aleph">https://ctan.org/pkg/aleph</a>, <a href="https://ctan.org/pkg/omega">https://ctan.org/pkg/omega</a>.
+<p>This adds Unicode support, right-to-left typesetting, and more, based
+on the Omega engine, with the e-TeX and other extensions. Aleph is
+maintained only for serious bug fixes and does not include the common
+functionality mentioned above. More info:
+<a href="https://ctan.org/pkg/aleph">https://ctan.org/pkg/aleph</a>, <a href="https://ctan.org/pkg/omega">https://ctan.org/pkg/omega</a>.
</p>
</dd>
-<dt>pdfTeX</dt>
-<dd><span id="index-pdfTeX"></span>
-<span id="index-PDF"></span>
+<dt id='index-pdfTeX'><span>pdfTeX<a href='#index-pdfTeX' class='copiable-anchor'> &para;</a></span></dt>
+<dd><span id="index-PDF"></span>
<span id="index-micro_002dtypography"></span>
<span id="index-hypertext"></span>
<span id="index-etex-is-pdfTeX"></span>
@@ -2466,9 +2467,8 @@ these additions available with DVI output. Home page:
<a href="http://pdftex.org">http://pdftex.org</a>.
</p>
</dd>
-<dt>LuaTeX</dt>
-<dd><span id="index-LuaTeX"></span>
-<span id="index-Lua"></span>
+<dt id='index-LuaTeX'><span>LuaTeX<a href='#index-LuaTeX' class='copiable-anchor'> &para;</a></span></dt>
+<dd><span id="index-Lua"></span>
<span id="index-UTF_002d8-input_002c-native"></span>
<span id="index-OpenType-support"></span>
<span id="index-TrueType-support"></span>
@@ -2480,29 +2480,33 @@ input, the OpenType and TrueType font formats, and use of system
fonts. Home page: <a href="http://luatex.org">http://luatex.org</a>.
</p>
</dd>
-<dt>XeTeX</dt>
-<dd><span id="index-XeTeX"></span>
-<span id="index-Unicode-input_002c-native"></span>
+<dt id='index-XeTeX'><span>XeTeX<a href='#index-XeTeX' class='copiable-anchor'> &para;</a></span></dt>
+<dd><span id="index-Unicode-input_002c-native"></span>
<p>Combines support for Unicode input, the OpenType and TrueType font
formats, and use of system fonts with the capabilities of pdfTeX,
with the exception of the font expansion part of micro-typography.
Home page: <a href="https://tug.org/xetex">https://tug.org/xetex</a>.
</p>
</dd>
-<dt>pTeX</dt>
-<dt>upTeX</dt>
-<dd><span id="index-pTeX"></span>
-<span id="index-upTeX"></span>
+<dt id='index-hiTeX'><span>hiTeX<a href='#index-hiTeX' class='copiable-anchor'> &para;</a></span></dt>
+<dd><span id="index-HINT-_0028Hint-Is-Not-TeX_0029"></span>
+<p>Outputs its own HINT format, which is designed for reading
+technical documents on mobile devices. More info:
+<a href="https://ctan.org/pkg/hitex">https://ctan.org/pkg/hitex</a>.
+</p>
+</dd>
+<dt id='index-pTeX'><span>pTeX<a href='#index-pTeX' class='copiable-anchor'> &para;</a></span></dt>
+<dt><span>upTeX</span></dt>
+<dd><span id="index-upTeX"></span>
<p>With additional support for Japanese; pTeX was the original engine,
and upTeX has native Unicode support and thus is more useful for
Chinese and Korean. More info: <a href="https://ctan.org/pkg/ptex">https://ctan.org/pkg/ptex</a>,
<a href="https://ctan.org/pkg/uptex">https://ctan.org/pkg/uptex</a>.
</p>
</dd>
-<dt>epTeX</dt>
-<dt>eupTeX</dt>
-<dd><span id="index-epTeX"></span>
-<span id="index-eupTeX"></span>
+<dt id='index-epTeX'><span>epTeX<a href='#index-epTeX' class='copiable-anchor'> &para;</a></span></dt>
+<dt><span>eupTeX</span></dt>
+<dd><span id="index-eupTeX"></span>
<p>Further extends pTeX and upTeX with the e-TeX extensions.
More info: <a href="https://ctan.org/pkg/eptex">https://ctan.org/pkg/eptex</a>,
<a href="https://ctan.org/pkg/euptex">https://ctan.org/pkg/euptex</a>.
@@ -2512,9 +2516,12 @@ More info: <a href="https://ctan.org/pkg/eptex">https://ctan.org/pkg/eptex</a>,
<hr>
-<span id="Metafont"></span><div class="header">
+</div>
+</div>
+<div class="chapter" id="Metafont">
+<div class="header">
<p>
-Next: <a href="#MetaPost" accesskey="n" rel="next">MetaPost</a>, Previous: <a href="#TeX" accesskey="p" rel="prev">TeX</a>, Up: <a href="#Top" accesskey="u" rel="up">Top</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
+Next: <a href="#MetaPost" accesskey="n" rel="next">MetaPost: Generating PostScript</a>, Previous: <a href="#TeX" accesskey="p" rel="prev">TeX: Typesetting</a>, Up: <a href="#Top" accesskey="u" rel="up">Web2c</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
<span id="Metafont_003a-Creating-typeface-families"></span><h2 class="chapter">6 Metafont: Creating typeface families</h2>
@@ -2538,26 +2545,21 @@ your design intentions specific and parameterizable). For a complete
description of the Metafont language, see <cite>The METAFONTbook</cite>
(see <a href="#References">References</a>).
</p>
-<table class="menu" border="0" cellspacing="0">
-<tr><td align="left" valign="top">&bull; <a href="#mf-invocation" accesskey="1">mf invocation</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top">Invoking Metafont.
-</td></tr>
-<tr><td align="left" valign="top">&bull; <a href="#Initial-Metafont" accesskey="2">Initial Metafont</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top">Making bases.
-</td></tr>
-<tr><td align="left" valign="top">&bull; <a href="#Modes" accesskey="3">Modes</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top">Device definitions for Metafont.
-</td></tr>
-<tr><td align="left" valign="top">&bull; <a href="#Online-Metafont-graphics" accesskey="4">Online Metafont graphics</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top">Seeing MF output online.
-</td></tr>
-<tr><td align="left" valign="top">&bull; <a href="#gftodvi-invocation" accesskey="5">gftodvi invocation</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top">Making proofsheets for fonts.
-</td></tr>
-<tr><td align="left" valign="top">&bull; <a href="#mft-invocation" accesskey="6">mft invocation</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top">Prettyprinting Metafont sources.
-</td></tr>
-</table>
+<ul class="section-toc">
+<li><a href="#mf-invocation" accesskey="1"><code>mf</code> invocation</a></li>
+<li><a href="#Initial-Metafont" accesskey="2">Initial Metafont</a></li>
+<li><a href="#Modes" accesskey="3">Modes: Device definitions for Metafont</a></li>
+<li><a href="#Online-Metafont-graphics" accesskey="4">Online Metafont graphics</a></li>
+<li><a href="#gftodvi-invocation" accesskey="5">GFtoDVI: Character proofs of fonts</a></li>
+<li><a href="#mft-invocation" accesskey="6">MFT: Prettyprinting Metafont source</a></li>
+</ul>
<hr>
-<span id="mf-invocation"></span><div class="header">
+<div class="section" id="mf-invocation">
+<div class="header">
<p>
-Next: <a href="#Initial-Metafont" accesskey="n" rel="next">Initial Metafont</a>, Up: <a href="#Metafont" accesskey="u" rel="up">Metafont</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
+Next: <a href="#Initial-Metafont" accesskey="n" rel="next">Initial Metafont</a>, Up: <a href="#Metafont" accesskey="u" rel="up">Metafont: Creating typeface families</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
<span id="mf-invocation-1"></span><h3 class="section">6.1 <code>mf</code> invocation</h3>
@@ -2572,7 +2574,7 @@ language, see <cite>The Metafontbook</cite> (see <a href="#References">Reference
</p>
<p>Metafont processes its command line and determines its memory dump
(base) file in a way exactly analogous to MetaPost and TeX
-(see <a href="#tex-invocation">tex invocation</a>, and see <a href="#Memory-dumps">Memory dumps</a>). Synopses:
+(see <a href="#tex-invocation"><code>tex</code> invocation</a>, and see <a href="#Memory-dumps">Memory dumps</a>). Synopses:
</p>
<div class="example">
<pre class="example">mf [<var>option</var>]&hellip; [<var>mfname</var>[.mf]] [<var>mf-commands</var>]
@@ -2591,13 +2593,13 @@ mf [<var>option</var>]&hellip; &amp;<var>base</var> <var>args</var>
<span id="index-EC-fonts-1"></span>
<span id="index-mktexmf_002c-disabling"></span>
<p>Metafont searches the usual places for the main input file <var>mfname</var>
-(see <a href="https://tug.org/texinfohtml/kpathsea.html#Supported-file-formats">Supported file formats</a> in <cite>Kpathsea</cite>), extending
+(see <a data-manual="kpathsea" href="https://tug.org/texinfohtml/kpathsea.html#Supported-file-formats">Supported file formats</a> in <cite>Kpathsea</cite>), extending
<var>mfname</var> with <samp>.mf</samp> if necessary. To see all the relevant
paths, set the environment variable <code>KPATHSEA_DEBUG</code> to &lsquo;<samp>-1</samp>&rsquo;
before running the program. By default, Metafont runs an external
program named <samp>mktexmf</samp> to create any nonexistent Metafont source
files you input. You can disable this at configure-time or runtime
-(see <a href="https://tug.org/texinfohtml/kpathsea.html#mktex-configuration">mktex configuration</a> in <cite>Kpathsea</cite>). This is mostly
+(see <a data-manual="kpathsea" href="https://tug.org/texinfohtml/kpathsea.html#mktex-configuration">mktex configuration</a> in <cite>Kpathsea</cite>). This is mostly
for the sake of the EC fonts, which can be generated at any size.
</p>
<span id="index-_002ennngf-generic-fonts"></span>
@@ -2610,7 +2612,7 @@ for the sake of the EC fonts, which can be generated at any size.
resolution in pixels per inch, and <var>basemfname</var> is the basename of
<var>mfname</var>, or &lsquo;<samp>mfput</samp>&rsquo; if no input file was specified. A GF file
contains bitmaps of the actual character shapes. Usually GF files are
-converted immediately to PK files with GFtoPK (see <a href="#gftopk-invocation">gftopk invocation</a>), since PK files contain equivalent information, but are
+converted immediately to PK files with GFtoPK (see <a href="#gftopk-invocation">GFtoPK: Generic to packed font conversion</a>), since PK files contain equivalent information, but are
more compact. (Metafont output in GF format rather than PK for only
historical reasons.)
</p>
@@ -2626,7 +2628,7 @@ kerns, and ligatures, and spacing parameters. TeX reads only this
<span id="index-2602gf"></span>
<span id="index-_002e2602gf"></span>
<p>The <var>mode</var> in the example command above is a name referring to a
-device definition (see <a href="#Modes">Modes</a>); for example, <code>localfont</code> or
+device definition (see <a href="#Modes">Modes: Device definitions for Metafont</a>); for example, <code>localfont</code> or
<code>ljfour</code>. These device definitions must generally be precompiled
into the base file. If you leave this out, the default is <code>proof</code>
mode, as stated in <cite>The Metafontbook</cite>, in which Metafont outputs at
@@ -2651,27 +2653,26 @@ usual. For example:
<p>The program accepts the following options, as well as the standard
&lsquo;<samp>-help</samp>&rsquo; and &lsquo;<samp>-version</samp>&rsquo; (see <a href="#Common-options">Common options</a>):
</p><dl compact="compact">
-<dt>&lsquo;<samp>-[no]-file-line-error</samp>&rsquo;</dt>
-<dt>&lsquo;<samp>-fmt=<var>fmtname</var></samp>&rsquo;</dt>
-<dt>&lsquo;<samp>-halt-on-error</samp>&rsquo;</dt>
-<dt>&lsquo;<samp>-ini</samp>&rsquo;</dt>
-<dt>&lsquo;<samp>-interaction=<var>string</var></samp>&rsquo;</dt>
-<dt>&lsquo;<samp>-jobname=<var>string</var></samp>&rsquo;</dt>
-<dt>&lsquo;<samp>-kpathsea-debug=<var>number</var></samp>&rsquo;</dt>
-<dt>&lsquo;<samp>-[no]parse-first-line</samp>&rsquo;</dt>
-<dt>&lsquo;<samp>-output-directory</samp>&rsquo;</dt>
-<dt>&lsquo;<samp>-progname=<var>string</var></samp>&rsquo;</dt>
-<dt>&lsquo;<samp>-recorder</samp>&rsquo;</dt>
-<dt>&lsquo;<samp>-translate-file=<var>tcxfile</var></samp>&rsquo;</dt>
-<dt>&lsquo;<samp>-8bit</samp>&rsquo;</dt>
+<dt><span>&lsquo;<samp>-[no]-file-line-error</samp>&rsquo;</span></dt>
+<dt><span>&lsquo;<samp>-fmt=<var>fmtname</var></samp>&rsquo;</span></dt>
+<dt><span>&lsquo;<samp>-halt-on-error</samp>&rsquo;</span></dt>
+<dt><span>&lsquo;<samp>-ini</samp>&rsquo;</span></dt>
+<dt><span>&lsquo;<samp>-interaction=<var>string</var></samp>&rsquo;</span></dt>
+<dt><span>&lsquo;<samp>-jobname=<var>string</var></samp>&rsquo;</span></dt>
+<dt><span>&lsquo;<samp>-kpathsea-debug=<var>number</var></samp>&rsquo;</span></dt>
+<dt><span>&lsquo;<samp>-[no]parse-first-line</samp>&rsquo;</span></dt>
+<dt><span>&lsquo;<samp>-output-directory</samp>&rsquo;</span></dt>
+<dt><span>&lsquo;<samp>-progname=<var>string</var></samp>&rsquo;</span></dt>
+<dt><span>&lsquo;<samp>-recorder</samp>&rsquo;</span></dt>
+<dt><span>&lsquo;<samp>-translate-file=<var>tcxfile</var></samp>&rsquo;</span></dt>
+<dt><span>&lsquo;<samp>-8bit</samp>&rsquo;</span></dt>
<dd><p>These options are common to TeX, Metafont, and MetaPost.
See <a href="#Common-options">Common options</a>.
</p>
</dd>
-<dt>&lsquo;<samp>-mktex=<var>filetype</var></samp>&rsquo;</dt>
-<dt>&lsquo;<samp>-no-mktex=<var>filetype</var></samp>&rsquo;</dt>
-<dd><span id="index-_002dmktex_003dfiletype-1"></span>
-<span id="index-_002dno_002dmktex_003dfiletype-1"></span>
+<dt id='index-_002dmktex_003dfiletype-1'><span>&lsquo;<samp>-mktex=<var>filetype</var></samp>&rsquo;<a href='#index-_002dmktex_003dfiletype-1' class='copiable-anchor'> &para;</a></span></dt>
+<dt><span>&lsquo;<samp>-no-mktex=<var>filetype</var></samp>&rsquo;</span></dt>
+<dd><span id="index-_002dno_002dmktex_003dfiletype-1"></span>
<p>Turn on or off the &lsquo;<samp>mktex</samp>&rsquo; script associated with <var>filetype</var>.
The only value that makes sense for <var>filetype</var> is &lsquo;<samp>mf</samp>&rsquo;.
</p></dd>
@@ -2679,9 +2680,11 @@ The only value that makes sense for <var>filetype</var> is &lsquo;<samp>mf</samp
<hr>
-<span id="Initial-Metafont"></span><div class="header">
+</div>
+<div class="section" id="Initial-Metafont">
+<div class="header">
<p>
-Next: <a href="#Modes" accesskey="n" rel="next">Modes</a>, Previous: <a href="#mf-invocation" accesskey="p" rel="prev">mf invocation</a>, Up: <a href="#Metafont" accesskey="u" rel="up">Metafont</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
+Next: <a href="#Modes" accesskey="n" rel="next">Modes: Device definitions for Metafont</a>, Previous: <a href="#mf-invocation" accesskey="p" rel="prev"><code>mf</code> invocation</a>, Up: <a href="#Metafont" accesskey="u" rel="up">Metafont: Creating typeface families</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
<span id="Initial-Metafont-1"></span><h3 class="section">6.2 Initial Metafont</h3>
@@ -2695,7 +2698,7 @@ initializations avoided by the &ldquo;virgin&rdquo; (<code>vir</code>) form, so
be capable of dumping &lsquo;<samp>.base</samp>&rsquo; files (see <a href="#Memory-dumps">Memory dumps</a>). For
a detailed comparison of virgin and initial forms, see <a href="#Initial-and-virgin">Initial and virgin</a>.
</p>
-<p>For a list of options and other information, see <a href="#mf-invocation">mf invocation</a>.
+<p>For a list of options and other information, see <a href="#mf-invocation"><code>mf</code> invocation</a>.
</p>
<span id="index-plain_002ebase"></span>
<span id="index-mf_002ebase"></span>
@@ -2711,7 +2714,7 @@ Then install the resulting <samp>plain.base</samp> in &lsquo;<samp>$(basedir)</s
<samp>mf.base</samp> to it.
</p>
<p>For an explanation of the additional <samp>modes.mf</samp> file,
-see <a href="#Modes">Modes</a>. This file has no counterpart in TeX or MetaPost.
+see <a href="#Modes">Modes: Device definitions for Metafont</a>. This file has no counterpart in TeX or MetaPost.
</p>
<span id="index-cmmf_002ebase-not-recommended"></span>
<span id="index-cm_002ebase"></span>
@@ -2730,9 +2733,11 @@ create their own base file, of course.
</p>
<hr>
-<span id="Modes"></span><div class="header">
+</div>
+<div class="section" id="Modes">
+<div class="header">
<p>
-Next: <a href="#Online-Metafont-graphics" accesskey="n" rel="next">Online Metafont graphics</a>, Previous: <a href="#Initial-Metafont" accesskey="p" rel="prev">Initial Metafont</a>, Up: <a href="#Metafont" accesskey="u" rel="up">Metafont</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
+Next: <a href="#Online-Metafont-graphics" accesskey="n" rel="next">Online Metafont graphics</a>, Previous: <a href="#Initial-Metafont" accesskey="p" rel="prev">Initial Metafont</a>, Up: <a href="#Metafont" accesskey="u" rel="up">Metafont: Creating typeface families</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
<span id="Modes_003a-Device-definitions-for-Metafont"></span><h3 class="section">6.3 Modes: Device definitions for Metafont</h3>
@@ -2779,7 +2784,7 @@ characteristics dynamically, by invoking Metafont with an assignment to
mode.
</p>
<p>The <var>magnification</var> and <var>mfname</var> arguments are explained in
-<a href="#mf-invocation">mf invocation</a>. In the file <samp>newmode.mf</samp>, you should have the
+<a href="#mf-invocation"><code>mf</code> invocation</a>. In the file <samp>newmode.mf</samp>, you should have the
following (with no <code>mode_def</code> or <code>enddef</code>), if you are using
<samp>modes.mf</samp> conventions:
</p><div class="example">
@@ -2797,9 +2802,11 @@ and <var>o</var>.)
</p>
<hr>
-<span id="Online-Metafont-graphics"></span><div class="header">
+</div>
+<div class="section" id="Online-Metafont-graphics">
+<div class="header">
<p>
-Next: <a href="#gftodvi-invocation" accesskey="n" rel="next">gftodvi invocation</a>, Previous: <a href="#Modes" accesskey="p" rel="prev">Modes</a>, Up: <a href="#Metafont" accesskey="u" rel="up">Metafont</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
+Next: <a href="#gftodvi-invocation" accesskey="n" rel="next">GFtoDVI: Character proofs of fonts</a>, Previous: <a href="#Modes" accesskey="p" rel="prev">Modes: Device definitions for Metafont</a>, Up: <a href="#Metafont" accesskey="u" rel="up">Metafont: Creating typeface families</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
<span id="Online-Metafont-graphics-1"></span><h3 class="section">6.4 Online Metafont graphics</h3>
@@ -2823,9 +2830,7 @@ be selected.
and the corresponding <code>configure</code> option(s) in parentheses.
</p>
<dl compact="compact">
-<dt><code>epsf</code>
-<span id="index-epsf"></span>
-</dt>
+<dt id='index-epsf'><span><code>epsf</code><a href='#index-epsf' class='copiable-anchor'> &para;</a></span></dt>
<dd><span id="index-Herberts_002c-Mathias"></span>
<span id="index-_002d_002denable_002depsfwin"></span>
<p>(&lsquo;<samp>--enable-epsfwin</samp>&rsquo;) Pseudo-window server for Encapsulated
@@ -2836,24 +2841,18 @@ can be changed by setting the MFEPSF environment variable to the new
filename. Contributed by Mathias Herberts.
</p>
</dd>
-<dt><code>hp2627</code>
-<span id="index-hp2627"></span>
-</dt>
+<dt id='index-hp2627'><span><code>hp2627</code><a href='#index-hp2627' class='copiable-anchor'> &para;</a></span></dt>
<dd><span id="index-_002d_002denable_002dhp2627win"></span>
<p>(&lsquo;<samp>--enable-hp2627win</samp>&rsquo;) HP2627a color graphics terminals.
</p>
</dd>
-<dt><code>mftalk</code>
-<span id="index-mftalk"></span>
-</dt>
+<dt id='index-mftalk'><span><code>mftalk</code><a href='#index-mftalk' class='copiable-anchor'> &para;</a></span></dt>
<dd><span id="index-_002d_002denable_002dmftalkwin"></span>
<p>(&lsquo;<samp>--enable-mftalkwin</samp>&rsquo;) Generic window server (see
<samp>web2c/window/mftalk.c</samp>).
</p>
</dd>
-<dt><code>next</code>
-<span id="index-next"></span>
-</dt>
+<dt id='index-next'><span><code>next</code><a href='#index-next' class='copiable-anchor'> &para;</a></span></dt>
<dd><span id="index-DrawingServant"></span>
<span id="index-_002d_002denable_002dnext"></span>
<p>(&lsquo;<samp>--enable-next</samp>&rsquo;) NeXT window system. This requires a separate
@@ -2861,17 +2860,13 @@ program, called <code>DrawingServant</code>, available separately. See the
<samp>web2c/window/next.c</samp>.
</p>
</dd>
-<dt><code>regis</code>
-<span id="index-regis"></span>
-</dt>
+<dt id='index-regis'><span><code>regis</code><a href='#index-regis' class='copiable-anchor'> &para;</a></span></dt>
<dd><span id="index-_002d_002denable_002dregiswin"></span>
<span id="index-Regis-graphics-support"></span>
<p>(&lsquo;<samp>--enable-regiswin</samp>&rsquo;) Regis terminals.
</p>
</dd>
-<dt><code>sun</code>
-<span id="index-sun"></span>
-</dt>
+<dt id='index-sun'><span><code>sun</code><a href='#index-sun' class='copiable-anchor'> &para;</a></span></dt>
<dd><span id="index-SunView"></span>
<span id="index-Suntools"></span>
<span id="index-_002d_002denable_002dsuntoolswin"></span>
@@ -2881,18 +2876,14 @@ window system. (You can get the even older SunWindows <code>gfx</code> system
by using <samp>sun-gfx.c</samp>.)
</p>
</dd>
-<dt><code>tek</code>
-<span id="index-tek"></span>
-</dt>
+<dt id='index-tek'><span><code>tek</code><a href='#index-tek' class='copiable-anchor'> &para;</a></span></dt>
<dd><span id="index-Tektronix"></span>
<span id="index-_002d_002denable_002dtektronixwin"></span>
<p>(&lsquo;<samp>--enable-tektronixwin</samp>&rsquo;) Tektronix terminals.
</p>
<span id="index-Poole_002c-Simon"></span>
</dd>
-<dt><code>uniterm</code>
-<span id="index-uniterm"></span>
-</dt>
+<dt id='index-uniterm'><span><code>uniterm</code><a href='#index-uniterm' class='copiable-anchor'> &para;</a></span></dt>
<dd><span id="index-Tektronix-4014"></span>
<span id="index-_002d_002denable_002dunitermwin"></span>
<p>(&lsquo;<samp>--enable-unitermwin</samp>&rsquo;) Uniterm, Simon Poole&rsquo;s emulator of a smart
@@ -2903,9 +2894,7 @@ as well; it&rsquo;s faster than the driver &lsquo;<samp>--enable-tektronixwin</s
<span id="index-Xt"></span>
<span id="index-Xlib"></span>
</dd>
-<dt><code>xterm</code>
-<span id="index-xterm"></span>
-</dt>
+<dt id='index-xterm'><span><code>xterm</code><a href='#index-xterm' class='copiable-anchor'> &para;</a></span></dt>
<dd><span id="index-_002d_002dwith_002dx"></span>
<p>&lsquo;<samp>--with-x</samp>&rsquo; The X window system (version 11).
</p>
@@ -2959,9 +2948,11 @@ use MFtalk (see <samp>web2c/window/mftalk.c</samp>).
</p>
<hr>
-<span id="gftodvi-invocation"></span><div class="header">
+</div>
+<div class="section" id="gftodvi-invocation">
+<div class="header">
<p>
-Next: <a href="#mft-invocation" accesskey="n" rel="next">mft invocation</a>, Previous: <a href="#Online-Metafont-graphics" accesskey="p" rel="prev">Online Metafont graphics</a>, Up: <a href="#Metafont" accesskey="u" rel="up">Metafont</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
+Next: <a href="#mft-invocation" accesskey="n" rel="next">MFT: Prettyprinting Metafont source</a>, Previous: <a href="#Online-Metafont-graphics" accesskey="p" rel="prev">Online Metafont graphics</a>, Up: <a href="#Metafont" accesskey="u" rel="up">Metafont: Creating typeface families</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
<span id="GFtoDVI_003a-Character-proofs-of-fonts"></span><h3 class="section">6.5 GFtoDVI: Character proofs of fonts</h3>
@@ -2971,14 +2962,14 @@ Next: <a href="#mft-invocation" accesskey="n" rel="next">mft invocation</a>, Pre
<span id="index-proof-sheets_002c-of-fonts"></span>
<p>GFtoDVI makes <em>proof sheets</em> from a GF bitmap file as output by, for
-example, Metafont (see <a href="#Metafont">Metafont</a>). This is an indispensable aid for
+example, Metafont (see <a href="#Metafont">Metafont: Creating typeface families</a>). This is an indispensable aid for
font designers or Metafont hackers. Synopsis:
</p>
<div class="example">
<pre class="example">gftodvi [<var>option</var>]&hellip; <var>gfname</var>[gf]
</pre></div>
-<p>The font <var>gfname</var> is searched for in the usual places (see <a href="https://tug.org/texinfohtml/kpathsea.html#Glyph-lookup">Glyph
+<p>The font <var>gfname</var> is searched for in the usual places (see <a data-manual="kpathsea" href="https://tug.org/texinfohtml/kpathsea.html#Glyph-lookup">Glyph
lookup</a> in <cite>Kpathsea</cite>). To see all the relevant paths, set the
environment variable <code>KPATHSEA_DEBUG</code> to &lsquo;<samp>-1</samp>&rsquo; before running
the program.
@@ -3033,9 +3024,8 @@ should produce <samp>rtest.dvi</samp>, which you process as usual.
&lsquo;<samp>-verbose</samp>&rsquo;, &lsquo;<samp>-help</samp>&rsquo;, and &lsquo;<samp>-version</samp>&rsquo; (see <a href="#Common-options">Common options</a>):
</p>
<dl compact="compact">
-<dt>&lsquo;<samp>-overflow-label-offset=<var>points</var></samp>&rsquo;</dt>
-<dd><span id="index-_002doverflow_002dlabel_002doffset_003dpoints"></span>
-<span id="index-overflow-label-offset"></span>
+<dt id='index-_002doverflow_002dlabel_002doffset_003dpoints'><span>&lsquo;<samp>-overflow-label-offset=<var>points</var></samp>&rsquo;<a href='#index-_002doverflow_002dlabel_002doffset_003dpoints' class='copiable-anchor'> &para;</a></span></dt>
+<dd><span id="index-overflow-label-offset"></span>
<span id="index-offset-for-overflow-labels"></span>
<p>Typeset the so-called overflow labels, if any, <var>points</var> TeX
points from the right edge of the character bounding box. The default
@@ -3047,9 +3037,11 @@ position is too crowded with other information.
<hr>
-<span id="mft-invocation"></span><div class="header">
+</div>
+<div class="section" id="mft-invocation">
+<div class="header">
<p>
-Previous: <a href="#gftodvi-invocation" accesskey="p" rel="prev">gftodvi invocation</a>, Up: <a href="#Metafont" accesskey="u" rel="up">Metafont</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
+Previous: <a href="#gftodvi-invocation" accesskey="p" rel="prev">GFtoDVI: Character proofs of fonts</a>, Up: <a href="#Metafont" accesskey="u" rel="up">Metafont: Creating typeface families</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
<span id="MFT_003a-Prettyprinting-Metafont-source"></span><h3 class="section">6.6 MFT: Prettyprinting Metafont source</h3>
@@ -3067,7 +3059,7 @@ typesetting, with the aid of TeX macros defined in the file
<pre class="example">mft [<var>option</var>]&hellip; <var>mfname</var>[.mf]
</pre></div>
-<p>MFT searches the usual places for <var>mfname</var> (see <a href="https://tug.org/texinfohtml/kpathsea.html#Supported-file-formats">Supported file
+<p>MFT searches the usual places for <var>mfname</var> (see <a data-manual="kpathsea" href="https://tug.org/texinfohtml/kpathsea.html#Supported-file-formats">Supported file
formats</a> in <cite>Kpathsea</cite>). To see all the relevant paths, set the
environment variable <code>KPATHSEA_DEBUG</code> to &lsquo;<samp>-1</samp>&rsquo; before running
the program. The output goes to the basename of <var>mfname</var> extended
@@ -3126,22 +3118,20 @@ D.E.&nbsp;Knuth<!-- /@w -->.)
<p>The program accepts the following options, as well as the standard
&lsquo;<samp>-help</samp>&rsquo; and &lsquo;<samp>-version</samp>&rsquo; (see <a href="#Common-options">Common options</a>):
</p><dl compact="compact">
-<dt>&lsquo;<samp>-change=<var>chfile</var>[.ch]</samp>&rsquo;</dt>
-<dd><span id="index-_002dchange_003dchfile"></span>
-<span id="index-change-files_002c-and-MFT"></span>
+<dt id='index-_002dchange_003dchfile'><span>&lsquo;<samp>-change=<var>chfile</var>[.ch]</samp>&rsquo;<a href='#index-_002dchange_003dchfile' class='copiable-anchor'> &para;</a></span></dt>
+<dd><span id="index-change-files_002c-and-MFT"></span>
<p>Apply the change file <var>chfile</var> as with Tangle and Weave
-(see <a href="#WEB">WEB</a>).
+(see <a href="#WEB">WEB: Literate programming</a>).
</p>
</dd>
-<dt>&lsquo;<samp>-style=<var>mftfile</var>[.mft]</samp>&rsquo;</dt>
-<dd><span id="index-_002dstyle_003dmftfile"></span>
-<span id="index-style-files"></span>
+<dt id='index-_002dstyle_003dmftfile'><span>&lsquo;<samp>-style=<var>mftfile</var>[.mft]</samp>&rsquo;<a href='#index-_002dstyle_003dmftfile' class='copiable-anchor'> &para;</a></span></dt>
+<dd><span id="index-style-files"></span>
<span id="index-plain_002emft"></span>
<p>Read <var>mftfile</var> before anything else; a MFT style file typically
contains only MFT directives as described above. The default style file
is named <samp>plain.mft</samp>, which defines this properly for programs
using plain Metafont. The MFT files is searched along the
-<code>MFTINPUTS</code> path; see <a href="https://tug.org/texinfohtml/kpathsea.html#Supported-file-formats">Supported file formats</a> in <cite>Kpathsea</cite>.
+<code>MFTINPUTS</code> path; see <a data-manual="kpathsea" href="https://tug.org/texinfohtml/kpathsea.html#Supported-file-formats">Supported file formats</a> in <cite>Kpathsea</cite>.
</p>
<span id="index-cmbase_002emft"></span>
<span id="index-e_002emft"></span>
@@ -3164,9 +3154,12 @@ configure TeX to print these properly.
</p>
<hr>
-<span id="MetaPost"></span><div class="header">
+</div>
+</div>
+<div class="chapter" id="MetaPost">
+<div class="header">
<p>
-Next: <a href="#BibTeX" accesskey="n" rel="next">BibTeX</a>, Previous: <a href="#Metafont" accesskey="p" rel="prev">Metafont</a>, Up: <a href="#Top" accesskey="u" rel="up">Top</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
+Next: <a href="#BibTeX" accesskey="n" rel="next">BibTeX: Bibliographies</a>, Previous: <a href="#Metafont" accesskey="p" rel="prev">Metafont: Creating typeface families</a>, Up: <a href="#Top" accesskey="u" rel="up">Web2c</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
<span id="MetaPost_003a-Generating-PostScript"></span><h2 class="chapter">7 MetaPost: Generating PostScript</h2>
@@ -3175,7 +3168,7 @@ Next: <a href="#BibTeX" accesskey="n" rel="next">BibTeX</a>, Previous: <a href="
<span id="index-Metafont-meets-PostScript"></span>
<span id="index-technical-illustrations_002c-creating"></span>
<p>MetaPost is a picture-drawing language similar to Metafont
-(see <a href="#Metafont">Metafont</a>), but instead of outputting bitmaps in a &ldquo;font&rdquo;, it
+(see <a href="#Metafont">Metafont: Creating typeface families</a>), but instead of outputting bitmaps in a &ldquo;font&rdquo;, it
outputs PostScript commands. It&rsquo;s primarily intended for creating
technical illustrations, but can also be used to create PostScript or
OpenType fonts (<a href="https://ctan.org/pkg/metatype1">https://ctan.org/pkg/metatype1</a>).
@@ -3185,20 +3178,18 @@ OpenType fonts (<a href="https://ctan.org/pkg/metatype1">https://ctan.org/pkg/me
a natural way, using any typesetter (TeX and Troff are both
supported) and a number of other subsidiary programs, described below.
</p>
-<table class="menu" border="0" cellspacing="0">
-<tr><td align="left" valign="top">&bull; <a href="#mpost-invocation" accesskey="1">mpost invocation</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top">Invoking MetaPost.
-</td></tr>
-<tr><td align="left" valign="top">&bull; <a href="#Initial-MetaPost" accesskey="2">Initial MetaPost</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top">Making mems.
-</td></tr>
-<tr><td align="left" valign="top">&bull; <a href="#dvitomp-invocation" accesskey="3">dvitomp invocation</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top">DVI-to-MPX translation.
-</td></tr>
-</table>
+<ul class="section-toc">
+<li><a href="#mpost-invocation" accesskey="1"><code>mpost</code> invocation</a></li>
+<li><a href="#Initial-MetaPost" accesskey="2">Initial MetaPost</a></li>
+<li><a href="#dvitomp-invocation" accesskey="3">DVItoMP: DVI to MPX conversion</a></li>
+</ul>
<hr>
-<span id="mpost-invocation"></span><div class="header">
+<div class="section" id="mpost-invocation">
+<div class="header">
<p>
-Next: <a href="#Initial-MetaPost" accesskey="n" rel="next">Initial MetaPost</a>, Up: <a href="#MetaPost" accesskey="u" rel="up">MetaPost</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
+Next: <a href="#Initial-MetaPost" accesskey="n" rel="next">Initial MetaPost</a>, Up: <a href="#MetaPost" accesskey="u" rel="up">MetaPost: Generating PostScript</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
<span id="mpost-invocation-1"></span><h3 class="section">7.1 <code>mpost</code> invocation</h3>
@@ -3233,7 +3224,7 @@ mpost [<var>option</var>]&hellip; &amp;<var>mem</var> <var>args</var>
<span id="index-_002emp"></span>
<span id="index-MetaPost-input-files"></span>
<p>MetaPost searches the usual places for the main input file <var>mpname</var>
-(see <a href="https://tug.org/texinfohtml/kpathsea.html#Supported-file-formats">Supported file formats</a> in <cite>Kpathsea</cite>), extending
+(see <a data-manual="kpathsea" href="https://tug.org/texinfohtml/kpathsea.html#Supported-file-formats">Supported file formats</a> in <cite>Kpathsea</cite>), extending
<var>mpname</var> with <samp>.mp</samp> if necessary. To see all the relevant
paths, set the environment variable <code>KPATHSEA_DEBUG</code> to &lsquo;<samp>-1</samp>&rsquo;
before running the program.
@@ -3258,7 +3249,7 @@ with any other PostScript figures. For example, with this TeX command:
</p><div class="example">
<pre class="example">\special{psfile=&quot;<var>filename</var>&quot;}
</pre></div>
-<p>or by using <samp>epsf.tex</samp> (see <a href="https://tug.org/texinfohtml/dvips.html#EPSF-macros">EPSF macros</a> in <cite>Dvips</cite>).
+<p>or by using <samp>epsf.tex</samp> (see <a data-manual="dvips" href="https://tug.org/texinfohtml/dvips.html#EPSF-macros">EPSF macros</a> in <cite>Dvips</cite>).
</p>
<span id="index-btex-for-MetaPost-labels"></span>
<span id="index-etex-for-MetaPost-labels"></span>
@@ -3278,7 +3269,7 @@ TeX. For example, if you are using LaTeX, your MetaPost input file
must start with a <code>verbatimtex</code> block that gives the necessary
<code>\documentclass</code> (or <code>\documentstyle</code>)
<code>\begin{document}</code> command. You will also need to set the
-enviroment variable <code>TEX</code> to &lsquo;<samp>latex</samp>&rsquo;.
+environment variable <code>TEX</code> to &lsquo;<samp>latex</samp>&rsquo;.
</p>
<p><var>tex-input</var> need not be specifically TeX input; it could also be
Troff. In that case, you will need the &lsquo;<samp>-m pictures</samp>&rsquo; Troff macro
@@ -3300,7 +3291,7 @@ Metafont fonts; you can also use PostScript fonts with TeX, of course.
<p>MetaPost-generated PostScript figures which do use Computer Modern fonts
for labels cannot be directly previewed or printed. Instead, you must
include them in a TeX document and run the resulting DVI file through
-Dvips to arrange for the downloading of the required fonts (see <a href="https://tug.org/texinfohtml/dvips.html#Fonts-in-figures">Fonts
+Dvips to arrange for the downloading of the required fonts (see <a data-manual="dvips" href="https://tug.org/texinfohtml/dvips.html#Fonts-in-figures">Fonts
in figures</a> in <cite>Dvips</cite>). To help with this, the MetaPost
distribution provides a small TeX file <samp>mproof.tex</samp> which is
typically called as:
@@ -3315,11 +3306,11 @@ typically called as:
<code>prologues</code> positive. To make the output files self-contained, use
only standard PostScript fonts. MetaPost reads the same
<samp>psfonts.map</samp> file as Dvips, to determine PostScript fonts that
-need to be downloaded (see <a href="https://tug.org/texinfohtml/dvips.html#psfonts_002emap">psfonts.map</a> in <cite>Dvips</cite>).
+need to be downloaded (see <a data-manual="dvips" href="https://tug.org/texinfohtml/dvips.html#psfonts_002emap">psfonts.map</a> in <cite>Dvips</cite>).
</p>
<span id="index-PDF_002c-and-_002emps-files"></span>
<span id="index-_002emps-files-and-PDF"></span>
-<p>It is posible for pdfTeX to read MetaPost output directly; this is
+<p>It is possible for pdfTeX to read MetaPost output directly; this is
in contrast to general EPSF files, which have to be converted for use
with PDF output. The easiest way is to name the MetaPost output files
with the <code>.mps</code> extension. Then the LaTeX
@@ -3328,39 +3319,37 @@ them, even when outputting PDF.
</p>
<span id="index-security_002c-and-write"></span>
<p>MetaPost can write output files, via the <code>write</code> primitive; this
-opens a security hole. See <a href="#tex-invocation">tex invocation</a>.
+opens a security hole. See <a href="#tex-invocation"><code>tex</code> invocation</a>.
</p>
<p>The program accepts the following options, as well as the standard
&lsquo;<samp>-help</samp>&rsquo; and &lsquo;<samp>-version</samp>&rsquo; (see <a href="#Common-options">Common options</a>):
</p><dl compact="compact">
-<dt>&lsquo;<samp>-[no]-file-line-error</samp>&rsquo;</dt>
-<dt>&lsquo;<samp>-fmt=<var>fmtname</var></samp>&rsquo;</dt>
-<dt>&lsquo;<samp>-halt-on-error</samp>&rsquo;</dt>
-<dt>&lsquo;<samp>-ini</samp>&rsquo;</dt>
-<dt>&lsquo;<samp>-interaction=<var>string</var></samp>&rsquo;</dt>
-<dt>&lsquo;<samp>-jobname=<var>string</var></samp>&rsquo;</dt>
-<dt>&lsquo;<samp>-kpathsea-debug=<var>number</var></samp>&rsquo;</dt>
-<dt>&lsquo;<samp>-[no]parse-first-line</samp>&rsquo;</dt>
-<dt>&lsquo;<samp>-output-directory</samp>&rsquo;</dt>
-<dt>&lsquo;<samp>-progname=<var>string</var></samp>&rsquo;</dt>
-<dt>&lsquo;<samp>-recorder</samp>&rsquo;</dt>
-<dt>&lsquo;<samp>-translate-file=<var>tcxfile</var></samp>&rsquo;</dt>
-<dt>&lsquo;<samp>-8bit</samp>&rsquo;</dt>
+<dt><span>&lsquo;<samp>-[no]-file-line-error</samp>&rsquo;</span></dt>
+<dt><span>&lsquo;<samp>-fmt=<var>fmtname</var></samp>&rsquo;</span></dt>
+<dt><span>&lsquo;<samp>-halt-on-error</samp>&rsquo;</span></dt>
+<dt><span>&lsquo;<samp>-ini</samp>&rsquo;</span></dt>
+<dt><span>&lsquo;<samp>-interaction=<var>string</var></samp>&rsquo;</span></dt>
+<dt><span>&lsquo;<samp>-jobname=<var>string</var></samp>&rsquo;</span></dt>
+<dt><span>&lsquo;<samp>-kpathsea-debug=<var>number</var></samp>&rsquo;</span></dt>
+<dt><span>&lsquo;<samp>-[no]parse-first-line</samp>&rsquo;</span></dt>
+<dt><span>&lsquo;<samp>-output-directory</samp>&rsquo;</span></dt>
+<dt><span>&lsquo;<samp>-progname=<var>string</var></samp>&rsquo;</span></dt>
+<dt><span>&lsquo;<samp>-recorder</samp>&rsquo;</span></dt>
+<dt><span>&lsquo;<samp>-translate-file=<var>tcxfile</var></samp>&rsquo;</span></dt>
+<dt><span>&lsquo;<samp>-8bit</samp>&rsquo;</span></dt>
<dd><p>These options are common to TeX, Metafont, and MetaPost.
See <a href="#Common-options">Common options</a>.
</p>
</dd>
-<dt>&lsquo;<samp>-T</samp>&rsquo;</dt>
-<dt>&lsquo;<samp>-troff</samp>&rsquo;</dt>
-<dd><span id="index-_002dT"></span>
-<span id="index-_002dtroff"></span>
+<dt id='index-_002dT'><span>&lsquo;<samp>-T</samp>&rsquo;<a href='#index-_002dT' class='copiable-anchor'> &para;</a></span></dt>
+<dt><span>&lsquo;<samp>-troff</samp>&rsquo;</span></dt>
+<dd><span id="index-_002dtroff"></span>
<span id="index-prologues"></span>
<p>Set the <code>prologues</code> internal variable to <code>1</code>.
</p>
</dd>
-<dt>&lsquo;<samp>-tex=<var>texprogram</var></samp>&rsquo;</dt>
-<dd><span id="index-_002dtex_003dtexprogram"></span>
-<p>When this option is given, the program <var>texprogram</var> is used to
+<dt id='index-_002dtex_003dtexprogram'><span>&lsquo;<samp>-tex=<var>texprogram</var></samp>&rsquo;<a href='#index-_002dtex_003dtexprogram' class='copiable-anchor'> &para;</a></span></dt>
+<dd><p>When this option is given, the program <var>texprogram</var> is used to
typeset the labels.
</p>
</dd>
@@ -3368,9 +3357,11 @@ typeset the labels.
<hr>
-<span id="Initial-MetaPost"></span><div class="header">
+</div>
+<div class="section" id="Initial-MetaPost">
+<div class="header">
<p>
-Next: <a href="#dvitomp-invocation" accesskey="n" rel="next">dvitomp invocation</a>, Previous: <a href="#mpost-invocation" accesskey="p" rel="prev">mpost invocation</a>, Up: <a href="#MetaPost" accesskey="u" rel="up">MetaPost</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
+Next: <a href="#dvitomp-invocation" accesskey="n" rel="next">DVItoMP: DVI to MPX conversion</a>, Previous: <a href="#mpost-invocation" accesskey="p" rel="prev"><code>mpost</code> invocation</a>, Up: <a href="#MetaPost" accesskey="u" rel="up">MetaPost: Generating PostScript</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
<span id="Initial-MetaPost-1"></span><h3 class="section">7.2 Initial MetaPost</h3>
@@ -3383,7 +3374,7 @@ virgin and initial forms (see <a href="#Initial-and-virgin">Initial and virgin</
&ldquo;initial&rdquo; file name is read in its source form&mdash;that is,
<samp>mpost.mp</samp> when the program is invoked as <code>mpost</code>.
</p>
-<p>For a list of options and other information, see <a href="#mpost-invocation">mpost invocation</a>.
+<p>For a list of options and other information, see <a href="#mpost-invocation"><code>mpost</code> invocation</a>.
</p>
<span id="index-Metafont_002c-compatibility-in-MetaPost"></span>
<span id="index-plain-Metafont_002c-compatibility-in-MetaPost"></span>
@@ -3394,13 +3385,15 @@ called <samp>mfplain</samp>. You can use that in the same way; just run
<code>mfplain</code> instead of <code>mpost</code>. This lets you directly
process Metafont source files with MetaPost, producing character
proofs (one file for each character) similar to those produced with
-Metafont in proof mode and GFtoDVI (see <a href="#gftodvi-invocation">gftodvi invocation</a>).
+Metafont in proof mode and GFtoDVI (see <a href="#gftodvi-invocation">GFtoDVI: Character proofs of fonts</a>).
</p>
<hr>
-<span id="dvitomp-invocation"></span><div class="header">
+</div>
+<div class="section" id="dvitomp-invocation">
+<div class="header">
<p>
-Previous: <a href="#Initial-MetaPost" accesskey="p" rel="prev">Initial MetaPost</a>, Up: <a href="#MetaPost" accesskey="u" rel="up">MetaPost</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
+Previous: <a href="#Initial-MetaPost" accesskey="p" rel="prev">Initial MetaPost</a>, Up: <a href="#MetaPost" accesskey="u" rel="up">MetaPost: Generating PostScript</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
<span id="DVItoMP_003a-DVI-to-MPX-conversion"></span><h3 class="section">7.3 DVItoMP: DVI to MPX conversion</h3>
@@ -3428,9 +3421,12 @@ MetaPost commands.
</p>
<hr>
-<span id="BibTeX"></span><div class="header">
+</div>
+</div>
+<div class="chapter" id="BibTeX">
+<div class="header">
<p>
-Next: <a href="#WEB" accesskey="n" rel="next">WEB</a>, Previous: <a href="#MetaPost" accesskey="p" rel="prev">MetaPost</a>, Up: <a href="#Top" accesskey="u" rel="up">Top</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
+Next: <a href="#WEB" accesskey="n" rel="next">WEB: Literate programming</a>, Previous: <a href="#MetaPost" accesskey="p" rel="prev">MetaPost: Generating PostScript</a>, Up: <a href="#Top" accesskey="u" rel="up">Web2c</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
<span id="BibTeX_003a-Bibliographies"></span><h2 class="chapter">8 BibTeX: Bibliographies</h2>
@@ -3440,18 +3436,17 @@ Next: <a href="#WEB" accesskey="n" rel="next">WEB</a>, Previous: <a href="#MetaP
<p>BibTeX automates much of the job of typesetting bibliographies, and
makes bibliography entries reusable in many different contexts.
</p>
-<table class="menu" border="0" cellspacing="0">
-<tr><td align="left" valign="top">&bull; <a href="#bibtex-invocation" accesskey="1">bibtex invocation</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
-</td></tr>
-<tr><td align="left" valign="top">&bull; <a href="#Basic-BibTeX-style-files" accesskey="2">Basic BibTeX style files</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top">The standard and semi-standard styles.
-</td></tr>
-</table>
+<ul class="section-toc">
+<li><a href="#bibtex-invocation" accesskey="1">BibTeX invocation</a></li>
+<li><a href="#Basic-BibTeX-style-files" accesskey="2">Basic BibTeX style files</a></li>
+</ul>
<hr>
-<span id="bibtex-invocation"></span><div class="header">
+<div class="section" id="bibtex-invocation">
+<div class="header">
<p>
-Next: <a href="#Basic-BibTeX-style-files" accesskey="n" rel="next">Basic BibTeX style files</a>, Up: <a href="#BibTeX" accesskey="u" rel="up">BibTeX</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
+Next: <a href="#Basic-BibTeX-style-files" accesskey="n" rel="next">Basic BibTeX style files</a>, Up: <a href="#BibTeX" accesskey="u" rel="up">BibTeX: Bibliographies</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
<span id="BibTeX-invocation"></span><h3 class="section">8.1 BibTeX invocation</h3>
@@ -3487,23 +3482,21 @@ of the <samp>.bbl</samp> file. Synopsis:
<samp>.aux</samp> file as well, via the <samp>\bibliography</samp> and
<samp>\bibliographystyle</samp> (La)TeX macros. BibTeX searches for
<samp>.bib</samp> files using the <code>BIBINPUTS</code> and <code>TEXBIB</code> paths,
-and for <samp>.bst</samp> files using <code>BSTINPUTS</code> (see <a href="https://tug.org/texinfohtml/kpathsea.html#Supported-file-formats">Supported file
+and for <samp>.bst</samp> files using <code>BSTINPUTS</code> (see <a data-manual="kpathsea" href="https://tug.org/texinfohtml/kpathsea.html#Supported-file-formats">Supported file
formats</a> in <cite>Kpathsea</cite>). It does no path searching for
<samp>.aux</samp> files.
</p>
<p>The program accepts the following options, as well as the standard
&lsquo;<samp>-help</samp>&rsquo; and &lsquo;<samp>-version</samp>&rsquo; (see <a href="#Common-options">Common options</a>):
</p><dl compact="compact">
-<dt>&lsquo;<samp>-terse</samp>&rsquo;</dt>
-<dd><span id="index-_002dterse"></span>
-<span id="index-terse-output"></span>
+<dt id='index-_002dterse'><span>&lsquo;<samp>-terse</samp>&rsquo;<a href='#index-_002dterse' class='copiable-anchor'> &para;</a></span></dt>
+<dd><span id="index-terse-output"></span>
<span id="index-verbose-BibTeX-output_002c-suppressing"></span>
<p>Suppress the program banner and progress reports normally output.
</p>
</dd>
-<dt>&lsquo;<samp>-min-crossrefs=<var>n</var></samp>&rsquo;</dt>
-<dd><span id="index-_002dmin_002dcrossrefs_003dn"></span>
-<span id="index-cross_002dreferenced-bibliography-items"></span>
+<dt id='index-_002dmin_002dcrossrefs_003dn'><span>&lsquo;<samp>-min-crossrefs=<var>n</var></samp>&rsquo;<a href='#index-_002dmin_002dcrossrefs_003dn' class='copiable-anchor'> &para;</a></span></dt>
+<dd><span id="index-cross_002dreferenced-bibliography-items"></span>
<span id="index-bibliography-items_002c-cross_002dreferenced"></span>
<p>If at least <var>n</var> (2 by default) bibliography entries refer to another
entry <var>e</var> via their <code>crossref</code> field, include <var>e</var> in the
@@ -3523,30 +3516,25 @@ for <var>e</var> to the <tt>.aux</tt>, and nothing will remove it.
<p>See also:
</p><dl compact="compact">
-<dt><samp>btxdoc.tex</samp></dt>
-<dd><span id="index-btxdoc_002etex"></span>
-<p>Basic LaTeXable documentation for general BibTeX users.
+<dt id='index-btxdoc_002etex'><span><samp>btxdoc.tex</samp><a href='#index-btxdoc_002etex' class='copiable-anchor'> &para;</a></span></dt>
+<dd><p>Basic LaTeXable documentation for general BibTeX users.
</p>
</dd>
-<dt><samp>btxhak.tex</samp></dt>
-<dd><span id="index-btxhak_002etex"></span>
-<span id="index-style-design_002c-for-BibTeX"></span>
+<dt id='index-btxhak_002etex'><span><samp>btxhak.tex</samp><a href='#index-btxhak_002etex' class='copiable-anchor'> &para;</a></span></dt>
+<dd><span id="index-style-design_002c-for-BibTeX"></span>
<p>LaTeXable documentation for style designers.
</p>
</dd>
-<dt><samp>btxdoc.bib</samp></dt>
-<dd><span id="index-btxdoc_002ebib"></span>
-<p>BibTeX database file for the two above documents.
+<dt id='index-btxdoc_002ebib'><span><samp>btxdoc.bib</samp><a href='#index-btxdoc_002ebib' class='copiable-anchor'> &para;</a></span></dt>
+<dd><p>BibTeX database file for the two above documents.
</p>
</dd>
-<dt><samp>xampl.bib</samp></dt>
-<dd><span id="index-xampl_002ebib"></span>
-<p>Example database file with all the standard entry types.
+<dt id='index-xampl_002ebib'><span><samp>xampl.bib</samp><a href='#index-xampl_002ebib' class='copiable-anchor'> &para;</a></span></dt>
+<dd><p>Example database file with all the standard entry types.
</p>
</dd>
-<dt><samp><a href="ftp://ftp.math.utah.edu/pub/tex/bib/">ftp://ftp.math.utah.edu/pub/tex/bib/</a></samp></dt>
-<dd><span id="index-ftp_002emath_002eutah_002eedu"></span>
-<span id="index-BibTeX-collection"></span>
+<dt id='index-ftp_002emath_002eutah_002eedu'><span><samp><a href="ftp://ftp.math.utah.edu/pub/tex/bib/">ftp://ftp.math.utah.edu/pub/tex/bib/</a></samp><a href='#index-ftp_002emath_002eutah_002eedu' class='copiable-anchor'> &para;</a></span></dt>
+<dd><span id="index-BibTeX-collection"></span>
<span id="index-TUGboat-bibliography"></span>
<span id="index-TeX_002c-bibliographies-for"></span>
<p>A very large <samp>.bib</samp> and <samp>.bst</samp> collection, including
@@ -3557,9 +3545,11 @@ for TUGboat.
<hr>
-<span id="Basic-BibTeX-style-files"></span><div class="header">
+</div>
+<div class="section" id="Basic-BibTeX-style-files">
+<div class="header">
<p>
-Previous: <a href="#bibtex-invocation" accesskey="p" rel="prev">bibtex invocation</a>, Up: <a href="#BibTeX" accesskey="u" rel="up">BibTeX</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
+Previous: <a href="#bibtex-invocation" accesskey="p" rel="prev">BibTeX invocation</a>, Up: <a href="#BibTeX" accesskey="u" rel="up">BibTeX: Bibliographies</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
<span id="Basic-BibTeX-style-files-1"></span><h3 class="section">8.2 Basic BibTeX style files</h3>
@@ -3568,57 +3558,49 @@ Previous: <a href="#bibtex-invocation" accesskey="p" rel="prev">bibtex invocatio
<p>Here are descriptions of the four standard and four semi-standard basic
BibTeX styles. <samp><var>CTAN:</var>/biblio/bibtex</samp> contains these and
-many more (for CTAN info, see <a href="https://tug.org/texinfohtml/kpathsea.html#unixtex_002eftp">unixtex.ftp</a> in <cite>Kpathsea</cite>).
+many more (for CTAN info, see <a data-manual="kpathsea" href="https://tug.org/texinfohtml/kpathsea.html#unixtex_002eftp">unixtex.ftp</a> in <cite>Kpathsea</cite>).
</p>
<dl compact="compact">
-<dt><code>plain</code></dt>
-<dd><span id="index-plain_002ebst"></span>
-<p>Sorts entries alphabetically, with numeric labels. Generally formatted
+<dt id='index-plain_002ebst'><span><code>plain</code><a href='#index-plain_002ebst' class='copiable-anchor'> &para;</a></span></dt>
+<dd><p>Sorts entries alphabetically, with numeric labels. Generally formatted
according to van Leunen&rsquo;s <cite>A Handbook for Scholars</cite>. The other
style files listed here are based on <code>plain</code>.
</p>
</dd>
-<dt><code>abbrv</code></dt>
-<dd><span id="index-abbrv_002ebst"></span>
-<p>First names, month names, and journal names are abbreviated.
+<dt id='index-abbrv_002ebst'><span><code>abbrv</code><a href='#index-abbrv_002ebst' class='copiable-anchor'> &para;</a></span></dt>
+<dd><p>First names, month names, and journal names are abbreviated.
</p>
</dd>
-<dt><code>acm</code></dt>
-<dd><span id="index-acm_002ebst"></span>
-<p>Names are printed in small caps.
+<dt id='index-acm_002ebst'><span><code>acm</code><a href='#index-acm_002ebst' class='copiable-anchor'> &para;</a></span></dt>
+<dd><p>Names are printed in small caps.
</p>
</dd>
-<dt><code>alpha</code></dt>
-<dd><span id="index-alpha_002ebst"></span>
-<p>Alphanumeric labels, e.g., &lsquo;<samp>Knu66</samp>&rsquo;.
+<dt id='index-alpha_002ebst'><span><code>alpha</code><a href='#index-alpha_002ebst' class='copiable-anchor'> &para;</a></span></dt>
+<dd><p>Alphanumeric labels, e.g., &lsquo;<samp>Knu66</samp>&rsquo;.
</p>
</dd>
-<dt><code>apalike</code></dt>
-<dd><span id="index-apalike_002ebst"></span>
-<p>No labels at all; instead, the year appears in parentheses after the author.
+<dt id='index-apalike_002ebst'><span><code>apalike</code><a href='#index-apalike_002ebst' class='copiable-anchor'> &para;</a></span></dt>
+<dd><p>No labels at all; instead, the year appears in parentheses after the author.
Use this in conjunction with <samp>apalike.tex</samp> (plain TeX) or
<samp>apalike.sty</samp> (LaTeX), which also changes the citations in the
text to be &lsquo;<samp>(<var>author</var>, <var>year</var>)</samp>&rsquo;.
</p>
</dd>
-<dt><code>ieeetr</code></dt>
-<dd><span id="index-ieeetr_002ebst"></span>
-<p>Numeric labels, entries in citation order, <small>IEEE</small> abbreviations,
+<dt id='index-ieeetr_002ebst'><span><code>ieeetr</code><a href='#index-ieeetr_002ebst' class='copiable-anchor'> &para;</a></span></dt>
+<dd><p>Numeric labels, entries in citation order, <small>IEEE</small> abbreviations,
article titles in quotes.
</p>
</dd>
-<dt><code>siam</code></dt>
-<dd><span id="index-siam_002ebst"></span>
-<p>Numeric labels, alphabetic order, <cite>Math. Reviews</cite>
+<dt id='index-siam_002ebst'><span><code>siam</code><a href='#index-siam_002ebst' class='copiable-anchor'> &para;</a></span></dt>
+<dd><p>Numeric labels, alphabetic order, <cite>Math. Reviews</cite>
abbreviations, names in small caps.
</p>
</dd>
-<dt><code>unsrt</code></dt>
-<dd><span id="index-unsrt_002ebst"></span>
-<p>Lists entries in citation order, i.e., unsorted.
+<dt id='index-unsrt_002ebst'><span><code>unsrt</code><a href='#index-unsrt_002ebst' class='copiable-anchor'> &para;</a></span></dt>
+<dd><p>Lists entries in citation order, i.e., unsorted.
</p>
</dd>
-<dt><code>btxbst.doc</code></dt>
+<dt><span><code>btxbst.doc</code></span></dt>
<dd><p>The template file and documentation for the standard styles.
</p>
</dd>
@@ -3626,9 +3608,12 @@ abbreviations, names in small caps.
<hr>
-<span id="WEB"></span><div class="header">
+</div>
+</div>
+<div class="chapter" id="WEB">
+<div class="header">
<p>
-Next: <a href="#DVI-utilities" accesskey="n" rel="next">DVI utilities</a>, Previous: <a href="#BibTeX" accesskey="p" rel="prev">BibTeX</a>, Up: <a href="#Top" accesskey="u" rel="up">Top</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
+Next: <a href="#DVI-utilities" accesskey="n" rel="next">DVI utilities</a>, Previous: <a href="#BibTeX" accesskey="p" rel="prev">BibTeX: Bibliographies</a>, Up: <a href="#Top" accesskey="u" rel="up">Web2c</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
<span id="WEB_003a-Literate-programming"></span><h2 class="chapter">9 WEB: Literate programming</h2>
@@ -3662,20 +3647,18 @@ the TeX project at Stanford.
which is included in the <a href="ftp://ftp.tug.org/tex/lib.tar.gz">ftp://ftp.tug.org/tex/lib.tar.gz</a> archive
(and available in many other places, of course).
</p>
-<table class="menu" border="0" cellspacing="0">
-<tr><td align="left" valign="top">&bull; <a href="#tangle-invocation" accesskey="1">tangle invocation</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
-</td></tr>
-<tr><td align="left" valign="top">&bull; <a href="#weave-invocation" accesskey="2">weave invocation</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
-</td></tr>
-<tr><td align="left" valign="top">&bull; <a href="#pooltype-invocation" accesskey="3">pooltype invocation</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
-</td></tr>
-</table>
+<ul class="section-toc">
+<li><a href="#tangle-invocation" accesskey="1">Tangle: Translate WEB to Pascal</a></li>
+<li><a href="#weave-invocation" accesskey="2">Weave: Translate WEB to TeX</a></li>
+<li><a href="#pooltype-invocation" accesskey="3">Pooltype: Display WEB pool files</a></li>
+</ul>
<hr>
-<span id="tangle-invocation"></span><div class="header">
+<div class="section" id="tangle-invocation">
+<div class="header">
<p>
-Next: <a href="#weave-invocation" accesskey="n" rel="next">weave invocation</a>, Up: <a href="#WEB" accesskey="u" rel="up">WEB</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
+Next: <a href="#weave-invocation" accesskey="n" rel="next">Weave: Translate WEB to TeX</a>, Up: <a href="#WEB" accesskey="u" rel="up">WEB: Literate programming</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
<span id="Tangle_003a-Translate-WEB-to-Pascal"></span><h3 class="section">9.1 Tangle: Translate WEB to Pascal</h3>
@@ -3684,7 +3667,7 @@ Next: <a href="#weave-invocation" accesskey="n" rel="next">weave invocation</a>,
<span id="index-WEB-programs_002c-compiling"></span>
<p>Tangle creates a compilable Pascal program from a WEB source file
-(see <a href="#WEB">WEB</a>). Synopsis:
+(see <a href="#WEB">WEB: Literate programming</a>). Synopsis:
</p>
<div class="example">
<pre class="example">tangle [<var>option</var>]&hellip; <var>webfile</var>[.web] [<var>changefile</var>[.ch]]
@@ -3709,39 +3692,35 @@ semicolons when this can be done conveniently.
&lsquo;<samp>--help</samp>&rsquo; and &lsquo;<samp>--version</samp>&rsquo; (see <a href="#Common-options">Common options</a>):
</p>
<dl compact="compact">
-<dt>&lsquo;<samp>-length=<var>number</var></samp>&rsquo;</dt>
-<dd><span id="index-_002dlength_003dnumber"></span>
-<span id="index-identifier-length"></span>
+<dt id='index-_002dlength_003dnumber'><span>&lsquo;<samp>-length=<var>number</var></samp>&rsquo;<a href='#index-_002dlength_003dnumber' class='copiable-anchor'> &para;</a></span></dt>
+<dd><span id="index-identifier-length"></span>
<p>The number of characters that are considered significant in an
identifier. Whether underline characters are counted depends on the
&lsquo;<samp>-underline</samp>&rsquo; option. The default value is 32, the original tangle
used 7, but this proved too restrictive for use by Web2c.
</p>
</dd>
-<dt>&lsquo;<samp>-lowercase</samp>&rsquo;</dt>
-<dt>&lsquo;<samp>-mixedcase</samp>&rsquo;</dt>
-<dt>&lsquo;<samp>-uppercase</samp>&rsquo;</dt>
-<dd><span id="index-_002dlowercase"></span>
-<span id="index-_002dmixedcase"></span>
+<dt id='index-_002dlowercase'><span>&lsquo;<samp>-lowercase</samp>&rsquo;<a href='#index-_002dlowercase' class='copiable-anchor'> &para;</a></span></dt>
+<dt><span>&lsquo;<samp>-mixedcase</samp>&rsquo;</span></dt>
+<dt><span>&lsquo;<samp>-uppercase</samp>&rsquo;</span></dt>
+<dd><span id="index-_002dmixedcase"></span>
<span id="index-_002duppercase"></span>
<span id="index-identifier-case"></span>
<p>These options specify the case of identifiers in the output of tangle.
If &lsquo;<samp>-uppercase</samp>&rsquo; (&lsquo;<samp>-lowercase</samp>&rsquo;) is specified, tangle will
-convert all identfiers to uppercase (lowercase). The default is
+convert all identifiers to uppercase (lowercase). The default is
&lsquo;<samp>-mixedcase</samp>&rsquo;, which specifies that the case will not be changed.
</p>
</dd>
-<dt>&lsquo;<samp>-underline</samp>&rsquo;</dt>
-<dd><span id="index-_002dunderline"></span>
-<span id="index-identifiers-with-underlines"></span>
+<dt id='index-_002dunderline'><span>&lsquo;<samp>-underline</samp>&rsquo;<a href='#index-_002dunderline' class='copiable-anchor'> &para;</a></span></dt>
+<dd><span id="index-identifiers-with-underlines"></span>
<p>When this option is given, tangle does not strip underline characters
from identifiers.
</p>
</dd>
-<dt>&lsquo;<samp>-loose</samp>&rsquo;</dt>
-<dt>&lsquo;<samp>-strict</samp>&rsquo;</dt>
-<dd><span id="index-_002dloose"></span>
-<span id="index-_002dstrict"></span>
+<dt id='index-_002dloose'><span>&lsquo;<samp>-loose</samp>&rsquo;<a href='#index-_002dloose' class='copiable-anchor'> &para;</a></span></dt>
+<dt><span>&lsquo;<samp>-strict</samp>&rsquo;</span></dt>
+<dd><span id="index-_002dstrict"></span>
<span id="index-identifier-collisions"></span>
<p>These options specify how strict tangle must be when checking
identifiers for equality. The default is &lsquo;<samp>-loose</samp>&rsquo;, which means
@@ -3754,9 +3733,11 @@ whether they collide.
</dl>
<hr>
-<span id="weave-invocation"></span><div class="header">
+</div>
+<div class="section" id="weave-invocation">
+<div class="header">
<p>
-Next: <a href="#pooltype-invocation" accesskey="n" rel="next">pooltype invocation</a>, Previous: <a href="#tangle-invocation" accesskey="p" rel="prev">tangle invocation</a>, Up: <a href="#WEB" accesskey="u" rel="up">WEB</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
+Next: <a href="#pooltype-invocation" accesskey="n" rel="next">Pooltype: Display WEB pool files</a>, Previous: <a href="#tangle-invocation" accesskey="p" rel="prev">Tangle: Translate WEB to Pascal</a>, Up: <a href="#WEB" accesskey="u" rel="up">WEB: Literate programming</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
<span id="Weave_003a-Translate-WEB-to-TeX"></span><h3 class="section">9.2 Weave: Translate WEB to TeX</h3>
@@ -3765,7 +3746,7 @@ Next: <a href="#pooltype-invocation" accesskey="n" rel="next">pooltype invocatio
<span id="index-WEB-programs_002c-typesetting"></span>
<span id="index-prettyprinting-WEB-programs"></span>
-<p>Weave creates a TeX document from a WEB source file (see <a href="#WEB">WEB</a>),
+<p>Weave creates a TeX document from a WEB source file (see <a href="#WEB">WEB: Literate programming</a>),
assuming various macros defined in <samp>webmac.tex</samp>. It takes care of
typographic details such as page layout, indentation, and italicizing
identifiers. It also automatically gathers and outputs extensive
@@ -3784,9 +3765,8 @@ before writing the output; by default, there is no change file.
<p>The program accepts the following option, as well as the standard
&lsquo;<samp>-verbose</samp>&rsquo;, &lsquo;<samp>-help</samp>&rsquo; and &lsquo;<samp>-version</samp>&rsquo; (see <a href="#Common-options">Common options</a>):
</p><dl compact="compact">
-<dt>&lsquo;<samp>-x</samp>&rsquo;</dt>
-<dd><span id="index-_002dx"></span>
-<span id="index-cross_002dreferences_002c-omitting"></span>
+<dt id='index-_002dx'><span>&lsquo;<samp>-x</samp>&rsquo;<a href='#index-_002dx' class='copiable-anchor'> &para;</a></span></dt>
+<dd><span id="index-cross_002dreferences_002c-omitting"></span>
<span id="index-CONTENTS_002etex"></span>
<span id="index-webmac_002etex"></span>
<p>Omit the cross-reference information: the index, the list of WEB module
@@ -3803,9 +3783,11 @@ first change in the change file).
</p>
<hr>
-<span id="pooltype-invocation"></span><div class="header">
+</div>
+<div class="section" id="pooltype-invocation">
+<div class="header">
<p>
-Previous: <a href="#weave-invocation" accesskey="p" rel="prev">weave invocation</a>, Up: <a href="#WEB" accesskey="u" rel="up">WEB</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
+Previous: <a href="#weave-invocation" accesskey="p" rel="prev">Weave: Translate WEB to TeX</a>, Up: <a href="#WEB" accesskey="u" rel="up">WEB: Literate programming</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
<span id="Pooltype_003a-Display-WEB-pool-files"></span><h3 class="section">9.3 Pooltype: Display WEB pool files</h3>
@@ -3815,7 +3797,7 @@ Previous: <a href="#weave-invocation" accesskey="p" rel="prev">weave invocation<
<span id="index-WEB-pool-files_002c-displaying"></span>
<p>Pooltype shows the so-called <em>string number</em> of each string in a WEB
-pool file (see <a href="#WEB">WEB</a>), as output by Tangle (see <a href="#tangle-invocation">tangle invocation</a>), including the first 256 strings corresponding to the
+pool file (see <a href="#WEB">WEB: Literate programming</a>), as output by Tangle (see <a href="#tangle-invocation">Tangle: Translate WEB to Pascal</a>), including the first 256 strings corresponding to the
possible input characters. Pooltype primarily serves as an example of
WEB conventions to implementors of the TeX system. Synopsis:
</p>
@@ -3849,9 +3831,12 @@ output.
</p>
<hr>
-<span id="DVI-utilities"></span><div class="header">
+</div>
+</div>
+<div class="chapter" id="DVI-utilities">
+<div class="header">
<p>
-Next: <a href="#Font-utilities" accesskey="n" rel="next">Font utilities</a>, Previous: <a href="#WEB" accesskey="p" rel="prev">WEB</a>, Up: <a href="#Top" accesskey="u" rel="up">Top</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
+Next: <a href="#Font-utilities" accesskey="n" rel="next">Font utilities</a>, Previous: <a href="#WEB" accesskey="p" rel="prev">WEB: Literate programming</a>, Up: <a href="#Top" accesskey="u" rel="up">Web2c</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
<span id="DVI-utilities-1"></span><h2 class="chapter">10 DVI utilities</h2>
@@ -3860,10 +3845,10 @@ Next: <a href="#Font-utilities" accesskey="n" rel="next">Font utilities</a>, Pre
<p>TeX outputs a file in <em>DVI</em> (DeVice Independent) format as a
compact representation of the original document. DVI files can be
translated to meet the requirements of a real physical device, such as
-PostScript printers (see <a href="https://tug.org/texinfohtml/dvips.html#Top">Introduction</a> in <cite>Dvips</cite>), PCL
+PostScript printers (see <a data-manual="dvips" href="https://tug.org/texinfohtml/dvips.html#Top">Introduction</a> in <cite>Dvips</cite>), PCL
printers (see dvilj(1)), and X displays (see xdvi(1)). In fact, DVI
translators are available for virtually all common devices: see
-<samp><var>CTAN:</var>/dviware</samp> (for CTAN info, see <a href="https://tug.org/texinfohtml/kpathsea.html#unixtex_002eftp">unixtex.ftp</a> in <cite>Kpathsea</cite>).
+<samp><var>CTAN:</var>/dviware</samp> (for CTAN info, see <a data-manual="kpathsea" href="https://tug.org/texinfohtml/kpathsea.html#unixtex_002eftp">unixtex.ftp</a> in <cite>Kpathsea</cite>).
</p>
<span id="index-dvitype_002eweb"></span>
<span id="index-DVI-format-definition"></span>
@@ -3873,17 +3858,16 @@ source file <samp>web2c/dvitype.web</samp>.
<p>The DVI-processing programs in the Web2c distribution are not device
drivers; they perform generic utility functions.
</p>
-<table class="menu" border="0" cellspacing="0">
-<tr><td align="left" valign="top">&bull; <a href="#dvicopy-invocation" accesskey="1">dvicopy invocation</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top">Expand virtual fonts.
-</td></tr>
-<tr><td align="left" valign="top">&bull; <a href="#dvitype-invocation" accesskey="2">dvitype invocation</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top">DVI to human-readable text.
-</td></tr>
-</table>
+<ul class="section-toc">
+<li><a href="#dvicopy-invocation" accesskey="1">DVIcopy: Canonicalize virtual font references</a></li>
+<li><a href="#dvitype-invocation" accesskey="2">DVItype: Plain text transliteration of DVI files</a></li>
+</ul>
<hr>
-<span id="dvicopy-invocation"></span><div class="header">
+<div class="section" id="dvicopy-invocation">
+<div class="header">
<p>
-Next: <a href="#dvitype-invocation" accesskey="n" rel="next">dvitype invocation</a>, Up: <a href="#DVI-utilities" accesskey="u" rel="up">DVI utilities</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
+Next: <a href="#dvitype-invocation" accesskey="n" rel="next">DVItype: Plain text transliteration of DVI files</a>, Up: <a href="#DVI-utilities" accesskey="u" rel="up">DVI utilities</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
<span id="DVIcopy_003a-Canonicalize-virtual-font-references"></span><h3 class="section">10.1 DVIcopy: Canonicalize virtual font references</h3>
@@ -3891,7 +3875,7 @@ Next: <a href="#dvitype-invocation" accesskey="n" rel="next">dvitype invocation<
<span id="index-virtual-fonts_002c-expanding"></span>
<p>DVIcopy reads a DVI file, expands any references to virtual fonts
-(see <a href="https://tug.org/texinfohtml/dvips.html#Virtual-fonts">Virtual fonts</a> in <cite>Dvips</cite>) to base fonts, and writes the
+(see <a data-manual="dvips" href="https://tug.org/texinfohtml/dvips.html#Virtual-fonts">Virtual fonts</a> in <cite>Dvips</cite>) to base fonts, and writes the
resulting DVI file. Thus you can use virtual fonts even if your DVI
processor does not support them, by passing the documents through
DVIcopy first. Synopsis:
@@ -3906,23 +3890,20 @@ standard output if <var>outdvi</var> is not specified.
<p>The program accepts the following options, as well as the standard
&lsquo;<samp>-help</samp>&rsquo; and &lsquo;<samp>-version</samp>&rsquo; (see <a href="#Common-options">Common options</a>):
</p><dl compact="compact">
-<dt>&lsquo;<samp>-magnification=<var>integer</var></samp>&rsquo;</dt>
-<dd><span id="index-_002dmagnification_003dinteger"></span>
-<span id="index-magnification"></span>
+<dt id='index-_002dmagnification_003dinteger'><span>&lsquo;<samp>-magnification=<var>integer</var></samp>&rsquo;<a href='#index-_002dmagnification_003dinteger' class='copiable-anchor'> &para;</a></span></dt>
+<dd><span id="index-magnification"></span>
<span id="index-_005cmag"></span>
<p>Override existing magnification in <var>indvi</var> with <var>integer</var>; 1000
specifies no magnification. This is equivalent to setting TeX&rsquo;s
<code>\mag</code> parameter.
</p>
</dd>
-<dt>&lsquo;<samp>-max-pages=<var>n</var></samp>&rsquo;</dt>
-<dd><span id="index-_002dmax_002dpages_003dn"></span>
-<p>Process <var>n</var> pages; default is one million.
+<dt id='index-_002dmax_002dpages_003dn'><span>&lsquo;<samp>-max-pages=<var>n</var></samp>&rsquo;<a href='#index-_002dmax_002dpages_003dn' class='copiable-anchor'> &para;</a></span></dt>
+<dd><p>Process <var>n</var> pages; default is one million.
</p>
</dd>
-<dt>&lsquo;<samp>-page-start=<var>page-spec</var></samp>&rsquo;</dt>
-<dd><span id="index-_002dpage_002dstart_003dpage_002dspec"></span>
-<span id="index-starting-page"></span>
+<dt id='index-_002dpage_002dstart_003dpage_002dspec'><span>&lsquo;<samp>-page-start=<var>page-spec</var></samp>&rsquo;<a href='#index-_002dpage_002dstart_003dpage_002dspec' class='copiable-anchor'> &para;</a></span></dt>
+<dd><span id="index-starting-page"></span>
<span id="index-page_002c-starting"></span>
<span id="index-_005ccountn"></span>
<p>Start at the first page matching <var>page-spec</var>, which is one or more
@@ -3934,9 +3915,11 @@ matches anything. Examples: &lsquo;<samp>3</samp>&rsquo;, &lsquo;<samp>1.*.-4</
<hr>
-<span id="dvitype-invocation"></span><div class="header">
+</div>
+<div class="section" id="dvitype-invocation">
+<div class="header">
<p>
-Previous: <a href="#dvicopy-invocation" accesskey="p" rel="prev">dvicopy invocation</a>, Up: <a href="#DVI-utilities" accesskey="u" rel="up">DVI utilities</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
+Previous: <a href="#dvicopy-invocation" accesskey="p" rel="prev">DVIcopy: Canonicalize virtual font references</a>, Up: <a href="#DVI-utilities" accesskey="u" rel="up">DVI utilities</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
<span id="DVItype_003a-Plain-text-transliteration-of-DVI-files"></span><h3 class="section">10.2 DVItype: Plain text transliteration of DVI files</h3>
@@ -3958,7 +3941,7 @@ correct. Synopsis:
<p>DVItype does not read any bitmap files, but it does read TFM files for
fonts referenced in <var>dvifile</var>. The usual places are searched
-(see <a href="https://tug.org/texinfohtml/kpathsea.html#Supported-file-formats">Supported file formats</a> in <cite>Kpathsea</cite>). To see all the
+(see <a data-manual="kpathsea" href="https://tug.org/texinfohtml/kpathsea.html#Supported-file-formats">Supported file formats</a> in <cite>Kpathsea</cite>). To see all the
relevant paths, set the environment variable <code>KPATHSEA_DEBUG</code> to
&lsquo;<samp>-1</samp>&rsquo; before running the program.
</p>
@@ -3967,29 +3950,25 @@ relevant paths, set the environment variable <code>KPATHSEA_DEBUG</code> to
<p>The program accepts the following options, as well as the standard
&lsquo;<samp>-help</samp>&rsquo; and &lsquo;<samp>-version</samp>&rsquo; (see <a href="#Common-options">Common options</a>):
</p><dl compact="compact">
-<dt>&lsquo;<samp>-dpi=<var>real</var></samp>&rsquo;</dt>
-<dd><span id="index-_002ddpi_003dreal"></span>
-<p>Do pixel movement calculations at <var>real</var> pixels per inch; default
+<dt id='index-_002ddpi_003dreal'><span>&lsquo;<samp>-dpi=<var>real</var></samp>&rsquo;<a href='#index-_002ddpi_003dreal' class='copiable-anchor'> &para;</a></span></dt>
+<dd><p>Do pixel movement calculations at <var>real</var> pixels per inch; default
300.0.
</p>
</dd>
-<dt>&lsquo;<samp>-magnification=<var>integer</var></samp>&rsquo;</dt>
-<dd><span id="index-_002dmagnification_003dinteger-1"></span>
-<span id="index-magnification-1"></span>
+<dt id='index-_002dmagnification_003dinteger-1'><span>&lsquo;<samp>-magnification=<var>integer</var></samp>&rsquo;<a href='#index-_002dmagnification_003dinteger-1' class='copiable-anchor'> &para;</a></span></dt>
+<dd><span id="index-magnification-1"></span>
<span id="index-_005cmag-1"></span>
<p>Override existing magnification in <var>indvi</var> with <var>integer</var>; 1000
specifies no magnification. This is equivalent to setting TeX&rsquo;s
<code>\mag</code> parameter.
</p>
</dd>
-<dt>&lsquo;<samp>-max-pages=<var>n</var></samp>&rsquo;</dt>
-<dd><span id="index-_002dmax_002dpages_003dn-1"></span>
-<p>Process <var>n</var> pages; default is one million.
+<dt id='index-_002dmax_002dpages_003dn-1'><span>&lsquo;<samp>-max-pages=<var>n</var></samp>&rsquo;<a href='#index-_002dmax_002dpages_003dn-1' class='copiable-anchor'> &para;</a></span></dt>
+<dd><p>Process <var>n</var> pages; default is one million.
</p>
</dd>
-<dt>&lsquo;<samp>-output-level=<var>n</var></samp>&rsquo;</dt>
-<dd><span id="index-_002doutput_002dlevel_003dn"></span>
-<p>Verbosity level of output, from 0 to 4 (default 4):
+<dt id='index-_002doutput_002dlevel_003dn'><span>&lsquo;<samp>-output-level=<var>n</var></samp>&rsquo;<a href='#index-_002doutput_002dlevel_003dn' class='copiable-anchor'> &para;</a></span></dt>
+<dd><p>Verbosity level of output, from 0 to 4 (default 4):
</p><ul>
<li> 0: Global document information only.
</li><li> 1: Most DVI commands included, and typeset characters summarized.
@@ -4000,9 +3979,8 @@ in the file, reading the DVI postamble first.
</li></ul>
</dd>
-<dt>&lsquo;<samp>-page-start=<var>page-spec</var></samp>&rsquo;</dt>
-<dd><span id="index-_002dpage_002dstart_003dpage_002dspec-1"></span>
-<span id="index-starting-page-1"></span>
+<dt id='index-_002dpage_002dstart_003dpage_002dspec-1'><span>&lsquo;<samp>-page-start=<var>page-spec</var></samp>&rsquo;<a href='#index-_002dpage_002dstart_003dpage_002dspec-1' class='copiable-anchor'> &para;</a></span></dt>
+<dd><span id="index-starting-page-1"></span>
<span id="index-page_002c-starting-1"></span>
<span id="index-_005ccountn-1"></span>
<p>Start at the first page matching <var>page-spec</var>, which is one or more
@@ -4011,9 +3989,8 @@ in the file, reading the DVI postamble first.
matches anything. Examples: &lsquo;<samp>1</samp>&rsquo;, &lsquo;<samp>5.*.-9</samp>&rsquo;.
</p>
</dd>
-<dt>&lsquo;<samp>-show-opcodes</samp>&rsquo;</dt>
-<dd><span id="index-_002dshow_002dopcodes"></span>
-<span id="index-opcodes_002c-showing-DVI"></span>
+<dt id='index-_002dshow_002dopcodes'><span>&lsquo;<samp>-show-opcodes</samp>&rsquo;<a href='#index-_002dshow_002dopcodes' class='copiable-anchor'> &para;</a></span></dt>
+<dd><span id="index-opcodes_002c-showing-DVI"></span>
<span id="index-DVI-opcodes_002c-showing"></span>
<span id="index-debugging-DVI-utilities"></span>
<p>Show numeric opcode values (in decimal) for DVI commands, in braces
@@ -4023,16 +4000,16 @@ use decimal because in the DVI format documentation (in
</p></dd>
</dl>
-<table class="menu" border="0" cellspacing="0">
-<tr><td align="left" valign="top">&bull; <a href="#dvitype-output-example" accesskey="1">dvitype output example</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
-</td></tr>
-</table>
+<ul class="section-toc">
+<li><a href="#dvitype-output-example" accesskey="1">DVItype output example</a></li>
+</ul>
<hr>
-<span id="dvitype-output-example"></span><div class="header">
+<div class="subsection" id="dvitype-output-example">
+<div class="header">
<p>
-Up: <a href="#dvitype-invocation" accesskey="u" rel="up">dvitype invocation</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
+Up: <a href="#dvitype-invocation" accesskey="u" rel="up">DVItype: Plain text transliteration of DVI files</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
<span id="DVItype-output-example"></span><h4 class="subsection">10.2.1 DVItype output example</h4>
@@ -4117,9 +4094,13 @@ STORY]</samp>&rsquo; and the &lsquo;<samp>[ 1]</samp>&rsquo;.
<hr>
-<span id="Font-utilities"></span><div class="header">
+</div>
+</div>
+</div>
+<div class="chapter" id="Font-utilities">
+<div class="header">
<p>
-Next: <a href="#Legalisms" accesskey="n" rel="next">Legalisms</a>, Previous: <a href="#DVI-utilities" accesskey="p" rel="prev">DVI utilities</a>, Up: <a href="#Top" accesskey="u" rel="up">Top</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
+Next: <a href="#Legalisms" accesskey="n" rel="next">Legalisms</a>, Previous: <a href="#DVI-utilities" accesskey="p" rel="prev">DVI utilities</a>, Up: <a href="#Top" accesskey="u" rel="up">Web2c</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
<span id="Font-utilities-1"></span><h2 class="chapter">11 Font utilities</h2>
@@ -4138,41 +4119,32 @@ outputs GF format, but it&rsquo;s most efficient for device drivers to use PK.
mentioned below are in the source files that read them;
<samp>pktype.web</samp>, <samp>gftype.web</samp>, <samp>tftopl.web</samp>, etc.
</p>
-<table class="menu" border="0" cellspacing="0">
-<tr><td align="left" valign="top">&bull; <a href="#Font-file-formats" accesskey="1">Font file formats</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top">Explanations of GF, PK, TFM, VF, ...
-</td></tr>
-<tr><td align="left" valign="top">&bull; <a href="#gftopk-invocation" accesskey="2">gftopk invocation</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top">GF -&gt; PK (compact)
-</td></tr>
-<tr><td align="left" valign="top">&bull; <a href="#pktogf-invocation" accesskey="3">pktogf invocation</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top">PK -&gt; GF (expand).
-</td></tr>
-<tr><td align="left" valign="top">&bull; <a href="#pktype-invocation" accesskey="4">pktype invocation</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top">PK -&gt; human-readable text.
-</td></tr>
-<tr><td align="left" valign="top">&bull; <a href="#gftype-invocation" accesskey="5">gftype invocation</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top">GF -&gt; human-readable text.
-</td></tr>
-<tr><td align="left" valign="top">&bull; <a href="#tftopl-invocation" accesskey="6">tftopl invocation</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top">TFM -&gt; PL (for editing TFM).
-</td></tr>
-<tr><td align="left" valign="top">&bull; <a href="#pltotf-invocation" accesskey="7">pltotf invocation</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top">PL -&gt; TFM (make editing results usable).
-</td></tr>
-<tr><td align="left" valign="top">&bull; <a href="#vftovp-invocation" accesskey="8">vftovp invocation</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top">VF -&gt; VPL (tftopl for virtual fonts).
-</td></tr>
-<tr><td align="left" valign="top">&bull; <a href="#vptovf-invocation" accesskey="9">vptovf invocation</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top">VPL -&gt; VF (pltotf for virtual fonts).
-</td></tr>
-<tr><td align="left" valign="top">&bull; <a href="#Font-utilities-available-elsewhere">Font utilities available elsewhere</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top">Type 1, BDF, editors, etc.
-</td></tr>
-</table>
+<ul class="section-toc">
+<li><a href="#Font-file-formats" accesskey="1">Font file formats</a></li>
+<li><a href="#gftopk-invocation" accesskey="2">GFtoPK: Generic to packed font conversion</a></li>
+<li><a href="#pktogf-invocation" accesskey="3">PKtoGF: Packed to generic font conversion</a></li>
+<li><a href="#pktype-invocation" accesskey="4">PKtype: Plain text transliteration of packed fonts</a></li>
+<li><a href="#gftype-invocation" accesskey="5">GFtype: Plain text transliteration of generic fonts</a></li>
+<li><a href="#tftopl-invocation" accesskey="6">TFtoPL: TeX font metric to property list conversion</a></li>
+<li><a href="#pltotf-invocation" accesskey="7">PLtoTF: Property list to TeX font metric conversion</a></li>
+<li><a href="#vftovp-invocation" accesskey="8">VFtoVP: Virtual font to virtual property lists</a></li>
+<li><a href="#vptovf-invocation" accesskey="9">VPtoVF: Virtual property lists to virtual font</a></li>
+<li><a href="#Font-utilities-available-elsewhere">Font utilities available elsewhere</a></li>
+</ul>
<hr>
-<span id="Font-file-formats"></span><div class="header">
+<div class="section" id="Font-file-formats">
+<div class="header">
<p>
-Next: <a href="#gftopk-invocation" accesskey="n" rel="next">gftopk invocation</a>, Up: <a href="#Font-utilities" accesskey="u" rel="up">Font utilities</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
+Next: <a href="#gftopk-invocation" accesskey="n" rel="next">GFtoPK: Generic to packed font conversion</a>, Up: <a href="#Font-utilities" accesskey="u" rel="up">Font utilities</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
<span id="Font-file-formats-1"></span><h3 class="section">11.1 Font file formats</h3>
<span id="index-font-file-formats"></span>
<span id="index-file-formats-for-fonts"></span>
-<p>(For another perspective on this, see <a href="https://tug.org/texinfohtml/dvips.html#Font-concepts">Font concepts</a> in <cite>Dvips</cite>).
+<p>For another perspective on this, see <a data-manual="dvips" href="https://tug.org/texinfohtml/dvips.html#Font-concepts">Font concepts</a> in <cite>Dvips</cite>.
</p>
<p>Font files come in several varieties, with suffixes like:
</p><div class="example">
@@ -4228,7 +4200,7 @@ obsolete.
<p>Font files with the &lsquo;<samp>.pl</samp>&rsquo; (property list) suffix are the plain text
(human-readable) analog of the binary &lsquo;<samp>.tfm</samp>&rsquo; files.
The TFtoPL and PLtoTF programs convert between the two formats
-(see <a href="#tftopl-invocation">tftopl invocation</a> and <a href="#pltotf-invocation">pltotf invocation</a>).
+(see <a href="#tftopl-invocation">TFtoPL: TeX font metric to property list conversion</a> and <a href="#pltotf-invocation">PLtoTF: Property list to TeX font metric conversion</a>).
</p>
<p>Font files with the &lsquo;<samp>.mf</samp>&rsquo; suffix are in Metafont source format.
These are the files used by Metafont to generate rastered fonts for
@@ -4238,10 +4210,10 @@ resolution and type of mapping used by your device.
<span id="index-virtual_002dfonts_002eknuth"></span>
<span id="index-virtualfonts_002etxt"></span>
<p>The suffix &lsquo;<samp>.vf</samp>&rsquo; identifies &ldquo;virtual font&rdquo; files, for which
-&lsquo;<samp>.vpl</samp>&rsquo; is the human-readable analog. See See <a href="#vftovp-invocation">vftovp invocation</a>,
-and <a href="#vptovf-invocation">vptovf invocation</a>. For further discussion of virtual fonts,
+&lsquo;<samp>.vpl</samp>&rsquo; is the human-readable analog. See See <a href="#vftovp-invocation">VFtoVP: Virtual font to virtual property lists</a>,
+and <a href="#vptovf-invocation">VPtoVF: Virtual property lists to virtual font</a>. For further discussion of virtual fonts,
see <samp><var>CTAN:</var>/doc/virtual-fonts.knuth</samp>,
-<samp><var>CTAN:</var>/help/virtualfonts.txt</samp>, and <a href="https://tug.org/texinfohtml/dvips.html#Virtual-fonts">Virtual fonts</a> in <cite>Dvips</cite>.
+<samp><var>CTAN:</var>/help/virtualfonts.txt</samp>, and <a data-manual="dvips" href="https://tug.org/texinfohtml/dvips.html#Virtual-fonts">Virtual fonts</a> in <cite>Dvips</cite>.
</p>
<span id="index-MacKay_002c-Pierre"></span>
<span id="index-Tachikawa_002c-Elizabeth"></span>
@@ -4250,9 +4222,11 @@ distribution by Pierre MacKay and Elizabeth Tachikawa.)
</p>
<hr>
-<span id="gftopk-invocation"></span><div class="header">
+</div>
+<div class="section" id="gftopk-invocation">
+<div class="header">
<p>
-Next: <a href="#pktogf-invocation" accesskey="n" rel="next">pktogf invocation</a>, Previous: <a href="#Font-file-formats" accesskey="p" rel="prev">Font file formats</a>, Up: <a href="#Font-utilities" accesskey="u" rel="up">Font utilities</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
+Next: <a href="#pktogf-invocation" accesskey="n" rel="next">PKtoGF: Packed to generic font conversion</a>, Previous: <a href="#Font-file-formats" accesskey="p" rel="prev">Font file formats</a>, Up: <a href="#Font-utilities" accesskey="u" rel="up">Font utilities</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
<span id="GFtoPK_003a-Generic-to-packed-font-conversion"></span><h3 class="section">11.2 GFtoPK: Generic to packed font conversion</h3>
@@ -4262,7 +4236,7 @@ Next: <a href="#pktogf-invocation" accesskey="n" rel="next">pktogf invocation</a
<span id="index-GF_002c-converting-to-PK"></span>
<p>GFtoPK converts a generic font (GF) file output by, for example,
-Metafont (see <a href="#mf-invocation">mf invocation</a>) to a packed font (PK) file. PK files
+Metafont (see <a href="#mf-invocation"><code>mf</code> invocation</a>) to a packed font (PK) file. PK files
are considerably smaller than the corresponding gf files, so they are
generally the bitmap font format of choice. Some DVI-processing
programs, notably Dvips, only support PK files and not GF files.
@@ -4272,7 +4246,7 @@ Synopsis:
<pre class="example">gftopk [<var>option</var>]&hellip; <var>gfname</var>.<var>dpi</var>[gf] [<var>pkfile</var>]
</pre></div>
-<p>The font <var>gfname</var> is searched for in the usual places (see <a href="https://tug.org/texinfohtml/kpathsea.html#Glyph-lookup">Glyph
+<p>The font <var>gfname</var> is searched for in the usual places (see <a data-manual="kpathsea" href="https://tug.org/texinfohtml/kpathsea.html#Glyph-lookup">Glyph
lookup</a> in <cite>Kpathsea</cite>). To see all the relevant paths, set the
environment variable <code>KPATHSEA_DEBUG</code> to &lsquo;<samp>-1</samp>&rsquo; before running
the program.
@@ -4290,9 +4264,11 @@ of &lsquo;<samp><var>gfname</var>.<var>dpi</var>pk</samp>&rsquo;, e.g., &lsquo;<
</p>
<hr>
-<span id="pktogf-invocation"></span><div class="header">
+</div>
+<div class="section" id="pktogf-invocation">
+<div class="header">
<p>
-Next: <a href="#pktype-invocation" accesskey="n" rel="next">pktype invocation</a>, Previous: <a href="#gftopk-invocation" accesskey="p" rel="prev">gftopk invocation</a>, Up: <a href="#Font-utilities" accesskey="u" rel="up">Font utilities</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
+Next: <a href="#pktype-invocation" accesskey="n" rel="next">PKtype: Plain text transliteration of packed fonts</a>, Previous: <a href="#gftopk-invocation" accesskey="p" rel="prev">GFtoPK: Generic to packed font conversion</a>, Up: <a href="#Font-utilities" accesskey="u" rel="up">Font utilities</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
<span id="PKtoGF_003a-Packed-to-generic-font-conversion"></span><h3 class="section">11.3 PKtoGF: Packed to generic font conversion</h3>
@@ -4303,7 +4279,7 @@ Next: <a href="#pktype-invocation" accesskey="n" rel="next">pktype invocation</a
<p>PKtoGF converts a packed font (PK) file to a generic font (GF) file.
Since PK format is much more compact than GF format, the most likely
-reason to do this is to run GFtype (see <a href="#gftype-invocation">gftype invocation</a>) on the
+reason to do this is to run GFtype (see <a href="#gftype-invocation">GFtype: Plain text transliteration of generic fonts</a>) on the
result, so you can see the bitmap images. Also, a few old utility
programs do not support PK format. Synopsis:
</p>
@@ -4311,7 +4287,7 @@ programs do not support PK format. Synopsis:
<pre class="example">pktogf [<var>option</var>]&hellip; <var>pkname</var>.<var>dpi</var>[pk] [<var>gffile</var>]
</pre></div>
-<p>The font <var>pkname</var> is searched for in the usual places (see <a href="https://tug.org/texinfohtml/kpathsea.html#Glyph-lookup">Glyph
+<p>The font <var>pkname</var> is searched for in the usual places (see <a data-manual="kpathsea" href="https://tug.org/texinfohtml/kpathsea.html#Glyph-lookup">Glyph
lookup</a> in <cite>Kpathsea</cite>). To see all the relevant paths, set the
environment variable <code>KPATHSEA_DEBUG</code> to &lsquo;<samp>-1</samp>&rsquo; before running
the program.
@@ -4329,9 +4305,11 @@ of &lsquo;<samp><var>pkname</var>.<var>dpi</var>gf</samp>&rsquo;, e.g., &lsquo;<
</p>
<hr>
-<span id="pktype-invocation"></span><div class="header">
+</div>
+<div class="section" id="pktype-invocation">
+<div class="header">
<p>
-Next: <a href="#gftype-invocation" accesskey="n" rel="next">gftype invocation</a>, Previous: <a href="#pktogf-invocation" accesskey="p" rel="prev">pktogf invocation</a>, Up: <a href="#Font-utilities" accesskey="u" rel="up">Font utilities</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
+Next: <a href="#gftype-invocation" accesskey="n" rel="next">GFtype: Plain text transliteration of generic fonts</a>, Previous: <a href="#pktogf-invocation" accesskey="p" rel="prev">PKtoGF: Packed to generic font conversion</a>, Up: <a href="#Font-utilities" accesskey="u" rel="up">Font utilities</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
<span id="PKtype_003a-Plain-text-transliteration-of-packed-fonts"></span><h3 class="section">11.4 PKtype: Plain text transliteration of packed fonts</h3>
@@ -4351,7 +4329,7 @@ correct. Synopsis:
<pre class="example">pktype <var>pkname</var>.<var>dpi</var>[pk]
</pre></div>
-<p>The font <var>pkname</var> is searched for in the usual places (see <a href="https://tug.org/texinfohtml/kpathsea.html#Glyph-lookup">Glyph
+<p>The font <var>pkname</var> is searched for in the usual places (see <a data-manual="kpathsea" href="https://tug.org/texinfohtml/kpathsea.html#Glyph-lookup">Glyph
lookup</a> in <cite>Kpathsea</cite>). To see all the relevant paths, set the
environment variable <code>KPATHSEA_DEBUG</code> to &lsquo;<samp>-1</samp>&rsquo; before running
the program.
@@ -4382,58 +4360,50 @@ letter &lsquo;K&rsquo; in &lsquo;<samp>cmr10</samp>&rsquo;, as rendered at 600dp
<p>Explanation:
</p>
<dl compact="compact">
-<dt>&lsquo;<samp>955</samp>&rsquo;</dt>
-<dd><span id="index-byte-position"></span>
-<p>The byte position in the file where this character starts.
+<dt id='index-byte-position'><span>&lsquo;<samp>955</samp>&rsquo;<a href='#index-byte-position' class='copiable-anchor'> &para;</a></span></dt>
+<dd><p>The byte position in the file where this character starts.
</p>
</dd>
-<dt>&lsquo;<samp>Flag byte</samp>&rsquo;</dt>
-<dt>&lsquo;<samp>Dynamic packing variable</samp>&rsquo;</dt>
-<dd><span id="index-flag-byte"></span>
-<span id="index-dynamic-packing-variable"></span>
+<dt id='index-flag-byte'><span>&lsquo;<samp>Flag byte</samp>&rsquo;<a href='#index-flag-byte' class='copiable-anchor'> &para;</a></span></dt>
+<dt><span>&lsquo;<samp>Dynamic packing variable</samp>&rsquo;</span></dt>
+<dd><span id="index-dynamic-packing-variable"></span>
<p>Related to the packing for this character; see the source code.
</p>
</dd>
-<dt>&lsquo;<samp>Character</samp>&rsquo;</dt>
-<dd><span id="index-character-codes_002c-in-PKtype-output"></span>
-<p>The character code, in decimal.
+<dt id='index-character-codes_002c-in-PKtype-output'><span>&lsquo;<samp>Character</samp>&rsquo;<a href='#index-character-codes_002c-in-PKtype-output' class='copiable-anchor'> &para;</a></span></dt>
+<dd><p>The character code, in decimal.
</p>
</dd>
-<dt>&lsquo;<samp>Packet length</samp>&rsquo;</dt>
-<dd><span id="index-packet-length"></span>
-<p>The total length of this character definition, in bytes.
+<dt id='index-packet-length'><span>&lsquo;<samp>Packet length</samp>&rsquo;<a href='#index-packet-length' class='copiable-anchor'> &para;</a></span></dt>
+<dd><p>The total length of this character definition, in bytes.
</p>
</dd>
-<dt>&lsquo;<samp>TFM width</samp>&rsquo;</dt>
-<dd><span id="index-TFM-width-of-characters"></span>
-<span id="index-device_002dindependent-width"></span>
+<dt id='index-TFM-width-of-characters'><span>&lsquo;<samp>TFM width</samp>&rsquo;<a href='#index-TFM-width-of-characters' class='copiable-anchor'> &para;</a></span></dt>
+<dd><span id="index-device_002dindependent-width"></span>
<span id="index-width_002c-device_002dindependent"></span>
<p>The device-independent (TFM) width of this character. It is 2^24
times the ratio of the true width to the font&rsquo;s design size.
</p>
</dd>
-<dt>&lsquo;<samp>dx</samp>&rsquo;</dt>
-<dd><span id="index-horizontal-escapement"></span>
-<span id="index-escapement_002c-horizontal"></span>
+<dt id='index-horizontal-escapement'><span>&lsquo;<samp>dx</samp>&rsquo;<a href='#index-horizontal-escapement' class='copiable-anchor'> &para;</a></span></dt>
+<dd><span id="index-escapement_002c-horizontal"></span>
<span id="index-scaled-pixels"></span>
<span id="index-dx-horizontal-escapement"></span>
<p>The device-dependent width, in <em>scaled pixels</em>, i.e., units of
horizontal pixels times 2^16.
</p>
</dd>
-<dt>&lsquo;<samp>Height</samp>&rsquo;</dt>
-<dt>&lsquo;<samp>Width</samp>&rsquo;</dt>
-<dd><span id="index-height_002c-in-pixels"></span>
-<span id="index-pixel-height"></span>
+<dt id='index-height_002c-in-pixels'><span>&lsquo;<samp>Height</samp>&rsquo;<a href='#index-height_002c-in-pixels' class='copiable-anchor'> &para;</a></span></dt>
+<dt><span>&lsquo;<samp>Width</samp>&rsquo;</span></dt>
+<dd><span id="index-pixel-height"></span>
<span id="index-pixel-width"></span>
<span id="index-width_002c-in-pixels"></span>
<p>The bitmap height and width, in pixels.
</p>
</dd>
-<dt>&lsquo;<samp>X-offset</samp>&rsquo;</dt>
-<dt>&lsquo;<samp>Y-offset</samp>&rsquo;</dt>
-<dd><span id="index-x-offset"></span>
-<span id="index-y-offset"></span>
+<dt id='index-x-offset'><span>&lsquo;<samp>X-offset</samp>&rsquo;<a href='#index-x-offset' class='copiable-anchor'> &para;</a></span></dt>
+<dt><span>&lsquo;<samp>Y-offset</samp>&rsquo;</span></dt>
+<dd><span id="index-y-offset"></span>
<span id="index-origin"></span>
<span id="index-reference-pixel"></span>
<span id="index-side-bearings"></span>
@@ -4448,9 +4418,8 @@ of the left side bearing; the right side bearing is the horizontal
escapement minus the bitmap width plus the x-offset.
</p>
</dd>
-<dt>&lsquo;<samp>[2]23(16)&hellip;</samp>&rsquo;</dt>
-<dd><span id="index-run-length-encoded-bitmaps"></span>
-<span id="index-repeated-rows"></span>
+<dt id='index-run-length-encoded-bitmaps'><span>&lsquo;<samp>[2]23(16)&hellip;</samp>&rsquo;<a href='#index-run-length-encoded-bitmaps' class='copiable-anchor'> &para;</a></span></dt>
+<dd><span id="index-repeated-rows"></span>
<p>Finally, run lengths of black pixels alternate with parenthesized run
lengths of white pixels, and brackets indicate a repeated row.
</p></dd>
@@ -4458,9 +4427,11 @@ lengths of white pixels, and brackets indicate a repeated row.
<hr>
-<span id="gftype-invocation"></span><div class="header">
+</div>
+<div class="section" id="gftype-invocation">
+<div class="header">
<p>
-Next: <a href="#tftopl-invocation" accesskey="n" rel="next">tftopl invocation</a>, Previous: <a href="#pktype-invocation" accesskey="p" rel="prev">pktype invocation</a>, Up: <a href="#Font-utilities" accesskey="u" rel="up">Font utilities</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
+Next: <a href="#tftopl-invocation" accesskey="n" rel="next">TFtoPL: TeX font metric to property list conversion</a>, Previous: <a href="#pktype-invocation" accesskey="p" rel="prev">PKtype: Plain text transliteration of packed fonts</a>, Up: <a href="#Font-utilities" accesskey="u" rel="up">Font utilities</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
<span id="GFtype_003a-Plain-text-transliteration-of-generic-fonts"></span><h3 class="section">11.5 GFtype: Plain text transliteration of generic fonts</h3>
@@ -4480,7 +4451,7 @@ it&rsquo;s correct. Synopsis:
<pre class="example">gftype [<var>option</var>]&hellip; <var>gfname</var>.<var>dpi</var>[gf]
</pre></div>
-<p>The font <var>gfname</var> is searched for in the usual places (see <a href="https://tug.org/texinfohtml/kpathsea.html#Glyph-lookup">Glyph
+<p>The font <var>gfname</var> is searched for in the usual places (see <a data-manual="kpathsea" href="https://tug.org/texinfohtml/kpathsea.html#Glyph-lookup">Glyph
lookup</a> in <cite>Kpathsea</cite>). To see all the relevant paths, set the
environment variable <code>KPATHSEA_DEBUG</code> to &lsquo;<samp>-1</samp>&rsquo; before running
the program.
@@ -4493,18 +4464,16 @@ not an extension; no &lsquo;<samp>.</samp>&rsquo; precedes it: for instance, <sa
<p>The program accepts the following options, as well as the standard
&lsquo;<samp>-help</samp>&rsquo; and &lsquo;<samp>-version</samp>&rsquo; (see <a href="#Common-options">Common options</a>):
</p><dl compact="compact">
-<dt>&lsquo;<samp>-images</samp>&rsquo;</dt>
-<dd><span id="index-_002dimages"></span>
-<p>Show the characters&rsquo; bitmaps using asterisks and spaces.
+<dt id='index-_002dimages'><span>&lsquo;<samp>-images</samp>&rsquo;<a href='#index-_002dimages' class='copiable-anchor'> &para;</a></span></dt>
+<dd><p>Show the characters&rsquo; bitmaps using asterisks and spaces.
</p>
</dd>
-<dt>&lsquo;<samp>-mnemonics</samp>&rsquo;</dt>
-<dd><span id="index-_002dmnemonics"></span>
-<p>Translate all commands in the GF file.
+<dt id='index-_002dmnemonics'><span>&lsquo;<samp>-mnemonics</samp>&rsquo;<a href='#index-_002dmnemonics' class='copiable-anchor'> &para;</a></span></dt>
+<dd><p>Translate all commands in the GF file.
</p></dd>
</dl>
-<p>As an example of the output, here is the (abrdiged) translation of the
+<p>As an example of the output, here is the (abridged) translation of the
letter &lsquo;K&rsquo; in &lsquo;<samp>cmr10</samp>&rsquo;, as rendered at 600dpi with the mode
&lsquo;<samp>ljfour</samp>&rsquo; from <samp>modes.mf</samp> (available from
<a href="ftp://ftp.tug.org/tex/modes.mf">ftp://ftp.tug.org/tex/modes.mf</a>), with both &lsquo;<samp>-mnemonics</samp>&rsquo; and
@@ -4550,43 +4519,37 @@ main definition:
<p>Explanation:
</p>
<dl compact="compact">
-<dt>&lsquo;<samp>2033</samp>&rsquo;</dt>
-<dt>&lsquo;<samp>2043</samp>&rsquo;</dt>
-<dt>&lsquo;<samp>&hellip;</samp>&rsquo;</dt>
-<dd><span id="index-byte-position-1"></span>
-<p>The byte position in the file where each GF command starts.
+<dt id='index-byte-position-1'><span>&lsquo;<samp>2033</samp>&rsquo;<a href='#index-byte-position-1' class='copiable-anchor'> &para;</a></span></dt>
+<dt><span>&lsquo;<samp>2043</samp>&rsquo;</span></dt>
+<dt><span>&lsquo;<samp>&hellip;</samp>&rsquo;</span></dt>
+<dd><p>The byte position in the file where each GF command starts.
</p>
</dd>
-<dt>&lsquo;<samp>beginning of char 75</samp>&rsquo;</dt>
-<dd><span id="index-character-codes_002c-in-GFtype-output"></span>
-<p>The character code, in decimal.
+<dt id='index-character-codes_002c-in-GFtype-output'><span>&lsquo;<samp>beginning of char 75</samp>&rsquo;<a href='#index-character-codes_002c-in-GFtype-output' class='copiable-anchor'> &para;</a></span></dt>
+<dd><p>The character code, in decimal.
</p>
</dd>
-<dt>&lsquo;<samp>3&lt;=m&lt;=60 0&lt;=n&lt;=56</samp>&rsquo;</dt>
-<dd><span id="index-left-side-bearing-1"></span>
-<span id="index-right-side-bearing-1"></span>
+<dt id='index-left-side-bearing-1'><span>&lsquo;<samp>3&lt;=m&lt;=60 0&lt;=n&lt;=56</samp>&rsquo;<a href='#index-left-side-bearing-1' class='copiable-anchor'> &para;</a></span></dt>
+<dd><span id="index-right-side-bearing-1"></span>
<span id="index-side-bearings-1"></span>
<p>The character&rsquo;s bitmap lies between 3 and 60 (inclusive) horizontally,
-and between 0 and 56 (inclusive) vertically. (<em>m</em> is a column
-position and <em>n</em> is a row position.) Thus, 3 is the left side
+and between 0 and 56 (inclusive) vertically. (<em class='math'>m</em> is a column
+position and <em class='math'>n</em> is a row position.) Thus, 3 is the left side
bearing. The right side bearing is the horizontal escapement (given
-below) minus the maximum <em>m</em>.
+below) minus the maximum <em class='math'>m</em>.
</p>
</dd>
-<dt>&lsquo;<samp>(initially n=56) paint (0)24(12)20</samp>&rsquo;</dt>
-<dd><span id="index-run-length-encoded-bitmaps-1"></span>
-<p>The first row of pixels: 0 white pixels, 24 black pixels, 12 white
+<dt id='index-run-length-encoded-bitmaps-1'><span>&lsquo;<samp>(initially n=56) paint (0)24(12)20</samp>&rsquo;<a href='#index-run-length-encoded-bitmaps-1' class='copiable-anchor'> &para;</a></span></dt>
+<dd><p>The first row of pixels: 0 white pixels, 24 black pixels, 12 white
pixels, etc.
</p>
</dd>
-<dt>&lsquo;<samp>newrow 0 (n=55) paint 24(12)20</samp>&rsquo;</dt>
-<dd><span id="index-newrow-GF-command"></span>
-<p>The second row of pixels, with zero leading white pixels on the row.
+<dt id='index-newrow-GF-command'><span>&lsquo;<samp>newrow 0 (n=55) paint 24(12)20</samp>&rsquo;<a href='#index-newrow-GF-command' class='copiable-anchor'> &para;</a></span></dt>
+<dd><p>The second row of pixels, with zero leading white pixels on the row.
</p>
</dd>
-<dt>&lsquo;<samp>eoc</samp>&rsquo;</dt>
-<dd><span id="index-eoc-GF-command"></span>
-<p>The end of the main character definition.
+<dt id='index-eoc-GF-command'><span>&lsquo;<samp>eoc</samp>&rsquo;<a href='#index-eoc-GF-command' class='copiable-anchor'> &para;</a></span></dt>
+<dd><p>The end of the main character definition.
</p>
</dd>
</dl>
@@ -4600,9 +4563,8 @@ pixels, etc.
<p>Explanation:
</p>
<dl compact="compact">
-<dt>&lsquo;<samp>dx</samp>&rsquo;</dt>
-<dd><span id="index-horizontal-escapement-1"></span>
-<span id="index-escapement_002c-horizontal-1"></span>
+<dt id='index-horizontal-escapement-1'><span>&lsquo;<samp>dx</samp>&rsquo;<a href='#index-horizontal-escapement-1' class='copiable-anchor'> &para;</a></span></dt>
+<dd><span id="index-escapement_002c-horizontal-1"></span>
<span id="index-vertical-escapement"></span>
<span id="index-escapement_002c-vertical"></span>
<span id="index-scaled-pixels-1"></span>
@@ -4614,16 +4576,15 @@ rounded. If the vertical escapement is nonzero, it would appear here as
a &lsquo;<samp>dy</samp>&rsquo; value.
</p>
</dd>
-<dt>&lsquo;<samp>width</samp>&rsquo;</dt>
-<dd><span id="index-TFM-width-of-characters-1"></span>
-<span id="index-device_002dindependent-width-1"></span>
+<dt id='index-TFM-width-of-characters-1'><span>&lsquo;<samp>width</samp>&rsquo;<a href='#index-TFM-width-of-characters-1' class='copiable-anchor'> &para;</a></span></dt>
+<dd><span id="index-device_002dindependent-width-1"></span>
<span id="index-width_002c-device_002dindependent-1"></span>
<p>The device-independent (TFM) width of this character. It is 2^24
times the ratio of the true width to the font&rsquo;s design size. The
&lsquo;<samp>64.57289</samp>&rsquo; is the same number converted to pixels.
</p>
</dd>
-<dt>&lsquo;<samp>loc</samp>&rsquo;</dt>
+<dt><span>&lsquo;<samp>loc</samp>&rsquo;</span></dt>
<dd><p>The byte position in the file where this character starts.
</p>
</dd>
@@ -4631,9 +4592,11 @@ times the ratio of the true width to the font&rsquo;s design size. The
<hr>
-<span id="tftopl-invocation"></span><div class="header">
+</div>
+<div class="section" id="tftopl-invocation">
+<div class="header">
<p>
-Next: <a href="#pltotf-invocation" accesskey="n" rel="next">pltotf invocation</a>, Previous: <a href="#gftype-invocation" accesskey="p" rel="prev">gftype invocation</a>, Up: <a href="#Font-utilities" accesskey="u" rel="up">Font utilities</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
+Next: <a href="#pltotf-invocation" accesskey="n" rel="next">PLtoTF: Property list to TeX font metric conversion</a>, Previous: <a href="#gftype-invocation" accesskey="p" rel="prev">GFtype: Plain text transliteration of generic fonts</a>, Up: <a href="#Font-utilities" accesskey="u" rel="up">Font utilities</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
<span id="TFtoPL_003a-TeX-font-metric-to-property-list-conversion"></span><h3 class="section">11.6 TFtoPL: TeX font metric to property list conversion</h3>
@@ -4644,7 +4607,7 @@ Next: <a href="#pltotf-invocation" accesskey="n" rel="next">pltotf invocation</a
<span id="index-human_002dreadable-text_002c-converting-TFM-to"></span>
<span id="index-plain-text_002c-converting-TFM-to"></span>
-<p>TFtoPL translates a TeX font metric (TFM, see <a href="https://tug.org/texinfohtml/dvips.html#Metric-files">Metric
+<p>TFtoPL translates a TeX font metric (TFM, see <a data-manual="dvips" href="https://tug.org/texinfohtml/dvips.html#Metric-files">Metric
files</a> in <cite>Dvips</cite>) file (as output by Metafont, for example) to
<em>property list format</em> (a list of parenthesized items describing the
font) that humans can edit or read. This program is mostly used by
@@ -4656,7 +4619,7 @@ Synopsis:
</pre></div>
<p>The font <var>tfmname</var> (extended with &lsquo;<samp>.tfm</samp>&rsquo; if necessary) is
-searched for in the usual places (see <a href="https://tug.org/texinfohtml/kpathsea.html#Supported-file-formats">Supported file formats</a> in <cite>Kpathsea</cite>). To see all the relevant paths, set the
+searched for in the usual places (see <a data-manual="kpathsea" href="https://tug.org/texinfohtml/kpathsea.html#Supported-file-formats">Supported file formats</a> in <cite>Kpathsea</cite>). To see all the relevant paths, set the
environment variable <code>KPATHSEA_DEBUG</code> to &lsquo;<samp>-1</samp>&rsquo; before running
the program.
</p>
@@ -4668,9 +4631,8 @@ program TFtoPL (see the next section).
<p>The program accepts the following option, as well as the standard
&lsquo;<samp>-verbose</samp>&rsquo;, &lsquo;<samp>-help</samp>&rsquo; and &lsquo;<samp>-version</samp>&rsquo; (see <a href="#Common-options">Common options</a>):
</p><dl compact="compact">
-<dt>&lsquo;<samp>-charcode-format=<var>type</var></samp>&rsquo;</dt>
-<dd><span id="index-_002dcharcode_002dformat_003dtype"></span>
-<p>Output character codes in the PL file according to <var>type</var>: either
+<dt id='index-_002dcharcode_002dformat_003dtype'><span>&lsquo;<samp>-charcode-format=<var>type</var></samp>&rsquo;<a href='#index-_002dcharcode_002dformat_003dtype' class='copiable-anchor'> &para;</a></span></dt>
+<dd><p>Output character codes in the PL file according to <var>type</var>: either
&lsquo;<samp>octal</samp>&rsquo; or &lsquo;<samp>ascii</samp>&rsquo;. Default is &lsquo;<samp>ascii</samp>&rsquo; for letters and
digits, octal for all other characters. Exception: if the font&rsquo;s coding
scheme starts with &lsquo;<samp>TeX math sy</samp>&rsquo; or &lsquo;<samp>TeX math ex</samp>&rsquo;, all
@@ -4790,9 +4752,11 @@ ligatures for this character as a comment.
<hr>
-<span id="pltotf-invocation"></span><div class="header">
+</div>
+<div class="section" id="pltotf-invocation">
+<div class="header">
<p>
-Next: <a href="#vftovp-invocation" accesskey="n" rel="next">vftovp invocation</a>, Previous: <a href="#tftopl-invocation" accesskey="p" rel="prev">tftopl invocation</a>, Up: <a href="#Font-utilities" accesskey="u" rel="up">Font utilities</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
+Next: <a href="#vftovp-invocation" accesskey="n" rel="next">VFtoVP: Virtual font to virtual property lists</a>, Previous: <a href="#tftopl-invocation" accesskey="p" rel="prev">TFtoPL: TeX font metric to property list conversion</a>, Up: <a href="#Font-utilities" accesskey="u" rel="up">Font utilities</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
<span id="PLtoTF_003a-Property-list-to-TeX-font-metric-conversion"></span><h3 class="section">11.7 PLtoTF: Property list to TeX font metric conversion</h3>
@@ -4802,7 +4766,7 @@ Next: <a href="#vftovp-invocation" accesskey="n" rel="next">vftovp invocation</a
<span id="index-machine_002dreadable_002c-converting-property-lists-to"></span>
<p>PLtoTF translates a property list file (as output by TFtoPL, for
-example) to TeX font metric (TFM, see <a href="https://tug.org/texinfohtml/dvips.html#Metric-files">Metric files</a> in <cite>Dvips</cite>)
+example) to TeX font metric (TFM, see <a data-manual="dvips" href="https://tug.org/texinfohtml/dvips.html#Metric-files">Metric files</a> in <cite>Dvips</cite>)
format. It&rsquo;s much easier for both programs and humans to create the
(plain text) property list files and let PLtoTF take care of creating
the binary TFM equivalent than to output TFM files directly. Synopsis:
@@ -4824,9 +4788,11 @@ output by default is undesirable.)
</p>
<hr>
-<span id="vftovp-invocation"></span><div class="header">
+</div>
+<div class="section" id="vftovp-invocation">
+<div class="header">
<p>
-Next: <a href="#vptovf-invocation" accesskey="n" rel="next">vptovf invocation</a>, Previous: <a href="#pltotf-invocation" accesskey="p" rel="prev">pltotf invocation</a>, Up: <a href="#Font-utilities" accesskey="u" rel="up">Font utilities</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
+Next: <a href="#vptovf-invocation" accesskey="n" rel="next">VPtoVF: Virtual property lists to virtual font</a>, Previous: <a href="#pltotf-invocation" accesskey="p" rel="prev">PLtoTF: Property list to TeX font metric conversion</a>, Up: <a href="#Font-utilities" accesskey="u" rel="up">Font utilities</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
<span id="VFtoVP_003a-Virtual-font-to-virtual-property-lists"></span><h3 class="section">11.8 VFtoVP: Virtual font to virtual property lists</h3>
@@ -4837,9 +4803,9 @@ Next: <a href="#vptovf-invocation" accesskey="n" rel="next">vptovf invocation</a
<span id="index-human_002dreadable-text_002c-converting-VF-to"></span>
<span id="index-plain-text_002c-converting-VF-to"></span>
-<p>VFtoVP translates a virtual font metric (VF, see <a href="https://tug.org/texinfohtml/dvips.html#Virtual-fonts">Virtual
+<p>VFtoVP translates a virtual font metric (VF, see <a data-manual="dvips" href="https://tug.org/texinfohtml/dvips.html#Virtual-fonts">Virtual
fonts</a> in <cite>Dvips</cite>) file and its accompanying TeX font metric (TFM,
-see <a href="https://tug.org/texinfohtml/dvips.html#Metric-files">Metric files</a> in <cite>Dvips</cite>) file (as output by VPtoVF, for
+see <a data-manual="dvips" href="https://tug.org/texinfohtml/dvips.html#Metric-files">Metric files</a> in <cite>Dvips</cite>) file (as output by VPtoVF, for
example) to <em>virtual property list format</em> (a list of parenthesized
items describing the virtual font) that humans can edit or read. This
program is mostly used by people debugging virtual font utilities.
@@ -4851,7 +4817,7 @@ Synopsis:
<p>The fonts <var>vfname</var> and <var>tfmname</var> (extended with &lsquo;<samp>.vf</samp>&rsquo; and
&lsquo;<samp>.tfm</samp>&rsquo; if necessary) are searched for in the usual places
-(see <a href="https://tug.org/texinfohtml/kpathsea.html#Supported-file-formats">Supported file formats</a> in <cite>Kpathsea</cite>). To see all the
+(see <a data-manual="kpathsea" href="https://tug.org/texinfohtml/kpathsea.html#Supported-file-formats">Supported file formats</a> in <cite>Kpathsea</cite>). To see all the
relevant paths, set the environment variable <code>KPATHSEA_DEBUG</code> to
&lsquo;<samp>-1</samp>&rsquo; before running the program. If <var>tfmname</var> is not
specified, <var>vfname</var> (without a trailing &lsquo;<samp>.vf</samp>&rsquo;) is used.
@@ -4864,9 +4830,8 @@ companion program VFtoVP (see the next section).
<p>The program accepts the following option, as well as the standard
&lsquo;<samp>-verbose</samp>&rsquo;, &lsquo;<samp>-help</samp>&rsquo; and &lsquo;<samp>-version</samp>&rsquo; (see <a href="#Common-options">Common options</a>):
</p><dl compact="compact">
-<dt>&lsquo;<samp>-charcode-format=<var>type</var></samp>&rsquo;</dt>
-<dd><span id="index-_002dcharcode_002dformat_003dtype-1"></span>
-<p>Output character codes in the PL file according to <var>type</var>: either
+<dt id='index-_002dcharcode_002dformat_003dtype-1'><span>&lsquo;<samp>-charcode-format=<var>type</var></samp>&rsquo;<a href='#index-_002dcharcode_002dformat_003dtype-1' class='copiable-anchor'> &para;</a></span></dt>
+<dd><p>Output character codes in the PL file according to <var>type</var>: either
&lsquo;<samp>octal</samp>&rsquo; or &lsquo;<samp>ascii</samp>&rsquo;. Default is &lsquo;<samp>ascii</samp>&rsquo; for letters and
digits, octal for all other characters. Exception: if the font&rsquo;s coding
scheme starts with &lsquo;<samp>TeX math sy</samp>&rsquo; or &lsquo;<samp>TeX math ex</samp>&rsquo;, all
@@ -4886,9 +4851,11 @@ confusing.
<hr>
-<span id="vptovf-invocation"></span><div class="header">
+</div>
+<div class="section" id="vptovf-invocation">
+<div class="header">
<p>
-Next: <a href="#Font-utilities-available-elsewhere" accesskey="n" rel="next">Font utilities available elsewhere</a>, Previous: <a href="#vftovp-invocation" accesskey="p" rel="prev">vftovp invocation</a>, Up: <a href="#Font-utilities" accesskey="u" rel="up">Font utilities</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
+Next: <a href="#Font-utilities-available-elsewhere" accesskey="n" rel="next">Font utilities available elsewhere</a>, Previous: <a href="#vftovp-invocation" accesskey="p" rel="prev">VFtoVP: Virtual font to virtual property lists</a>, Up: <a href="#Font-utilities" accesskey="u" rel="up">Font utilities</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
<span id="VPtoVF_003a-Virtual-property-lists-to-virtual-font"></span><h3 class="section">11.9 VPtoVF: Virtual property lists to virtual font</h3>
@@ -4898,8 +4865,8 @@ Next: <a href="#Font-utilities-available-elsewhere" accesskey="n" rel="next">Fon
<span id="index-machine_002dreadable_002c-converting-property-lists-to-1"></span>
<p>VPtoVF translates a virtual property list file (as output by VFtoVP, for
-example) to virtual font (VF, see <a href="https://tug.org/texinfohtml/dvips.html#Virtual-fonts">Virtual fonts</a> in <cite>Dvips</cite>) and
-TeX font metric (TFM, see <a href="https://tug.org/texinfohtml/dvips.html#Metric-files">Metric files</a> in <cite>Dvips</cite>) files.
+example) to virtual font (VF, see <a data-manual="dvips" href="https://tug.org/texinfohtml/dvips.html#Virtual-fonts">Virtual fonts</a> in <cite>Dvips</cite>) and
+TeX font metric (TFM, see <a data-manual="dvips" href="https://tug.org/texinfohtml/dvips.html#Metric-files">Metric files</a> in <cite>Dvips</cite>) files.
It&rsquo;s much easier for both programs and humans to create the (plain text)
property list files and let VPtoVF take care of creating the binary VF
and TFM equivalents than to output them directly. Synopsis:
@@ -4919,9 +4886,11 @@ specified, the VF output is written to the basename of
</p>
<hr>
-<span id="Font-utilities-available-elsewhere"></span><div class="header">
+</div>
+<div class="section" id="Font-utilities-available-elsewhere">
+<div class="header">
<p>
-Previous: <a href="#vptovf-invocation" accesskey="p" rel="prev">vptovf invocation</a>, Up: <a href="#Font-utilities" accesskey="u" rel="up">Font utilities</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
+Previous: <a href="#vptovf-invocation" accesskey="p" rel="prev">VPtoVF: Virtual property lists to virtual font</a>, Up: <a href="#Font-utilities" accesskey="u" rel="up">Font utilities</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
<span id="Font-utilities-available-elsewhere-1"></span><h3 class="section">11.10 Font utilities available elsewhere</h3>
@@ -4930,14 +4899,14 @@ Previous: <a href="#vptovf-invocation" accesskey="p" rel="prev">vptovf invocatio
<p>The Web2c complement of font utilities merely implements a few basic
conversions. Many other more sophisticated font utilities exist; most
are in <samp><var>CTAN:</var>/fonts/utilities</samp> (for CTAN info,
-see <a href="https://tug.org/texinfohtml/kpathsea.html#unixtex_002eftp">unixtex.ftp</a> in <cite>Kpathsea</cite>). Here are some of the most
+see <a data-manual="kpathsea" href="https://tug.org/texinfohtml/kpathsea.html#unixtex_002eftp">unixtex.ftp</a> in <cite>Kpathsea</cite>). Here are some of the most
commonly-requested items:
</p>
<ul>
<li> <span id="index-AFM-to-TFM-conversion"></span>
<span id="index-afm2tfm"></span>
<span id="index-afmtopl"></span>
-AFM (Adobe font metric) to TFM conversion: see <a href="https://tug.org/texinfohtml/dvips.html#Invoking-afm2tfm">Invoking afm2tfm</a> in <cite>Dvips</cite>, and <samp><var>CTAN:</var>/fonts/utilities/afmtopl</samp>.
+AFM (Adobe font metric) to TFM conversion: see <a data-manual="dvips" href="https://tug.org/texinfohtml/dvips.html#Invoking-afm2tfm">Invoking afm2tfm</a> in <cite>Dvips</cite>, and <samp><var>CTAN:</var>/fonts/utilities/afmtopl</samp>.
</li><li> <span id="index-X-bitmap-fonts"></span>
<span id="index-BDF-and-GF-conversion"></span>
@@ -5003,9 +4972,12 @@ Virtual font creation: <a href="https://ctan.org/pkg/fontinst">https://ctan.org/
<hr>
-<span id="Legalisms"></span><div class="header">
+</div>
+</div>
+<div class="appendix" id="Legalisms">
+<div class="header">
<p>
-Next: <a href="#References" accesskey="n" rel="next">References</a>, Previous: <a href="#Font-utilities" accesskey="p" rel="prev">Font utilities</a>, Up: <a href="#Top" accesskey="u" rel="up">Top</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
+Next: <a href="#References" accesskey="n" rel="next">References</a>, Previous: <a href="#Font-utilities" accesskey="p" rel="prev">Font utilities</a>, Up: <a href="#Top" accesskey="u" rel="up">Web2c</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
<span id="Legalisms-1"></span><h2 class="appendix">Appendix A Legalisms</h2>
@@ -5025,13 +4997,13 @@ nature of a development request rather than a legal requirement.
</p>
<p>MLTeX, pdfTeX, LuaTeX, XeTeX, and all the other derived
engines have used various license terms for their additions to the
-base code, often the GPL (see <a href="https://www.gnu.org/licenses/#GPL">https://www.gnu.org/licenses/#GPL</a>
+base code, often the GPL (see <a href="https://www.gnu.org/licenses/#GPL">https://www.gnu.org/licenses/#GPL</a>)
or (for example) the file <samp>web2c/pdftexdir/COPYINGv2</samp>. They also
mostly make use of additional libraries with their own (compatible)
terms. Please see each program&rsquo;s sources.
</p>
<p>The Kpathsea library is covered by the GNU Lesser General Public
-License (see <a href="https://tug.org/texinfohtml/kpathsea.html#Introduction">Introduction</a> in <cite>Kpathsea</cite>). Therefore, the
+License (see <a data-manual="kpathsea" href="https://tug.org/texinfohtml/kpathsea.html#Introduction">Introduction</a> in <cite>Kpathsea</cite>). Therefore, the
<em>binaries</em> resulting from a standard Web2c compilation are also
covered by the LGPL; so if you (re)distribute the binaries, you must
also (offer to) distribute the complete source that went into those
@@ -5039,9 +5011,11 @@ binaries. See <a href="https://gnu.org/licenses/#LGPL">https://gnu.org/licenses
<samp>kpathsea/COPYING.LESSERv2</samp>.
</p>
<hr>
-<span id="References"></span><div class="header">
+</div>
+<div class="appendix" id="References">
+<div class="header">
<p>
-Next: <a href="#Index" accesskey="n" rel="next">Index</a>, Previous: <a href="#Legalisms" accesskey="p" rel="prev">Legalisms</a>, Up: <a href="#Top" accesskey="u" rel="up">Top</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
+Next: <a href="#Index" accesskey="n" rel="next">Index</a>, Previous: <a href="#Legalisms" accesskey="p" rel="prev">Legalisms</a>, Up: <a href="#Top" accesskey="u" rel="up">Web2c</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
<span id="References-1"></span><h2 class="appendix">Appendix B References</h2>
@@ -5049,9 +5023,9 @@ Next: <a href="#Index" accesskey="n" rel="next">Index</a>, Previous: <a href="#L
<span id="index-bibliography"></span>
<ol>
-<li> Kpathsea: See <a href="https://tug.org/texinfohtml/kpathsea.html#Top">Introduction</a> in <cite>Kpathsea</cite>.
+<li> Kpathsea: See <a data-manual="kpathsea" href="https://tug.org/texinfohtml/kpathsea.html#Top">Introduction</a> in <cite>Kpathsea</cite>.
-</li><li> Dvips and Afm2tfm: See <a href="https://tug.org/texinfohtml/dvips.html#Top">Introduction</a> in <cite>Dvips</cite>.
+</li><li> Dvips and Afm2tfm: See <a data-manual="dvips" href="https://tug.org/texinfohtml/dvips.html#Top">Introduction</a> in <cite>Dvips</cite>.
</li><li> The TeX Users Group: <a href="https://tug.org">https://tug.org</a>. For an introduction
to the TeX system, see <a href="https://tug.org/begin.html">https://tug.org/begin.html</a>.
@@ -5169,7 +5143,7 @@ Reprinted with corrections, 1996.
</li><li> [Lia83]
Franklin Mark Liang.
-Word hy-phen-a-tion by com-pu-ter.
+Word hy-phen-a-tion by com-put-er.
Technical Report STAN-CS-83-977, Stanford University, August 1983.
<a href="https://tug.org/docs/liang/liang-thesis.pdf">https://tug.org/docs/liang/liang-thesis.pdf</a>.
@@ -5187,9 +5161,11 @@ In Robert A. Morris and Jacques Andre, editors, <cite>Raster Imaging and
<hr>
-<span id="Index"></span><div class="header">
+</div>
+<div class="unnumbered" id="Index">
+<div class="header">
<p>
-Previous: <a href="#References" accesskey="p" rel="prev">References</a>, Up: <a href="#Top" accesskey="u" rel="up">Top</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
+Previous: <a href="#References" accesskey="p" rel="prev">References</a>, Up: <a href="#Top" accesskey="u" rel="up">Web2c</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
<span id="Index-1"></span><h2 class="unnumbered">Index</h2>
@@ -5207,13 +5183,17 @@ Previous: <a href="#References" accesskey="p" rel="prev">References</a>, Up: <a
&nbsp;
<a class="summary-letter" href="#Index_cp_symbol-7"><b>2</b></a>
&nbsp;
-<a class="summary-letter" href="#Index_cp_symbol-8"><b>8</b></a>
+<a class="summary-letter" href="#Index_cp_symbol-8"><b>3</b></a>
&nbsp;
-<a class="summary-letter" href="#Index_cp_symbol-9"><b>\</b></a>
+<a class="summary-letter" href="#Index_cp_symbol-9"><b>6</b></a>
&nbsp;
-<a class="summary-letter" href="#Index_cp_symbol-10"><b>^</b></a>
+<a class="summary-letter" href="#Index_cp_symbol-10"><b>8</b></a>
&nbsp;
-<a class="summary-letter" href="#Index_cp_symbol-11"><b>~</b></a>
+<a class="summary-letter" href="#Index_cp_symbol-11"><b>\</b></a>
+ &nbsp;
+<a class="summary-letter" href="#Index_cp_symbol-12"><b>^</b></a>
+ &nbsp;
+<a class="summary-letter" href="#Index_cp_symbol-13"><b>~</b></a>
&nbsp;
<br>
<a class="summary-letter" href="#Index_cp_letter-A"><b>A</b></a>
@@ -5398,12 +5378,18 @@ Previous: <a href="#References" accesskey="p" rel="prev">References</a>, Up: <a
<tr><th id="Index_cp_symbol-7">2</th><td></td><td></td></tr>
<tr><td></td><td valign="top"><a href="#index-2602gf"><code>2602gf</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#mf-invocation">mf invocation</a></td></tr>
<tr><td colspan="4"> <hr></td></tr>
-<tr><th id="Index_cp_symbol-8">8</th><td></td><td></td></tr>
+<tr><th id="Index_cp_symbol-8">3</th><td></td><td></td></tr>
+<tr><td></td><td valign="top"><a href="#index-32_002dbit-architecture">32-bit architecture</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Hardware-and-memory-dumps">Hardware and memory dumps</a></td></tr>
+<tr><td colspan="4"> <hr></td></tr>
+<tr><th id="Index_cp_symbol-9">6</th><td></td><td></td></tr>
+<tr><td></td><td valign="top"><a href="#index-64_002dbit-architecture">64-bit architecture</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Hardware-and-memory-dumps">Hardware and memory dumps</a></td></tr>
+<tr><td colspan="4"> <hr></td></tr>
+<tr><th id="Index_cp_symbol-10">8</th><td></td><td></td></tr>
<tr><td></td><td valign="top"><a href="#index-8-bit-clean">8 bit clean</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Common-options">Common options</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-8-bit-clean-output_002c-specifying"><code>8 bit clean output, specifying</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Common-options">Common options</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-8_002dbit-characters">8-bit characters</a>:</td><td>&nbsp;</td><td valign="top"><a href="#TCX-files">TCX files</a></td></tr>
<tr><td colspan="4"> <hr></td></tr>
-<tr><th id="Index_cp_symbol-9">\</th><td></td><td></td></tr>
+<tr><th id="Index_cp_symbol-11">\</th><td></td><td></td></tr>
<tr><td></td><td valign="top"><a href="#index-_005cbibliography"><code>\bibliography</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#bibtex-invocation">bibtex invocation</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-_005cbibliographystyle"><code>\bibliographystyle</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#bibtex-invocation">bibtex invocation</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-_005ccharsubdef-and-MLTeX"><code>\charsubdef <span class="roman">and MLTeX</span></code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005ccharsubdef">\charsubdef</a></td></tr>
@@ -5429,10 +5415,10 @@ Previous: <a href="#References" accesskey="p" rel="prev">References</a>, Up: <a
<tr><td></td><td valign="top"><a href="#index-_005ctracinglostchars-and-MLTeX"><code>\tracinglostchars <span class="roman">and MLTeX</span></code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005ctracingcharsubdef">\tracingcharsubdef</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-_005cwrite18-shell-escape-extension"><code>\write18 <span class="roman">shell escape extension</span></code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Shell-escapes">Shell escapes</a></td></tr>
<tr><td colspan="4"> <hr></td></tr>
-<tr><th id="Index_cp_symbol-10">^</th><td></td><td></td></tr>
+<tr><th id="Index_cp_symbol-12">^</th><td></td><td></td></tr>
<tr><td></td><td valign="top"><a href="#index-_005e_005e-notation_002c-avoiding"><code>^^ <span class="roman">notation, avoiding</span></code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#TCX-files">TCX files</a></td></tr>
<tr><td colspan="4"> <hr></td></tr>
-<tr><th id="Index_cp_symbol-11">~</th><td></td><td></td></tr>
+<tr><th id="Index_cp_symbol-13">~</th><td></td><td></td></tr>
<tr><td></td><td valign="top"><a href="#index-_007e-expansion-in-filenames"><code>~ <span class="roman">expansion in filenames</span></code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cinput-filename-caveats">\input filename caveats</a></td></tr>
<tr><td colspan="4"> <hr></td></tr>
<tr><th id="Index_cp_letter-A">A</th><td></td><td></td></tr>
@@ -5551,6 +5537,7 @@ Previous: <a href="#References" accesskey="p" rel="prev">References</a>, Up: <a
<tr><td></td><td valign="top"><a href="#index-copyright-notices">copyright notices</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Legalisms">Legalisms</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-Cork-encoding-and-ISO-input">Cork encoding and ISO input</a>:</td><td>&nbsp;</td><td valign="top"><a href="#TCX-files">TCX files</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-creating-memory-dumps">creating memory dumps</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Creating-memory-dumps">Creating memory dumps</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-cross_002dengine-functionality">cross-engine functionality</a>:</td><td>&nbsp;</td><td valign="top"><a href="#TeX-extensions">TeX extensions</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-cross_002dreferenced-bibliography-items">cross-referenced bibliography items</a>:</td><td>&nbsp;</td><td valign="top"><a href="#bibtex-invocation">bibtex invocation</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-cross_002dreferences_002c-omitting">cross-references, omitting</a>:</td><td>&nbsp;</td><td valign="top"><a href="#weave-invocation">weave invocation</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-current-directory_002c-used-for-output">current directory, used for output</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Output-file-location">Output file location</a></td></tr>
@@ -5697,7 +5684,9 @@ Previous: <a href="#References" accesskey="p" rel="prev">References</a>, Up: <a
<tr><td></td><td valign="top"><a href="#index-help_002c-online">help, online</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Common-options">Common options</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-Herberts_002c-Mathias">Herberts, Mathias</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Online-Metafont-graphics">Online Metafont graphics</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-hex-character-codes_002c-in-TCX-files">hex character codes, in TCX files</a>:</td><td>&nbsp;</td><td valign="top"><a href="#TCX-files">TCX files</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-HINT-_0028Hint-Is-Not-TeX_0029">HINT (Hint Is Not TeX)</a>:</td><td>&nbsp;</td><td valign="top"><a href="#TeX-extensions">TeX extensions</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-history">history</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Introduction">Introduction</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-hiTeX">hiTeX</a>:</td><td>&nbsp;</td><td valign="top"><a href="#TeX-extensions">TeX extensions</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-Hobby_002c-John">Hobby, John</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Introduction">Introduction</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-horizontal-escapement">horizontal escapement</a>:</td><td>&nbsp;</td><td valign="top"><a href="#pktype-invocation">pktype invocation</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-horizontal-escapement-1">horizontal escapement</a>:</td><td>&nbsp;</td><td valign="top"><a href="#gftype-invocation">gftype invocation</a></td></tr>
@@ -5774,6 +5763,7 @@ Previous: <a href="#References" accesskey="p" rel="prev">References</a>, Up: <a
<tr><td></td><td valign="top"><a href="#index-LittleEndian-machines">LittleEndian machines</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Hardware-and-memory-dumps">Hardware and memory dumps</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-location-of-texmf_002ecnf-in-TeX-Live">location of <samp>texmf.cnf</samp> in TeX Live</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Runtime-options">Runtime options</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-log-file_002c-BibTeX">log file, BibTeX</a>:</td><td>&nbsp;</td><td valign="top"><a href="#bibtex-invocation">bibtex invocation</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-long-data-type_002c-size-of"><code>long</code> data type, size of</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Hardware-and-memory-dumps">Hardware and memory dumps</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-Lua">Lua</a>:</td><td>&nbsp;</td><td valign="top"><a href="#TeX-extensions">TeX extensions</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-LuaTeX">LuaTeX</a>:</td><td>&nbsp;</td><td valign="top"><a href="#TeX-extensions">TeX extensions</a></td></tr>
<tr><td colspan="4"> <hr></td></tr>
@@ -6049,6 +6039,7 @@ Previous: <a href="#References" accesskey="p" rel="prev">References</a>, Up: <a
<tr><td></td><td valign="top"><a href="#index-TERM"><code>TERM</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Online-Metafont-graphics">Online Metafont graphics</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-terminator-for-filenames">terminator for filenames</a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cinput-filenames">\input filenames</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-terse-output">terse output</a>:</td><td>&nbsp;</td><td valign="top"><a href="#bibtex-invocation">bibtex invocation</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-teTeX-distribution">teTeX distribution</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Introduction">Introduction</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-tex"><code>tex</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#tex-invocation">tex invocation</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-TeX_002c-bibliographies-for">TeX, bibliographies for</a>:</td><td>&nbsp;</td><td valign="top"><a href="#bibtex-invocation">bibtex invocation</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-TeX_002c-creating-from-Metafont">TeX, creating from Metafont</a>:</td><td>&nbsp;</td><td valign="top"><a href="#mft-invocation">mft invocation</a></td></tr>
@@ -6085,6 +6076,7 @@ Previous: <a href="#References" accesskey="p" rel="prev">References</a>, Up: <a
<tr><td></td><td valign="top"><a href="#index-three-programs">three programs</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Three-programs">Three programs</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-time-and-date_002c-in-memory-dumps">time and date, in memory dumps</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Hardware-and-memory-dumps">Hardware and memory dumps</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-title-font">title font</a>:</td><td>&nbsp;</td><td valign="top"><a href="#gftodvi-invocation">gftodvi invocation</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-tl_002dcheck_002dfmtshare"><code>tl-check-fmtshare</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Hardware-and-memory-dumps">Hardware and memory dumps</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-tokenization_002c-and-_005cinput-filenames">tokenization, and <code>\input</code> filenames</a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cinput-filename-caveats">\input filename caveats</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-toolkits_002c-X">toolkits, X</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Online-Metafont-graphics">Online Metafont graphics</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-torture-tests">torture tests</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Triptrap">Triptrap</a></td></tr>
@@ -6196,13 +6188,17 @@ Previous: <a href="#References" accesskey="p" rel="prev">References</a>, Up: <a
&nbsp;
<a class="summary-letter" href="#Index_cp_symbol-7"><b>2</b></a>
&nbsp;
-<a class="summary-letter" href="#Index_cp_symbol-8"><b>8</b></a>
+<a class="summary-letter" href="#Index_cp_symbol-8"><b>3</b></a>
+ &nbsp;
+<a class="summary-letter" href="#Index_cp_symbol-9"><b>6</b></a>
&nbsp;
-<a class="summary-letter" href="#Index_cp_symbol-9"><b>\</b></a>
+<a class="summary-letter" href="#Index_cp_symbol-10"><b>8</b></a>
&nbsp;
-<a class="summary-letter" href="#Index_cp_symbol-10"><b>^</b></a>
+<a class="summary-letter" href="#Index_cp_symbol-11"><b>\</b></a>
&nbsp;
-<a class="summary-letter" href="#Index_cp_symbol-11"><b>~</b></a>
+<a class="summary-letter" href="#Index_cp_symbol-12"><b>^</b></a>
+ &nbsp;
+<a class="summary-letter" href="#Index_cp_symbol-13"><b>~</b></a>
&nbsp;
<br>
<a class="summary-letter" href="#Index_cp_letter-A"><b>A</b></a>
@@ -6257,7 +6253,8 @@ Previous: <a href="#References" accesskey="p" rel="prev">References</a>, Up: <a
&nbsp;
</td></tr></table>
-<hr>
+</div>
+</div>