summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
-rw-r--r--Master/texmf/doc/dvipng/dvipng.html54
-rw-r--r--Master/texmf/doc/dvipng/dvipng.pdfbin176160 -> 256860 bytes
-rw-r--r--Master/texmf/doc/dvips/dvips.html1492
-rw-r--r--Master/texmf/doc/dvips/dvips.pdfbin446568 -> 408821 bytes
-rw-r--r--Master/texmf/doc/info/asymptote.info2063
-rw-r--r--Master/texmf/doc/info/dir1
-rw-r--r--Master/texmf/doc/info/dvipng.info55
-rw-r--r--Master/texmf/doc/info/dvips.info631
-rw-r--r--Master/texmf/doc/info/fontname.info1219
-rw-r--r--Master/texmf/doc/info/kpathsea.info786
-rw-r--r--Master/texmf/doc/info/web2c.info809
-rw-r--r--Master/texmf/doc/kpathsea/kpathsea.html2778
-rw-r--r--Master/texmf/doc/kpathsea/kpathsea.pdfbin563870 -> 657266 bytes
-rw-r--r--Master/texmf/doc/web2c/web2c.html2174
-rw-r--r--Master/texmf/doc/web2c/web2c.pdfbin598873 -> 667676 bytes
-rwxr-xr-xMaster/tlpkg/bin/tl-update-txi21
16 files changed, 6002 insertions, 6081 deletions
diff --git a/Master/texmf/doc/dvipng/dvipng.html b/Master/texmf/doc/dvipng/dvipng.html
index 6224cf78c7f..b2de8e77039 100644
--- a/Master/texmf/doc/dvipng/dvipng.html
+++ b/Master/texmf/doc/dvipng/dvipng.html
@@ -3,7 +3,7 @@
<title>A DVI-to-PNG translator</title>
<meta http-equiv="Content-Type" content="text/html">
<meta name="description" content="A DVI-to-PNG translator">
-<meta name="generator" content="makeinfo 4.12">
+<meta name="generator" content="makeinfo 4.13">
<link title="Top" rel="top" href="#Top">
<link href="http://www.gnu.org/software/texinfo/" rel="generator-home" title="Texinfo Homepage">
<meta http-equiv="Content-Style-Type" content="text/css">
@@ -64,8 +64,8 @@
<div class="node">
-<p><hr>
<a name="Top"></a>
+<p><hr>
Next:&nbsp;<a rel="next" accesskey="n" href="#Introduction">Introduction</a>,
Up:&nbsp;<a rel="up" accesskey="u" href="#dir">(dir)</a>
@@ -76,7 +76,7 @@ Up:&nbsp;<a rel="up" accesskey="u" href="#dir">(dir)</a>
<p>This manual documents dvipng, a program to translate a DVI (DeVice
Independent) file into PNG (Portable Network Graphics).
- <p>This file documents dvipng version 1.11
+ <p>This file documents dvipng version 1.12
<p>Corrections or perhaps rewrites of sections are <em>very welcome</em>.
@@ -96,8 +96,8 @@ Independent) file into PNG (Portable Network Graphics).
</ul>
<div class="node">
-<p><hr>
<a name="Introduction"></a>
+<p><hr>
Next:&nbsp;<a rel="next" accesskey="n" href="#Installation">Installation</a>,
Previous:&nbsp;<a rel="previous" accesskey="p" href="#Top">Top</a>,
Up:&nbsp;<a rel="up" accesskey="u" href="#Top">Top</a>
@@ -162,8 +162,8 @@ PNG, JPEG or GIF images.
<!-- man end -->
<div class="node">
-<p><hr>
<a name="Installation"></a>
+<p><hr>
Next:&nbsp;<a rel="next" accesskey="n" href="#Basic-usage">Basic usage</a>,
Previous:&nbsp;<a rel="previous" accesskey="p" href="#Introduction">Introduction</a>,
Up:&nbsp;<a rel="up" accesskey="u" href="#Top">Top</a>
@@ -189,8 +189,8 @@ Up:&nbsp;<a rel="up" accesskey="u" href="#Top">Top</a>
</ul>
<div class="node">
-<p><hr>
<a name="Prerequisites"></a>
+<p><hr>
Next:&nbsp;<a rel="next" accesskey="n" href="#Configure">Configure</a>,
Up:&nbsp;<a rel="up" accesskey="u" href="#Installation">Installation</a>
@@ -252,8 +252,8 @@ any modern system, if not, download them and install them.
</ul>
<div class="node">
-<p><hr>
<a name="Configure"></a>
+<p><hr>
Next:&nbsp;<a rel="next" accesskey="n" href="#Build_002finstall">Build/install</a>,
Previous:&nbsp;<a rel="previous" accesskey="p" href="#Prerequisites">Prerequisites</a>,
Up:&nbsp;<a rel="up" accesskey="u" href="#Installation">Installation</a>
@@ -311,9 +311,9 @@ are located in e.g., <samp><span class="file">/sw/local/include</span></samp>, d
<p class="noindent">where the backslash denotes a continuation of the line.
<div class="node">
-<p><hr>
<a name="Build%2finstall"></a>
<a name="Build_002finstall"></a>
+<p><hr>
Next:&nbsp;<a rel="next" accesskey="n" href="#Installation-outside-the-texmf-tree">Installation outside the texmf tree</a>,
Previous:&nbsp;<a rel="previous" accesskey="p" href="#Configure">Configure</a>,
Up:&nbsp;<a rel="up" accesskey="u" href="#Installation">Installation</a>
@@ -335,8 +335,8 @@ To install the files into the locations chosen earlier, type
into system directories.
<div class="node">
-<p><hr>
<a name="Installation-outside-the-texmf-tree"></a>
+<p><hr>
Next:&nbsp;<a rel="next" accesskey="n" href="#Advice-for-non_002dprivileged-users">Advice for non-privileged users</a>,
Previous:&nbsp;<a rel="previous" accesskey="p" href="#Build_002finstall">Build/install</a>,
Up:&nbsp;<a rel="up" accesskey="u" href="#Installation">Installation</a>
@@ -355,9 +355,9 @@ dvipng adjust these three internally so that kpathsea thinks that
dvipng <em>is</em> installed in the texmf tree.
<div class="node">
-<p><hr>
<a name="Advice-for-non-privileged-users"></a>
<a name="Advice-for-non_002dprivileged-users"></a>
+<p><hr>
Previous:&nbsp;<a rel="previous" accesskey="p" href="#Installation-outside-the-texmf-tree">Installation outside the texmf tree</a>,
Up:&nbsp;<a rel="up" accesskey="u" href="#Installation">Installation</a>
@@ -381,8 +381,8 @@ set the <code>INFOPATH</code> and <code>MANPATH</code> variables to be able to
access the documentation.
<div class="node">
-<p><hr>
<a name="Basic-usage"></a>
+<p><hr>
Next:&nbsp;<a rel="next" accesskey="n" href="#Command_002dline-options">Command-line options</a>,
Previous:&nbsp;<a rel="previous" accesskey="p" href="#Installation">Installation</a>,
Up:&nbsp;<a rel="up" accesskey="u" href="#Top">Top</a>
@@ -416,9 +416,9 @@ of available options, just type
<pre class="example"> dvipng --help
</pre>
<div class="node">
-<p><hr>
<a name="Command-line-options"></a>
<a name="Command_002dline-options"></a>
+<p><hr>
Next:&nbsp;<a rel="next" accesskey="n" href="#Graphics">Graphics</a>,
Previous:&nbsp;<a rel="previous" accesskey="p" href="#Basic-usage">Basic usage</a>,
Up:&nbsp;<a rel="up" accesskey="u" href="#Top">Top</a>
@@ -437,8 +437,8 @@ section will give a good idea of the capabilities of the driver.
</ul>
<div class="node">
-<p><hr>
<a name="Option-summary"></a>
+<p><hr>
Next:&nbsp;<a rel="next" accesskey="n" href="#Option-details">Option details</a>,
Up:&nbsp;<a rel="up" accesskey="u" href="#Command_002dline-options">Command-line options</a>
@@ -449,7 +449,7 @@ Up:&nbsp;<a rel="up" accesskey="u" href="#Command_002dline-options">Command-line
<p><a name="index-options_002c-summary-7"></a>Here is a handy summary of the options; it is printed out when you run
dvipng with no arguments or with the standard &lsquo;<samp><span class="samp">--help</span></samp>&rsquo; option.
-<pre class="example"> This is ./dvipng 1.11 Copyright 2002-2008 Jan-Ake Larsson
+<pre class="example"> This is ./dvipng 1.12 Copyright 2002-2008 Jan-Ake Larsson
Usage: ./dvipng [OPTION]... FILENAME[.dvi]
Options are chosen to be similar to dvips' options where possible:
@@ -493,8 +493,8 @@ dvipng with no arguments or with the standard &lsquo;<samp><span class="samp">--
</pre>
<div class="node">
-<p><hr>
<a name="Option-details"></a>
+<p><hr>
Previous:&nbsp;<a rel="previous" accesskey="p" href="#Option-summary">Option summary</a>,
Up:&nbsp;<a rel="up" accesskey="u" href="#Command_002dline-options">Command-line options</a>
@@ -781,8 +781,8 @@ correspond directly to the zlib compression levels.
<!-- man end -->
<div class="node">
-<p><hr>
<a name="Graphics"></a>
+<p><hr>
Next:&nbsp;<a rel="next" accesskey="n" href="#Color">Color</a>,
Previous:&nbsp;<a rel="previous" accesskey="p" href="#Command_002dline-options">Command-line options</a>,
Up:&nbsp;<a rel="up" accesskey="u" href="#Top">Top</a>
@@ -804,8 +804,8 @@ details below.
</ul>
<div class="node">
-<p><hr>
<a name="Encapsulated-PostScript"></a>
+<p><hr>
Next:&nbsp;<a rel="next" accesskey="n" href="#Bitmapped-graphics">Bitmapped graphics</a>,
Up:&nbsp;<a rel="up" accesskey="u" href="#Graphics">Graphics</a>
@@ -837,8 +837,8 @@ in this example (using &lsquo;<samp><span class="samp">graphicx</span></samp>&rs
<pre class="example"> \includegraphics[bb=10 20 100 200]{imagename.eps}
</pre>
<div class="node">
-<p><hr>
<a name="Bitmapped-graphics"></a>
+<p><hr>
Previous:&nbsp;<a rel="previous" accesskey="p" href="#Encapsulated-PostScript">Encapsulated PostScript</a>,
Up:&nbsp;<a rel="up" accesskey="u" href="#Graphics">Graphics</a>
@@ -870,8 +870,8 @@ wide:
<pre class="example"> \includegraphics[bb=0 0 300 400,witdh=1.5in]{imagename.png}
</pre>
<div class="node">
-<p><hr>
<a name="Color"></a>
+<p><hr>
Next:&nbsp;<a rel="next" accesskey="n" href="#Diagnosing-problems">Diagnosing problems</a>,
Previous:&nbsp;<a rel="previous" accesskey="p" href="#Graphics">Graphics</a>,
Up:&nbsp;<a rel="up" accesskey="u" href="#Top">Top</a>
@@ -891,8 +891,8 @@ specials start with the keyword &lsquo;<samp><span class="samp">color</span></sa
</ul>
<div class="node">
-<p><hr>
<a name="Color-specifications"></a>
+<p><hr>
Next:&nbsp;<a rel="next" accesskey="n" href="#Color-specials">Color specials</a>,
Up:&nbsp;<a rel="up" accesskey="u" href="#Color">Color</a>
@@ -922,8 +922,8 @@ an argument to &lsquo;<samp><span class="samp">--bg</span></samp>&rsquo; to choo
See <a href="#Option-details">Option details</a>.
<div class="node">
-<p><hr>
<a name="Color-specials"></a>
+<p><hr>
Previous:&nbsp;<a rel="previous" accesskey="p" href="#Color-specifications">Color specifications</a>,
Up:&nbsp;<a rel="up" accesskey="u" href="#Color">Color</a>
@@ -958,8 +958,8 @@ that color.
the pages are rendered repeatedly or in reverse order.
<div class="node">
-<p><hr>
<a name="Diagnosing-problems"></a>
+<p><hr>
Next:&nbsp;<a rel="next" accesskey="n" href="#Credits">Credits</a>,
Previous:&nbsp;<a rel="previous" accesskey="p" href="#Color">Color</a>,
Up:&nbsp;<a rel="up" accesskey="u" href="#Top">Top</a>
@@ -980,8 +980,8 @@ yourself in such a situation.
</ul>
<div class="node">
-<p><hr>
<a name="Contact-information"></a>
+<p><hr>
Next:&nbsp;<a rel="next" accesskey="n" href="#Debug-options">Debug options</a>,
Up:&nbsp;<a rel="up" accesskey="u" href="#Diagnosing-problems">Diagnosing problems</a>
@@ -1005,8 +1005,8 @@ access, ask on <a href="mailto:dvipng@nongnu.org">dvipng@nongnu.org</a>.
problems, see <a href="kpathsea.html#Common-problems">Common problems</a>.
<div class="node">
-<p><hr>
<a name="Debug-options"></a>
+<p><hr>
Previous:&nbsp;<a rel="previous" accesskey="p" href="#Contact-information">Contact information</a>,
Up:&nbsp;<a rel="up" accesskey="u" href="#Diagnosing-problems">Diagnosing problems</a>
@@ -1044,8 +1044,8 @@ track all classes, you can use <code>-1</code>.
</dl>
<div class="node">
-<p><hr>
<a name="Credits"></a>
+<p><hr>
Next:&nbsp;<a rel="next" accesskey="n" href="#Copying">Copying</a>,
Previous:&nbsp;<a rel="previous" accesskey="p" href="#Diagnosing-problems">Diagnosing problems</a>,
Up:&nbsp;<a rel="up" accesskey="u" href="#Top">Top</a>
@@ -1072,8 +1072,8 @@ Klausner, Harald Koenig, Adrian Bunk, Kevin Smith, Jason Riedy,
Wolfram Krause, Reinhard Kotucha, and Takeshi Abe.
<div class="node">
-<p><hr>
<a name="Copying"></a>
+<p><hr>
Next:&nbsp;<a rel="next" accesskey="n" href="#Index">Index</a>,
Previous:&nbsp;<a rel="previous" accesskey="p" href="#Credits">Credits</a>,
Up:&nbsp;<a rel="up" accesskey="u" href="#Top">Top</a>
@@ -1103,8 +1103,8 @@ License along with this program. If not, see
Copyright &copy; 2002-2008 Jan-&Aring;ke Larsson
<div class="node">
-<p><hr>
<a name="Index"></a>
+<p><hr>
Previous:&nbsp;<a rel="previous" accesskey="p" href="#Copying">Copying</a>,
Up:&nbsp;<a rel="up" accesskey="u" href="#Top">Top</a>
diff --git a/Master/texmf/doc/dvipng/dvipng.pdf b/Master/texmf/doc/dvipng/dvipng.pdf
index 019033d132d..e92a19ce5be 100644
--- a/Master/texmf/doc/dvipng/dvipng.pdf
+++ b/Master/texmf/doc/dvipng/dvipng.pdf
Binary files differ
diff --git a/Master/texmf/doc/dvips/dvips.html b/Master/texmf/doc/dvips/dvips.html
index 6112c321935..22c3022a8ea 100644
--- a/Master/texmf/doc/dvips/dvips.html
+++ b/Master/texmf/doc/dvips/dvips.html
@@ -3,12 +3,12 @@
<title>Dvips: A DVI-to-PostScript translator</title>
<meta http-equiv="Content-Type" content="text/html">
<meta name="description" content="Dvips: A DVI-to-PostScript translator">
-<meta name="generator" content="makeinfo 4.12">
+<meta name="generator" content="makeinfo 4.13">
<link title="Top" rel="top" href="#Top">
<link href="http://www.gnu.org/software/texinfo/" rel="generator-home" title="Texinfo Homepage">
<!--
-This manual documents Dvips version 5.97
-(July 2008), a program to translate a DVI file into
+This manual documents Dvips version 5.98
+(September 2009), a program to translate a DVI file into
PostScript. You may freely use, modify and/or distribute this file.-->
<meta http-equiv="Content-Style-Type" content="text/css">
<style type="text/css"><!--
@@ -162,8 +162,8 @@ PostScript. You may freely use, modify and/or distribute this file.-->
</div>
<div class="node">
-<p><hr>
<a name="Top"></a>
+<p><hr>
Next:&nbsp;<a rel="next" accesskey="n" href="#Why-Dvips">Why Dvips</a>,
Up:&nbsp;<a rel="up" accesskey="u" href="#dir">(dir)</a>
@@ -171,8 +171,8 @@ Up:&nbsp;<a rel="up" accesskey="u" href="#dir">(dir)</a>
<h2 class="unnumbered">Dvips</h2>
-<p>This manual documents Dvips version 5.97
-(July 2008), a program to translate a DVI file into
+<p>This manual documents Dvips version 5.98
+(September 2009), a program to translate a DVI file into
PostScript. You may freely use, modify and/or distribute this file.
<ul class="menu">
@@ -187,8 +187,8 @@ PostScript. You may freely use, modify and/or distribute this file.
</ul>
<div class="node">
-<p><hr>
<a name="Why-Dvips"></a>
+<p><hr>
Next:&nbsp;<a rel="next" accesskey="n" href="#Installation">Installation</a>,
Previous:&nbsp;<a rel="previous" accesskey="p" href="#Top">Top</a>,
Up:&nbsp;<a rel="up" accesskey="u" href="#Top">Top</a>
@@ -263,8 +263,8 @@ So if you don't use Dvips on your system, get it today.
<!-- INSTALLONLY -->
<div class="node">
-<p><hr>
<a name="Installation"></a>
+<p><hr>
Next:&nbsp;<a rel="next" accesskey="n" href="#Invoking-Dvips">Invoking Dvips</a>,
Previous:&nbsp;<a rel="previous" accesskey="p" href="#Why-Dvips">Why Dvips</a>,
Up:&nbsp;<a rel="up" accesskey="u" href="#Top">Top</a>
@@ -297,9 +297,9 @@ sections below. Also, to configure color devices, see <a href="#Color-device-co
</ul>
<div class="node">
-<p><hr>
<a name="config.ps-installation"></a>
<a name="config_002eps-installation"></a>
+<p><hr>
Next:&nbsp;<a rel="next" accesskey="n" href="#PostScript-font-installation">PostScript font installation</a>,
Up:&nbsp;<a rel="up" accesskey="u" href="#Installation">Installation</a>
@@ -370,8 +370,8 @@ for your reading pleasure:
% <samp><span class="file">contrib/papersize.simple</span></samp>.
</pre>
<div class="node">
-<p><hr>
<a name="PostScript-font-installation"></a>
+<p><hr>
Next:&nbsp;<a rel="next" accesskey="n" href="#Ghostscript-installation">Ghostscript installation</a>,
Previous:&nbsp;<a rel="previous" accesskey="p" href="#config_002eps-installation">config.ps installation</a>,
Up:&nbsp;<a rel="up" accesskey="u" href="#Installation">Installation</a>
@@ -447,8 +447,8 @@ Windows when you ask for the driver set will likely lead to great
confusion on the other end.
<div class="node">
-<p><hr>
<a name="Ghostscript-installation"></a>
+<p><hr>
Next:&nbsp;<a rel="next" accesskey="n" href="#Diagnosing-problems">Diagnosing problems</a>,
Previous:&nbsp;<a rel="previous" accesskey="p" href="#PostScript-font-installation">PostScript font installation</a>,
Up:&nbsp;<a rel="up" accesskey="u" href="#Installation">Installation</a>
@@ -477,8 +477,8 @@ specifically with &lsquo;<samp><span class="samp">%%Page</span></samp>&rsquo; co
Ghostscript.
<div class="node">
-<p><hr>
<a name="Diagnosing-problems"></a>
+<p><hr>
Previous:&nbsp;<a rel="previous" accesskey="p" href="#Ghostscript-installation">Ghostscript installation</a>,
Up:&nbsp;<a rel="up" accesskey="u" href="#Installation">Installation</a>
@@ -510,8 +510,8 @@ settings you expect.
</ul>
<div class="node">
-<p><hr>
<a name="Debug-options"></a>
+<p><hr>
Next:&nbsp;<a rel="next" accesskey="n" href="#No-output">No output</a>,
Up:&nbsp;<a rel="up" accesskey="u" href="#Diagnosing-problems">Diagnosing problems</a>
@@ -554,8 +554,8 @@ of these values.
</dl>
<div class="node">
-<p><hr>
<a name="No-output"></a>
+<p><hr>
Next:&nbsp;<a rel="next" accesskey="n" href="#Small-or-inverted">Small or inverted</a>,
Previous:&nbsp;<a rel="previous" accesskey="p" href="#Debug-options">Debug options</a>,
Up:&nbsp;<a rel="up" accesskey="u" href="#Diagnosing-problems">Diagnosing problems</a>
@@ -591,8 +591,8 @@ structured comments. Try the &lsquo;<samp><span class="samp">-N</span></samp>&r
comments and see what happens.
<div class="node">
-<p><hr>
<a name="Small-or-inverted"></a>
+<p><hr>
Next:&nbsp;<a rel="next" accesskey="n" href="#Printer-errors">Printer errors</a>,
Previous:&nbsp;<a rel="previous" accesskey="p" href="#No-output">No output</a>,
Up:&nbsp;<a rel="up" accesskey="u" href="#Diagnosing-problems">Diagnosing problems</a>
@@ -612,8 +612,8 @@ config file option) to enclose the entire job in a save/restore pair.
See <a href="#Command_002dline-options">Command-line options</a>, and <a href="#Config-files">Config files</a>.
<div class="node">
-<p><hr>
<a name="Printer-errors"></a>
+<p><hr>
Next:&nbsp;<a rel="next" accesskey="n" href="#Long-documents-fail">Long documents fail</a>,
Previous:&nbsp;<a rel="previous" accesskey="p" href="#Small-or-inverted">Small or inverted</a>,
Up:&nbsp;<a rel="up" accesskey="u" href="#Diagnosing-problems">Diagnosing problems</a>
@@ -645,8 +645,8 @@ you have one, or Ghostscript (see <a href="#Ghostscript-installation">Ghostscrip
might be a problem with the printer itself.
<div class="node">
-<p><hr>
<a name="Long-documents-fail"></a>
+<p><hr>
Next:&nbsp;<a rel="next" accesskey="n" href="#Including-graphics-fails">Including graphics fails</a>,
Previous:&nbsp;<a rel="previous" accesskey="p" href="#Printer-errors">Printer errors</a>,
Up:&nbsp;<a rel="up" accesskey="u" href="#Diagnosing-problems">Diagnosing problems</a>
@@ -660,8 +660,8 @@ This is usually caused by incorrectly specifying the amount of memory
the printer has in the configuration file; see the previous section.
<div class="node">
-<p><hr>
<a name="Including-graphics-fails"></a>
+<p><hr>
Previous:&nbsp;<a rel="previous" accesskey="p" href="#Long-documents-fail">Long documents fail</a>,
Up:&nbsp;<a rel="up" accesskey="u" href="#Diagnosing-problems">Diagnosing problems</a>
@@ -691,8 +691,8 @@ looking for a particular comment.
(not ASCII hex) will probably fail with Dvips.
<div class="node">
-<p><hr>
<a name="Invoking-Dvips"></a>
+<p><hr>
Next:&nbsp;<a rel="next" accesskey="n" href="#Paper-size-and-landscape">Paper size and landscape</a>,
Previous:&nbsp;<a rel="previous" accesskey="p" href="#Installation">Installation</a>,
Up:&nbsp;<a rel="up" accesskey="u" href="#Top">Top</a>
@@ -718,8 +718,8 @@ environment variables, and command-line options.
</ul>
<div class="node">
-<p><hr>
<a name="Basic-usage"></a>
+<p><hr>
Next:&nbsp;<a rel="next" accesskey="n" href="#Command_002dline-options">Command-line options</a>,
Up:&nbsp;<a rel="up" accesskey="u" href="#Invoking-Dvips">Invoking Dvips</a>
@@ -747,9 +747,9 @@ of available options, just type
<pre class="example"> dvips --help
</pre>
<div class="node">
-<p><hr>
<a name="Command-line-options"></a>
<a name="Command_002dline-options"></a>
+<p><hr>
Next:&nbsp;<a rel="next" accesskey="n" href="#Environment-variables">Environment variables</a>,
Previous:&nbsp;<a rel="previous" accesskey="p" href="#Basic-usage">Basic usage</a>,
Up:&nbsp;<a rel="up" accesskey="u" href="#Invoking-Dvips">Invoking Dvips</a>
@@ -767,8 +767,8 @@ section will give a good idea of the capabilities of the driver.
</ul>
<div class="node">
-<p><hr>
<a name="Option-summary"></a>
+<p><hr>
Next:&nbsp;<a rel="next" accesskey="n" href="#Option-details">Option details</a>,
Up:&nbsp;<a rel="up" accesskey="u" href="#Command_002dline-options">Command-line options</a>
@@ -820,8 +820,8 @@ Email bug reports to tex-k@mail.tug.org.
</pre>
<div class="node">
-<p><hr>
<a name="Option-details"></a>
+<p><hr>
Previous:&nbsp;<a rel="previous" accesskey="p" href="#Option-summary">Option summary</a>,
Up:&nbsp;<a rel="up" accesskey="u" href="#Command_002dline-options">Command-line options</a>
@@ -925,7 +925,8 @@ systems. On systems shared by more than one person, this is not
recommended.
<br><dt>&lsquo;<samp><span class="samp">-G*</span></samp>&rsquo;<dd><a name="index-g_t_002dG-128"></a><a name="index-low-characters_002c-shifting-129"></a><a name="index-non_002dprinting-characters_002c-shifting-130"></a>Shift non-printing characters (ASCII 0-32, 127) to higher-numbered positions.
-This may be useful sometimes.
+This was useful to work around bugs in old versions of Adobe's PDF
+reader. It's more likely to cause problems nowadays.
<br><dt>&lsquo;<samp><span class="samp">-h </span><var>name</var></samp>&rsquo;<dd><a name="index-g_t_002dh-_0040var_007bname_007d-131"></a><a name="index-header-file_002c-downloading-132"></a><a name="index-userdict_0040r_007b_002c-used-for-header-files_007d-133"></a>Prepend <var>name</var> as an additional header file, or, if <var>name</var> is
&lsquo;<samp><span class="samp">-</span></samp>&rsquo;, suppress all header files. Any definitions in the header file
@@ -1105,11 +1106,15 @@ which rotates a document by 90 degrees.
can use the &lsquo;<samp><span class="samp">-t</span></samp>&rsquo; option twice, once for the paper type, and once
for &lsquo;<samp><span class="samp">landscape</span></samp>&rsquo;.
<li>In general, you should not use any &lsquo;<samp><span class="samp">-t</span></samp>&rsquo; option when
-using a &lsquo;<samp><span class="samp">papersize</span></samp>&rsquo; special, as some LaTeX packages do, e.g.,
-&lsquo;<samp><span class="samp">hyperref.sty</span></samp>&rsquo;.
-<li>The exception is when using a nonstandard paper size that is not
+using a &lsquo;<samp><span class="samp">papersize</span></samp>&rsquo; special, which some LaTeX packages (e.g.,
+&lsquo;<samp><span class="samp">hyperref</span></samp>&rsquo;) insert.
+<li>One exception is when using a nonstandard paper size that is not
already defined in <samp><span class="file">config.ps</span></samp>; in this case, you need to specify
&lsquo;<samp><span class="samp">-t&nbsp;unknown</span></samp>&rsquo;.
+<li>Another exception is when producing multi-page files for further
+processing; use &lsquo;<samp><span class="samp">-t&nbsp;nopaper</span></samp>&rsquo; to omit any paper size
+information in the output. (If you just have a single page document,
+you can use &lsquo;<samp><span class="samp">-E</span></samp>&rsquo; to get pure EPSF output.)
</ul>
<br><dt>&lsquo;<samp><span class="samp">-T </span><var>hsize</var><span class="samp">,</span><var>vsize</var></samp>&rsquo;<dd><a name="index-g_t_002dT-_0040var_007bhsize_007d_002c_0040var_007bvsize_007d-219"></a>Set the paper size to (<var>hsize</var>,<var>vsize</var>), a comma-separated
@@ -1170,8 +1175,8 @@ enabled in the configuration file (see <a href="#Configuration-file-commands">Co
</dl>
<div class="node">
-<p><hr>
<a name="Environment-variables"></a>
+<p><hr>
Next:&nbsp;<a rel="next" accesskey="n" href="#Config-files">Config files</a>,
Previous:&nbsp;<a rel="previous" accesskey="p" href="#Command_002dline-options">Command-line options</a>,
Up:&nbsp;<a rel="up" accesskey="u" href="#Invoking-Dvips">Invoking Dvips</a>
@@ -1235,8 +1240,8 @@ config file option (see <a href="#Configuration-file-commands">Configuration fil
</dl>
<div class="node">
-<p><hr>
<a name="Config-files"></a>
+<p><hr>
Previous:&nbsp;<a rel="previous" accesskey="p" href="#Environment-variables">Environment variables</a>,
Up:&nbsp;<a rel="up" accesskey="u" href="#Invoking-Dvips">Invoking Dvips</a>
@@ -1260,8 +1265,8 @@ you can copy, see <a href="#config_002eps-installation">config.ps installation</
</ul>
<div class="node">
-<p><hr>
<a name="Configuration-file-searching"></a>
+<p><hr>
Next:&nbsp;<a rel="next" accesskey="n" href="#Configuration-file-commands">Configuration file commands</a>,
Up:&nbsp;<a rel="up" accesskey="u" href="#Config-files">Config files</a>
@@ -1337,8 +1342,8 @@ resolve), and (2) let command-line options override config files where
possible.
<div class="node">
-<p><hr>
<a name="Configuration-file-commands"></a>
+<p><hr>
Previous:&nbsp;<a rel="previous" accesskey="p" href="#Configuration-file-searching">Configuration file searching</a>,
Up:&nbsp;<a rel="up" accesskey="u" href="#Config-files">Config files</a>
@@ -1376,19 +1381,22 @@ be printed if the option is used (and warnings are not suppressed).
<br><dt>&lsquo;<samp><span class="samp">f*</span></samp>&rsquo;<dt>&lsquo;<samp><span class="samp">F</span></samp>&rsquo;<dd><a name="index-f-_0040r_007bconfig-command-_0028filter_0029_007d-278"></a><a name="index-F-_0040r_007bconfig-command-_0028filter_0029_007d-279"></a>Run as a filter. Same as &lsquo;<samp><span class="samp">-f</span></samp>&rsquo;, see <a href="#Option-details">Option details</a>.
- <br><dt>&lsquo;<samp><span class="samp">h </span><var>header</var></samp>&rsquo;<dd><a name="index-h-_0040r_007bheader-downloading-config-command_007d-280"></a>Prepend <var>header</var> to output. Same as &lsquo;<samp><span class="samp">h-</span></samp>&rsquo;, see <a href="#Option-details">Option details</a>.
+ <br><dt>&lsquo;<samp><span class="samp">G*</span></samp>&rsquo;<dd><a name="index-G-_0040r_007bcharacter-shifting-config-command_007d-280"></a>Shift low-numbered characters; obsolete. Same as &lsquo;<samp><span class="samp">-G</span></samp>&rsquo;,
+see <a href="#Option-details">Option details</a>.
+
+ <br><dt>&lsquo;<samp><span class="samp">h </span><var>header</var></samp>&rsquo;<dd><a name="index-h-_0040r_007bheader-downloading-config-command_007d-281"></a>Prepend <var>header</var> to output. Same as &lsquo;<samp><span class="samp">h-</span></samp>&rsquo;, see <a href="#Option-details">Option details</a>.
- <br><dt>&lsquo;<samp><span class="samp">H </span><var>path</var></samp>&rsquo;<dd><a name="index-H-_0040r_007bheader-path-config-command_007d-281"></a><a name="index-header-path_002c-defining-282"></a><a name="index-DVIPSHEADERS_0040r_007b_002c-overrides_007d-H-283"></a>Use <var>path</var> to search for PostScript header files. The environment
+ <br><dt>&lsquo;<samp><span class="samp">H </span><var>path</var></samp>&rsquo;<dd><a name="index-H-_0040r_007bheader-path-config-command_007d-282"></a><a name="index-header-path_002c-defining-283"></a><a name="index-DVIPSHEADERS_0040r_007b_002c-overrides_007d-H-284"></a>Use <var>path</var> to search for PostScript header files. The environment
variable <code>DVIPSHEADERS</code> overrides this.
- <br><dt>&lsquo;<samp><span class="samp">i </span><var>n</var></samp>&rsquo;<dd><a name="index-i-_0040r_007bconfig-command-_0028pages_002fsection_0029_007d-284"></a>Make multiple output files. Same as &lsquo;<samp><span class="samp">-i -S </span><var>n</var></samp>&rsquo;, see <a href="#Option-details">Option details</a>.
+ <br><dt>&lsquo;<samp><span class="samp">i </span><var>n</var></samp>&rsquo;<dd><a name="index-i-_0040r_007bconfig-command-_0028pages_002fsection_0029_007d-285"></a>Make multiple output files. Same as &lsquo;<samp><span class="samp">-i -S </span><var>n</var></samp>&rsquo;, see <a href="#Option-details">Option details</a>.
- <br><dt>&lsquo;<samp><span class="samp">j*</span></samp>&rsquo;<dd><a name="index-j-_0040r_007bconfig-command-_0028partial-font-downloading_0029_007d-285"></a>Partially download Type 1 fonts. Same as &lsquo;<samp><span class="samp">-j</span></samp>&rsquo;, see <a href="#Option-details">Option details</a>.
+ <br><dt>&lsquo;<samp><span class="samp">j*</span></samp>&rsquo;<dd><a name="index-j-_0040r_007bconfig-command-_0028partial-font-downloading_0029_007d-286"></a>Partially download Type 1 fonts. Same as &lsquo;<samp><span class="samp">-j</span></samp>&rsquo;, see <a href="#Option-details">Option details</a>.
- <br><dt>&lsquo;<samp><span class="samp">K*</span></samp>&rsquo;<dd><a name="index-K-_0040r_007bconfig-command-_0028comment_002dremoveal_0029_007d-286"></a>Remove comments from included PostScript files. Same as &lsquo;<samp><span class="samp">-K</span></samp>&rsquo;,
+ <br><dt>&lsquo;<samp><span class="samp">K*</span></samp>&rsquo;<dd><a name="index-K-_0040r_007bconfig-command-_0028comment_002dremoval_0029_007d-287"></a>Remove comments from included PostScript files. Same as &lsquo;<samp><span class="samp">-K</span></samp>&rsquo;,
see <a href="#Option-details">Option details</a>.
- <br><dt>&lsquo;<samp><span class="samp">m </span><var>num</var></samp>&rsquo;<dd><a name="index-m-_0040r_007bconfig-command-_0028available-memory_0029_007d-287"></a><a name="index-memory-available-288"></a><a name="index-printer-memory-289"></a>Declare <var>num</var> as the memory available for fonts and strings in the
+ <br><dt>&lsquo;<samp><span class="samp">m </span><var>num</var></samp>&rsquo;<dd><a name="index-m-_0040r_007bconfig-command-_0028available-memory_0029_007d-288"></a><a name="index-memory-available-289"></a><a name="index-printer-memory-290"></a>Declare <var>num</var> as the memory available for fonts and strings in the
printer. Default is 180000. This value must be accurate if memory
conservation and document splitting is to work correctly. To determine
this value, send the following file to the printer:
@@ -1405,13 +1413,13 @@ memory available to a PostScript interpreter, in which case this file
might return a ridiculously low number; for example, the NeXT computer
and Ghostscript. In these cases, a value of one million works fine.
- <br><dt>&lsquo;<samp><span class="samp">M </span><var>mode</var></samp>&rsquo;<dd><a name="index-M-_0040r_007bconfig-command-_0028mf-mode_0029_007d-290"></a>Metafont mode. Same as &lsquo;<samp><span class="samp">-mode</span></samp>&rsquo;, see <a href="#Option-details">Option details</a>.
+ <br><dt>&lsquo;<samp><span class="samp">M </span><var>mode</var></samp>&rsquo;<dd><a name="index-M-_0040r_007bconfig-command-_0028mf-mode_0029_007d-291"></a>Metafont mode. Same as &lsquo;<samp><span class="samp">-mode</span></samp>&rsquo;, see <a href="#Option-details">Option details</a>.
- <br><dt>&lsquo;<samp><span class="samp">N*</span></samp>&rsquo;<dd><a name="index-N-_0040r_007bEPS_002ddisabling-config-command_007d-291"></a>Disable structured comments. Beware: This also turns off displaying
+ <br><dt>&lsquo;<samp><span class="samp">N*</span></samp>&rsquo;<dd><a name="index-N-_0040r_007bEPS_002ddisabling-config-command_007d-292"></a>Disable structured comments. Beware: This also turns off displaying
page numbers or changing to specific pagenumbers in PostScript viewers.
Same as &lsquo;<samp><span class="samp">-N</span></samp>&rsquo;, see <a href="#Option-details">Option details</a>.
- <br><dt>&lsquo;<samp><span class="samp">o </span><var>name</var></samp>&rsquo;<dd><a name="index-o-_0040r_007bconfig-command-_0028output-file_0029_007d-292"></a><a name="index-output-file_002c-setting-293"></a>Send output to <var>name</var>. Same as &lsquo;<samp><span class="samp">-o</span></samp>&rsquo;, see <a href="#Option-details">Option details</a>.
+ <br><dt>&lsquo;<samp><span class="samp">o </span><var>name</var></samp>&rsquo;<dd><a name="index-o-_0040r_007bconfig-command-_0028output-file_0029_007d-293"></a><a name="index-output-file_002c-setting-294"></a>Send output to <var>name</var>. Same as &lsquo;<samp><span class="samp">-o</span></samp>&rsquo;, see <a href="#Option-details">Option details</a>.
In the file <samp><span class="file">config.foo</span></samp>, a setting like this is probably
appropriate:
<pre class="example"> o |lpr -Pfoo
@@ -1420,9 +1428,9 @@ appropriate:
the local printer device <samp><span class="file">PRN</span></samp> if it doesn't find an executable
program by that name in the current directory or along the <code>PATH</code>.
- <br><dt>&lsquo;<samp><span class="samp">O </span><var>xoff</var><span class="samp">,</span><var>yoff</var></samp>&rsquo;<dd><a name="index-O-_0040r_007bconfig-command-_0028offset_0029_007d-294"></a>Origin offset. Same as &lsquo;<samp><span class="samp">-O</span></samp>&rsquo;, see <a href="#Option-details">Option details</a>.
+ <br><dt>&lsquo;<samp><span class="samp">O </span><var>xoff</var><span class="samp">,</span><var>yoff</var></samp>&rsquo;<dd><a name="index-O-_0040r_007bconfig-command-_0028offset_0029_007d-295"></a>Origin offset. Same as &lsquo;<samp><span class="samp">-O</span></samp>&rsquo;, see <a href="#Option-details">Option details</a>.
- <br><dt>&lsquo;<samp><span class="samp">p [+]</span><var>name</var></samp>&rsquo;<dd><a name="index-p-_0040r_007bconfig-command-_0028font-aliases_0029_007d-295"></a><a name="index-PostScript-font-alias-file-296"></a><a name="index-resident-fonts_002c-different-in-different-printers-297"></a><a name="index-g_t_002b_0040var_007bpsmapfile_007d-298"></a>Examine <var>name</var> for PostScript font aliases. Default is
+ <br><dt>&lsquo;<samp><span class="samp">p [+]</span><var>name</var></samp>&rsquo;<dd><a name="index-p-_0040r_007bconfig-command-_0028font-aliases_0029_007d-296"></a><a name="index-PostScript-font-alias-file-297"></a><a name="index-resident-fonts_002c-different-in-different-printers-298"></a><a name="index-g_t_002b_0040var_007bpsmapfile_007d-299"></a>Examine <var>name</var> for PostScript font aliases. Default is
<samp><span class="file">psfonts.map</span></samp>. This option allows you to specify different resident
fonts that different printers may have. If <var>name</var> starts with a
&lsquo;<samp><span class="samp">+</span></samp>&rsquo; character, then the rest of the name (after any leading spaces)
@@ -1430,15 +1438,15 @@ is used as an additional map file; thus, it is possible to have local
map files pointed to by local configuration files that append to the
global map file. This can be used for font families.
- <br><dt>&lsquo;<samp><span class="samp">P </span><var>path</var></samp>&rsquo;<dd><a name="index-P-_0040r_007bconfig-command-_0028PK-path_0029_007d-299"></a><a name="index-PKFONTS_0040r_007b_002c-overrides_007d-P-300"></a><a name="index-TEXPKS_0040r_007b_002c-overrides_007d-P-301"></a><a name="index-GLYPHFONTS_0040r_007b_002c-overrides_007d-P-302"></a><a name="index-TEXFONTS_0040r_007b_002c-overrides_007d-P-303"></a>Use <var>path</var> to search for bitmap PK font files is <var>path</var>. The
+ <br><dt>&lsquo;<samp><span class="samp">P </span><var>path</var></samp>&rsquo;<dd><a name="index-P-_0040r_007bconfig-command-_0028PK-path_0029_007d-300"></a><a name="index-PKFONTS_0040r_007b_002c-overrides_007d-P-301"></a><a name="index-TEXPKS_0040r_007b_002c-overrides_007d-P-302"></a><a name="index-GLYPHFONTS_0040r_007b_002c-overrides_007d-P-303"></a><a name="index-TEXFONTS_0040r_007b_002c-overrides_007d-P-304"></a>Use <var>path</var> to search for bitmap PK font files is <var>path</var>. The
<code>PKFONTS</code>, <code>TEXPKS</code>, <code>GLYPHFONTS</code>, and <code>TEXFONTS</code>
environment variables override this. See <a href="kpathsea.html#Supported-file-formats">Supported file formats</a>.
- <br><dt>&lsquo;<samp><span class="samp">q*</span></samp>&rsquo;<dt>&lsquo;<samp><span class="samp">Q</span></samp>&rsquo;<dd><a name="index-q-_0040r_007bconfig-command-_0028quiet_0029_007d-304"></a><a name="index-Q-_0040r_007bconfig-command-_0028quiet_0029_007d-305"></a>Run quietly. Same as &lsquo;<samp><span class="samp">-q</span></samp>&rsquo;, see <a href="#Option-details">Option details</a>.
+ <br><dt>&lsquo;<samp><span class="samp">q*</span></samp>&rsquo;<dt>&lsquo;<samp><span class="samp">Q</span></samp>&rsquo;<dd><a name="index-q-_0040r_007bconfig-command-_0028quiet_0029_007d-305"></a><a name="index-Q-_0040r_007bconfig-command-_0028quiet_0029_007d-306"></a>Run quietly. Same as &lsquo;<samp><span class="samp">-q</span></samp>&rsquo;, see <a href="#Option-details">Option details</a>.
- <br><dt>&lsquo;<samp><span class="samp">r*</span></samp>&rsquo;<dd><a name="index-r-_0040r_007bconfig-command-_0028page-reversal_0029_007d-306"></a>Page reversal. Same as &lsquo;<samp><span class="samp">-r</span></samp>&rsquo;, see <a href="#Option-details">Option details</a>.
+ <br><dt>&lsquo;<samp><span class="samp">r*</span></samp>&rsquo;<dd><a name="index-r-_0040r_007bconfig-command-_0028page-reversal_0029_007d-307"></a>Page reversal. Same as &lsquo;<samp><span class="samp">-r</span></samp>&rsquo;, see <a href="#Option-details">Option details</a>.
- <br><dt>&lsquo;<samp><span class="samp">R </span><var>num1 num2 <small class="dots">...</small></var></samp>&rsquo;<dd><a name="index-R-_0040r_007bfallback-resolution-config-command_007d-307"></a><a name="index-fallback-resolutions-308"></a><a name="index-default-resolutions-309"></a><a name="index-last_002dresort-scaling_002c-with-_0040code_007bR_007d-310"></a>Define the list of default resolutions for PK fonts. If a font size
+ <br><dt>&lsquo;<samp><span class="samp">R </span><var>num1 num2 <small class="dots">...</small></var></samp>&rsquo;<dd><a name="index-R-_0040r_007bfallback-resolution-config-command_007d-308"></a><a name="index-fallback-resolutions-309"></a><a name="index-default-resolutions-310"></a><a name="index-last_002dresort-scaling_002c-with-_0040code_007bR_007d-311"></a>Define the list of default resolutions for PK fonts. If a font size
actually used in a document is not available and cannot be created,
Dvips will scale the font found at the closest of these resolutions to
the requested size, using PostScript scaling. The resulting output may
@@ -1450,51 +1458,51 @@ than the preceding one is ignored. This is because it is better to
scale a font up than down; scaling down can obliterate small features in
the character shape.
- <p><a name="index-DVIPSSIZES_0040r_007b_002c-overrides_007d-R-311"></a><a name="index-TEXSIZES_0040r_007b_002c-overrides_007d-R-312"></a>The environment and config file values &lsquo;<samp><span class="samp">DVIPSSIZES</span></samp>&rsquo; or
+ <p><a name="index-DVIPSSIZES_0040r_007b_002c-overrides_007d-R-312"></a><a name="index-TEXSIZES_0040r_007b_002c-overrides_007d-R-313"></a>The environment and config file values &lsquo;<samp><span class="samp">DVIPSSIZES</span></samp>&rsquo; or
&lsquo;<samp><span class="samp">TEXSIZES</span></samp>&rsquo; override this configuration file setting.
- <p><a name="index-default_005ftexsizes-_0040r_007bMake-variable_007d-313"></a>If no &lsquo;<samp><span class="samp">R</span></samp>&rsquo; settings or environment variables are specified, a list
+ <p><a name="index-default_005ftexsizes-_0040r_007bMake-variable_007d-314"></a>If no &lsquo;<samp><span class="samp">R</span></samp>&rsquo; settings or environment variables are specified, a list
compiled in during installation is used. This default list is defined by
the Makefile variable &lsquo;<samp><span class="samp">default_texsizes</span></samp>&rsquo;, defined in the file
<samp><span class="file">make/paths.make</span></samp>.
- <br><dt>&lsquo;<samp><span class="samp">s*</span></samp>&rsquo;<dd><a name="index-s-_0040r_007bconfig-command-_0028save_002frestore_0029_007d-314"></a>Output global save/restore. Same as &lsquo;<samp><span class="samp">-s</span></samp>&rsquo;, see <a href="#Option-details">Option details</a>.
+ <br><dt>&lsquo;<samp><span class="samp">s*</span></samp>&rsquo;<dd><a name="index-s-_0040r_007bconfig-command-_0028save_002frestore_0029_007d-315"></a>Output global save/restore. Same as &lsquo;<samp><span class="samp">-s</span></samp>&rsquo;, see <a href="#Option-details">Option details</a>.
- <br><dt>&lsquo;<samp><span class="samp">S </span><var>path</var></samp>&rsquo;<dd><a name="index-S-_0040r_007bconfig-command-_0028pict-path_0029_007d-315"></a><a name="index-TEXPICTS_0040r_007b_002c-overrides_007d-S-316"></a><a name="index-TEXINPUTS_0040r_007b_002c-overrides_007d-S-317"></a>Use <var>path</var> to search for special illustrations (Encapsulated
+ <br><dt>&lsquo;<samp><span class="samp">S </span><var>path</var></samp>&rsquo;<dd><a name="index-S-_0040r_007bconfig-command-_0028pict-path_0029_007d-316"></a><a name="index-TEXPICTS_0040r_007b_002c-overrides_007d-S-317"></a><a name="index-TEXINPUTS_0040r_007b_002c-overrides_007d-S-318"></a>Use <var>path</var> to search for special illustrations (Encapsulated
PostScript files or psfiles). The <code>TEXPICTS</code> and then
<code>TEXINPUTS</code> environment variables override this.
- <br><dt>&lsquo;<samp><span class="samp">T </span><var>path</var></samp>&rsquo;<dd><a name="index-T-_0040r_007bconfig-command-_0028TFM-path_0029_007d-318"></a><a name="index-TFMFONTS_0040r_007b_002c-overrides_007d-T-319"></a><a name="index-TEXFONTS_0040r_007b_002c-overrides_007d-T-320"></a>Use <var>path</var> to search for TFM files. The <code>TFMFONTS</code> and then
+ <br><dt>&lsquo;<samp><span class="samp">T </span><var>path</var></samp>&rsquo;<dd><a name="index-T-_0040r_007bconfig-command-_0028TFM-path_0029_007d-319"></a><a name="index-TFMFONTS_0040r_007b_002c-overrides_007d-T-320"></a><a name="index-TEXFONTS_0040r_007b_002c-overrides_007d-T-321"></a>Use <var>path</var> to search for TFM files. The <code>TFMFONTS</code> and then
<code>TEXFONTS</code> environment variables overrides this. This path is used
for resident fonts and fonts that can't otherwise be found.
- <br><dt>&lsquo;<samp><span class="samp">U*</span></samp>&rsquo;<dd><a name="index-U-_0040r_007bconfig-command-_0028Xerox-4045_0029_007d-321"></a>Work around bug in Xerox 4045 printer. Same as &lsquo;<samp><span class="samp">-U</span></samp>&rsquo;, see <a href="#Option-details">Option details</a>.
+ <br><dt>&lsquo;<samp><span class="samp">U*</span></samp>&rsquo;<dd><a name="index-U-_0040r_007bconfig-command-_0028Xerox-4045_0029_007d-322"></a>Work around bug in Xerox 4045 printer. Same as &lsquo;<samp><span class="samp">-U</span></samp>&rsquo;, see <a href="#Option-details">Option details</a>.
- <br><dt>&lsquo;<samp><span class="samp">V </span><var>path</var></samp>&rsquo;<dd><a name="index-V-_0040r_007bconfig-command-_0028vf-path_0029_007d-322"></a><a name="index-virtual-font-path-323"></a><a name="index-device-dependency_002c-and-virtual-fonts-324"></a>Use <var>path</var> to search for virtual font files. This may be
+ <br><dt>&lsquo;<samp><span class="samp">V </span><var>path</var></samp>&rsquo;<dd><a name="index-V-_0040r_007bconfig-command-_0028vf-path_0029_007d-323"></a><a name="index-virtual-font-path-324"></a><a name="index-device-dependency_002c-and-virtual-fonts-325"></a>Use <var>path</var> to search for virtual font files. This may be
device-dependent if you use virtual fonts to simulate actual fonts on
different devices.
- <br><dt>&lsquo;<samp><span class="samp">W [</span><var>string</var><span class="roman">]</span></samp>&rsquo;<dd><a name="index-W-_0040r_007bconfig-command-_0028warning_0029_007d-325"></a><a name="index-warning-messages_002c-defining-326"></a>If <var>string</var> is supplied, write it to standard error after reading
+ <br><dt>&lsquo;<samp><span class="samp">W [</span><var>string</var><span class="roman">]</span></samp>&rsquo;<dd><a name="index-W-_0040r_007bconfig-command-_0028warning_0029_007d-326"></a><a name="index-warning-messages_002c-defining-327"></a>If <var>string</var> is supplied, write it to standard error after reading
all the configuration files; with no <var>string</var>, cancel any previous
&lsquo;<samp><span class="samp">W</span></samp>&rsquo; message. This is useful in the default configuration file to
remind users to specify a printer, for instance, or to notify users
about special characteristics of a particular printer.
- <br><dt>&lsquo;<samp><span class="samp">X </span><var>num</var></samp>&rsquo;<dd><a name="index-X-_0040r_007bconfig-command-_0028horizontal-resolution_0029_007d-327"></a>Horizontal resolution. Same as &lsquo;<samp><span class="samp">-X</span></samp>&rsquo; (see <a href="#Option-details">Option details</a>).
+ <br><dt>&lsquo;<samp><span class="samp">X </span><var>num</var></samp>&rsquo;<dd><a name="index-X-_0040r_007bconfig-command-_0028horizontal-resolution_0029_007d-328"></a>Horizontal resolution. Same as &lsquo;<samp><span class="samp">-X</span></samp>&rsquo; (see <a href="#Option-details">Option details</a>).
- <br><dt>&lsquo;<samp><span class="samp">Y </span><var>num</var></samp>&rsquo;<dd><a name="index-Y-_0040r_007bconfig-command-_0028vertical-resolution_0029_007d-328"></a>Vertical resolution. Same as &lsquo;<samp><span class="samp">-Y</span></samp>&rsquo; (see <a href="#Option-details">Option details</a>).
+ <br><dt>&lsquo;<samp><span class="samp">Y </span><var>num</var></samp>&rsquo;<dd><a name="index-Y-_0040r_007bconfig-command-_0028vertical-resolution_0029_007d-329"></a>Vertical resolution. Same as &lsquo;<samp><span class="samp">-Y</span></samp>&rsquo; (see <a href="#Option-details">Option details</a>).
- <br><dt>&lsquo;<samp><span class="samp">Z*</span></samp>&rsquo;<dd><a name="index-Z-_0040r_007bconfig-command-_0028compression_0029_007d-329"></a>Compress bitmap fonts. Same as &lsquo;<samp><span class="samp">-Z</span></samp>&rsquo; (see <a href="#Option-details">Option details</a>).
+ <br><dt>&lsquo;<samp><span class="samp">Z*</span></samp>&rsquo;<dd><a name="index-Z-_0040r_007bconfig-command-_0028compression_0029_007d-330"></a>Compress bitmap fonts. Same as &lsquo;<samp><span class="samp">-Z</span></samp>&rsquo; (see <a href="#Option-details">Option details</a>).
- <br><dt>&lsquo;<samp><span class="samp">z*</span></samp>&rsquo;<dd><a name="index-z-_0040r_007bconfig-command-_0028secure-mode_0029_007d-330"></a>Disables execution of system commands, like &lsquo;<samp><span class="samp">-R</span></samp>&rsquo;
+ <br><dt>&lsquo;<samp><span class="samp">z*</span></samp>&rsquo;<dd><a name="index-z-_0040r_007bconfig-command-_0028secure-mode_0029_007d-331"></a>Disables execution of system commands, like &lsquo;<samp><span class="samp">-R</span></samp>&rsquo;
(see <a href="#Option-details">Option details</a>). If &lsquo;<samp><span class="samp">-R</span></samp>&rsquo; is specified
on the command line, that takes precedence.
</dl>
<div class="node">
-<p><hr>
<a name="Paper-size-and-landscape"></a>
+<p><hr>
Next:&nbsp;<a rel="next" accesskey="n" href="#Interaction-with-PostScript">Interaction with PostScript</a>,
Previous:&nbsp;<a rel="previous" accesskey="p" href="#Invoking-Dvips">Invoking Dvips</a>,
Up:&nbsp;<a rel="up" accesskey="u" href="#Top">Top</a>
@@ -1503,13 +1511,13 @@ Up:&nbsp;<a rel="up" accesskey="u" href="#Top">Top</a>
<h2 class="chapter">4 Paper size and landscape orientation</h2>
-<p><a name="index-paper-size_002c-general-331"></a>
+<p><a name="index-paper-size_002c-general-332"></a>
Most TeX documents at a particular site are designed to use the
local standard paper size (letter size in the United States, A4 in
Europe). The Dvips program can be customized either sitewide or for a
particular printer.
- <p><a name="index-landscape-orientation_002c-defined-332"></a><a name="index-portrait-orientation_002c-defined-333"></a>But many documents are designed for other paper sizes. For instance,
+ <p><a name="index-landscape-orientation_002c-defined-333"></a><a name="index-portrait-orientation_002c-defined-334"></a>But many documents are designed for other paper sizes. For instance,
you may want to design a document that has the long edge of the paper
horizontal. This can be useful when typesetting booklets, brochures,
complex tables, or many other documents. This type of paper orientation
@@ -1535,8 +1543,8 @@ not and should not attempt to override it manually.
</ul>
<div class="node">
-<p><hr>
<a name="papersize-special"></a>
+<p><hr>
Next:&nbsp;<a rel="next" accesskey="n" href="#Config-file-paper-sizes">Config file paper sizes</a>,
Up:&nbsp;<a rel="up" accesskey="u" href="#Paper-size-and-landscape">Paper size and landscape</a>
@@ -1544,7 +1552,7 @@ Up:&nbsp;<a rel="up" accesskey="u" href="#Paper-size-and-landscape">Paper size a
<h3 class="section">4.1 &lsquo;<samp><span class="samp">papersize</span></samp>&rsquo; special</h3>
-<p><a name="index-papersize-_0040r_007bspecial_007d-334"></a>
+<p><a name="index-papersize-_0040r_007bspecial_007d-335"></a>
The format of the &lsquo;<samp><span class="samp">papersize</span></samp>&rsquo; special is
<pre class="example"> \special{papersize=<var>width</var>,<var>height</var>}
@@ -1555,7 +1563,7 @@ namely, in (inches), cm (centimeters), mm (millimeters), pt (points), sp
(scaled points), bp (big points, the same as the default PostScript
unit), pc (picas), dd (didot points), and cc (ciceros).
- <p><a name="index-landscape_0040r_007b_002c-as-_0040code_007b_005cspecial_007d_007d-335"></a>For a US letter size landscape document, the <code>papersize</code> would be:
+ <p><a name="index-landscape_0040r_007b_002c-as-_0040code_007b_005cspecial_007d_007d-336"></a>For a US letter size landscape document, the <code>papersize</code> would be:
<pre class="example"> \special{papersize=11in,8.5in}
</pre>
<p class="noindent">An alternate specification of <code>landscape</code>:
@@ -1568,7 +1576,7 @@ reventually the <code>papersize</code> comment will dominate.
paper size; you must also adjust <code>\hsize</code> and <code>\vsize</code> in your
TeX document typeset to those dimensions.
- <p><a name="index-unknown_0040r_007b_002c-paper-format-for-_0040samp_007b_002dt_007d_007d-336"></a>When using the <code>papersize</code> special, you generally should not also
+ <p><a name="index-unknown_0040r_007b_002c-paper-format-for-_0040samp_007b_002dt_007d_007d-337"></a>When using the <code>papersize</code> special, you generally should not also
specify <code>-t</code> on the command line (see <a href="#Option-details">Option details</a>). The
exception is when using a nonstandard paper size that isn't
predefined; in this case, use <code>-t&nbsp;unknown</code>.
@@ -1577,8 +1585,8 @@ predefined; in this case, use <code>-t&nbsp;unknown</code>.
the document. Some packages, notably &lsquo;<samp><span class="samp">hyperref</span></samp>&rsquo;, insert this special.
<div class="node">
-<p><hr>
<a name="Config-file-paper-sizes"></a>
+<p><hr>
Next:&nbsp;<a rel="next" accesskey="n" href="#Paper-trays">Paper trays</a>,
Previous:&nbsp;<a rel="previous" accesskey="p" href="#papersize-special">papersize special</a>,
Up:&nbsp;<a rel="up" accesskey="u" href="#Paper-size-and-landscape">Paper size and landscape</a>
@@ -1587,7 +1595,7 @@ Up:&nbsp;<a rel="up" accesskey="u" href="#Paper-size-and-landscape">Paper size a
<h3 class="section">4.2 Configuration file paper size command</h3>
-<p><a name="index-paper-size-configuration-file-command-337"></a><a name="index-configuration-file-paper-size-command-338"></a>
+<p><a name="index-paper-size-configuration-file-command-338"></a><a name="index-configuration-file-paper-size-command-339"></a>
The &lsquo;<samp><span class="samp">@</span></samp>&rsquo; command in a configuration file sets the paper size
defaults and options. The first &lsquo;<samp><span class="samp">@</span></samp>&rsquo; command defines the default
paper size. It has three possible parameters:
@@ -1633,50 +1641,56 @@ For example:
<p>When Dvips has a paper format name given on the command line, it looks
for a match by the <var>name</var>; when it has a &lsquo;<samp><span class="samp">papersize</span></samp>&rsquo; special,
it looks for a match by dimensions. The best match found (from the
-paper size information in the configuration file) is used. If nothing
-matches, a warning is printed and the first paper size is used. The
-dimensions must match within 5bp. Landscape mode for all paper sizes
-is automatically supported.
+paper size information in the configuration file) is used. The
+dimensions must match within 5bp.
+
+ <p>If nothing matches, a warning is printed and the first paper size with
+zero dimensions is used; this should be the <code>unknown</code> paper size
+definition mentioned below, resulting in the actual dimensions being
+used.
+
+ <p>Landscape mode for all paper sizes is automatically supported.
<p>If your printer has a command to set a special paper size, then give
dimensions of &lsquo;<samp><span class="samp">0in 0in</span></samp>&rsquo;; the PostScript code that sets the paper
-size can refer to the dimensions the user requested as &lsquo;<samp><span class="samp">hsize</span></samp>&rsquo; and
-&lsquo;<samp><span class="samp">vsize</span></samp>&rsquo;; these will be macros defined in the PostScript that return
-the requested size in default PostScript units. Virtually all of the
-PostScript commands you use here are device-dependent and degrade the
-portability of the file; that is why the default first paper size entry
-should not send any PostScript commands down (although a structured
-comment or two would be okay). Also, some printers want
-&lsquo;<samp><span class="samp">BeginPaperSize</span></samp>&rsquo; comments and paper size setting commands; others
-(such as the NeXT) want &lsquo;<samp><span class="samp">PaperSize</span></samp>&rsquo; comments and they will handle
-setting the paper size. There is no solution I could find that works
-for both (except maybe specifying both).
-
- <p>When using a paper size that is not already defined in
+size can refer to the dimensions the user requested as &lsquo;<samp><span class="samp">hsize</span></samp>&rsquo;
+and &lsquo;<samp><span class="samp">vsize</span></samp>&rsquo;; these will be macros defined in the PostScript that
+return the requested size in default PostScript units. Also, some
+printers want &lsquo;<samp><span class="samp">BeginPaperSize</span></samp>&rsquo; comments and paper size setting
+commands; others (such as the NeXT) want &lsquo;<samp><span class="samp">PaperSize</span></samp>&rsquo; comments and
+they will handle setting the paper size. So paper size entries should
+typically specify both.
+
+ <p><a name="index-unknown_0040r_007b_002c-paper-format-for-_0040samp_007b_002dt_007d_007d-340"></a>When using a paper size that is not already defined in
<samp><span class="file">config.ps</span></samp>, you probably want to say &lsquo;<samp><span class="samp">-t&nbsp;unknown</span></samp>&rsquo; on
the command line; the <code>unknown</code> paper size definition in
<samp><span class="file">config.ps</span></samp> has the requisite PostScript incantation to set the
PostScript page size, as just described.
- <p><a name="index-mkdvipspapers-339"></a>The Perl 5 script <samp><span class="file">contrib/configs/mkdvipspapers</span></samp> in the
+ <p><a name="index-nopaper_0040r_007b_002c-paper-format-for-_0040samp_007b_002dt_007d_007d-341"></a>If you want no paper size information in the output at all, use
+&lsquo;<samp><span class="samp">-t&nbsp;nopaper</span></samp>&rsquo;. This is useful with multi-page output that
+will be processed further. If you just have a single page document,
+you can use &lsquo;<samp><span class="samp">-E</span></samp>&rsquo; to get pure EPSF output.
+
+ <p><a name="index-mkdvipspapers-342"></a>The Perl 5 script <samp><span class="file">contrib/configs/mkdvipspapers</span></samp> in the
distribution directory may help in determining appropriate paper size
definitions.
- <p><a name="index-config_002eps-_0040r_007bpaper-sizes_007d-340"></a><a name="index-letter-_0040r_007bpaper-size_007d-341"></a><a name="index-a4-_0040r_007bpaper-size_007d-342"></a>Notwithstanding the above, the default <code>letter</code> and <code>a4</code>
+ <p><a name="index-config_002eps-_0040r_007bpaper-sizes_007d-343"></a><a name="index-letter-_0040r_007bpaper-size_007d-344"></a><a name="index-a4-_0040r_007bpaper-size_007d-345"></a>Notwithstanding the above, the default <code>letter</code> and <code>a4</code>
paper size definitions in <samp><span class="file">config.ps</span></samp> execute the
<code>setpagedevice</code> operator if it exists (it was defined in
-PostScript Level 2), or the &lsquo;<samp><span class="samp">letter</span></samp>&rsquo; or &lsquo;<samp><span class="samp">a4</span></samp>&rsquo; operator if
-they exist (they are nonstandard and thus perhaps cause failures on
+PostScript Level&nbsp;2), or the &lsquo;<samp><span class="samp">letter</span></samp>&rsquo; or &lsquo;<samp><span class="samp">a4</span></samp>&rsquo; operator
+if they exist (they are nonstandard and thus perhaps cause failures on
certain (unknown) printers). Not executing any page size definition
at all confuses PostScript conversion programs such as
<samp><span class="command">ps2pdf</span></samp>, so we want to execute one if we can.
- <p><a name="index-letterSize-_0040r_007bpaper-size_007d-343"></a><a name="index-A4size-_0040r_007bpaper-size_007d-344"></a>The <code>letterSize</code> and <code>A4Size</code> paper size definitions are now
+ <p><a name="index-letterSize-_0040r_007bpaper-size_007d-346"></a><a name="index-A4size-_0040r_007bpaper-size_007d-347"></a>The <code>letterSize</code> and <code>A4Size</code> paper size definitions are now
synonyms for <code>letter</code> and <code>a4</code>.
<div class="node">
-<p><hr>
<a name="Paper-trays"></a>
+<p><hr>
Previous:&nbsp;<a rel="previous" accesskey="p" href="#Config-file-paper-sizes">Config file paper sizes</a>,
Up:&nbsp;<a rel="up" accesskey="u" href="#Paper-size-and-landscape">Paper size and landscape</a>
@@ -1684,12 +1698,12 @@ Up:&nbsp;<a rel="up" accesskey="u" href="#Paper-size-and-landscape">Paper size a
<h3 class="section">4.3 Paper trays</h3>
-<p><a name="index-paper-trays-345"></a><a name="index-dual-paper-trays-346"></a><a name="index-multiple-paper-trays-347"></a><a name="index-HP4Si-printer-and-paper-trays-348"></a>
-<a name="index-bop_002dhook-349"></a>Some printers, such as the Hewlett-Packard HP4si, have multiple paper
+<p><a name="index-paper-trays-348"></a><a name="index-dual-paper-trays-349"></a><a name="index-multiple-paper-trays-350"></a><a name="index-HP4Si-printer-and-paper-trays-351"></a>
+<a name="index-bop_002dhook-352"></a>Some printers, such as the Hewlett-Packard HP4si, have multiple paper
trays. You can set up Dvips to take advantage of this using the
<code>bop-hook</code> PostScript variable (see <a href="#PostScript-hooks">PostScript hooks</a>).
- <p><a name="index-letterhead-tray-350"></a>For example, suppose you have an alternate tray stocked with letterhead
+ <p><a name="index-letterhead-tray-353"></a>For example, suppose you have an alternate tray stocked with letterhead
paper; the usual tray has the usual paper. You have a document where
you want the first page printed on letterhead, and the remaining pages
on the usual paper. You can create a header file, say
@@ -1716,8 +1730,8 @@ commands to select the paper trays. On the 4SI, <var>alternatetray</var> is
</ul>
<div class="node">
-<p><hr>
<a name="Interaction-with-PostScript"></a>
+<p><hr>
Next:&nbsp;<a rel="next" accesskey="n" href="#PostScript-fonts">PostScript fonts</a>,
Previous:&nbsp;<a rel="previous" accesskey="p" href="#Paper-size-and-landscape">Paper size and landscape</a>,
Up:&nbsp;<a rel="up" accesskey="u" href="#Top">Top</a>
@@ -1726,7 +1740,7 @@ Up:&nbsp;<a rel="up" accesskey="u" href="#Top">Top</a>
<h2 class="chapter">5 Interaction with PostScript</h2>
-<p><a name="index-interaction-with-PostScript-351"></a><a name="index-PostScript-interaction-352"></a>
+<p><a name="index-interaction-with-PostScript-354"></a><a name="index-PostScript-interaction-355"></a>
Dvips supports inclusion of PostScript figure files (e.g., Encapsulated
PostScript), downloading other header files (e.g., fonts), including
literal PostScript code, and hypertext.
@@ -1739,8 +1753,8 @@ literal PostScript code, and hypertext.
</ul>
<div class="node">
-<p><hr>
<a name="PostScript-figures"></a>
+<p><hr>
Next:&nbsp;<a rel="next" accesskey="n" href="#Header-files">Header files</a>,
Up:&nbsp;<a rel="up" accesskey="u" href="#Interaction-with-PostScript">Interaction with PostScript</a>
@@ -1762,8 +1776,8 @@ be accommodated with just a little more work.
</ul>
<div class="node">
-<p><hr>
<a name="Bounding-box"></a>
+<p><hr>
Next:&nbsp;<a rel="next" accesskey="n" href="#g_t_005cincludegraphics">\includegraphics</a>,
Up:&nbsp;<a rel="up" accesskey="u" href="#PostScript-figures">PostScript figures</a>
@@ -1771,20 +1785,20 @@ Up:&nbsp;<a rel="up" accesskey="u" href="#PostScript-figures">PostScript figures
<h4 class="subsection">5.1.1 The bounding box comment</h4>
-<p><a name="index-bounding-box_002c-comment-for-353"></a>
+<p><a name="index-bounding-box_002c-comment-for-356"></a>
The most important feature of a good PostScript file from the standpoint
of including it in another document is an accurate bounding box comment.
Every well-formed PostScript file has a comment describing where on the
page the graphic is located, and how big that graphic is.
- <p><a name="index-big-points-354"></a><a name="index-PostScript-units-355"></a><a name="index-bounding-box_002c-defined-356"></a>This information is given as the lower left and upper right corners of
+ <p><a name="index-big-points-357"></a><a name="index-PostScript-units-358"></a><a name="index-bounding-box_002c-defined-359"></a>This information is given as the lower left and upper right corners of
the box just enclosing the graphic, and is thus referred to as the
<dfn>bounding box</dfn>. These coordinates are given in the default
PostScript units (there are precisely 72 PostScript units to the inch,
like TeX big points) with respect to the lower left corner of the
sheet of paper.
- <p><a name="index-g_t_0025_0025BoundingBox-357"></a>To see if a PostScript file has a bounding box comment, just look at the
+ <p><a name="index-g_t_0025_0025BoundingBox-360"></a>To see if a PostScript file has a bounding box comment, just look at the
first few lines of the file. PostScript files are standard ASCII, so
you can use any text editor to do this. If within the first few dozen
lines there is a line like
@@ -1795,7 +1809,7 @@ lines there is a line like
Encapsulated PostScript and will work easily with Dvips. If the file
contains instead a line like
- <p><a name="index-atend_0040r_007b_002c-bounding-box-specification_007d-358"></a><a name="index-g_t_0028atend_0029_0040r_007b_002c-bounding-box-specification_007d-359"></a>
+ <p><a name="index-atend_0040r_007b_002c-bounding-box-specification_007d-361"></a><a name="index-g_t_0028atend_0029_0040r_007b_002c-bounding-box-specification_007d-362"></a>
<pre class="example"> %%BoundingBox: (atend)
</pre>
<p class="noindent">the file is still probably Encapsulated PostScript, but the bounding box
@@ -1805,13 +1819,13 @@ bounding box is given in this way when the program that generated the
PostScript couldn't know the size in advance, or was too lazy to compute
it.)
- <p><a name="index-bbfig-360"></a><a name="index-bounding-box_002c-determining-361"></a>If the document lacks a &lsquo;<samp><span class="samp">%%BoundingBox:</span></samp>&rsquo; altogether, you can
+ <p><a name="index-bbfig-363"></a><a name="index-bounding-box_002c-determining-364"></a>If the document lacks a &lsquo;<samp><span class="samp">%%BoundingBox:</span></samp>&rsquo; altogether, you can
determine one in a couple of ways. One is to use the &lsquo;<samp><span class="samp">bbfig</span></samp>&rsquo;
program distributed with Dvips in the <samp><span class="file">contrib</span></samp> directory. This can
usually find the correct bounding box automatically; it works best with
Ghostscript.
- <p><a name="index-g_t612-792-_0040r_007bbounding-box-size_007d-362"></a>If the comment looks like this:
+ <p><a name="index-g_t612-792-_0040r_007bbounding-box-size_007d-365"></a>If the comment looks like this:
<pre class="example"> %%BoundingBox: 0 0 612 792
</pre>
<p class="noindent">the graphic claims to take up an entire sheet of paper. This is
@@ -1844,9 +1858,9 @@ please complain to the authors of the software package that generated
the file.
<div class="node">
-<p><hr>
<a name="%5cincludegraphics"></a>
<a name="g_t_005cincludegraphics"></a>
+<p><hr>
Next:&nbsp;<a rel="next" accesskey="n" href="#EPSF-macros">EPSF macros</a>,
Previous:&nbsp;<a rel="previous" accesskey="p" href="#Bounding-box">Bounding box</a>,
Up:&nbsp;<a rel="up" accesskey="u" href="#PostScript-figures">PostScript figures</a>
@@ -1855,7 +1869,7 @@ Up:&nbsp;<a rel="up" accesskey="u" href="#PostScript-figures">PostScript figures
<h4 class="subsection">5.1.2 The \includegraphics macro for LaTeX</h4>
-<p><a name="index-g_t_005cincludegraphics-_0040LaTeX_007b_007d-macro-363"></a><a name="index-macros-for-epsf-inclusion-364"></a>
+<p><a name="index-g_t_005cincludegraphics-_0040LaTeX_007b_007d-macro-366"></a><a name="index-macros-for-epsf-inclusion-367"></a>
Once the figure file has a bounding box comment (see the previous
section) you are ready to import the graphic into a LaTeX
document. For LaTeX 2e, you can use the epsf, graphics or graphicx
@@ -1887,7 +1901,7 @@ different TeX engines or DVI converters if you also provide
suitable graphics files for them, e.g., <samp><span class="file">foo.pdf</span></samp> or
<samp><span class="file">foo.png</span></samp>.
- <p><a name="index-bounding-box_002c-supplying-to-_0040TeX_007b_007d-365"></a>The \includegraphics command has many options, specified in
+ <p><a name="index-bounding-box_002c-supplying-to-_0040TeX_007b_007d-368"></a>The \includegraphics command has many options, specified in
&lsquo;<samp><span class="samp">key=value</span></samp>&rsquo; syntax, to allow you to resize, rotate or trim the
included graphic&mdash;see <samp><span class="file">grfguide</span></samp> or <samp><span class="file">epslatex</span></samp>. If your
file does not have a bounding box comment, you can supply the numbers
@@ -1908,8 +1922,8 @@ minipages can sometimes be confusing when this is not taken into
account.
<div class="node">
-<p><hr>
<a name="EPSF-macros"></a>
+<p><hr>
Next:&nbsp;<a rel="next" accesskey="n" href="#psfile-special">psfile special</a>,
Previous:&nbsp;<a rel="previous" accesskey="p" href="#g_t_005cincludegraphics">\includegraphics</a>,
Up:&nbsp;<a rel="up" accesskey="u" href="#PostScript-figures">PostScript figures</a>
@@ -1918,7 +1932,7 @@ Up:&nbsp;<a rel="up" accesskey="u" href="#PostScript-figures">PostScript figures
<h4 class="subsection">5.1.3 Using the EPSF macros</h4>
-<p><a name="index-EPSF-macros-366"></a><a name="index-macros-for-epsf-inclusion-367"></a>
+<p><a name="index-EPSF-macros-369"></a><a name="index-macros-for-epsf-inclusion-370"></a>
If you are using LaTeX 2e, use the &lsquo;<samp><span class="samp">graphics</span></samp>&rsquo; or &lsquo;<samp><span class="samp">graphicx</span></samp>&rsquo;
package. See <a href="#g_t_005cincludegraphics">\includegraphics</a>.
@@ -1926,10 +1940,10 @@ package. See <a href="#g_t_005cincludegraphics">\includegraphics</a>.
(for plain TeX) and <samp><span class="file">epsf.sty</span></samp> (for LaTeX). For plain
TeX, add a line like this near the top of your input file:
- <p><a name="index-epsf_002etex-368"></a>
+ <p><a name="index-epsf_002etex-371"></a>
<pre class="example"> \input epsf
</pre>
- <p class="noindent"><a name="index-epsf_002esty-369"></a>If you are using LaTeX 2.09, add the &lsquo;<samp><span class="samp">epsf</span></samp>&rsquo; style option, as in:
+ <p class="noindent"><a name="index-epsf_002esty-372"></a>If you are using LaTeX 2.09, add the &lsquo;<samp><span class="samp">epsf</span></samp>&rsquo; style option, as in:
<pre class="example"> \documentstyle[12pt,epsf]{article}
</pre>
@@ -1940,7 +1954,7 @@ figures you plan to include.
<pre class="example"> \epsffile{foo.eps}
</pre>
- <p><a name="index-g_t_005cleavevmode-370"></a><a name="index-bounding-box_002c-supplying-to-_0040TeX_007b_007d-371"></a>If you are using LaTeX, you may need to add <code>\leavevmode</code>
+ <p><a name="index-g_t_005cleavevmode-373"></a><a name="index-bounding-box_002c-supplying-to-_0040TeX_007b_007d-374"></a>If you are using LaTeX, you may need to add <code>\leavevmode</code>
immediately before the <code>\epsffile</code> command to get certain
environments to work correctly. If your file does not have a bounding
box comment, you can supply the numbers as determined in the previous
@@ -1953,7 +1967,7 @@ comment:
your graphic positioned at precisely the point you indicated, occupying
the proper amount of space.
- <p><a name="index-g_t_005cepsffile-_0040r_007bmacro_007d-372"></a><a name="index-figures_002c-natural-size-373"></a>The <code>\epsffile</code> macro typesets the figure as a TeX <code>\vbox</code>
+ <p><a name="index-g_t_005cepsffile-_0040r_007bmacro_007d-375"></a><a name="index-figures_002c-natural-size-376"></a>The <code>\epsffile</code> macro typesets the figure as a TeX <code>\vbox</code>
at the point of the page that the command is executed. By default, the
graphic will have its `natural' width (namely, the width of its bounding
box). The TeX box will have depth zero and its natural height. By
@@ -1961,7 +1975,7 @@ default, the graphic will be scaled by any DVI magnification in effect,
just as is everything else in your document. See the next section for
more information on scaling.
- <p><a name="index-g_t_005cepsfverbosetrue-374"></a><a name="index-verbose-EPSF-processing-375"></a>If you want TeX to report the size of the figure as a message on your
+ <p><a name="index-g_t_005cepsfverbosetrue-377"></a><a name="index-verbose-EPSF-processing-378"></a>If you want TeX to report the size of the figure as a message on your
terminal when it processes each figure, give the command:
<pre class="example"> \epsfverbosetrue
@@ -1972,8 +1986,8 @@ terminal when it processes each figure, give the command:
</ul>
<div class="node">
-<p><hr>
<a name="EPSF-scaling"></a>
+<p><hr>
Next:&nbsp;<a rel="next" accesskey="n" href="#EPSF-clipping">EPSF clipping</a>,
Up:&nbsp;<a rel="up" accesskey="u" href="#EPSF-macros">EPSF macros</a>
@@ -1981,7 +1995,7 @@ Up:&nbsp;<a rel="up" accesskey="u" href="#EPSF-macros">EPSF macros</a>
<h5 class="subsubsection">5.1.3.1 EPSF scaling</h5>
-<p><a name="index-scaling-of-figures-376"></a><a name="index-figures_002c-scaling-377"></a>
+<p><a name="index-scaling-of-figures-379"></a><a name="index-figures_002c-scaling-380"></a>
Usually, you will want to scale an EPSF figure to some size appropriate
for your document, since its natural size is determined by the creator
of the EPS file.
@@ -1990,14 +2004,14 @@ of the EPS file.
<code>\epsfxsize</code> or <code>\epsfysize</code> variables, whichever is more
convenient for you. That is, put
- <p><a name="index-g_t_005cepsfxsize-378"></a>
+ <p><a name="index-g_t_005cepsfxsize-381"></a>
<pre class="example"> \epsfxsize=<var>dimen</var>
</pre>
<p class="noindent">right before the call to <code>\epsffile</code>. Then the width of the TeX
box will be <var>dimen</var> and its height will be scaled proportionately.
Similarly, you can set the vertical size with
- <p><a name="index-g_t_005cepsfysize-379"></a>
+ <p><a name="index-g_t_005cepsfysize-382"></a>
<pre class="example"> \epsfysize=<var>dimen</var>
</pre>
<p class="noindent">in which case the height will be set and the width scaled
@@ -2007,7 +2021,7 @@ proportionally.
included graphic may necessarily be distorted, i.e., its contents
stretched in one direction or the other.
- <p><a name="index-g_t_005cepsfsize-380"></a>You can resize graphics in a more general way by redefining the
+ <p><a name="index-g_t_005cepsfsize-383"></a>You can resize graphics in a more general way by redefining the
<code>\epsfsize</code> macro. <code>\epsffile</code> calls this with two
parameters: the natural horizontal and vertical sizes of the PostScript
graphic. <code>\epsfsize</code> must expand to the desired horizontal size,
@@ -2037,11 +2051,11 @@ instead of <code>\hsize</code>.)
</dl>
- <p><a name="index-DVI-magnification-381"></a><a name="index-magnification_002c-DVI-382"></a><a name="index-g_t_005cmagnification-383"></a>For compatibility with other PostScript drivers, it is possible to turn
+ <p><a name="index-DVI-magnification-384"></a><a name="index-magnification_002c-DVI-385"></a><a name="index-g_t_005cmagnification-386"></a>For compatibility with other PostScript drivers, it is possible to turn
off the default scaling of included figures by the DVI magnification
with the following TeX command:
- <p><a name="index-g_t_002fmagscale-384"></a>
+ <p><a name="index-g_t_002fmagscale-387"></a>
<pre class="example"> \special{! /magscale false def}
</pre>
<p class="noindent">Use of this command is not recommended because it will make the
@@ -2050,12 +2064,12 @@ being used, and it will cause any PostScript graphics to appear
improperly scaled and out of position if a DVI to DVI program is used to
scale or otherwise modify the document.
- <p><a name="index-bop_002dhook-385"></a>DVI magnification is not applied to any output from code you write in
+ <p><a name="index-bop_002dhook-388"></a>DVI magnification is not applied to any output from code you write in
&lsquo;<samp><span class="samp">bop-hook</span></samp>&rsquo; or its ilk (see <a href="#PostScript-hooks">PostScript hooks</a>),
<div class="node">
-<p><hr>
<a name="EPSF-clipping"></a>
+<p><hr>
Previous:&nbsp;<a rel="previous" accesskey="p" href="#EPSF-scaling">EPSF scaling</a>,
Up:&nbsp;<a rel="up" accesskey="u" href="#EPSF-macros">EPSF macros</a>
@@ -2063,7 +2077,7 @@ Up:&nbsp;<a rel="up" accesskey="u" href="#EPSF-macros">EPSF macros</a>
<h5 class="subsubsection">5.1.3.2 EPSF clipping</h5>
-<p><a name="index-clipping-of-EPSF-386"></a><a name="index-bounding-box_002c-inaccurate-387"></a><a name="index-text-in-figures_002c-chopped-off-388"></a><a name="index-lines-in-figures_002c-wrong-width-389"></a>
+<p><a name="index-clipping-of-EPSF-389"></a><a name="index-bounding-box_002c-inaccurate-390"></a><a name="index-text-in-figures_002c-chopped-off-391"></a><a name="index-lines-in-figures_002c-wrong-width-392"></a>
By default, clipping is disabled for included EPSF images. This is
because clipping to the bounding box dimensions often cuts off a
small portion of the figure, due to slightly inaccurate bounding
@@ -2079,8 +2093,8 @@ turn clipping on, just use the command
<pre class="example"> \epsfclipoff
</pre>
<div class="node">
-<p><hr>
<a name="psfile-special"></a>
+<p><hr>
Next:&nbsp;<a rel="next" accesskey="n" href="#Dynamic-creation-of-graphics">Dynamic creation of graphics</a>,
Previous:&nbsp;<a rel="previous" accesskey="p" href="#EPSF-macros">EPSF macros</a>,
Up:&nbsp;<a rel="up" accesskey="u" href="#PostScript-figures">PostScript figures</a>
@@ -2089,7 +2103,7 @@ Up:&nbsp;<a rel="up" accesskey="u" href="#PostScript-figures">PostScript figures
<h4 class="subsection">5.1.4 &lsquo;<samp><span class="samp">psfile</span></samp>&rsquo; special</h4>
-<p><a name="index-psfile-_0040r_007bspecial_007d-390"></a>
+<p><a name="index-psfile-_0040r_007bspecial_007d-393"></a>
The basic special for file inclusion is as follows:
<pre class="example"> \special{psfile=<var>filename</var>.ps <span class="roman">[</span><var>key</var>=<var>value</var><span class="roman">]</span> ... }
@@ -2102,26 +2116,26 @@ specify transformations on the PostScript.
<p>The possible <var>key</var>s are:
<dl>
-<dt>&lsquo;<samp><span class="samp">hoffset</span></samp>&rsquo;<dd><a name="index-hoffset-_0040r_007b_0028_0040samp_007bpsfile_007d-special-option_0029_007d-391"></a>The horizontal offset (default 0).
+<dt>&lsquo;<samp><span class="samp">hoffset</span></samp>&rsquo;<dd><a name="index-hoffset-_0040r_007b_0028_0040samp_007bpsfile_007d-special-option_0029_007d-394"></a>The horizontal offset (default 0).
- <br><dt>&lsquo;<samp><span class="samp">voffset</span></samp>&rsquo;<dd><a name="index-voffset-_0040r_007b_0028_0040samp_007bpsfile_007d-special-option_0029_007d-392"></a>The vertical offset (default 0).
+ <br><dt>&lsquo;<samp><span class="samp">voffset</span></samp>&rsquo;<dd><a name="index-voffset-_0040r_007b_0028_0040samp_007bpsfile_007d-special-option_0029_007d-395"></a>The vertical offset (default 0).
- <br><dt>&lsquo;<samp><span class="samp">hsize</span></samp>&rsquo;<dd><a name="index-hsize-_0040r_007b_0028_0040samp_007bpsfile_007d-special-option_0029_007d-393"></a>The horizontal clipping size (default 612).
+ <br><dt>&lsquo;<samp><span class="samp">hsize</span></samp>&rsquo;<dd><a name="index-hsize-_0040r_007b_0028_0040samp_007bpsfile_007d-special-option_0029_007d-396"></a>The horizontal clipping size (default 612).
- <br><dt>&lsquo;<samp><span class="samp">vsize</span></samp>&rsquo;<dd><a name="index-vsize-_0040r_007b_0028_0040samp_007bpsfile_007d-special-option_0029_007d-394"></a>The vertical clipping size (default 792).
+ <br><dt>&lsquo;<samp><span class="samp">vsize</span></samp>&rsquo;<dd><a name="index-vsize-_0040r_007b_0028_0040samp_007bpsfile_007d-special-option_0029_007d-397"></a>The vertical clipping size (default 792).
- <br><dt>&lsquo;<samp><span class="samp">hscale</span></samp>&rsquo;<dd><a name="index-hscale-_0040r_007b_0028_0040samp_007bpsfile_007d-special-option_0029_007d-395"></a>The horizontal scaling factor, as a percentage (default 100).
+ <br><dt>&lsquo;<samp><span class="samp">hscale</span></samp>&rsquo;<dd><a name="index-hscale-_0040r_007b_0028_0040samp_007bpsfile_007d-special-option_0029_007d-398"></a>The horizontal scaling factor, as a percentage (default 100).
- <br><dt>&lsquo;<samp><span class="samp">vscale</span></samp>&rsquo;<dd><a name="index-vscale-_0040r_007b_0028_0040samp_007bpsfile_007d-special-option_0029_007d-396"></a>The vertical scaling factor, as a percentage (default 100).
+ <br><dt>&lsquo;<samp><span class="samp">vscale</span></samp>&rsquo;<dd><a name="index-vscale-_0040r_007b_0028_0040samp_007bpsfile_007d-special-option_0029_007d-399"></a>The vertical scaling factor, as a percentage (default 100).
- <br><dt>&lsquo;<samp><span class="samp">angle</span></samp>&rsquo;<dd><a name="index-angle-_0040r_007b_0028_0040samp_007bpsfile_007d-special-option_0029_007d-397"></a>The rotation, in degrees (default 0).
+ <br><dt>&lsquo;<samp><span class="samp">angle</span></samp>&rsquo;<dd><a name="index-angle-_0040r_007b_0028_0040samp_007bpsfile_007d-special-option_0029_007d-400"></a>The rotation, in degrees (default 0).
- <br><dt>&lsquo;<samp><span class="samp">clip</span></samp>&rsquo;<dd><a name="index-clip-_0040r_007b_0028_0040samp_007bpsfile_007d-special-option_0029_007d-398"></a>Enable clipping to the bounding box (default disabled).
+ <br><dt>&lsquo;<samp><span class="samp">clip</span></samp>&rsquo;<dd><a name="index-clip-_0040r_007b_0028_0040samp_007bpsfile_007d-special-option_0029_007d-401"></a>Enable clipping to the bounding box (default disabled).
- <br><dt>&lsquo;<samp><span class="samp">llx, lly, urx, ury</span></samp>&rsquo;<dd><a name="index-llx-_0040r_007b_0028_0040samp_007bpsfile_007d-special-option_0029_007d-399"></a><a name="index-lly-_0040r_007b_0028_0040samp_007bpsfile_007d-special-option_0029_007d-400"></a><a name="index-urx-_0040r_007b_0028_0040samp_007bpsfile_007d-special-option_0029_007d-401"></a><a name="index-ury-_0040r_007b_0028_0040samp_007bpsfile_007d-special-option_0029_007d-402"></a>Bounding box of the included image, just as in a <code>%%BoundingBox</code>
+ <br><dt>&lsquo;<samp><span class="samp">llx, lly, urx, ury</span></samp>&rsquo;<dd><a name="index-llx-_0040r_007b_0028_0040samp_007bpsfile_007d-special-option_0029_007d-402"></a><a name="index-lly-_0040r_007b_0028_0040samp_007bpsfile_007d-special-option_0029_007d-403"></a><a name="index-urx-_0040r_007b_0028_0040samp_007bpsfile_007d-special-option_0029_007d-404"></a><a name="index-ury-_0040r_007b_0028_0040samp_007bpsfile_007d-special-option_0029_007d-405"></a>Bounding box of the included image, just as in a <code>%%BoundingBox</code>
comment. Values are in big points, and may be fractional.
- <br><dt>&lsquo;<samp><span class="samp">rhi, rwi</span></samp>&rsquo;<dd><a name="index-rhi-_0040r_007b_0028_0040samp_007bpsfile_007d-special-option_0029_007d-403"></a><a name="index-rwi-_0040r_007b_0028_0040samp_007bpsfile_007d-special-option_0029_007d-404"></a>Desired width and height of the resulting figure in the output, in
+ <br><dt>&lsquo;<samp><span class="samp">rhi, rwi</span></samp>&rsquo;<dd><a name="index-rhi-_0040r_007b_0028_0040samp_007bpsfile_007d-special-option_0029_007d-406"></a><a name="index-rwi-_0040r_007b_0028_0040samp_007bpsfile_007d-special-option_0029_007d-407"></a>Desired width and height of the resulting figure in the output, in
tenths of big points (720 to the inch); may be fractional.
<p>If both <code>rwi</code> and <code>rhi</code> are nonzero, the picture is scaled,
@@ -2144,8 +2158,8 @@ operations is to rotate the figure, scale it, then offset it.
<p>For compatibility with older PostScript drivers, it is possible to change
the units that &lsquo;<samp><span class="samp">hscale</span></samp>&rsquo; and &lsquo;<samp><span class="samp">vscale</span></samp>&rsquo; are given in. This can be
done by redefining &lsquo;<samp><span class="samp">@scaleunit</span></samp>&rsquo;
-<a name="index-scaleunit-405"></a>in &lsquo;<samp><span class="samp">SDict</span></samp>&rsquo;
-<a name="index-SDict-406"></a>by a TeX command such as
+<a name="index-scaleunit-408"></a>in &lsquo;<samp><span class="samp">SDict</span></samp>&rsquo;
+<a name="index-SDict-409"></a>by a TeX command such as
<pre class="example"> \special{! /@scaleunit 1 def}
</pre>
@@ -2154,8 +2168,8 @@ done by redefining &lsquo;<samp><span class="samp">@scaleunit</span></samp>&rsqu
scale factor.
<div class="node">
-<p><hr>
<a name="Dynamic-creation-of-graphics"></a>
+<p><hr>
Next:&nbsp;<a rel="next" accesskey="n" href="#Fonts-in-figures">Fonts in figures</a>,
Previous:&nbsp;<a rel="previous" accesskey="p" href="#psfile-special">psfile special</a>,
Up:&nbsp;<a rel="up" accesskey="u" href="#PostScript-figures">PostScript figures</a>
@@ -2164,7 +2178,7 @@ Up:&nbsp;<a rel="up" accesskey="u" href="#PostScript-figures">PostScript figures
<h4 class="subsection">5.1.5 Dynamic creation of PostScript graphics files</h4>
-<p><a name="index-dynamic-creation-of-graphics-407"></a><a name="index-compressed-PostScript-408"></a><a name="index-uncompressing-PostScript-409"></a>
+<p><a name="index-dynamic-creation-of-graphics-410"></a><a name="index-compressed-PostScript-411"></a><a name="index-uncompressing-PostScript-412"></a>
PostScript is an excellent page description language&mdash;but it does tend
to be rather verbose. Compressing PostScript graphics files can reduce
them by factor of five or more. For this reason, if the name of an
@@ -2184,14 +2198,14 @@ file to standard output. For example:
<pre class="example"> \special{psfile="`gnuplot foo"}
</pre>
- <p class="noindent"><a name="index-gnuplot-410"></a>to include the file <samp><span class="file">foo</span></samp>. Of course, the command to be executed
+ <p class="noindent"><a name="index-gnuplot-413"></a>to include the file <samp><span class="file">foo</span></samp>. Of course, the command to be executed
can be anything, including using a file conversion utility such as
<samp><span class="file">tek2ps</span></samp> or whatever is appropriate. This feature can be disabled
with the &lsquo;<samp><span class="samp">-R</span></samp>&rsquo; command-line option or &lsquo;<samp><span class="samp">R</span></samp>&rsquo; configuration option.
<div class="node">
-<p><hr>
<a name="Fonts-in-figures"></a>
+<p><hr>
Previous:&nbsp;<a rel="previous" accesskey="p" href="#Dynamic-creation-of-graphics">Dynamic creation of graphics</a>,
Up:&nbsp;<a rel="up" accesskey="u" href="#PostScript-figures">PostScript figures</a>
@@ -2199,7 +2213,7 @@ Up:&nbsp;<a rel="up" accesskey="u" href="#PostScript-figures">PostScript figures
<h4 class="subsection">5.1.6 Fonts in figures</h4>
-<p><a name="index-figures-and-fonts-411"></a><a name="index-fonts_002c-in-PostScript-figures-412"></a><a name="index-g_t_0025_002aFont-413"></a>
+<p><a name="index-figures-and-fonts-414"></a><a name="index-fonts_002c-in-PostScript-figures-415"></a><a name="index-g_t_0025_002aFont-416"></a>
You can use any font available to TeX and Dvips within a graphics
file by putting a <code>%*Font:</code> line in the leading commentary of the
file. Schematically, this looks like:
@@ -2238,8 +2252,8 @@ treated as a bitmap. For example, if your figure used the single letter
in a MetaPost label (see <a href="web2c.html#MetaPost">MetaPost</a>).
<div class="node">
-<p><hr>
<a name="Header-files"></a>
+<p><hr>
Next:&nbsp;<a rel="next" accesskey="n" href="#Literal-PS">Literal PS</a>,
Previous:&nbsp;<a rel="previous" accesskey="p" href="#PostScript-figures">PostScript figures</a>,
Up:&nbsp;<a rel="up" accesskey="u" href="#Interaction-with-PostScript">Interaction with PostScript</a>
@@ -2248,14 +2262,14 @@ Up:&nbsp;<a rel="up" accesskey="u" href="#Interaction-with-PostScript">Interacti
<h3 class="section">5.2 PostScript header files</h3>
-<p><a name="index-header-files_002c-defined-414"></a><a name="index-PostScript-header-files-415"></a>
+<p><a name="index-header-files_002c-defined-417"></a><a name="index-PostScript-header-files-418"></a>
<dfn>Header files</dfn> are bits of PostScript included in the output file;
generally they provide support for special features, rather than
producing any printed output themselves. You can explicitly request
downloading header files if necessary for some figure, or to achieve
some special effect.
- <p><a name="index-psheaderdir-416"></a><a name="index-g_t_002epro-_0040r_007bprologue-files_007d-417"></a><a name="index-g_t_002elpro-_0040r_007blong-prologue-files_007d-418"></a>Dvips includes some headers on its own initiative, to implement features
+ <p><a name="index-psheaderdir-419"></a><a name="index-g_t_002epro-_0040r_007bprologue-files_007d-420"></a><a name="index-g_t_002elpro-_0040r_007blong-prologue-files_007d-421"></a>Dvips includes some headers on its own initiative, to implement features
such as PostScript font reencoding, bitmap font downloading, handling of
<code>\special</code>'s, and so on. These standard headers are the
<samp><span class="file">.pro</span></samp> files (for &ldquo;prologue&rdquo;) in the installation directory
@@ -2265,7 +2279,7 @@ comments, squeezing blank lines, etc., for maximum efficiency. If you
want to peruse one of the standard header files, read the <samp><span class="file">.lpro</span></samp>
version.
- <p><a name="index-userdict_0040r_007b_002c-and-dictionary-files_007d-419"></a><a name="index-dictionary_002c-_0040code_007buserdict_007d-420"></a>The PostScript dictionary stack will be at the &lsquo;<samp><span class="samp">userdict</span></samp>&rsquo; level
+ <p><a name="index-userdict_0040r_007b_002c-and-dictionary-files_007d-422"></a><a name="index-dictionary_002c-_0040code_007buserdict_007d-423"></a>The PostScript dictionary stack will be at the &lsquo;<samp><span class="samp">userdict</span></samp>&rsquo; level
when header files are included.
<ul class="menu">
@@ -2275,8 +2289,8 @@ when header files are included.
</ul>
<div class="node">
-<p><hr>
<a name="Including-headers-from-TeX"></a>
+<p><hr>
Next:&nbsp;<a rel="next" accesskey="n" href="#Including-headers-from-the-command-line">Including headers from the command line</a>,
Up:&nbsp;<a rel="up" accesskey="u" href="#Header-files">Header files</a>
@@ -2284,15 +2298,15 @@ Up:&nbsp;<a rel="up" accesskey="u" href="#Header-files">Header files</a>
<h4 class="subsection">5.2.1 Including headers from TeX</h4>
-<p><a name="index-including-headers-in-_0040TeX_007b_007d-421"></a><a name="index-header_003d_0040var_007bfile_007d-_005cspecial-422"></a><a name="index-g_t_0040TeX_007b_007d_002c-including-headers-in-423"></a>
-<a name="index-headers_002c-including-in-_0040TeX_007b_007d-424"></a>In order to get a particular graphic file to work, a certain font or
+<p><a name="index-including-headers-in-_0040TeX_007b_007d-424"></a><a name="index-header_003d_0040var_007bfile_007d-_005cspecial-425"></a><a name="index-g_t_0040TeX_007b_007d_002c-including-headers-in-426"></a>
+<a name="index-headers_002c-including-in-_0040TeX_007b_007d-427"></a>In order to get a particular graphic file to work, a certain font or
header file might need to be sent first. The Dvips program provides
support for this with the &lsquo;<samp><span class="samp">header</span></samp>&rsquo; <code>\special</code>. For instance,
to ensure that <samp><span class="file">foo.ps</span></samp> gets downloaded:
<pre class="example"> \special{header=foo.ps}
</pre>
- <p><a name="index-fonts_002c-as-header-files-425"></a>As another example, if you have some PostScript code that uses a
+ <p><a name="index-fonts_002c-as-header-files-428"></a>As another example, if you have some PostScript code that uses a
PostScript font not built into your printer, you must download it to the
printer. If the font isn't used elsewhere in the document, Dvips can't
know you've used it, so you must include it in the same way, as in:
@@ -2307,7 +2321,7 @@ the file itself, as follows:
<pre class="example"> \special{header={foo.ps} pre={pre code} post={post code}}
</pre>
- <p><a name="index-before-header_002c-inserting-code-426"></a><a name="index-after-header_002c-inserting-code-427"></a><a name="index-pre-_0040r_007bcode-before-headers_007d-428"></a><a name="index-post-_0040r_007bcode-after-headers_007d-429"></a>This will insert <code>pre code</code> just before <samp><span class="file">foo.ps</span></samp> and
+ <p><a name="index-before-header_002c-inserting-code-429"></a><a name="index-after-header_002c-inserting-code-430"></a><a name="index-pre-_0040r_007bcode-before-headers_007d-431"></a><a name="index-post-_0040r_007bcode-after-headers_007d-432"></a>This will insert <code>pre code</code> just before <samp><span class="file">foo.ps</span></samp> and
<code>post code</code> just after. It is required to use the (balanced)
braces in <em>all</em> of the arguments, including the <code>header</code>,
when using this extended syntax.
@@ -2327,8 +2341,8 @@ does. This is because common graphics may well come with packages
which are installed in the <samp><span class="file">tex/</span></samp> tree.
<div class="node">
-<p><hr>
<a name="Including-headers-from-the-command-line"></a>
+<p><hr>
Next:&nbsp;<a rel="next" accesskey="n" href="#Headers-and-memory-usage">Headers and memory usage</a>,
Previous:&nbsp;<a rel="previous" accesskey="p" href="#Including-headers-from-TeX">Including headers from TeX</a>,
Up:&nbsp;<a rel="up" accesskey="u" href="#Header-files">Header files</a>
@@ -2337,14 +2351,14 @@ Up:&nbsp;<a rel="up" accesskey="u" href="#Header-files">Header files</a>
<h4 class="subsection">5.2.2 Including headers from the command line</h4>
-<p><a name="index-including-headers-from-the-command-line-430"></a><a name="index-command-line_002c-including-headers-from-431"></a><a name="index-headers_002c-including-from-the-command-line-432"></a>
+<p><a name="index-including-headers-from-the-command-line-433"></a><a name="index-command-line_002c-including-headers-from-434"></a><a name="index-headers_002c-including-from-the-command-line-435"></a>
You can include headers when you run Dvips, as well as from your
document (see the previous section). To do this, run Dvips with the
option &lsquo;<samp><span class="samp">-P </span><var>header</var></samp>&rsquo;; this will read the file
<samp><span class="file">config.</span><var>header</var></samp>, which in turn can specify a header file to
be downloaded with the &lsquo;<samp><span class="samp">h</span></samp>&rsquo; option. See <a href="#Configuration-file-commands">Configuration file commands</a>. These files are called <samp><var>header</var><span class="file">.cfg</span></samp> on MS-DOS.
- <p><a name="index-duplex-printers-433"></a><a name="index-simplex-mode-on-duplex-printers-434"></a><a name="index-screen-frequencies_002c-setting-435"></a>You can arrange for the same file to serve as a &lsquo;<samp><span class="samp">-P</span></samp>&rsquo; config file
+ <p><a name="index-duplex-printers-436"></a><a name="index-simplex-mode-on-duplex-printers-437"></a><a name="index-screen-frequencies_002c-setting-438"></a>You can arrange for the same file to serve as a &lsquo;<samp><span class="samp">-P</span></samp>&rsquo; config file
and the downloadable header file, by starting the lines of PostScript
code with a space, leaving only the &lsquo;<samp><span class="samp">h</span></samp>&rsquo; line and any comments
starting in the first column. As an example, see
@@ -2354,8 +2368,8 @@ mode on duplex printers, and setting various screen frequencies;
<samp><span class="file">contrib/volker/README</span></samp> explains further.)
<div class="node">
-<p><hr>
<a name="Headers-and-memory-usage"></a>
+<p><hr>
Previous:&nbsp;<a rel="previous" accesskey="p" href="#Including-headers-from-the-command-line">Including headers from the command line</a>,
Up:&nbsp;<a rel="up" accesskey="u" href="#Header-files">Header files</a>
@@ -2363,13 +2377,13 @@ Up:&nbsp;<a rel="up" accesskey="u" href="#Header-files">Header files</a>
<h4 class="subsection">5.2.3 Headers and memory usage</h4>
-<p><a name="index-headers-and-memory-usage-436"></a><a name="index-memory-usage_002c-and-headers-437"></a>
-<a name="index-sections-of-output-file_002c-and-memory-438"></a><a name="index-output-file_002c-sectioning-of-439"></a>Dvips tries to avoid overflowing the printer's memory by splitting the
+<p><a name="index-headers-and-memory-usage-439"></a><a name="index-memory-usage_002c-and-headers-440"></a>
+<a name="index-sections-of-output-file_002c-and-memory-441"></a><a name="index-output-file_002c-sectioning-of-442"></a>Dvips tries to avoid overflowing the printer's memory by splitting the
output files into &ldquo;sections&rdquo; (see the &lsquo;<samp><span class="samp">-i</span></samp>&rsquo; option in <a href="#Option-details">Option details</a>). Therefore, for all header files, Dvips debits the printer VM
budget by some value. If the header file has, in its leading
commentary a line of the form
- <p><a name="index-VMusage-440"></a><a name="index-g_t_0025_0025VMusage-441"></a>
+ <p><a name="index-VMusage-443"></a><a name="index-g_t_0025_0025VMusage-444"></a>
<pre class="example"> %%VMusage: <var>min</var> <var>max</var>
</pre>
<p class="noindent">then <var>max</var> is used. If there is no <code>%%VMusage</code> line, then
@@ -2378,8 +2392,8 @@ the size (in bytes) of the header file is used as an approximation.
<p>Illustrations (figure files) are also checked for <code>%%VMusage</code> line.
<div class="node">
-<p><hr>
<a name="Literal-PS"></a>
+<p><hr>
Next:&nbsp;<a rel="next" accesskey="n" href="#Hypertext">Hypertext</a>,
Previous:&nbsp;<a rel="previous" accesskey="p" href="#Header-files">Header files</a>,
Up:&nbsp;<a rel="up" accesskey="u" href="#Interaction-with-PostScript">Interaction with PostScript</a>
@@ -2388,7 +2402,7 @@ Up:&nbsp;<a rel="up" accesskey="u" href="#Interaction-with-PostScript">Interacti
<h3 class="section">5.3 Literal PostScript</h3>
-<p><a name="index-literal-PostScript_002c-using-442"></a><a name="index-PostScript-code_002c-literal-443"></a>
+<p><a name="index-literal-PostScript_002c-using-445"></a><a name="index-PostScript-code_002c-literal-446"></a>
You can include literal PostScript code in your document in several ways.
<ul class="menu">
@@ -2400,9 +2414,9 @@ You can include literal PostScript code in your document in several ways.
</ul>
<div class="node">
-<p><hr>
<a name="%22-special"></a>
<a name="g_t_0022-special"></a>
+<p><hr>
Next:&nbsp;<a rel="next" accesskey="n" href="#ps-special">ps special</a>,
Up:&nbsp;<a rel="up" accesskey="u" href="#Literal-PS">Literal PS</a>
@@ -2410,7 +2424,7 @@ Up:&nbsp;<a rel="up" accesskey="u" href="#Literal-PS">Literal PS</a>
<h4 class="subsection">5.3.1 <code>"</code> special: Literal PostScript</h4>
-<p><a name="index-g_t_0022-_0040r_007bspecial-_0028literal-PostScript_0029_007d-444"></a>
+<p><a name="index-g_t_0022-_0040r_007bspecial-_0028literal-PostScript_0029_007d-447"></a>
For simple graphics, or just for experimentation, literal PostScript
code can be included. Simply use a <code>\special</code> beginning with a
double quote character &lsquo;<samp><span class="samp">"</span></samp>&rsquo;; there is no matching closing &lsquo;<samp><span class="samp">"</span></samp>&rsquo;.
@@ -2427,8 +2441,8 @@ double quote character &lsquo;<samp><span class="samp">"</span></samp>&rsquo;; t
the <code>\vbox</code> above.
<div class="node">
-<p><hr>
<a name="ps-special"></a>
+<p><hr>
Next:&nbsp;<a rel="next" accesskey="n" href="#PostScript-hooks">PostScript hooks</a>,
Previous:&nbsp;<a rel="previous" accesskey="p" href="#g_t_0022-special">&quot; special</a>,
Up:&nbsp;<a rel="up" accesskey="u" href="#Literal-PS">Literal PS</a>
@@ -2437,8 +2451,8 @@ Up:&nbsp;<a rel="up" accesskey="u" href="#Literal-PS">Literal PS</a>
<h4 class="subsection">5.3.2 &lsquo;<samp><span class="samp">ps</span></samp>&rsquo; special</h4>
-<p><a name="index-ps-_0040r_007bspecial_007d-445"></a>
-<a name="index-save_002frestore_002c-and-specials-446"></a>Generally, Dvips encloses specials in a PostScript save/restore pair,
+<p><a name="index-ps-_0040r_007bspecial_007d-448"></a>
+<a name="index-save_002frestore_002c-and-specials-449"></a>Generally, Dvips encloses specials in a PostScript save/restore pair,
guaranteeing that the special will have no effect on the rest of the
document. The &lsquo;<samp><span class="samp">ps</span></samp>&rsquo; special, however, allows you to insert literal
PostScript instructions without this protective shield; you should
@@ -2462,18 +2476,18 @@ can be used to continue PostScript literals started with &lsquo;<samp><span clas
<em>not</em> broken into lines. This feature may be used to include
PostScript comments, for example.
- <p><a name="index-plotfile_0040r_007b_002c-_0040samp_007bps_007d-subspecial_007d-447"></a>In addition, the variant
+ <p><a name="index-plotfile_0040r_007b_002c-_0040samp_007bps_007d-subspecial_007d-450"></a>In addition, the variant
<pre class="example"> \special{ps: plotfile <var>filename</var>}
</pre>
- <p class="noindent"><a name="index-rotate_002etex-448"></a>inserts the contents of <var>filename</var> verbatim into the output (except
+ <p class="noindent"><a name="index-rotate_002etex-451"></a>inserts the contents of <var>filename</var> verbatim into the output (except
for omitting lines that begin with %). An example of the proper use of
literal specials can be found in the file <samp><span class="file">rotate.tex</span></samp>, which makes
it easy to typeset text turned in multiples of 90 degrees.
<div class="node">
-<p><hr>
<a name="Literal-headers"></a>
+<p><hr>
Next:&nbsp;<a rel="next" accesskey="n" href="#Literal-examples">Literal examples</a>,
Previous:&nbsp;<a rel="previous" accesskey="p" href="#PostScript-hooks">PostScript hooks</a>,
Up:&nbsp;<a rel="up" accesskey="u" href="#Literal-PS">Literal PS</a>
@@ -2482,8 +2496,8 @@ Up:&nbsp;<a rel="up" accesskey="u" href="#Literal-PS">Literal PS</a>
<h4 class="subsection">5.3.3 Literal headers: &lsquo;<samp><span class="samp">!</span></samp>&rsquo; <code>\special</code></h4>
-<p><a name="index-literal-headers-449"></a><a name="index-SDict-_0040r_007bdictionary_007d-450"></a>
-<a name="index-g_t_0021-_0040r_007bspecial-_0028literal-PS-header_0029_007d-451"></a><a name="index-dictionary_002c-_0040code_007bSDict_007d-452"></a>You can download literal PostScript header code in your TeX document,
+<p><a name="index-literal-headers-452"></a><a name="index-SDict-_0040r_007bdictionary_007d-453"></a>
+<a name="index-g_t_0021-_0040r_007bspecial-_0028literal-PS-header_0029_007d-454"></a><a name="index-dictionary_002c-_0040code_007bSDict_007d-455"></a>You can download literal PostScript header code in your TeX document,
for use with (for example) literal graphics code that you include later.
The text of a <code>\special</code> beginning with an &lsquo;<samp><span class="samp">!</span></samp>&rsquo; is copied into
the output file. A dictionary <code>SDict</code> will be current when this
@@ -2497,8 +2511,8 @@ literally (the &lsquo;<samp><span class="samp">"</span></samp>&rsquo; special) o
<pre class="example"> \special{! /reset { 0 0 moveto} def}
</pre>
<div class="node">
-<p><hr>
<a name="PostScript-hooks"></a>
+<p><hr>
Next:&nbsp;<a rel="next" accesskey="n" href="#Literal-headers">Literal headers</a>,
Previous:&nbsp;<a rel="previous" accesskey="p" href="#ps-special">ps special</a>,
Up:&nbsp;<a rel="up" accesskey="u" href="#Literal-PS">Literal PS</a>
@@ -2507,18 +2521,18 @@ Up:&nbsp;<a rel="up" accesskey="u" href="#Literal-PS">Literal PS</a>
<h4 class="subsection">5.3.4 PostScript hooks</h4>
-<p><a name="index-PostScript-hooks-453"></a>
+<p><a name="index-PostScript-hooks-456"></a>
Besides including literal PostScript at a particular place in your
document (as described in the previous section), you can also arrange to
execute arbitrary PostScript code at particular times while the
PostScript is printing.
- <p><a name="index-bop_002dhook-454"></a><a name="index-eop_002dhook-455"></a><a name="index-start_002dhook-456"></a><a name="index-end_002dhook-457"></a>If any of the PostScript names <code>bop-hook</code>, <code>eop-hook</code>,
+ <p><a name="index-bop_002dhook-457"></a><a name="index-eop_002dhook-458"></a><a name="index-start_002dhook-459"></a><a name="index-end_002dhook-460"></a>If any of the PostScript names <code>bop-hook</code>, <code>eop-hook</code>,
<code>start-hook</code>, or <code>end-hook</code> are defined in <code>userdict</code>,
they will be executed at the beginning of a page, end of a page, start
of the document, and end of a document, respectively.
- <p><a name="index-draft-copies-458"></a><a name="index-dated-output-459"></a>When these macros are executed, the default PostScript coordinate system
+ <p><a name="index-draft-copies-461"></a><a name="index-dated-output-462"></a>When these macros are executed, the default PostScript coordinate system
and origin is in effect. Such macros can be defined in headers added by
the &lsquo;<samp><span class="samp">-h</span></samp>&rsquo; option or the &lsquo;<samp><span class="samp">header=</span></samp>&rsquo; special, and might be useful
for writing, for instance, `DRAFT' across the entire page, or, with the
@@ -2528,7 +2542,7 @@ possible for them to accumulate information, but if a document must be
divided into sections because of memory constraints, such added
information will be lost across section breaks.
- <p><a name="index-physical-page-number_002c-and-_0040code_007bbop_002dhook_007d-460"></a>The single argument to <code>bop-hook</code> is the physical page number; the
+ <p><a name="index-physical-page-number_002c-and-_0040code_007bbop_002dhook_007d-463"></a>The single argument to <code>bop-hook</code> is the physical page number; the
first page gets zero, the second one, etc. <code>bop-hook</code> must leave
this number on the stack. None of the other hooks are passed arguments.
@@ -2539,7 +2553,7 @@ a light grey `DRAFT' across each page in the document:
65 rotate /Times-Roman findfont 216 scalefont setfont
0 0 moveto 0.7 setgray (DRAFT) show grestore}def end}
</pre>
- <p><a name="index-g_t_0025_0025Page_0040r_007b_002c-and-multi_002dpage-information_007d-461"></a>Using <code>bop-hook</code> or <code>eop-hook</code> to preserve information across
+ <p><a name="index-g_t_0025_0025Page_0040r_007b_002c-and-multi_002dpage-information_007d-464"></a>Using <code>bop-hook</code> or <code>eop-hook</code> to preserve information across
pages breaks compliance with the Adobe document structuring conventions,
so if you use any such tricks, you may also want to use the &lsquo;<samp><span class="samp">-N</span></samp>&rsquo;
option to turn off structured comments (such as &lsquo;<samp><span class="samp">%%Page</span></samp>&rsquo;).
@@ -2547,8 +2561,8 @@ Otherwise, programs that read your file will assume its pages are
independent.
<div class="node">
-<p><hr>
<a name="Literal-examples"></a>
+<p><hr>
Previous:&nbsp;<a rel="previous" accesskey="p" href="#Literal-headers">Literal headers</a>,
Up:&nbsp;<a rel="up" accesskey="u" href="#Literal-PS">Literal PS</a>
@@ -2556,7 +2570,7 @@ Up:&nbsp;<a rel="up" accesskey="u" href="#Literal-PS">Literal PS</a>
<h4 class="subsection">5.3.5 Literal examples</h4>
-<p><a name="index-literal-PostScript_002c-examples-462"></a><a name="index-examples-of-literal-PostScript-463"></a>
+<p><a name="index-literal-PostScript_002c-examples-465"></a><a name="index-examples-of-literal-PostScript-466"></a>
To finish off this section, the following examples of literal PostScript
are presented without explanation:
@@ -2572,7 +2586,7 @@ are presented without explanation:
\line{\hss\hskip4pt NEAT\hss}\vss}\special{ps:0 setgray}%
\hbox{\raise2pt\line{\hss NEAT\hss}\special{ps:grestore}}\vss}
</pre>
- <p><a name="index-g_t_005crotninety-464"></a><a name="index-gsave_0040r_007b_002f_007dgrestore_0040r_007b_002c-and-literal-PS_007d-465"></a><a name="index-save_0040r_007b_002f_007drestore_0040r_007b_002c-and-literal-PS_007d-466"></a>Some caveats are in order, however. Make sure that each <code>gsave</code> is
+ <p><a name="index-g_t_005crotninety-467"></a><a name="index-gsave_0040r_007b_002f_007dgrestore_0040r_007b_002c-and-literal-PS_007d-468"></a><a name="index-save_0040r_007b_002f_007drestore_0040r_007b_002c-and-literal-PS_007d-469"></a>Some caveats are in order, however. Make sure that each <code>gsave</code> is
matched with a <code>grestore</code> on the same page. Do not use <code>save</code>
and <code>restore</code>; they can interact with the PostScript generated by
Dvips if care is not taken. Try to understand what the above macros are
@@ -2580,8 +2594,8 @@ doing before writing your own. The <code>\rotninety</code> macro especially
has a useful trick that appears again and again.
<div class="node">
-<p><hr>
<a name="Hypertext"></a>
+<p><hr>
Previous:&nbsp;<a rel="previous" accesskey="p" href="#Literal-PS">Literal PS</a>,
Up:&nbsp;<a rel="up" accesskey="u" href="#Interaction-with-PostScript">Interaction with PostScript</a>
@@ -2589,13 +2603,13 @@ Up:&nbsp;<a rel="up" accesskey="u" href="#Interaction-with-PostScript">Interacti
<h3 class="section">5.4 HyperTeXt</h3>
-<p><a name="index-hypertext-support-467"></a>
-<a name="index-g_t_002dz-468"></a><a name="index-html-_0040r_007bspecials_007d-469"></a><a name="index-pdfmark-470"></a>Dvips has support for producing hypertext PostScript documents. If you
+<p><a name="index-hypertext-support-470"></a>
+<a name="index-g_t_002dz-471"></a><a name="index-html-_0040r_007bspecials_007d-472"></a><a name="index-pdfmark-473"></a>Dvips has support for producing hypertext PostScript documents. If you
specify the &lsquo;<samp><span class="samp">-z</span></samp>&rsquo; option, the <samp><span class="file">html:</span></samp> specials described below
will be converted into &lsquo;<samp><span class="samp">pdfmark</span></samp>&rsquo; PostScript operators to specify
links. Without &lsquo;<samp><span class="samp">-z</span></samp>&rsquo;, <samp><span class="file">html:</span></samp> specials are ignored.
- <p><a name="index-distiller_002c-for-PDF-files-471"></a><a name="index-PDF-files_002c-making-472"></a>The resulting PostScript can then be processed by a distiller program to
+ <p><a name="index-distiller_002c-for-PDF-files-474"></a><a name="index-PDF-files_002c-making-475"></a>The resulting PostScript can then be processed by a distiller program to
make a PDF file. (It can still be handled by ordinary PostScript
interpreters as well.) Various versions of both PC and Unix distillers
are supported; Ghostscript includes limited distiller support
@@ -2605,7 +2619,7 @@ are supported; Ghostscript includes limited distiller support
first place are available from <samp><var>CTAN:</var><span class="file">/support/hypertex</span></samp>. For
CTAN info, see <a href="kpathsea.html#unixtex_002eftp">unixtex.ftp</a>.
- <p><a name="index-g_t_0040code_007bhttp_003a_002f_002fwww_002ewin_002etue_002enl_002f_007edickie_002fidvi_007d-473"></a><a name="index-g_t_0040code_007bhttp_003a_002f_002fxxx_002elanl_002egov_002fhypertex_007d-474"></a><a name="index-Doyle_002c-Mark-475"></a><a name="index-Bhattacharya_002c-Tanmoy-476"></a><a name="index-Java-DVI-reader-477"></a><a name="index-idvi-_0040r_007bJava-DVI-reader_007d-478"></a><a name="index-dvihps_0040r_007b_002c-hyperdvi-to-PostScript_007d-479"></a>This hypertext support (and original form of the documentation) was
+ <p><a name="index-g_t_0040code_007bhttp_003a_002f_002fwww_002ewin_002etue_002enl_002f_007edickie_002fidvi_007d-476"></a><a name="index-g_t_0040code_007bhttp_003a_002f_002fxxx_002elanl_002egov_002fhypertex_007d-477"></a><a name="index-Doyle_002c-Mark-478"></a><a name="index-Bhattacharya_002c-Tanmoy-479"></a><a name="index-Java-DVI-reader-480"></a><a name="index-idvi-_0040r_007bJava-DVI-reader_007d-481"></a><a name="index-dvihps_0040r_007b_002c-hyperdvi-to-PostScript_007d-482"></a>This hypertext support (and original form of the documentation) was
written by Mark Doyle and Tanmoy Bhattacharya as the &lsquo;<samp><span class="samp">dvihps</span></samp>&rsquo;
program. You can retrieve their software and additional documentation
via the CTAN reference above. You may also be interested in the Java
@@ -2622,8 +2636,8 @@ the process of making PDF files from TeX files in more detail.
</ul>
<div class="node">
-<p><hr>
<a name="Hypertext-caveats"></a>
+<p><hr>
Next:&nbsp;<a rel="next" accesskey="n" href="#Hypertext-specials">Hypertext specials</a>,
Up:&nbsp;<a rel="up" accesskey="u" href="#Hypertext">Hypertext</a>
@@ -2631,8 +2645,8 @@ Up:&nbsp;<a rel="up" accesskey="u" href="#Hypertext">Hypertext</a>
<h4 class="subsection">5.4.1 Hypertext caveats</h4>
-<p><a name="index-hypertext-caveats-480"></a>
-<a name="index-Computer-Modern-in-PostScript-481"></a><a name="index-hypertext-and-bitmap-fonts-482"></a><a name="index-hypertext-caveats-483"></a><a name="index-embedding-Type-1-fonts-484"></a><a name="index-PDF-files_002c-font-quality-485"></a>If you intend to go all the way to PDF, you may want to use the standard
+<p><a name="index-hypertext-caveats-483"></a>
+<a name="index-Computer-Modern-in-PostScript-484"></a><a name="index-hypertext-and-bitmap-fonts-485"></a><a name="index-hypertext-caveats-486"></a><a name="index-embedding-Type-1-fonts-487"></a><a name="index-PDF-files_002c-font-quality-488"></a>If you intend to go all the way to PDF, you may want to use the standard
35 PostScript fonts exclusively, since other fonts are embedded as
bitmaps by default. The Adobe PDF readers are extremely slow when
dealing with bitmap fonts and the results look terrible on the screen.
@@ -2680,7 +2694,7 @@ recommendations are GNU Ghostscript 6.51 or Aladdin Ghostscript 7.0.
You can check the fonts in a PDF file with Acrobat Reader by selecting
the menu entries &lsquo;<samp><span class="samp">File|Document Info|Fonts</span></samp>&rsquo;.
- <p><a name="index-psi-character-missing-486"></a><a name="index-trailing-spaces_002c-dropped-487"></a><a name="index-spaces_002c-dropped-trailing-488"></a>Also, the Adobe distillers prior to 2.1 drop trailing space characters
+ <p><a name="index-psi-character-missing-489"></a><a name="index-trailing-spaces_002c-dropped-490"></a><a name="index-spaces_002c-dropped-trailing-491"></a>Also, the Adobe distillers prior to 2.1 drop trailing space characters
(character code 32) from strings. Unfortunately, the PostScript fonts
use this character code for characters other than space (notably the
Greek letter psi in the <code>Symbol</code> font), and so these characters are
@@ -2710,8 +2724,8 @@ P. Van Zandt:<br>
<a href="http://www.emrg.com/texpdf.htmlhttp://zandtwerk.insead.fr/tex2pdf.html">http://www.emrg.com/texpdf.htmlhttp://zandtwerk.insead.fr/tex2pdf.html</a>.
<div class="node">
-<p><hr>
<a name="Hypertext-specials"></a>
+<p><hr>
Previous:&nbsp;<a rel="previous" accesskey="p" href="#Hypertext-caveats">Hypertext caveats</a>,
Up:&nbsp;<a rel="up" accesskey="u" href="#Hypertext">Hypertext</a>
@@ -2719,8 +2733,8 @@ Up:&nbsp;<a rel="up" accesskey="u" href="#Hypertext">Hypertext</a>
<h4 class="subsection">5.4.2 Hypertext specials</h4>
-<p><a name="index-hypertext-specials-489"></a><a name="index-specials_002c-hypertext-490"></a>
-<a name="index-Smith_002c-Arthur-491"></a>Current support for the World Wide Web in the TeX system does not
+<p><a name="index-hypertext-specials-492"></a><a name="index-specials_002c-hypertext-493"></a>
+<a name="index-Smith_002c-Arthur-494"></a>Current support for the World Wide Web in the TeX system does not
involve modifying TeX itself. We need only define some specials;
Arthur Smith (<a href="mailto:apsmith@aps.org">apsmith@aps.org</a>), Tanmoy Bhattacharya, and Paul
Ginsparg originally proposed and implemented the following:
@@ -2734,7 +2748,7 @@ Ginsparg originally proposed and implemented the following:
are uninterpreted by TeX itself. They are instructions to DVI
processors only.
- <p><a name="index-uniform-resource-locator-492"></a><a name="index-extended-URL-493"></a><a name="index-URL_002c-extended-for-_0040TeX_007b_007d-494"></a><a name="index-Murphy_002c-Tim-495"></a>Here, <var>xurl</var> is a standard WWW uniform resource locator (URL),
+ <p><a name="index-uniform-resource-locator-495"></a><a name="index-extended-URL-496"></a><a name="index-URL_002c-extended-for-_0040TeX_007b_007d-497"></a><a name="index-Murphy_002c-Tim-498"></a>Here, <var>xurl</var> is a standard WWW uniform resource locator (URL),
possibly extended with a &lsquo;<samp><span class="samp">#</span><var>type</var><span class="samp">.</span><var>string</var></samp>&rsquo; construct,
where <var>type</var> is &lsquo;<samp><span class="samp">page</span></samp>&rsquo;, &lsquo;<samp><span class="samp">section</span></samp>&rsquo;, &lsquo;<samp><span class="samp">equation</span></samp>&rsquo;,
&lsquo;<samp><span class="samp">reference</span></samp>&rsquo; (for bibliographic references), &lsquo;<samp><span class="samp">figure</span></samp>&rsquo;,
@@ -2743,12 +2757,12 @@ where <var>type</var> is &lsquo;<samp><span class="samp">page</span></samp>&rsqu
</pre>
<p class="noindent">is a link to equation (1.1) in an example document by Tim Murphy.
- <p><a name="index-URL_002c-definition-496"></a>See the URL <a href="http://www.w3.org/hypertext/WWW/Addressing/Addressing.html">http://www.w3.org/hypertext/WWW/Addressing/Addressing.html</a>
+ <p><a name="index-URL_002c-definition-499"></a>See the URL <a href="http://www.w3.org/hypertext/WWW/Addressing/Addressing.html">http://www.w3.org/hypertext/WWW/Addressing/Addressing.html</a>
for a precise description of base URL's.
<p>Descriptions of the <code>\special</code>'s:
<dl>
-<dt>&lsquo;<samp><span class="samp">href</span></samp>&rsquo;<a name="index-href-497"></a><dd><a name="index-links_002c-hypertext-498"></a>Creates links in your TeX document. For example:
+<dt>&lsquo;<samp><span class="samp">href</span></samp>&rsquo;<a name="index-href-500"></a><dd><a name="index-links_002c-hypertext-501"></a>Creates links in your TeX document. For example:
<pre class="example"> \special{html:&lt;a href="http://www.tug.org/"&gt;}\TeX\ Users
Group\special{html:&lt;/a&gt;}
</pre>
@@ -2757,7 +2771,7 @@ Group' while running Xdvi and get to the TUG home page. (By the way,
this is for illustration. In practice, you most likely want to use
macros to insert the <code>\special</code> commands; reference above.)
- <br><dt>&lsquo;<samp><span class="samp">name</span></samp>&rsquo;<a name="index-name-499"></a><dd><a name="index-Anderson_002c-Laurie-500"></a>Defines URL targets in your TeX documents, so links can be
+ <br><dt>&lsquo;<samp><span class="samp">name</span></samp>&rsquo;<a name="index-name-502"></a><dd><a name="index-Anderson_002c-Laurie-503"></a>Defines URL targets in your TeX documents, so links can be
resolved. For example:
<pre class="example"> \special{html:&lt;a name="paradise"&gt;}Paradise\special{html:&lt;/a&gt;}
is exactly where you are right now.
@@ -2767,11 +2781,11 @@ change the catcode of &lsquo;<samp><span class="samp">#</span></samp>&rsquo;, et
existing macro packages which take care of all the details, such as
<samp><span class="file">hyperref</span></samp> for LaTeX. The <a href="http://arxiv.org/hypertex/">HyperTeX FAQ</a> has more information.
- <br><dt>&lsquo;<samp><span class="samp">img</span></samp>&rsquo;<a name="index-img-501"></a><dd><a name="index-mailcap-_0040r_007band-hypertext_007d-502"></a>Links to an arbitrary external file. Interactively, a viewer is spawned
+ <br><dt>&lsquo;<samp><span class="samp">img</span></samp>&rsquo;<a name="index-img-504"></a><dd><a name="index-mailcap-_0040r_007band-hypertext_007d-505"></a>Links to an arbitrary external file. Interactively, a viewer is spawned
to read the file according to the file extension and your <samp><span class="file">mailcap</span></samp>
file (see the Xdvi documentation).
- <br><dt>&lsquo;<samp><span class="samp">base</span></samp>&rsquo;<a name="index-base-503"></a><dd>Defines a base URL that is prepended to all the <code>name</code> targets.
+ <br><dt>&lsquo;<samp><span class="samp">base</span></samp>&rsquo;<a name="index-base-506"></a><dd>Defines a base URL that is prepended to all the <code>name</code> targets.
Typically unnecessary, as the name of the DVI file being read is used by
default.
</dl>
@@ -2780,8 +2794,8 @@ default.
the NeXTSTEP DVI viewer.
<div class="node">
-<p><hr>
<a name="PostScript-fonts"></a>
+<p><hr>
Next:&nbsp;<a rel="next" accesskey="n" href="#Color">Color</a>,
Previous:&nbsp;<a rel="previous" accesskey="p" href="#Interaction-with-PostScript">Interaction with PostScript</a>,
Up:&nbsp;<a rel="up" accesskey="u" href="#Top">Top</a>
@@ -2790,7 +2804,7 @@ Up:&nbsp;<a rel="up" accesskey="u" href="#Top">Top</a>
<h2 class="chapter">6 PostScript fonts</h2>
-<p><a name="index-PostScript-fonts-504"></a>
+<p><a name="index-PostScript-fonts-507"></a>
Dvips supports the use of PostScript fonts in TeX documents. To use
a PostScript font conveniently, you need to prepare a corresponding
virtual font; the program Afm2tfm, supplied with Dvips, helps
@@ -2812,8 +2826,8 @@ supplied with Dvips. (Or if you're curious.)
</ul>
<div class="node">
-<p><hr>
<a name="Font-concepts"></a>
+<p><hr>
Next:&nbsp;<a rel="next" accesskey="n" href="#Making-a-font-available">Making a font available</a>,
Up:&nbsp;<a rel="up" accesskey="u" href="#PostScript-fonts">PostScript fonts</a>
@@ -2821,7 +2835,7 @@ Up:&nbsp;<a rel="up" accesskey="u" href="#PostScript-fonts">PostScript fonts</a>
<h3 class="section">6.1 Font concepts</h3>
-<p><a name="index-font-concepts-505"></a>
+<p><a name="index-font-concepts-508"></a>
The information needed to typeset using a particular font is contained
in two files: a <dfn>metric file</dfn> that contains shape-independent
information and a <dfn>glyph file</dfn> that contains the actual shapes of
@@ -2844,8 +2858,8 @@ i.e., renumbers, the characters of a font.
</ul>
<div class="node">
-<p><hr>
<a name="Metric-files"></a>
+<p><hr>
Next:&nbsp;<a rel="next" accesskey="n" href="#Glyph-files">Glyph files</a>,
Up:&nbsp;<a rel="up" accesskey="u" href="#Font-concepts">Font concepts</a>
@@ -2853,7 +2867,7 @@ Up:&nbsp;<a rel="up" accesskey="u" href="#Font-concepts">Font concepts</a>
<h4 class="subsection">6.1.1 Metric files</h4>
-<p><a name="index-metric-files-506"></a>
+<p><a name="index-metric-files-509"></a>
A <dfn>metric file</dfn> describes properties of the font that are
independent of what the characters actually look like. Aside from
general information about the font itself, a metric file has two kinds
@@ -2863,7 +2877,7 @@ character code, and information about sequences of characters.
<p>The per-character information specifies the width, height, depth, and
italic correction of each character in the font. Any might be zero.
- <p><a name="index-kerning_002c-defined-507"></a><a name="index-ligature_002c-defined-508"></a>In addition to information on individual characters, the metric file
+ <p><a name="index-kerning_002c-defined-510"></a><a name="index-ligature_002c-defined-511"></a>In addition to information on individual characters, the metric file
specifies <dfn>kerning</dfn>, i.e., adding or removing space between
particular character pairs. It further specifies <dfn>ligature</dfn>
information: when a sequence of input characters should be typeset as a
@@ -2875,12 +2889,12 @@ the only common ligatures are fi, fl, ff, ffi, and ffl.)
<p>Different typesetting systems use different metric file formats:
<ul>
-<li><a name="index-afm-files-509"></a><a name="index-g_t_002eafm-_0040r_007bAdobe-metric-files_007d-510"></a>Each Postscript font has an <dfn>Adobe font metrics</dfn> (&lsquo;<samp><span class="samp">.afm</span></samp>&rsquo;)
+<li><a name="index-afm-files-512"></a><a name="index-g_t_002eafm-_0040r_007bAdobe-metric-files_007d-513"></a>Each Postscript font has an <dfn>Adobe font metrics</dfn> (&lsquo;<samp><span class="samp">.afm</span></samp>&rsquo;)
file. These files are plain text, so you can inspect them easily. You
can get AFM files for Adobe's fonts from
<a href="ftp://ftp.adobe.com/pub/adobe/Fonts/AFMs">ftp://ftp.adobe.com/pub/adobe/Fonts/AFMs</a>.
- <li><a name="index-tfm-files-511"></a><a name="index-g_t_002etfm-_0040r_007b_0040TeX_007b_007d-font-metric-files_007d-512"></a>TeX uses <dfn>TeX font metrics</dfn> (&lsquo;<samp><span class="samp">.tfm</span></samp>&rsquo;) files. When you say
+ <li><a name="index-tfm-files-514"></a><a name="index-g_t_002etfm-_0040r_007b_0040TeX_007b_007d-font-metric-files_007d-515"></a>TeX uses <dfn>TeX font metrics</dfn> (&lsquo;<samp><span class="samp">.tfm</span></samp>&rsquo;) files. When you say
&lsquo;<samp><span class="samp">\font = </span><var>font</var></samp>&rsquo; in your TeX document, TeX reads a file
named &lsquo;<samp><var>font</var><span class="samp">.tfm</span></samp>&rsquo;. (Well, except for the <samp><span class="file">texfonts.map</span></samp>
feature; see <a href="kpathsea.html#Fontmap">Fontmap</a>). TeX can then
@@ -2888,14 +2902,14 @@ calculate the space occupied by characters from the font when
typesetting. In addition, the DVI drivers you use to print or view the
DVI file produced by TeX may need to look at the TFM file.
- <p><a name="index-property-list-files-513"></a><a name="index-tftopl-514"></a><a name="index-pltotf-515"></a><a name="index-g_t_002epl-_0040r_007bproperty-list-files_007d-516"></a>TFM files are binary (and hence are typically much smaller than AFM
+ <p><a name="index-property-list-files-516"></a><a name="index-tftopl-517"></a><a name="index-pltotf-518"></a><a name="index-g_t_002epl-_0040r_007bproperty-list-files_007d-519"></a>TFM files are binary (and hence are typically much smaller than AFM
files). You can use the <code>tftopl</code> program (see <a href="web2c.html#tftopl-invocation">tftopl invocation</a>) that comes with TeX to transform a TFM
file into a human-readable &ldquo;property list&rdquo; (&lsquo;<samp><span class="samp">.pl</span></samp>&rsquo;) file. You can
also edit a PL file and transform it back to a TeX-readable TFM with
the companion program <code>pltotf</code> (see <a href="web2c.html#pltotf-invocation">pltotf invocation</a>). Editing metrics by hand is not something you're likely to want
to do often, but the capability is there.
- <li><a name="index-pfm-files-517"></a><a name="index-g_t_002epfm-_0040r_007bprinter-font-metric-files_007d-518"></a>ATM and other typesetting systems use <dfn>printer font metric</dfn>
+ <li><a name="index-pfm-files-520"></a><a name="index-g_t_002epfm-_0040r_007bprinter-font-metric-files_007d-521"></a>ATM and other typesetting systems use <dfn>printer font metric</dfn>
(&lsquo;<samp><span class="samp">.pfm</span></samp>&rsquo;) files. These are binary files. They are irrelevant in the
TeX world, and not freely available, so we will not discuss them
further.
@@ -2907,8 +2921,8 @@ to a TFM file and performs other useful transformations as well.
See <a href="#Invoking-afm2tfm">Invoking afm2tfm</a>.
<div class="node">
-<p><hr>
<a name="Glyph-files"></a>
+<p><hr>
Next:&nbsp;<a rel="next" accesskey="n" href="#Virtual-fonts">Virtual fonts</a>,
Previous:&nbsp;<a rel="previous" accesskey="p" href="#Metric-files">Metric files</a>,
Up:&nbsp;<a rel="up" accesskey="u" href="#Font-concepts">Font concepts</a>
@@ -2917,7 +2931,7 @@ Up:&nbsp;<a rel="up" accesskey="u" href="#Font-concepts">Font concepts</a>
<h4 class="subsection">6.1.2 Glyph files</h4>
-<p><a name="index-glyph-files-519"></a>
+<p><a name="index-glyph-files-522"></a>
Although a metric file (see the previous section) contains information
about the spatial and other properties of the character at position 75,
say, it contains nothing about what the character at position 75
@@ -2929,7 +2943,7 @@ know character shapes.
<p>A <dfn>glyph file</dfn> is a file that defines the shapes of the characters
in a font. The shapes can be defined either by outlines or by bitmaps.
- <p><a name="index-outline-fonts-520"></a><a name="index-arcs-521"></a><a name="index-splines-522"></a>PostScript fonts are defined as <dfn>outline fonts</dfn>: Each character in
+ <p><a name="index-outline-fonts-523"></a><a name="index-arcs-524"></a><a name="index-splines-525"></a>PostScript fonts are defined as <dfn>outline fonts</dfn>: Each character in
the font is defined by giving the mathematical curves (lines, arcs, and
splines) that define its contours. Different sizes of a character are
generated by linearly scaling a single shape. For example, a 10-point
@@ -2937,33 +2951,33 @@ generated by linearly scaling a single shape. For example, a 10-point
usually also contain <dfn>hints</dfn>&mdash;additional information to improve the
appearance of the font at small sizes or low resolutions.
- <p><a name="index-Type-1-fonts-523"></a><a name="index-pfa-files-524"></a><a name="index-pfb-files-525"></a><a name="index-g_t_002epfa-_0040r_007bprinter-font-ascii-files_007d-526"></a><a name="index-g_t_002epfb-_0040r_007bprinter-font-binary-files_007d-527"></a>Although various kinds of PostScript outline fonts exist, by far the
+ <p><a name="index-Type-1-fonts-526"></a><a name="index-pfa-files-527"></a><a name="index-pfb-files-528"></a><a name="index-g_t_002epfa-_0040r_007bprinter-font-ascii-files_007d-529"></a><a name="index-g_t_002epfb-_0040r_007bprinter-font-binary-files_007d-530"></a>Although various kinds of PostScript outline fonts exist, by far the
most common, and the only one we will consider, is called <dfn>Type 1</dfn>.
The glyph files for Postscript Type 1 fonts typically have names ending
in &lsquo;<samp><span class="samp">.pfa</span></samp>&rsquo; (&ldquo;printer font ASCII&rdquo;) or &lsquo;<samp><span class="samp">.pfb</span></samp>&rsquo; (&ldquo;printer font
binary&rdquo;).
- <p><a name="index-bitmap-fonts-528"></a><a name="index-g_t_002emf-_0040r_007bMetafont-source-files_007d-529"></a><a name="index-Metafont-source-files-530"></a>In contrast, glyph files for Computer Modern and the other standard
+ <p><a name="index-bitmap-fonts-531"></a><a name="index-g_t_002emf-_0040r_007bMetafont-source-files_007d-532"></a><a name="index-Metafont-source-files-533"></a>In contrast, glyph files for Computer Modern and the other standard
TeX fonts are <dfn>bitmap fonts</dfn>, generated from Metafont
(&lsquo;<samp><span class="samp">.mf</span></samp>&rsquo;) descriptions. The Metafont program distributed with TeX
generates bitmaps from these descriptions.
- <p><a name="index-pk-files-531"></a><a name="index-g_t_002e_0040var_007bnnn_007dpk-_0040r_007bpacked-font-bitmaps_007d-532"></a>The glyph files for TeX bitmap fonts are usually stored in
+ <p><a name="index-pk-files-534"></a><a name="index-g_t_002e_0040var_007bnnn_007dpk-_0040r_007bpacked-font-bitmaps_007d-535"></a>The glyph files for TeX bitmap fonts are usually stored in
<dfn>packed font</dfn> (PK) files. The names of these files end in
&lsquo;<samp><span class="samp">.</span><var>nnn</var><span class="samp">pk</span></samp>&rsquo;, where <var>nnn</var> is the resolution of the font in
dots per inch. For example, <samp><span class="file">cmr10.600pk</span></samp> contains the bitmaps for
the &lsquo;<samp><span class="samp">cmr10</span></samp>&rsquo; font at a resolution of 600<span class="dmn">dpi</span>. (On DOS
filesystems, it's more likely <samp><span class="file">dpi600\cmr10.pk</span></samp>.)
- <p><a name="index-gf-files-533"></a><a name="index-gftopk-534"></a>Metafont actually outputs <dfn>generic font</dfn> (GF) files, e.g.,
+ <p><a name="index-gf-files-536"></a><a name="index-gftopk-537"></a>Metafont actually outputs <dfn>generic font</dfn> (GF) files, e.g.,
<samp><span class="file">cmr10.600gf</span></samp>, but the GF files are usually converted immediately
to PK format (using the <code>gftopk</code> utility that comes with TeX)
since PK files are smaller and contain the same information. (The GF
format is a historical artifact.)
<div class="node">
-<p><hr>
<a name="Virtual-fonts"></a>
+<p><hr>
Next:&nbsp;<a rel="next" accesskey="n" href="#Encodings">Encodings</a>,
Previous:&nbsp;<a rel="previous" accesskey="p" href="#Glyph-files">Glyph files</a>,
Up:&nbsp;<a rel="up" accesskey="u" href="#Font-concepts">Font concepts</a>
@@ -2972,7 +2986,7 @@ Up:&nbsp;<a rel="up" accesskey="u" href="#Font-concepts">Font concepts</a>
<h4 class="subsection">6.1.3 Virtual fonts</h4>
-<p><a name="index-virtual-fonts-535"></a>
+<p><a name="index-virtual-fonts-538"></a>
A <dfn>virtual font</dfn> is constructed by extracting characters from one or
more existing fonts and rearranging them, or synthesizing new characters
in various ways. The explanation in this manual is intended to suffice
@@ -2984,13 +2998,13 @@ Wizards&rdquo; (<samp><var>CTAN:</var><span class="file">/info/virtual-fonts.knu
see <a href="kpathsea.html#unixtex_002eftp">unixtex.ftp</a>). (Don't be intimidated by
the subtitle.)
- <p><a name="index-vf-files-536"></a><a name="index-vpl-files-537"></a>A virtual font (&lsquo;<samp><span class="samp">.vf</span></samp>&rsquo;) file specifies, for each character in the
+ <p><a name="index-vf-files-539"></a><a name="index-vpl-files-540"></a>A virtual font (&lsquo;<samp><span class="samp">.vf</span></samp>&rsquo;) file specifies, for each character in the
virtual font, a recipe for typesetting that character. A VF file, like
a TFM file, is in a compressed binary format. The <code>vftovp</code> and
<code>vptovf</code> programs convert a VF file to a human-readable VPL
(virtual property list) format and back again. See <a href="web2c.html#vftovp-invocation">vftovp invocation</a>, and <a href="web2c.html#vptovf-invocation">vptovf invocation</a>.
- <p><a name="index-base-fonts-538"></a>In the case of a PostScript font <var>f</var> being used in a straightforward
+ <p><a name="index-base-fonts-541"></a>In the case of a PostScript font <var>f</var> being used in a straightforward
way, the recipe says: character <var>i</var> in the VF font is character
<var>j</var> in font <var>f</var>. The font <var>f</var> is called a <dfn>base font</dfn>.
For example, the VF file could remap the characters of the PostScript
@@ -3001,13 +3015,13 @@ See <a href="#Encodings">Encodings</a>.
corresponding TFM for use with TeX. This corresponding TFM is
created when you run <code>vptovf</code>.
- <p><a name="index-expansion_002c-of-virtual-fonts-539"></a><a name="index-virtual-font-expansion-540"></a>You can <dfn>expand</dfn> virtual fonts into their base fonts with DVIcopy
+ <p><a name="index-expansion_002c-of-virtual-fonts-542"></a><a name="index-virtual-font-expansion-543"></a>You can <dfn>expand</dfn> virtual fonts into their base fonts with DVIcopy
(see <a href="web2c.html#dvicopy-invocation">dvicopy invocation</a>). This is useful if you are
using a DVI translator that doesn't understand vf's itself.
<div class="node">
-<p><hr>
<a name="Encodings"></a>
+<p><hr>
Next:&nbsp;<a rel="next" accesskey="n" href="#PostScript-typesetting">PostScript typesetting</a>,
Previous:&nbsp;<a rel="previous" accesskey="p" href="#Virtual-fonts">Virtual fonts</a>,
Up:&nbsp;<a rel="up" accesskey="u" href="#Font-concepts">Font concepts</a>
@@ -3016,7 +3030,7 @@ Up:&nbsp;<a rel="up" accesskey="u" href="#Font-concepts">Font concepts</a>
<h4 class="subsection">6.1.4 Encodings</h4>
-<p><a name="index-encodings-541"></a>
+<p><a name="index-encodings-544"></a>
Every font, whatever its type, has an <dfn>encoding</dfn>, that specifies the
correspondence between &ldquo;logical&rdquo; characters and character codes. For
example, the ASCII encoding specifies that the character numbered 65
@@ -3026,7 +3040,7 @@ character at that position looks like; there are lots of ways to draw an
specify how much space that character occupies; that information is in a
metric file (see <a href="#Metric-files">Metric files</a>).
- <p><a name="index-Computer-Modern_002c-encoding-of-542"></a>TeX implicitly assumes a particular encoding for the fonts you use
+ <p><a name="index-Computer-Modern_002c-encoding-of-545"></a>TeX implicitly assumes a particular encoding for the fonts you use
with it. For example, the plain TeX macro <code>\'</code>, which typesets
an acute accent over the following letter, assumes the acute accent is
at position 19 (decimal). This happens to be true of standard TeX
@@ -3038,7 +3052,7 @@ particular character positions. A better solution is to create a new
font with the information for the acute accent at position 19, where
TeX expects it to be. See <a href="#Making-a-font-available">Making a font available</a>.
- <p><a name="index-PostScript-encoding-543"></a><a name="index-encoding-files-544"></a><a name="index-encoding-vectors_002c-defined-545"></a>
+ <p><a name="index-PostScript-encoding-546"></a><a name="index-encoding-files-547"></a><a name="index-encoding-vectors_002c-defined-548"></a>
PostScript represents encodings as a sequence of 256 character names
called an <dfn>encoding vector</dfn>. An <dfn>encoding file</dfn> (&lsquo;<samp><span class="samp">.enc</span></samp>&rsquo;)
gives such a vector, together with ligature and kerning information
@@ -3047,7 +3061,7 @@ are used by the Afm2tfm program. Encoding files are also downloaded to
the PostScript interpreter in your printer if you use one of them in
place of the default encoding vector for a particular PostScript font.
- <p><a name="index-dvips_002eenc-546"></a><a name="index-g_t8r_002eenc-547"></a><a name="index-texmext_002eenc-548"></a><a name="index-texmital_002eenc-549"></a><a name="index-texmsym_002eenc-550"></a><a name="index-reencode_002f_002a_002eenc-551"></a>Examples of encodings: the <samp><span class="file">dvips.enc</span></samp> encoding file that comes
+ <p><a name="index-dvips_002eenc-549"></a><a name="index-g_t8r_002eenc-550"></a><a name="index-texmext_002eenc-551"></a><a name="index-texmital_002eenc-552"></a><a name="index-texmsym_002eenc-553"></a><a name="index-reencode_002f_002a_002eenc-554"></a>Examples of encodings: the <samp><span class="file">dvips.enc</span></samp> encoding file that comes
with Dvips in the &lsquo;<samp><span class="samp">reencode</span></samp>&rsquo; directory is a good (but not perfect)
approximation to the TeX encoding for TeX's Computer Modern text
fonts. This is the encoding of the fonts that originated with Dvips,
@@ -3059,8 +3073,8 @@ TeX mathematics fonts: <samp><span class="file">texmext.enc</span></samp> for ma
symbols.
<div class="node">
-<p><hr>
<a name="PostScript-typesetting"></a>
+<p><hr>
Previous:&nbsp;<a rel="previous" accesskey="p" href="#Encodings">Encodings</a>,
Up:&nbsp;<a rel="up" accesskey="u" href="#Font-concepts">Font concepts</a>
@@ -3068,7 +3082,7 @@ Up:&nbsp;<a rel="up" accesskey="u" href="#Font-concepts">Font concepts</a>
<h4 class="subsection">6.1.5 How PostScript typesets a character</h4>
-<p><a name="index-typesetting-in-PostScript-552"></a><a name="index-character-lookup-procedure-in-PostScript-553"></a>
+<p><a name="index-typesetting-in-PostScript-555"></a><a name="index-character-lookup-procedure-in-PostScript-556"></a>
The output of Dvips is a program in the PostScript language that
instructs your (presumably PostScript-capable) printer how to typeset
your document by transforming it into toner on paper. Your printer, in
@@ -3087,7 +3101,7 @@ what character to typeset, with this mass of metrics, glyphs, encodings,
and other information. (If you're not wondering, skip this section
<small class="dots">...</small>)
- <p><a name="index-show-_0040r_007bPostScript-operator_007d-554"></a>The basic PostScript operator for imaging characters is
+ <p><a name="index-show-_0040r_007bPostScript-operator_007d-557"></a>The basic PostScript operator for imaging characters is
<code>show</code>. Suppose you've asked TeX to typeset an `S'. This will
eventually wind up in the Dvips output as the equivalent of this
PostScript operation:
@@ -3097,11 +3111,11 @@ PostScript operation:
<p class="noindent">Here is how PostScript typesets the `S':
<ol type=1 start=1>
-<li><a name="index-ASCII-character-codes_002c-used-by-PostScript-555"></a>PostScript interpreters use ASCII; therefore `S' is represented as the
+<li><a name="index-ASCII-character-codes_002c-used-by-PostScript-558"></a>PostScript interpreters use ASCII; therefore `S' is represented as the
integer 83. (Any of the 256 possible characters representable in a
standard 8-bit byte can be typeset.)
- <li><a name="index-current-font_002c-in-PostScript-556"></a><a name="index-dictionary_002c-PostScript-language-557"></a>A PostScript <dfn>dictionary</dfn> is a mapping of names to arbitrary values.
+ <li><a name="index-current-font_002c-in-PostScript-559"></a><a name="index-dictionary_002c-PostScript-language-560"></a>A PostScript <dfn>dictionary</dfn> is a mapping of names to arbitrary values.
A font, to the interpreter, is a dictionary which contains entries for
certain names. (If these entries are missing, the interpreter refuses
to do anything with that font.)
@@ -3109,18 +3123,18 @@ to do anything with that font.)
<p>PostScript has a notion of &ldquo;the current font&rdquo;&mdash;whatever font is
currently being typeset in.
- <li><a name="index-encoding-vectors_002c-in-Type-1-fonts-558"></a><a name="index-Encoding-_0040r_007bType-1-dictionary_007d-559"></a>One of the mandatory entries in a font dictionary is &lsquo;<samp><span class="samp">Encoding</span></samp>&rsquo;,
+ <li><a name="index-encoding-vectors_002c-in-Type-1-fonts-561"></a><a name="index-Encoding-_0040r_007bType-1-dictionary_007d-562"></a>One of the mandatory entries in a font dictionary is &lsquo;<samp><span class="samp">Encoding</span></samp>&rsquo;,
which defines the encoding vector (see <a href="#Encodings">Encodings</a>) for that font.
This vector of 256 names maps each possible input character to a name.
<li>The interpreter retrieves the entry at position 83 of the encoding
vector. This value is a PostScript name: <code>/S</code>.
- <li><a name="index-CharStrings-_0040r_007bType-1-dictionary_007d-560"></a><a name="index-dictionary_002c-_0040code_007bCharStrings_007d-561"></a>For Type 1 fonts (we're not going to discuss anything else), the
+ <li><a name="index-CharStrings-_0040r_007bType-1-dictionary_007d-563"></a><a name="index-dictionary_002c-_0040code_007bCharStrings_007d-564"></a>For Type 1 fonts (we're not going to discuss anything else), the
interpreter now looks up <code>/S</code> as a key in a dictionary named
<code>CharStrings</code>, another mandatory entry in a font dictionary.
- <li><a name="index-hints-562"></a><a name="index-character-definitions-in-PostScript-563"></a>The value of <code>S</code> in <code>CharStrings</code> is the equivalent of a
+ <li><a name="index-hints-565"></a><a name="index-character-definitions-in-PostScript-566"></a>The value of <code>S</code> in <code>CharStrings</code> is the equivalent of a
series of standard PostScript commands like &lsquo;<samp><span class="samp">curveto</span></samp>&rsquo;,
&lsquo;<samp><span class="samp">lineto</span></samp>&rsquo;, &lsquo;<samp><span class="samp">fill</span></samp>&rsquo;, and so on. These commands are executed to
draw the character. There can also be <dfn>hint information</dfn> that helps
@@ -3135,8 +3149,8 @@ standard PostScript source; see the Type 1 book for details.
information.
<div class="node">
-<p><hr>
<a name="Making-a-font-available"></a>
+<p><hr>
Next:&nbsp;<a rel="next" accesskey="n" href="#Invoking-afm2tfm">Invoking afm2tfm</a>,
Previous:&nbsp;<a rel="previous" accesskey="p" href="#Font-concepts">Font concepts</a>,
Up:&nbsp;<a rel="up" accesskey="u" href="#PostScript-fonts">PostScript fonts</a>
@@ -3145,7 +3159,7 @@ Up:&nbsp;<a rel="up" accesskey="u" href="#PostScript-fonts">PostScript fonts</a>
<h3 class="section">6.2 Making a PostScript font available</h3>
-<p><a name="index-installing-fonts-564"></a><a name="index-fonts_002c-installing-565"></a>
+<p><a name="index-installing-fonts-567"></a><a name="index-fonts_002c-installing-568"></a>
To make a PostScript font available in a TeX document, you need to
install the font on your system and then define it within the document.
Once you have installed the font, of course, it is available for any
@@ -3187,7 +3201,7 @@ from the VPL file:
<p>The simplest invocation of Afm2tfm to make virtual fonts goes something
like this:
- <p><a name="index-afm2tfm-566"></a>
+ <p><a name="index-afm2tfm-569"></a>
<pre class="example"> afm2tfm Times-Roman -v ptmr rptmr
</pre>
<p class="noindent">This reads the file <samp><span class="file">Times-Roman.afm</span></samp>, and produces two files as
@@ -3195,7 +3209,7 @@ output, namely the virtual property list'file <samp><span class="file">ptmr.vpl<
&ldquo;raw&rdquo; font metric file <samp><span class="file">rptmr.tfm</span></samp>. To use the font in TeX,
you first run
- <p><a name="index-vptovf-567"></a>
+ <p><a name="index-vptovf-570"></a>
<pre class="example"> vptovf ptmr.vpl ptmr.vf ptmr.tfm
</pre>
<p class="noindent">You should then install the virtual font file <samp><span class="file">ptmr.vf</span></samp> where Dvips
@@ -3249,15 +3263,15 @@ printer, so there's no need to download any Type 1 file for it. But if
you are actually following these instructions for new fonts, most likely
they are not built in to the printer.
- <p><a name="index-memory_002c-used-by-PostScript-fonts-568"></a><a name="index-efficiency_002c-and-fonts-569"></a>These PostScript fonts can be scaled to any size. Go wild! Using
+ <p><a name="index-memory_002c-used-by-PostScript-fonts-571"></a><a name="index-efficiency_002c-and-fonts-572"></a>These PostScript fonts can be scaled to any size. Go wild! Using
PostScript fonts, however, does use up a great deal of the printer's
memory and it does take time. You may find downloading bitmap fonts
(possibly compressed, with the &lsquo;<samp><span class="samp">Z</span></samp>&rsquo; option) to be faster than using
the built-in PostScript fonts.
<div class="node">
-<p><hr>
<a name="Invoking-afm2tfm"></a>
+<p><hr>
Next:&nbsp;<a rel="next" accesskey="n" href="#psfonts_002emap">psfonts.map</a>,
Previous:&nbsp;<a rel="previous" accesskey="p" href="#Making-a-font-available">Making a font available</a>,
Up:&nbsp;<a rel="up" accesskey="u" href="#PostScript-fonts">PostScript fonts</a>
@@ -3266,7 +3280,7 @@ Up:&nbsp;<a rel="up" accesskey="u" href="#PostScript-fonts">PostScript fonts</a>
<h3 class="section">6.3 Invoking Afm2tfm</h3>
-<p><a name="index-afm2tfm-570"></a>
+<p><a name="index-afm2tfm-573"></a>
The Afm2tfm program converts an AFM file for a PostScript font to a TFM
file and a VPL file for a corresponding virtual font (or, in its
simplest form, to a TFM file for the PostScript font itself). The
@@ -3274,7 +3288,7 @@ results of the conversion are affected by the command-line options and
especially by the reencodings you can specify with those options. You
can also obtain special effects such as an oblique font.
- <p><a name="index-fontinst-571"></a><a name="index-virtual-fonts_002c-creating-572"></a><a name="index-Jeffrey_002c-Alan-573"></a>An alternative to Afm2tfm for creating virtual fonts is Alan Jeffrey's
+ <p><a name="index-fontinst-574"></a><a name="index-virtual-fonts_002c-creating-575"></a><a name="index-Jeffrey_002c-Alan-576"></a>An alternative to Afm2tfm for creating virtual fonts is Alan Jeffrey's
<code>fontinst</code> program, available from
<samp><var>CTAN:</var><span class="file">fonts/utilities/fontinst</span></samp> (for CTAN info,
see <a href="kpathsea.html#unixtex_002eftp">unixtex.ftp</a>).
@@ -3286,8 +3300,8 @@ see <a href="kpathsea.html#unixtex_002eftp">unixtex.ftp</a>).
</ul>
<div class="node">
-<p><hr>
<a name="Changing-font-encodings"></a>
+<p><hr>
Next:&nbsp;<a rel="next" accesskey="n" href="#Special-font-effects">Special font effects</a>,
Up:&nbsp;<a rel="up" accesskey="u" href="#Invoking-afm2tfm">Invoking afm2tfm</a>
@@ -3295,7 +3309,7 @@ Up:&nbsp;<a rel="up" accesskey="u" href="#Invoking-afm2tfm">Invoking afm2tfm</a>
<h4 class="subsection">6.3.1 Changing font encodings</h4>
-<p><a name="index-encoding-changes-574"></a><a name="index-fonts_002c-changing-encoding-of-575"></a>
+<p><a name="index-encoding-changes-577"></a><a name="index-fonts_002c-changing-encoding-of-578"></a>
Afm2tfm allows you to specify a different encoding for a PostScript font
(for a general introduction to encodings, see <a href="#Encodings">Encodings</a>). The
&lsquo;<samp><span class="samp">-t</span></samp>&rsquo; option changes the TeX encoding, &lsquo;<samp><span class="samp">-p</span></samp>&rsquo; changes the
@@ -3311,8 +3325,8 @@ detailed in the sections below.
</ul>
<div class="node">
-<p><hr>
<a name="Changing-TeX-encodings"></a>
+<p><hr>
Next:&nbsp;<a rel="next" accesskey="n" href="#Changing-PostScript-encodings">Changing PostScript encodings</a>,
Up:&nbsp;<a rel="up" accesskey="u" href="#Changing-font-encodings">Changing font encodings</a>
@@ -3320,8 +3334,8 @@ Up:&nbsp;<a rel="up" accesskey="u" href="#Changing-font-encodings">Changing font
<h5 class="subsubsection">6.3.1.1 &lsquo;<samp><span class="samp">-t</span></samp>&rsquo;: Changing TeX encodings</h5>
-<p><a name="index-changing-_0040TeX_007b_007d-encodings-576"></a><a name="index-g_t_0040TeX_007b_007d-encoding_002c-changing-577"></a>
-<a name="index-g_t_002dt-_0040var_007btex_002denc_007d-578"></a>To build a virtual font with Afm2tfm, you specify the &lsquo;<samp><span class="samp">-v</span></samp>&rsquo; or
+<p><a name="index-changing-_0040TeX_007b_007d-encodings-579"></a><a name="index-g_t_0040TeX_007b_007d-encoding_002c-changing-580"></a>
+<a name="index-g_t_002dt-_0040var_007btex_002denc_007d-581"></a>To build a virtual font with Afm2tfm, you specify the &lsquo;<samp><span class="samp">-v</span></samp>&rsquo; or
&lsquo;<samp><span class="samp">-V</span></samp>&rsquo; option. You can then specify an encoding for that virtual font
with &lsquo;<samp><span class="samp">-t </span><var>tex-enc</var></samp>&rsquo;. (&lsquo;<samp><span class="samp">-t</span></samp>&rsquo; is ignored if neither
&lsquo;<samp><span class="samp">-v</span></samp>&rsquo; nor &lsquo;<samp><span class="samp">-V</span></samp>&rsquo; is present.) Any ligature and kerning
@@ -3331,7 +3345,7 @@ addition to the ligature and kerning information from the AFM file.
<p>If the AFM file has no entry for a character specified in <var>tex-enc</var>,
that character will be omitted from the output VPL.
- <p><a name="index-texmsym_002eenc-579"></a>The &lsquo;<samp><span class="samp">-t</span></samp>&rsquo; option is likely to be needed when you have a PostScript
+ <p><a name="index-texmsym_002eenc-582"></a>The &lsquo;<samp><span class="samp">-t</span></samp>&rsquo; option is likely to be needed when you have a PostScript
font corresponding to a TeX font other than a normal text font such
as Computer Modern. For instance, if you have a PostScript font that
contains math symbols, you'd probably want to use the encoding in the
@@ -3340,8 +3354,8 @@ get usable math fonts, you have to define much more than just an
encoding.)
<div class="node">
-<p><hr>
<a name="Changing-PostScript-encodings"></a>
+<p><hr>
Next:&nbsp;<a rel="next" accesskey="n" href="#Changing-both-encodings">Changing both encodings</a>,
Previous:&nbsp;<a rel="previous" accesskey="p" href="#Changing-TeX-encodings">Changing TeX encodings</a>,
Up:&nbsp;<a rel="up" accesskey="u" href="#Changing-font-encodings">Changing font encodings</a>
@@ -3350,7 +3364,7 @@ Up:&nbsp;<a rel="up" accesskey="u" href="#Changing-font-encodings">Changing font
<h5 class="subsubsection">6.3.1.2 &lsquo;<samp><span class="samp">-p</span></samp>&rsquo;: Changing PostScript encodings</h5>
-<p><a name="index-changing-PostScript-encodings-580"></a><a name="index-PostScript-encoding_002c-changing-581"></a><a name="index-g_t_002dp-_0040var_007bps_002denc_007d-582"></a>
+<p><a name="index-changing-PostScript-encodings-583"></a><a name="index-PostScript-encoding_002c-changing-584"></a><a name="index-g_t_002dp-_0040var_007bps_002denc_007d-585"></a>
By default, Afm2tfm uses the encoding it finds in the AFM file. You can
specify a different PostScript encoding with &lsquo;<samp><span class="samp">-p </span><var>ps-enc</var></samp>&rsquo;.
This makes the raw TFM file (the one output by Afm2tfm) have the
@@ -3363,18 +3377,18 @@ as part of any document that uses this font. You do this by adding a
line like the following one to <samp><span class="file">psfonts.map</span></samp> (see <a href="#psfonts_002emap">psfonts.map</a>):
<pre class="example"> zpopr Optima "MyEncoding ReEncodeFont" &lt;myenc.enc
</pre>
- <p><a name="index-trademark-_0040r_007bcharacter_002c-accessing_007d-583"></a><a name="index-registered-_0040r_007bcharacter_002c-accessing_007d-584"></a><a name="index-extra-characters_002c-accessing-585"></a>Using &lsquo;<samp><span class="samp">-p</span></samp>&rsquo; is the only way to access characters in a PostScript
+ <p><a name="index-trademark-_0040r_007bcharacter_002c-accessing_007d-586"></a><a name="index-registered-_0040r_007bcharacter_002c-accessing_007d-587"></a><a name="index-extra-characters_002c-accessing-588"></a>Using &lsquo;<samp><span class="samp">-p</span></samp>&rsquo; is the only way to access characters in a PostScript
font that are neither encoded in the AFM file nor constructed from other
characters. For instance, Adobe's &lsquo;<samp><span class="samp">Times-Roman</span></samp>&rsquo; font contains the
extra characters &lsquo;<samp><span class="samp">trademark</span></samp>&rsquo; and &lsquo;<samp><span class="samp">registered</span></samp>&rsquo; (among others);
these can only be accessed through such a PostScript reencoding.
- <p><a name="index-g_t8r-_0040r_007bencoding_002c-and-extra-characters_007d-586"></a>The `8r' base encoding used for the current PostScript font
+ <p><a name="index-g_t8r-_0040r_007bencoding_002c-and-extra-characters_007d-589"></a>The `8r' base encoding used for the current PostScript font
distribution does do this reencoding, for precisely this reason.
<div class="node">
-<p><hr>
<a name="Changing-both-encodings"></a>
+<p><hr>
Next:&nbsp;<a rel="next" accesskey="n" href="#Reencoding-with-Afm2tfm">Reencoding with Afm2tfm</a>,
Previous:&nbsp;<a rel="previous" accesskey="p" href="#Changing-PostScript-encodings">Changing PostScript encodings</a>,
Up:&nbsp;<a rel="up" accesskey="u" href="#Changing-font-encodings">Changing font encodings</a>
@@ -3383,7 +3397,7 @@ Up:&nbsp;<a rel="up" accesskey="u" href="#Changing-font-encodings">Changing font
<h5 class="subsubsection">6.3.1.3 &lsquo;<samp><span class="samp">-T</span></samp>&rsquo;: Changing both TeX and PostScript encodings</h5>
-<p><a name="index-g_t_002dT-_0040var_007benc_002dfile_007d-587"></a>
+<p><a name="index-g_t_002dT-_0040var_007benc_002dfile_007d-590"></a>
The option &lsquo;<samp><span class="samp">-T </span><var>enc-file</var></samp>&rsquo; is equivalent to &lsquo;<samp><span class="samp">-p
</span><var>enc-file</var><span class="samp"> -t </span><var>enc-file</var></samp>&rsquo;. If you make regular use of a private
non-standard reencoding &lsquo;<samp><span class="samp">-T</span></samp>&rsquo; is usually a better idea than the
@@ -3393,8 +3407,8 @@ font: when you have a TeX encoding that is designed to be used with a
particular PostScript font.
<div class="node">
-<p><hr>
<a name="Reencoding-with-Afm2tfm"></a>
+<p><hr>
Next:&nbsp;<a rel="next" accesskey="n" href="#Encoding-file-format">Encoding file format</a>,
Previous:&nbsp;<a rel="previous" accesskey="p" href="#Changing-both-encodings">Changing both encodings</a>,
Up:&nbsp;<a rel="up" accesskey="u" href="#Changing-font-encodings">Changing font encodings</a>
@@ -3403,7 +3417,7 @@ Up:&nbsp;<a rel="up" accesskey="u" href="#Changing-font-encodings">Changing font
<h5 class="subsubsection">6.3.1.4 Reencoding with Afm2tfm</h5>
-<p><a name="index-reencoding-588"></a><a name="index-remapping-589"></a>
+<p><a name="index-reencoding-591"></a><a name="index-remapping-592"></a>
The Afm2tfm program creates the TFM and VF files for the virtual font
corresponding to a PostScript font by <dfn>reencoding</dfn> the PostScript
font. Afm2tfm generates these files from two encodings: one for TeX
@@ -3430,7 +3444,7 @@ then yielding the corresponding number.) The combined mapping of 19 to
that the properties of PostScript character 194 appear in position 19 of
the TFM file for the virtual font.
- <p><a name="index-accents_002c-in-wrong-position-590"></a><a name="index-Hungarian-umlaut-591"></a><a name="index-dot-accent-592"></a><a name="index-Scandinavian-A-ring-593"></a><a name="index-A-ring_002c-Scandinavian-letter-594"></a>The default encoding of the distributed fonts (e.g., <samp><span class="file">ptmr.tfm</span></samp>)
+ <p><a name="index-accents_002c-in-wrong-position-593"></a><a name="index-Hungarian-umlaut-594"></a><a name="index-dot-accent-595"></a><a name="index-Scandinavian-A-ring-596"></a><a name="index-A-ring_002c-Scandinavian-letter-597"></a>The default encoding of the distributed fonts (e.g., <samp><span class="file">ptmr.tfm</span></samp>)
mostly follows plain TeX conventions for accents. The exceptions:
the Hungarian umlaut (which is at position <code>0x7D</code> in &lsquo;<samp><span class="samp">cmr10</span></samp>&rsquo;,
but position <code>0xCD</code> in &lsquo;<samp><span class="samp">ptmr</span></samp>&rsquo;); the dot accent (at positions
@@ -3442,7 +3456,7 @@ following definitions. These definitions will not work with the
Computer Modern fonts for the relevant accents. They are already part
of the distributed <samp><span class="file">psfonts.sty</span></samp> for use with LaTeX.
- <p><a name="index-g_t_005cH-595"></a><a name="index-g_t_005c_002e-596"></a><a name="index-g_t_005cdot-597"></a><a name="index-g_t_005cAA-598"></a>
+ <p><a name="index-g_t_005cH-598"></a><a name="index-g_t_005c_002e-599"></a><a name="index-g_t_005cdot-600"></a><a name="index-g_t_005cAA-601"></a>
<pre class="example"> \def\H#1{{\accent"CD #1}}
\def\.#1{{\accent"C7 #1}}
\def\dot{\mathaccent"70C7 }
@@ -3451,7 +3465,7 @@ of the distributed <samp><span class="file">psfonts.sty</span></samp> for use wi
\advance\aadimen-1ex\setbox0\hbox{A}\rlap{\raise.67\aadimen
\hbox to \wd0{\hss\char'27\hss}}A}
</pre>
- <p><a name="index-CODINGSCHEME-599"></a>As a kind of summary, here are the &lsquo;<samp><span class="samp">CODINGSCHEME</span></samp>&rsquo;s that result from
+ <p><a name="index-CODINGSCHEME-602"></a>As a kind of summary, here are the &lsquo;<samp><span class="samp">CODINGSCHEME</span></samp>&rsquo;s that result from
the various possible choices for reencoding.
<dl>
@@ -3473,8 +3487,8 @@ the various possible choices for reencoding.
ignored by Dvips.
<div class="node">
-<p><hr>
<a name="Encoding-file-format"></a>
+<p><hr>
Previous:&nbsp;<a rel="previous" accesskey="p" href="#Reencoding-with-Afm2tfm">Reencoding with Afm2tfm</a>,
Up:&nbsp;<a rel="up" accesskey="u" href="#Changing-font-encodings">Changing font encodings</a>
@@ -3482,7 +3496,7 @@ Up:&nbsp;<a rel="up" accesskey="u" href="#Changing-font-encodings">Changing font
<h5 class="subsubsection">6.3.1.5 Encoding file format</h5>
-<p><a name="index-encoding-file-format-600"></a>
+<p><a name="index-encoding-file-format-603"></a>
Afm2tfm's encoding files have the same format as an encoding vector in a
PostScript font. Here is a skeletal example:
@@ -3497,7 +3511,7 @@ PostScript font. Here is a skeletal example:
<p>These encoding files are downloaded as part of changing the encoding at
the PostScript level (see the previous section).
- <p><a name="index-comments_002c-in-encoding-files-601"></a>Comments, which start with a percent sign and continue until the end
+ <p><a name="index-comments_002c-in-encoding-files-604"></a>Comments, which start with a percent sign and continue until the end
of the line, are ignored unless they start with &lsquo;<samp><span class="samp">LIGKERN</span></samp>&rsquo; (see below).
<p>The first non-comment word of the file must start with a forward slash
@@ -3515,11 +3529,11 @@ kern information is given in groups of words: each group is terminated
by a space and a semicolon and (unless the semicolon is at the end of a
line) another space.
- <p><a name="index-LIGKERN-_0040r_007bencoding-file-command_007d-602"></a>In these <code>LIGKERN</code> statements, three types of information may be
+ <p><a name="index-LIGKERN-_0040r_007bencoding-file-command_007d-605"></a>In these <code>LIGKERN</code> statements, three types of information may be
specified. These three types are ligature pairs, kerns to ignore, and
the character value of this font's boundary character.
- <p><a name="index-boundary-character-603"></a>Throughout a <code>LIGKERN</code> statement, the boundary character is
+ <p><a name="index-boundary-character-606"></a>Throughout a <code>LIGKERN</code> statement, the boundary character is
specified as &lsquo;<samp><span class="samp">||</span></samp>&rsquo;. To set the font's boundary character value for
TeX:
@@ -3533,12 +3547,12 @@ particular location. Either or both of the character names can be given
as &lsquo;<samp><span class="samp">*</span></samp>&rsquo;, which is a wild card matching any character; thus, all
kerns can be removed with &lsquo;<samp><span class="samp">* {} * ;</span></samp>&rsquo;.
- <p><a name="index-ligature-operations-604"></a><a name="index-Metafont-ligature-operations-605"></a>To specify a ligature, specify the names of the pair of characters,
+ <p><a name="index-ligature-operations-607"></a><a name="index-Metafont-ligature-operations-608"></a>To specify a ligature, specify the names of the pair of characters,
followed by the ligature operation (as in Metafont), followed by the
replacing character name. Either (but not both) of the first two
characters can be &lsquo;<samp><span class="samp">||</span></samp>&rsquo; to indicate a word boundary.
- <p><a name="index-g_t_003d_003a-_0040r_007bligature-operation_007d-606"></a>The most common operation is &lsquo;<samp><span class="samp">=:</span></samp>&rsquo; meaning that both characters are
+ <p><a name="index-g_t_003d_003a-_0040r_007bligature-operation_007d-609"></a>The most common operation is &lsquo;<samp><span class="samp">=:</span></samp>&rsquo; meaning that both characters are
removed and replaced by the third character, but by adding the &lsquo;<samp><span class="samp">|</span></samp>&rsquo;
character on either side of the &lsquo;<samp><span class="samp">=:</span></samp>&rsquo;, you can retain either or both
of the two leading characters. In addition, by suffixing the ligature
@@ -3567,8 +3581,8 @@ operation, so there are a total of eight possibilities:
% LIGKERN 7 {} * ; * {} 7 ; 8 {} * ; * {} 8 ; 9 {} * ; * {} 9 ;
</pre>
<div class="node">
-<p><hr>
<a name="Special-font-effects"></a>
+<p><hr>
Next:&nbsp;<a rel="next" accesskey="n" href="#Afm2tfm-options">Afm2tfm options</a>,
Previous:&nbsp;<a rel="previous" accesskey="p" href="#Changing-font-encodings">Changing font encodings</a>,
Up:&nbsp;<a rel="up" accesskey="u" href="#Invoking-afm2tfm">Invoking afm2tfm</a>
@@ -3577,7 +3591,7 @@ Up:&nbsp;<a rel="up" accesskey="u" href="#Invoking-afm2tfm">Invoking afm2tfm</a>
<h4 class="subsection">6.3.2 Special font effects</h4>
-<p><a name="index-oblique-fonts-607"></a><a name="index-slanted-fonts-608"></a><a name="index-fonts_002c-slanted-609"></a>Besides the reencodings described in the previous section, Afm2tfm can
+<p><a name="index-oblique-fonts-610"></a><a name="index-slanted-fonts-611"></a><a name="index-fonts_002c-slanted-612"></a>Besides the reencodings described in the previous section, Afm2tfm can
do other manipulations. (Again, it's best to use the prebuilt fonts
rather than attempting to remake them.)
@@ -3588,26 +3602,26 @@ rather than attempting to remake them.)
<p class="noindent">This creates <samp><span class="file">ptmro.vpl</span></samp> and <samp><span class="file">rptmro.tfm</span></samp>. To use this font,
put the line
- <p><a name="index-SlantFont-610"></a>
+ <p><a name="index-SlantFont-613"></a>
<pre class="example"> rptmro Times-Roman ".167 SlantFont"
</pre>
- <p class="noindent"><a name="index-psfonts_002emap-611"></a>into <samp><span class="file">psfonts.map</span></samp>. Then &lsquo;<samp><span class="samp">rptmro</span></samp>&rsquo; (our name for the obliqued
+ <p class="noindent"><a name="index-psfonts_002emap-614"></a>into <samp><span class="file">psfonts.map</span></samp>. Then &lsquo;<samp><span class="samp">rptmro</span></samp>&rsquo; (our name for the obliqued
Times) will act as if it were a resident font, although it is actually
constructed from Times-Roman via the PostScript routine <code>SlantFont</code>
(which will slant everything 1/6 to the right, in this case).
- <p><a name="index-expanded-fonts-612"></a><a name="index-fonts_002c-expanded-613"></a>Similarly, you can get an expanded font with
+ <p><a name="index-expanded-fonts-615"></a><a name="index-fonts_002c-expanded-616"></a>Similarly, you can get an expanded font with
<pre class="example"> afm2tfm Times-Roman -e 1.2 -v ptmrre rptmrre
</pre>
<p class="noindent">and by recording the pseudo-resident font
-<a name="index-ExtendFont-614"></a>
+<a name="index-ExtendFont-617"></a>
<pre class="example"> rptmrre Times-Roman "1.2 ExtendFont"
</pre>
<p class="noindent">in <samp><span class="file">psfonts.map</span></samp>.
<p>You can also create a small caps font with a command such as
-<a name="index-small-caps-fonts-615"></a><a name="index-fonts_002c-small-caps-616"></a>
+<a name="index-small-caps-fonts-618"></a><a name="index-fonts_002c-small-caps-619"></a>
<pre class="example"> afm2tfm Times-Roman -V ptmrc rptmrc
</pre>
<p class="noindent">This will generate a set of pseudo-small caps mapped into the usual
@@ -3622,7 +3636,7 @@ independently of the rest of the font. If you want a really
professional looking set of small caps, you need to acquire a small caps
font.
- <p><a name="index-PaintType-617"></a><a name="index-outline-fonts-618"></a><a name="index-fonts_002c-outlined-619"></a>To change the <code>PaintType</code> in a font from filled (0) to outlined
+ <p><a name="index-PaintType-620"></a><a name="index-outline-fonts-621"></a><a name="index-fonts_002c-outlined-622"></a>To change the <code>PaintType</code> in a font from filled (0) to outlined
(2), you can add <code>"/PaintType 2 store"</code> to <samp><span class="file">psfonts.map</span></samp>, as
in the following:
@@ -3637,8 +3651,8 @@ even though many different fonts (small caps variants, or ones with
different output encodings) may be based on it.
<div class="node">
-<p><hr>
<a name="Afm2tfm-options"></a>
+<p><hr>
Previous:&nbsp;<a rel="previous" accesskey="p" href="#Special-font-effects">Special font effects</a>,
Up:&nbsp;<a rel="up" accesskey="u" href="#Invoking-afm2tfm">Invoking afm2tfm</a>
@@ -3646,7 +3660,7 @@ Up:&nbsp;<a rel="up" accesskey="u" href="#Invoking-afm2tfm">Invoking afm2tfm</a>
<h4 class="subsection">6.3.3 Afm2tfm options</h4>
-<p><a name="index-options_002c-to-Afm2tfm-620"></a><a name="index-afm2tfm-options-621"></a>
+<p><a name="index-options_002c-to-Afm2tfm-623"></a><a name="index-afm2tfm-options-624"></a>
Synopsis:
<pre class="example"> afm2tfm [<var>option</var>]... <var>afmfile</var>[.afm] [<var>tfmfile</var>[.tfm]]
</pre>
@@ -3658,7 +3672,7 @@ extended with &lsquo;<samp><span class="samp">.tfm</span></samp>&rsquo; to get t
<pre class="example"> afm2tfm Times-Roman rptmr
</pre>
- <p><a name="index-accents_002c-wrong-622"></a>The TFM file thus created is <dfn>raw</dfn> because it omits ligature and
+ <p><a name="index-accents_002c-wrong-625"></a>The TFM file thus created is <dfn>raw</dfn> because it omits ligature and
kern information, and does no character remapping; it simply contains
the character information in the AFM file in TFM form, which is the form
that TeX understands. The characters have the same code in the TFM
@@ -3674,49 +3688,49 @@ See <a href="#Making-a-font-available">Making a font available</a>.
<p>The command line options to Afm2tfm:
<dl>
-<dt>&lsquo;<samp><span class="samp">-c </span><var>ratio</var></samp>&rsquo;<dd><a name="index-g_t_002dc-_0040var_007bratio_007d-623"></a><a name="index-scaling-small-caps-624"></a>See &lsquo;<samp><span class="samp">-V</span></samp>&rsquo;; overrides the default ratio of 0.8 for the
+<dt>&lsquo;<samp><span class="samp">-c </span><var>ratio</var></samp>&rsquo;<dd><a name="index-g_t_002dc-_0040var_007bratio_007d-626"></a><a name="index-scaling-small-caps-627"></a>See &lsquo;<samp><span class="samp">-V</span></samp>&rsquo;; overrides the default ratio of 0.8 for the
scaling of small caps.
- <br><dt>&lsquo;<samp><span class="samp">-e </span><var>ratio</var></samp>&rsquo;<dd><a name="index-g_t_002de-_0040var_007bratio_007d-625"></a><a name="index-expanded-fonts-626"></a><a name="index-condensed-fonts-627"></a>Stretch characters horizontally by <var>ratio</var>; if less than 1.0, you
+ <br><dt>&lsquo;<samp><span class="samp">-e </span><var>ratio</var></samp>&rsquo;<dd><a name="index-g_t_002de-_0040var_007bratio_007d-628"></a><a name="index-expanded-fonts-629"></a><a name="index-condensed-fonts-630"></a>Stretch characters horizontally by <var>ratio</var>; if less than 1.0, you
get a condensed font.
- <br><dt>&lsquo;<samp><span class="samp">-O</span></samp>&rsquo;<dd><a name="index-g_t_002dO-628"></a><a name="index-octal-character-codes-629"></a>Output all character codes in the &lsquo;<samp><span class="samp">vpl</span></samp>&rsquo; file as octal numbers, not
+ <br><dt>&lsquo;<samp><span class="samp">-O</span></samp>&rsquo;<dd><a name="index-g_t_002dO-631"></a><a name="index-octal-character-codes-632"></a>Output all character codes in the &lsquo;<samp><span class="samp">vpl</span></samp>&rsquo; file as octal numbers, not
names; this is useful for symbol or other special-purpose fonts where
character names such as &lsquo;<samp><span class="samp">A</span></samp>&rsquo; have no meaning.
- <br><dt>&lsquo;<samp><span class="samp">-p </span><var>ps-enc</var></samp>&rsquo;<dd><a name="index-g_t_002dp-_0040var_007bps_002denc_007d-630"></a>Use <var>ps-enc</var> for the destination (PostScript) encoding of the font;
+ <br><dt>&lsquo;<samp><span class="samp">-p </span><var>ps-enc</var></samp>&rsquo;<dd><a name="index-g_t_002dp-_0040var_007bps_002denc_007d-633"></a>Use <var>ps-enc</var> for the destination (PostScript) encoding of the font;
<var>ps-enc</var> must be mentioned as a header file for the font in
&lsquo;<samp><span class="samp">psfonts.map</span></samp>&rsquo;.
See <a href="#Changing-PostScript-encodings">Changing PostScript encodings</a>.
- <br><dt>&lsquo;<samp><span class="samp">-s </span><var>slant</var></samp>&rsquo;<dd><a name="index-g_t_002ds-_0040var_007bslant_007d-631"></a><a name="index-slanted-fonts_002c-making-632"></a>Slant characters to the right by <var>slant</var>. If <var>slant</var> is
+ <br><dt>&lsquo;<samp><span class="samp">-s </span><var>slant</var></samp>&rsquo;<dd><a name="index-g_t_002ds-_0040var_007bslant_007d-634"></a><a name="index-slanted-fonts_002c-making-635"></a>Slant characters to the right by <var>slant</var>. If <var>slant</var> is
negative, the letters slope to the left (or they might be upright if you
start with an italic font).
- <br><dt>&lsquo;<samp><span class="samp">-t </span><var>tex-enc</var></samp>&rsquo;<dd><a name="index-g_t_002dt-_0040var_007btex_002denc_007d-633"></a>Use <var>tex-enc</var> for the target (TeX) encoding of the font.
+ <br><dt>&lsquo;<samp><span class="samp">-t </span><var>tex-enc</var></samp>&rsquo;<dd><a name="index-g_t_002dt-_0040var_007btex_002denc_007d-636"></a>Use <var>tex-enc</var> for the target (TeX) encoding of the font.
Ligature and kern information may also be specified in <var>file</var>.
<var>file</var> is not mentioned in <samp><span class="file">psfonts.map</span></samp>.
- <br><dt>&lsquo;<samp><span class="samp">-T </span><var>ps-tex-enc</var></samp>&rsquo;<dd><a name="index-g_t_002dT-_0040var_007bps_002dtex_002denc_007d-634"></a>Use <var>ps-tex-enc</var> for both the PostScript and target TeX encodings
+ <br><dt>&lsquo;<samp><span class="samp">-T </span><var>ps-tex-enc</var></samp>&rsquo;<dd><a name="index-g_t_002dT-_0040var_007bps_002dtex_002denc_007d-637"></a>Use <var>ps-tex-enc</var> for both the PostScript and target TeX encodings
of the font. Equivalent to &lsquo;<samp><span class="samp">-p </span><var>file</var><span class="samp"> -t </span><var>file</var></samp>&rsquo;.
- <br><dt>&lsquo;<samp><span class="samp">-u</span></samp>&rsquo;<dd><a name="index-g_t_002du-635"></a>Use only those characters specified in the TeX encoding, and no
+ <br><dt>&lsquo;<samp><span class="samp">-u</span></samp>&rsquo;<dd><a name="index-g_t_002du-638"></a>Use only those characters specified in the TeX encoding, and no
others. By default, Afm2tfm tries to include all characters in the
input font, even those not present in the TeX encoding (it puts them
into otherwise-unused positions, arbitrarily).
- <br><dt>&lsquo;<samp><span class="samp">-v </span><var>vpl-file</var></samp>&rsquo;<dd><a name="index-g_t_002dv-_0040var_007bvpl_002dfile_007d-636"></a>Output a VPL (virtual property list) file, as well as a TFM file.
+ <br><dt>&lsquo;<samp><span class="samp">-v </span><var>vpl-file</var></samp>&rsquo;<dd><a name="index-g_t_002dv-_0040var_007bvpl_002dfile_007d-639"></a>Output a VPL (virtual property list) file, as well as a TFM file.
- <br><dt>&lsquo;<samp><span class="samp">-V </span><var>vpl-file</var></samp>&rsquo;<dd><a name="index-g_t_002dV-_0040var_007bvpl_002dfile_007d-637"></a>Same as &lsquo;<samp><span class="samp">-v</span></samp>&rsquo;, but the virtual font generated is a pseudo small caps
+ <br><dt>&lsquo;<samp><span class="samp">-V </span><var>vpl-file</var></samp>&rsquo;<dd><a name="index-g_t_002dV-_0040var_007bvpl_002dfile_007d-640"></a>Same as &lsquo;<samp><span class="samp">-v</span></samp>&rsquo;, but the virtual font generated is a pseudo small caps
font obtained by scaling uppercase letters by 0.8 to typeset
lowercase. This font handles accented letters and retains proper
kerning.
</dl>
<div class="node">
-<p><hr>
<a name="psfonts.map"></a>
<a name="psfonts_002emap"></a>
+<p><hr>
Previous:&nbsp;<a rel="previous" accesskey="p" href="#Invoking-afm2tfm">Invoking afm2tfm</a>,
Up:&nbsp;<a rel="up" accesskey="u" href="#PostScript-fonts">PostScript fonts</a>
@@ -3724,70 +3738,68 @@ Up:&nbsp;<a rel="up" accesskey="u" href="#PostScript-fonts">PostScript fonts</a>
<h3 class="section">6.4 <samp><span class="file">psfonts.map</span></samp>: PostScript font catalog</h3>
-<p><a name="index-psfonts_002emap-638"></a><a name="index-non_002dresident-fonts-639"></a><a name="index-downloading-PostScript-fonts-640"></a><a name="index-fonts_002c-downloading-641"></a>
+<p><a name="index-psfonts_002emap-641"></a><a name="index-non_002dresident-fonts-642"></a><a name="index-downloading-PostScript-fonts-643"></a><a name="index-fonts_002c-downloading-644"></a>
The <samp><span class="file">psfonts.map</span></samp> file associates a PostScript font with related
files and constructs. Each line has the format:
<pre class="example"> <var>filename</var> <var>PostScript-name</var> <var>options</var>
</pre>
- <p><a name="index-g_t_003c-_0040r_007bfont-downloading_007d-642"></a>For example, the line
+ <p><a name="index-g_t_003c-_0040r_007bfont-downloading_007d-645"></a>For example, the line
<pre class="example"> rpstrn StoneInformal &lt;StoneInformal.pfb
</pre>
- <p class="noindent">causes Dvips to download <samp><span class="file">StoneInformal.pfb</span></samp> if your document (just
-as if it were a header file, see <a href="#Header-files">Header files</a>) uses the font
-&lsquo;<samp><span class="samp">StoneInformal</span></samp>&rsquo;.
+ <p class="noindent">causes Dvips to download <samp><span class="file">StoneInformal.pfb</span></samp> (just as if it were
+a header file, see <a href="#Header-files">Header files</a>) if the DVI file (or a virtual
+font, see <a href="#Virtual-fonts">Virtual fonts</a>) references the TFM file &lsquo;<samp><span class="samp">rpstrn</span></samp>&rsquo;.
+The PostScript <code>/FontName</code> of the font defined inside the &lsquo;<samp><span class="samp">pfb</span></samp>&rsquo;
+file should be <code>StoneInformal</code>.
- <p><a name="index-partial-font-downloading-643"></a><a name="index-downloading-fonts-partially-644"></a>If the &lsquo;<samp><span class="samp">j</span></samp>&rsquo; config file or command-line option is enabled,
-<samp><span class="file">StoneInformal.pfb</span></samp> will be <dfn>partially downloaded</dfn>&mdash;only those
-characters your document actually uses will be extracted and downloaded,
-and the remainder discarded. See <a href="#Option-details">Option details</a>.
-
- <p>Filenames of fonts that are partially downloaded are surrounded by curly
-braces (&lsquo;<samp><span class="samp">{...}</span></samp>&rsquo;) in the progress report Dvips writes to
-standard output. Wholly-downloaded fonts appear inside angle brackets
-(&lsquo;<samp><span class="samp">&lt;...&gt;</span></samp>&rsquo;), like other downloaded files.
-
- <p><a name="index-whole-font-downloading-645"></a><a name="index-multiple-master-fonts-646"></a><a name="index-Minion-typeface-family-647"></a><a name="index-g_t_003c_003c-_0040r_007bwhole-font-downloading_007d-648"></a>Adobe Multiple Master fonts, such as Minion, cannot be partially
-downloaded. To partially download in general, but avoid partial
-downloading for individual fonts, use &lsquo;<samp><span class="samp">&lt;&lt;</span></samp>&rsquo; instead &lsquo;<samp><span class="samp">&lt;</span></samp>&rsquo;:
-<pre class="example"> pmnr8r Minion &lt;&lt;Minion.pfb
-</pre>
- <p><a name="index-transforming-downloaded-fonts-649"></a><a name="index-expanded-fonts-650"></a><a name="index-wide-fonts-651"></a><a name="index-narrow-fonts-652"></a>You can generate transformed fonts with a line like this:
+ <p><a name="index-transforming-downloaded-fonts-646"></a><a name="index-expanded-fonts-647"></a><a name="index-wide-fonts-648"></a><a name="index-narrow-fonts-649"></a>You can generate transformed fonts with a line like this:
<pre class="example"> rpstrc StoneInformal &lt;StoneInformal.pfb ".8 ExtendFont"
</pre>
<p class="noindent">See <a href="#Special-font-effects">Special font effects</a>, for a
complete list of font effects.
- <p><a name="index-reencoding-PostScript-fonts-653"></a>You can change the encoding of the Type 1 font at the PostScript
+ <p><a name="index-reencoding-PostScript-fonts-650"></a>You can change the encoding of the Type 1 font at the PostScript
level with a &lsquo;<samp><span class="samp">ReEncodeFont</span></samp>&rsquo; instruction, plus the name of the
encoding file. This allows you access to characters that may be present
in the Type 1 font file, but not encoded by default&mdash;most of the
preaccented characters, for example. An example:
<pre class="smallexample"> pstrn8r StoneInformal "TeXBase1Encoding ReEncodeFont" &lt;8r.enc &lt;pstrn8a.pfb
</pre>
- <p><a name="index-g_t8r-font-encoding-654"></a><a name="index-base-encoding_002c-recommended-655"></a>The &lsquo;<samp><span class="samp">8r</span></samp>&rsquo; encoding mentioned here has been designed to serve as a
+ <p><a name="index-g_t8r-font-encoding-651"></a><a name="index-base-encoding_002c-recommended-652"></a>The &lsquo;<samp><span class="samp">8r</span></samp>&rsquo; encoding mentioned here has been designed to serve as a
base for all downloadable fonts; it allows access to all the characters
commonly present in a Type 1 font. For more details, see the
<samp><span class="file">8r.enc</span></samp> source file that comes with (and is installed with) Dvips.
- <p><a name="index-g_t_003c_005b-_0040r_007bencoding-vector-downloading_007d-656"></a>You may notice that the same syntax is used for downloading encoding
+ <p><a name="index-g_t_003c_005b-_0040r_007bencoding-vector-downloading_007d-653"></a>You may notice that the same syntax is used for downloading encoding
vectors and Type 1 font files. To make your intentions clear, you can
also use &lsquo;<samp><span class="samp">&lt;[</span></samp>&rsquo; to explicitly indicate you are downloading an
encoding vector, as in:
<pre class="smallexample"> pstrn8r StoneInformal "TeXBase1Encoding ReEncodeFont" &lt;[8r.enc &lt;pstrn8a.pfb
</pre>
- <p><a name="index-g_t_002eenc-_0040r_007bextension-for-encoding-vectors_007d-657"></a>If the filename of your encoding vector does not end in &lsquo;<samp><span class="samp">.enc</span></samp>&rsquo;, and
+ <p><a name="index-g_t_002eenc-_0040r_007bextension-for-encoding-vectors_007d-654"></a>If the filename of your encoding vector does not end in &lsquo;<samp><span class="samp">.enc</span></samp>&rsquo;, and
you are using partial font downloading, you must use the &lsquo;<samp><span class="samp">&lt;[</span></samp>&rsquo;
syntax, or Dvips will not download the font properly.
- <p><a name="index-g_t_002epfa-_0040r_007bextension-required-for-partial-downloading_007d-658"></a><a name="index-g_t_002epfb-_0040r_007bextension-required-for-partial-downloading_007d-659"></a>Similarly, the name of the Type 1 font file itself must have extension
+ <p><a name="index-g_t_002epfa-_0040r_007bextension-required-for-partial-downloading_007d-655"></a><a name="index-g_t_002epfb-_0040r_007bextension-required-for-partial-downloading_007d-656"></a>Similarly, the name of the Type 1 font file itself must have extension
<samp><span class="file">.pfa</span></samp> or <samp><span class="file">.pfb</span></samp> for partial downloading to work properly.
- <p><a name="index-pfb-files_002c-automatically-unpacked-660"></a>When using PFB files, Dvips is smart enough to unpack the binary PFB
+ <p><a name="index-pfb-files_002c-automatically-unpacked-657"></a>When using PFB files, Dvips is smart enough to unpack the binary PFB
format into printable ASCII so there is no need to perform this
conversion yourself. In addition, Dvips scans the font to determine its
memory usage, just as it does for other header files (see <a href="#Header-files">Header files</a>).
+ <p><a name="index-partial-font-downloading-658"></a><a name="index-downloading-fonts-partially-659"></a>If the &lsquo;<samp><span class="samp">j</span></samp>&rsquo; config file or command-line option is enabled (as it
+is by default), <samp><span class="file">StoneInformal.pfb</span></samp> will be <dfn>partially
+downloaded</dfn>&mdash;only those characters your document actually uses will
+be extracted and downloaded, and the remainder discarded.
+See <a href="#Option-details">Option details</a>.
+
+ <p><a name="index-whole-font-downloading-660"></a><a name="index-multiple-master-fonts-661"></a><a name="index-Minion-typeface-family-662"></a><a name="index-g_t_003c_003c-_0040r_007bwhole-font-downloading_007d-663"></a>Adobe Multiple Master fonts, such as Minion, cannot be partially
+downloaded. To partially download in general, but avoid partial
+downloading for individual fonts, use &lsquo;<samp><span class="samp">&lt;&lt;</span></samp>&rsquo; instead &lsquo;<samp><span class="samp">&lt;</span></samp>&rsquo;:
+<pre class="example"> pmnr8r Minion &lt;&lt;Minion.pfb
+</pre>
<p>Here is a brief summary of how <samp><span class="file">psfonts.map</span></samp> is read:
<ol type=1 start=1>
@@ -3818,16 +3830,17 @@ code used in generating that font, and is inserted into the output
verbatim at the appropriate point. (And the double quotes beginning and
ending the word are removed.)
- <li>Otherwise the word is a name. The first such name is the TFM file that
-a virtual font file can refer to. If there is a second name, it is used
-as the PostScript name; if there is only one name, it is used for both
-the TeX name and the PostScript name.
+ <li>Otherwise the word is a name. The first such name is the TFM
+file, that either a DVI file or a virtual font file can refer to. If
+there is a second name, it is used as the PostScript name and should
+match what is defined in the downloaded file; if there is only one
+name, it is used for both the TeX name and the PostScript name.
</ol>
<div class="node">
-<p><hr>
<a name="Color"></a>
+<p><hr>
Next:&nbsp;<a rel="next" accesskey="n" href="#Index">Index</a>,
Previous:&nbsp;<a rel="previous" accesskey="p" href="#PostScript-fonts">PostScript fonts</a>,
Up:&nbsp;<a rel="up" accesskey="u" href="#Top">Top</a>
@@ -3836,8 +3849,8 @@ Up:&nbsp;<a rel="up" accesskey="u" href="#Top">Top</a>
<h2 class="chapter">7 Color</h2>
-<p><a name="index-color-661"></a>
-<a name="index-Hafner_002c-Jim-662"></a>Dvips supports one-pass multi-color printing of TeX documents on any
+<p><a name="index-color-664"></a>
+<a name="index-Hafner_002c-Jim-665"></a>Dvips supports one-pass multi-color printing of TeX documents on any
color PostScript device. Initially added by Jim Hafner, IBM Research,
<a href="mailto:hafner@almaden.ibm.com">hafner@almaden.ibm.com</a>, the color support has gone through many
changes by Tomas Rokicki. Besides the source code support itself, there
@@ -3859,8 +3872,8 @@ for the TeX administrator.
</ul>
<div class="node">
-<p><hr>
<a name="Color-macro-files"></a>
+<p><hr>
Next:&nbsp;<a rel="next" accesskey="n" href="#User_002ddefinable-colors">User-definable colors</a>,
Up:&nbsp;<a rel="up" accesskey="u" href="#Color">Color</a>
@@ -3868,7 +3881,7 @@ Up:&nbsp;<a rel="up" accesskey="u" href="#Color">Color</a>
<h3 class="section">7.1 Color macro files</h3>
-<p><a name="index-macros-for-color-663"></a><a name="index-color-macros-664"></a>
+<p><a name="index-macros-for-color-666"></a><a name="index-color-macros-667"></a>
All the color macro commands are defined in &lsquo;<samp><span class="samp">colordvi.tex</span></samp>&rsquo; (or
&lsquo;<samp><span class="samp">colordvi.sty</span></samp>&rsquo;). To access these macros simply add to the top of
your plain TeX file the command:
@@ -3882,7 +3895,7 @@ the documentation for the graphics package, available from
<samp><var>CTAN</var><span class="file">:doc/latex/graphics/</span></samp>. See also
<samp><var>CTAN</var><span class="file">:doc/epslatex.ps</span></samp>.
- <p><a name="index-Crayola-crayon-box-665"></a><a name="index-Pantone-colors-666"></a><a name="index-color-names_002c-mixed-case-667"></a>These macros provide two basic kinds of color macros: ones for local
+ <p><a name="index-Crayola-crayon-box-668"></a><a name="index-Pantone-colors-669"></a><a name="index-color-names_002c-mixed-case-670"></a>These macros provide two basic kinds of color macros: ones for local
color changes (a few words, a single symbol) and one for global color
changes (the whole document). All the color names use a mixed case
scheme to avoid conflicts with other macros. There are 68 predefined
@@ -3897,7 +3910,7 @@ and Pantones.
<pre class="example"> \<var>ColorName</var>{this is the color <var>ColorName</var>}
</pre>
- <p><a name="index-g_t_005c_0040var_007bColorName_007d-668"></a>where <var>ColorName</var> is the name of a predefined color, e.g.,
+ <p><a name="index-g_t_005c_0040var_007bColorName_007d-671"></a>where <var>ColorName</var> is the name of a predefined color, e.g.,
&lsquo;<samp><span class="samp">Blue</span></samp>&rsquo;. As shown, these macros take one argument, the text to
print in the specified color. This can be used for nested color changes
since it restores the original color state when it completes. For
@@ -3906,14 +3919,14 @@ example:
<pre class="example"> This text is normal but here we are \Red{switching to red,
\Blue{nesting blue}, recovering the red} and back to original.
</pre>
- <p class="noindent"><a name="index-color-nesting-level-669"></a>The color nesting level has no hard limit, but it is not advisable to
+ <p class="noindent"><a name="index-color-nesting-level-672"></a>The color nesting level has no hard limit, but it is not advisable to
nest too deeply lest you and the reader lose track of the color history.
<p>The global color command has the form
<pre class="example"> \text<var>ColorName</var>
</pre>
- <p class="noindent"><a name="index-g_t_005ctext_0040var_007bColorName_007d-670"></a>These macros take no arguments and changes the default color from that
+ <p class="noindent"><a name="index-g_t_005ctext_0040var_007bColorName_007d-673"></a>These macros take no arguments and changes the default color from that
point on to <var>ColorName</var>. This of course can be overridden globally
by another such command or locally by local color commands. For example,
expanding on the example above, we might have
@@ -3941,9 +3954,9 @@ which might have a larger range. This is primarily to keep the TeX
and LaTeX use compatible.
<div class="node">
-<p><hr>
<a name="User-definable-colors"></a>
<a name="User_002ddefinable-colors"></a>
+<p><hr>
Next:&nbsp;<a rel="next" accesskey="n" href="#Color-subtleties">Color subtleties</a>,
Previous:&nbsp;<a rel="previous" accesskey="p" href="#Color-macro-files">Color macro files</a>,
Up:&nbsp;<a rel="up" accesskey="u" href="#Color">Color</a>
@@ -3952,7 +3965,7 @@ Up:&nbsp;<a rel="up" accesskey="u" href="#Color">Color</a>
<h3 class="section">7.2 User-definable colors</h3>
-<p><a name="index-user_002ddefinable-colors-671"></a><a name="index-colors_002c-user_002ddefinable-672"></a>
+<p><a name="index-user_002ddefinable-colors-674"></a><a name="index-colors_002c-user_002ddefinable-675"></a>
There are two ways for the user to specify colors not already defined.
For local changes, there is the command <code>\Color</code> which takes two
arguments. The first argument is four numbers between zero and one and
@@ -3979,8 +3992,8 @@ highly discouraged. Consequently, Dvips will give you warning message
and do its best to recover by discarding the current color history.
<div class="node">
-<p><hr>
<a name="Color-subtleties"></a>
+<p><hr>
Next:&nbsp;<a rel="next" accesskey="n" href="#Ted-Turner">Ted Turner</a>,
Previous:&nbsp;<a rel="previous" accesskey="p" href="#User_002ddefinable-colors">User-definable colors</a>,
Up:&nbsp;<a rel="up" accesskey="u" href="#Color">Color</a>
@@ -3989,7 +4002,7 @@ Up:&nbsp;<a rel="up" accesskey="u" href="#Color">Color</a>
<h3 class="section">7.3 Color subtleties</h3>
-<p><a name="index-color-subtleties-673"></a>
+<p><a name="index-color-subtleties-676"></a>
Color macros are defined via <code>\special</code> keywords. As such, they
are put in the &lsquo;<samp><span class="samp">.dvi</span></samp>&rsquo; file only as explicit message strings to the
driver. The (unpleasant) result is that certain unprotected regions of
@@ -4020,8 +4033,8 @@ in horizontal mode before the first special command is issued; this can
be done by prefixing the color command with <code>\leavevmode</code>.
<div class="node">
-<p><hr>
<a name="Ted-Turner"></a>
+<p><hr>
Next:&nbsp;<a rel="next" accesskey="n" href="#Color-device-configuration">Color device configuration</a>,
Previous:&nbsp;<a rel="previous" accesskey="p" href="#Color-subtleties">Color subtleties</a>,
Up:&nbsp;<a rel="up" accesskey="u" href="#Color">Color</a>
@@ -4048,8 +4061,8 @@ Hopefully, in the future screen previewers for color displays will be
compatible with some form of color support.
<div class="node">
-<p><hr>
<a name="Color-device-configuration"></a>
+<p><hr>
Next:&nbsp;<a rel="next" accesskey="n" href="#Color-support-details">Color support details</a>,
Previous:&nbsp;<a rel="previous" accesskey="p" href="#Ted-Turner">Ted Turner</a>,
Up:&nbsp;<a rel="up" accesskey="u" href="#Color">Color</a>
@@ -4058,7 +4071,7 @@ Up:&nbsp;<a rel="up" accesskey="u" href="#Color">Color</a>
<h3 class="section">7.5 Color device configuration</h3>
-<p><a name="index-color-configuration-674"></a><a name="index-configuration_002c-of-color-devices-675"></a>
+<p><a name="index-color-configuration-677"></a><a name="index-configuration_002c-of-color-devices-678"></a>
To configure Dvips for a particular color device you need to fine tune
the color parameters to match your device's color rendition. To do this,
you will need a Pantone chart for your device. The header file
@@ -4071,7 +4084,7 @@ interpreter) the PostScript commands &lsquo;<samp><span class="samp">setcmykcolo
&lsquo;<samp><span class="samp">currentcmykcolor</span></samp>&rsquo; in terms of a RGB equivalent so if your device
only understands RGB, there should be no problem.
- <p><a name="index-Phaser-printer_002c-used-for-color-calibration-676"></a><a name="index-Tektronix-Phaser-printer_002c-used-for-color-calibration-677"></a>The parameters set in this file were determined by comparing the Pantone
+ <p><a name="index-Phaser-printer_002c-used-for-color-calibration-679"></a><a name="index-Tektronix-Phaser-printer_002c-used-for-color-calibration-680"></a>The parameters set in this file were determined by comparing the Pantone
chart of a Tektronix Phaser printer with the actual Crayola Crayons.
Because these were defined for a particular device, the actual color
rendition on your device may be very different. There are two ways to
@@ -4106,8 +4119,8 @@ your device, find the CMYK values for Pantone 109. Let's say they are
predefine other colors for your users.
<div class="node">
-<p><hr>
<a name="Color-support-details"></a>
+<p><hr>
Previous:&nbsp;<a rel="previous" accesskey="p" href="#Color-device-configuration">Color device configuration</a>,
Up:&nbsp;<a rel="up" accesskey="u" href="#Color">Color</a>
@@ -4125,8 +4138,8 @@ specials start with the keyword &lsquo;<samp><span class="samp">color</span></sa
</ul>
<div class="node">
-<p><hr>
<a name="Color-specifications"></a>
+<p><hr>
Next:&nbsp;<a rel="next" accesskey="n" href="#Color-specials">Color specials</a>,
Up:&nbsp;<a rel="up" accesskey="u" href="#Color-support-details">Color support details</a>
@@ -4134,7 +4147,7 @@ Up:&nbsp;<a rel="up" accesskey="u" href="#Color-support-details">Color support d
<h4 class="subsection">7.6.1 Color specifications</h4>
-<p><a name="index-color-specifications-678"></a>
+<p><a name="index-color-specifications-681"></a>
What is a color specification? One of three things. First, it might be
a PostScript procedure as defined in a PostScript header file. The
<samp><span class="file">color.pro</span></samp> file defines 64 of these, including &lsquo;<samp><span class="samp">Maroon</span></samp>&rsquo;.
@@ -4160,8 +4173,8 @@ from the output. For instance, the color specification
pattern (assuming such exists.)
<div class="node">
-<p><hr>
<a name="Color-specials"></a>
+<p><hr>
Previous:&nbsp;<a rel="previous" accesskey="p" href="#Color-specifications">Color specifications</a>,
Up:&nbsp;<a rel="up" accesskey="u" href="#Color-support-details">Color support details</a>
@@ -4208,8 +4221,8 @@ This may be addressed in the future by adding support for different
categories of color-like state.
<div class="node">
-<p><hr>
<a name="Index"></a>
+<p><hr>
Previous:&nbsp;<a rel="previous" accesskey="p" href="#Color">Color</a>,
Up:&nbsp;<a rel="up" accesskey="u" href="#Top">Top</a>
@@ -4218,18 +4231,18 @@ Up:&nbsp;<a rel="up" accesskey="u" href="#Top">Top</a>
<h2 class="unnumbered">Index</h2>
<ul class="index-cp" compact>
-<li><a href="#index-g_t_0021-_0040r_007bspecial-_0028literal-PS-header_0029_007d-451"><code>! </code><span class="roman">special (literal PS header)</span></a>: <a href="#Literal-headers">Literal headers</a></li>
+<li><a href="#index-g_t_0021-_0040r_007bspecial-_0028literal-PS-header_0029_007d-454"><code>! </code><span class="roman">special (literal PS header)</span></a>: <a href="#Literal-headers">Literal headers</a></li>
<li><a href="#index-g_t_0021-_0040r_007bstarting-output-filename_007d-176"><code>! </code><span class="roman">starting output filename</span></a>: <a href="#Option-details">Option details</a></li>
-<li><a href="#index-g_t_0022-_0040r_007bspecial-_0028literal-PostScript_0029_007d-444"><code>" </code><span class="roman">special (literal PostScript)</span></a>: <a href="#g_t_0022-special">&quot; special</a></li>
-<li><a href="#index-g_t_0025_0025BoundingBox-357"><code>%%BoundingBox</code></a>: <a href="#Bounding-box">Bounding box</a></li>
-<li><a href="#index-g_t_0025_0025Page_0040r_007b_002c-and-multi_002dpage-information_007d-461"><code>%%Page</code><span class="roman">, and multi-page information</span></a>: <a href="#PostScript-hooks">PostScript hooks</a></li>
+<li><a href="#index-g_t_0022-_0040r_007bspecial-_0028literal-PostScript_0029_007d-447"><code>" </code><span class="roman">special (literal PostScript)</span></a>: <a href="#g_t_0022-special">&quot; special</a></li>
+<li><a href="#index-g_t_0025_0025BoundingBox-360"><code>%%BoundingBox</code></a>: <a href="#Bounding-box">Bounding box</a></li>
+<li><a href="#index-g_t_0025_0025Page_0040r_007b_002c-and-multi_002dpage-information_007d-464"><code>%%Page</code><span class="roman">, and multi-page information</span></a>: <a href="#PostScript-hooks">PostScript hooks</a></li>
<li><a href="#index-g_t_0025_0025Page_0040r_007b_002c-not-generating_007d-168"><code>%%Page</code><span class="roman">, not generating</span></a>: <a href="#Option-details">Option details</a></li>
<li><a href="#index-g_t_0025_0025Page_0040r_007b_002c-removing_007d-144"><code>%%Page</code><span class="roman">, removing</span></a>: <a href="#Option-details">Option details</a></li>
<li><a href="#index-g_t_0025_0025Page_0040r_007b_002c-required-by-Ghostview_007d-45"><code>%%Page</code><span class="roman">, required by Ghostview</span></a>: <a href="#Ghostscript-installation">Ghostscript installation</a></li>
-<li><a href="#index-g_t_0025_0025VMusage-441"><code>%%VMusage</code></a>: <a href="#Headers-and-memory-usage">Headers and memory usage</a></li>
-<li><a href="#index-g_t_0025_002aFont-413"><code>%*Font</code></a>: <a href="#Fonts-in-figures">Fonts in figures</a></li>
-<li><a href="#index-g_t_0028atend_0029_0040r_007b_002c-bounding-box-specification_007d-359"><code>(atend)</code><span class="roman">, bounding box specification</span></a>: <a href="#Bounding-box">Bounding box</a></li>
-<li><a href="#index-g_t_002b_0040var_007bpsmapfile_007d-298"><code>+</code><var>psmapfile</var></a>: <a href="#Configuration-file-commands">Configuration file commands</a></li>
+<li><a href="#index-g_t_0025_0025VMusage-444"><code>%%VMusage</code></a>: <a href="#Headers-and-memory-usage">Headers and memory usage</a></li>
+<li><a href="#index-g_t_0025_002aFont-416"><code>%*Font</code></a>: <a href="#Fonts-in-figures">Fonts in figures</a></li>
+<li><a href="#index-g_t_0028atend_0029_0040r_007b_002c-bounding-box-specification_007d-362"><code>(atend)</code><span class="roman">, bounding box specification</span></a>: <a href="#Bounding-box">Bounding box</a></li>
+<li><a href="#index-g_t_002b_0040var_007bpsmapfile_007d-299"><code>+</code><var>psmapfile</var></a>: <a href="#Configuration-file-commands">Configuration file commands</a></li>
<li><a href="#index-g_t_002d-83"><code>-</code></a>: <a href="#Option-details">Option details</a></li>
<li><a href="#index-g_t_002d-_0040r_007bas-output-filename_007d-175"><code>- </code><span class="roman">as output filename</span></a>: <a href="#Option-details">Option details</a></li>
<li><a href="#index-g_t_002d_002dhelp-86"><code>--help</code></a>: <a href="#Option-details">Option details</a></li>
@@ -4241,12 +4254,12 @@ Up:&nbsp;<a rel="up" accesskey="u" href="#Top">Top</a>
<li><a href="#index-g_t_002db-_0040var_007bnum_007d-92"><code>-b </code><var>num</var></a>: <a href="#Option-details">Option details</a></li>
<li><a href="#index-g_t_002dC-_0040var_007bnum_007d-103"><code>-C </code><var>num</var></a>: <a href="#Option-details">Option details</a></li>
<li><a href="#index-g_t_002dc-_0040var_007bnum_007d-99"><code>-c </code><var>num</var></a>: <a href="#Option-details">Option details</a></li>
-<li><a href="#index-g_t_002dc-_0040var_007bratio_007d-623"><code>-c </code><var>ratio</var></a>: <a href="#Afm2tfm-options">Afm2tfm options</a></li>
+<li><a href="#index-g_t_002dc-_0040var_007bratio_007d-626"><code>-c </code><var>ratio</var></a>: <a href="#Afm2tfm-options">Afm2tfm options</a></li>
<li><a href="#index-g_t_002dD-_0040var_007bnum_007d-108"><code>-D </code><var>num</var></a>: <a href="#Option-details">Option details</a></li>
<li><a href="#index-g_t_002dd-_0040var_007bnum_007d-106"><code>-d </code><var>num</var></a>: <a href="#Option-details">Option details</a></li>
<li><a href="#index-g_t_002dE-114"><code>-E</code></a>: <a href="#Option-details">Option details</a></li>
<li><a href="#index-g_t_002de-_0040var_007bnum_007d-110"><code>-e </code><var>num</var></a>: <a href="#Option-details">Option details</a></li>
-<li><a href="#index-g_t_002de-_0040var_007bratio_007d-625"><code>-e </code><var>ratio</var></a>: <a href="#Afm2tfm-options">Afm2tfm options</a></li>
+<li><a href="#index-g_t_002de-_0040var_007bratio_007d-628"><code>-e </code><var>ratio</var></a>: <a href="#Afm2tfm-options">Afm2tfm options</a></li>
<li><a href="#index-g_t_002dF-123"><code>-F</code></a>: <a href="#Option-details">Option details</a></li>
<li><a href="#index-g_t_002df-118"><code>-f</code></a>: <a href="#Option-details">Option details</a></li>
<li><a href="#index-g_t_002dG-128"><code>-G</code></a>: <a href="#Option-details">Option details</a></li>
@@ -4263,13 +4276,13 @@ Up:&nbsp;<a rel="up" accesskey="u" href="#Top">Top</a>
<li><a href="#index-g_t_002dN-165"><code>-N</code></a>: <a href="#Option-details">Option details</a></li>
<li><a href="#index-g_t_002dn-_0040var_007bnum_007d-162"><code>-n </code><var>num</var></a>: <a href="#Option-details">Option details</a></li>
<li><a href="#index-g_t_002dnoomega-169"><code>-noomega</code></a>: <a href="#Option-details">Option details</a></li>
-<li><a href="#index-g_t_002dO-628"><code>-O</code></a>: <a href="#Afm2tfm-options">Afm2tfm options</a></li>
+<li><a href="#index-g_t_002dO-631"><code>-O</code></a>: <a href="#Afm2tfm-options">Afm2tfm options</a></li>
<li><a href="#index-g_t_002do-_0040var_007bname_007d-171"><code>-o </code><var>name</var></a>: <a href="#Option-details">Option details</a></li>
<li><a href="#index-g_t_002dO-_0040var_007bx_002doffset_007d_002c_0040var_007by_002doffset_007d-180"><code>-O </code><var>x-offset</var><code>,</code><var>y-offset</var></a>: <a href="#Option-details">Option details</a></li>
<li><a href="#index-g_t_002dp-_005b_003d_005d_0040var_007bnum_007d-185"><code>-p [=]</code><var>num</var></a>: <a href="#Option-details">Option details</a></li>
<li><a href="#index-g_t_002dP-_0040var_007bprinter_007d-193"><code>-P </code><var>printer</var></a>: <a href="#Option-details">Option details</a></li>
-<li><a href="#index-g_t_002dp-_0040var_007bps_002denc_007d-630"><code>-p </code><var>ps-enc</var></a>: <a href="#Afm2tfm-options">Afm2tfm options</a></li>
-<li><a href="#index-g_t_002dp-_0040var_007bps_002denc_007d-582"><code>-p </code><var>ps-enc</var></a>: <a href="#Changing-PostScript-encodings">Changing PostScript encodings</a></li>
+<li><a href="#index-g_t_002dp-_0040var_007bps_002denc_007d-633"><code>-p </code><var>ps-enc</var></a>: <a href="#Afm2tfm-options">Afm2tfm options</a></li>
+<li><a href="#index-g_t_002dp-_0040var_007bps_002denc_007d-585"><code>-p </code><var>ps-enc</var></a>: <a href="#Changing-PostScript-encodings">Changing PostScript encodings</a></li>
<li><a href="#index-g_t_002dpp-_0040var_007bfirst_007d_002d_0040var_007blast_007d-190"><code>-pp </code><var>first</var><code>-</code><var>last</var></a>: <a href="#Option-details">Option details</a></li>
<li><a href="#index-g_t_002dpp-_0040var_007brange_007d-192"><code>-pp </code><var>range</var></a>: <a href="#Option-details">Option details</a></li>
<li><a href="#index-g_t_002dP_0040var_007bprinter_007d_0040r_007b_002c-and-config-file-searching_007d-263"><code>-P</code><var>printer</var><span class="roman">, and config file searching</span></a>: <a href="#Configuration-file-searching">Configuration file searching</a></li>
@@ -4278,397 +4291,399 @@ Up:&nbsp;<a rel="up" accesskey="u" href="#Top">Top</a>
<li><a href="#index-g_t_002dr-199"><code>-r</code></a>: <a href="#Option-details">Option details</a></li>
<li><a href="#index-g_t_002ds-206"><code>-s</code></a>: <a href="#Option-details">Option details</a></li>
<li><a href="#index-g_t_002dS-_0040var_007bnum_007d-208"><code>-S </code><var>num</var></a>: <a href="#Option-details">Option details</a></li>
-<li><a href="#index-g_t_002ds-_0040var_007bslant_007d-631"><code>-s </code><var>slant</var></a>: <a href="#Afm2tfm-options">Afm2tfm options</a></li>
-<li><a href="#index-g_t_002dT-_0040var_007benc_002dfile_007d-587"><code>-T </code><var>enc-file</var></a>: <a href="#Changing-both-encodings">Changing both encodings</a></li>
+<li><a href="#index-g_t_002ds-_0040var_007bslant_007d-634"><code>-s </code><var>slant</var></a>: <a href="#Afm2tfm-options">Afm2tfm options</a></li>
+<li><a href="#index-g_t_002dT-_0040var_007benc_002dfile_007d-590"><code>-T </code><var>enc-file</var></a>: <a href="#Changing-both-encodings">Changing both encodings</a></li>
<li><a href="#index-g_t_002dT-_0040var_007bhsize_007d_002c_0040var_007bvsize_007d-219"><code>-T </code><var>hsize</var><code>,</code><var>vsize</var></a>: <a href="#Option-details">Option details</a></li>
<li><a href="#index-g_t_002dt-_0040var_007bpapertype_007d-209"><code>-t </code><var>papertype</var></a>: <a href="#Option-details">Option details</a></li>
-<li><a href="#index-g_t_002dT-_0040var_007bps_002dtex_002denc_007d-634"><code>-T </code><var>ps-tex-enc</var></a>: <a href="#Afm2tfm-options">Afm2tfm options</a></li>
-<li><a href="#index-g_t_002dt-_0040var_007btex_002denc_007d-633"><code>-t </code><var>tex-enc</var></a>: <a href="#Afm2tfm-options">Afm2tfm options</a></li>
-<li><a href="#index-g_t_002dt-_0040var_007btex_002denc_007d-578"><code>-t </code><var>tex-enc</var></a>: <a href="#Changing-TeX-encodings">Changing TeX encodings</a></li>
-<li><a href="#index-g_t_002du-635"><code>-u</code></a>: <a href="#Afm2tfm-options">Afm2tfm options</a></li>
+<li><a href="#index-g_t_002dT-_0040var_007bps_002dtex_002denc_007d-637"><code>-T </code><var>ps-tex-enc</var></a>: <a href="#Afm2tfm-options">Afm2tfm options</a></li>
+<li><a href="#index-g_t_002dt-_0040var_007btex_002denc_007d-636"><code>-t </code><var>tex-enc</var></a>: <a href="#Afm2tfm-options">Afm2tfm options</a></li>
+<li><a href="#index-g_t_002dt-_0040var_007btex_002denc_007d-581"><code>-t </code><var>tex-enc</var></a>: <a href="#Changing-TeX-encodings">Changing TeX encodings</a></li>
+<li><a href="#index-g_t_002du-638"><code>-u</code></a>: <a href="#Afm2tfm-options">Afm2tfm options</a></li>
<li><a href="#index-g_t_002dU-223"><code>-U</code></a>: <a href="#Option-details">Option details</a></li>
<li><a href="#index-g_t_002du-_0040var_007bpsmapfile_007d-220"><code>-u </code><var>psmapfile</var></a>: <a href="#Option-details">Option details</a></li>
<li><a href="#index-g_t_002dV-226"><code>-V</code></a>: <a href="#Option-details">Option details</a></li>
<li><a href="#index-g_t_002dv-225"><code>-v</code></a>: <a href="#Option-details">Option details</a></li>
-<li><a href="#index-g_t_002dV-_0040var_007bvpl_002dfile_007d-637"><code>-V </code><var>vpl-file</var></a>: <a href="#Afm2tfm-options">Afm2tfm options</a></li>
-<li><a href="#index-g_t_002dv-_0040var_007bvpl_002dfile_007d-636"><code>-v </code><var>vpl-file</var></a>: <a href="#Afm2tfm-options">Afm2tfm options</a></li>
+<li><a href="#index-g_t_002dV-_0040var_007bvpl_002dfile_007d-640"><code>-V </code><var>vpl-file</var></a>: <a href="#Afm2tfm-options">Afm2tfm options</a></li>
+<li><a href="#index-g_t_002dv-_0040var_007bvpl_002dfile_007d-639"><code>-v </code><var>vpl-file</var></a>: <a href="#Afm2tfm-options">Afm2tfm options</a></li>
<li><a href="#index-g_t_002dX-_0040var_007bnum_007d-232"><code>-X </code><var>num</var></a>: <a href="#Option-details">Option details</a></li>
<li><a href="#index-g_t_002dx-_0040var_007bnum_007d-230"><code>-x </code><var>num</var></a>: <a href="#Option-details">Option details</a></li>
<li><a href="#index-g_t_002dY-_0040var_007bnum_007d-235"><code>-Y </code><var>num</var></a>: <a href="#Option-details">Option details</a></li>
-<li><a href="#index-g_t_002dz-468"><code>-z</code></a>: <a href="#Hypertext">Hypertext</a></li>
+<li><a href="#index-g_t_002dz-471"><code>-z</code></a>: <a href="#Hypertext">Hypertext</a></li>
<li><a href="#index-g_t_002dZ-_0040r_007bfor-compressing-bitmap-fonts_007d-242"><code>-Z </code><span class="roman">for compressing bitmap fonts</span></a>: <a href="#Option-details">Option details</a></li>
<li><a href="#index-g_t_002dz-_0040r_007bfor-recognizing-hyperdvi_007d-237"><code>-z </code><span class="roman">for recognizing hyperdvi</span></a>: <a href="#Option-details">Option details</a></li>
<li><a href="#index-g_t_0040file_007b_002e_002e_007d_002drelative-filenames-205"><samp><span class="file">..</span></samp>-relative filenames</a>: <a href="#Option-details">Option details</a></li>
-<li><a href="#index-g_t_002eafm-_0040r_007bAdobe-metric-files_007d-510"><code>.afm </code><span class="roman">Adobe metric files</span></a>: <a href="#Metric-files">Metric files</a></li>
+<li><a href="#index-g_t_002eafm-_0040r_007bAdobe-metric-files_007d-513"><code>.afm </code><span class="roman">Adobe metric files</span></a>: <a href="#Metric-files">Metric files</a></li>
<li><a href="#index-g_t_002edvipsrc_0040r_007b_002c-searched-for_007d-262"><code>.dvipsrc</code><span class="roman">, searched for</span></a>: <a href="#Configuration-file-searching">Configuration file searching</a></li>
-<li><a href="#index-g_t_002eenc-_0040r_007bextension-for-encoding-vectors_007d-657"><code>.enc </code><span class="roman">extension for encoding vectors</span></a>: <a href="#psfonts_002emap">psfonts.map</a></li>
-<li><a href="#index-g_t_002elpro-_0040r_007blong-prologue-files_007d-418"><code>.lpro </code><span class="roman">long prologue files</span></a>: <a href="#Header-files">Header files</a></li>
-<li><a href="#index-g_t_002emf-_0040r_007bMetafont-source-files_007d-529"><code>.mf </code><span class="roman">Metafont source files</span></a>: <a href="#Glyph-files">Glyph files</a></li>
-<li><a href="#index-g_t_002e_0040var_007bnnn_007dpk-_0040r_007bpacked-font-bitmaps_007d-532"><code>.</code><var>nnn</var><code>pk </code><span class="roman">packed font bitmaps</span></a>: <a href="#Glyph-files">Glyph files</a></li>
-<li><a href="#index-g_t_002epfa-_0040r_007bextension-required-for-partial-downloading_007d-658"><code>.pfa </code><span class="roman">extension required for partial downloading</span></a>: <a href="#psfonts_002emap">psfonts.map</a></li>
-<li><a href="#index-g_t_002epfa-_0040r_007bprinter-font-ascii-files_007d-526"><code>.pfa </code><span class="roman">printer font ascii files</span></a>: <a href="#Glyph-files">Glyph files</a></li>
-<li><a href="#index-g_t_002epfb-_0040r_007bextension-required-for-partial-downloading_007d-659"><code>.pfb </code><span class="roman">extension required for partial downloading</span></a>: <a href="#psfonts_002emap">psfonts.map</a></li>
-<li><a href="#index-g_t_002epfb-_0040r_007bprinter-font-binary-files_007d-527"><code>.pfb </code><span class="roman">printer font binary files</span></a>: <a href="#Glyph-files">Glyph files</a></li>
-<li><a href="#index-g_t_002epfm-_0040r_007bprinter-font-metric-files_007d-518"><code>.pfm </code><span class="roman">printer font metric files</span></a>: <a href="#Metric-files">Metric files</a></li>
-<li><a href="#index-g_t_002epl-_0040r_007bproperty-list-files_007d-516"><code>.pl </code><span class="roman">property list files</span></a>: <a href="#Metric-files">Metric files</a></li>
-<li><a href="#index-g_t_002epro-_0040r_007bprologue-files_007d-417"><code>.pro </code><span class="roman">prologue files</span></a>: <a href="#Header-files">Header files</a></li>
-<li><a href="#index-g_t_002etfm-_0040r_007b_0040TeX_007b_007d-font-metric-files_007d-512"><code>.tfm </code><span class="roman">TeX font metric files</span></a>: <a href="#Metric-files">Metric files</a></li>
+<li><a href="#index-g_t_002eenc-_0040r_007bextension-for-encoding-vectors_007d-654"><code>.enc </code><span class="roman">extension for encoding vectors</span></a>: <a href="#psfonts_002emap">psfonts.map</a></li>
+<li><a href="#index-g_t_002elpro-_0040r_007blong-prologue-files_007d-421"><code>.lpro </code><span class="roman">long prologue files</span></a>: <a href="#Header-files">Header files</a></li>
+<li><a href="#index-g_t_002emf-_0040r_007bMetafont-source-files_007d-532"><code>.mf </code><span class="roman">Metafont source files</span></a>: <a href="#Glyph-files">Glyph files</a></li>
+<li><a href="#index-g_t_002e_0040var_007bnnn_007dpk-_0040r_007bpacked-font-bitmaps_007d-535"><code>.</code><var>nnn</var><code>pk </code><span class="roman">packed font bitmaps</span></a>: <a href="#Glyph-files">Glyph files</a></li>
+<li><a href="#index-g_t_002epfa-_0040r_007bextension-required-for-partial-downloading_007d-655"><code>.pfa </code><span class="roman">extension required for partial downloading</span></a>: <a href="#psfonts_002emap">psfonts.map</a></li>
+<li><a href="#index-g_t_002epfa-_0040r_007bprinter-font-ascii-files_007d-529"><code>.pfa </code><span class="roman">printer font ascii files</span></a>: <a href="#Glyph-files">Glyph files</a></li>
+<li><a href="#index-g_t_002epfb-_0040r_007bextension-required-for-partial-downloading_007d-656"><code>.pfb </code><span class="roman">extension required for partial downloading</span></a>: <a href="#psfonts_002emap">psfonts.map</a></li>
+<li><a href="#index-g_t_002epfb-_0040r_007bprinter-font-binary-files_007d-530"><code>.pfb </code><span class="roman">printer font binary files</span></a>: <a href="#Glyph-files">Glyph files</a></li>
+<li><a href="#index-g_t_002epfm-_0040r_007bprinter-font-metric-files_007d-521"><code>.pfm </code><span class="roman">printer font metric files</span></a>: <a href="#Metric-files">Metric files</a></li>
+<li><a href="#index-g_t_002epl-_0040r_007bproperty-list-files_007d-519"><code>.pl </code><span class="roman">property list files</span></a>: <a href="#Metric-files">Metric files</a></li>
+<li><a href="#index-g_t_002epro-_0040r_007bprologue-files_007d-420"><code>.pro </code><span class="roman">prologue files</span></a>: <a href="#Header-files">Header files</a></li>
+<li><a href="#index-g_t_002etfm-_0040r_007b_0040TeX_007b_007d-font-metric-files_007d-515"><code>.tfm </code><span class="roman">TeX font metric files</span></a>: <a href="#Metric-files">Metric files</a></li>
<li><a href="#index-g_t_002f_0023copies-93"><code>/#copies</code></a>: <a href="#Option-details">Option details</a></li>
-<li><a href="#index-g_t_002fmagscale-384"><code>/magscale</code></a>: <a href="#EPSF-scaling">EPSF scaling</a></li>
-<li><a href="#index-g_t612-792-_0040r_007bbounding-box-size_007d-362"><code>612 792 </code><span class="roman">bounding box size</span></a>: <a href="#Bounding-box">Bounding box</a></li>
-<li><a href="#index-g_t8r-_0040r_007bencoding_002c-and-extra-characters_007d-586"><code>8r </code><span class="roman">encoding, and extra characters</span></a>: <a href="#Changing-PostScript-encodings">Changing PostScript encodings</a></li>
-<li><a href="#index-g_t8r-font-encoding-654">8r font encoding</a>: <a href="#psfonts_002emap">psfonts.map</a></li>
-<li><a href="#index-g_t8r_002eenc-547"><code>8r.enc</code></a>: <a href="#Encodings">Encodings</a></li>
-<li><a href="#index-g_t_003c-_0040r_007bfont-downloading_007d-642"><code>&lt; </code><span class="roman">font downloading</span></a>: <a href="#psfonts_002emap">psfonts.map</a></li>
-<li><a href="#index-g_t_003c_003c-_0040r_007bwhole-font-downloading_007d-648"><code>&lt;&lt; </code><span class="roman">whole font downloading</span></a>: <a href="#psfonts_002emap">psfonts.map</a></li>
-<li><a href="#index-g_t_003c_005b-_0040r_007bencoding-vector-downloading_007d-656"><code>&lt;[ </code><span class="roman">encoding vector downloading</span></a>: <a href="#psfonts_002emap">psfonts.map</a></li>
-<li><a href="#index-g_t_003d_003a-_0040r_007bligature-operation_007d-606"><code>=: </code><span class="roman">ligature operation</span></a>: <a href="#Encoding-file-format">Encoding file format</a></li>
+<li><a href="#index-g_t_002fmagscale-387"><code>/magscale</code></a>: <a href="#EPSF-scaling">EPSF scaling</a></li>
+<li><a href="#index-g_t612-792-_0040r_007bbounding-box-size_007d-365"><code>612 792 </code><span class="roman">bounding box size</span></a>: <a href="#Bounding-box">Bounding box</a></li>
+<li><a href="#index-g_t8r-_0040r_007bencoding_002c-and-extra-characters_007d-589"><code>8r </code><span class="roman">encoding, and extra characters</span></a>: <a href="#Changing-PostScript-encodings">Changing PostScript encodings</a></li>
+<li><a href="#index-g_t8r-font-encoding-651">8r font encoding</a>: <a href="#psfonts_002emap">psfonts.map</a></li>
+<li><a href="#index-g_t8r_002eenc-550"><code>8r.enc</code></a>: <a href="#Encodings">Encodings</a></li>
+<li><a href="#index-g_t_003c-_0040r_007bfont-downloading_007d-645"><code>&lt; </code><span class="roman">font downloading</span></a>: <a href="#psfonts_002emap">psfonts.map</a></li>
+<li><a href="#index-g_t_003c_003c-_0040r_007bwhole-font-downloading_007d-663"><code>&lt;&lt; </code><span class="roman">whole font downloading</span></a>: <a href="#psfonts_002emap">psfonts.map</a></li>
+<li><a href="#index-g_t_003c_005b-_0040r_007bencoding-vector-downloading_007d-653"><code>&lt;[ </code><span class="roman">encoding vector downloading</span></a>: <a href="#psfonts_002emap">psfonts.map</a></li>
+<li><a href="#index-g_t_003d_003a-_0040r_007bligature-operation_007d-609"><code>=: </code><span class="roman">ligature operation</span></a>: <a href="#Encoding-file-format">Encoding file format</a></li>
<li><a href="#index-g_t_0040_0040-_0040r_007bpaper-size-config-command_007d-269"><code>@ </code><span class="roman">paper size config command</span></a>: <a href="#Configuration-file-commands">Configuration file commands</a></li>
-<li><a href="#index-g_t_005c_002e-596"><code>\.</code></a>: <a href="#Reencoding-with-Afm2tfm">Reencoding with Afm2tfm</a></li>
-<li><a href="#index-g_t_005cAA-598"><code>\AA</code></a>: <a href="#Reencoding-with-Afm2tfm">Reencoding with Afm2tfm</a></li>
-<li><a href="#index-g_t_005c_0040var_007bColorName_007d-668"><code>\</code><var>ColorName</var></a>: <a href="#Color-macro-files">Color macro files</a></li>
-<li><a href="#index-g_t_005cdot-597"><code>\dot</code></a>: <a href="#Reencoding-with-Afm2tfm">Reencoding with Afm2tfm</a></li>
-<li><a href="#index-g_t_005cepsffile-_0040r_007bmacro_007d-372"><code>\epsffile </code><span class="roman">macro</span></a>: <a href="#EPSF-macros">EPSF macros</a></li>
-<li><a href="#index-g_t_005cepsfsize-380"><code>\epsfsize</code></a>: <a href="#EPSF-scaling">EPSF scaling</a></li>
-<li><a href="#index-g_t_005cepsfverbosetrue-374"><code>\epsfverbosetrue</code></a>: <a href="#EPSF-macros">EPSF macros</a></li>
-<li><a href="#index-g_t_005cepsfxsize-378"><code>\epsfxsize</code></a>: <a href="#EPSF-scaling">EPSF scaling</a></li>
-<li><a href="#index-g_t_005cepsfysize-379"><code>\epsfysize</code></a>: <a href="#EPSF-scaling">EPSF scaling</a></li>
-<li><a href="#index-g_t_005cH-595"><code>\H</code></a>: <a href="#Reencoding-with-Afm2tfm">Reencoding with Afm2tfm</a></li>
-<li><a href="#index-g_t_005cincludegraphics-_0040LaTeX_007b_007d-macro-363">\includegraphics LaTeX macro</a>: <a href="#g_t_005cincludegraphics">\includegraphics</a></li>
-<li><a href="#index-g_t_005cleavevmode-370"><code>\leavevmode</code></a>: <a href="#EPSF-macros">EPSF macros</a></li>
-<li><a href="#index-g_t_005cmagnification-383"><code>\magnification</code></a>: <a href="#EPSF-scaling">EPSF scaling</a></li>
-<li><a href="#index-g_t_005crotninety-464"><code>\rotninety</code></a>: <a href="#Literal-examples">Literal examples</a></li>
-<li><a href="#index-g_t_005ctext_0040var_007bColorName_007d-670"><code>\text</code><var>ColorName</var></a>: <a href="#Color-macro-files">Color macro files</a></li>
+<li><a href="#index-g_t_005c_002e-599"><code>\.</code></a>: <a href="#Reencoding-with-Afm2tfm">Reencoding with Afm2tfm</a></li>
+<li><a href="#index-g_t_005cAA-601"><code>\AA</code></a>: <a href="#Reencoding-with-Afm2tfm">Reencoding with Afm2tfm</a></li>
+<li><a href="#index-g_t_005c_0040var_007bColorName_007d-671"><code>\</code><var>ColorName</var></a>: <a href="#Color-macro-files">Color macro files</a></li>
+<li><a href="#index-g_t_005cdot-600"><code>\dot</code></a>: <a href="#Reencoding-with-Afm2tfm">Reencoding with Afm2tfm</a></li>
+<li><a href="#index-g_t_005cepsffile-_0040r_007bmacro_007d-375"><code>\epsffile </code><span class="roman">macro</span></a>: <a href="#EPSF-macros">EPSF macros</a></li>
+<li><a href="#index-g_t_005cepsfsize-383"><code>\epsfsize</code></a>: <a href="#EPSF-scaling">EPSF scaling</a></li>
+<li><a href="#index-g_t_005cepsfverbosetrue-377"><code>\epsfverbosetrue</code></a>: <a href="#EPSF-macros">EPSF macros</a></li>
+<li><a href="#index-g_t_005cepsfxsize-381"><code>\epsfxsize</code></a>: <a href="#EPSF-scaling">EPSF scaling</a></li>
+<li><a href="#index-g_t_005cepsfysize-382"><code>\epsfysize</code></a>: <a href="#EPSF-scaling">EPSF scaling</a></li>
+<li><a href="#index-g_t_005cH-598"><code>\H</code></a>: <a href="#Reencoding-with-Afm2tfm">Reencoding with Afm2tfm</a></li>
+<li><a href="#index-g_t_005cincludegraphics-_0040LaTeX_007b_007d-macro-366">\includegraphics LaTeX macro</a>: <a href="#g_t_005cincludegraphics">\includegraphics</a></li>
+<li><a href="#index-g_t_005cleavevmode-373"><code>\leavevmode</code></a>: <a href="#EPSF-macros">EPSF macros</a></li>
+<li><a href="#index-g_t_005cmagnification-386"><code>\magnification</code></a>: <a href="#EPSF-scaling">EPSF scaling</a></li>
+<li><a href="#index-g_t_005crotninety-467"><code>\rotninety</code></a>: <a href="#Literal-examples">Literal examples</a></li>
+<li><a href="#index-g_t_005ctext_0040var_007bColorName_007d-673"><code>\text</code><var>ColorName</var></a>: <a href="#Color-macro-files">Color macro files</a></li>
<li><a href="#index-a-_0040r_007bconfig-command-_0028memory-conservation_0029_007d-270"><code>a </code><span class="roman">config command (memory conservation)</span></a>: <a href="#Configuration-file-commands">Configuration file commands</a></li>
-<li><a href="#index-A-ring_002c-Scandinavian-letter-594">A ring, Scandinavian letter</a>: <a href="#Reencoding-with-Afm2tfm">Reencoding with Afm2tfm</a></li>
+<li><a href="#index-A-ring_002c-Scandinavian-letter-597">A ring, Scandinavian letter</a>: <a href="#Reencoding-with-Afm2tfm">Reencoding with Afm2tfm</a></li>
<li><a href="#index-a3-papertype-216">a3 papertype</a>: <a href="#Option-details">Option details</a></li>
-<li><a href="#index-a4-_0040r_007bpaper-size_007d-342"><code>a4 </code><span class="roman">paper size</span></a>: <a href="#Config-file-paper-sizes">Config file paper sizes</a></li>
+<li><a href="#index-a4-_0040r_007bpaper-size_007d-345"><code>a4 </code><span class="roman">paper size</span></a>: <a href="#Config-file-paper-sizes">Config file paper sizes</a></li>
<li><a href="#index-a4-papertype-215">a4 papertype</a>: <a href="#Option-details">Option details</a></li>
-<li><a href="#index-A4size-_0040r_007bpaper-size_007d-344"><code>A4size </code><span class="roman">paper size</span></a>: <a href="#Config-file-paper-sizes">Config file paper sizes</a></li>
+<li><a href="#index-A4size-_0040r_007bpaper-size_007d-347"><code>A4size </code><span class="roman">paper size</span></a>: <a href="#Config-file-paper-sizes">Config file paper sizes</a></li>
<li><a href="#index-absolute-filenames_002c-disabling-204">absolute filenames, disabling</a>: <a href="#Option-details">Option details</a></li>
<li><a href="#index-absolute-page-number_002c-and-_0040samp_007b_002dl_007d-149">absolute page number, and &lsquo;<samp><span class="samp">-l</span></samp>&rsquo;</a>: <a href="#Option-details">Option details</a></li>
<li><a href="#index-absolute-page-number_002c-and-_0040samp_007b_002dp_007d-189">absolute page number, and &lsquo;<samp><span class="samp">-p</span></samp>&rsquo;</a>: <a href="#Option-details">Option details</a></li>
-<li><a href="#index-accents_002c-in-wrong-position-590">accents, in wrong position</a>: <a href="#Reencoding-with-Afm2tfm">Reencoding with Afm2tfm</a></li>
-<li><a href="#index-accents_002c-wrong-622">accents, wrong</a>: <a href="#Afm2tfm-options">Afm2tfm options</a></li>
+<li><a href="#index-accents_002c-in-wrong-position-593">accents, in wrong position</a>: <a href="#Reencoding-with-Afm2tfm">Reencoding with Afm2tfm</a></li>
+<li><a href="#index-accents_002c-wrong-625">accents, wrong</a>: <a href="#Afm2tfm-options">Afm2tfm options</a></li>
<li><a href="#index-accuracy-in-positioning-112">accuracy in positioning</a>: <a href="#Option-details">Option details</a></li>
<li><a href="#index-Adobe-fonts-17">Adobe fonts</a>: <a href="#PostScript-font-installation">PostScript font installation</a></li>
<li><a href="#index-Adobe-fonts_002c-installing-22">Adobe fonts, installing</a>: <a href="#PostScript-font-installation">PostScript font installation</a></li>
-<li><a href="#index-afm-files-509">afm files</a>: <a href="#Metric-files">Metric files</a></li>
-<li><a href="#index-afm2tfm-570"><code>afm2tfm</code></a>: <a href="#Invoking-afm2tfm">Invoking afm2tfm</a></li>
-<li><a href="#index-afm2tfm-566"><code>afm2tfm</code></a>: <a href="#Making-a-font-available">Making a font available</a></li>
-<li><a href="#index-afm2tfm-options-621">afm2tfm options</a>: <a href="#Afm2tfm-options">Afm2tfm options</a></li>
-<li><a href="#index-after-header_002c-inserting-code-427">after header, inserting code</a>: <a href="#Including-headers-from-TeX">Including headers from TeX</a></li>
+<li><a href="#index-afm-files-512">afm files</a>: <a href="#Metric-files">Metric files</a></li>
+<li><a href="#index-afm2tfm-573"><code>afm2tfm</code></a>: <a href="#Invoking-afm2tfm">Invoking afm2tfm</a></li>
+<li><a href="#index-afm2tfm-569"><code>afm2tfm</code></a>: <a href="#Making-a-font-available">Making a font available</a></li>
+<li><a href="#index-afm2tfm-options-624">afm2tfm options</a>: <a href="#Afm2tfm-options">Afm2tfm options</a></li>
+<li><a href="#index-after-header_002c-inserting-code-430">after header, inserting code</a>: <a href="#Including-headers-from-TeX">Including headers from TeX</a></li>
<li><a href="#index-Aladdin-Ghostscript-38">Aladdin Ghostscript</a>: <a href="#Ghostscript-installation">Ghostscript installation</a></li>
-<li><a href="#index-Anderson_002c-Laurie-500">Anderson, Laurie</a>: <a href="#Hypertext-specials">Hypertext specials</a></li>
-<li><a href="#index-angle-_0040r_007b_0028_0040samp_007bpsfile_007d-special-option_0029_007d-397"><code>angle </code><span class="roman">(&lsquo;</span><samp><span class="samp">psfile</span></samp><span class="roman">&rsquo; special option)</span></a>: <a href="#psfile-special">psfile special</a></li>
-<li><a href="#index-arcs-521">arcs</a>: <a href="#Glyph-files">Glyph files</a></li>
-<li><a href="#index-ASCII-character-codes_002c-used-by-PostScript-555">ASCII character codes, used by PostScript</a>: <a href="#PostScript-typesetting">PostScript typesetting</a></li>
-<li><a href="#index-atend_0040r_007b_002c-bounding-box-specification_007d-358"><code>atend</code><span class="roman">, bounding box specification</span></a>: <a href="#Bounding-box">Bounding box</a></li>
+<li><a href="#index-Anderson_002c-Laurie-503">Anderson, Laurie</a>: <a href="#Hypertext-specials">Hypertext specials</a></li>
+<li><a href="#index-angle-_0040r_007b_0028_0040samp_007bpsfile_007d-special-option_0029_007d-400"><code>angle </code><span class="roman">(&lsquo;</span><samp><span class="samp">psfile</span></samp><span class="roman">&rsquo; special option)</span></a>: <a href="#psfile-special">psfile special</a></li>
+<li><a href="#index-arcs-524">arcs</a>: <a href="#Glyph-files">Glyph files</a></li>
+<li><a href="#index-ASCII-character-codes_002c-used-by-PostScript-558">ASCII character codes, used by PostScript</a>: <a href="#PostScript-typesetting">PostScript typesetting</a></li>
+<li><a href="#index-atend_0040r_007b_002c-bounding-box-specification_007d-361"><code>atend</code><span class="roman">, bounding box specification</span></a>: <a href="#Bounding-box">Bounding box</a></li>
<li><a href="#index-b-_0040r_007bconfig-command-_0028_0023copies_0029_007d-271"><code>b </code><span class="roman">config command (#copies)</span></a>: <a href="#Configuration-file-commands">Configuration file commands</a></li>
-<li><a href="#index-base-503"><code>base</code></a>: <a href="#Hypertext-specials">Hypertext specials</a></li>
-<li><a href="#index-base-encoding_002c-recommended-655">base encoding, recommended</a>: <a href="#psfonts_002emap">psfonts.map</a></li>
-<li><a href="#index-base-fonts-538">base fonts</a>: <a href="#Virtual-fonts">Virtual fonts</a></li>
-<li><a href="#index-bbfig-360"><code>bbfig</code></a>: <a href="#Bounding-box">Bounding box</a></li>
-<li><a href="#index-before-header_002c-inserting-code-426">before header, inserting code</a>: <a href="#Including-headers-from-TeX">Including headers from TeX</a></li>
-<li><a href="#index-Bhattacharya_002c-Tanmoy-476">Bhattacharya, Tanmoy</a>: <a href="#Hypertext">Hypertext</a></li>
-<li><a href="#index-big-points-354">big points</a>: <a href="#Bounding-box">Bounding box</a></li>
+<li><a href="#index-base-506"><code>base</code></a>: <a href="#Hypertext-specials">Hypertext specials</a></li>
+<li><a href="#index-base-encoding_002c-recommended-652">base encoding, recommended</a>: <a href="#psfonts_002emap">psfonts.map</a></li>
+<li><a href="#index-base-fonts-541">base fonts</a>: <a href="#Virtual-fonts">Virtual fonts</a></li>
+<li><a href="#index-bbfig-363"><code>bbfig</code></a>: <a href="#Bounding-box">Bounding box</a></li>
+<li><a href="#index-before-header_002c-inserting-code-429">before header, inserting code</a>: <a href="#Including-headers-from-TeX">Including headers from TeX</a></li>
+<li><a href="#index-Bhattacharya_002c-Tanmoy-479">Bhattacharya, Tanmoy</a>: <a href="#Hypertext">Hypertext</a></li>
+<li><a href="#index-big-points-357">big points</a>: <a href="#Bounding-box">Bounding box</a></li>
<li><a href="#index-Bigelow-_0026-Holmes-fonts-18">Bigelow &amp; Holmes fonts</a>: <a href="#PostScript-font-installation">PostScript font installation</a></li>
<li><a href="#index-binary-files_002c-not-supported-76">binary files, not supported</a>: <a href="#Including-graphics-fails">Including graphics fails</a></li>
-<li><a href="#index-bitmap-fonts-528">bitmap fonts</a>: <a href="#Glyph-files">Glyph files</a></li>
+<li><a href="#index-bitmap-fonts-531">bitmap fonts</a>: <a href="#Glyph-files">Glyph files</a></li>
<li><a href="#index-Bitstream-fonts_002c-installing-23">Bitstream fonts, installing</a>: <a href="#PostScript-font-installation">PostScript font installation</a></li>
<li><a href="#index-g_t_0040t_007bbop-undefined_007d-error-66"><tt>bop undefined</tt> error</a>: <a href="#Printer-errors">Printer errors</a></li>
-<li><a href="#index-bop_002dhook-454"><code>bop-hook</code></a>: <a href="#PostScript-hooks">PostScript hooks</a></li>
-<li><a href="#index-bop_002dhook-385"><code>bop-hook</code></a>: <a href="#EPSF-scaling">EPSF scaling</a></li>
-<li><a href="#index-bop_002dhook-349"><code>bop-hook</code></a>: <a href="#Paper-trays">Paper trays</a></li>
+<li><a href="#index-bop_002dhook-457"><code>bop-hook</code></a>: <a href="#PostScript-hooks">PostScript hooks</a></li>
+<li><a href="#index-bop_002dhook-388"><code>bop-hook</code></a>: <a href="#EPSF-scaling">EPSF scaling</a></li>
+<li><a href="#index-bop_002dhook-352"><code>bop-hook</code></a>: <a href="#Paper-trays">Paper trays</a></li>
<li><a href="#index-bop_002dhook_0040r_007b_002c-and-offset-pages_007d-184"><code>bop-hook</code><span class="roman">, and offset pages</span></a>: <a href="#Option-details">Option details</a></li>
-<li><a href="#index-boundary-character-603">boundary character</a>: <a href="#Encoding-file-format">Encoding file format</a></li>
-<li><a href="#index-bounding-box_002c-comment-for-353">bounding box, comment for</a>: <a href="#Bounding-box">Bounding box</a></li>
-<li><a href="#index-bounding-box_002c-defined-356">bounding box, defined</a>: <a href="#Bounding-box">Bounding box</a></li>
-<li><a href="#index-bounding-box_002c-determining-361">bounding box, determining</a>: <a href="#Bounding-box">Bounding box</a></li>
+<li><a href="#index-boundary-character-606">boundary character</a>: <a href="#Encoding-file-format">Encoding file format</a></li>
+<li><a href="#index-bounding-box_002c-comment-for-356">bounding box, comment for</a>: <a href="#Bounding-box">Bounding box</a></li>
+<li><a href="#index-bounding-box_002c-defined-359">bounding box, defined</a>: <a href="#Bounding-box">Bounding box</a></li>
+<li><a href="#index-bounding-box_002c-determining-364">bounding box, determining</a>: <a href="#Bounding-box">Bounding box</a></li>
<li><a href="#index-bounding-box_002c-finding-tight-117">bounding box, finding tight</a>: <a href="#Option-details">Option details</a></li>
-<li><a href="#index-bounding-box_002c-inaccurate-387">bounding box, inaccurate</a>: <a href="#EPSF-clipping">EPSF clipping</a></li>
-<li><a href="#index-bounding-box_002c-supplying-to-_0040TeX_007b_007d-371">bounding box, supplying to TeX</a>: <a href="#EPSF-macros">EPSF macros</a></li>
-<li><a href="#index-bounding-box_002c-supplying-to-_0040TeX_007b_007d-365">bounding box, supplying to TeX</a>: <a href="#g_t_005cincludegraphics">\includegraphics</a></li>
-<li><a href="#index-changing-PostScript-encodings-580">changing PostScript encodings</a>: <a href="#Changing-PostScript-encodings">Changing PostScript encodings</a></li>
-<li><a href="#index-changing-_0040TeX_007b_007d-encodings-576">changing TeX encodings</a>: <a href="#Changing-TeX-encodings">Changing TeX encodings</a></li>
-<li><a href="#index-character-definitions-in-PostScript-563">character definitions in PostScript</a>: <a href="#PostScript-typesetting">PostScript typesetting</a></li>
-<li><a href="#index-character-lookup-procedure-in-PostScript-553">character lookup procedure in PostScript</a>: <a href="#PostScript-typesetting">PostScript typesetting</a></li>
-<li><a href="#index-CharStrings-_0040r_007bType-1-dictionary_007d-560"><code>CharStrings </code><span class="roman">Type 1 dictionary</span></a>: <a href="#PostScript-typesetting">PostScript typesetting</a></li>
-<li><a href="#index-clip-_0040r_007b_0028_0040samp_007bpsfile_007d-special-option_0029_007d-398"><code>clip </code><span class="roman">(&lsquo;</span><samp><span class="samp">psfile</span></samp><span class="roman">&rsquo; special option)</span></a>: <a href="#psfile-special">psfile special</a></li>
-<li><a href="#index-clipping-of-EPSF-386">clipping of EPSF</a>: <a href="#EPSF-clipping">EPSF clipping</a></li>
-<li><a href="#index-CODINGSCHEME-599"><code>CODINGSCHEME</code></a>: <a href="#Reencoding-with-Afm2tfm">Reencoding with Afm2tfm</a></li>
+<li><a href="#index-bounding-box_002c-inaccurate-390">bounding box, inaccurate</a>: <a href="#EPSF-clipping">EPSF clipping</a></li>
+<li><a href="#index-bounding-box_002c-supplying-to-_0040TeX_007b_007d-374">bounding box, supplying to TeX</a>: <a href="#EPSF-macros">EPSF macros</a></li>
+<li><a href="#index-bounding-box_002c-supplying-to-_0040TeX_007b_007d-368">bounding box, supplying to TeX</a>: <a href="#g_t_005cincludegraphics">\includegraphics</a></li>
+<li><a href="#index-changing-PostScript-encodings-583">changing PostScript encodings</a>: <a href="#Changing-PostScript-encodings">Changing PostScript encodings</a></li>
+<li><a href="#index-changing-_0040TeX_007b_007d-encodings-579">changing TeX encodings</a>: <a href="#Changing-TeX-encodings">Changing TeX encodings</a></li>
+<li><a href="#index-character-definitions-in-PostScript-566">character definitions in PostScript</a>: <a href="#PostScript-typesetting">PostScript typesetting</a></li>
+<li><a href="#index-character-lookup-procedure-in-PostScript-556">character lookup procedure in PostScript</a>: <a href="#PostScript-typesetting">PostScript typesetting</a></li>
+<li><a href="#index-CharStrings-_0040r_007bType-1-dictionary_007d-563"><code>CharStrings </code><span class="roman">Type 1 dictionary</span></a>: <a href="#PostScript-typesetting">PostScript typesetting</a></li>
+<li><a href="#index-clip-_0040r_007b_0028_0040samp_007bpsfile_007d-special-option_0029_007d-401"><code>clip </code><span class="roman">(&lsquo;</span><samp><span class="samp">psfile</span></samp><span class="roman">&rsquo; special option)</span></a>: <a href="#psfile-special">psfile special</a></li>
+<li><a href="#index-clipping-of-EPSF-389">clipping of EPSF</a>: <a href="#EPSF-clipping">EPSF clipping</a></li>
+<li><a href="#index-CODINGSCHEME-602"><code>CODINGSCHEME</code></a>: <a href="#Reencoding-with-Afm2tfm">Reencoding with Afm2tfm</a></li>
<li><a href="#index-collated-copies-105">collated copies</a>: <a href="#Option-details">Option details</a></li>
-<li><a href="#index-color-661">color</a>: <a href="#Color">Color</a></li>
-<li><a href="#index-color-configuration-674">color configuration</a>: <a href="#Color-device-configuration">Color device configuration</a></li>
-<li><a href="#index-color-macros-664">color macros</a>: <a href="#Color-macro-files">Color macro files</a></li>
-<li><a href="#index-color-names_002c-mixed-case-667">color names, mixed case</a>: <a href="#Color-macro-files">Color macro files</a></li>
-<li><a href="#index-color-nesting-level-669">color nesting level</a>: <a href="#Color-macro-files">Color macro files</a></li>
+<li><a href="#index-color-664">color</a>: <a href="#Color">Color</a></li>
+<li><a href="#index-color-configuration-677">color configuration</a>: <a href="#Color-device-configuration">Color device configuration</a></li>
+<li><a href="#index-color-macros-667">color macros</a>: <a href="#Color-macro-files">Color macro files</a></li>
+<li><a href="#index-color-names_002c-mixed-case-670">color names, mixed case</a>: <a href="#Color-macro-files">Color macro files</a></li>
+<li><a href="#index-color-nesting-level-672">color nesting level</a>: <a href="#Color-macro-files">Color macro files</a></li>
<li><a href="#index-color-separations-95">color separations</a>: <a href="#Option-details">Option details</a></li>
-<li><a href="#index-color-specifications-678">color specifications</a>: <a href="#Color-specifications">Color specifications</a></li>
-<li><a href="#index-color-subtleties-673">color subtleties</a>: <a href="#Color-subtleties">Color subtleties</a></li>
-<li><a href="#index-colors_002c-user_002ddefinable-672">colors, user-definable</a>: <a href="#User_002ddefinable-colors">User-definable colors</a></li>
-<li><a href="#index-command-line_002c-including-headers-from-431">command line, including headers from</a>: <a href="#Including-headers-from-the-command-line">Including headers from the command line</a></li>
+<li><a href="#index-color-specifications-681">color specifications</a>: <a href="#Color-specifications">Color specifications</a></li>
+<li><a href="#index-color-subtleties-676">color subtleties</a>: <a href="#Color-subtleties">Color subtleties</a></li>
+<li><a href="#index-colors_002c-user_002ddefinable-675">colors, user-definable</a>: <a href="#User_002ddefinable-colors">User-definable colors</a></li>
+<li><a href="#index-command-line_002c-including-headers-from-434">command line, including headers from</a>: <a href="#Including-headers-from-the-command-line">Including headers from the command line</a></li>
<li><a href="#index-command_002dline-options-77">command-line options</a>: <a href="#Invoking-Dvips">Invoking Dvips</a></li>
<li><a href="#index-comments_002c-in-configuration-files-267">comments, in configuration files</a>: <a href="#Configuration-file-commands">Configuration file commands</a></li>
-<li><a href="#index-comments_002c-in-encoding-files-601">comments, in encoding files</a>: <a href="#Encoding-file-format">Encoding file format</a></li>
+<li><a href="#index-comments_002c-in-encoding-files-604">comments, in encoding files</a>: <a href="#Encoding-file-format">Encoding file format</a></li>
<li><a href="#index-comments_002c-removing-included-143">comments, removing included</a>: <a href="#Option-details">Option details</a></li>
<li><a href="#index-compilation-3">compilation</a>: <a href="#Installation">Installation</a></li>
-<li><a href="#index-compressed-PostScript-408">compressed PostScript</a>: <a href="#Dynamic-creation-of-graphics">Dynamic creation of graphics</a></li>
+<li><a href="#index-compressed-PostScript-411">compressed PostScript</a>: <a href="#Dynamic-creation-of-graphics">Dynamic creation of graphics</a></li>
<li><a href="#index-compressing-bitmap-fonts-243">compressing bitmap fonts</a>: <a href="#Option-details">Option details</a></li>
-<li><a href="#index-Computer-Modern-in-PostScript-481">Computer Modern in PostScript</a>: <a href="#Hypertext-caveats">Hypertext caveats</a></li>
-<li><a href="#index-Computer-Modern_002c-encoding-of-542">Computer Modern, encoding of</a>: <a href="#Encodings">Encodings</a></li>
-<li><a href="#index-condensed-fonts-627">condensed fonts</a>: <a href="#Afm2tfm-options">Afm2tfm options</a></li>
+<li><a href="#index-Computer-Modern-in-PostScript-484">Computer Modern in PostScript</a>: <a href="#Hypertext-caveats">Hypertext caveats</a></li>
+<li><a href="#index-Computer-Modern_002c-encoding-of-545">Computer Modern, encoding of</a>: <a href="#Encodings">Encodings</a></li>
+<li><a href="#index-condensed-fonts-630">condensed fonts</a>: <a href="#Afm2tfm-options">Afm2tfm options</a></li>
<li><a href="#index-config_002eproto-10"><code>config.proto</code></a>: <a href="#config_002eps-installation">config.ps installation</a></li>
<li><a href="#index-config_002eps-194"><code>config.ps</code></a>: <a href="#Option-details">Option details</a></li>
<li><a href="#index-config_002eps-_0040r_007binstallation_007d-5"><code>config.ps </code><span class="roman">installation</span></a>: <a href="#config_002eps-installation">config.ps installation</a></li>
-<li><a href="#index-config_002eps-_0040r_007bpaper-sizes_007d-340"><code>config.ps </code><span class="roman">paper sizes</span></a>: <a href="#Config-file-paper-sizes">Config file paper sizes</a></li>
+<li><a href="#index-config_002eps-_0040r_007bpaper-sizes_007d-343"><code>config.ps </code><span class="roman">paper sizes</span></a>: <a href="#Config-file-paper-sizes">Config file paper sizes</a></li>
<li><a href="#index-config_002eps_0040r_007b_002c-searched-for_007d-261"><code>config.ps</code><span class="roman">, searched for</span></a>: <a href="#Configuration-file-searching">Configuration file searching</a></li>
<li><a href="#index-configuration-file-options-265">configuration file options</a>: <a href="#Configuration-file-commands">Configuration file commands</a></li>
-<li><a href="#index-configuration-file-paper-size-command-338">configuration file paper size command</a>: <a href="#Config-file-paper-sizes">Config file paper sizes</a></li>
+<li><a href="#index-configuration-file-paper-size-command-339">configuration file paper size command</a>: <a href="#Config-file-paper-sizes">Config file paper sizes</a></li>
<li><a href="#index-configuration-file-path-256">configuration file path</a>: <a href="#Environment-variables">Environment variables</a></li>
<li><a href="#index-configuration-file-searching-259">configuration file searching</a>: <a href="#Configuration-file-searching">Configuration file searching</a></li>
<li><a href="#index-configuration-files-258">configuration files</a>: <a href="#Config-files">Config files</a></li>
<li><a href="#index-configuration-files_002c-creating-9">configuration files, creating</a>: <a href="#config_002eps-installation">config.ps installation</a></li>
<li><a href="#index-configuration-files_002c-prototype-13">configuration files, prototype</a>: <a href="#config_002eps-installation">config.ps installation</a></li>
-<li><a href="#index-configuration_002c-of-color-devices-675">configuration, of color devices</a>: <a href="#Color-device-configuration">Color device configuration</a></li>
+<li><a href="#index-configuration_002c-of-color-devices-678">configuration, of color devices</a>: <a href="#Color-device-configuration">Color device configuration</a></li>
<li><a href="#index-configuration_002c-of-Dvips-2">configuration, of Dvips</a>: <a href="#Installation">Installation</a></li>
<li><a href="#index-continuation-lines_002c-not-supported-268">continuation lines, not supported</a>: <a href="#Configuration-file-commands">Configuration file commands</a></li>
<li><a href="#index-control_002dD-125">control-D</a>: <a href="#Option-details">Option details</a></li>
<li><a href="#index-copies_002c-collated-104">copies, collated</a>: <a href="#Option-details">Option details</a></li>
<li><a href="#index-copies_002c-duplicated-page-bodies-94">copies, duplicated page bodies</a>: <a href="#Option-details">Option details</a></li>
<li><a href="#index-copies_002c-uncollated-101">copies, uncollated</a>: <a href="#Option-details">Option details</a></li>
-<li><a href="#index-Crayola-crayon-box-665">Crayola crayon box</a>: <a href="#Color-macro-files">Color macro files</a></li>
+<li><a href="#index-Crayola-crayon-box-668">Crayola crayon box</a>: <a href="#Color-macro-files">Color macro files</a></li>
<li><a href="#index-crop_002epro-141"><code>crop.pro</code></a>: <a href="#Option-details">Option details</a></li>
<li><a href="#index-cropmarks-140">cropmarks</a>: <a href="#Option-details">Option details</a></li>
-<li><a href="#index-current-font_002c-in-PostScript-556">current font, in PostScript</a>: <a href="#PostScript-typesetting">PostScript typesetting</a></li>
+<li><a href="#index-current-font_002c-in-PostScript-559">current font, in PostScript</a>: <a href="#PostScript-typesetting">PostScript typesetting</a></li>
<li><a href="#index-D-_0040r_007bconfig-command-_0028dpi_0029_007d-272"><code>D </code><span class="roman">config command (dpi)</span></a>: <a href="#Configuration-file-commands">Configuration file commands</a></li>
-<li><a href="#index-dated-output-459">dated output</a>: <a href="#PostScript-hooks">PostScript hooks</a></li>
+<li><a href="#index-dated-output-462">dated output</a>: <a href="#PostScript-hooks">PostScript hooks</a></li>
<li><a href="#index-datestamp_002c-in-output-276">datestamp, in output</a>: <a href="#Configuration-file-commands">Configuration file commands</a></li>
<li><a href="#index-debugging-107">debugging</a>: <a href="#Option-details">Option details</a></li>
<li><a href="#index-debugging-48">debugging</a>: <a href="#Diagnosing-problems">Diagnosing problems</a></li>
<li><a href="#index-debugging-options-49">debugging options</a>: <a href="#Debug-options">Debug options</a></li>
-<li><a href="#index-default-resolutions-309">default resolutions</a>: <a href="#Configuration-file-commands">Configuration file commands</a></li>
-<li><a href="#index-default_005ftexsizes-_0040r_007bMake-variable_007d-313"><code>default_texsizes </code><span class="roman">Make variable</span></a>: <a href="#Configuration-file-commands">Configuration file commands</a></li>
+<li><a href="#index-default-resolutions-310">default resolutions</a>: <a href="#Configuration-file-commands">Configuration file commands</a></li>
+<li><a href="#index-default_005ftexsizes-_0040r_007bMake-variable_007d-314"><code>default_texsizes </code><span class="roman">Make variable</span></a>: <a href="#Configuration-file-commands">Configuration file commands</a></li>
<li><a href="#index-Deutsch_002c-Peter-33">Deutsch, Peter</a>: <a href="#Ghostscript-installation">Ghostscript installation</a></li>
-<li><a href="#index-device-dependency_002c-and-virtual-fonts-324">device dependency, and virtual fonts</a>: <a href="#Configuration-file-commands">Configuration file commands</a></li>
-<li><a href="#index-dictionary_002c-_0040code_007bCharStrings_007d-561">dictionary, <code>CharStrings</code></a>: <a href="#PostScript-typesetting">PostScript typesetting</a></li>
-<li><a href="#index-dictionary_002c-PostScript-language-557">dictionary, PostScript language</a>: <a href="#PostScript-typesetting">PostScript typesetting</a></li>
-<li><a href="#index-dictionary_002c-_0040code_007bSDict_007d-452">dictionary, <code>SDict</code></a>: <a href="#Literal-headers">Literal headers</a></li>
-<li><a href="#index-dictionary_002c-_0040code_007buserdict_007d-420">dictionary, <code>userdict</code></a>: <a href="#Header-files">Header files</a></li>
+<li><a href="#index-device-dependency_002c-and-virtual-fonts-325">device dependency, and virtual fonts</a>: <a href="#Configuration-file-commands">Configuration file commands</a></li>
+<li><a href="#index-dictionary_002c-_0040code_007bCharStrings_007d-564">dictionary, <code>CharStrings</code></a>: <a href="#PostScript-typesetting">PostScript typesetting</a></li>
+<li><a href="#index-dictionary_002c-PostScript-language-560">dictionary, PostScript language</a>: <a href="#PostScript-typesetting">PostScript typesetting</a></li>
+<li><a href="#index-dictionary_002c-_0040code_007bSDict_007d-455">dictionary, <code>SDict</code></a>: <a href="#Literal-headers">Literal headers</a></li>
+<li><a href="#index-dictionary_002c-_0040code_007buserdict_007d-423">dictionary, <code>userdict</code></a>: <a href="#Header-files">Header files</a></li>
<li><a href="#index-distillation_002c-and-_0040samp_007b_002dz_007d-239">distillation, and &lsquo;<samp><span class="samp">-z</span></samp>&rsquo;</a>: <a href="#Option-details">Option details</a></li>
-<li><a href="#index-distiller_002c-for-PDF-files-471">distiller, for PDF files</a>: <a href="#Hypertext">Hypertext</a></li>
-<li><a href="#index-dot-accent-592">dot accent</a>: <a href="#Reencoding-with-Afm2tfm">Reencoding with Afm2tfm</a></li>
+<li><a href="#index-distiller_002c-for-PDF-files-474">distiller, for PDF files</a>: <a href="#Hypertext">Hypertext</a></li>
+<li><a href="#index-dot-accent-595">dot accent</a>: <a href="#Reencoding-with-Afm2tfm">Reencoding with Afm2tfm</a></li>
<li><a href="#index-double_002dsided-printing-98">double-sided printing</a>: <a href="#Option-details">Option details</a></li>
-<li><a href="#index-downloading-fonts-partially-644">downloading fonts partially</a>: <a href="#psfonts_002emap">psfonts.map</a></li>
-<li><a href="#index-downloading-PostScript-fonts-640">downloading PostScript fonts</a>: <a href="#psfonts_002emap">psfonts.map</a></li>
-<li><a href="#index-Doyle_002c-Mark-475">Doyle, Mark</a>: <a href="#Hypertext">Hypertext</a></li>
-<li><a href="#index-draft-copies-458">draft copies</a>: <a href="#PostScript-hooks">PostScript hooks</a></li>
-<li><a href="#index-dual-paper-trays-346">dual paper trays</a>: <a href="#Paper-trays">Paper trays</a></li>
-<li><a href="#index-duplex-printers-433">duplex printers</a>: <a href="#Including-headers-from-the-command-line">Including headers from the command line</a></li>
-<li><a href="#index-DVI-magnification-381">DVI magnification</a>: <a href="#EPSF-scaling">EPSF scaling</a></li>
-<li><a href="#index-dvihps_0040r_007b_002c-hyperdvi-to-PostScript_007d-479"><code>dvihps</code><span class="roman">, hyperdvi to PostScript</span></a>: <a href="#Hypertext">Hypertext</a></li>
+<li><a href="#index-downloading-fonts-partially-659">downloading fonts partially</a>: <a href="#psfonts_002emap">psfonts.map</a></li>
+<li><a href="#index-downloading-PostScript-fonts-643">downloading PostScript fonts</a>: <a href="#psfonts_002emap">psfonts.map</a></li>
+<li><a href="#index-Doyle_002c-Mark-478">Doyle, Mark</a>: <a href="#Hypertext">Hypertext</a></li>
+<li><a href="#index-draft-copies-461">draft copies</a>: <a href="#PostScript-hooks">PostScript hooks</a></li>
+<li><a href="#index-dual-paper-trays-349">dual paper trays</a>: <a href="#Paper-trays">Paper trays</a></li>
+<li><a href="#index-duplex-printers-436">duplex printers</a>: <a href="#Including-headers-from-the-command-line">Including headers from the command line</a></li>
+<li><a href="#index-DVI-magnification-384">DVI magnification</a>: <a href="#EPSF-scaling">EPSF scaling</a></li>
+<li><a href="#index-dvihps_0040r_007b_002c-hyperdvi-to-PostScript_007d-482"><code>dvihps</code><span class="roman">, hyperdvi to PostScript</span></a>: <a href="#Hypertext">Hypertext</a></li>
<li><a href="#index-Dvips-configuration-file-options-266">Dvips configuration file options</a>: <a href="#Configuration-file-commands">Configuration file commands</a></li>
-<li><a href="#index-dvips_002eenc-546"><code>dvips.enc</code></a>: <a href="#Encodings">Encodings</a></li>
+<li><a href="#index-dvips_002eenc-549"><code>dvips.enc</code></a>: <a href="#Encodings">Encodings</a></li>
<li><a href="#index-DVIPSDEBUG-245"><code>DVIPSDEBUG</code></a>: <a href="#Environment-variables">Environment variables</a></li>
<li><a href="#index-DVIPSFONTS-247"><code>DVIPSFONTS</code></a>: <a href="#Environment-variables">Environment variables</a></li>
<li><a href="#index-DVIPSHEADERS-248"><code>DVIPSHEADERS</code></a>: <a href="#Environment-variables">Environment variables</a></li>
-<li><a href="#index-DVIPSHEADERS_0040r_007b_002c-overrides_007d-H-283"><code>DVIPSHEADERS</code><span class="roman">, overrides</span><code> H</code></a>: <a href="#Configuration-file-commands">Configuration file commands</a></li>
+<li><a href="#index-DVIPSHEADERS_0040r_007b_002c-overrides_007d-H-284"><code>DVIPSHEADERS</code><span class="roman">, overrides</span><code> H</code></a>: <a href="#Configuration-file-commands">Configuration file commands</a></li>
<li><a href="#index-DVIPSMAKEPK-249"><code>DVIPSMAKEPK</code></a>: <a href="#Environment-variables">Environment variables</a></li>
<li><a href="#index-DVIPSRC-251"><code>DVIPSRC</code></a>: <a href="#Environment-variables">Environment variables</a></li>
<li><a href="#index-DVIPSSIZES-252"><code>DVIPSSIZES</code></a>: <a href="#Environment-variables">Environment variables</a></li>
-<li><a href="#index-DVIPSSIZES_0040r_007b_002c-overrides_007d-R-311"><code>DVIPSSIZES</code><span class="roman">, overrides</span><code> R</code></a>: <a href="#Configuration-file-commands">Configuration file commands</a></li>
-<li><a href="#index-dynamic-creation-of-graphics-407">dynamic creation of graphics</a>: <a href="#Dynamic-creation-of-graphics">Dynamic creation of graphics</a></li>
+<li><a href="#index-DVIPSSIZES_0040r_007b_002c-overrides_007d-R-312"><code>DVIPSSIZES</code><span class="roman">, overrides</span><code> R</code></a>: <a href="#Configuration-file-commands">Configuration file commands</a></li>
+<li><a href="#index-dynamic-creation-of-graphics-410">dynamic creation of graphics</a>: <a href="#Dynamic-creation-of-graphics">Dynamic creation of graphics</a></li>
<li><a href="#index-e-_0040r_007bconfig-command-_0028maxdrift_0029_007d-273"><code>e </code><span class="roman">config command (maxdrift)</span></a>: <a href="#Configuration-file-commands">Configuration file commands</a></li>
<li><a href="#index-E-_0040r_007bconfig-command-_0028shell-escape_0029_007d-274"><code>E </code><span class="roman">config command (shell escape)</span></a>: <a href="#Configuration-file-commands">Configuration file commands</a></li>
-<li><a href="#index-efficiency_002c-and-fonts-569">efficiency, and fonts</a>: <a href="#Making-a-font-available">Making a font available</a></li>
+<li><a href="#index-efficiency_002c-and-fonts-572">efficiency, and fonts</a>: <a href="#Making-a-font-available">Making a font available</a></li>
<li><a href="#index-ehandler_002eps-54"><code>ehandler.ps</code></a>: <a href="#No-output">No output</a></li>
-<li><a href="#index-embedding-Type-1-fonts-484">embedding Type 1 fonts</a>: <a href="#Hypertext-caveats">Hypertext caveats</a></li>
-<li><a href="#index-encoding-changes-574">encoding changes</a>: <a href="#Changing-font-encodings">Changing font encodings</a></li>
-<li><a href="#index-encoding-file-format-600">encoding file format</a>: <a href="#Encoding-file-format">Encoding file format</a></li>
-<li><a href="#index-encoding-files-544">encoding files</a>: <a href="#Encodings">Encodings</a></li>
-<li><a href="#index-Encoding-_0040r_007bType-1-dictionary_007d-559"><code>Encoding </code><span class="roman">Type 1 dictionary</span></a>: <a href="#PostScript-typesetting">PostScript typesetting</a></li>
-<li><a href="#index-encoding-vectors_002c-defined-545">encoding vectors, defined</a>: <a href="#Encodings">Encodings</a></li>
-<li><a href="#index-encoding-vectors_002c-in-Type-1-fonts-558">encoding vectors, in Type 1 fonts</a>: <a href="#PostScript-typesetting">PostScript typesetting</a></li>
-<li><a href="#index-encodings-541">encodings</a>: <a href="#Encodings">Encodings</a></li>
-<li><a href="#index-end_002dhook-457"><code>end-hook</code></a>: <a href="#PostScript-hooks">PostScript hooks</a></li>
+<li><a href="#index-embedding-Type-1-fonts-487">embedding Type 1 fonts</a>: <a href="#Hypertext-caveats">Hypertext caveats</a></li>
+<li><a href="#index-encoding-changes-577">encoding changes</a>: <a href="#Changing-font-encodings">Changing font encodings</a></li>
+<li><a href="#index-encoding-file-format-603">encoding file format</a>: <a href="#Encoding-file-format">Encoding file format</a></li>
+<li><a href="#index-encoding-files-547">encoding files</a>: <a href="#Encodings">Encodings</a></li>
+<li><a href="#index-Encoding-_0040r_007bType-1-dictionary_007d-562"><code>Encoding </code><span class="roman">Type 1 dictionary</span></a>: <a href="#PostScript-typesetting">PostScript typesetting</a></li>
+<li><a href="#index-encoding-vectors_002c-defined-548">encoding vectors, defined</a>: <a href="#Encodings">Encodings</a></li>
+<li><a href="#index-encoding-vectors_002c-in-Type-1-fonts-561">encoding vectors, in Type 1 fonts</a>: <a href="#PostScript-typesetting">PostScript typesetting</a></li>
+<li><a href="#index-encodings-544">encodings</a>: <a href="#Encodings">Encodings</a></li>
+<li><a href="#index-end_002dhook-460"><code>end-hook</code></a>: <a href="#PostScript-hooks">PostScript hooks</a></li>
<li><a href="#index-environment-variables-244">environment variables</a>: <a href="#Environment-variables">Environment variables</a></li>
<li><a href="#index-EOF-124">EOF</a>: <a href="#Option-details">Option details</a></li>
-<li><a href="#index-eop_002dhook-455"><code>eop-hook</code></a>: <a href="#PostScript-hooks">PostScript hooks</a></li>
+<li><a href="#index-eop_002dhook-458"><code>eop-hook</code></a>: <a href="#PostScript-hooks">PostScript hooks</a></li>
<li><a href="#index-EPS_002c-and-Ghostview-43">EPS, and Ghostview</a>: <a href="#Ghostscript-installation">Ghostscript installation</a></li>
-<li><a href="#index-EPSF-macros-366">EPSF macros</a>: <a href="#EPSF-macros">EPSF macros</a></li>
+<li><a href="#index-EPSF-macros-369">EPSF macros</a>: <a href="#EPSF-macros">EPSF macros</a></li>
<li><a href="#index-EPSF_002c-generating-115">EPSF, generating</a>: <a href="#Option-details">Option details</a></li>
-<li><a href="#index-epsf_002esty-369"><code>epsf.sty</code></a>: <a href="#EPSF-macros">EPSF macros</a></li>
-<li><a href="#index-epsf_002etex-368"><code>epsf.tex</code></a>: <a href="#EPSF-macros">EPSF macros</a></li>
+<li><a href="#index-epsf_002esty-372"><code>epsf.sty</code></a>: <a href="#EPSF-macros">EPSF macros</a></li>
+<li><a href="#index-epsf_002etex-371"><code>epsf.tex</code></a>: <a href="#EPSF-macros">EPSF macros</a></li>
<li><a href="#index-Epson-printers-34">Epson printers</a>: <a href="#Ghostscript-installation">Ghostscript installation</a></li>
<li><a href="#index-error-messages-from-printer-64">error messages from printer</a>: <a href="#Printer-errors">Printer errors</a></li>
<li><a href="#index-even-pages-only-97">even pages only</a>: <a href="#Option-details">Option details</a></li>
-<li><a href="#index-examples-of-literal-PostScript-463">examples of literal PostScript</a>: <a href="#Literal-examples">Literal examples</a></li>
-<li><a href="#index-expanded-fonts-650">expanded fonts</a>: <a href="#psfonts_002emap">psfonts.map</a></li>
-<li><a href="#index-expanded-fonts-626">expanded fonts</a>: <a href="#Afm2tfm-options">Afm2tfm options</a></li>
-<li><a href="#index-expanded-fonts-612">expanded fonts</a>: <a href="#Special-font-effects">Special font effects</a></li>
-<li><a href="#index-expansion_002c-of-virtual-fonts-539">expansion, of virtual fonts</a>: <a href="#Virtual-fonts">Virtual fonts</a></li>
-<li><a href="#index-extended-URL-493">extended URL</a>: <a href="#Hypertext-specials">Hypertext specials</a></li>
-<li><a href="#index-ExtendFont-614"><code>ExtendFont</code></a>: <a href="#Special-font-effects">Special font effects</a></li>
-<li><a href="#index-extra-characters_002c-accessing-585">extra characters, accessing</a>: <a href="#Changing-PostScript-encodings">Changing PostScript encodings</a></li>
+<li><a href="#index-examples-of-literal-PostScript-466">examples of literal PostScript</a>: <a href="#Literal-examples">Literal examples</a></li>
+<li><a href="#index-expanded-fonts-647">expanded fonts</a>: <a href="#psfonts_002emap">psfonts.map</a></li>
+<li><a href="#index-expanded-fonts-629">expanded fonts</a>: <a href="#Afm2tfm-options">Afm2tfm options</a></li>
+<li><a href="#index-expanded-fonts-615">expanded fonts</a>: <a href="#Special-font-effects">Special font effects</a></li>
+<li><a href="#index-expansion_002c-of-virtual-fonts-542">expansion, of virtual fonts</a>: <a href="#Virtual-fonts">Virtual fonts</a></li>
+<li><a href="#index-extended-URL-496">extended URL</a>: <a href="#Hypertext-specials">Hypertext specials</a></li>
+<li><a href="#index-ExtendFont-617"><code>ExtendFont</code></a>: <a href="#Special-font-effects">Special font effects</a></li>
+<li><a href="#index-extra-characters_002c-accessing-588">extra characters, accessing</a>: <a href="#Changing-PostScript-encodings">Changing PostScript encodings</a></li>
<li><a href="#index-F-_0040r_007bconfig-command-_0028filter_0029_007d-279"><code>F </code><span class="roman">config command (filter)</span></a>: <a href="#Configuration-file-commands">Configuration file commands</a></li>
<li><a href="#index-f-_0040r_007bconfig-command-_0028filter_0029_007d-278"><code>f </code><span class="roman">config command (filter)</span></a>: <a href="#Configuration-file-commands">Configuration file commands</a></li>
<li><a href="#index-failure_002c-and-printer-errors-65">failure, and printer errors</a>: <a href="#Printer-errors">Printer errors</a></li>
<li><a href="#index-failure_002c-of-long-documents-71">failure, of long documents</a>: <a href="#Long-documents-fail">Long documents fail</a></li>
<li><a href="#index-failure_002c-to-include-graphics-74">failure, to include graphics</a>: <a href="#Including-graphics-fails">Including graphics fails</a></li>
<li><a href="#index-failure_002c-to-print-at-all-53">failure, to print at all</a>: <a href="#No-output">No output</a></li>
-<li><a href="#index-fallback-resolutions-308">fallback resolutions</a>: <a href="#Configuration-file-commands">Configuration file commands</a></li>
-<li><a href="#index-figures-and-fonts-411">figures and fonts</a>: <a href="#Fonts-in-figures">Fonts in figures</a></li>
-<li><a href="#index-figures_002c-natural-size-373">figures, natural size</a>: <a href="#EPSF-macros">EPSF macros</a></li>
-<li><a href="#index-figures_002c-scaling-377">figures, scaling</a>: <a href="#EPSF-scaling">EPSF scaling</a></li>
+<li><a href="#index-fallback-resolutions-309">fallback resolutions</a>: <a href="#Configuration-file-commands">Configuration file commands</a></li>
+<li><a href="#index-figures-and-fonts-414">figures and fonts</a>: <a href="#Fonts-in-figures">Fonts in figures</a></li>
+<li><a href="#index-figures_002c-natural-size-376">figures, natural size</a>: <a href="#EPSF-macros">EPSF macros</a></li>
+<li><a href="#index-figures_002c-scaling-380">figures, scaling</a>: <a href="#EPSF-scaling">EPSF scaling</a></li>
<li><a href="#index-filter_002c-running-as-a-119">filter, running as a</a>: <a href="#Option-details">Option details</a></li>
<li><a href="#index-first-page-printed-186">first page printed</a>: <a href="#Option-details">Option details</a></li>
-<li><a href="#index-font-concepts-505">font concepts</a>: <a href="#Font-concepts">Font concepts</a></li>
+<li><a href="#index-font-concepts-508">font concepts</a>: <a href="#Font-concepts">Font concepts</a></li>
<li><a href="#index-font-generation_002c-avoiding-157">font generation, avoiding</a>: <a href="#Option-details">Option details</a></li>
-<li><a href="#index-fontinst-571"><code>fontinst</code></a>: <a href="#Invoking-afm2tfm">Invoking afm2tfm</a></li>
-<li><a href="#index-fonts_002c-as-header-files-425">fonts, as header files</a>: <a href="#Including-headers-from-TeX">Including headers from TeX</a></li>
-<li><a href="#index-fonts_002c-changing-encoding-of-575">fonts, changing encoding of</a>: <a href="#Changing-font-encodings">Changing font encodings</a></li>
-<li><a href="#index-fonts_002c-downloading-641">fonts, downloading</a>: <a href="#psfonts_002emap">psfonts.map</a></li>
-<li><a href="#index-fonts_002c-expanded-613">fonts, expanded</a>: <a href="#Special-font-effects">Special font effects</a></li>
-<li><a href="#index-fonts_002c-in-PostScript-figures-412">fonts, in PostScript figures</a>: <a href="#Fonts-in-figures">Fonts in figures</a></li>
+<li><a href="#index-fontinst-574"><code>fontinst</code></a>: <a href="#Invoking-afm2tfm">Invoking afm2tfm</a></li>
+<li><a href="#index-fonts_002c-as-header-files-428">fonts, as header files</a>: <a href="#Including-headers-from-TeX">Including headers from TeX</a></li>
+<li><a href="#index-fonts_002c-changing-encoding-of-578">fonts, changing encoding of</a>: <a href="#Changing-font-encodings">Changing font encodings</a></li>
+<li><a href="#index-fonts_002c-downloading-644">fonts, downloading</a>: <a href="#psfonts_002emap">psfonts.map</a></li>
+<li><a href="#index-fonts_002c-expanded-616">fonts, expanded</a>: <a href="#Special-font-effects">Special font effects</a></li>
+<li><a href="#index-fonts_002c-in-PostScript-figures-415">fonts, in PostScript figures</a>: <a href="#Fonts-in-figures">Fonts in figures</a></li>
<li><a href="#index-fonts_002c-installation-of-PostScript-15">fonts, installation of PostScript</a>: <a href="#PostScript-font-installation">PostScript font installation</a></li>
-<li><a href="#index-fonts_002c-installing-565">fonts, installing</a>: <a href="#Making-a-font-available">Making a font available</a></li>
-<li><a href="#index-fonts_002c-outlined-619">fonts, outlined</a>: <a href="#Special-font-effects">Special font effects</a></li>
-<li><a href="#index-fonts_002c-slanted-609">fonts, slanted</a>: <a href="#Special-font-effects">Special font effects</a></li>
-<li><a href="#index-fonts_002c-small-caps-616">fonts, small caps</a>: <a href="#Special-font-effects">Special font effects</a></li>
+<li><a href="#index-fonts_002c-installing-568">fonts, installing</a>: <a href="#Making-a-font-available">Making a font available</a></li>
+<li><a href="#index-fonts_002c-outlined-622">fonts, outlined</a>: <a href="#Special-font-effects">Special font effects</a></li>
+<li><a href="#index-fonts_002c-slanted-612">fonts, slanted</a>: <a href="#Special-font-effects">Special font effects</a></li>
+<li><a href="#index-fonts_002c-small-caps-619">fonts, small caps</a>: <a href="#Special-font-effects">Special font effects</a></li>
<li><a href="#index-fonts_002c-system-PostScript-27">fonts, system PostScript</a>: <a href="#PostScript-font-installation">PostScript font installation</a></li>
-<li><a href="#index-gf-files-533">gf files</a>: <a href="#Glyph-files">Glyph files</a></li>
-<li><a href="#index-gftopk-534"><code>gftopk</code></a>: <a href="#Glyph-files">Glyph files</a></li>
+<li><a href="#index-G-_0040r_007bcharacter-shifting-config-command_007d-280"><code>G </code><span class="roman">character shifting config command</span></a>: <a href="#Configuration-file-commands">Configuration file commands</a></li>
+<li><a href="#index-gf-files-536">gf files</a>: <a href="#Glyph-files">Glyph files</a></li>
+<li><a href="#index-gftopk-537"><code>gftopk</code></a>: <a href="#Glyph-files">Glyph files</a></li>
<li><a href="#index-Ghostscript-installation-31">Ghostscript installation</a>: <a href="#Ghostscript-installation">Ghostscript installation</a></li>
<li><a href="#index-ghostview-41"><code>ghostview</code></a>: <a href="#Ghostscript-installation">Ghostscript installation</a></li>
<li><a href="#index-Ghostview_002c-and-no-_0040samp_007bN_007d-42">Ghostview, and no &lsquo;<samp><span class="samp">N</span></samp>&rsquo;</a>: <a href="#Ghostscript-installation">Ghostscript installation</a></li>
-<li><a href="#index-glyph-files-519">glyph files</a>: <a href="#Glyph-files">Glyph files</a></li>
-<li><a href="#index-GLYPHFONTS_0040r_007b_002c-overrides_007d-P-302"><code>GLYPHFONTS</code><span class="roman">, overrides</span><code> P</code></a>: <a href="#Configuration-file-commands">Configuration file commands</a></li>
+<li><a href="#index-glyph-files-522">glyph files</a>: <a href="#Glyph-files">Glyph files</a></li>
+<li><a href="#index-GLYPHFONTS_0040r_007b_002c-overrides_007d-P-303"><code>GLYPHFONTS</code><span class="roman">, overrides</span><code> P</code></a>: <a href="#Configuration-file-commands">Configuration file commands</a></li>
<li><a href="#index-GNU-Ghostscript-39">GNU Ghostscript</a>: <a href="#Ghostscript-installation">Ghostscript installation</a></li>
-<li><a href="#index-gnuplot-410"><code>gnuplot</code></a>: <a href="#Dynamic-creation-of-graphics">Dynamic creation of graphics</a></li>
+<li><a href="#index-gnuplot-413"><code>gnuplot</code></a>: <a href="#Dynamic-creation-of-graphics">Dynamic creation of graphics</a></li>
<li><a href="#index-graphics-inclusion-fails-73">graphics inclusion fails</a>: <a href="#Including-graphics-fails">Including graphics fails</a></li>
<li><a href="#index-gs-_0040r_007binstallation_007d-32"><code>gs </code><span class="roman">installation</span></a>: <a href="#Ghostscript-installation">Ghostscript installation</a></li>
-<li><a href="#index-gsave_0040r_007b_002f_007dgrestore_0040r_007b_002c-and-literal-PS_007d-465"><code>gsave</code><span class="roman">/</span><code>grestore</code><span class="roman">, and literal PS</span></a>: <a href="#Literal-examples">Literal examples</a></li>
+<li><a href="#index-gsave_0040r_007b_002f_007dgrestore_0040r_007b_002c-and-literal-PS_007d-468"><code>gsave</code><span class="roman">/</span><code>grestore</code><span class="roman">, and literal PS</span></a>: <a href="#Literal-examples">Literal examples</a></li>
<li><a href="#index-gsftopk-228"><code>gsftopk</code></a>: <a href="#Option-details">Option details</a></li>
-<li><a href="#index-h-_0040r_007bheader-downloading-config-command_007d-280"><code>h </code><span class="roman">header downloading config command</span></a>: <a href="#Configuration-file-commands">Configuration file commands</a></li>
-<li><a href="#index-H-_0040r_007bheader-path-config-command_007d-281"><code>H </code><span class="roman">header path config command</span></a>: <a href="#Configuration-file-commands">Configuration file commands</a></li>
-<li><a href="#index-Hafner_002c-Jim-662">Hafner, Jim</a>: <a href="#Color">Color</a></li>
+<li><a href="#index-h-_0040r_007bheader-downloading-config-command_007d-281"><code>h </code><span class="roman">header downloading config command</span></a>: <a href="#Configuration-file-commands">Configuration file commands</a></li>
+<li><a href="#index-H-_0040r_007bheader-path-config-command_007d-282"><code>H </code><span class="roman">header path config command</span></a>: <a href="#Configuration-file-commands">Configuration file commands</a></li>
+<li><a href="#index-Hafner_002c-Jim-665">Hafner, Jim</a>: <a href="#Color">Color</a></li>
<li><a href="#index-header-file_002c-downloading-132">header file, downloading</a>: <a href="#Option-details">Option details</a></li>
-<li><a href="#index-header-files_002c-defined-414">header files, defined</a>: <a href="#Header-files">Header files</a></li>
-<li><a href="#index-header-path_002c-defining-282">header path, defining</a>: <a href="#Configuration-file-commands">Configuration file commands</a></li>
-<li><a href="#index-header_003d_0040var_007bfile_007d-_005cspecial-422"><code>header=</code><var>file</var><code> \special</code></a>: <a href="#Including-headers-from-TeX">Including headers from TeX</a></li>
-<li><a href="#index-headers-and-memory-usage-436">headers and memory usage</a>: <a href="#Headers-and-memory-usage">Headers and memory usage</a></li>
-<li><a href="#index-headers_002c-including-from-the-command-line-432">headers, including from the command line</a>: <a href="#Including-headers-from-the-command-line">Including headers from the command line</a></li>
-<li><a href="#index-headers_002c-including-in-_0040TeX_007b_007d-424">headers, including in TeX</a>: <a href="#Including-headers-from-TeX">Including headers from TeX</a></li>
-<li><a href="#index-hints-562">hints</a>: <a href="#PostScript-typesetting">PostScript typesetting</a></li>
-<li><a href="#index-hoffset-_0040r_007b_0028_0040samp_007bpsfile_007d-special-option_0029_007d-391"><code>hoffset </code><span class="roman">(&lsquo;</span><samp><span class="samp">psfile</span></samp><span class="roman">&rsquo; special option)</span></a>: <a href="#psfile-special">psfile special</a></li>
+<li><a href="#index-header-files_002c-defined-417">header files, defined</a>: <a href="#Header-files">Header files</a></li>
+<li><a href="#index-header-path_002c-defining-283">header path, defining</a>: <a href="#Configuration-file-commands">Configuration file commands</a></li>
+<li><a href="#index-header_003d_0040var_007bfile_007d-_005cspecial-425"><code>header=</code><var>file</var><code> \special</code></a>: <a href="#Including-headers-from-TeX">Including headers from TeX</a></li>
+<li><a href="#index-headers-and-memory-usage-439">headers and memory usage</a>: <a href="#Headers-and-memory-usage">Headers and memory usage</a></li>
+<li><a href="#index-headers_002c-including-from-the-command-line-435">headers, including from the command line</a>: <a href="#Including-headers-from-the-command-line">Including headers from the command line</a></li>
+<li><a href="#index-headers_002c-including-in-_0040TeX_007b_007d-427">headers, including in TeX</a>: <a href="#Including-headers-from-TeX">Including headers from TeX</a></li>
+<li><a href="#index-hints-565">hints</a>: <a href="#PostScript-typesetting">PostScript typesetting</a></li>
+<li><a href="#index-hoffset-_0040r_007b_0028_0040samp_007bpsfile_007d-special-option_0029_007d-394"><code>hoffset </code><span class="roman">(&lsquo;</span><samp><span class="samp">psfile</span></samp><span class="roman">&rsquo; special option)</span></a>: <a href="#psfile-special">psfile special</a></li>
<li><a href="#index-HP-printers-and-Type-1-fonts-30">HP printers and Type 1 fonts</a>: <a href="#PostScript-font-installation">PostScript font installation</a></li>
-<li><a href="#index-HP4Si-printer-and-paper-trays-348">HP4Si printer and paper trays</a>: <a href="#Paper-trays">Paper trays</a></li>
-<li><a href="#index-href-497"><code>href</code></a>: <a href="#Hypertext-specials">Hypertext specials</a></li>
-<li><a href="#index-hscale-_0040r_007b_0028_0040samp_007bpsfile_007d-special-option_0029_007d-395"><code>hscale </code><span class="roman">(&lsquo;</span><samp><span class="samp">psfile</span></samp><span class="roman">&rsquo; special option)</span></a>: <a href="#psfile-special">psfile special</a></li>
-<li><a href="#index-hsize-_0040r_007b_0028_0040samp_007bpsfile_007d-special-option_0029_007d-393"><code>hsize </code><span class="roman">(&lsquo;</span><samp><span class="samp">psfile</span></samp><span class="roman">&rsquo; special option)</span></a>: <a href="#psfile-special">psfile special</a></li>
-<li><a href="#index-html-_0040r_007bspecials_007d-469"><code>html </code><span class="roman">specials</span></a>: <a href="#Hypertext">Hypertext</a></li>
+<li><a href="#index-HP4Si-printer-and-paper-trays-351">HP4Si printer and paper trays</a>: <a href="#Paper-trays">Paper trays</a></li>
+<li><a href="#index-href-500"><code>href</code></a>: <a href="#Hypertext-specials">Hypertext specials</a></li>
+<li><a href="#index-hscale-_0040r_007b_0028_0040samp_007bpsfile_007d-special-option_0029_007d-398"><code>hscale </code><span class="roman">(&lsquo;</span><samp><span class="samp">psfile</span></samp><span class="roman">&rsquo; special option)</span></a>: <a href="#psfile-special">psfile special</a></li>
+<li><a href="#index-hsize-_0040r_007b_0028_0040samp_007bpsfile_007d-special-option_0029_007d-396"><code>hsize </code><span class="roman">(&lsquo;</span><samp><span class="samp">psfile</span></samp><span class="roman">&rsquo; special option)</span></a>: <a href="#psfile-special">psfile special</a></li>
+<li><a href="#index-html-_0040r_007bspecials_007d-472"><code>html </code><span class="roman">specials</span></a>: <a href="#Hypertext">Hypertext</a></li>
<li><a href="#index-html-_0040r_007bspecials_002c-and-_0040samp_007b_002dz_007d_007d-241"><code>html </code><span class="roman">specials, and &lsquo;</span><samp><span class="samp">-z</span></samp><span class="roman">&rsquo;</span></a>: <a href="#Option-details">Option details</a></li>
-<li><a href="#index-g_t_0040code_007bhttp_003a_002f_002fwww_002ewin_002etue_002enl_002f_007edickie_002fidvi_007d-473"><code>http://www.win.tue.nl/~dickie/idvi</code></a>: <a href="#Hypertext">Hypertext</a></li>
-<li><a href="#index-g_t_0040code_007bhttp_003a_002f_002fxxx_002elanl_002egov_002fhypertex_007d-474"><code>http://xxx.lanl.gov/hypertex</code></a>: <a href="#Hypertext">Hypertext</a></li>
-<li><a href="#index-Hungarian-umlaut-591">Hungarian umlaut</a>: <a href="#Reencoding-with-Afm2tfm">Reencoding with Afm2tfm</a></li>
+<li><a href="#index-g_t_0040code_007bhttp_003a_002f_002fwww_002ewin_002etue_002enl_002f_007edickie_002fidvi_007d-476"><code>http://www.win.tue.nl/~dickie/idvi</code></a>: <a href="#Hypertext">Hypertext</a></li>
+<li><a href="#index-g_t_0040code_007bhttp_003a_002f_002fxxx_002elanl_002egov_002fhypertex_007d-477"><code>http://xxx.lanl.gov/hypertex</code></a>: <a href="#Hypertext">Hypertext</a></li>
+<li><a href="#index-Hungarian-umlaut-594">Hungarian umlaut</a>: <a href="#Reencoding-with-Afm2tfm">Reencoding with Afm2tfm</a></li>
<li><a href="#index-hyperdvi-extensions_002c-enabling-238">hyperdvi extensions, enabling</a>: <a href="#Option-details">Option details</a></li>
-<li><a href="#index-hypertext-and-bitmap-fonts-482">hypertext and bitmap fonts</a>: <a href="#Hypertext-caveats">Hypertext caveats</a></li>
-<li><a href="#index-hypertext-caveats-480">hypertext caveats</a>: <a href="#Hypertext-caveats">Hypertext caveats</a></li>
-<li><a href="#index-hypertext-specials-489">hypertext specials</a>: <a href="#Hypertext-specials">Hypertext specials</a></li>
-<li><a href="#index-hypertext-support-467">hypertext support</a>: <a href="#Hypertext">Hypertext</a></li>
-<li><a href="#index-i-_0040r_007bconfig-command-_0028pages_002fsection_0029_007d-284"><code>i </code><span class="roman">config command (pages/section)</span></a>: <a href="#Configuration-file-commands">Configuration file commands</a></li>
-<li><a href="#index-idvi-_0040r_007bJava-DVI-reader_007d-478"><code>idvi </code><span class="roman">Java DVI reader</span></a>: <a href="#Hypertext">Hypertext</a></li>
+<li><a href="#index-hypertext-and-bitmap-fonts-485">hypertext and bitmap fonts</a>: <a href="#Hypertext-caveats">Hypertext caveats</a></li>
+<li><a href="#index-hypertext-caveats-483">hypertext caveats</a>: <a href="#Hypertext-caveats">Hypertext caveats</a></li>
+<li><a href="#index-hypertext-specials-492">hypertext specials</a>: <a href="#Hypertext-specials">Hypertext specials</a></li>
+<li><a href="#index-hypertext-support-470">hypertext support</a>: <a href="#Hypertext">Hypertext</a></li>
+<li><a href="#index-i-_0040r_007bconfig-command-_0028pages_002fsection_0029_007d-285"><code>i </code><span class="roman">config command (pages/section)</span></a>: <a href="#Configuration-file-commands">Configuration file commands</a></li>
+<li><a href="#index-idvi-_0040r_007bJava-DVI-reader_007d-481"><code>idvi </code><span class="roman">Java DVI reader</span></a>: <a href="#Hypertext">Hypertext</a></li>
<li><a href="#index-Illustrator_002c-workaround-for-75">Illustrator, workaround for</a>: <a href="#Including-graphics-fails">Including graphics fails</a></li>
-<li><a href="#index-img-501"><code>img</code></a>: <a href="#Hypertext-specials">Hypertext specials</a></li>
+<li><a href="#index-img-504"><code>img</code></a>: <a href="#Hypertext-specials">Hypertext specials</a></li>
<li><a href="#index-including-graphics-fails-72">including graphics fails</a>: <a href="#Including-graphics-fails">Including graphics fails</a></li>
-<li><a href="#index-including-headers-from-the-command-line-430">including headers from the command line</a>: <a href="#Including-headers-from-the-command-line">Including headers from the command line</a></li>
-<li><a href="#index-including-headers-in-_0040TeX_007b_007d-421">including headers in TeX</a>: <a href="#Including-headers-from-TeX">Including headers from TeX</a></li>
+<li><a href="#index-including-headers-from-the-command-line-433">including headers from the command line</a>: <a href="#Including-headers-from-the-command-line">Including headers from the command line</a></li>
+<li><a href="#index-including-headers-in-_0040TeX_007b_007d-424">including headers in TeX</a>: <a href="#Including-headers-from-TeX">Including headers from TeX</a></li>
<li><a href="#index-installation-of-_0040file_007bconfig_002eps_007d-6">installation of <samp><span class="file">config.ps</span></samp></a>: <a href="#config_002eps-installation">config.ps installation</a></li>
<li><a href="#index-installation-of-PostScript-fonts-14">installation of PostScript fonts</a>: <a href="#PostScript-font-installation">PostScript font installation</a></li>
<li><a href="#index-installation_002c-of-Dvips-4">installation, of Dvips</a>: <a href="#Installation">Installation</a></li>
-<li><a href="#index-installing-fonts-564">installing fonts</a>: <a href="#Making-a-font-available">Making a font available</a></li>
-<li><a href="#index-interaction-with-PostScript-351">interaction with PostScript</a>: <a href="#Interaction-with-PostScript">Interaction with PostScript</a></li>
+<li><a href="#index-installing-fonts-567">installing fonts</a>: <a href="#Making-a-font-available">Making a font available</a></li>
+<li><a href="#index-interaction-with-PostScript-354">interaction with PostScript</a>: <a href="#Interaction-with-PostScript">Interaction with PostScript</a></li>
<li><a href="#index-inverted-output-60">inverted output</a>: <a href="#Small-or-inverted">Small or inverted</a></li>
<li><a href="#index-invoking-Dvips-79">invoking Dvips</a>: <a href="#Invoking-Dvips">Invoking Dvips</a></li>
-<li><a href="#index-j-_0040r_007bconfig-command-_0028partial-font-downloading_0029_007d-285"><code>j </code><span class="roman">config command (partial font downloading)</span></a>: <a href="#Configuration-file-commands">Configuration file commands</a></li>
-<li><a href="#index-Java-DVI-reader-477">Java DVI reader</a>: <a href="#Hypertext">Hypertext</a></li>
-<li><a href="#index-Jeffrey_002c-Alan-573">Jeffrey, Alan</a>: <a href="#Invoking-afm2tfm">Invoking afm2tfm</a></li>
-<li><a href="#index-K-_0040r_007bconfig-command-_0028comment_002dremoveal_0029_007d-286"><code>K </code><span class="roman">config command (comment-removeal)</span></a>: <a href="#Configuration-file-commands">Configuration file commands</a></li>
-<li><a href="#index-kerning_002c-defined-507">kerning, defined</a>: <a href="#Metric-files">Metric files</a></li>
+<li><a href="#index-j-_0040r_007bconfig-command-_0028partial-font-downloading_0029_007d-286"><code>j </code><span class="roman">config command (partial font downloading)</span></a>: <a href="#Configuration-file-commands">Configuration file commands</a></li>
+<li><a href="#index-Java-DVI-reader-480">Java DVI reader</a>: <a href="#Hypertext">Hypertext</a></li>
+<li><a href="#index-Jeffrey_002c-Alan-576">Jeffrey, Alan</a>: <a href="#Invoking-afm2tfm">Invoking afm2tfm</a></li>
+<li><a href="#index-K-_0040r_007bconfig-command-_0028comment_002dremoval_0029_007d-287"><code>K </code><span class="roman">config command (comment-removal)</span></a>: <a href="#Configuration-file-commands">Configuration file commands</a></li>
+<li><a href="#index-kerning_002c-defined-510">kerning, defined</a>: <a href="#Metric-files">Metric files</a></li>
<li><a href="#index-KPATHSEA_005fDEBUG-246"><code>KPATHSEA_DEBUG</code></a>: <a href="#Environment-variables">Environment variables</a></li>
-<li><a href="#index-landscape-orientation_002c-defined-332">landscape orientation, defined</a>: <a href="#Paper-size-and-landscape">Paper size and landscape</a></li>
+<li><a href="#index-landscape-orientation_002c-defined-333">landscape orientation, defined</a>: <a href="#Paper-size-and-landscape">Paper size and landscape</a></li>
<li><a href="#index-landscape-papertype-217">landscape papertype</a>: <a href="#Option-details">Option details</a></li>
-<li><a href="#index-landscape_0040r_007b_002c-as-_0040code_007b_005cspecial_007d_007d-335"><code>landscape</code><span class="roman">, as </span><code>\special</code></a>: <a href="#papersize-special">papersize special</a></li>
+<li><a href="#index-landscape_0040r_007b_002c-as-_0040code_007b_005cspecial_007d_007d-336"><code>landscape</code><span class="roman">, as </span><code>\special</code></a>: <a href="#papersize-special">papersize special</a></li>
<li><a href="#index-last-page-printed-146">last page printed</a>: <a href="#Option-details">Option details</a></li>
<li><a href="#index-last_002dresort-font-scaling_002c-with-_0040code_007bDVIPSSIZES_007d-253">last-resort font scaling, with <code>DVIPSSIZES</code></a>: <a href="#Environment-variables">Environment variables</a></li>
-<li><a href="#index-last_002dresort-scaling_002c-with-_0040code_007bR_007d-310">last-resort scaling, with <code>R</code></a>: <a href="#Configuration-file-commands">Configuration file commands</a></li>
+<li><a href="#index-last_002dresort-scaling_002c-with-_0040code_007bR_007d-311">last-resort scaling, with <code>R</code></a>: <a href="#Configuration-file-commands">Configuration file commands</a></li>
<li><a href="#index-ledger-papertype-214">ledger papertype</a>: <a href="#Option-details">Option details</a></li>
<li><a href="#index-legal-papertype-213">legal papertype</a>: <a href="#Option-details">Option details</a></li>
-<li><a href="#index-letter-_0040r_007bpaper-size_007d-341"><code>letter </code><span class="roman">paper size</span></a>: <a href="#Config-file-paper-sizes">Config file paper sizes</a></li>
+<li><a href="#index-letter-_0040r_007bpaper-size_007d-344"><code>letter </code><span class="roman">paper size</span></a>: <a href="#Config-file-paper-sizes">Config file paper sizes</a></li>
<li><a href="#index-letter-papertype-212">letter papertype</a>: <a href="#Option-details">Option details</a></li>
-<li><a href="#index-letterhead-tray-350">letterhead tray</a>: <a href="#Paper-trays">Paper trays</a></li>
-<li><a href="#index-letterSize-_0040r_007bpaper-size_007d-343"><code>letterSize </code><span class="roman">paper size</span></a>: <a href="#Config-file-paper-sizes">Config file paper sizes</a></li>
-<li><a href="#index-ligature-operations-604">ligature operations</a>: <a href="#Encoding-file-format">Encoding file format</a></li>
-<li><a href="#index-ligature_002c-defined-508">ligature, defined</a>: <a href="#Metric-files">Metric files</a></li>
-<li><a href="#index-LIGKERN-_0040r_007bencoding-file-command_007d-602"><code>LIGKERN </code><span class="roman">encoding file command</span></a>: <a href="#Encoding-file-format">Encoding file format</a></li>
-<li><a href="#index-lines-in-figures_002c-wrong-width-389">lines in figures, wrong width</a>: <a href="#EPSF-clipping">EPSF clipping</a></li>
-<li><a href="#index-links_002c-hypertext-498">links, hypertext</a>: <a href="#Hypertext-specials">Hypertext specials</a></li>
-<li><a href="#index-literal-headers-449">literal headers</a>: <a href="#Literal-headers">Literal headers</a></li>
-<li><a href="#index-literal-PostScript_002c-examples-462">literal PostScript, examples</a>: <a href="#Literal-examples">Literal examples</a></li>
-<li><a href="#index-literal-PostScript_002c-using-442">literal PostScript, using</a>: <a href="#Literal-PS">Literal PS</a></li>
-<li><a href="#index-llx-_0040r_007b_0028_0040samp_007bpsfile_007d-special-option_0029_007d-399"><code>llx </code><span class="roman">(&lsquo;</span><samp><span class="samp">psfile</span></samp><span class="roman">&rsquo; special option)</span></a>: <a href="#psfile-special">psfile special</a></li>
-<li><a href="#index-lly-_0040r_007b_0028_0040samp_007bpsfile_007d-special-option_0029_007d-400"><code>lly </code><span class="roman">(&lsquo;</span><samp><span class="samp">psfile</span></samp><span class="roman">&rsquo; special option)</span></a>: <a href="#psfile-special">psfile special</a></li>
+<li><a href="#index-letterhead-tray-353">letterhead tray</a>: <a href="#Paper-trays">Paper trays</a></li>
+<li><a href="#index-letterSize-_0040r_007bpaper-size_007d-346"><code>letterSize </code><span class="roman">paper size</span></a>: <a href="#Config-file-paper-sizes">Config file paper sizes</a></li>
+<li><a href="#index-ligature-operations-607">ligature operations</a>: <a href="#Encoding-file-format">Encoding file format</a></li>
+<li><a href="#index-ligature_002c-defined-511">ligature, defined</a>: <a href="#Metric-files">Metric files</a></li>
+<li><a href="#index-LIGKERN-_0040r_007bencoding-file-command_007d-605"><code>LIGKERN </code><span class="roman">encoding file command</span></a>: <a href="#Encoding-file-format">Encoding file format</a></li>
+<li><a href="#index-lines-in-figures_002c-wrong-width-392">lines in figures, wrong width</a>: <a href="#EPSF-clipping">EPSF clipping</a></li>
+<li><a href="#index-links_002c-hypertext-501">links, hypertext</a>: <a href="#Hypertext-specials">Hypertext specials</a></li>
+<li><a href="#index-literal-headers-452">literal headers</a>: <a href="#Literal-headers">Literal headers</a></li>
+<li><a href="#index-literal-PostScript_002c-examples-465">literal PostScript, examples</a>: <a href="#Literal-examples">Literal examples</a></li>
+<li><a href="#index-literal-PostScript_002c-using-445">literal PostScript, using</a>: <a href="#Literal-PS">Literal PS</a></li>
+<li><a href="#index-llx-_0040r_007b_0028_0040samp_007bpsfile_007d-special-option_0029_007d-402"><code>llx </code><span class="roman">(&lsquo;</span><samp><span class="samp">psfile</span></samp><span class="roman">&rsquo; special option)</span></a>: <a href="#psfile-special">psfile special</a></li>
+<li><a href="#index-lly-_0040r_007b_0028_0040samp_007bpsfile_007d-special-option_0029_007d-403"><code>lly </code><span class="roman">(&lsquo;</span><samp><span class="samp">psfile</span></samp><span class="roman">&rsquo; special option)</span></a>: <a href="#psfile-special">psfile special</a></li>
<li><a href="#index-long-documents-not-printing-70">long documents not printing</a>: <a href="#Long-documents-fail">Long documents fail</a></li>
<li><a href="#index-low-characters_002c-shifting-129">low characters, shifting</a>: <a href="#Option-details">Option details</a></li>
<li><a href="#index-lpr-spooler_002c-MS_002dDOS-emulation-178">lpr spooler, MS-DOS emulation</a>: <a href="#Option-details">Option details</a></li>
<li><a href="#index-Lucida_002c-installing-19">Lucida, installing</a>: <a href="#PostScript-font-installation">PostScript font installation</a></li>
-<li><a href="#index-m-_0040r_007bconfig-command-_0028available-memory_0029_007d-287"><code>m </code><span class="roman">config command (available memory)</span></a>: <a href="#Configuration-file-commands">Configuration file commands</a></li>
-<li><a href="#index-M-_0040r_007bconfig-command-_0028mf-mode_0029_007d-290"><code>M </code><span class="roman">config command (mf mode)</span></a>: <a href="#Configuration-file-commands">Configuration file commands</a></li>
-<li><a href="#index-macros-for-color-663">macros for color</a>: <a href="#Color-macro-files">Color macro files</a></li>
-<li><a href="#index-macros-for-epsf-inclusion-367">macros for epsf inclusion</a>: <a href="#EPSF-macros">EPSF macros</a></li>
-<li><a href="#index-macros-for-epsf-inclusion-364">macros for epsf inclusion</a>: <a href="#g_t_005cincludegraphics">\includegraphics</a></li>
-<li><a href="#index-magnification_002c-DVI-382">magnification, DVI</a>: <a href="#EPSF-scaling">EPSF scaling</a></li>
+<li><a href="#index-m-_0040r_007bconfig-command-_0028available-memory_0029_007d-288"><code>m </code><span class="roman">config command (available memory)</span></a>: <a href="#Configuration-file-commands">Configuration file commands</a></li>
+<li><a href="#index-M-_0040r_007bconfig-command-_0028mf-mode_0029_007d-291"><code>M </code><span class="roman">config command (mf mode)</span></a>: <a href="#Configuration-file-commands">Configuration file commands</a></li>
+<li><a href="#index-macros-for-color-666">macros for color</a>: <a href="#Color-macro-files">Color macro files</a></li>
+<li><a href="#index-macros-for-epsf-inclusion-370">macros for epsf inclusion</a>: <a href="#EPSF-macros">EPSF macros</a></li>
+<li><a href="#index-macros-for-epsf-inclusion-367">macros for epsf inclusion</a>: <a href="#g_t_005cincludegraphics">\includegraphics</a></li>
+<li><a href="#index-magnification_002c-DVI-385">magnification, DVI</a>: <a href="#EPSF-scaling">EPSF scaling</a></li>
<li><a href="#index-magnification_002c-overriding-DVI-231">magnification, overriding DVI</a>: <a href="#Option-details">Option details</a></li>
<li><a href="#index-magnification_002c-vertical-234">magnification, vertical</a>: <a href="#Option-details">Option details</a></li>
-<li><a href="#index-mailcap-_0040r_007band-hypertext_007d-502"><code>mailcap </code><span class="roman">and hypertext</span></a>: <a href="#Hypertext-specials">Hypertext specials</a></li>
+<li><a href="#index-mailcap-_0040r_007band-hypertext_007d-505"><code>mailcap </code><span class="roman">and hypertext</span></a>: <a href="#Hypertext-specials">Hypertext specials</a></li>
<li><a href="#index-manual-feed-151">manual feed</a>: <a href="#Option-details">Option details</a></li>
<li><a href="#index-maxdrift-111">maxdrift</a>: <a href="#Option-details">Option details</a></li>
<li><a href="#index-maximum-pages-printed-163">maximum pages printed</a>: <a href="#Option-details">Option details</a></li>
<li><a href="#index-media-211">media</a>: <a href="#Option-details">Option details</a></li>
-<li><a href="#index-memory-available-288">memory available</a>: <a href="#Configuration-file-commands">Configuration file commands</a></li>
+<li><a href="#index-memory-available-289">memory available</a>: <a href="#Configuration-file-commands">Configuration file commands</a></li>
<li><a href="#index-memory-of-printer-exhausted-69">memory of printer exhausted</a>: <a href="#Printer-errors">Printer errors</a></li>
-<li><a href="#index-memory-usage_002c-and-headers-437">memory usage, and headers</a>: <a href="#Headers-and-memory-usage">Headers and memory usage</a></li>
+<li><a href="#index-memory-usage_002c-and-headers-440">memory usage, and headers</a>: <a href="#Headers-and-memory-usage">Headers and memory usage</a></li>
<li><a href="#index-memory_002c-conserving-89">memory, conserving</a>: <a href="#Option-details">Option details</a></li>
-<li><a href="#index-memory_002c-used-by-PostScript-fonts-568">memory, used by PostScript fonts</a>: <a href="#Making-a-font-available">Making a font available</a></li>
-<li><a href="#index-Metafont-ligature-operations-605">Metafont ligature operations</a>: <a href="#Encoding-file-format">Encoding file format</a></li>
+<li><a href="#index-memory_002c-used-by-PostScript-fonts-571">memory, used by PostScript fonts</a>: <a href="#Making-a-font-available">Making a font available</a></li>
+<li><a href="#index-Metafont-ligature-operations-608">Metafont ligature operations</a>: <a href="#Encoding-file-format">Encoding file format</a></li>
<li><a href="#index-Metafont-mode_002c-specifying-155">Metafont mode, specifying</a>: <a href="#Option-details">Option details</a></li>
-<li><a href="#index-Metafont-source-files-530">Metafont source files</a>: <a href="#Glyph-files">Glyph files</a></li>
-<li><a href="#index-metric-files-506">metric files</a>: <a href="#Metric-files">Metric files</a></li>
-<li><a href="#index-Minion-typeface-family-647">Minion typeface family</a>: <a href="#psfonts_002emap">psfonts.map</a></li>
+<li><a href="#index-Metafont-source-files-533">Metafont source files</a>: <a href="#Glyph-files">Glyph files</a></li>
+<li><a href="#index-metric-files-509">metric files</a>: <a href="#Metric-files">Metric files</a></li>
+<li><a href="#index-Minion-typeface-family-662">Minion typeface family</a>: <a href="#psfonts_002emap">psfonts.map</a></li>
<li><a href="#index-missfont_002elog-159"><code>missfont.log</code></a>: <a href="#Option-details">Option details</a></li>
<li><a href="#index-MISSFONT_005fLOG-161"><code>MISSFONT_LOG</code></a>: <a href="#Option-details">Option details</a></li>
<li><a href="#index-Mitsubishi-Shinko-CHC_002dS446i-printer-57">Mitsubishi Shinko CHC-S446i printer</a>: <a href="#No-output">No output</a></li>
-<li><a href="#index-mkdvipspapers-339"><code>mkdvipspapers</code></a>: <a href="#Config-file-paper-sizes">Config file paper sizes</a></li>
+<li><a href="#index-mkdvipspapers-342"><code>mkdvipspapers</code></a>: <a href="#Config-file-paper-sizes">Config file paper sizes</a></li>
<li><a href="#index-mktexpk_0040r_007b_002c-avoiding_007d-158"><code>mktexpk</code><span class="roman">, avoiding</span></a>: <a href="#Option-details">Option details</a></li>
<li><a href="#index-mktexpk_0040r_007b_002c-changing-name_007d-250"><code>mktexpk</code><span class="roman">, changing name</span></a>: <a href="#Environment-variables">Environment variables</a></li>
<li><a href="#index-mode-name_002c-specifying-154">mode name, specifying</a>: <a href="#Option-details">Option details</a></li>
<li><a href="#index-Monotype-fonts-20">Monotype fonts</a>: <a href="#PostScript-font-installation">PostScript font installation</a></li>
<li><a href="#index-Monotype-fonts_002c-installing-24">Monotype fonts, installing</a>: <a href="#PostScript-font-installation">PostScript font installation</a></li>
<li><a href="#index-mtpk-227"><code>mtpk</code></a>: <a href="#Option-details">Option details</a></li>
-<li><a href="#index-multiple-master-fonts-646">multiple master fonts</a>: <a href="#psfonts_002emap">psfonts.map</a></li>
+<li><a href="#index-multiple-master-fonts-661">multiple master fonts</a>: <a href="#psfonts_002emap">psfonts.map</a></li>
<li><a href="#index-multiple-output-files-136">multiple output files</a>: <a href="#Option-details">Option details</a></li>
-<li><a href="#index-multiple-paper-trays-347">multiple paper trays</a>: <a href="#Paper-trays">Paper trays</a></li>
-<li><a href="#index-Murphy_002c-Tim-495">Murphy, Tim</a>: <a href="#Hypertext-specials">Hypertext specials</a></li>
-<li><a href="#index-N-_0040r_007bEPS_002ddisabling-config-command_007d-291"><code>N </code><span class="roman">EPS-disabling config command</span></a>: <a href="#Configuration-file-commands">Configuration file commands</a></li>
-<li><a href="#index-name-499"><code>name</code></a>: <a href="#Hypertext-specials">Hypertext specials</a></li>
-<li><a href="#index-narrow-fonts-652">narrow fonts</a>: <a href="#psfonts_002emap">psfonts.map</a></li>
+<li><a href="#index-multiple-paper-trays-350">multiple paper trays</a>: <a href="#Paper-trays">Paper trays</a></li>
+<li><a href="#index-Murphy_002c-Tim-498">Murphy, Tim</a>: <a href="#Hypertext-specials">Hypertext specials</a></li>
+<li><a href="#index-N-_0040r_007bEPS_002ddisabling-config-command_007d-292"><code>N </code><span class="roman">EPS-disabling config command</span></a>: <a href="#Configuration-file-commands">Configuration file commands</a></li>
+<li><a href="#index-name-502"><code>name</code></a>: <a href="#Hypertext-specials">Hypertext specials</a></li>
+<li><a href="#index-narrow-fonts-649">narrow fonts</a>: <a href="#psfonts_002emap">psfonts.map</a></li>
<li><a href="#index-no-output-at-all-52">no output at all</a>: <a href="#No-output">No output</a></li>
<li><a href="#index-non_002dprinting-characters_002c-shifting-130">non-printing characters, shifting</a>: <a href="#Option-details">Option details</a></li>
-<li><a href="#index-non_002dresident-fonts-639">non-resident fonts</a>: <a href="#psfonts_002emap">psfonts.map</a></li>
-<li><a href="#index-O-_0040r_007bconfig-command-_0028offset_0029_007d-294"><code>O </code><span class="roman">config command (offset)</span></a>: <a href="#Configuration-file-commands">Configuration file commands</a></li>
-<li><a href="#index-o-_0040r_007bconfig-command-_0028output-file_0029_007d-292"><code>o </code><span class="roman">config command (output file)</span></a>: <a href="#Configuration-file-commands">Configuration file commands</a></li>
-<li><a href="#index-oblique-fonts-607">oblique fonts</a>: <a href="#Special-font-effects">Special font effects</a></li>
-<li><a href="#index-octal-character-codes-629">octal character codes</a>: <a href="#Afm2tfm-options">Afm2tfm options</a></li>
+<li><a href="#index-non_002dresident-fonts-642">non-resident fonts</a>: <a href="#psfonts_002emap">psfonts.map</a></li>
+<li><a href="#index-nopaper_0040r_007b_002c-paper-format-for-_0040samp_007b_002dt_007d_007d-341"><code>nopaper</code><span class="roman">, paper format for &lsquo;</span><samp><span class="samp">-t</span></samp><span class="roman">&rsquo;</span></a>: <a href="#Config-file-paper-sizes">Config file paper sizes</a></li>
+<li><a href="#index-O-_0040r_007bconfig-command-_0028offset_0029_007d-295"><code>O </code><span class="roman">config command (offset)</span></a>: <a href="#Configuration-file-commands">Configuration file commands</a></li>
+<li><a href="#index-o-_0040r_007bconfig-command-_0028output-file_0029_007d-293"><code>o </code><span class="roman">config command (output file)</span></a>: <a href="#Configuration-file-commands">Configuration file commands</a></li>
+<li><a href="#index-oblique-fonts-610">oblique fonts</a>: <a href="#Special-font-effects">Special font effects</a></li>
+<li><a href="#index-octal-character-codes-632">octal character codes</a>: <a href="#Afm2tfm-options">Afm2tfm options</a></li>
<li><a href="#index-odd-pages-only-91">odd pages only</a>: <a href="#Option-details">Option details</a></li>
<li><a href="#index-offset-pages-181">offset pages</a>: <a href="#Option-details">Option details</a></li>
<li><a href="#index-Omega-extensions-170">Omega extensions</a>: <a href="#Option-details">Option details</a></li>
@@ -4677,221 +4692,222 @@ Up:&nbsp;<a rel="up" accesskey="u" href="#Top">Top</a>
<li><a href="#index-options_002c-Dvips-78">options, Dvips</a>: <a href="#Invoking-Dvips">Invoking Dvips</a></li>
<li><a href="#index-options_002c-reading-from-standard-input-84">options, reading from standard input</a>: <a href="#Option-details">Option details</a></li>
<li><a href="#index-options_002c-summary-80">options, summary</a>: <a href="#Option-summary">Option summary</a></li>
-<li><a href="#index-options_002c-to-Afm2tfm-620">options, to Afm2tfm</a>: <a href="#Afm2tfm-options">Afm2tfm options</a></li>
-<li><a href="#index-outline-fonts-618">outline fonts</a>: <a href="#Special-font-effects">Special font effects</a></li>
-<li><a href="#index-outline-fonts-520">outline fonts</a>: <a href="#Glyph-files">Glyph files</a></li>
-<li><a href="#index-output-file_002c-sectioning-of-439">output file, sectioning of</a>: <a href="#Headers-and-memory-usage">Headers and memory usage</a></li>
-<li><a href="#index-output-file_002c-setting-293">output file, setting</a>: <a href="#Configuration-file-commands">Configuration file commands</a></li>
+<li><a href="#index-options_002c-to-Afm2tfm-623">options, to Afm2tfm</a>: <a href="#Afm2tfm-options">Afm2tfm options</a></li>
+<li><a href="#index-outline-fonts-621">outline fonts</a>: <a href="#Special-font-effects">Special font effects</a></li>
+<li><a href="#index-outline-fonts-523">outline fonts</a>: <a href="#Glyph-files">Glyph files</a></li>
+<li><a href="#index-output-file_002c-sectioning-of-442">output file, sectioning of</a>: <a href="#Headers-and-memory-usage">Headers and memory usage</a></li>
+<li><a href="#index-output-file_002c-setting-294">output file, setting</a>: <a href="#Configuration-file-commands">Configuration file commands</a></li>
<li><a href="#index-output-files_002c-multiple-137">output files, multiple</a>: <a href="#Option-details">Option details</a></li>
<li><a href="#index-output_002c-inverted-59">output, inverted</a>: <a href="#Small-or-inverted">Small or inverted</a></li>
<li><a href="#index-output_002c-none-51">output, none</a>: <a href="#No-output">No output</a></li>
<li><a href="#index-output_002c-redirecting-172">output, redirecting</a>: <a href="#Option-details">Option details</a></li>
<li><a href="#index-output_002c-too-small-58">output, too small</a>: <a href="#Small-or-inverted">Small or inverted</a></li>
-<li><a href="#index-p-_0040r_007bconfig-command-_0028font-aliases_0029_007d-295"><code>p </code><span class="roman">config command (font aliases)</span></a>: <a href="#Configuration-file-commands">Configuration file commands</a></li>
-<li><a href="#index-P-_0040r_007bconfig-command-_0028PK-path_0029_007d-299"><code>P </code><span class="roman">config command (PK path)</span></a>: <a href="#Configuration-file-commands">Configuration file commands</a></li>
+<li><a href="#index-p-_0040r_007bconfig-command-_0028font-aliases_0029_007d-296"><code>p </code><span class="roman">config command (font aliases)</span></a>: <a href="#Configuration-file-commands">Configuration file commands</a></li>
+<li><a href="#index-P-_0040r_007bconfig-command-_0028PK-path_0029_007d-300"><code>P </code><span class="roman">config command (PK path)</span></a>: <a href="#Configuration-file-commands">Configuration file commands</a></li>
<li><a href="#index-page-range-191">page range</a>: <a href="#Option-details">Option details</a></li>
<li><a href="#index-page_002c-first-printed-187">page, first printed</a>: <a href="#Option-details">Option details</a></li>
<li><a href="#index-page_002c-last-printed-147">page, last printed</a>: <a href="#Option-details">Option details</a></li>
<li><a href="#index-pages_002c-maximum-printed-164">pages, maximum printed</a>: <a href="#Option-details">Option details</a></li>
-<li><a href="#index-PaintType-617"><code>PaintType</code></a>: <a href="#Special-font-effects">Special font effects</a></li>
-<li><a href="#index-Pantone-colors-666">Pantone colors</a>: <a href="#Color-macro-files">Color macro files</a></li>
-<li><a href="#index-paper-size-configuration-file-command-337">paper size configuration file command</a>: <a href="#Config-file-paper-sizes">Config file paper sizes</a></li>
+<li><a href="#index-PaintType-620"><code>PaintType</code></a>: <a href="#Special-font-effects">Special font effects</a></li>
+<li><a href="#index-Pantone-colors-669">Pantone colors</a>: <a href="#Color-macro-files">Color macro files</a></li>
+<li><a href="#index-paper-size-configuration-file-command-338">paper size configuration file command</a>: <a href="#Config-file-paper-sizes">Config file paper sizes</a></li>
<li><a href="#index-paper-size_002c-default-8">paper size, default</a>: <a href="#config_002eps-installation">config.ps installation</a></li>
-<li><a href="#index-paper-size_002c-general-331">paper size, general</a>: <a href="#Paper-size-and-landscape">Paper size and landscape</a></li>
-<li><a href="#index-paper-trays-345">paper trays</a>: <a href="#Paper-trays">Paper trays</a></li>
+<li><a href="#index-paper-size_002c-general-332">paper size, general</a>: <a href="#Paper-size-and-landscape">Paper size and landscape</a></li>
+<li><a href="#index-paper-trays-348">paper trays</a>: <a href="#Paper-trays">Paper trays</a></li>
<li><a href="#index-paper-type-210">paper type</a>: <a href="#Option-details">Option details</a></li>
-<li><a href="#index-papersize-_0040r_007bspecial_007d-334"><code>papersize </code><span class="roman">special</span></a>: <a href="#papersize-special">papersize special</a></li>
+<li><a href="#index-papersize-_0040r_007bspecial_007d-335"><code>papersize </code><span class="roman">special</span></a>: <a href="#papersize-special">papersize special</a></li>
<li><a href="#index-papersize-special_002c-and-no-_0040samp_007b_002dt_007d-218">papersize special, and no &lsquo;<samp><span class="samp">-t</span></samp>&rsquo;</a>: <a href="#Option-details">Option details</a></li>
-<li><a href="#index-partial-font-downloading-643">partial font downloading</a>: <a href="#psfonts_002emap">psfonts.map</a></li>
-<li><a href="#index-PDF-files_002c-font-quality-485">PDF files, font quality</a>: <a href="#Hypertext-caveats">Hypertext caveats</a></li>
-<li><a href="#index-PDF-files_002c-making-472">PDF files, making</a>: <a href="#Hypertext">Hypertext</a></li>
+<li><a href="#index-partial-font-downloading-658">partial font downloading</a>: <a href="#psfonts_002emap">psfonts.map</a></li>
+<li><a href="#index-PDF-files_002c-font-quality-488">PDF files, font quality</a>: <a href="#Hypertext-caveats">Hypertext caveats</a></li>
+<li><a href="#index-PDF-files_002c-making-475">PDF files, making</a>: <a href="#Hypertext">Hypertext</a></li>
<li><a href="#index-PDF-files_002c-making-37">PDF files, making</a>: <a href="#Ghostscript-installation">Ghostscript installation</a></li>
<li><a href="#index-PDF-files_002c-option-for-240">PDF files, option for</a>: <a href="#Option-details">Option details</a></li>
-<li><a href="#index-pdfmark-470"><code>pdfmark</code></a>: <a href="#Hypertext">Hypertext</a></li>
-<li><a href="#index-pfa-files-524">pfa files</a>: <a href="#Glyph-files">Glyph files</a></li>
-<li><a href="#index-pfb-files-525">pfb files</a>: <a href="#Glyph-files">Glyph files</a></li>
-<li><a href="#index-pfb-files_002c-automatically-unpacked-660">pfb files, automatically unpacked</a>: <a href="#psfonts_002emap">psfonts.map</a></li>
-<li><a href="#index-pfm-files-517">pfm files</a>: <a href="#Metric-files">Metric files</a></li>
-<li><a href="#index-Phaser-printer_002c-used-for-color-calibration-676">Phaser printer, used for color calibration</a>: <a href="#Color-device-configuration">Color device configuration</a></li>
+<li><a href="#index-pdfmark-473"><code>pdfmark</code></a>: <a href="#Hypertext">Hypertext</a></li>
+<li><a href="#index-pfa-files-527">pfa files</a>: <a href="#Glyph-files">Glyph files</a></li>
+<li><a href="#index-pfb-files-528">pfb files</a>: <a href="#Glyph-files">Glyph files</a></li>
+<li><a href="#index-pfb-files_002c-automatically-unpacked-657">pfb files, automatically unpacked</a>: <a href="#psfonts_002emap">psfonts.map</a></li>
+<li><a href="#index-pfm-files-520">pfm files</a>: <a href="#Metric-files">Metric files</a></li>
+<li><a href="#index-Phaser-printer_002c-used-for-color-calibration-679">Phaser printer, used for color calibration</a>: <a href="#Color-device-configuration">Color device configuration</a></li>
<li><a href="#index-physical-page-number_002c-and-_0040samp_007b_002dl_007d-148">physical page number, and &lsquo;<samp><span class="samp">-l</span></samp>&rsquo;</a>: <a href="#Option-details">Option details</a></li>
<li><a href="#index-physical-page-number_002c-and-_0040samp_007b_002dp_007d-188">physical page number, and &lsquo;<samp><span class="samp">-p</span></samp>&rsquo;</a>: <a href="#Option-details">Option details</a></li>
-<li><a href="#index-physical-page-number_002c-and-_0040code_007bbop_002dhook_007d-460">physical page number, and <code>bop-hook</code></a>: <a href="#PostScript-hooks">PostScript hooks</a></li>
+<li><a href="#index-physical-page-number_002c-and-_0040code_007bbop_002dhook_007d-463">physical page number, and <code>bop-hook</code></a>: <a href="#PostScript-hooks">PostScript hooks</a></li>
<li><a href="#index-pipes_002c-not-readable-121">pipes, not readable</a>: <a href="#Option-details">Option details</a></li>
-<li><a href="#index-pk-files-531">pk files</a>: <a href="#Glyph-files">Glyph files</a></li>
-<li><a href="#index-PKFONTS_0040r_007b_002c-overrides_007d-P-300"><code>PKFONTS</code><span class="roman">, overrides</span><code> P</code></a>: <a href="#Configuration-file-commands">Configuration file commands</a></li>
-<li><a href="#index-plotfile_0040r_007b_002c-_0040samp_007bps_007d-subspecial_007d-447"><code>plotfile</code><span class="roman">, &lsquo;</span><samp><span class="samp">ps</span></samp><span class="roman">&rsquo; subspecial</span></a>: <a href="#ps-special">ps special</a></li>
-<li><a href="#index-pltotf-515"><code>pltotf</code></a>: <a href="#Metric-files">Metric files</a></li>
+<li><a href="#index-pk-files-534">pk files</a>: <a href="#Glyph-files">Glyph files</a></li>
+<li><a href="#index-PKFONTS_0040r_007b_002c-overrides_007d-P-301"><code>PKFONTS</code><span class="roman">, overrides</span><code> P</code></a>: <a href="#Configuration-file-commands">Configuration file commands</a></li>
+<li><a href="#index-plotfile_0040r_007b_002c-_0040samp_007bps_007d-subspecial_007d-450"><code>plotfile</code><span class="roman">, &lsquo;</span><samp><span class="samp">ps</span></samp><span class="roman">&rsquo; subspecial</span></a>: <a href="#ps-special">ps special</a></li>
+<li><a href="#index-pltotf-518"><code>pltotf</code></a>: <a href="#Metric-files">Metric files</a></li>
<li><a href="#index-popen-_0040r_007bfor-output_007d-174"><code>popen </code><span class="roman">for output</span></a>: <a href="#Option-details">Option details</a></li>
-<li><a href="#index-portrait-orientation_002c-defined-333">portrait orientation, defined</a>: <a href="#Paper-size-and-landscape">Paper size and landscape</a></li>
+<li><a href="#index-portrait-orientation_002c-defined-334">portrait orientation, defined</a>: <a href="#Paper-size-and-landscape">Paper size and landscape</a></li>
<li><a href="#index-positioning-accuracy-113">positioning accuracy</a>: <a href="#Option-details">Option details</a></li>
-<li><a href="#index-post-_0040r_007bcode-after-headers_007d-429"><code>post </code><span class="roman">code after headers</span></a>: <a href="#Including-headers-from-TeX">Including headers from TeX</a></li>
-<li><a href="#index-PostScript-code_002c-literal-443">PostScript code, literal</a>: <a href="#Literal-PS">Literal PS</a></li>
-<li><a href="#index-PostScript-encoding-543">PostScript encoding</a>: <a href="#Encodings">Encodings</a></li>
-<li><a href="#index-PostScript-encoding_002c-changing-581">PostScript encoding, changing</a>: <a href="#Changing-PostScript-encodings">Changing PostScript encodings</a></li>
-<li><a href="#index-PostScript-font-alias-file-296">PostScript font alias file</a>: <a href="#Configuration-file-commands">Configuration file commands</a></li>
+<li><a href="#index-post-_0040r_007bcode-after-headers_007d-432"><code>post </code><span class="roman">code after headers</span></a>: <a href="#Including-headers-from-TeX">Including headers from TeX</a></li>
+<li><a href="#index-PostScript-code_002c-literal-446">PostScript code, literal</a>: <a href="#Literal-PS">Literal PS</a></li>
+<li><a href="#index-PostScript-encoding-546">PostScript encoding</a>: <a href="#Encodings">Encodings</a></li>
+<li><a href="#index-PostScript-encoding_002c-changing-584">PostScript encoding, changing</a>: <a href="#Changing-PostScript-encodings">Changing PostScript encodings</a></li>
+<li><a href="#index-PostScript-font-alias-file-297">PostScript font alias file</a>: <a href="#Configuration-file-commands">Configuration file commands</a></li>
<li><a href="#index-PostScript-font-alias-file-221">PostScript font alias file</a>: <a href="#Option-details">Option details</a></li>
-<li><a href="#index-PostScript-fonts-504">PostScript fonts</a>: <a href="#PostScript-fonts">PostScript fonts</a></li>
+<li><a href="#index-PostScript-fonts-507">PostScript fonts</a>: <a href="#PostScript-fonts">PostScript fonts</a></li>
<li><a href="#index-PostScript-fonts_002c-installing-16">PostScript fonts, installing</a>: <a href="#PostScript-font-installation">PostScript font installation</a></li>
<li><a href="#index-PostScript-fonts_002c-on-your-system-28">PostScript fonts, on your system</a>: <a href="#PostScript-font-installation">PostScript font installation</a></li>
-<li><a href="#index-PostScript-header-files-415">PostScript header files</a>: <a href="#Header-files">Header files</a></li>
-<li><a href="#index-PostScript-hooks-453">PostScript hooks</a>: <a href="#PostScript-hooks">PostScript hooks</a></li>
-<li><a href="#index-PostScript-interaction-352">PostScript interaction</a>: <a href="#Interaction-with-PostScript">Interaction with PostScript</a></li>
+<li><a href="#index-PostScript-header-files-418">PostScript header files</a>: <a href="#Header-files">Header files</a></li>
+<li><a href="#index-PostScript-hooks-456">PostScript hooks</a>: <a href="#PostScript-hooks">PostScript hooks</a></li>
+<li><a href="#index-PostScript-interaction-355">PostScript interaction</a>: <a href="#Interaction-with-PostScript">Interaction with PostScript</a></li>
<li><a href="#index-PostScript-previewers-36">PostScript previewers</a>: <a href="#Ghostscript-installation">Ghostscript installation</a></li>
-<li><a href="#index-PostScript-units-355">PostScript units</a>: <a href="#Bounding-box">Bounding box</a></li>
+<li><a href="#index-PostScript-units-358">PostScript units</a>: <a href="#Bounding-box">Bounding box</a></li>
<li><a href="#index-PowerPage-PostScript-implementation-55">PowerPage PostScript implementation</a>: <a href="#No-output">No output</a></li>
-<li><a href="#index-pre-_0040r_007bcode-before-headers_007d-428"><code>pre </code><span class="roman">code before headers</span></a>: <a href="#Including-headers-from-TeX">Including headers from TeX</a></li>
+<li><a href="#index-pre-_0040r_007bcode-before-headers_007d-431"><code>pre </code><span class="roman">code before headers</span></a>: <a href="#Including-headers-from-TeX">Including headers from TeX</a></li>
<li><a href="#index-previewing-Dvips-output-35">previewing Dvips output</a>: <a href="#Ghostscript-installation">Ghostscript installation</a></li>
<li><a href="#index-PRINTER-254"><code>PRINTER</code></a>: <a href="#Environment-variables">Environment variables</a></li>
<li><a href="#index-printer-configuration-7">printer configuration</a>: <a href="#config_002eps-installation">config.ps installation</a></li>
<li><a href="#index-printer-configuration-file_002c-prototype-12">printer configuration file, prototype</a>: <a href="#config_002eps-installation">config.ps installation</a></li>
<li><a href="#index-printer-errors-63">printer errors</a>: <a href="#Printer-errors">Printer errors</a></li>
-<li><a href="#index-printer-memory-289">printer memory</a>: <a href="#Configuration-file-commands">Configuration file commands</a></li>
+<li><a href="#index-printer-memory-290">printer memory</a>: <a href="#Configuration-file-commands">Configuration file commands</a></li>
<li><a href="#index-printer-memory-exhausted-68">printer memory exhausted</a>: <a href="#Printer-errors">Printer errors</a></li>
<li><a href="#index-printer-offset-182">printer offset</a>: <a href="#Option-details">Option details</a></li>
<li><a href="#index-PRINTER_0040r_007b_002c-and-config-file-searching_007d-264"><code>PRINTER</code><span class="roman">, and config file searching</span></a>: <a href="#Configuration-file-searching">Configuration file searching</a></li>
<li><a href="#index-PRINTER_0040r_007b_002c-avoided-with-_0040samp_007b_002df_007d_007d-122"><code>PRINTER</code><span class="roman">, avoided with &lsquo;</span><samp><span class="samp">-f</span></samp><span class="roman">&rsquo;</span></a>: <a href="#Option-details">Option details</a></li>
<li><a href="#index-printer_002c-driving-directly-126">printer, driving directly</a>: <a href="#Option-details">Option details</a></li>
<li><a href="#index-problems-46">problems</a>: <a href="#Diagnosing-problems">Diagnosing problems</a></li>
-<li><a href="#index-property-list-files-513">property list files</a>: <a href="#Metric-files">Metric files</a></li>
+<li><a href="#index-property-list-files-516">property list files</a>: <a href="#Metric-files">Metric files</a></li>
<li><a href="#index-prototype-printer-configuration-file-11">prototype printer configuration file</a>: <a href="#config_002eps-installation">config.ps installation</a></li>
-<li><a href="#index-ps-_0040r_007bspecial_007d-445"><code>ps </code><span class="roman">special</span></a>: <a href="#ps-special">ps special</a></li>
-<li><a href="#index-psfile-_0040r_007bspecial_007d-390"><code>psfile </code><span class="roman">special</span></a>: <a href="#psfile-special">psfile special</a></li>
-<li><a href="#index-psfonts_002emap-638"><code>psfonts.map</code></a>: <a href="#psfonts_002emap">psfonts.map</a></li>
-<li><a href="#index-psfonts_002emap-611"><code>psfonts.map</code></a>: <a href="#Special-font-effects">Special font effects</a></li>
+<li><a href="#index-ps-_0040r_007bspecial_007d-448"><code>ps </code><span class="roman">special</span></a>: <a href="#ps-special">ps special</a></li>
+<li><a href="#index-psfile-_0040r_007bspecial_007d-393"><code>psfile </code><span class="roman">special</span></a>: <a href="#psfile-special">psfile special</a></li>
+<li><a href="#index-psfonts_002emap-641"><code>psfonts.map</code></a>: <a href="#psfonts_002emap">psfonts.map</a></li>
+<li><a href="#index-psfonts_002emap-614"><code>psfonts.map</code></a>: <a href="#Special-font-effects">Special font effects</a></li>
<li><a href="#index-psfonts_002emap-29"><code>psfonts.map</code></a>: <a href="#PostScript-font-installation">PostScript font installation</a></li>
-<li><a href="#index-psheaderdir-416"><code>psheaderdir</code></a>: <a href="#Header-files">Header files</a></li>
-<li><a href="#index-psi-character-missing-486">psi character missing</a>: <a href="#Hypertext-caveats">Hypertext caveats</a></li>
+<li><a href="#index-psheaderdir-419"><code>psheaderdir</code></a>: <a href="#Header-files">Header files</a></li>
+<li><a href="#index-psi-character-missing-489">psi character missing</a>: <a href="#Hypertext-caveats">Hypertext caveats</a></li>
<li><a href="#index-pstopk-229"><code>pstopk</code></a>: <a href="#Option-details">Option details</a></li>
-<li><a href="#index-Q-_0040r_007bconfig-command-_0028quiet_0029_007d-305"><code>Q </code><span class="roman">config command (quiet)</span></a>: <a href="#Configuration-file-commands">Configuration file commands</a></li>
-<li><a href="#index-q-_0040r_007bconfig-command-_0028quiet_0029_007d-304"><code>q </code><span class="roman">config command (quiet)</span></a>: <a href="#Configuration-file-commands">Configuration file commands</a></li>
+<li><a href="#index-Q-_0040r_007bconfig-command-_0028quiet_0029_007d-306"><code>Q </code><span class="roman">config command (quiet)</span></a>: <a href="#Configuration-file-commands">Configuration file commands</a></li>
+<li><a href="#index-q-_0040r_007bconfig-command-_0028quiet_0029_007d-305"><code>q </code><span class="roman">config command (quiet)</span></a>: <a href="#Configuration-file-commands">Configuration file commands</a></li>
<li><a href="#index-quiet-operation-196">quiet operation</a>: <a href="#Option-details">Option details</a></li>
-<li><a href="#index-r-_0040r_007bconfig-command-_0028page-reversal_0029_007d-306"><code>r </code><span class="roman">config command (page reversal)</span></a>: <a href="#Configuration-file-commands">Configuration file commands</a></li>
-<li><a href="#index-R-_0040r_007bfallback-resolution-config-command_007d-307"><code>R </code><span class="roman">fallback resolution config command</span></a>: <a href="#Configuration-file-commands">Configuration file commands</a></li>
-<li><a href="#index-reencode_002f_002a_002eenc-551"><code>reencode/*.enc</code></a>: <a href="#Encodings">Encodings</a></li>
-<li><a href="#index-reencoding-588">reencoding</a>: <a href="#Reencoding-with-Afm2tfm">Reencoding with Afm2tfm</a></li>
-<li><a href="#index-reencoding-PostScript-fonts-653">reencoding PostScript fonts</a>: <a href="#psfonts_002emap">psfonts.map</a></li>
-<li><a href="#index-registered-_0040r_007bcharacter_002c-accessing_007d-584"><code>registered </code><span class="roman">character, accessing</span></a>: <a href="#Changing-PostScript-encodings">Changing PostScript encodings</a></li>
-<li><a href="#index-remapping-589">remapping</a>: <a href="#Reencoding-with-Afm2tfm">Reencoding with Afm2tfm</a></li>
-<li><a href="#index-resident-fonts_002c-different-in-different-printers-297">resident fonts, different in different printers</a>: <a href="#Configuration-file-commands">Configuration file commands</a></li>
+<li><a href="#index-r-_0040r_007bconfig-command-_0028page-reversal_0029_007d-307"><code>r </code><span class="roman">config command (page reversal)</span></a>: <a href="#Configuration-file-commands">Configuration file commands</a></li>
+<li><a href="#index-R-_0040r_007bfallback-resolution-config-command_007d-308"><code>R </code><span class="roman">fallback resolution config command</span></a>: <a href="#Configuration-file-commands">Configuration file commands</a></li>
+<li><a href="#index-reencode_002f_002a_002eenc-554"><code>reencode/*.enc</code></a>: <a href="#Encodings">Encodings</a></li>
+<li><a href="#index-reencoding-591">reencoding</a>: <a href="#Reencoding-with-Afm2tfm">Reencoding with Afm2tfm</a></li>
+<li><a href="#index-reencoding-PostScript-fonts-650">reencoding PostScript fonts</a>: <a href="#psfonts_002emap">psfonts.map</a></li>
+<li><a href="#index-registered-_0040r_007bcharacter_002c-accessing_007d-587"><code>registered </code><span class="roman">character, accessing</span></a>: <a href="#Changing-PostScript-encodings">Changing PostScript encodings</a></li>
+<li><a href="#index-remapping-592">remapping</a>: <a href="#Reencoding-with-Afm2tfm">Reencoding with Afm2tfm</a></li>
+<li><a href="#index-resident-fonts_002c-different-in-different-printers-298">resident fonts, different in different printers</a>: <a href="#Configuration-file-commands">Configuration file commands</a></li>
<li><a href="#index-resident-fonts_002c-different-in-different-printers-222">resident fonts, different in different printers</a>: <a href="#Option-details">Option details</a></li>
<li><a href="#index-resolution-233">resolution</a>: <a href="#Option-details">Option details</a></li>
<li><a href="#index-resolution_002c-setting-109">resolution, setting</a>: <a href="#Option-details">Option details</a></li>
<li><a href="#index-reverse-pagination-200">reverse pagination</a>: <a href="#Option-details">Option details</a></li>
-<li><a href="#index-rhi-_0040r_007b_0028_0040samp_007bpsfile_007d-special-option_0029_007d-403"><code>rhi </code><span class="roman">(&lsquo;</span><samp><span class="samp">psfile</span></samp><span class="roman">&rsquo; special option)</span></a>: <a href="#psfile-special">psfile special</a></li>
+<li><a href="#index-rhi-_0040r_007b_0028_0040samp_007bpsfile_007d-special-option_0029_007d-406"><code>rhi </code><span class="roman">(&lsquo;</span><samp><span class="samp">psfile</span></samp><span class="roman">&rsquo; special option)</span></a>: <a href="#psfile-special">psfile special</a></li>
<li><a href="#index-Rokicki_002c-Tomas-1">Rokicki, Tomas</a>: <a href="#Why-Dvips">Why Dvips</a></li>
-<li><a href="#index-rotate_002etex-448"><code>rotate.tex</code></a>: <a href="#ps-special">ps special</a></li>
-<li><a href="#index-rwi-_0040r_007b_0028_0040samp_007bpsfile_007d-special-option_0029_007d-404"><code>rwi </code><span class="roman">(&lsquo;</span><samp><span class="samp">psfile</span></samp><span class="roman">&rsquo; special option)</span></a>: <a href="#psfile-special">psfile special</a></li>
-<li><a href="#index-S-_0040r_007bconfig-command-_0028pict-path_0029_007d-315"><code>S </code><span class="roman">config command (pict path)</span></a>: <a href="#Configuration-file-commands">Configuration file commands</a></li>
-<li><a href="#index-s-_0040r_007bconfig-command-_0028save_002frestore_0029_007d-314"><code>s </code><span class="roman">config command (save/restore)</span></a>: <a href="#Configuration-file-commands">Configuration file commands</a></li>
+<li><a href="#index-rotate_002etex-451"><code>rotate.tex</code></a>: <a href="#ps-special">ps special</a></li>
+<li><a href="#index-rwi-_0040r_007b_0028_0040samp_007bpsfile_007d-special-option_0029_007d-407"><code>rwi </code><span class="roman">(&lsquo;</span><samp><span class="samp">psfile</span></samp><span class="roman">&rsquo; special option)</span></a>: <a href="#psfile-special">psfile special</a></li>
+<li><a href="#index-S-_0040r_007bconfig-command-_0028pict-path_0029_007d-316"><code>S </code><span class="roman">config command (pict path)</span></a>: <a href="#Configuration-file-commands">Configuration file commands</a></li>
+<li><a href="#index-s-_0040r_007bconfig-command-_0028save_002frestore_0029_007d-315"><code>s </code><span class="roman">config command (save/restore)</span></a>: <a href="#Configuration-file-commands">Configuration file commands</a></li>
<li><a href="#index-save_002frestore_002c-and-inverted-output-62">save/restore, and inverted output</a>: <a href="#Small-or-inverted">Small or inverted</a></li>
-<li><a href="#index-save_0040r_007b_002f_007drestore_0040r_007b_002c-and-literal-PS_007d-466"><code>save</code><span class="roman">/</span><code>restore</code><span class="roman">, and literal PS</span></a>: <a href="#Literal-examples">Literal examples</a></li>
-<li><a href="#index-save_002frestore_002c-and-specials-446">save/restore, and specials</a>: <a href="#ps-special">ps special</a></li>
+<li><a href="#index-save_0040r_007b_002f_007drestore_0040r_007b_002c-and-literal-PS_007d-469"><code>save</code><span class="roman">/</span><code>restore</code><span class="roman">, and literal PS</span></a>: <a href="#Literal-examples">Literal examples</a></li>
+<li><a href="#index-save_002frestore_002c-and-specials-449">save/restore, and specials</a>: <a href="#ps-special">ps special</a></li>
<li><a href="#index-save_002frestore_002c-generating-global-207">save/restore, generating global</a>: <a href="#Option-details">Option details</a></li>
-<li><a href="#index-scaleunit-405"><code>scaleunit</code></a>: <a href="#psfile-special">psfile special</a></li>
-<li><a href="#index-scaling-of-figures-376">scaling of figures</a>: <a href="#EPSF-scaling">EPSF scaling</a></li>
-<li><a href="#index-scaling-small-caps-624">scaling small caps</a>: <a href="#Afm2tfm-options">Afm2tfm options</a></li>
-<li><a href="#index-Scandinavian-A-ring-593">Scandinavian A ring</a>: <a href="#Reencoding-with-Afm2tfm">Reencoding with Afm2tfm</a></li>
-<li><a href="#index-screen-frequencies_002c-setting-435">screen frequencies, setting</a>: <a href="#Including-headers-from-the-command-line">Including headers from the command line</a></li>
-<li><a href="#index-SDict-406"><code>SDict</code></a>: <a href="#psfile-special">psfile special</a></li>
-<li><a href="#index-SDict-_0040r_007bdictionary_007d-450"><code>SDict </code><span class="roman">dictionary</span></a>: <a href="#Literal-headers">Literal headers</a></li>
+<li><a href="#index-scaleunit-408"><code>scaleunit</code></a>: <a href="#psfile-special">psfile special</a></li>
+<li><a href="#index-scaling-of-figures-379">scaling of figures</a>: <a href="#EPSF-scaling">EPSF scaling</a></li>
+<li><a href="#index-scaling-small-caps-627">scaling small caps</a>: <a href="#Afm2tfm-options">Afm2tfm options</a></li>
+<li><a href="#index-Scandinavian-A-ring-596">Scandinavian A ring</a>: <a href="#Reencoding-with-Afm2tfm">Reencoding with Afm2tfm</a></li>
+<li><a href="#index-screen-frequencies_002c-setting-438">screen frequencies, setting</a>: <a href="#Including-headers-from-the-command-line">Including headers from the command line</a></li>
+<li><a href="#index-SDict-409"><code>SDict</code></a>: <a href="#psfile-special">psfile special</a></li>
+<li><a href="#index-SDict-_0040r_007bdictionary_007d-453"><code>SDict </code><span class="roman">dictionary</span></a>: <a href="#Literal-headers">Literal headers</a></li>
<li><a href="#index-searching-config-files_002c-order-of-260">searching config files, order of</a>: <a href="#Configuration-file-searching">Configuration file searching</a></li>
-<li><a href="#index-sections-of-output-file_002c-and-memory-438">sections of output file, and memory</a>: <a href="#Headers-and-memory-usage">Headers and memory usage</a></li>
+<li><a href="#index-sections-of-output-file_002c-and-memory-441">sections of output file, and memory</a>: <a href="#Headers-and-memory-usage">Headers and memory usage</a></li>
<li><a href="#index-sections-output_002c-in-separate-files-135">sections output, in separate files</a>: <a href="#Option-details">Option details</a></li>
<li><a href="#index-security-202">security</a>: <a href="#Option-details">Option details</a></li>
<li><a href="#index-shell-command-execution_002c-disabling-203">shell command execution, disabling</a>: <a href="#Option-details">Option details</a></li>
<li><a href="#index-shell-escape_002c-in-config-file-277">shell escape, in config file</a>: <a href="#Configuration-file-commands">Configuration file commands</a></li>
<li><a href="#index-Shinko-CHC_002dS446i-printer-56">Shinko CHC-S446i printer</a>: <a href="#No-output">No output</a></li>
-<li><a href="#index-show-_0040r_007bPostScript-operator_007d-554"><code>show </code><span class="roman">PostScript operator</span></a>: <a href="#PostScript-typesetting">PostScript typesetting</a></li>
+<li><a href="#index-show-_0040r_007bPostScript-operator_007d-557"><code>show </code><span class="roman">PostScript operator</span></a>: <a href="#PostScript-typesetting">PostScript typesetting</a></li>
<li><a href="#index-silent-operation-197">silent operation</a>: <a href="#Option-details">Option details</a></li>
-<li><a href="#index-simplex-mode-on-duplex-printers-434">simplex mode on duplex printers</a>: <a href="#Including-headers-from-the-command-line">Including headers from the command line</a></li>
-<li><a href="#index-slanted-fonts-608">slanted fonts</a>: <a href="#Special-font-effects">Special font effects</a></li>
-<li><a href="#index-slanted-fonts_002c-making-632">slanted fonts, making</a>: <a href="#Afm2tfm-options">Afm2tfm options</a></li>
-<li><a href="#index-SlantFont-610"><code>SlantFont</code></a>: <a href="#Special-font-effects">Special font effects</a></li>
-<li><a href="#index-small-caps-fonts-615">small caps fonts</a>: <a href="#Special-font-effects">Special font effects</a></li>
-<li><a href="#index-Smith_002c-Arthur-491">Smith, Arthur</a>: <a href="#Hypertext-specials">Hypertext specials</a></li>
+<li><a href="#index-simplex-mode-on-duplex-printers-437">simplex mode on duplex printers</a>: <a href="#Including-headers-from-the-command-line">Including headers from the command line</a></li>
+<li><a href="#index-slanted-fonts-611">slanted fonts</a>: <a href="#Special-font-effects">Special font effects</a></li>
+<li><a href="#index-slanted-fonts_002c-making-635">slanted fonts, making</a>: <a href="#Afm2tfm-options">Afm2tfm options</a></li>
+<li><a href="#index-SlantFont-613"><code>SlantFont</code></a>: <a href="#Special-font-effects">Special font effects</a></li>
+<li><a href="#index-small-caps-fonts-618">small caps fonts</a>: <a href="#Special-font-effects">Special font effects</a></li>
+<li><a href="#index-Smith_002c-Arthur-494">Smith, Arthur</a>: <a href="#Hypertext-specials">Hypertext specials</a></li>
<li><a href="#index-Softkey-fonts-21">Softkey fonts</a>: <a href="#PostScript-font-installation">PostScript font installation</a></li>
<li><a href="#index-Softkey-fonts_002c-installing-25">Softkey fonts, installing</a>: <a href="#PostScript-font-installation">PostScript font installation</a></li>
-<li><a href="#index-spaces_002c-dropped-trailing-488">spaces, dropped trailing</a>: <a href="#Hypertext-caveats">Hypertext caveats</a></li>
-<li><a href="#index-specials_002c-hypertext-490">specials, hypertext</a>: <a href="#Hypertext-specials">Hypertext specials</a></li>
-<li><a href="#index-splines-522">splines</a>: <a href="#Glyph-files">Glyph files</a></li>
+<li><a href="#index-spaces_002c-dropped-trailing-491">spaces, dropped trailing</a>: <a href="#Hypertext-caveats">Hypertext caveats</a></li>
+<li><a href="#index-specials_002c-hypertext-493">specials, hypertext</a>: <a href="#Hypertext-specials">Hypertext specials</a></li>
+<li><a href="#index-splines-525">splines</a>: <a href="#Glyph-files">Glyph files</a></li>
<li><a href="#index-spooler_002c-lacking-127">spooler, lacking</a>: <a href="#Option-details">Option details</a></li>
<li><a href="#index-spooling-to-lpr-on-MS_002dDOS-179">spooling to lpr on MS-DOS</a>: <a href="#Option-details">Option details</a></li>
<li><a href="#index-standard-I_002fO-120">standard I/O</a>: <a href="#Option-details">Option details</a></li>
<li><a href="#index-standard-input_002c-reading-options-from-85">standard input, reading options from</a>: <a href="#Option-details">Option details</a></li>
<li><a href="#index-standard-output_002c-output-to-173">standard output, output to</a>: <a href="#Option-details">Option details</a></li>
<li><a href="#index-standard-PostScript_002c-required-by-Ghostview-44">standard PostScript, required by Ghostview</a>: <a href="#Ghostscript-installation">Ghostscript installation</a></li>
-<li><a href="#index-start_002dhook-456"><code>start-hook</code></a>: <a href="#PostScript-hooks">PostScript hooks</a></li>
+<li><a href="#index-start_002dhook-459"><code>start-hook</code></a>: <a href="#PostScript-hooks">PostScript hooks</a></li>
<li><a href="#index-structured-comments-166">structured comments</a>: <a href="#Option-details">Option details</a></li>
<li><a href="#index-system-_0040r_007bin-config-file_007d-275"><code>system </code><span class="roman">in config file</span></a>: <a href="#Configuration-file-commands">Configuration file commands</a></li>
-<li><a href="#index-T-_0040r_007bconfig-command-_0028TFM-path_0029_007d-318"><code>T </code><span class="roman">config command (TFM path)</span></a>: <a href="#Configuration-file-commands">Configuration file commands</a></li>
-<li><a href="#index-Tektronix-Phaser-printer_002c-used-for-color-calibration-677">Tektronix Phaser printer, used for color calibration</a>: <a href="#Color-device-configuration">Color device configuration</a></li>
+<li><a href="#index-T-_0040r_007bconfig-command-_0028TFM-path_0029_007d-319"><code>T </code><span class="roman">config command (TFM path)</span></a>: <a href="#Configuration-file-commands">Configuration file commands</a></li>
+<li><a href="#index-Tektronix-Phaser-printer_002c-used-for-color-calibration-680">Tektronix Phaser printer, used for color calibration</a>: <a href="#Color-device-configuration">Color device configuration</a></li>
<li><a href="#index-testpage_002etex-183"><code>testpage.tex</code></a>: <a href="#Option-details">Option details</a></li>
-<li><a href="#index-g_t_0040TeX_007b_007d-encoding_002c-changing-577">TeX encoding, changing</a>: <a href="#Changing-TeX-encodings">Changing TeX encodings</a></li>
-<li><a href="#index-g_t_0040TeX_007b_007d_002c-including-headers-in-423">TeX, including headers in</a>: <a href="#Including-headers-from-TeX">Including headers from TeX</a></li>
+<li><a href="#index-g_t_0040TeX_007b_007d-encoding_002c-changing-580">TeX encoding, changing</a>: <a href="#Changing-TeX-encodings">Changing TeX encodings</a></li>
+<li><a href="#index-g_t_0040TeX_007b_007d_002c-including-headers-in-426">TeX, including headers in</a>: <a href="#Including-headers-from-TeX">Including headers from TeX</a></li>
<li><a href="#index-TEXCONFIG-255"><code>TEXCONFIG</code></a>: <a href="#Environment-variables">Environment variables</a></li>
-<li><a href="#index-TEXFONTS_0040r_007b_002c-overrides_007d-P-303"><code>TEXFONTS</code><span class="roman">, overrides</span><code> P</code></a>: <a href="#Configuration-file-commands">Configuration file commands</a></li>
-<li><a href="#index-TEXFONTS_0040r_007b_002c-overrides_007d-T-320"><code>TEXFONTS</code><span class="roman">, overrides</span><code> T</code></a>: <a href="#Configuration-file-commands">Configuration file commands</a></li>
-<li><a href="#index-TEXINPUTS_0040r_007b_002c-overrides_007d-S-317"><code>TEXINPUTS</code><span class="roman">, overrides</span><code> S</code></a>: <a href="#Configuration-file-commands">Configuration file commands</a></li>
-<li><a href="#index-texmext_002eenc-548"><code>texmext.enc</code></a>: <a href="#Encodings">Encodings</a></li>
+<li><a href="#index-TEXFONTS_0040r_007b_002c-overrides_007d-P-304"><code>TEXFONTS</code><span class="roman">, overrides</span><code> P</code></a>: <a href="#Configuration-file-commands">Configuration file commands</a></li>
+<li><a href="#index-TEXFONTS_0040r_007b_002c-overrides_007d-T-321"><code>TEXFONTS</code><span class="roman">, overrides</span><code> T</code></a>: <a href="#Configuration-file-commands">Configuration file commands</a></li>
+<li><a href="#index-TEXINPUTS_0040r_007b_002c-overrides_007d-S-318"><code>TEXINPUTS</code><span class="roman">, overrides</span><code> S</code></a>: <a href="#Configuration-file-commands">Configuration file commands</a></li>
+<li><a href="#index-texmext_002eenc-551"><code>texmext.enc</code></a>: <a href="#Encodings">Encodings</a></li>
<li><a href="#index-TEXMFOUTPUT-160"><code>TEXMFOUTPUT</code></a>: <a href="#Option-details">Option details</a></li>
-<li><a href="#index-texmital_002eenc-549"><code>texmital.enc</code></a>: <a href="#Encodings">Encodings</a></li>
-<li><a href="#index-texmsym_002eenc-579"><code>texmsym.enc</code></a>: <a href="#Changing-TeX-encodings">Changing TeX encodings</a></li>
-<li><a href="#index-texmsym_002eenc-550"><code>texmsym.enc</code></a>: <a href="#Encodings">Encodings</a></li>
+<li><a href="#index-texmital_002eenc-552"><code>texmital.enc</code></a>: <a href="#Encodings">Encodings</a></li>
+<li><a href="#index-texmsym_002eenc-582"><code>texmsym.enc</code></a>: <a href="#Changing-TeX-encodings">Changing TeX encodings</a></li>
+<li><a href="#index-texmsym_002eenc-553"><code>texmsym.enc</code></a>: <a href="#Encodings">Encodings</a></li>
<li><a href="#index-TEXPICTS-257"><code>TEXPICTS</code></a>: <a href="#Environment-variables">Environment variables</a></li>
-<li><a href="#index-TEXPICTS_0040r_007b_002c-overrides_007d-S-316"><code>TEXPICTS</code><span class="roman">, overrides</span><code> S</code></a>: <a href="#Configuration-file-commands">Configuration file commands</a></li>
-<li><a href="#index-TEXPKS_0040r_007b_002c-overrides_007d-P-301"><code>TEXPKS</code><span class="roman">, overrides</span><code> P</code></a>: <a href="#Configuration-file-commands">Configuration file commands</a></li>
-<li><a href="#index-TEXSIZES_0040r_007b_002c-overrides_007d-R-312"><code>TEXSIZES</code><span class="roman">, overrides</span><code> R</code></a>: <a href="#Configuration-file-commands">Configuration file commands</a></li>
-<li><a href="#index-text-in-figures_002c-chopped-off-388">text in figures, chopped off</a>: <a href="#EPSF-clipping">EPSF clipping</a></li>
-<li><a href="#index-tfm-files-511">tfm files</a>: <a href="#Metric-files">Metric files</a></li>
-<li><a href="#index-TFMFONTS_0040r_007b_002c-overrides_007d-T-319"><code>TFMFONTS</code><span class="roman">, overrides</span><code> T</code></a>: <a href="#Configuration-file-commands">Configuration file commands</a></li>
-<li><a href="#index-tftopl-514"><code>tftopl</code></a>: <a href="#Metric-files">Metric files</a></li>
+<li><a href="#index-TEXPICTS_0040r_007b_002c-overrides_007d-S-317"><code>TEXPICTS</code><span class="roman">, overrides</span><code> S</code></a>: <a href="#Configuration-file-commands">Configuration file commands</a></li>
+<li><a href="#index-TEXPKS_0040r_007b_002c-overrides_007d-P-302"><code>TEXPKS</code><span class="roman">, overrides</span><code> P</code></a>: <a href="#Configuration-file-commands">Configuration file commands</a></li>
+<li><a href="#index-TEXSIZES_0040r_007b_002c-overrides_007d-R-313"><code>TEXSIZES</code><span class="roman">, overrides</span><code> R</code></a>: <a href="#Configuration-file-commands">Configuration file commands</a></li>
+<li><a href="#index-text-in-figures_002c-chopped-off-391">text in figures, chopped off</a>: <a href="#EPSF-clipping">EPSF clipping</a></li>
+<li><a href="#index-tfm-files-514">tfm files</a>: <a href="#Metric-files">Metric files</a></li>
+<li><a href="#index-TFMFONTS_0040r_007b_002c-overrides_007d-T-320"><code>TFMFONTS</code><span class="roman">, overrides</span><code> T</code></a>: <a href="#Configuration-file-commands">Configuration file commands</a></li>
+<li><a href="#index-tftopl-517"><code>tftopl</code></a>: <a href="#Metric-files">Metric files</a></li>
<li><a href="#index-Theisen_002c-Tim-40">Theisen, Tim</a>: <a href="#Ghostscript-installation">Ghostscript installation</a></li>
<li><a href="#index-tight-bounding-box_002c-finding-116">tight bounding box, finding</a>: <a href="#Option-details">Option details</a></li>
<li><a href="#index-too_002dsmall-output-61">too-small output</a>: <a href="#Small-or-inverted">Small or inverted</a></li>
-<li><a href="#index-trademark-_0040r_007bcharacter_002c-accessing_007d-583"><code>trademark </code><span class="roman">character, accessing</span></a>: <a href="#Changing-PostScript-encodings">Changing PostScript encodings</a></li>
-<li><a href="#index-trailing-spaces_002c-dropped-487">trailing spaces, dropped</a>: <a href="#Hypertext-caveats">Hypertext caveats</a></li>
+<li><a href="#index-trademark-_0040r_007bcharacter_002c-accessing_007d-586"><code>trademark </code><span class="roman">character, accessing</span></a>: <a href="#Changing-PostScript-encodings">Changing PostScript encodings</a></li>
+<li><a href="#index-trailing-spaces_002c-dropped-490">trailing spaces, dropped</a>: <a href="#Hypertext-caveats">Hypertext caveats</a></li>
<li><a href="#index-TranScript-167">TranScript</a>: <a href="#Option-details">Option details</a></li>
-<li><a href="#index-transforming-downloaded-fonts-649">transforming downloaded fonts</a>: <a href="#psfonts_002emap">psfonts.map</a></li>
+<li><a href="#index-transforming-downloaded-fonts-646">transforming downloaded fonts</a>: <a href="#psfonts_002emap">psfonts.map</a></li>
<li><a href="#index-trouble-47">trouble</a>: <a href="#Diagnosing-problems">Diagnosing problems</a></li>
-<li><a href="#index-Type-1-fonts-523">Type 1 fonts</a>: <a href="#Glyph-files">Glyph files</a></li>
-<li><a href="#index-typesetting-in-PostScript-552">typesetting in PostScript</a>: <a href="#PostScript-typesetting">PostScript typesetting</a></li>
-<li><a href="#index-U-_0040r_007bconfig-command-_0028Xerox-4045_0029_007d-321"><code>U </code><span class="roman">config command (Xerox 4045)</span></a>: <a href="#Configuration-file-commands">Configuration file commands</a></li>
+<li><a href="#index-Type-1-fonts-526">Type 1 fonts</a>: <a href="#Glyph-files">Glyph files</a></li>
+<li><a href="#index-typesetting-in-PostScript-555">typesetting in PostScript</a>: <a href="#PostScript-typesetting">PostScript typesetting</a></li>
+<li><a href="#index-U-_0040r_007bconfig-command-_0028Xerox-4045_0029_007d-322"><code>U </code><span class="roman">config command (Xerox 4045)</span></a>: <a href="#Configuration-file-commands">Configuration file commands</a></li>
<li><a href="#index-uncollated-copies-102">uncollated copies</a>: <a href="#Option-details">Option details</a></li>
-<li><a href="#index-uncompressing-PostScript-409">uncompressing PostScript</a>: <a href="#Dynamic-creation-of-graphics">Dynamic creation of graphics</a></li>
-<li><a href="#index-uniform-resource-locator-492">uniform resource locator</a>: <a href="#Hypertext-specials">Hypertext specials</a></li>
-<li><a href="#index-unknown_0040r_007b_002c-paper-format-for-_0040samp_007b_002dt_007d_007d-336"><code>unknown</code><span class="roman">, paper format for &lsquo;</span><samp><span class="samp">-t</span></samp><span class="roman">&rsquo;</span></a>: <a href="#papersize-special">papersize special</a></li>
-<li><a href="#index-URL_002c-definition-496">URL, definition</a>: <a href="#Hypertext-specials">Hypertext specials</a></li>
-<li><a href="#index-URL_002c-extended-for-_0040TeX_007b_007d-494">URL, extended for TeX</a>: <a href="#Hypertext-specials">Hypertext specials</a></li>
-<li><a href="#index-urx-_0040r_007b_0028_0040samp_007bpsfile_007d-special-option_0029_007d-401"><code>urx </code><span class="roman">(&lsquo;</span><samp><span class="samp">psfile</span></samp><span class="roman">&rsquo; special option)</span></a>: <a href="#psfile-special">psfile special</a></li>
-<li><a href="#index-ury-_0040r_007b_0028_0040samp_007bpsfile_007d-special-option_0029_007d-402"><code>ury </code><span class="roman">(&lsquo;</span><samp><span class="samp">psfile</span></samp><span class="roman">&rsquo; special option)</span></a>: <a href="#psfile-special">psfile special</a></li>
-<li><a href="#index-user_002ddefinable-colors-671">user-definable colors</a>: <a href="#User_002ddefinable-colors">User-definable colors</a></li>
-<li><a href="#index-userdict_0040r_007b_002c-and-dictionary-files_007d-419"><code>userdict</code><span class="roman">, and dictionary files</span></a>: <a href="#Header-files">Header files</a></li>
+<li><a href="#index-uncompressing-PostScript-412">uncompressing PostScript</a>: <a href="#Dynamic-creation-of-graphics">Dynamic creation of graphics</a></li>
+<li><a href="#index-uniform-resource-locator-495">uniform resource locator</a>: <a href="#Hypertext-specials">Hypertext specials</a></li>
+<li><a href="#index-unknown_0040r_007b_002c-paper-format-for-_0040samp_007b_002dt_007d_007d-340"><code>unknown</code><span class="roman">, paper format for &lsquo;</span><samp><span class="samp">-t</span></samp><span class="roman">&rsquo;</span></a>: <a href="#Config-file-paper-sizes">Config file paper sizes</a></li>
+<li><a href="#index-unknown_0040r_007b_002c-paper-format-for-_0040samp_007b_002dt_007d_007d-337"><code>unknown</code><span class="roman">, paper format for &lsquo;</span><samp><span class="samp">-t</span></samp><span class="roman">&rsquo;</span></a>: <a href="#papersize-special">papersize special</a></li>
+<li><a href="#index-URL_002c-definition-499">URL, definition</a>: <a href="#Hypertext-specials">Hypertext specials</a></li>
+<li><a href="#index-URL_002c-extended-for-_0040TeX_007b_007d-497">URL, extended for TeX</a>: <a href="#Hypertext-specials">Hypertext specials</a></li>
+<li><a href="#index-urx-_0040r_007b_0028_0040samp_007bpsfile_007d-special-option_0029_007d-404"><code>urx </code><span class="roman">(&lsquo;</span><samp><span class="samp">psfile</span></samp><span class="roman">&rsquo; special option)</span></a>: <a href="#psfile-special">psfile special</a></li>
+<li><a href="#index-ury-_0040r_007b_0028_0040samp_007bpsfile_007d-special-option_0029_007d-405"><code>ury </code><span class="roman">(&lsquo;</span><samp><span class="samp">psfile</span></samp><span class="roman">&rsquo; special option)</span></a>: <a href="#psfile-special">psfile special</a></li>
+<li><a href="#index-user_002ddefinable-colors-674">user-definable colors</a>: <a href="#User_002ddefinable-colors">User-definable colors</a></li>
+<li><a href="#index-userdict_0040r_007b_002c-and-dictionary-files_007d-422"><code>userdict</code><span class="roman">, and dictionary files</span></a>: <a href="#Header-files">Header files</a></li>
<li><a href="#index-userdict_0040r_007b_002c-used-for-header-files_007d-133">userdict<span class="roman">, used for header files</span></a>: <a href="#Option-details">Option details</a></li>
-<li><a href="#index-V-_0040r_007bconfig-command-_0028vf-path_0029_007d-322"><code>V </code><span class="roman">config command (vf path)</span></a>: <a href="#Configuration-file-commands">Configuration file commands</a></li>
-<li><a href="#index-verbose-EPSF-processing-375">verbose EPSF processing</a>: <a href="#EPSF-macros">EPSF macros</a></li>
-<li><a href="#index-vf-files-536">vf files</a>: <a href="#Virtual-fonts">Virtual fonts</a></li>
-<li><a href="#index-virtual-font-expansion-540">virtual font expansion</a>: <a href="#Virtual-fonts">Virtual fonts</a></li>
-<li><a href="#index-virtual-font-path-323">virtual font path</a>: <a href="#Configuration-file-commands">Configuration file commands</a></li>
-<li><a href="#index-virtual-fonts-535">virtual fonts</a>: <a href="#Virtual-fonts">Virtual fonts</a></li>
-<li><a href="#index-virtual-fonts_002c-creating-572">virtual fonts, creating</a>: <a href="#Invoking-afm2tfm">Invoking afm2tfm</a></li>
+<li><a href="#index-V-_0040r_007bconfig-command-_0028vf-path_0029_007d-323"><code>V </code><span class="roman">config command (vf path)</span></a>: <a href="#Configuration-file-commands">Configuration file commands</a></li>
+<li><a href="#index-verbose-EPSF-processing-378">verbose EPSF processing</a>: <a href="#EPSF-macros">EPSF macros</a></li>
+<li><a href="#index-vf-files-539">vf files</a>: <a href="#Virtual-fonts">Virtual fonts</a></li>
+<li><a href="#index-virtual-font-expansion-543">virtual font expansion</a>: <a href="#Virtual-fonts">Virtual fonts</a></li>
+<li><a href="#index-virtual-font-path-324">virtual font path</a>: <a href="#Configuration-file-commands">Configuration file commands</a></li>
+<li><a href="#index-virtual-fonts-538">virtual fonts</a>: <a href="#Virtual-fonts">Virtual fonts</a></li>
+<li><a href="#index-virtual-fonts_002c-creating-575">virtual fonts, creating</a>: <a href="#Invoking-afm2tfm">Invoking afm2tfm</a></li>
<li><a href="#index-VM-exhausted-67">VM exhausted</a>: <a href="#Printer-errors">Printer errors</a></li>
-<li><a href="#index-VMusage-440"><code>VMusage</code></a>: <a href="#Headers-and-memory-usage">Headers and memory usage</a></li>
-<li><a href="#index-voffset-_0040r_007b_0028_0040samp_007bpsfile_007d-special-option_0029_007d-392"><code>voffset </code><span class="roman">(&lsquo;</span><samp><span class="samp">psfile</span></samp><span class="roman">&rsquo; special option)</span></a>: <a href="#psfile-special">psfile special</a></li>
-<li><a href="#index-vpl-files-537">vpl files</a>: <a href="#Virtual-fonts">Virtual fonts</a></li>
-<li><a href="#index-vptovf-567"><code>vptovf</code></a>: <a href="#Making-a-font-available">Making a font available</a></li>
-<li><a href="#index-vscale-_0040r_007b_0028_0040samp_007bpsfile_007d-special-option_0029_007d-396"><code>vscale </code><span class="roman">(&lsquo;</span><samp><span class="samp">psfile</span></samp><span class="roman">&rsquo; special option)</span></a>: <a href="#psfile-special">psfile special</a></li>
-<li><a href="#index-vsize-_0040r_007b_0028_0040samp_007bpsfile_007d-special-option_0029_007d-394"><code>vsize </code><span class="roman">(&lsquo;</span><samp><span class="samp">psfile</span></samp><span class="roman">&rsquo; special option)</span></a>: <a href="#psfile-special">psfile special</a></li>
-<li><a href="#index-W-_0040r_007bconfig-command-_0028warning_0029_007d-325"><code>W </code><span class="roman">config command (warning)</span></a>: <a href="#Configuration-file-commands">Configuration file commands</a></li>
-<li><a href="#index-warning-messages_002c-defining-326">warning messages, defining</a>: <a href="#Configuration-file-commands">Configuration file commands</a></li>
+<li><a href="#index-VMusage-443"><code>VMusage</code></a>: <a href="#Headers-and-memory-usage">Headers and memory usage</a></li>
+<li><a href="#index-voffset-_0040r_007b_0028_0040samp_007bpsfile_007d-special-option_0029_007d-395"><code>voffset </code><span class="roman">(&lsquo;</span><samp><span class="samp">psfile</span></samp><span class="roman">&rsquo; special option)</span></a>: <a href="#psfile-special">psfile special</a></li>
+<li><a href="#index-vpl-files-540">vpl files</a>: <a href="#Virtual-fonts">Virtual fonts</a></li>
+<li><a href="#index-vptovf-570"><code>vptovf</code></a>: <a href="#Making-a-font-available">Making a font available</a></li>
+<li><a href="#index-vscale-_0040r_007b_0028_0040samp_007bpsfile_007d-special-option_0029_007d-399"><code>vscale </code><span class="roman">(&lsquo;</span><samp><span class="samp">psfile</span></samp><span class="roman">&rsquo; special option)</span></a>: <a href="#psfile-special">psfile special</a></li>
+<li><a href="#index-vsize-_0040r_007b_0028_0040samp_007bpsfile_007d-special-option_0029_007d-397"><code>vsize </code><span class="roman">(&lsquo;</span><samp><span class="samp">psfile</span></samp><span class="roman">&rsquo; special option)</span></a>: <a href="#psfile-special">psfile special</a></li>
+<li><a href="#index-W-_0040r_007bconfig-command-_0028warning_0029_007d-326"><code>W </code><span class="roman">config command (warning)</span></a>: <a href="#Configuration-file-commands">Configuration file commands</a></li>
+<li><a href="#index-warning-messages_002c-defining-327">warning messages, defining</a>: <a href="#Configuration-file-commands">Configuration file commands</a></li>
<li><a href="#index-warnings_002c-suppressing-198">warnings, suppressing</a>: <a href="#Option-details">Option details</a></li>
-<li><a href="#index-whole-font-downloading-645">whole font downloading</a>: <a href="#psfonts_002emap">psfonts.map</a></li>
-<li><a href="#index-wide-fonts-651">wide fonts</a>: <a href="#psfonts_002emap">psfonts.map</a></li>
-<li><a href="#index-X-_0040r_007bconfig-command-_0028horizontal-resolution_0029_007d-327"><code>X </code><span class="roman">config command (horizontal resolution)</span></a>: <a href="#Configuration-file-commands">Configuration file commands</a></li>
+<li><a href="#index-whole-font-downloading-660">whole font downloading</a>: <a href="#psfonts_002emap">psfonts.map</a></li>
+<li><a href="#index-wide-fonts-648">wide fonts</a>: <a href="#psfonts_002emap">psfonts.map</a></li>
+<li><a href="#index-X-_0040r_007bconfig-command-_0028horizontal-resolution_0029_007d-328"><code>X </code><span class="roman">config command (horizontal resolution)</span></a>: <a href="#Configuration-file-commands">Configuration file commands</a></li>
<li><a href="#index-Xerox-4045-224">Xerox 4045</a>: <a href="#Option-details">Option details</a></li>
-<li><a href="#index-Y-_0040r_007bconfig-command-_0028vertical-resolution_0029_007d-328"><code>Y </code><span class="roman">config command (vertical resolution)</span></a>: <a href="#Configuration-file-commands">Configuration file commands</a></li>
+<li><a href="#index-Y-_0040r_007bconfig-command-_0028vertical-resolution_0029_007d-329"><code>Y </code><span class="roman">config command (vertical resolution)</span></a>: <a href="#Configuration-file-commands">Configuration file commands</a></li>
<li><a href="#index-Y_0026Y-fonts_002c-installing-26">Y&amp;Y fonts, installing</a>: <a href="#PostScript-font-installation">PostScript font installation</a></li>
-<li><a href="#index-Z-_0040r_007bconfig-command-_0028compression_0029_007d-329"><code>Z </code><span class="roman">config command (compression)</span></a>: <a href="#Configuration-file-commands">Configuration file commands</a></li>
-<li><a href="#index-z-_0040r_007bconfig-command-_0028secure-mode_0029_007d-330"><code>z </code><span class="roman">config command (secure mode)</span></a>: <a href="#Configuration-file-commands">Configuration file commands</a></li>
+<li><a href="#index-Z-_0040r_007bconfig-command-_0028compression_0029_007d-330"><code>Z </code><span class="roman">config command (compression)</span></a>: <a href="#Configuration-file-commands">Configuration file commands</a></li>
+<li><a href="#index-z-_0040r_007bconfig-command-_0028secure-mode_0029_007d-331"><code>z </code><span class="roman">config command (secure mode)</span></a>: <a href="#Configuration-file-commands">Configuration file commands</a></li>
<li><a href="#index-g_t_007c-_0040r_007bstarting-output-filename_007d-177"><code>| </code><span class="roman">starting output filename</span></a>: <a href="#Option-details">Option details</a></li>
</ul><!-- INSTALLONLY -->
</body></html>
diff --git a/Master/texmf/doc/dvips/dvips.pdf b/Master/texmf/doc/dvips/dvips.pdf
index 4fb49a0c3a7..ac9ce039a45 100644
--- a/Master/texmf/doc/dvips/dvips.pdf
+++ b/Master/texmf/doc/dvips/dvips.pdf
Binary files differ
diff --git a/Master/texmf/doc/info/asymptote.info b/Master/texmf/doc/info/asymptote.info
index 0df4062ecf3..108efc52ce3 100644
--- a/Master/texmf/doc/info/asymptote.info
+++ b/Master/texmf/doc/info/asymptote.info
@@ -1,7 +1,7 @@
This is asymptote.info, produced by makeinfo version 4.13 from
../asymptote.texi.
-This file documents `Asymptote', version 1.77.
+This file documents `Asymptote', version 1.88.
`http://asymptote.sourceforge.net'
@@ -23,7 +23,7 @@ File: asymptote.info, Node: Top, Next: Description, Up: (dir)
Asymptote
*********
-This file documents `Asymptote', version 1.77.
+This file documents `Asymptote', version 1.88.
`http://asymptote.sourceforge.net'
@@ -40,6 +40,7 @@ This file documents `Asymptote', version 1.77.
* Installation:: Downloading and installing
* Tutorial:: Getting started
* Drawing commands:: Four primitive graphics commands
+* Bezier curves:: Path connectors and direction specifiers
* Programming:: The `Asymptote' vector graphics language
* LaTeX usage:: Embedding `Asymptote' commands within `LaTeX'
* Base modules:: Base modules shipped with `Asymptote'
@@ -153,8 +154,8 @@ Base modules
Graphical User Interface
-* GUI Installation:: Installing `xasy'
-* GUI Usage::
+* GUI installation:: Installing `xasy'
+* GUI usage::

File: asymptote.info, Node: Description, Next: Installation, Prev: Top, Up: Top
@@ -195,6 +196,9 @@ weaker syntax and capabilities) called `MetaPost'.
* `LaTeX' typesetting of labels, for overall document consistency;
+ * the ability to generate and embed 3D vector PRC graphics within
+ PDF files;
+
* a natural coordinate-based framework for technical drawings,
inspired by `MetaPost', with a much cleaner, powerful C++-like
programming syntax;
@@ -260,7 +264,7 @@ We recommend subscribing to new release announcements at
`http://freshmeat.net/projects/asy'
Users may also wish to monitor the `Asymptote' forum:
- `http://sourceforge.net/forum/monitor.php?forum_id=409349'
+ `http://sourceforge.net/projects/asymptote/forums/forum/409349'

File: asymptote.info, Node: UNIX binary distributions, Next: MacOS X binary distributions, Up: Installation
@@ -308,10 +312,9 @@ source:
`http://sourceforge.net/project/showfiles.php?group_id=120000'
-Note that many `MacOS X' (and FreeBSD) systems inexplicably ship with
-an extremely old GNU `readline' version (4.1, dated 21 March 2000). For
-full interactive functionality, `readline' version 4.2 or later (16
-April 2001) is required.
+Note that many `MacOS X' (and FreeBSD) systems lack the GNU `readline'
+library. For full interactive functionality, GNU `readline' version 4.3
+or later must be installed.

File: asymptote.info, Node: Microsoft Windows, Next: Configuring, Prev: MacOS X binary distributions, Up: Installation
@@ -326,9 +329,19 @@ where `x.xx' denotes the latest version.
A working TeX implementation (such as the one available at
`http://www.miktex.org') will be required to typeset labels. You will
also need to install `GPL Ghostscript' from
-`http://sourceforge.net/projects/ghostscript/'. To view the default
-`PostScript' output, you can install the program `gsview' available from
-`http://www.cs.wisc.edu/~ghost/gsview/'.
+`http://sourceforge.net/projects/ghostscript/'.
+
+ To view the default `PostScript' output, you can install the program
+`gsview' available from `http://www.cs.wisc.edu/~ghost/gsview/'. A
+better (and free) `PostScript' viewer available at
+`http://psview.sourceforge.net/' (which in particular works properly in
+interactive mode) unfortunately currently requires some manual
+configuration. Specifically, if version `x.xx' of `psview' is extracted
+to the directory `c:\Program Files' one needs to put
+import settings;
+psviewer="c:\Program Files\psview-x.xx\psv.exe";
+ in the optional `Asymptote' configuration file; *note configuration
+file::).
The `ImageMagick' package from
@@ -362,24 +375,26 @@ interactive mode to work properly. Users of `ggv' will need to enable
`Watch file' under `Edit/Postscript Viewer Preferences'. Users of
`gsview' will need to enable `Options/Auto Redisplay' (however, under
`MSDOS' it is still necessary to click on the `gsview' window; under
-`UNIX' one must manually redisplay by pressing the `r' key).
+`UNIX' one must manually redisplay by pressing the `r' key). A better
+(and free) multiplatform alternative to `gsview' is `psview' (*note
+psview::).
Configuration variables are most easily set as `Asymptote' variables
-in an optional configuration file (by default, `.asy/config.asy' in the
-user's home directory or `%USERPROFILE%\.asy\config.asy' under
-`MSDOS'); *note configuration file::. Here are the default values of
-several important configuration variables under `UNIX':
+in an optional configuration file `config.asy' *note configuration
+file::). Here are the default values of several important configuration
+variables under `UNIX':
import settings;
psviewer="gv";
pdfviewer="acroread";
gs="gs";
-python="";
-The (installation-dependent) default values of these configuration
-variables under `MSDOS' are determined automatically from the
-`Microsoft Windows' registry.
+Under `MSDOS', the (installation-dependent) default values of these
+configuration variables are determined automatically from the
+`Microsoft Windows' registry. Viewer settings (such as `psviewer' and
+`pdfviewer') can be set to the string `cmd' to request the application
+normally associated with the corresponding file type.
For PDF format output, the `gs' setting specifies the location of
the `PostScript'-to-PDF processor `Ghostscript', available from
@@ -399,9 +414,6 @@ pdfreloadOptions="-tempFile";
useful under `MSDOS' since the document cannot be updated anyway on
that operating system until it is first closed by `Adobe Reader'.
- The graphical user interface may also require setting the variable
-`python' if `Python' is installed in a nonstandard location.
-
The configuration variable `dir' can be used to adjust the search
path (*note Search paths::).
@@ -415,15 +427,17 @@ variables `paperwidth' and `paperheight'.
adjustment:
texpath
texcommand
-texdvicommand
dvips
+dvisvg
convert
display
animate
-xasy
- The `texdvicommand' is used for `3D' label typesetting, which requires
-`dvips' output. An empty string indicates the default setting of
-`latex'/`tex', depending on the setting of `texengine'.
+ Warnings (such as "writeoverloaded") may be enabled or disabled with
+the functions
+warn(string s);
+nowarn(string s);
+ or by directly modifying the string array `settings.suppress', which
+lists all disabled warnings.
Configuration variables may also be set or overwritten with a
command-line option:
@@ -459,8 +473,10 @@ following paths, in the order listed:
2. A list of one or more directories specified by the configuration
variable `dir' (separated by `:' under UNIX and `;' under `MSDOS');
- 3. The directory `.asy' in the user's home directory
- (`%USERPROFILE%\.asy' under `MSDOS');
+ 3. The directory specified by the environment variable
+ `ASYMPTOTE_HOME'; if this variable is not set, the directory
+ `.asy' in the user's home directory (`%USERPROFILE%\.asy' under
+ `MSDOS') is used;
4. The `Asymptote' system directory (by default,
`/usr/local/share/asymptote' under `UNIX' and `C:\Program
@@ -482,17 +498,16 @@ used; if it is old we recommend first putting
`http://www.hpl.hp.com/personal/Hans_Boehm/gc/gc_source/gc-7.1.tar.gz'
in the `Asymptote' source directory.
-If your graphics card supports multisampling, we recommend using SVN
-revision 761 (or later) of `freeglut' to support antialiasing in
+If your graphics card supports multisampling, we recommend using version
+`2.6.0-rc1' (or later) of `freeglut' to support antialiasing in
`Asymptote''s adaptive `OpenGL' 3D renderer (`MacOS X' users can skip
this step since `Asymptote' is configured to use the native glut
library on that platform). Download
- `http://freeglut.svn.sourceforge.net/viewvc/freeglut/trunk/freeglut/freeglut.tar.gz'
+ `http://prdownloads.sourceforge.net/freeglut/freeglut-2.6.0-rc1.tar.gz'
and type (as the root user):
-tar -zxf freeglut.tar.gz
-cd freeglut
-sh autogen.sh
+tar -zxf freeglut-2.6.0-rc1.tar.gz
+cd freeglut-2.6.0
./configure --prefix=/usr
make install
cd ..
@@ -520,7 +535,7 @@ for header files and libraries in nonstandard locations:
If you are compiling `Asymptote' with `gcc', you will need a
relatively recent version (e.g. 3.4.4 or later). For full interactive
-functionality, you will need version 4.2 or later of the GNU `readline'
+functionality, you will need version 4.3 or later of the GNU `readline'
library. The file `gcc3.3.2curses.patch' in the `patches' directory can
be used to patch the broken curses.h header file (or a local copy
thereof in the current directory) on some `AIX' and `IRIX' systems.
@@ -584,6 +599,11 @@ add to `~/.vim/ftplugin/asy.vim':
setlocal makeprg=asy\ %
setlocal errorformat=%f:\ %l.%c:\ %m
+ Syntax highlighting support for the KDE editor `Kate' can be enabled
+by running `asy-kate.sh' in the `/usr/local/share/asymptote' directory
+and putting the generated `asymptote.xml' file in
+`~/.kde/share/apps/katepart/syntax/'.
+

File: asymptote.info, Node: Subversion, Next: Uninstall, Prev: Editing modes, Up: Installation
@@ -591,7 +611,7 @@ File: asymptote.info, Node: Subversion, Next: Uninstall, Prev: Editing modes,
====================
The following commands are needed to install the latest development
-version of `Asymptote' using Subversion:
+version of `Asymptote' using `Subversion':
svn co http://asymptote.svn.sourceforge.net/svnroot/asymptote/trunk/asymptote
cd asymptote
./autogen.sh
@@ -621,86 +641,96 @@ File: asymptote.info, Node: Tutorial, Next: Drawing commands, Prev: Installat
3 Tutorial
**********
-_An excellent user-written `Asymptote' tutorial is also available from_
+3.1 Drawing in batch mode
+=========================
- `http://www.artofproblemsolving.com/Wiki/index.php/Asymptote:_Basics'
+To draw a line from coordinate (0,0) to coordinate (100,100), create a
+text file `test.asy' containing
-To draw a line from coordinate (0,0) to coordinate (100,100) using
-`Asymptote''s interactive mode, type at the command prompt:
-asy
draw((0,0)--(100,100));
+ Then execute the command
+asy -V test
+ Alternatively, `MSDOS' users can drag and drop `test.asy' onto the
+Desktop `asy' icon (or make `Asymptote' the default application for the
+extension `asy').
+This method, known as _batch mode_, outputs a `PostScript' file
+`test.eps'. The `-V' option opens up a `PostScript' viewer window so
+you can immediately view the result:
-The units here are `PostScript' "big points" (1 `bp' = 1/72 `inch');
-`--' means join with a linear segment. In `Asymptote' coordinates like
-`(0,0)' and `(1000,100)' are called _pairs_.
-
- At this point you can type in further draw commands, which will be
-added to the displayed figure, or type `quit' to exit interactive mode.
-You can use the arrow keys in interactive mode to edit previous lines
-(assuming that you have support for the GNU `readline' library
-enabled). The tab key will automatically complete unambiguous words;
-otherwise, hitting tab again will show the possible choices. Further
-commands specific to interactive mode are described in *note
-Interactive mode::.
+The `--' connector joins the two points `(0,0)' and `(100,100)' with a
+line segment.
- In batch mode, `Asymptote' reads commands directly from a file. To
-try this out, type
+3.2 Drawing in interactive mode
+===============================
+Another method is _interactive mode_, where `Asymptote' reads
+individual commands as they are entered by the user. To try this out,
+enter `Asymptote''s interactive mode by clicking on the `Asymptote'
+icon or typing the command `asy'. Then type
draw((0,0)--(100,100));
- into a file, say test.asy. Then execute this file with the `MSDOS' or
-`UNIX' command
-asy -V test
- `MSDOS' users can drag and drop the file onto the Desktop `asy' icon
-or make `Asymptote' the default application for files with the
-extension `asy'.
+ followed by `Enter', to obtain the above image. At this point you can
+type further `draw' commands, which will be added to the displayed
+figure, `erase' to clear the canvas,
+input test;
+ to execute all of the commands contained in the file `test.asy', or
+`quit' to exit interactive mode. You can use the arrow keys in
+interactive mode to edit previous lines. The tab key will
+automatically complete unambiguous words; otherwise, hitting tab again
+will show the possible choices. Further commands specific to
+interactive mode are described in *note Interactive mode::.
+
+3.3 Figure size
+===============
-The `-V' option opens up a `PostScript' viewer window so you can
-immediately view the encapsulated `PostScript' output. By default the
-output will be written to the file `test.eps'; the prefix of the output
-file may be changed with the `-o' command-line option.
+In `Asymptote', coordinates like `(0,0)' and `(100,100)', called
+_pairs_, are expressed in `PostScript' "big points" (1 `bp' = 1/72
+`inch') and the default line width is `0.5bp'. However, it is often
+inconvenient to work directly in `PostScript' coordinates. The next
+example produces identical output to the previous example, by scaling
+the line `(0,0)--(1,1)' to fit a rectangle of width `100.5 bp' and
+height `100.5 bp' (the extra `0.5bp' accounts for the line width):
+size(100.5,100.5);
+draw((0,0)--(1,1));
- One can draw a line with more than two points and create a cyclic
-path like this square:
-draw((0,0)--(100,0)--(100,100)--(0,100)--cycle);
+One can also specify the size in `pt' (1 `pt' = 1/72.27 `inch'), `cm',
+`mm', or `inches'. Two nonzero size arguments (or a single size
+argument) restrict the size in both directions, preserving the aspect
+ratio. If 0 is given as a size argument, no restriction is made in
+that direction; the overall scaling will be determined by the other
+direction (*note size::):
+size(0,100.5);
+draw((0,0)--(2,1),Arrow);
-It is often inconvenient to work directly with `PostScript' coordinates.
-The next example draws a unit square scaled to width 101 bp and height
-101 bp. The output is identical to that of the previous example.
-size(101,101);
-draw((0,0)--(1,0)--(1,1)--(0,1)--cycle);
- For convenience, the path `(0,0)--(1,0)--(1,1)--(0,1)--cycle' may be
-replaced with the predefined variable `unitsquare', or equivalently,
-`box((0,0),(1,1))'.
- One can also specify the size in `pt' (1 `pt' = 1/72.27 `inch'),
-`cm', `mm', or `inches'. If 0 is given as a size argument, no
-restriction is made in that direction; the overall scaling will be
-determined by the other direction (*note size::):
+To connect several points and create a cyclic path, use the `cycle'
+keyword:
-size(0,3cm);
-draw(unitsquare);
+size(100,100);
+draw((0,0)--(1,0)--(1,1)--(0,1)--cycle);
+For convenience, the path `(0,0)--(1,0)--(1,1)--(0,1)--cycle' may be
+replaced with the predefined variable `unitsquare', or equivalently,
+`box((0,0),(1,1))'.
-To make the user coordinates represent multiples of exactly `1cm':
+ To make the user coordinates represent multiples of exactly `1cm':
unitsize(1cm);
draw(unitsquare);
- One can also specify different x and y unit sizes:
-unitsize(1cm,2cm);
-draw(unitsquare);
+3.4 Labels
+==========
- Adding labels is easy in `Asymptote'; one specifies the label as a
+Adding labels is easy in `Asymptote'; one specifies the label as a
double-quoted `LaTeX' string, a coordinate, and an optional alignment
direction:
-size(0,3cm);
+size(3cm);
draw(unitsquare);
label("$A$",(0,0),SW);
label("$B$",(1,0),SE);
@@ -712,107 +742,32 @@ label("$D$",(0,1),NW);
`Asymptote' uses the standard compass directions `E=(1,0)', `N=(0,1)',
`NE=unit(N+E)', and `ENE=unit(E+NE)', etc., which along with the
directions `up', `down', `right', and `left' are defined as pairs in
-the `Asymptote' base module `plain'. A user who has a local variable
+the `Asymptote' base module `plain' (a user who has a local variable
named `E' may access the compass direction `E' by prefixing it with the
-name of the module where it is defined: `plain.E'.
+name of the module where it is defined: `plain.E').
- This example draws a path that approximates a quarter circle:
+3.5 Paths
+=========
+
+This example draws a path that approximates a quarter circle,
+terminated with an arrowhead:
size(100,0);
-draw((1,0){up}..{left}(0,1));
+draw((1,0){up}..{left}(0,1),Arrow);
+Here the directions `up' and `left' in braces specify the incoming and
+outgoing directions at the points `(1,0)' and `(0,1)', respectively.
-In general, a path is specified as a list of pairs (or other paths)
+ In general, a path is specified as a list of points (or other paths)
interconnected with `--', which denotes a straight line segment, or
-`..', which denotes a cubic spline. Specifying a final node `cycle'
-creates a cyclic path that connects smoothly back to the initial node,
-as in this approximation (accurate to within 0.06%) of a unit circle:
+`..', which denotes a cubic spline (*note Bezier curves::). Specifying
+a final `..cycle' creates a cyclic path that connects smoothly back to
+the initial node, as in this approximation (accurate to within 0.06%)
+of a unit circle:
path unitcircle=E..N..W..S..cycle;
- Each interior node of a cubic spline may be given a direction prefix
-or suffix `{dir}': the direction of the pair `dir' specifies the
-direction of the incoming or outgoing tangent, respectively, to the
-curve at that node. Exterior nodes may be given direction specifiers
-only on their interior side.
-
- A cubic spline between the node z_0, with postcontrol point c_0, and
-the node z_1, with precontrol point c_1, is computed as the Bezier curve
-
-
-
-As illustrated in the diagram below, the third-order midpoint (m_5)
-constructed from two endpoints z_0 and z_1 and two control points c_0
-and c_1, is the point corresponding to t=1/2 on the Bezier curve formed
-by the quadruple (z_0, c_0, c_1, z_1). This allows one to recursively
-construct the desired curve, by using the newly extracted third-order
-midpoint as an endpoint and the respective second- and first-order
-midpoints as control points:
-
-
-
-Here m_0, m_1 and m_2 are the first-order midpoints, m_3 and m_4 are
-the second-order midpoints, and m_5 is the third-order midpoint. The
-curve is then constructed by recursively applying the algorithm to
-(z_0, m_0, m_3, m_5) and (m_5, m_4, m_2, z_1).
-
- In fact, an analogous property holds for points located at any
-fraction t in [0,1] of each segment, not just for midpoints (t=1/2).
-
- The Bezier curve constructed in this manner has the following
-properties:
- * It is entirely contained in the convex hull of the given four
- points.
-
- * It starts heading from the first endpoint to the first control
- point and finishes heading from the second control point to the
- second endpoint.
-
-
- The user can specify explicit control points between two nodes like
-this:
-draw((0,0)..controls (0,100) and (100,100)..(100,0));
-
- However, it is usually more convenient to just use the `..'
-operator, which tells `Asymptote' to choose its own control points
-using the algorithms described in Donald Knuth's monograph, The
-MetaFontbook, Chapter 14. The user can still customize the guide (or
-path) by specifying direction, tension, and curl values.
-
- The higher the tension, the straighter the curve is, and the more it
-approximates a straight line. One can change the spline tension from
-its default value of 1 to any real value greater than or equal to 0.75
-(cf. John D. Hobby, Discrete and Computational Geometry 1, 1986):
-draw((100,0)..tension 2 ..(100,100)..(0,100));
-draw((100,0)..tension 2 and 1 ..(100,100)..(0,100));
-draw((100,0)..tension atleast 1 ..(100,100)..(0,100));
-
- The curl parameter specifies the curvature at the endpoints of a path
-(0 means straight; the default value of 1 means approximately circular):
-draw((100,0){curl 0}..(100,100)..{curl 0}(0,100));
-
- The `MetaPost ...' path connector, which requests, when possible, an
-inflection-free curve confined to a triangle defined by the endpoints
-and directions, is implemented in `Asymptote' as the convenient
-abbreviation `::' for `..tension atleast 1 ..' (the ellipsis `...' is
-used in `Asymptote' to indicate a variable number of arguments; *note
-Rest arguments::). For example, compare
-
-draw((0,0){up}..(100,25){right}..(200,0){down});
-
-
-with
-
-draw((0,0){up}::(100,25){right}::(200,0){down});
-
-
-
-The `---' connector is an abbreviation for `..tension atleast
-infinity..' and the `&' connector concatenates two paths, after first
-stripping off the last node of the first path (which normally should
-coincide with the first node of the second path).
-
- An `Asymptote' path, being connected, is equivalent to a `Postscript
+An `Asymptote' path, being connected, is equivalent to a `Postscript
subpath'. The `^^' binary operator, which requests that the pen be
moved (without drawing or affecting endpoint curvatures) from the final
point of the left-hand path to the initial point of the right-hand
@@ -834,8 +789,8 @@ orientation of the paths:
filldraw(unitcircle^^reverse(g),yellow,black);
The `^^' operator is used by the `box(triple, triple)' function in
-`three.asy' to construct the edges of a cube `unitbox' without
-retracing steps:
+the module `three.asy' to construct the edges of a cube `unitbox'
+without retracing steps (*note three::):
import three;
dotgranularity=0; // Render dots as spheres.
@@ -858,12 +813,14 @@ label("(0,0,1)",(0,0,1),Z);
See section *note graph:: (or the online `Asymptote' gallery and
external links posted at `http://asymptote.sourceforge.net') for
-further examples, including two and three-dimensional scientific
-graphs. Additional examples have been posted by Philippe Ivaldi at
-`http://piprim.tuxfamily.org/asymptote/'.
+further examples, including two-dimensional and interactive
+three-dimensional scientific graphs. Additional examples have been
+posted by Philippe Ivaldi at `http://www.piprime.fr/asymptote'. A
+user-written `Asymptote' tutorial is available at
+http://www.artofproblemsolving.com/Wiki/index.php/Asymptote:_Basics

-File: asymptote.info, Node: Drawing commands, Next: Programming, Prev: Tutorial, Up: Top
+File: asymptote.info, Node: Drawing commands, Next: Bezier curves, Prev: Tutorial, Up: Top
4 Drawing commands
******************
@@ -935,12 +892,12 @@ arrowhead styles `DefaultHead', `SimpleHead', `HookHead', `TeXHead'),
real `size' (arrowhead size in `PostScript' coordinates), real `angle'
(arrowhead angle in degrees), filltype `filltype' (one of `FillDraw',
`Fill', `NoFill', `UnFill', `Draw') and (except for `MidArrow' and
-`Arrows') a relative real `position' along the path (an `arctime') where
-the tip of the arrow should be placed. The default arrowhead size when
-drawn with a pen `p' is `arrowsize(p)'. There are also arrow versions
-with slightly modified default values of `size' and `angle' suitable for
-curved arrows: `BeginArcArrow', `EndArcArrow' (or equivalently
-`ArcArrow'), `MidArcArrow', and `ArcArrows'.
+`Arrows') a real `position' (in the sense of `point(path p, real t)')
+along the path where the tip of the arrow should be placed. The default
+arrowhead size when drawn with a pen `p' is `arrowsize(p)'. There are
+also arrow versions with slightly modified default values of `size' and
+`angle' suitable for curved arrows: `BeginArcArrow', `EndArcArrow' (or
+equivalently `ArcArrow'), `MidArcArrow', and `ArcArrows'.
Margins can be used to shrink the visible portion of a path by
`labelmargin(p)' to avoid overlap with other drawn objects. Typical
@@ -1195,11 +1152,11 @@ Label should transform with the embedding picture:
void label(picture pic=currentpicture, Label L, path g, align align=NoAlign,
pen p=nullpen, filltype filltype=NoFill);
By default the label will be positioned at the midpoint of the path.
-An alternative label location (an `arctime' value between 0 and
-`length(g)' *note arctime::) may be specified as real value for
-`position' in constructing the Label. The position `Relative(real)'
-specifies a location relative to the total arclength of the path. These
-convenient abbreviations are predefined:
+An alternative label position (in the sense of `point(path p, real t)')
+may be specified as a real value for `position' in constructing the
+Label. The position `Relative(real)' specifies a location relative to
+the total arclength of the path. These convenient abbreviations are
+predefined:
position BeginPoint=Relative(0);
position MidPoint=Relative(0.5);
position EndPoint=Relative(1);
@@ -1282,9 +1239,97 @@ label(graphic("logo."+nativeformat(),"height=7cm"),(0,-0.22));
clip(unitcircle^^(scale(2/11.7)*unitcircle),evenodd);

-File: asymptote.info, Node: Programming, Next: LaTeX usage, Prev: Drawing commands, Up: Top
+File: asymptote.info, Node: Bezier curves, Next: Programming, Prev: Drawing commands, Up: Top
+
+5 Bezier curves
+***************
+
+Each interior node of a cubic spline may be given a direction prefix or
+suffix `{dir}': the direction of the pair `dir' specifies the direction
+of the incoming or outgoing tangent, respectively, to the curve at that
+node. Exterior nodes may be given direction specifiers only on their
+interior side.
+
+ A cubic spline between the node z_0, with postcontrol point c_0, and
+the node z_1, with precontrol point c_1, is computed as the Bezier curve
+
+
+
+As illustrated in the diagram below, the third-order midpoint (m_5)
+constructed from two endpoints z_0 and z_1 and two control points c_0
+and c_1, is the point corresponding to t=1/2 on the Bezier curve formed
+by the quadruple (z_0, c_0, c_1, z_1). This allows one to recursively
+construct the desired curve, by using the newly extracted third-order
+midpoint as an endpoint and the respective second- and first-order
+midpoints as control points:
+
+
+
+Here m_0, m_1 and m_2 are the first-order midpoints, m_3 and m_4 are
+the second-order midpoints, and m_5 is the third-order midpoint. The
+curve is then constructed by recursively applying the algorithm to
+(z_0, m_0, m_3, m_5) and (m_5, m_4, m_2, z_1).
+
+ In fact, an analogous property holds for points located at any
+fraction t in [0,1] of each segment, not just for midpoints (t=1/2).
+
+ The Bezier curve constructed in this manner has the following
+properties:
+ * It is entirely contained in the convex hull of the given four
+ points.
+
+ * It starts heading from the first endpoint to the first control
+ point and finishes heading from the second control point to the
+ second endpoint.
+
+
+ The user can specify explicit control points between two nodes like
+this:
+draw((0,0)..controls (0,100) and (100,100)..(100,0));
+
+ However, it is usually more convenient to just use the `..'
+operator, which tells `Asymptote' to choose its own control points
+using the algorithms described in Donald Knuth's monograph, The
+MetaFontbook, Chapter 14. The user can still customize the guide (or
+path) by specifying direction, tension, and curl values.
+
+ The higher the tension, the straighter the curve is, and the more it
+approximates a straight line. One can change the spline tension from
+its default value of 1 to any real value greater than or equal to 0.75
+(cf. John D. Hobby, Discrete and Computational Geometry 1, 1986):
+draw((100,0)..tension 2 ..(100,100)..(0,100));
+draw((100,0)..tension 2 and 1 ..(100,100)..(0,100));
+draw((100,0)..tension atleast 1 ..(100,100)..(0,100));
+
+ The curl parameter specifies the curvature at the endpoints of a path
+(0 means straight; the default value of 1 means approximately circular):
+draw((100,0){curl 0}..(100,100)..{curl 0}(0,100));
+
+ The `MetaPost ...' path connector, which requests, when possible, an
+inflection-free curve confined to a triangle defined by the endpoints
+and directions, is implemented in `Asymptote' as the convenient
+abbreviation `::' for `..tension atleast 1 ..' (the ellipsis `...' is
+used in `Asymptote' to indicate a variable number of arguments; *note
+Rest arguments::). For example, compare
+
+draw((0,0){up}..(100,25){right}..(200,0){down});
+
+
+with
+
+draw((0,0){up}::(100,25){right}::(200,0){down});
+
+
+
+The `---' connector is an abbreviation for `..tension atleast
+infinity..' and the `&' connector concatenates two paths, after first
+stripping off the last node of the first path (which normally should
+coincide with the first node of the second path).
+
+
+File: asymptote.info, Node: Programming, Next: LaTeX usage, Prev: Bezier curves, Up: Top
-5 Programming
+6 Programming
*************
Here is a short introductory example to the `Asymptote' programming
@@ -1343,7 +1388,7 @@ languages.

File: asymptote.info, Node: Data types, Next: Paths and guides, Up: Programming
-5.1 Data types
+6.1 Data types
==============
`Asymptote' supports the following data types (in addition to
@@ -1601,7 +1646,7 @@ user-defined types):
string pairs {`before',`after'} to the corresponding string
`after';
- `string[] split(string s, string delimiter)'
+ `string[] split(string s, string delimiter=" ")'
returns an array of strings obtained by splitting `s' into
substrings delimited by `delimiter';
@@ -1686,7 +1731,7 @@ user-defined types):

File: asymptote.info, Node: Paths and guides, Next: Pens, Prev: Data types, Up: Programming
-5.2 Paths and guides
+6.2 Paths and guides
====================
`path'
@@ -1722,14 +1767,13 @@ File: asymptote.info, Node: Paths and guides, Next: Pens, Prev: Data types,
path Arc(pair c, explicit pair z1, explicit pair z2,
bool direction=CCW, int n=nCircle);
- An ellipse can be drawn with the routine @cindex @code{ellipse}
- path ellipse(pair c, real a, real b)
+ An ellipse can be drawn with the routine path ellipse(pair c, real a, real b)
{
return shift(c)*scale(a,b)*unitcircle;
}
This example illustrates the use of all five guide connectors
- discussed in *note Tutorial::: size(300,0);
+ discussed in *note Tutorial:: and *note Bezier curves::: size(300,0);
pair[] z=new pair[10];
z[0]=(0,100); z[1]=(50,0); z[2]=(180,0);
@@ -1777,8 +1821,8 @@ File: asymptote.info, Node: Paths and guides, Next: Pens, Prev: Data types,
`pair point(path p, real t);'
This returns the coordinates of the point between node
`floor(t)' and `floor(t)+1' corresponding to the cubic spline
- parameter `t-floor(t)' (*note Bezier::). If `t' lies outside
- the range [0,`length(p)'], it is first reduced modulo
+ parameter `t-floor(t)' (*note Bezier curves::). If `t' lies
+ outside the range [0,`length(p)'], it is first reduced modulo
`length(p)' in the case where `p' is cyclic or else converted
to the corresponding endpoint of `p'.
@@ -1791,7 +1835,7 @@ File: asymptote.info, Node: Paths and guides, Next: Pens, Prev: Data types,
`pair dir(path p, real t, bool normalize=true);'
returns the direction of the tangent to path `p' at the point
between node `floor(t)' and `floor(t)+1' corresponding to the
- cubic spline parameter `t-floor(t)' (*note Bezier::).
+ cubic spline parameter `t-floor(t)' (*note Bezier curves::).
`pair accel(path p, int t, int sign=0);'
If `sign < 0', return the acceleration of the incoming path
@@ -1802,7 +1846,7 @@ File: asymptote.info, Node: Paths and guides, Next: Pens, Prev: Data types,
`pair accel(path p, real t);'
returns the acceleration of the path `p' at the point `t'.
- `pair radius(path p, real t);'
+ `real radius(path p, real t);'
returns the radius of curvature of the path `p' at the point
`t'.
@@ -2088,7 +2132,7 @@ File: asymptote.info, Node: Paths and guides, Next: Pens, Prev: Data types,

File: asymptote.info, Node: Pens, Next: Transforms, Prev: Paths and guides, Up: Programming
-5.3 Pens
+6.3 Pens
========
In `Asymptote', pens provide a context for the four basic drawing
@@ -2197,8 +2241,9 @@ number, until it saturates with one or more color components equal to 1.
The default line type is `solid'; this may be changed with
- `defaultpen(pen)'. The line type of a pen is returned by `int
- linetype(pen p=currentpen)'.
+ `defaultpen(pen)'. The line type of a pen can be determined with
+ the functions `string linetype(pen p=currentpen)', `real
+ offset(pen p)', `bool scale(pen p)', and `bool adjust(pen p)'.
* The pen line width is specified in `PostScript' units with `pen
linewidth(real)'. The default line width is 0.5 bp; this value may
@@ -2441,7 +2486,7 @@ default attributes to their initial values.

File: asymptote.info, Node: Transforms, Next: Frames and pictures, Prev: Pens, Up: Programming
-5.4 Transforms
+6.4 Transforms
==============
`Asymptote' makes extensive use of affine transforms. A pair `(x,y)' is
@@ -2499,7 +2544,7 @@ respectively.

File: asymptote.info, Node: Frames and pictures, Next: Files, Prev: Transforms, Up: Programming
-5.5 Frames and pictures
+6.5 Frames and pictures
=======================
`frame'
@@ -2583,7 +2628,7 @@ File: asymptote.info, Node: Frames and pictures, Next: Files, Prev: Transform
orientation orientation=orientation,
string format="", bool wait=false, bool view=true,
string options="", string script="",
- projection P=currentprojection);
+ light light=currentlight, projection P=currentprojection)
The default output format, `PostScript', may be changed with the
`-f' or `-tex' command-line options. The `options', `script', and
`projection' parameters are only relevant for 3D pictures. If
@@ -2662,16 +2707,16 @@ File: asymptote.info, Node: Frames and pictures, Next: Files, Prev: Transform
For example, to draw a bounding box around a picture with a 0.25 cm
margin and output the resulting frame, use the command: shipout(bbox(0.25cm));
- A `picture' may be fit to a frame with the background color of
- pen `p' with the function `bbox(p,Fill)'.
+ A `picture' may be fit to a frame with the background color pen
+ `p', using the function `bbox(p,Fill)'.
The functions pair min(picture pic, user=false);
pair max(picture pic, user=false);
pair size(picture pic, user=false);
- calculate the `PostScript' bounds that picture `pic' would have
- if it were currently fit to a frame using its default size
- specification. If `user' is `false' the returned value is in
- `PostScript' coordinates, otherwise it is in user coordinates.
+ calculate the bounds that picture `pic' would have if it were
+ currently fit to a frame using its default size specification. If
+ `user' is `false' the returned value is in `PostScript'
+ coordinates, otherwise it is in user coordinates.
The function pair point(picture pic=currentpicture, pair dir, bool user=true);
is a convenient way of determining the point on the bounding box
@@ -2791,7 +2836,7 @@ File: asymptote.info, Node: Frames and pictures, Next: Files, Prev: Transform

File: asymptote.info, Node: Files, Next: Variable initializers, Prev: Frames and pictures, Up: Programming
-5.6 Files
+6.6 Files
=========
`Asymptote' can read and write text files (including comma-separated
@@ -2860,19 +2905,22 @@ write(fout,1); // Writes "1"
write(fout); // Writes a new line
write(fout,"List: ",1,2,3); // Writes "List: 1 2 3"
A file may also be opened with `xinput' or `xoutput', instead of
-`input' or `output', to read or write double precision (64-bit) real
-values and single precision (32-bit) integer values in Sun
-Microsystem's XDR (External Data Representation) portable binary format
-(available on all `UNIX' platforms). A file may also be opened with
-`binput' or `boutput' to read or write double precision values in the
-native (nonportable) machine binary format. The function `file
-single(file,0.0)' may be used to set a file to read single precision
-real XDR or binary values; calling `file single(file,0.0,false)' sets
-it back to read doubles again. The functions `file single(file,0)' and
-`file single(file,0,false)' can be used to change the default integer
-precision (single). The functions `file single(file)' and `file
-single(file,false)' may be used to set the precision for both real and
-integer values.
+`input' or `output', to read or write double precision (64-bit) reals
+and single precision (32-bit) integers in Sun Microsystem's XDR
+(External Data Representation) portable binary format (available on all
+`UNIX' platforms). Alternatively, a file may also be opened with
+`binput' or `boutput' to read or write double precision reals and single
+precision integers in the native (nonportable) machine binary format.
+The virtual member functions `file singlereal(bool b=false)' and `file
+singleint(bool b=true)' be used to change the precision of real and
+integer I/O operations, respectively, for an XDR or binary file `f'.
+Similarly, the function `file signedint(bool b=true)' can be used to
+modify the signedness of integer reads and writes for an XDR or binary
+file `f'.
+
+ The virtual members `name', `mode', `singlereal', `singleint', and
+`signedint' may be used to query the respective parameters for a given
+file.
One can test a file for end-of-file with the boolean function
`eof(file)', end-of-line with `eol(file)', and for I/O errors with
@@ -2942,13 +2990,13 @@ int animate(string args="", string file="", string format="");
call the `ImageMagick' commands `convert' and `animate', respectively,
with the arguments `args' and the file name constructed from the
strings `file' and `format'. If the setting `safe' is false, then the
-function `int system(string s)' can be used to call the arbitrary system
-command `s'.
+functions `int system(string s)' and `int system(string[] s)' can be
+used to call the arbitrary system command `s'.

File: asymptote.info, Node: Variable initializers, Next: Structures, Prev: Files, Up: Programming
-5.7 Variable initializers
+6.7 Variable initializers
=========================
A variable can be assigned a value when it is declared, as in `int
@@ -3013,7 +3061,7 @@ sensible defaults for user-defined types.

File: asymptote.info, Node: Structures, Next: Operators, Prev: Variable initializers, Up: Programming
-5.8 Structures
+6.8 Structures
==============
Users may also define their own data types as structures, along with
@@ -3202,8 +3250,9 @@ and the total system cputime followed by "S".
Much like in C++, casting (*note Casts::) provides for an elegant
implementation of structure inheritance, including virtual functions:
struct parent {
- real x=1;
- void virtual(int) {write (0);}
+ real x;
+ void operator init(int x) {this.x=x;}
+ void virtual(int) {write(0);}
void f() {virtual(1);}
}
@@ -3211,24 +3260,25 @@ void write(parent p) {write(p.x);}
struct child {
parent parent;
- real y=2;
- void virtual(int x) {write (x);}
+ real y=3;
+ void operator init(int x) {parent.operator init(x);}
+ void virtual(int x) {write(x);}
parent.virtual=virtual;
void f()=parent.f;
}
parent operator cast(child child) {return child.parent;}
-parent p;
-child c;
+parent p=parent(1);
+child c=child(2);
-write(c); // Outputs 1;
+write(c); // Outputs 2;
p.f(); // Outputs 0;
c.f(); // Outputs 1;
-write(c.parent.x); // Outputs 1;
-write(c.y); // Outputs 2;
+write(c.parent.x); // Outputs 2;
+write(c.y); // Outputs 3;
For further examples of structures, see `Legend' and `picture' in
the `Asymptote' base module `plain'.
@@ -3236,7 +3286,7 @@ the `Asymptote' base module `plain'.

File: asymptote.info, Node: Operators, Next: Implicit scaling, Prev: Structures, Up: Programming
-5.9 Operators
+6.9 Operators
=============
* Menu:
@@ -3248,7 +3298,7 @@ File: asymptote.info, Node: Operators, Next: Implicit scaling, Prev: Structur

File: asymptote.info, Node: Arithmetic & logical, Next: Self & prefix operators, Up: Operators
-5.9.1 Arithmetic & logical operators
+6.9.1 Arithmetic & logical operators
------------------------------------
`Asymptote' uses the standard binary arithmetic operators. However,
@@ -3331,7 +3381,7 @@ OR(int,int)', `int XOR(int,int)', and `int NOT(int)'.

File: asymptote.info, Node: Self & prefix operators, Next: User-defined operators, Prev: Arithmetic & logical, Up: Operators
-5.9.2 Self & prefix operators
+6.9.2 Self & prefix operators
-----------------------------
As in C, each of the arithmetic operators `+', `-', `*', `/', `%', and
@@ -3356,7 +3406,7 @@ really needed, one can substitute the expressions `(++i-1)' and

File: asymptote.info, Node: User-defined operators, Prev: Self & prefix operators, Up: Operators
-5.9.3 User-defined operators
+6.9.3 User-defined operators
----------------------------
The following symbols may be used with `operator' to define or redefine
@@ -3390,7 +3440,7 @@ write("g=",g);

File: asymptote.info, Node: Implicit scaling, Next: Functions, Prev: Operators, Up: Programming
-5.10 Implicit scaling
+6.10 Implicit scaling
=====================
If a numeric literal is in front of certain types of expressions, then
@@ -3427,7 +3477,7 @@ write(10cm);

File: asymptote.info, Node: Functions, Next: Arrays, Prev: Implicit scaling, Up: Programming
-5.11 Functions
+6.11 Functions
==============
`Asymptote' functions are treated as variables with a signature
@@ -3527,7 +3577,7 @@ segmentation fault, unless a fully working version of the GNU library

File: asymptote.info, Node: Default arguments, Next: Named arguments, Up: Functions
-5.11.1 Default arguments
+6.11.1 Default arguments
------------------------
`Asymptote' supports a more flexible mechanism for default function
@@ -3546,7 +3596,7 @@ defined.

File: asymptote.info, Node: Named arguments, Next: Rest arguments, Prev: Default arguments, Up: Functions
-5.11.2 Named arguments
+6.11.2 Named arguments
----------------------
It is sometimes difficult to remember the order in which arguments
@@ -3601,7 +3651,7 @@ would be allowed.

File: asymptote.info, Node: Rest arguments, Next: Mathematical functions, Prev: Named arguments, Up: Functions
-5.11.3 Rest arguments
+6.11.3 Rest arguments
---------------------
Rest arguments allow one to write functions that take a variable number
@@ -3681,7 +3731,7 @@ i(3,4); // ambiguous; the first candidate is better for the first argument,

File: asymptote.info, Node: Mathematical functions, Prev: Rest arguments, Up: Functions
-5.11.4 Mathematical functions
+6.11.4 Mathematical functions
-----------------------------
`Asymptote' has built-in versions of the standard `libm' mathematical
@@ -3767,7 +3817,7 @@ write(Si(1.0));

File: asymptote.info, Node: Arrays, Next: Casts, Prev: Functions, Up: Programming
-5.12 Arrays
+6.12 Arrays
===========
* Menu:
@@ -3806,9 +3856,7 @@ The `copy' function listed below provides a deep copy of an array.
Every array `A' of type `T[]' has the virtual members
* `int length',
- * `void cyclic(bool b)',
-
- * `bool cyclicflag',
+ * `int cyclic',
* `int[] keys',
@@ -3827,10 +3875,9 @@ The `copy' function listed below provides a deep copy of an array.
* `bool initialized(int n)'.
The member `A.length' evaluates to the length of the array. Setting
-`A.cyclic(true)' signifies that array indices should be reduced modulo
+`A.cyclic=true' signifies that array indices should be reduced modulo
the current array length. Reading from or writing to a nonempty cyclic
-array never leads to out-of-bounds errors or array resizing. The member
-`A.cyclicflag' returns the current setting of the `cyclic' flag.
+array never leads to out-of-bounds errors or array resizing.
The member `A.keys' evaluates to an array of integers containing the
indices of initialized entries in the array in ascending order. Hence,
@@ -3847,9 +3894,9 @@ range [`i',`j'], shifting the position of all higher-indexed elements
down. If no arguments are given, `A.delete()' provides a convenient way
of deleting all elements of `A'. The routine `A.initialized(int n)' can
be used to examine whether the element at index `n' is initialized.
-Like all `Asymptote' functions, `cyclic', `push', `append', `pop',
-`insert', `delete', and `initialized' can be "pulled off" of the array
-and used on their own. For example,
+Like all `Asymptote' functions, `push', `append', `pop', `insert',
+`delete', and `initialized' can be "pulled off" of the array and used
+on their own. For example,
int[] A={1};
A.push(2); // A now contains {1,2}.
A.append(A); // A now contains {1,2,1,2}.
@@ -4111,28 +4158,29 @@ file fin=input("test.txt");
real[] A=fin;
reads real values into `A' until the end-of-file is reached (or an I/O
-error occurs). If line mode is set with `line(file)', then reading will
-stop once the end of the line is reached instead (line mode may be
-cleared with `line(file,false)'):
+error occurs).
+
+ The virtual members `dimension', `line', `csv', `word', and `read'
+of a file are useful for reading arrays. For example, if line mode is
+set with `file line(bool b=true)', then reading will stop once the end
+of the line is reached instead
file fin=input("test.txt");
-real[] A=line(fin);
+real[] A=fin.line();
Since string reads by default read up to the end of line anyway,
line mode normally has no effect on string array reads. However, there
-is a white-space delimiter mode for reading strings, set with
-`word(file)' and cleared with `word(file,false)', which causes string
-reads to respect white-space delimiters, instead of the default
-end-of-line delimiter:
-file fin=word(line(input("test.txt")));
+is a white-space delimiter mode for reading strings, `file word(bool
+b=true)', which causes string reads to respect white-space delimiters,
+instead of the default end-of-line delimiter:
+file fin=input("test.txt").line().word();
real[] A=fin;
- Another useful mode is comma-separated-value mode, set with
-`csv(file)' and cleared with `csv(file,false)', which causes reads to
-respect comma delimiters:
+ Another useful mode is comma-separated-value mode, `file csv(bool
+b=true)', which causes reads to respect comma delimiters:
file fin=csv(input("test.txt"));
real[] A=fin;
- To restrict the number of values read, use the `dimension(file,int)'
+ To restrict the number of values read, use the `file dimension(int)'
function:
file fin=input("test.txt");
real[] A=dimension(fin,10);
@@ -4146,17 +4194,18 @@ end-of-file (or end-of-line in line mode) is encountered.
Two- and three-dimensional arrays of the basic data types can be read
in like this:
file fin=input("test.txt");
-real[][] A=dimension(fin,2,3);
-real[][][] B=dimension(fin,2,3,4);
+real[][] A=fin.dimension(2,3);
+real[][][] B=fin.dimension(2,3,4);
Again, an integer limit of zero means no restriction.
Sometimes the array dimensions are stored with the data as integer
-fields at the beginning of an array. Such arrays can be read in with the
-functions `read1', `read2', and `read3', respectively:
+fields at the beginning of an array. Such 1, 2, or 3 dimensional arrays
+can be read in with the virtual member functions `read(1)', `read(2)',
+or `read(3)', respectively:
file fin=input("test.txt");
-real[] A=read1(fin);
-real[][] B=read2(fin);
-real[][][] C=read3(fin);
+real[] A=fin.read(1);
+real[][] B=fin.read(2);
+real[][][] C=fin.read(3);
One, two, and three-dimensional arrays of the basic data types can be
output with the functions `write(file,T[])', `write(file,T[][])',
@@ -4165,7 +4214,7 @@ output with the functions `write(file,T[])', `write(file,T[][])',

File: asymptote.info, Node: Slices, Up: Arrays
-5.12.1 Slices
+6.12.1 Slices
-------------
Asymptote allows a section of an array to be addressed as a slice using
@@ -4197,7 +4246,7 @@ beyond the length of the array are allowed. The indices simply wrap
around. For example:
int[] x={0,1,2,3,4,5,6,7,8,9};
-x.cyclic(true);
+x.cyclic=true;
int[] y=x[8:15]; // y={8,9,0,1,2,3,4}.
int[] z=x[-5:5]; // z={5,6,7,8,9,0,1,2,3,4}
int[] w=x[-3:17]; // w={7,8,9,0,1,2,3,4,5,6,7,8,9,0,1,2,3,4,5,6}
@@ -4253,7 +4302,7 @@ any of the cells.

File: asymptote.info, Node: Casts, Next: Import, Prev: Arrays, Up: Programming
-5.13 Casts
+6.13 Casts
==========
`Asymptote' implicitly casts `int' to `real', `int' to `pair', `real'
@@ -4313,7 +4362,7 @@ real operator cast(int x)=convert;

File: asymptote.info, Node: Import, Next: Static, Prev: Casts, Up: Programming
-5.14 Import
+6.14 Import
===========
While `Asymptote' provides many features by default, some applications
@@ -4455,7 +4504,7 @@ is `true'.

File: asymptote.info, Node: Static, Prev: Import, Up: Programming
-5.15 Static
+6.15 Static
===========
Static qualifiers allocate the memory address of a variable in a higher
@@ -4568,7 +4617,7 @@ the variable actually possesses.

File: asymptote.info, Node: LaTeX usage, Next: Base modules, Prev: Programming, Up: Top
-6 `LaTeX' usage
+7 `LaTeX' usage
***************
`Asymptote' comes with a convenient `LaTeX' style file `asymptote.sty'
@@ -4599,7 +4648,7 @@ remove the files `latexusage-*', `latexusage_.pre', and
One can specify `width', `height', `viewportwidth',
`viewportheight', and `attach' `keyval'-style options to the `asy'
-environment. The current version (1.07) of `asymptote.sty' supports the
+environment. The current version (1.10) of `asymptote.sty' supports the
embedding of 3D PRC files, either inline or, using the `attach' option
with the `attachfile2' (or older `attachfile') `LaTeX' package, as
annotated (but printable) attachments. For many applications, the
@@ -4711,7 +4760,7 @@ the \verb+{attach=true}+ option:
import three;
currentprojection=orthographic(5,4,2);
draw(unitcube,blue);
-label("$V-E+F=2$",(0,1,0.5),3Y,blue+fontsize(17));
+label("$V-E+F=2$",(0,1,0.5),3Y,blue+fontsize(17pt));
\end{asy}
\end{center}
@@ -4728,7 +4777,7 @@ dot(z1,red+0.15cm);
dot(z2,darkgreen+0.3cm);
label("$m$",z1,1.2N,red);
label("$M$",z2,1.5N,darkgreen);
-label("$\hat{\ }$",zf,0.2*S,fontsize(24)+blue);
+label("$\hat{\ }$",zf,0.2*S,fontsize(24pt)+blue);
pair s=-0.2*I;
draw("$x$",z0+s--z1+s,N,red,Arrows,Bars,PenMargins);
@@ -4743,7 +4792,7 @@ draw("$X$",z0+s--z2+s,darkgreen,Arrows,Bars,PenMargins);

File: asymptote.info, Node: Base modules, Next: Options, Prev: LaTeX usage, Up: Top
-7 Base modules
+8 Base modules
**************
`Asymptote' currently ships with the following base modules:
@@ -4793,7 +4842,7 @@ File: asymptote.info, Node: Base modules, Next: Options, Prev: LaTeX usage,

File: asymptote.info, Node: plain, Next: simplex, Up: Base modules
-7.1 `plain'
+8.1 `plain'
===========
This is the default `Asymptote' base file, which defines key parts of
@@ -4810,7 +4859,7 @@ this feature.

File: asymptote.info, Node: simplex, Next: math, Prev: plain, Up: Base modules
-7.2 `simplex'
+8.2 `simplex'
=============
This package solves the two-variable linear programming problem using
@@ -4820,11 +4869,11 @@ sizing of pictures.

File: asymptote.info, Node: math, Next: interpolate, Prev: simplex, Up: Base modules
-7.3 `math'
+8.3 `math'
==========
This package extends `Asymptote''s mathematical capabilities with
-intersection algorithms and matrix arithmetic:
+matrix arithmetic and intersection algorithms:
`void drawline(picture pic=currentpicture, pair P, pair Q, pen p=currentpen);'
draw the visible portion of the (infinite) line going through `P'
@@ -4847,7 +4896,7 @@ intersection algorithms and matrix arithmetic:

File: asymptote.info, Node: interpolate, Next: geometry, Prev: math, Up: Base modules
-7.4 `interpolate'
+8.4 `interpolate'
=================
This module implements Lagrange, Hermite, and standard cubic spline
@@ -4857,7 +4906,7 @@ interpolation in `Asymptote', as illustrated in the example

File: asymptote.info, Node: geometry, Next: trembling, Prev: interpolate, Up: Base modules
-7.5 `geometry'
+8.5 `geometry'
==============
This module, written by Philippe Ivaldi, provides an extensive set of
@@ -4865,26 +4914,25 @@ geometry routines, including `perpendicular' symbols and a `triangle'
structure. Link to the documentation for the `geometry' module are
posted here: `http://asymptote.sourceforge.net/links.html', including
an extensive set of examples,
-`http://piprim.tuxfamily.org/asymptote/geometry/index.html', and an
-index:
+`http://www.piprime.fr/files/asymptote/geometry/', and an index:
- `http://piprim.tuxfamily.org/asymptote/geometry/modules/geometry.asy.index.type.html'
+ `http://www.piprime.fr/files/asymptote/geometry/modules/geometry.asy.index.type.html'

File: asymptote.info, Node: trembling, Next: stats, Prev: geometry, Up: Base modules
-7.6 `trembling'
+8.6 `trembling'
===============
This module, written by Philippe Ivaldi and illustrated in the example
`floatingdisk.asy', allows one to draw wavy lines, as if drawn by hand.
Further examples are posted at
-`http://piprim.tuxfamily.org/asymptote/trembling/index.html'
+`http://www.piprime.fr/files/asymptote/trembling/'

File: asymptote.info, Node: stats, Next: patterns, Prev: trembling, Up: Base modules
-7.7 `stats'
+8.7 `stats'
===========
This package implements a Gaussian random number generator and a
@@ -4894,7 +4942,7 @@ collection of statistics routines, including `histogram' and

File: asymptote.info, Node: patterns, Next: markers, Prev: stats, Up: Base modules
-7.8 `patterns'
+8.8 `patterns'
==============
This package implements `Postscript' tiling patterns and includes
@@ -4903,7 +4951,7 @@ several convenient pattern generation routines.

File: asymptote.info, Node: markers, Next: tree, Prev: patterns, Up: Base modules
-7.9 `markers'
+8.9 `markers'
=============
This package implements specialized routines for marking paths and
@@ -4952,7 +5000,7 @@ void markangle(picture pic=currentpicture, Label L="",

File: asymptote.info, Node: tree, Next: binarytree, Prev: markers, Up: Base modules
-7.10 `tree'
+8.10 `tree'
===========
This package implements an example of a dynamic binary search tree.
@@ -4960,7 +5008,7 @@ This package implements an example of a dynamic binary search tree.

File: asymptote.info, Node: binarytree, Next: drawtree, Prev: tree, Up: Base modules
-7.11 `binarytree'
+8.11 `binarytree'
=================
This module can be used to draw an arbitrary binary tree and includes an
@@ -4985,7 +5033,7 @@ add(pic2.fit(),(0,0),10S);

File: asymptote.info, Node: drawtree, Next: syzygy, Prev: binarytree, Up: Base modules
-7.12 `drawtree'
+8.12 `drawtree'
===============
This is a simple tree drawing module used by the example `treetest.asy'.
@@ -4993,7 +5041,7 @@ This is a simple tree drawing module used by the example `treetest.asy'.

File: asymptote.info, Node: syzygy, Next: feynman, Prev: drawtree, Up: Base modules
-7.13 `syzygy'
+8.13 `syzygy'
=============
This module automates the drawing of braids, relations, and syzygies,
@@ -5003,7 +5051,7 @@ along with the corresponding equations, as illustrated in the example

File: asymptote.info, Node: feynman, Next: roundedpath, Prev: syzygy, Up: Base modules
-7.14 `feynman'
+8.14 `feynman'
==============
This package, contributed by Martin Wiebusch, is useful for drawing
@@ -5013,7 +5061,7 @@ Feynman diagrams, as illustrated by the examples `eetomumu.asy' and

File: asymptote.info, Node: roundedpath, Next: animation, Prev: feynman, Up: Base modules
-7.15 `roundedpath'
+8.15 `roundedpath'
==================
This package, contributed by Stefan Knorr, is useful for rounding the
@@ -5023,14 +5071,14 @@ sharp corners of paths, as illustrated in the example file

File: asymptote.info, Node: animation, Next: embed, Prev: roundedpath, Up: Base modules
-7.16 `animation'
+8.16 `animation'
================
This module allows one to generate animations, as illustrated by the
files `wheel.asy', `wavelet.asy', and `cube.asy' in the `animations'
subdirectory of the examples directory. These animations use the
-`ImageMagick' `convert' program to `merge' multiple images into a GIF
-or MPEG movie.
+`ImageMagick' `convert' program to merge multiple images into a GIF or
+MPEG movie.
The related `animate' module, derived from the `animation' module,
generates higher-quality portable clickable PDF movies, with optional
@@ -5057,7 +5105,7 @@ as described here:

File: asymptote.info, Node: embed, Next: slide, Prev: animation, Up: Base modules
-7.17 `embed'
+8.17 `embed'
============
This module provides an interface to the `LaTeX' package (included with
@@ -5100,7 +5148,7 @@ animation (*note animate::).

File: asymptote.info, Node: slide, Next: MetaPost, Prev: embed, Up: Base modules
-7.18 `slide'
+8.18 `slide'
============
This package provides a simple yet high-quality facility for making
@@ -5111,7 +5159,7 @@ the file `slidemovies.asy'). A simple example is provided in the file

File: asymptote.info, Node: MetaPost, Next: unicode, Prev: slide, Up: Base modules
-7.19 `MetaPost'
+8.19 `MetaPost'
===============
This package provides some useful routines to help `MetaPost' users
@@ -5129,7 +5177,7 @@ equation solver `solve' instead.

File: asymptote.info, Node: unicode, Next: latin1, Prev: MetaPost, Up: Base modules
-7.20 `unicode'
+8.20 `unicode'
==============
Import this package at the beginning of the file to instruct `LaTeX' to
@@ -5152,7 +5200,7 @@ texpreamble("\usepackage{CJK}

File: asymptote.info, Node: latin1, Next: babel, Prev: unicode, Up: Base modules
-7.21 `latin1'
+8.21 `latin1'
=============
If you don't have `LaTeX' support for `unicode' installed, you can
@@ -5163,7 +5211,7 @@ providing support for other ISO 8859 alphabets.

File: asymptote.info, Node: babel, Next: labelpath, Prev: latin1, Up: Base modules
-7.22 `babel'
+8.22 `babel'
============
This module implements the `LaTeX' `babel' package in `Asymptote'. For
@@ -5174,7 +5222,7 @@ babel("german");

File: asymptote.info, Node: labelpath, Next: labelpath3, Prev: babel, Up: Base modules
-7.23 `labelpath'
+8.23 `labelpath'
================
This module uses the `PSTricks' `pstextpath' macro to fit labels along
@@ -5193,7 +5241,7 @@ macro.

File: asymptote.info, Node: labelpath3, Next: annotate, Prev: labelpath, Up: Base modules
-7.24 `labelpath3'
+8.24 `labelpath3'
=================
This module, contributed by Jens Schwaiger, implements a 3D version of
@@ -5203,7 +5251,7 @@ is provided in `curvedlabel3.asy'.

File: asymptote.info, Node: annotate, Next: CAD, Prev: labelpath3, Up: Base modules
-7.25 `annotate'
+8.25 `annotate'
===============
This module supports PDF annotations for viewing with `Adobe Reader',
@@ -5217,7 +5265,7 @@ and `tex' TeX engines.

File: asymptote.info, Node: CAD, Next: graph, Prev: annotate, Up: Base modules
-7.26 `CAD'
+8.26 `CAD'
==========
This package, contributed by Mark Henning, provides basic pen
@@ -5227,7 +5275,7 @@ according to DIN 15. It is documented separately, in the file `CAD.pdf'.

File: asymptote.info, Node: graph, Next: palette, Prev: CAD, Up: Base modules
-7.27 `graph'
+8.27 `graph'
============
This package implements two-dimensional linear and logarithmic graphs,
@@ -5253,7 +5301,7 @@ following routines:
* `default', the point is added to a new guide;
* `false', the point is omitted and a new guide is begun.
- Th points are connected using the interpolation specified by
+ The points are connected using the interpolation specified by
`join':
* `operator --' (linear interpolation; the abbreviation
`Straight' is also accepted);
@@ -5339,9 +5387,9 @@ following routines:
corresponding axis limit will be automatically determined from the
picture limits. The optional `arrow' argument takes the same
values as in the `draw' command (*note arrows::). The axis is
- drawn before any existing objects in the current picture unless
- `above=true'. The axis placement is determined by one of the
- following `axis' types:
+ drawn before any existing objects in `pic' unless `above=true'.
+ The axis placement is determined by one of the following `axis'
+ types:
`YZero(bool extend=true)'
Request an x axis at y=0 (or y=1 on a logarithmic axis)
@@ -5485,9 +5533,9 @@ following routines:
corresponding axis limit will be automatically determined from the
picture limits. The optional `arrow' argument takes the same
values as in the `draw' command (*note arrows::). The axis is
- drawn before any existing objects in the current picture unless
- `above=true'. The tick type is specified by `ticks' and the axis
- placement is determined by one of the following `axis' types:
+ drawn before any existing objects in `pic' unless `above=true'.
+ The tick type is specified by `ticks' and the axis placement is
+ determined by one of the following `axis' types:
`XZero(bool extend=true)'
Request a y axis at x=0 (or x=1 on a logarithmic axis)
@@ -5527,7 +5575,7 @@ following routines:
This convenience routine draws both x and y axes on picture `pic'
from `min' to `max', with optional labels `xlabel' and `ylabel'
and any arrows specified by `arrow'. The axes are drawn on top of
- existing objects in the current picture only if `above=true'.
+ existing objects in `pic' only if `above=true'.
* void axis(picture pic=currentpicture, Label L="", path g,
pen p=currentpen, ticks ticks, ticklocate locate,
@@ -5542,8 +5590,8 @@ following routines:
uncrowded tick labels. A `true' value for the flag `opposite'
identifies an unlabelled secondary axis (typically drawn opposite
a primary axis). The axis is drawn before any existing objects in
- the current picture unless `above=true'. The tick locator
- `ticklocate' is constructed by the routine ticklocate ticklocate(real a, real b, autoscaleT S=defaultS,
+ `pic' unless `above=true'. The tick locator `ticklocate' is
+ constructed by the routine ticklocate ticklocate(real a, real b, autoscaleT S=defaultS,
real tickmin=-infinity, real tickmax=infinity,
real time(real)=null, pair dir(real)=zero);
where `a' and `b' specify the respective tick values at
@@ -5676,7 +5724,7 @@ following routines:
xaxis("$x$",BottomTop,LeftTicks);
yaxis("$y$",LeftRight,
- RightTicks(Label(fontsize(8)),new real[]{0,4,9}));
+ RightTicks(Label(fontsize(8pt)),new real[]{0,4,9}));
@@ -5684,8 +5732,8 @@ following routines:
size(200,150,IgnoreAspect);
- file in=line(input("filegraph.dat"));
- real[][] a=dimension(in,0,0);
+ file in=input("filegraph.dat").line();
+ real[][] a=in.dimension(0,0);
a=transpose(a);
real[] x=a[0];
@@ -5938,8 +5986,8 @@ following routines:
draw(graph(f,0.1,10));
- //xlimits(1,10);
- //ylimits(0.1,1);
+ //xlimits(1,10,Crop);
+ //ylimits(0.1,1,Crop);
dot(Label("(3,5)",align=S),Scale((3,5)));
@@ -6065,12 +6113,12 @@ following routines:
size(9cm,6cm,IgnoreAspect);
string data="secondaryaxis.csv";
- file in=line(csv(input(data)));
+ file in=input(data).line().csv();
string[] titlelabel=in;
string[] columnlabel=in;
- real[][] a=dimension(in,0,0);
+ real[][] a=in.dimension(0,0);
a=transpose(a);
real[] t=a[0], susceptible=a[1], infectious=a[2], dead=a[3], larvae=a[4];
real[] susceptibleM=a[5], exposed=a[6],infectiousM=a[7];
@@ -6121,9 +6169,9 @@ following routines:
import graph;
import stats;
- file fin=line(input("leastsquares.dat"));
+ file fin=input("leastsquares.dat").line();
- real[][] a=dimension(fin,0,0);
+ real[][] a=fin.dimension(0,0);
a=transpose(a);
real[] t=a[0], rho=a[1];
@@ -6251,7 +6299,7 @@ following routines:

File: asymptote.info, Node: palette, Next: three, Prev: graph, Up: Base modules
-7.28 `palette'
+8.28 `palette'
==============
`Asymptote' can also generate color density images and palettes. The
@@ -6423,7 +6471,7 @@ pen[][] palette(real[][] f, pen[] palette);

File: asymptote.info, Node: three, Next: obj, Prev: palette, Up: Base modules
-7.29 `three'
+8.29 `three'
============
This module fully extends the notion of guides and paths in `Asymptote'
@@ -6473,16 +6521,17 @@ containing an array of Bezier patches. Surfaces may drawn with one of
the routines
void draw(picture pic=currentpicture, surface s, int nu=1, int nv=1,
material surfacepen=currentpen, pen meshpen=nullpen,
- light light=currentlight, light meshlight=light);
+ light light=currentlight, light meshlight=light, string name="");
void draw(picture pic=currentpicture, surface s, int nu=1, int nv=1,
material[] surfacepen, pen meshpen,
- light light=currentlight, light meshlight=light);
+ light light=currentlight, light meshlight=light, string name="");
void draw(picture pic=currentpicture, surface s, int nu=1, int nv=1,
material[] surfacepen, pen[] meshpen=nullpens,
- light light=currentlight, light meshlight=light);
+ light light=currentlight, light meshlight=light, string name="");
The parameters `nu' and `nv' specify the number of subdivisions for
-drawing optional mesh lines for each Bezier patch. Here material is a
-structure defined in `three_light.asy':
+drawing optional mesh lines for each Bezier patch. The optional `name'
+parameter is used as a prefix for naming the surface patches in the PRC
+model tree. Here material is a structure defined in `three_light.asy':
struct material {
pen[] p; // diffusepen,ambientpen,emissivepen,specularpen
real opacity;
@@ -6526,13 +6575,15 @@ length `4' or less.
Arbitrary thick three-dimensional curves and line caps (which the
`OpenGL' standard does not require implementations to provide) are
-constructed with the routine
-surface tube(path3 g, real width);
- which returns a tube of diameter `width' centered on `g'. This can
-make files slow to render, especially with the `Adobe Reader' renderer.
-The setting `thick=false' can be used to disable this feature and force
-all lines to be drawn with `linewidth(0)' (one pixel wide, regardless
-of the resolution). By default mesh and contour lines in
+constructed with
+tube tube(path3 p, real width, real granularity=tubegranularity);
+ this returns a tube structure representing a tube of diameter `width'
+centered approximately on `g'. The tube structure consists of a surface
+`s' and the actual tube center, path3 `center'. Drawing thick lines as
+tubes can be slow to render, especially with the `Adobe Reader'
+renderer. The setting `thick=false' can be used to disable this feature
+and force all lines to be drawn with `linewidth(0)' (one pixel wide,
+regardless of the resolution). By default, mesh and contour lines in
three-dimensions are always drawn thin, unless an explicit line width
is given in the pen parameter or the setting `thin' is set to `false'.
The pens `thin()' and `thick()' defined in plain_pens.asy can also be
@@ -6549,26 +6600,38 @@ There are four choices for viewing 3D `Asymptote' output:
sample width can be controlled with the setting `multisample'. An
initial screen position can be specified with the pair setting
`position', where negative values are interpreted as relative to
- the corresponding maximum screen dimension. The mouse bindings are:
+ the corresponding maximum screen dimension. The default settings import settings;
+ leftbutton=new string[] {"rotate","zoom","shift","pan"};
+ middlebutton=new string[] {"menu"};
+ rightbutton=new string[] {"zoom/menu","rotateX","rotateY","rotateZ"};
+ wheelup=new string[] {"zoomin"};
+ wheeldown=new string[] {"zoomout"};
+ bind the mouse buttons as follows:
* Left: rotate
- * shift Left: zoom
+ * Shift Left: zoom
+
+ * Ctrl Left: shift viewport
- * ctrl Left: shift
+ * Alt Left: pan
- * Middle: menu
+ * Middle: menu (must be unmodified; ignores Shift, Ctrl, and
+ Alt)
- * Wheel: zoom
+ * Wheel Up: zoom in
- * Right: zoom
+ * Wheel Down: zoom out
+
+ * Right: zoom/menu (must be unmodified)
* Right double click: menu
- * shift Right: rotate about the X axis
+ * Shift Right: rotate about the X axis
+
+ * Ctrl Right: rotate about the Y axis
- * ctrl Right: rotate about the Y axis
+ * Alt Right: rotate about the Z axis
- * alt Right: rotate about the Z axis
The keyboard shortcuts are:
* h: home
@@ -6588,14 +6651,24 @@ There are four choices for viewing 3D `Asymptote' output:
* c: show camera parameters
+ * p: play animation
+
+ * r: reverse animation
+
+ * : step animation
+
* +: expand
* =: expand
+ * >: expand
+
* -: shrink
* _: shrink
+ * <: shrink
+
* q: exit
* Ctrl-q: exit
@@ -6614,8 +6687,9 @@ There are four choices for viewing 3D `Asymptote' output:
restricts the maximum width and height of the viewport. On `UNIX'
systems some graphics drivers support batch mode (`-noV')
rendering in an iconified window; this can be enabled with the
- setting `iconify=true'. Other `UNIX' graphics drivers may require
- the command line setting `-glOptions=-indirect'.
+ setting `iconify=true'. Some (broken) `UNIX' graphics drivers may
+ require the command line setting `-glOptions=-indirect', which
+ requests (slower) indirect rendering.
3. Embed the 3D PRC format in a PDF file and view the resulting PDF
file with version `8.0' or later of `Adobe Reader'. In addition
@@ -6700,7 +6774,7 @@ surfaces `unitdisk', `unitplane', `unitcube', `unitcylinder',
These projections to two dimensions are predefined:
`oblique'
-`oblique(real angle);'
+`oblique(real angle)'
The point `(x,y,z)' is projected to `(x-0.5z,y-0.5z)'. If an
optional real argument is given, the negative z axis is drawn at
this angle in degrees. The projection `obliqueZ' is a synonym for
@@ -6721,7 +6795,8 @@ These projections to two dimensions are predefined:
this angle in degrees.
`orthographic(triple camera, triple up=Z, triple target=O,
- bool showtarget=true, bool center=false)'
+ real zoom=1, pair viewportshift=0, bool showtarget=true,
+ bool center=false)'
This projects from three to two dimensions using the view as seen
at a point infinitely far away in the direction `unit(camera)',
orienting the camera so that, if possible, the vector `up' points
@@ -6731,11 +6806,12 @@ These projections to two dimensions are predefined:
to the center of the bounding volume.
`orthographic(real x, real y, real z, triple up=Z, triple target=O,
- bool showtarget=true, bool center=false)'
- This is equivalent to
- `orthographic((x,y,z),up,target,showtarget,center)'.
+ real zoom=1, pair viewportshift=0, bool showtarget=true,
+ bool center=false)'
+ This is equivalent to orthographic((x,y,z),up,target,zoom,viewportshift,showtarget,center)
`perspective(triple camera, triple up=Z, triple target=O,
+ real zoom=1, real angle=0, pair viewportshift=0,
bool showtarget=true, bool autoadjust=true,
bool center=autoadjust)'
This projects from three to two dimensions, taking account of
@@ -6752,10 +6828,11 @@ These projections to two dimensions are predefined:
bounding volume.
`perspective(real x, real y, real z, triple up=Z, triple target=O,
+ real zoom=1, real angle=0, pair viewportshift=0,
bool showtarget=true, bool autoadjust=true,
bool center=autoadjust)'
- This is equivalent to `perspective((x,y,z),up,target,showtarget,
- autoadjust,center)'.
+ This is equivalent to perspective((x,y,z),up,target,zoom,angle,viewportshift,showtarget,
+ autoadjust,center)
The default projection, `currentprojection', is initially set to
`perspective(5,4,2)'.
@@ -6973,7 +7050,7 @@ add(faces);

File: asymptote.info, Node: obj, Next: graph3, Prev: three, Up: Base modules
-7.30 `obj'
+8.30 `obj'
==========
This module allows one to construct surfaces from simple obj files, as
@@ -6982,7 +7059,7 @@ illustrated in the example files `galleon.asy' and `triceratops.asy'.

File: asymptote.info, Node: graph3, Next: grid3, Prev: obj, Up: Base modules
-7.31 `graph3'
+8.31 `graph3'
=============
This module implements three-dimensional versions of the functions in
@@ -7038,9 +7115,9 @@ draw(p,Arrow3);
scale(true);
-xaxis3(XZ()*"$x$",Bounds(),red,InTicks(Label,2,2));
-yaxis3(YZ()*"$y$",Bounds(),red,InTicks(beginlabel=false,Label,2,2));
-zaxis3(XZ()*"$z$",Bounds(),red,InTicks);
+xaxis3(XZ()*"$x$",Bounds,red,InTicks(Label,2,2));
+yaxis3(YZ()*"$y$",Bounds,red,InTicks(beginlabel=false,Label,2,2));
+zaxis3(XZ()*"$z$",Bounds,red,InTicks);
@@ -7093,6 +7170,9 @@ surface surface(real f(pair z), pair a, pair b, int nx=nmesh, int ny=nx,
surface surface(real f(pair z), pair a, pair b, int nx=nmesh, int ny=nx,
splinetype xsplinetype, splinetype ysplinetype=xsplinetype,
bool cond(pair z)=null);
+surface surface(triple f(pair z), real[] u, real[] v,
+ splinetype[] usplinetype, splinetype[] vsplinetype=Spline,
+ bool cond(pair z)=null);
surface surface(triple f(pair z), pair a, pair b, int nu=nmesh, int nv=nu,
bool cond(pair z)=null);
surface surface(triple f(pair z), pair a, pair b, int nu=nmesh, int nv=nu,
@@ -7147,12 +7227,12 @@ picture vectorfield(path3 vector(pair v), triple f(pair z), pair a, pair b,

File: asymptote.info, Node: grid3, Next: solids, Prev: graph3, Up: Base modules
-7.32 `grid3'
+8.32 `grid3'
============
This module, contributed by Philippe Ivaldi, can be used for drawing 3D
grids. Here is an example (further examples can be found in `grid3.asy'
-and at `http://piprim.tuxfamily.org/asymptote/grid3/'):
+and at `http://www.piprime.fr/files/asymptote/grid3/'):
import grid3;
@@ -7176,7 +7256,7 @@ zaxis3(Label("$z$",position=EndPoint,align=(-1,0.5)),Bounds(Min,Min),

File: asymptote.info, Node: solids, Next: tube, Prev: grid3, Up: Base modules
-7.33 `solids'
+8.33 `solids'
=============
This solid geometry package defines a structure `revolution' that can
@@ -7212,12 +7292,12 @@ struct skeleton {

File: asymptote.info, Node: tube, Next: flowchart, Prev: solids, Up: Base modules
-7.34 `tube'
+8.34 `tube'
===========
-This package extends the routine `tube' defined in `three_arrows.asy'
-to arbitrary cross sections, colors, and spine transformations. The
-routine
+This package extends the `tube' surfaces constructed in
+`three_arrows.asy' to arbitrary cross sections, colors, and spine
+transformations. The routine
surface tube(path3 g, coloredpath section,
transform T(real)=new transform(real t) {return identity();},
real corner=1, real relstep=0);
@@ -7258,12 +7338,12 @@ default shading behavior for a surface.
An example of `tube' is provided in the file `trefoilknot.asy'.
Further examples can be found at
-`http://piprim.tuxfamily.org/asymptote/tube/'.
+`http://www.piprime.fr/files/asymptote/tube/'.

File: asymptote.info, Node: flowchart, Next: contour, Prev: tube, Up: Base modules
-7.35 `flowchart'
+8.35 `flowchart'
================
This package provides routines for drawing flowcharts. The primary
@@ -7378,7 +7458,7 @@ add(new void(picture pic, transform t) {

File: asymptote.info, Node: contour, Next: contour3, Prev: flowchart, Up: Base modules
-7.36 `contour'
+8.36 `contour'
==============
This package draws contour lines. To construct contours corresponding
@@ -7441,7 +7521,7 @@ real[] c=new real[n];
for(int i=0; i < n; ++i) c[i]=(i-n/2)/n;
pen[] p=sequence(new pen(int i) {
- return (c[i] >= 0 ? solid : dashed)+fontsize(6);
+ return (c[i] >= 0 ? solid : dashed)+fontsize(6pt);
},c.length);
Label[] Labels=sequence(new Label(int i) {
@@ -7561,7 +7641,7 @@ Shewchuk.

File: asymptote.info, Node: contour3, Next: slopefield, Prev: contour, Up: Base modules
-7.37 `contour3'
+8.37 `contour3'
===============
This package draws surfaces described as the null space of real-valued
@@ -7571,7 +7651,7 @@ in the example file `magnetic.asy'.

File: asymptote.info, Node: slopefield, Next: ode, Prev: contour3, Up: Base modules
-7.38 `slopefield'
+8.38 `slopefield'
=================
To draw a slope field for the differential equation dy/dx=f(x,y) (or
@@ -7611,7 +7691,7 @@ draw(curve((0,0),func,(-3,-3),(3,3)),red);

File: asymptote.info, Node: ode, Prev: slopefield, Up: Base modules
-7.39 `ode'
+8.39 `ode'
==========
The `ode' module, illustrated in the example `odetest.asy', implements
@@ -7621,8 +7701,8 @@ differential equations.

File: asymptote.info, Node: Options, Next: Interactive mode, Prev: Base modules, Up: Top
-8 Options
-*********
+9 Command-line options
+**********************
Type `asy -h' to see the full list of command-line options supported by
`Asymptote':
@@ -7632,11 +7712,14 @@ Usage: ../asy [options] [file ...]
Options (negate by replacing - with -no):
-V,-View View output; command-line only
--a,-align C|B|T|Z Center, Bottom, Top, or Zero page alignment [Center]
+-a,-align C|B|T|Z Center, Bottom, Top, or Zero page alignment [C]
-antialias n Antialiasing width for rasterized output [2]
+-arcballradius pixels Arcball radius [750]
-auto3D Automatically activate 3D scene [true]
+-autobillboard 3D labels always face viewer by default [true]
-autoimport string Module to automatically import
-autoplain Enable automatic importing of plain [true]
+-autoplay Autoplay 3D animations [false]
-autorotate Enable automatic PDF page rotation [false]
-batchMask Mask fpu exceptions in batch mode [false]
-batchView View output in batch mode [false]
@@ -7647,13 +7730,16 @@ Options (negate by replacing - with -no):
-compact Conserve memory at the expense of speed [false]
-d,-debug Enable debugging messages [false]
-divisor n Garbage collect using purge(divisor=n) [2]
+-doubleclick ms Emulated double-click timeout [200]
-embed Embed rendered preview image [true]
-exitonEOF Exit interactive mode on EOF [true]
-fitscreen Fit rendered image to screen [true]
+-framerate frames/sec Animation speed [30]
-globalwrite Allow write to other directory [false]
-gray Convert all colors to grayscale [false]
-h,-help Show summary of options; command-line only
-historylines n Retain n lines of history [1000]
+-hyperrefOptions str LaTeX hyperref package options [setpagesize=false,unicode]
-iconify Iconify rendering window [false]
-inlineimage Generate inline embedded image [false]
-inlinetex Generate inline TeX code [false]
@@ -7665,6 +7751,7 @@ Options (negate by replacing - with -no):
-level n Postscript level [3]
-l,-listvariables List available global functions and variables [false]
-localhistory Use a local interactive history file [false]
+-loop Loop 3D animations [false]
-m,-mask Mask fpu exceptions; command-line only
-maxtile pair Maximum rendering tile size [(0,0)]
-maxviewport pair Maximum viewport size [(2048,2048)]
@@ -7683,9 +7770,12 @@ Options (negate by replacing - with -no):
-prompt2 string Continuation prompt for multiline input [..]
-q,-quiet Suppress welcome message [false]
-render n Render 3D graphics using n pixels per bp (-1=auto) [-1]
+-resizestep step Resize step [1.2]
+-reverse reverse 3D animations [false]
-rgb Convert cmyk colors to rgb [false]
-safe Disable system call [true]
-scroll n Scroll standard output n lines at a time [0]
+-spinstep deg/sec Spin speed [60]
-tabcompletion Interactive prompt auto-completion [true]
-tex engine latex|pdflatex|xelatex|tex|pdftex|context|none [latex]
-thick Render thick 3D lines [true]
@@ -7699,8 +7789,10 @@ Options (negate by replacing - with -no):
-v,-verbose Increase verbosity level (can specify multiple times) [0]
-version Show version; command-line only
-wait Wait for child processes to finish before exiting [false]
+-warn string Enable warning; command-line only
-where Show where listed variables are declared [false]
--xformat format GUI deconstruction format [png]
+-zoomfactor factor Zoom step factor [1.05]
+-zoomstep step Mouse motion zoom step [0.1]
All boolean options can be negated by prepending `no' to the option
name.
@@ -7722,11 +7814,11 @@ automatically imported for each run as the final step in loading module
Default option values may be entered as `Asymptote' code in a
configuration file named `config.asy' (or the file specified by the
environment variable `ASYMPTOTE_CONFIG' or `-config' option).
-`Asymptote' will look for this file in its usual search path.
-Typically the configuration file is placed in the `.asy' directory in
-the user's home directory (`%USERPROFILE%\.asy' under `MSDOS').
-Configuration variables are accessed using the long form of the option
-names:
+`Asymptote' will look for this file in its usual search path (*note
+Search paths::). Typically the configuration file is placed in the
+`.asy' directory in the user's home directory (`%USERPROFILE%\.asy'
+under `MSDOS'). Configuration variables are accessed using the long
+form of the option names:
import settings;
outformat="pdf";
batchView=false;
@@ -7763,8 +7855,9 @@ pixel per `bp':
asy -o - venn | convert -alpha Off -density 144x144 -geometry 50%x eps:- venn.tiff
If the option `-nosafe' is given, `Asymptote' runs in unsafe mode.
-This enables the `int system(string s)' call, allowing one to execute
-arbitrary shell commands. The default mode, `-safe', disables this call.
+This enables the `int system(string s)' and `int system(string[] s)'
+calls, allowing one to execute arbitrary shell commands. The default
+mode, `-safe', disables this call.
A `PostScript' offset may be specified as a pair (in `bp' units)
with the `-O' option:
@@ -7816,8 +7909,8 @@ option:

File: asymptote.info, Node: Interactive mode, Next: GUI, Prev: Options, Up: Top
-9 Interactive mode
-******************
+10 Interactive mode
+*******************
Interactive mode is entered by executing the command `asy' with no file
arguments. When the `-multiline' option is disabled (the default), each
@@ -7841,6 +7934,9 @@ and must be entered immediately after the prompt:
`help'
view the manual;
+`erase'
+ erase `currentpicture';
+
`reset'
reset the `Asymptote' environment to its initial state, except for
changes to the settings module (*note settings::), the current
@@ -7887,7 +7983,7 @@ g.label("\"$O$\", (0,0), SW")

File: asymptote.info, Node: GUI, Next: PostScript to Asymptote, Prev: Interactive mode, Up: Top
-10 Graphical User Interface
+11 Graphical User Interface
***************************
In the event that adjustments to the final figure are required, the
@@ -7897,13 +7993,13 @@ The modified figure can then be saved as a normal `Asymptote' file.
* Menu:
-* GUI Installation:: Installing `xasy'
-* GUI Usage::
+* GUI installation:: Installing `xasy'
+* GUI usage::

-File: asymptote.info, Node: GUI Installation, Next: GUI Usage, Up: GUI
+File: asymptote.info, Node: GUI installation, Next: GUI usage, Up: GUI
-10.1 GUI Installation
+11.1 GUI installation
=====================
As `xasy' is written in the interactive scripting language `Python/TK',
@@ -7919,31 +8015,22 @@ packages.
Pictures are deconstructed into the PNG image format, which supports
full alpha channel transparency. Under `Microsoft Windows', this
-requires `Python 2.5 (or 2.5.1)' and the `Python Imaging Library':
+requires `Python 2.6.2' and the `Python Imaging Library':
- `http://www.python.org/ftp/python/2.5.1/python-2.5.1.msi'
+ `http://www.python.org/ftp/python/2.6.2/python-2.6.2.msi'
- `http://effbot.org/downloads/PIL-1.1.6.win32-py2.5.exe'.
+ `http://effbot.org/downloads/PIL-1.1.7b1.win32-py2.6.exe'.
On `UNIX' systems, place
-`http://effbot.org/downloads/Imaging-1.1.6.tar.gz' in the `Asymptote'
+`http://effbot.org/downloads/Imaging-1.1.7b1.tar.gz' in the `Asymptote'
source directory, and type (as the root user):
-tar -zxf Imaging-1.1.6.tar.gz
-cd Imaging-1.1.6
-patch -p1 < ../patches/TkAlpha-Imaging-1.1.6.patch
+tar -zxf Imaging-1.1.7b1.tar.gz
+cd Imaging-1.1.7b1
python setup.py install
- Alternatively, `xasy' can deconstruct pictures into the GIF image
-format (not recommended as this is very slow), using white as the
-transparent color. This requires the lines
-import settings;
-xformat="gif";
- in the `Asymptote' configuration file (*note configuration file::),
-along with the `ImageMagick' (*note convert::) program.
-

-File: asymptote.info, Node: GUI Usage, Prev: GUI Installation, Up: GUI
+File: asymptote.info, Node: GUI usage, Prev: GUI installation, Up: GUI
-10.2 GUI Usage
+11.2 GUI usage
==============
A wheel mouse is convenient for raising and lowering objects within
@@ -7964,32 +8051,15 @@ elements will be individually deconstructed (*note add::).

File: asymptote.info, Node: PostScript to Asymptote, Next: Help, Prev: GUI, Up: Top
-11 `PostScript' to `Asymptote'
+12 `PostScript' to `Asymptote'
******************************
-The excellent `PostScript' editor `pstoedit' (version 3.45 or later;
-available from `http://pstoedit.net') includes an `Asymptote' backend.
-Unlike virtually all other `pstoedit' backends, this driver includes
-native clipping, even-odd fill rule, `PostScript' subpath, and full
-image support.
-
- For full functionality, the patch `pstoedit-3.45asy.patch' in the
-`patches' directory should be applied. On `UNIX' systems, as the root
-user, place
-
- `http://prdownloads.sourceforge.net/pstoedit/pstoedit-3.45.tar.gz'
- in the `Asymptote' source directory, and type:
-
-tar -zxf pstoedit-3.45.tar.gz
-cd pstoedit-3.45
-patch -p1 < ../patches/pstoedit-3.45asy.patch
-autoconf
-./configure --prefix=/usr
-make install
-
-Then try:
-
-`asy -V /usr/local/share/doc/asymptote/examples/venn.asy'
+The excellent `PostScript' editor `pstoedit' (version 3.50 or later;
+available from `http://sourceforge.net/projects/pstoedit/') includes an
+`Asymptote' backend. Unlike virtually all other `pstoedit' backends,
+this driver includes native clipping, even-odd fill rule, `PostScript'
+subpath, and full image support. Here is an example: `asy -V
+/usr/local/share/doc/asymptote/examples/venn.asy'
pstoedit -f asy venn.eps test.asy
asy -V test
@@ -8000,7 +8070,7 @@ If the line widths aren't quite correct, try giving `pstoedit' the

File: asymptote.info, Node: Help, Next: Debugger, Prev: PostScript to Asymptote, Up: Top
-12 Help
+13 Help
*******
A list of frequently asked questions (FAQ) is maintained at
@@ -8009,7 +8079,7 @@ A list of frequently asked questions (FAQ) is maintained at
Questions on installing and using `Asymptote' that are not addressed
in the FAQ should be sent to the `Asymptote' forum:
- `http://sourceforge.net/forum/forum.php?forum_id=409349'
+ `http://sourceforge.net/projects/asymptote/forums/forum/409349'
Including an example that illustrates what you are trying to do will
help you get useful feedback. `LaTeX' problems can often be diagnosed
with the `-vv' or `-vvv' command-line options. Contributions in the
@@ -8021,7 +8091,7 @@ form of patches or `Asymptote' modules can be posted here:
`http://freshmeat.net/projects/asy'
If you find a bug in `Asymptote', please check (if possible) whether
-the bug is still present in the latest Subversion developmental code
+the bug is still present in the latest `Subversion' developmental code
(*note Subversion::) before submitting a bug report. New bugs can be
submitted using the Bug Tracking System at
@@ -8040,7 +8110,7 @@ generates such segmentation faults along with your bug report).

File: asymptote.info, Node: Debugger, Next: Credits, Prev: Help, Up: Top
-13 Debugger
+14 Debugger
***********
Asymptote now includes a line-based (as opposed to code-based) debugger
@@ -8108,7 +8178,7 @@ void breakpoint(code s=quote{});

File: asymptote.info, Node: Credits, Next: Index, Prev: Debugger, Up: Top
-14 Acknowledgments
+15 Acknowledgments
******************
Financial support for the development of `Asymptote' was generously
@@ -8147,7 +8217,7 @@ Index
(line 6)
* & <1>: Arithmetic & logical.
(line 56)
-* &: Tutorial. (line 192)
+* &: Bezier curves. (line 83)
* &&: Arithmetic & logical.
(line 53)
* * <1>: Arithmetic & logical.
@@ -8168,16 +8238,16 @@ Index
(line 14)
* -- <1>: Self & prefix operators.
(line 6)
-* --: Tutorial. (line 109)
-* ---: Tutorial. (line 192)
+* --: Tutorial. (line 125)
+* ---: Bezier curves. (line 83)
* -=: Self & prefix operators.
(line 6)
-* -c: Options. (line 154)
-* -l: Options. (line 173)
-* -u: Options. (line 164)
-* -V <1>: Tutorial. (line 41)
+* -c: Options. (line 167)
+* -l: Options. (line 186)
+* -u: Options. (line 177)
+* -V <1>: Tutorial. (line 19)
* -V: Configuring. (line 6)
-* ..: Tutorial. (line 109)
+* ..: Tutorial. (line 125)
* .asy: Search paths. (line 13)
* /: Arithmetic & logical.
(line 20)
@@ -8186,11 +8256,12 @@ Index
* 2D graphs: graph. (line 6)
* 3D graphs: graph3. (line 6)
* 3D grids: grid3. (line 6)
+* 3D PostScript: three. (line 532)
* 3D rendering: Compiling from UNIX source.
(line 16)
* :: Arithmetic & logical.
(line 73)
-* ::: Tutorial. (line 176)
+* ::: Bezier curves. (line 67)
* <: Arithmetic & logical.
(line 41)
* <=: Arithmetic & logical.
@@ -8208,14 +8279,14 @@ Index
(line 28)
* ^=: Self & prefix operators.
(line 6)
-* ^^: Tutorial. (line 197)
-* a4: Configuring. (line 62)
+* ^^: Tutorial. (line 132)
+* a4: Configuring. (line 61)
* abort: Data types. (line 321)
* abs <1>: Mathematical functions.
(line 35)
* abs: Data types. (line 60)
-* accel <1>: three. (line 433)
-* accel: Paths and guides. (line 110)
+* accel <1>: three. (line 462)
+* accel: Paths and guides. (line 109)
* access: Import. (line 6)
* acknowledgments: Credits. (line 6)
* aCos: Mathematical functions.
@@ -8225,57 +8296,59 @@ Index
* acosh: Mathematical functions.
(line 6)
* add: Frames and pictures. (line 192)
+* adjust: Pens. (line 112)
* Ai: Mathematical functions.
(line 48)
* Ai_deriv: Mathematical functions.
(line 48)
* Airy: Mathematical functions.
(line 48)
-* alias <1>: Arrays. (line 187)
+* alias <1>: Arrays. (line 184)
* alias: Structures. (line 54)
-* align: Options. (line 148)
+* align: Options. (line 161)
* Align: label. (line 12)
-* all: Arrays. (line 331)
-* Allow: Pens. (line 323)
+* all: Arrays. (line 328)
+* Allow: Pens. (line 324)
* AND: Arithmetic & logical.
(line 80)
-* and: Tutorial. (line 165)
+* and: Bezier curves. (line 56)
* angle: Data types. (line 68)
* animate <1>: animation. (line 12)
-* animate <2>: Files. (line 148)
-* animate: Configuring. (line 68)
+* animate <2>: Files. (line 151)
+* animate: Configuring. (line 67)
* animation: animation. (line 6)
* annotate: annotate. (line 6)
-* antialias <1>: Options. (line 128)
-* antialias: three. (line 180)
+* antialias <1>: Options. (line 140)
+* antialias: three. (line 205)
* antialiasing: Compiling from UNIX source.
(line 16)
* append <1>: Arrays. (line 39)
* append: Files. (line 36)
-* arc: three. (line 245)
+* arc: three. (line 271)
* Arc: Paths and guides. (line 32)
* arc: Paths and guides. (line 22)
* ArcArrow: draw. (line 26)
-* ArcArrow3: three. (line 476)
+* ArcArrow3: three. (line 505)
* ArcArrows: draw. (line 26)
-* ArcArrows3: three. (line 476)
-* arclength <1>: three. (line 433)
-* arclength: Paths and guides. (line 137)
-* arctime <1>: three. (line 433)
-* arctime: Paths and guides. (line 141)
+* ArcArrows3: three. (line 505)
+* arclength <1>: three. (line 462)
+* arclength: Paths and guides. (line 136)
+* arctime <1>: three. (line 462)
+* arctime: Paths and guides. (line 140)
* arguments: Default arguments. (line 6)
* arithmetic operators: Arithmetic & logical.
(line 6)
-* array: Arrays. (line 125)
+* array: Arrays. (line 122)
* array iteration: Programming. (line 33)
* arrays: Arrays. (line 6)
* arrow: label. (line 72)
* Arrow: draw. (line 26)
* arrow: Drawing commands. (line 31)
-* arrow keys: Tutorial. (line 21)
-* Arrow3: three. (line 476)
+* arrow keys: Tutorial. (line 35)
+* Arrow3: three. (line 505)
* Arrows: draw. (line 26)
-* Arrows3: three. (line 476)
+* arrows: draw. (line 26)
+* Arrows3: three. (line 505)
* as: Import. (line 70)
* aSin: Mathematical functions.
(line 20)
@@ -8289,7 +8362,8 @@ Index
* asy-mode: Editing modes. (line 6)
* asy.vim: Editing modes. (line 33)
* asymptote.sty: LaTeX usage. (line 6)
-* ASYMPTOTE_CONFIG: Options. (line 101)
+* asymptote.xml: Editing modes. (line 49)
+* ASYMPTOTE_CONFIG: Options. (line 113)
* aTan: Mathematical functions.
(line 20)
* atan: Mathematical functions.
@@ -8298,11 +8372,11 @@ Index
(line 6)
* atanh: Mathematical functions.
(line 6)
-* atleast: Tutorial. (line 165)
+* atleast: Bezier curves. (line 56)
* attach <1>: graph. (line 405)
* attach: LaTeX usage. (line 32)
-* autoadjust: three. (line 315)
-* autoimport: Options. (line 97)
+* autoadjust: three. (line 342)
+* autoimport: Options. (line 109)
* automatic scaling: graph. (line 672)
* axialshade: fill. (line 43)
* axis <1>: graph3. (line 66)
@@ -8310,36 +8384,37 @@ Index
* azimuth: Data types. (line 124)
* babel: babel. (line 6)
* background color: Frames and pictures. (line 164)
-* BackView: three. (line 340)
+* BackView: three. (line 369)
* Bar: draw. (line 19)
-* Bar3: three. (line 476)
+* Bar3: three. (line 505)
* Bars: draw. (line 19)
-* Bars3: three. (line 476)
+* Bars3: three. (line 505)
* barsize: draw. (line 19)
* base modules: Base modules. (line 6)
-* basealign: Pens. (line 164)
+* basealign: Pens. (line 165)
* baseline: label. (line 92)
-* batch mode: Tutorial. (line 30)
+* batch mode: Tutorial. (line 6)
* beep: Data types. (line 335)
* BeginArcArrow: draw. (line 26)
-* BeginArcArrow3: three. (line 476)
+* BeginArcArrow3: three. (line 505)
* BeginArrow: draw. (line 26)
-* BeginArrow3: three. (line 476)
+* BeginArrow3: three. (line 505)
* BeginBar: draw. (line 19)
-* BeginBar3: three. (line 476)
+* BeginBar3: three. (line 505)
* BeginDotMargin: draw. (line 42)
-* BeginDotMargin3: three. (line 492)
+* BeginDotMargin3: three. (line 521)
* BeginMargin: draw. (line 42)
-* BeginMargin3: three. (line 492)
+* BeginMargin3: three. (line 521)
* BeginPenMargin: draw. (line 42)
-* BeginPenMargin2: three. (line 492)
-* BeginPenMargin3: three. (line 492)
+* BeginPenMargin2: three. (line 521)
+* BeginPenMargin3: three. (line 521)
* BeginPoint: label. (line 57)
* Bessel: Mathematical functions.
(line 48)
* bevel: flowchart. (line 68)
-* beveljoin: Pens. (line 134)
-* bezulate: three. (line 98)
+* beveljoin: Pens. (line 135)
+* Bezier curves: Bezier curves. (line 6)
+* bezulate: three. (line 99)
* Bi: Mathematical functions.
(line 48)
* Bi_deriv: Mathematical functions.
@@ -8367,19 +8442,19 @@ Index
(line 6)
* Bottom: graph. (line 128)
* BottomTop: graph. (line 134)
-* BottomView: three. (line 340)
+* BottomView: three. (line 369)
* bounding box: Frames and pictures. (line 164)
* Bounds: graph3. (line 20)
* boutput: Files. (line 71)
-* box <1>: three. (line 267)
+* box <1>: three. (line 293)
* box: Frames and pictures. (line 22)
-* bp: Tutorial. (line 17)
+* bp: Tutorial. (line 24)
* break: Programming. (line 29)
* breakpoints: Debugger. (line 21)
-* brick: Pens. (line 247)
+* brick: Pens. (line 248)
* broken axis: graph. (line 773)
* bug reports: Help. (line 23)
-* buildcycle: Paths and guides. (line 251)
+* buildcycle: Paths and guides. (line 250)
* Button-1: GUI. (line 6)
* Button-2: GUI. (line 6)
* BWRainbow: palette. (line 15)
@@ -8393,24 +8468,25 @@ Index
* cd: Files. (line 24)
* ceil: Mathematical functions.
(line 26)
-* center: three. (line 300)
+* center: three. (line 326)
* Center: label. (line 62)
-* checker: Pens. (line 247)
+* checker: Pens. (line 248)
* Chinese: unicode. (line 12)
* choose: Mathematical functions.
(line 39)
* Ci: Mathematical functions.
(line 48)
* circle <1>: flowchart. (line 57)
-* circle: three. (line 241)
+* circle: three. (line 267)
* Circle: Paths and guides. (line 17)
* circle: Paths and guides. (line 10)
* circlebarframe: markers. (line 18)
* CJK: unicode. (line 12)
* clear <1>: Debugger. (line 23)
-* clear: Files. (line 86)
+* clear: Files. (line 89)
* clip: fill. (line 110)
-* cm: Tutorial. (line 63)
+* cm: Tutorial. (line 61)
+* cmd: Configuring. (line 34)
* cmyk: Pens. (line 34)
* colatitude: Data types. (line 129)
* color: Pens. (line 23)
@@ -8420,38 +8496,39 @@ Index
* colorless: Pens. (line 54)
* colors: Pens. (line 51)
* comma: Files. (line 59)
-* comma-separated-value mode: Arrays. (line 362)
+* comma-separated-value mode: Arrays. (line 361)
* command-line options <1>: Options. (line 6)
-* command-line options: Configuring. (line 82)
+* command-line options: Configuring. (line 83)
* comment character: Files. (line 15)
-* compass directions: Tutorial. (line 94)
+* compass directions: Tutorial. (line 104)
* Compiling from UNIX source: Compiling from UNIX source.
(line 6)
-* complement: Arrays. (line 153)
-* concat: Arrays. (line 183)
+* complement: Arrays. (line 150)
+* concat: Arrays. (line 180)
* conditional <1>: Arithmetic & logical.
(line 73)
* conditional: Programming. (line 8)
-* config: Options. (line 101)
-* configuration file: Configuring. (line 21)
+* config: Options. (line 113)
+* configuration file <1>: Options. (line 113)
+* configuration file: Configuring. (line 23)
* configuring: Configuring. (line 6)
* conj: Data types. (line 57)
* constructors: Structures. (line 95)
-* context: Options. (line 128)
+* context: Options. (line 140)
* continue <1>: Debugger. (line 31)
* continue: Programming. (line 29)
* contour: contour. (line 9)
* contour3: contour3. (line 6)
* controls <1>: three. (line 6)
-* controls: Tutorial. (line 154)
-* controlSpecifier: Paths and guides. (line 375)
-* convert <1>: Options. (line 128)
+* controls: Bezier curves. (line 45)
+* controlSpecifier: Paths and guides. (line 374)
+* convert <1>: Options. (line 140)
* convert <2>: animation. (line 6)
-* convert <3>: Files. (line 148)
-* convert: Configuring. (line 68)
-* convertOptions: Options. (line 116)
+* convert <3>: Files. (line 151)
+* convert: Configuring. (line 67)
+* convertOptions: Options. (line 128)
* Coons shading: fill. (line 74)
-* copy: Arrays. (line 174)
+* copy: Arrays. (line 171)
* Cos: Mathematical functions.
(line 20)
* cos: Mathematical functions.
@@ -8464,25 +8541,24 @@ Index
* cross <1>: graph. (line 474)
* cross: Data types. (line 167)
* crossframe: markers. (line 23)
-* crosshatch: Pens. (line 263)
-* csv: Arrays. (line 362)
-* cubicroots: Arrays. (line 320)
+* crosshatch: Pens. (line 264)
+* csv: Arrays. (line 361)
+* cubicroots: Arrays. (line 317)
* curl <1>: three. (line 6)
-* curl: Tutorial. (line 172)
-* curlSpecifier: Paths and guides. (line 387)
+* curl: Bezier curves. (line 63)
+* curlSpecifier: Paths and guides. (line 386)
* currentpen: Pens. (line 6)
-* currentprojection: three. (line 337)
+* currentprojection: three. (line 366)
* curve: slopefield. (line 20)
* custom axis types: graph. (line 138)
* custom mark routine: graph. (line 566)
* custom tick locations: graph. (line 241)
-* cut: Paths and guides. (line 233)
+* cut: Paths and guides. (line 232)
* cycle <1>: three. (line 6)
-* cycle: Tutorial. (line 46)
-* cyclic <1>: three. (line 433)
+* cycle: Tutorial. (line 73)
+* cyclic <1>: three. (line 462)
* cyclic <2>: Arrays. (line 39)
-* cyclic: Paths and guides. (line 75)
-* cyclicflag: Arrays. (line 39)
+* cyclic: Paths and guides. (line 74)
* Cyrillic: unicode. (line 7)
* dashdotted: Pens. (line 92)
* dashed: Pens. (line 92)
@@ -8492,11 +8568,11 @@ Index
(line 19)
* debugger: Debugger. (line 6)
* declaration: Programming. (line 8)
-* deconstruct: GUI Usage. (line 6)
+* deconstruct: GUI usage. (line 6)
* default arguments: Default arguments. (line 6)
* defaultformat: graph. (line 169)
* DefaultHead: draw. (line 26)
-* DefaultHead3: three. (line 476)
+* DefaultHead3: three. (line 505)
* defaultpen: Pens. (line 46)
* deferred drawing: simplex. (line 6)
* Degrees: Mathematical functions.
@@ -8505,30 +8581,30 @@ Index
(line 17)
* degrees: Data types. (line 73)
* delete <1>: Arrays. (line 39)
-* delete: Files. (line 143)
+* delete: Files. (line 146)
* description: Description. (line 6)
-* diagonal: Arrays. (line 305)
+* diagonal: Arrays. (line 302)
* diamond: flowchart. (line 50)
-* dimension: Arrays. (line 368)
-* dir <1>: three. (line 433)
-* dir <2>: Paths and guides. (line 99)
+* dimension: Arrays. (line 366)
+* dir <1>: three. (line 462)
+* dir <2>: Paths and guides. (line 98)
* dir <3>: Data types. (line 85)
* dir: Search paths. (line 10)
-* direction specifier: Tutorial. (line 115)
+* direction specifier: Bezier curves. (line 6)
* directory: Files. (line 24)
-* dirSpecifier: Paths and guides. (line 369)
-* dirtime: Paths and guides. (line 147)
-* display: Configuring. (line 68)
+* dirSpecifier: Paths and guides. (line 368)
+* dirtime: Paths and guides. (line 146)
+* display: Configuring. (line 67)
* do: Programming. (line 29)
* dot <1>: Data types. (line 98)
* dot: draw. (line 83)
* DotMargin: draw. (line 42)
-* DotMargin3: three. (line 492)
+* DotMargin3: three. (line 521)
* DotMargins: draw. (line 42)
-* DotMargins3: three. (line 492)
+* DotMargins3: three. (line 521)
* dotted: Pens. (line 92)
-* double: Files. (line 71)
-* double deferred drawing: three. (line 222)
+* double deferred drawing: three. (line 248)
+* double precision: Files. (line 71)
* Draw: Frames and pictures. (line 147)
* draw: draw. (line 110)
* Draw: draw. (line 26)
@@ -8536,15 +8612,17 @@ Index
* drawing commands: Drawing commands. (line 6)
* drawline: math. (line 9)
* drawtree: drawtree. (line 9)
-* dvips: Configuring. (line 68)
-* dvipsOptions: Options. (line 116)
+* dvips: Configuring. (line 67)
+* dvipsOptions: Options. (line 128)
+* dvisvg: Configuring. (line 67)
* E <1>: Mathematical functions.
(line 48)
-* E: Tutorial. (line 94)
+* E: Tutorial. (line 104)
* Editing modes: Editing modes. (line 6)
* Ei: Mathematical functions.
(line 48)
-* ellipse: Frames and pictures. (line 22)
+* ellipse <1>: Frames and pictures. (line 22)
+* ellipse: Paths and guides. (line 39)
* elliptic functions: Mathematical functions.
(line 48)
* else: Programming. (line 8)
@@ -8552,40 +8630,42 @@ Index
* embed: embed. (line 6)
* empty: Frames and pictures. (line 7)
* EndArcArrow: draw. (line 26)
-* EndArcArrow3: three. (line 476)
+* EndArcArrow3: three. (line 505)
* EndArrow: draw. (line 26)
-* EndArrow3: three. (line 476)
+* EndArrow3: three. (line 505)
* EndBar: draw. (line 19)
-* EndBar3: three. (line 476)
+* EndBar3: three. (line 505)
* EndDotMargin: draw. (line 42)
-* EndDotMargin3: three. (line 492)
+* EndDotMargin3: three. (line 521)
* endl: Files. (line 59)
* EndMargin: draw. (line 42)
-* EndMargin3: three. (line 492)
+* EndMargin3: three. (line 521)
* EndPenMargin: draw. (line 42)
-* EndPenMargin2: three. (line 492)
-* EndPenMargin3: three. (line 492)
+* EndPenMargin2: three. (line 521)
+* EndPenMargin3: three. (line 521)
* EndPoint: label. (line 57)
* envelope: Frames and pictures. (line 22)
-* environment variables: Configuring. (line 86)
-* eof <1>: Arrays. (line 346)
-* eof: Files. (line 86)
-* eol <1>: Arrays. (line 346)
-* eol: Files. (line 86)
+* environment variables: Configuring. (line 87)
+* eof <1>: Arrays. (line 343)
+* eof: Files. (line 89)
+* eol <1>: Arrays. (line 343)
+* eol: Files. (line 89)
* EPS: label. (line 80)
* erase <1>: Frames and pictures. (line 7)
-* erase: Data types. (line 239)
+* erase <2>: Data types. (line 239)
+* erase: Tutorial. (line 35)
* erf: Mathematical functions.
(line 6)
* erfc: Mathematical functions.
(line 6)
* error: Files. (line 15)
+* error bars: graph. (line 522)
* errorbars: graph. (line 474)
* eval: Import. (line 101)
-* evenodd <1>: Pens. (line 148)
-* evenodd: Tutorial. (line 211)
+* evenodd <1>: Pens. (line 149)
+* evenodd: Tutorial. (line 146)
* exit <1>: Debugger. (line 57)
-* exit <2>: Interactive mode. (line 37)
+* exit <2>: Interactive mode. (line 40)
* exit: Data types. (line 326)
* exp: Mathematical functions.
(line 6)
@@ -8596,24 +8676,24 @@ Index
(line 6)
* exponential integral: Mathematical functions.
(line 48)
-* extendcap: Pens. (line 125)
+* extendcap: Pens. (line 126)
* extension <1>: MetaPost. (line 10)
-* extension: Paths and guides. (line 228)
+* extension: Paths and guides. (line 227)
* external: embed. (line 28)
-* extrude: three. (line 427)
+* extrude: three. (line 456)
* F: Mathematical functions.
(line 48)
* fabs: Mathematical functions.
(line 6)
-* face: three. (line 511)
+* face: three. (line 540)
* factorial: Mathematical functions.
(line 39)
* Fedora: UNIX binary distributions.
(line 15)
* feynman: feynman. (line 6)
-* fft: Arrays. (line 252)
+* fft: Arrays. (line 249)
* FFTW: Compiling from UNIX source.
- (line 59)
+ (line 58)
* file <1>: Debugger. (line 45)
* file: Files. (line 6)
* Fill: Frames and pictures. (line 133)
@@ -8624,12 +8704,12 @@ Index
* filldraw: fill. (line 11)
* FillDraw: draw. (line 26)
* filloutside: fill. (line 27)
-* fillrule: Pens. (line 148)
-* find <1>: Arrays. (line 162)
+* fillrule: Pens. (line 149)
+* find <1>: Arrays. (line 159)
* find: Data types. (line 224)
-* firstcut: Paths and guides. (line 243)
+* firstcut: Paths and guides. (line 242)
* fit: Frames and pictures. (line 103)
-* fix-cm: Pens. (line 174)
+* fix-cm: Pens. (line 175)
* fixedscaling: Frames and pictures. (line 74)
* floor: Mathematical functions.
(line 26)
@@ -8637,19 +8717,19 @@ Index
* flush: Files. (line 59)
* fmod: Mathematical functions.
(line 6)
-* font: Pens. (line 188)
-* font command: Pens. (line 188)
-* fontcommand: Pens. (line 203)
-* fontsize: Pens. (line 174)
+* font: Pens. (line 189)
+* font command: Pens. (line 189)
+* fontcommand: Pens. (line 204)
+* fontsize: Pens. (line 175)
* for: Programming. (line 8)
-* format <1>: Options. (line 128)
+* format <1>: Options. (line 140)
* format: Data types. (line 266)
* forum: Help. (line 6)
* frame: Frames and pictures. (line 7)
* freeglut: Compiling from UNIX source.
(line 16)
* from: Import. (line 17)
-* FrontView: three. (line 340)
+* FrontView: three. (line 369)
* function declarations: Functions. (line 67)
* function shading: fill. (line 95)
* Function shading: fill. (line 95)
@@ -8663,12 +8743,12 @@ Index
(line 39)
* geometry: geometry. (line 6)
* getc: Files. (line 30)
-* getpair: Files. (line 111)
-* getreal: Files. (line 111)
-* getstring: Files. (line 111)
-* gettriple: Files. (line 111)
-* glOptions <1>: Options. (line 116)
-* glOptions: three. (line 180)
+* getpair: Files. (line 114)
+* getreal: Files. (line 114)
+* getstring: Files. (line 114)
+* gettriple: Files. (line 114)
+* glOptions <1>: Options. (line 128)
+* glOptions: three. (line 205)
* GNU Scientific Library: Mathematical functions.
(line 48)
* gouraudshade: fill. (line 58)
@@ -8682,20 +8762,20 @@ Index
* Grayscale: palette. (line 9)
* grayscale: Pens. (line 25)
* grid <1>: graph. (line 724)
-* grid: Pens. (line 247)
+* grid: Pens. (line 248)
* grid3: grid3. (line 6)
* gs: Configuring. (line 6)
* gsl: Mathematical functions.
(line 48)
* GSL: Compiling from UNIX source.
- (line 59)
-* gsOptions: Options. (line 116)
+ (line 58)
+* gsOptions: Options. (line 128)
* GUI: GUI. (line 6)
-* GUI installation: GUI Installation. (line 6)
-* GUI usage: GUI Usage. (line 6)
-* guide: Paths and guides. (line 296)
+* GUI installation: GUI installation. (line 6)
+* GUI usage: GUI usage. (line 6)
+* guide: Paths and guides. (line 295)
* guide3: three. (line 6)
-* hatch: Pens. (line 263)
+* hatch: Pens. (line 264)
* height: LaTeX usage. (line 32)
* help <1>: Debugger. (line 30)
* help <2>: Help. (line 6)
@@ -8705,13 +8785,14 @@ Index
* hex: Data types. (line 279)
* hexidecimal <1>: Pens. (line 59)
* hexidecimal: Data types. (line 279)
-* hidden surface removal: three. (line 511)
+* hidden surface removal: three. (line 540)
* histogram: Mathematical functions.
(line 39)
-* history: Files. (line 136)
-* historylines: Interactive mode. (line 42)
+* history <1>: Interactive mode. (line 40)
+* history: Files. (line 139)
+* historylines: Interactive mode. (line 45)
* HookHead: draw. (line 26)
-* HookHead3: three. (line 476)
+* HookHead3: three. (line 505)
* Horizontal: flowchart. (line 74)
* hypot: Mathematical functions.
(line 6)
@@ -8719,60 +8800,61 @@ Index
(line 48)
* i_scaled: Mathematical functions.
(line 48)
-* iconic: three. (line 180)
-* identity <1>: Arrays. (line 302)
+* iconic: three. (line 205)
+* identity <1>: Arrays. (line 299)
* identity <2>: Mathematical functions.
(line 6)
* identity: Transforms. (line 24)
* if: Programming. (line 8)
* IgnoreAspect: Frames and pictures. (line 58)
* image: palette. (line 34)
-* ImageMagick <1>: Options. (line 128)
+* ImageMagick <1>: Options. (line 140)
* ImageMagick <2>: animation. (line 6)
-* ImageMagick: Configuring. (line 68)
+* ImageMagick: Configuring. (line 67)
+* images: palette. (line 6)
* implicit casts: Casts. (line 6)
* implicit linear solver: MetaPost. (line 10)
* implicit scaling: Implicit scaling. (line 6)
* import: Import. (line 48)
-* inches: Tutorial. (line 63)
+* inches: Tutorial. (line 61)
* including images: label. (line 80)
* inheritance: Structures. (line 189)
* initialized: Arrays. (line 39)
* initializers: Variable initializers.
(line 6)
* InOutTicks: graph3. (line 34)
-* input <1>: Interactive mode. (line 31)
+* input <1>: Interactive mode. (line 29)
* input: Files. (line 11)
* insert <1>: Arrays. (line 39)
* insert: Data types. (line 235)
-* inside: Paths and guides. (line 275)
+* inside: Paths and guides. (line 274)
* inst: Debugger. (line 36)
* installation: Installation. (line 6)
* int: Data types. (line 28)
* integer division: Arithmetic & logical.
(line 6)
* interactive mode: Interactive mode. (line 6)
-* interior: Paths and guides. (line 271)
+* interior: Paths and guides. (line 270)
* international characters: unicode. (line 6)
* interp: Arithmetic & logical.
(line 76)
* interpolate: interpolate. (line 6)
-* intersect <1>: three. (line 433)
+* intersect <1>: three. (line 462)
* intersect <2>: math. (line 13)
-* intersect: Paths and guides. (line 176)
-* intersectionpoint <1>: three. (line 433)
+* intersect: Paths and guides. (line 175)
+* intersectionpoint <1>: three. (line 462)
* intersectionpoint <2>: math. (line 17)
-* intersectionpoint: Paths and guides. (line 220)
-* intersectionpoints <1>: three. (line 433)
-* intersectionpoints: Paths and guides. (line 224)
-* intersections <1>: three. (line 433)
-* intersections: Paths and guides. (line 187)
+* intersectionpoint: Paths and guides. (line 219)
+* intersectionpoints <1>: three. (line 462)
+* intersectionpoints: Paths and guides. (line 223)
+* intersections <1>: three. (line 462)
+* intersections: Paths and guides. (line 186)
* InTicks: graph3. (line 34)
* intMax: Data types. (line 28)
* intMin: Data types. (line 28)
-* inverse <1>: Arrays. (line 308)
+* inverse <1>: Arrays. (line 305)
* inverse: Transforms. (line 16)
-* invert: three. (line 366)
+* invert: three. (line 395)
* invisible: Pens. (line 39)
* J: Mathematical functions.
(line 6)
@@ -8781,11 +8863,14 @@ Index
(line 48)
* k_scaled: Mathematical functions.
(line 48)
-* keyboard bindings:: three. (line 149)
+* Kate: Editing modes. (line 49)
+* KDE editor: Editing modes. (line 49)
+* keyboard bindings:: three. (line 164)
* keys: Arrays. (line 39)
* keywords: Named arguments. (line 6)
* Korean: unicode. (line 12)
-* Label: graph. (line 332)
+* Label <1>: graph. (line 332)
+* Label: label. (line 15)
* label: clip. (line 16)
* Label: draw. (line 98)
* labelpath: labelpath. (line 6)
@@ -8793,10 +8878,10 @@ Index
* labelx: graph. (line 332)
* labely: graph. (line 332)
* Landscape: Frames and pictures. (line 95)
-* lastcut: Paths and guides. (line 247)
+* lastcut: Paths and guides. (line 246)
* lasy-mode: Editing modes. (line 6)
-* latex: Options. (line 128)
-* LaTeX fonts: Pens. (line 188)
+* latex: Options. (line 140)
+* LaTeX fonts: Pens. (line 189)
* LaTeX usage: LaTeX usage. (line 6)
* latin1: latin1. (line 6)
* latitude: Data types. (line 134)
@@ -8808,29 +8893,30 @@ Index
* LeftRight: graph. (line 280)
* LeftSide: label. (line 62)
* LeftTicks: graph. (line 155)
-* LeftView: three. (line 340)
+* LeftView: three. (line 369)
* legend <1>: graph. (line 421)
* legend <2>: draw. (line 64)
* legend: Drawing commands. (line 31)
* Legendre: Mathematical functions.
(line 48)
-* length <1>: three. (line 433)
+* length <1>: three. (line 462)
* length <2>: Arrays. (line 39)
-* length <3>: Paths and guides. (line 66)
+* length <3>: Paths and guides. (line 65)
* length: Data types. (line 60)
-* letter: Configuring. (line 62)
+* letter: Configuring. (line 61)
* libm routines: Mathematical functions.
(line 6)
* libsigsegv <1>: Help. (line 33)
* libsigsegv: Functions. (line 88)
* limits: graph. (line 626)
-* line: Arrays. (line 346)
-* line mode: Arrays. (line 346)
+* line: Arrays. (line 343)
+* line mode: Arrays. (line 343)
* Linear: graph. (line 672)
-* linecap: Pens. (line 125)
-* linejoin: Pens. (line 134)
-* lineskip: Pens. (line 174)
-* linewidth: Pens. (line 115)
+* linecap: Pens. (line 126)
+* linejoin: Pens. (line 135)
+* lineskip: Pens. (line 175)
+* linetype: Pens. (line 112)
+* linewidth: Pens. (line 116)
* locale: Data types. (line 286)
* Log: graph. (line 672)
* log: Mathematical functions.
@@ -8850,13 +8936,13 @@ Index
* loop: Programming. (line 8)
* MacOS X binary distributions: MacOS X binary distributions.
(line 6)
-* makepen: Pens. (line 296)
-* map: Arrays. (line 144)
+* makepen: Pens. (line 297)
+* map: Arrays. (line 141)
* Margin: draw. (line 42)
-* Margin3: three. (line 492)
-* margins: three. (line 228)
+* Margin3: three. (line 521)
+* margins: three. (line 254)
* Margins: draw. (line 42)
-* Margins3: three. (line 492)
+* Margins3: three. (line 521)
* mark: graph. (line 474)
* markangle: markers. (line 38)
* marker: graph. (line 474)
@@ -8866,64 +8952,65 @@ Index
* math: math. (line 6)
* mathematical functions: Mathematical functions.
(line 6)
-* max <1>: three. (line 433)
-* max <2>: Arrays. (line 231)
+* max <1>: three. (line 462)
+* max <2>: Arrays. (line 228)
* max <3>: Frames and pictures. (line 7)
-* max: Paths and guides. (line 260)
+* max: Paths and guides. (line 259)
* maxbound: Data types. (line 104)
-* maxtile: three. (line 180)
-* maxtimes: Paths and guides. (line 215)
-* maxviewport: three. (line 180)
-* merge: animation. (line 6)
+* maxtile: three. (line 205)
+* maxtimes: Paths and guides. (line 214)
+* maxviewport: three. (line 205)
* MetaPost: MetaPost. (line 6)
-* MetaPost ... : Tutorial. (line 176)
-* MetaPost cutafter: Paths and guides. (line 248)
-* MetaPost cutbefore: Paths and guides. (line 244)
+* MetaPost ... : Bezier curves. (line 67)
+* MetaPost cutafter: Paths and guides. (line 247)
+* MetaPost cutbefore: Paths and guides. (line 243)
* MetaPost pickup: Pens. (line 6)
* MetaPost whatever: MetaPost. (line 10)
* Microsoft Windows: Microsoft Windows. (line 6)
* MidArcArrow: draw. (line 26)
-* MidArcArrow3: three. (line 476)
+* MidArcArrow3: three. (line 505)
* MidArrow: draw. (line 26)
-* MidArrow3: three. (line 476)
-* midpoint: Paths and guides. (line 161)
+* MidArrow3: three. (line 505)
+* midpoint: Paths and guides. (line 160)
* MidPoint: label. (line 57)
-* min <1>: three. (line 433)
-* min <2>: Arrays. (line 224)
+* min <1>: three. (line 462)
+* min <2>: Arrays. (line 221)
* min <3>: Frames and pictures. (line 7)
-* min: Paths and guides. (line 256)
+* min: Paths and guides. (line 255)
* minbound: Data types. (line 101)
* minipage: label. (line 119)
-* mintimes: Paths and guides. (line 210)
-* miterjoin: Pens. (line 134)
-* miterlimit: Pens. (line 143)
-* mm: Tutorial. (line 63)
+* mintimes: Paths and guides. (line 209)
+* miterjoin: Pens. (line 135)
+* miterlimit: Pens. (line 144)
+* mm: Tutorial. (line 61)
+* mode: Files. (line 85)
* mouse: GUI. (line 6)
-* mouse bindings: three. (line 129)
-* Move: Pens. (line 335)
-* MoveQuiet: Pens. (line 341)
-* multisample: three. (line 119)
+* mouse bindings: three. (line 132)
+* Move: Pens. (line 336)
+* MoveQuiet: Pens. (line 342)
+* multisample: three. (line 122)
* multisampling: Compiling from UNIX source.
(line 16)
-* N: Tutorial. (line 94)
+* N: Tutorial. (line 104)
+* name: Files. (line 85)
* named arguments: Named arguments. (line 6)
-* new <1>: Arrays. (line 112)
+* new <1>: Arrays. (line 109)
* new: Structures. (line 6)
* newframe: Frames and pictures. (line 7)
* newl: Files. (line 59)
* newton: Mathematical functions.
(line 65)
* next: Debugger. (line 42)
-* NFSS: Pens. (line 188)
-* nobasealign: Pens. (line 164)
+* NFSS: Pens. (line 189)
+* nobasealign: Pens. (line 165)
* NoFill <1>: Frames and pictures. (line 141)
* NoFill: draw. (line 26)
* NoMargin: draw. (line 42)
-* NoMargin3: three. (line 492)
+* NoMargin3: three. (line 521)
* none: Files. (line 59)
* None: draw. (line 19)
-* normal: three. (line 419)
-* nosafe: Options. (line 144)
+* normal: three. (line 448)
+* nosafe: Options. (line 156)
* NOT: Arithmetic & logical.
(line 80)
* NoTicks: graph. (line 155)
@@ -8931,18 +9018,19 @@ Index
* null: Structures. (line 6)
* nullpen <1>: Frames and pictures. (line 127)
* nullpen: label. (line 14)
-* NURBS: three. (line 318)
-* O: three. (line 236)
+* NURBS: three. (line 346)
+* O: three. (line 262)
* obj: obj. (line 9)
-* oblique: three. (line 281)
-* obliqueX: three. (line 289)
-* obliqueY: three. (line 296)
-* obliqueZ: three. (line 281)
+* oblique: three. (line 307)
+* obliqueX: three. (line 315)
+* obliqueY: three. (line 322)
+* obliqueZ: three. (line 307)
* ode: ode. (line 9)
-* offset: Options. (line 148)
-* opacity: Pens. (line 218)
+* offset <1>: Options. (line 161)
+* offset: Pens. (line 112)
+* opacity: Pens. (line 219)
* open: Files. (line 11)
-* OpenGL: three. (line 119)
+* OpenGL: three. (line 122)
* operator: User-defined operators.
(line 6)
* operator --: graph. (line 31)
@@ -8957,92 +9045,94 @@ Index
* OR: Arithmetic & logical.
(line 80)
* orientation: Frames and pictures. (line 95)
-* orthographic: three. (line 300)
-* outformat: three. (line 119)
+* orthographic: three. (line 326)
+* outformat: three. (line 122)
* outprefix: Frames and pictures. (line 83)
-* output <1>: Options. (line 128)
+* output <1>: Options. (line 140)
* output: Files. (line 36)
* OutTicks: graph3. (line 34)
* overloading functions: Functions. (line 44)
-* overwrite: Pens. (line 320)
+* overwrite: Pens. (line 321)
* P: Mathematical functions.
(line 48)
* pack: label. (line 102)
* packing: Rest arguments. (line 30)
* pair <1>: Data types. (line 41)
-* pair: Tutorial. (line 17)
-* pairs: Arrays. (line 248)
-* paperheight: Configuring. (line 62)
-* papertype: Configuring. (line 62)
-* paperwidth: Configuring. (line 62)
+* pair: Tutorial. (line 49)
+* pairs: Arrays. (line 245)
+* paperheight: Configuring. (line 61)
+* papertype: Configuring. (line 61)
+* paperwidth: Configuring. (line 61)
* parametric surface: graph3. (line 100)
* parametrized curve: graph. (line 626)
-* patch-dependent colors: three. (line 75)
+* patch-dependent colors: three. (line 76)
* path <1>: flowchart. (line 74)
* path <2>: three. (line 43)
* path: Paths and guides. (line 7)
+* path markers: graph. (line 474)
* path3: three. (line 6)
-* path[]: Tutorial. (line 197)
+* path[]: Tutorial. (line 132)
* patterns <1>: patterns. (line 6)
-* patterns: Pens. (line 234)
-* pdflatex: Options. (line 128)
+* patterns: Pens. (line 235)
+* pdflatex: Options. (line 140)
* pdfviewer: Configuring. (line 6)
-* pdfviewerOptions: Options. (line 116)
+* pdfviewerOptions: Options. (line 128)
* pen: Pens. (line 6)
* PenMargin: draw. (line 42)
-* PenMargin2: three. (line 492)
-* PenMargin3: three. (line 492)
+* PenMargin2: three. (line 521)
+* PenMargin3: three. (line 521)
* PenMargins: draw. (line 42)
-* PenMargins2: three. (line 492)
-* PenMargins3: three. (line 492)
+* PenMargins2: three. (line 521)
+* PenMargins3: three. (line 521)
* perpendicular: geometry. (line 6)
-* perspective: three. (line 318)
+* perspective: three. (line 346)
* picture: Frames and pictures. (line 35)
* picture alignment: Frames and pictures. (line 205)
-* piecewisestraight: Paths and guides. (line 82)
+* piecewisestraight: Paths and guides. (line 81)
* Pl: Mathematical functions.
(line 48)
* plain: plain. (line 6)
-* planar: three. (line 83)
-* plane: three. (line 263)
-* planeproject: three. (line 416)
-* point <1>: three. (line 433)
-* point: Paths and guides. (line 85)
+* planar: three. (line 84)
+* plane: three. (line 289)
+* planeproject: three. (line 445)
+* point <1>: three. (line 462)
+* point: Paths and guides. (line 84)
* polar: Data types. (line 119)
* polargraph: graph. (line 90)
* polygon: graph. (line 474)
* pop: Arrays. (line 39)
* Portrait: Frames and pictures. (line 95)
-* postcontrol <1>: three. (line 433)
-* postcontrol: Paths and guides. (line 130)
+* postcontrol <1>: three. (line 462)
+* postcontrol: Paths and guides. (line 129)
* postfix operators: Self & prefix operators.
(line 19)
* postscript: Frames and pictures. (line 267)
-* PostScript fonts: Pens. (line 206)
-* PostScript subpath: Tutorial. (line 197)
+* PostScript fonts: Pens. (line 207)
+* PostScript subpath: Tutorial. (line 132)
* pow10: Mathematical functions.
(line 6)
-* prc: three. (line 197)
-* precision: Files. (line 86)
-* precontrol <1>: three. (line 433)
-* precontrol: Paths and guides. (line 123)
+* prc: three. (line 223)
+* precision: Files. (line 89)
+* precontrol <1>: three. (line 462)
+* precontrol: Paths and guides. (line 122)
* prefix operators: Self & prefix operators.
(line 6)
* private: Structures. (line 6)
* programming: Programming. (line 6)
* pstoedit: PostScript to Asymptote.
(line 6)
+* psview: Microsoft Windows. (line 16)
* psviewer: Configuring. (line 6)
-* psviewerOptions: Options. (line 116)
-* pt: Tutorial. (line 63)
+* psviewerOptions: Options. (line 128)
+* pt: Tutorial. (line 61)
* public: Structures. (line 6)
* push: Arrays. (line 39)
-* python: Configuring. (line 27)
-* Python usage: Interactive mode. (line 58)
-* quadraticroots: Arrays. (line 311)
+* Python usage: Interactive mode. (line 61)
+* quadraticroots: Arrays. (line 308)
* quarticroots: math. (line 22)
* quit <1>: Debugger. (line 54)
-* quit: Interactive mode. (line 37)
+* quit <2>: Interactive mode. (line 40)
+* quit: Tutorial. (line 35)
* quote: Import. (line 119)
* quotient: Arithmetic & logical.
(line 6)
@@ -9050,19 +9140,17 @@ Index
* radialshade: fill. (line 49)
* radians: Mathematical functions.
(line 17)
-* radius <1>: three. (line 433)
-* radius: Paths and guides. (line 119)
+* radius <1>: three. (line 462)
+* radius: Paths and guides. (line 118)
* Rainbow: palette. (line 12)
* rand: Mathematical functions.
(line 39)
* randMax: Mathematical functions.
(line 39)
-* read1: Arrays. (line 386)
-* read2: Arrays. (line 386)
-* read3: Arrays. (line 386)
+* read: Arrays. (line 384)
* reading: Files. (line 11)
* reading string arrays: Arrays. (line 353)
-* readline: Files. (line 128)
+* readline: Files. (line 131)
* real: Data types. (line 33)
* realDigits: Data types. (line 33)
* realEpsilon: Data types. (line 33)
@@ -9073,24 +9161,24 @@ Index
* recursion: Functions. (line 88)
* reflect: Transforms. (line 51)
* Relative: label. (line 52)
-* relpoint: Paths and guides. (line 157)
-* reltime: Paths and guides. (line 153)
+* relpoint: Paths and guides. (line 156)
+* reltime: Paths and guides. (line 152)
* remainder: Mathematical functions.
(line 6)
-* rename: Files. (line 145)
-* render <1>: Options. (line 128)
-* render: three. (line 119)
+* rename: Files. (line 148)
+* render <1>: Options. (line 140)
+* render: three. (line 122)
* replace: Data types. (line 252)
-* resetdefaultpen: Pens. (line 349)
+* resetdefaultpen: Pens. (line 350)
* rest arguments: Rest arguments. (line 6)
* restore: Frames and pictures. (line 261)
* restricted: Structures. (line 6)
* return: Debugger. (line 48)
-* reverse <1>: three. (line 433)
-* reverse <2>: Arrays. (line 149)
-* reverse <3>: Paths and guides. (line 164)
+* reverse <1>: three. (line 462)
+* reverse <2>: Arrays. (line 146)
+* reverse <3>: Paths and guides. (line 163)
* reverse: Data types. (line 248)
-* rewind: Files. (line 86)
+* rewind: Files. (line 89)
* rfind: Data types. (line 229)
* rgb: Pens. (line 30)
* Riemann zeta function: Mathematical functions.
@@ -9098,58 +9186,60 @@ Index
* Right: graph. (line 277)
* RightSide: label. (line 62)
* RightTicks: graph. (line 155)
-* RightView: three. (line 340)
+* RightView: three. (line 369)
* Rotate: label. (line 37)
* Rotate(pair z): label. (line 40)
* round: Mathematical functions.
(line 26)
-* roundcap: Pens. (line 125)
+* roundcap: Pens. (line 126)
* roundedpath: roundedpath. (line 6)
-* roundjoin: Pens. (line 134)
+* roundjoin: Pens. (line 135)
* roundrectangle: flowchart. (line 62)
* RPM: UNIX binary distributions.
(line 6)
* runtime imports: Import. (line 101)
* Russian: unicode. (line 7)
-* S: Tutorial. (line 94)
-* safe: Options. (line 144)
+* S: Tutorial. (line 104)
+* safe: Options. (line 156)
* save: Frames and pictures. (line 258)
-* saveline: Files. (line 128)
-* scale: three. (line 395)
+* saveline: Files. (line 131)
+* scale: three. (line 424)
* Scale: graph. (line 688)
* scale <1>: graph. (line 672)
-* scale: Transforms. (line 39)
+* scale <2>: Transforms. (line 39)
+* scale: Pens. (line 112)
* Scale: label. (line 46)
-* scale3: three. (line 392)
+* scale3: three. (line 421)
* scaled graph: graph. (line 653)
* scientific graph: graph. (line 386)
-* scroll: Files. (line 102)
-* search: Arrays. (line 167)
+* scroll: Files. (line 105)
+* search: Arrays. (line 164)
* search paths: Search paths. (line 6)
* Seascape: Frames and pictures. (line 100)
* secondary axis: graph. (line 803)
* secondaryX: graph. (line 803)
* secondaryY: graph. (line 803)
* seconds: Data types. (line 299)
-* seek: Files. (line 86)
-* seekeof: Files. (line 86)
+* seek: Files. (line 89)
+* seekeof: Files. (line 89)
* segmentation fault: Help. (line 33)
* self operators: Self & prefix operators.
(line 6)
-* sequence: Arrays. (line 131)
-* settings <1>: Options. (line 101)
-* settings: Configuring. (line 21)
+* sequence: Arrays. (line 128)
+* settings <1>: Options. (line 113)
+* settings: Configuring. (line 23)
* sgn: Mathematical functions.
(line 26)
* shading: fill. (line 32)
-* shift <1>: three. (line 380)
+* shift <1>: three. (line 409)
* shift: Transforms. (line 27)
* Shift: label. (line 34)
* shiftless: Transforms. (line 53)
* shipout: Frames and pictures. (line 83)
-* showtarget: three. (line 300)
+* showtarget: three. (line 326)
* Si: Mathematical functions.
(line 48)
+* signedint: Files. (line 71)
* SimpleHead: draw. (line 26)
* simplex: simplex. (line 6)
* simpson: Mathematical functions.
@@ -9158,31 +9248,33 @@ Index
(line 20)
* sin: Mathematical functions.
(line 6)
-* single: Files. (line 71)
+* single precision: Files. (line 71)
+* singleint: Files. (line 71)
+* singlereal: Files. (line 71)
* sinh: Mathematical functions.
(line 6)
-* size <1>: Options. (line 128)
-* size <2>: three. (line 433)
+* size <1>: Options. (line 140)
+* size <2>: three. (line 462)
* size <3>: Frames and pictures. (line 43)
-* size: Paths and guides. (line 71)
-* size3: three. (line 225)
+* size: Paths and guides. (line 70)
+* size3: three. (line 251)
* slant: Transforms. (line 45)
* Slant: label. (line 43)
* sleep: Data types. (line 329)
-* slice: Paths and guides. (line 233)
+* slice: Paths and guides. (line 232)
* slices: Slices. (line 6)
* slide: slide. (line 6)
* slopefield: slopefield. (line 6)
* solid: Pens. (line 92)
* solids: solids. (line 9)
-* solve: Arrays. (line 265)
-* sort: Arrays. (line 190)
+* solve: Arrays. (line 262)
+* sort: Arrays. (line 187)
* Spline <1>: graph3. (line 100)
* Spline: graph. (line 34)
* split: Data types. (line 261)
* sqrt: Mathematical functions.
(line 6)
-* squarecap: Pens. (line 125)
+* squarecap: Pens. (line 126)
* srand: Mathematical functions.
(line 39)
* stack overflow <1>: Help. (line 33)
@@ -9194,157 +9286,155 @@ Index
* step: Debugger. (line 39)
* stickframe: markers. (line 16)
* stop: Debugger. (line 10)
-* straight: three. (line 433)
+* straight: three. (line 462)
* Straight: graph. (line 31)
-* straight: Paths and guides. (line 78)
+* straight: Paths and guides. (line 77)
* strftime: Data types. (line 291)
* string: Data types. (line 179)
* stroke: fill. (line 36)
-* strokepath: Paths and guides. (line 290)
+* strokepath: Paths and guides. (line 289)
* strptime: Data types. (line 299)
* struct: Structures. (line 6)
* structures: Structures. (line 6)
-* subpath <1>: three. (line 433)
-* subpath: Paths and guides. (line 167)
+* subpath <1>: three. (line 462)
+* subpath: Paths and guides. (line 166)
* subpictures: Frames and pictures. (line 103)
* substr: Data types. (line 244)
* Subversion: Subversion. (line 6)
-* sum: Arrays. (line 219)
-* superpath: Tutorial. (line 197)
-* Suppress: Pens. (line 327)
-* SuppressQuiet: Pens. (line 331)
+* sum: Arrays. (line 216)
+* superpath: Tutorial. (line 132)
+* Suppress: Pens. (line 328)
+* SuppressQuiet: Pens. (line 332)
* surface <1>: graph3. (line 100)
* surface: three. (line 47)
* SVN: Subversion. (line 6)
-* system <1>: Options. (line 144)
-* system: Files. (line 153)
+* system <1>: Options. (line 156)
+* system: Files. (line 156)
* syzygy: syzygy. (line 6)
* tab: Files. (line 59)
-* tab completion: Tutorial. (line 21)
+* tab completion: Tutorial. (line 35)
* Tan: Mathematical functions.
(line 20)
* tan: Mathematical functions.
(line 6)
* tanh: Mathematical functions.
(line 6)
-* target: three. (line 300)
-* tell: Files. (line 86)
+* target: three. (line 326)
+* tell: Files. (line 89)
* tension <1>: three. (line 6)
-* tension: Tutorial. (line 165)
-* tensionSpecifier: Paths and guides. (line 381)
+* tension: Bezier curves. (line 56)
+* tensionSpecifier: Paths and guides. (line 380)
* tensor product shading: fill. (line 74)
* tensorshade: fill. (line 74)
-* tex <1>: Options. (line 128)
+* tex <1>: Options. (line 140)
* tex: Frames and pictures. (line 274)
-* TeX fonts: Pens. (line 197)
+* TeX fonts: Pens. (line 198)
* TeX string: Data types. (line 179)
-* texcommand: Configuring. (line 68)
-* texdvicommand: Configuring. (line 68)
+* texcommand: Configuring. (line 67)
* TeXHead: draw. (line 26)
-* TeXHead3: three. (line 476)
+* TeXHead3: three. (line 505)
* texpath <1>: label. (line 116)
-* texpath: Configuring. (line 68)
+* texpath: Configuring. (line 67)
* texpreamble: Frames and pictures. (line 282)
* texreset: Frames and pictures. (line 285)
* textbook graph: graph. (line 361)
* tgz: UNIX binary distributions.
(line 6)
-* thick: three. (line 104)
-* thin: three. (line 104)
+* thick: three. (line 105)
+* thin: three. (line 105)
* this: Structures. (line 6)
* three: three. (line 6)
* tick: graph. (line 332)
* Ticks: graph. (line 155)
* ticks: graph. (line 155)
* tildeframe: markers. (line 26)
-* tile: Pens. (line 247)
-* tilings: Pens. (line 234)
+* tile: Pens. (line 248)
+* tilings: Pens. (line 235)
* time: Data types. (line 291)
-* times: Paths and guides. (line 202)
+* times: Paths and guides. (line 201)
* Top: graph. (line 131)
-* TopView: three. (line 340)
+* TopView: three. (line 369)
* trace: Debugger. (line 51)
* trailingzero: graph. (line 169)
-* transform <1>: three. (line 407)
+* transform <1>: three. (line 436)
* transform: Transforms. (line 6)
-* transform3: three. (line 376)
-* transparency: Pens. (line 218)
-* transpose: Arrays. (line 211)
+* transform3: three. (line 405)
+* transparency: Pens. (line 219)
+* transpose: Arrays. (line 208)
* tree: tree. (line 9)
* trembling: trembling. (line 6)
* triangle: geometry. (line 6)
* triangulate: contour. (line 156)
-* tridiagonal: Arrays. (line 268)
+* tridiagonal: Arrays. (line 265)
* trigonometric integrals: Mathematical functions.
(line 48)
* triple: Data types. (line 108)
* TrueMargin: draw. (line 42)
-* TrueMargin3: three. (line 492)
+* TrueMargin3: three. (line 521)
* tube <1>: tube. (line 6)
-* tube: three. (line 104)
+* tube: three. (line 105)
* tutorial: Tutorial. (line 6)
* typedef <1>: Functions. (line 36)
* typedef: Data types. (line 339)
-* undefined: Paths and guides. (line 264)
+* undefined: Paths and guides. (line 263)
* UnFill: Frames and pictures. (line 152)
* unfill: fill. (line 105)
* UnFill: draw. (line 26)
* unicode: unicode. (line 6)
-* uniform: Arrays. (line 158)
+* uniform: Arrays. (line 155)
* Uninstall: Uninstall. (line 6)
* unit: Data types. (line 78)
-* unitbox <1>: three. (line 269)
-* unitbox: Tutorial. (line 218)
-* unitcircle <1>: three. (line 236)
-* unitcircle: Tutorial. (line 110)
+* unitbox <1>: three. (line 295)
+* unitbox: Tutorial. (line 153)
+* unitcircle <1>: three. (line 262)
+* unitcircle: Tutorial. (line 126)
* unitrand: Mathematical functions.
(line 39)
* unitsize <1>: Frames and pictures. (line 64)
-* unitsize: Tutorial. (line 73)
+* unitsize: Tutorial. (line 84)
* UNIX binary distributions: UNIX binary distributions.
(line 6)
* unpacking: Rest arguments. (line 39)
* unravel: Import. (line 31)
-* up: three. (line 300)
+* up: three. (line 326)
* update: Files. (line 36)
* UpsideDown: Frames and pictures. (line 95)
* usepackage: Frames and pictures. (line 287)
-* user coordinates: Tutorial. (line 73)
+* user coordinates: Tutorial. (line 84)
* user-defined operators: User-defined operators.
(line 6)
* usleep: Data types. (line 332)
* variable initializers: Variable initializers.
(line 6)
* vectorfield: graph. (line 965)
-* vectorfield3: graph3. (line 156)
-* vectorization: Arrays. (line 325)
+* vectorfield3: graph3. (line 159)
+* vectorization: Arrays. (line 322)
* verbatim: Frames and pictures. (line 267)
-* vertex-dependent colors: three. (line 75)
+* vertex-dependent colors: three. (line 76)
* Vertical: flowchart. (line 74)
* viewportheight: LaTeX usage. (line 32)
-* viewportmargin: three. (line 228)
-* viewportsize: three. (line 228)
+* viewportmargin: three. (line 254)
+* viewportsize: three. (line 254)
* viewportwidth: LaTeX usage. (line 32)
-* views: three. (line 197)
+* views: three. (line 223)
* vim: Editing modes. (line 33)
* virtual functions: Structures. (line 189)
* void: Data types. (line 10)
-* W: Tutorial. (line 94)
-* whatever: Paths and guides. (line 228)
+* W: Tutorial. (line 104)
+* whatever: Paths and guides. (line 227)
* Wheel: palette. (line 22)
* wheel mouse: GUI. (line 6)
* while: Programming. (line 29)
* white-space string delimiter mode: Arrays. (line 353)
* width: LaTeX usage. (line 32)
-* windingnumber: Paths and guides. (line 264)
+* windingnumber: Paths and guides. (line 263)
* word: Arrays. (line 353)
-* write <1>: Arrays. (line 394)
+* write <1>: Arrays. (line 393)
* write: Files. (line 51)
-* X: three. (line 236)
-* xasy <1>: GUI. (line 6)
-* xasy: Configuring. (line 68)
+* X: three. (line 262)
+* xasy: GUI. (line 6)
* xaxis3: graph3. (line 7)
-* xelatex <1>: Options. (line 128)
+* xelatex <1>: Options. (line 140)
* xelatex: embed. (line 10)
* xequals: graph. (line 284)
* XEquals: graph. (line 270)
@@ -9355,14 +9445,14 @@ Index
* xoutput: Files. (line 71)
* xpart: Data types. (line 89)
* xscale: Transforms. (line 33)
-* xscale3: three. (line 383)
+* xscale3: three. (line 412)
* xtick: graph. (line 332)
* XYEquals: graph3. (line 20)
* XYZero: graph3. (line 20)
* XZEquals: graph3. (line 20)
* XZero: graph. (line 265)
* XZZero: graph3. (line 20)
-* Y <1>: three. (line 236)
+* Y <1>: three. (line 262)
* Y: Mathematical functions.
(line 6)
* yaxis3: graph3. (line 7)
@@ -9371,12 +9461,12 @@ Index
* ylimits: graph. (line 626)
* ypart: Data types. (line 92)
* yscale: Transforms. (line 36)
-* yscale3: three. (line 386)
+* yscale3: three. (line 415)
* ytick: graph. (line 332)
* YZEquals: graph3. (line 20)
* YZero: graph. (line 119)
* YZZero: graph3. (line 20)
-* Z: three. (line 236)
+* Z: three. (line 262)
* zaxis3: graph3. (line 7)
* zero_Ai: Mathematical functions.
(line 48)
@@ -9388,11 +9478,11 @@ Index
(line 48)
* zero_J: Mathematical functions.
(line 48)
-* zerowinding: Pens. (line 148)
+* zerowinding: Pens. (line 149)
* zeta: Mathematical functions.
(line 48)
* zpart: Data types. (line 161)
-* zscale3: three. (line 389)
+* zscale3: three. (line 418)
* |: Arithmetic & logical.
(line 62)
* ||: Arithmetic & logical.
@@ -9402,144 +9492,145 @@ Index

Tag Table:
Node: Top574
-Node: Description6760
-Node: Installation10175
-Node: UNIX binary distributions11223
-Node: MacOS X binary distributions12329
-Node: Microsoft Windows13277
-Node: Configuring14447
-Node: Search paths18640
-Node: Compiling from UNIX source19320
-Ref: multisampling19909
-Node: Editing modes22335
-Node: Subversion24535
-Node: Uninstall24996
-Node: Tutorial25346
-Ref: unitcircle29089
-Ref: Bezier29298
-Node: Drawing commands34357
-Node: draw36066
-Ref: arrows37214
-Node: fill42439
-Ref: gradient shading43483
-Node: clip47676
-Node: label48268
-Ref: Label48967
-Node: Programming54711
-Ref: array iteration55528
-Node: Data types56610
-Ref: format65507
-Node: Paths and guides68971
-Ref: circle69225
-Ref: arctime74570
-Ref: extension78435
-Node: Pens85118
-Ref: fillrule92263
-Ref: basealign93160
-Ref: transparency95985
-Ref: makepen99428
-Ref: overwrite100266
-Node: Transforms101476
-Node: Frames and pictures103267
-Ref: envelope104408
-Ref: size105491
-Ref: unitsize106478
-Ref: shipout107538
-Ref: filltype109846
-Ref: add112829
-Ref: add about113775
-Ref: tex116720
-Node: Files117594
-Ref: cd118559
-Ref: scroll122940
-Node: Variable initializers125983
-Node: Structures128278
-Node: Operators135620
-Node: Arithmetic & logical135934
-Node: Self & prefix operators137831
-Node: User-defined operators138619
-Node: Implicit scaling139530
-Node: Functions140093
-Ref: stack overflow142846
-Node: Default arguments143410
-Node: Named arguments144149
-Node: Rest arguments146311
-Node: Mathematical functions149121
-Node: Arrays153726
-Ref: sort160907
-Ref: tridiagonal163198
-Ref: solve164426
-Node: Slices168553
-Node: Casts172447
-Node: Import174413
-Node: Static179643
-Node: LaTeX usage182539
-Node: Base modules187980
-Node: plain190480
-Node: simplex191132
-Node: math191405
-Node: interpolate192504
-Node: geometry192783
-Node: trembling193387
-Node: stats193748
-Node: patterns194008
-Node: markers194244
-Node: tree196027
-Node: binarytree196215
-Node: drawtree196804
-Node: syzygy197008
-Node: feynman197282
-Node: roundedpath197557
-Node: animation197840
-Ref: animate198259
-Node: embed199398
-Node: slide201187
-Node: MetaPost201527
-Node: unicode202243
-Node: latin1203131
-Node: babel203499
-Node: labelpath203728
-Node: labelpath3204548
-Node: annotate204859
-Node: CAD205330
-Node: graph205640
-Ref: ticks212478
-Ref: pathmarkers225626
-Ref: marker226091
-Ref: markuniform226442
-Ref: errorbars228233
-Ref: automatic scaling232289
-Node: palette242922
-Ref: images243040
-Ref: image247211
-Ref: logimage247689
-Ref: penimage248495
-Node: three248939
-Ref: PostScript3D270300
-Node: obj271992
-Node: graph3272244
-Ref: GaussianSurface277205
-Node: grid3278290
-Node: solids279030
-Node: tube279978
-Node: flowchart282209
-Node: contour286708
-Node: contour3291737
-Node: slopefield292044
-Node: ode293481
-Node: Options293741
-Ref: configuration file298908
-Ref: settings298908
-Ref: convert299979
-Node: Interactive mode302738
-Ref: history304362
-Node: GUI305667
-Node: GUI Installation306170
-Node: GUI Usage307696
-Node: PostScript to Asymptote308599
-Node: Help309742
-Node: Debugger311469
-Node: Credits313254
-Node: Index314167
+Node: Description6833
+Node: Installation10334
+Node: UNIX binary distributions11387
+Node: MacOS X binary distributions12493
+Node: Microsoft Windows13377
+Ref: psview14087
+Node: Configuring15008
+Node: Search paths19228
+Node: Compiling from UNIX source20025
+Ref: multisampling20614
+Node: Editing modes23032
+Node: Subversion25464
+Node: Uninstall25927
+Node: Tutorial26277
+Ref: unitcircle30503
+Node: Drawing commands32484
+Node: draw34195
+Ref: arrows35343
+Node: fill40586
+Ref: gradient shading41630
+Node: clip45823
+Node: label46415
+Ref: Label47114
+Node: Bezier curves52839
+Node: Programming56416
+Ref: array iteration57230
+Node: Data types58312
+Ref: format67213
+Node: Paths and guides70677
+Ref: circle70931
+Ref: arctime76288
+Ref: extension80153
+Node: Pens86836
+Ref: fillrule94080
+Ref: basealign94977
+Ref: transparency97802
+Ref: makepen101245
+Ref: overwrite102083
+Node: Transforms103293
+Node: Frames and pictures105084
+Ref: envelope106225
+Ref: size107308
+Ref: unitsize108295
+Ref: shipout109355
+Ref: filltype111688
+Ref: add114657
+Ref: add about115603
+Ref: tex118548
+Node: Files119422
+Ref: cd120387
+Ref: scroll124856
+Node: Variable initializers127929
+Node: Structures130224
+Node: Operators137676
+Node: Arithmetic & logical137990
+Node: Self & prefix operators139887
+Node: User-defined operators140675
+Node: Implicit scaling141586
+Node: Functions142149
+Ref: stack overflow144902
+Node: Default arguments145466
+Node: Named arguments146205
+Node: Rest arguments148367
+Node: Mathematical functions151177
+Node: Arrays155782
+Ref: sort162842
+Ref: tridiagonal165133
+Ref: solve166361
+Node: Slices170558
+Node: Casts174451
+Node: Import176417
+Node: Static181647
+Node: LaTeX usage184543
+Node: Base modules189988
+Node: plain192488
+Node: simplex193140
+Node: math193413
+Node: interpolate194512
+Node: geometry194791
+Node: trembling195385
+Node: stats195736
+Node: patterns195996
+Node: markers196232
+Node: tree198015
+Node: binarytree198203
+Node: drawtree198792
+Node: syzygy198996
+Node: feynman199270
+Node: roundedpath199545
+Node: animation199828
+Ref: animate200245
+Node: embed201384
+Node: slide203173
+Node: MetaPost203513
+Node: unicode204229
+Node: latin1205117
+Node: babel205485
+Node: labelpath205714
+Node: labelpath3206534
+Node: annotate206845
+Node: CAD207316
+Node: graph207626
+Ref: ticks214450
+Ref: pathmarkers227558
+Ref: marker228023
+Ref: markuniform228374
+Ref: errorbars230165
+Ref: automatic scaling234221
+Node: palette244867
+Ref: images244985
+Ref: image249156
+Ref: logimage249634
+Ref: penimage250440
+Node: three250884
+Ref: PostScript3D273456
+Node: obj275148
+Node: graph3275400
+Ref: GaussianSurface280525
+Node: grid3281610
+Node: solids282350
+Node: tube283298
+Node: flowchart285533
+Node: contour290032
+Node: contour3295063
+Node: slopefield295370
+Node: ode296807
+Node: Options297067
+Ref: configuration file302880
+Ref: settings302880
+Ref: convert303975
+Node: Interactive mode306764
+Ref: history308429
+Node: GUI309734
+Node: GUI installation310237
+Node: GUI usage311375
+Node: PostScript to Asymptote312278
+Node: Help313034
+Node: Debugger314770
+Node: Credits316555
+Node: Index317468

End Tag Table
diff --git a/Master/texmf/doc/info/dir b/Master/texmf/doc/info/dir
index 8e4409e6811..f9e705da18b 100644
--- a/Master/texmf/doc/info/dir
+++ b/Master/texmf/doc/info/dir
@@ -40,6 +40,7 @@ TeX
* gftopk: (web2c)gftopk invocation. Generic to packed fonts.
* gftype: (web2c)gftype invocation. GF to human-readable text.
* kpsewhich: (kpathsea)Invoking kpsewhich. TeX file searching.
+* latex2man: (latex2man)Top. Convert man pages in LaTeX.
* makempx: (web2c)makempx invocation. MetaPost label typesetting.
* mf: (web2c)mf invocation. Creating typeface families.
* mft: (web2c)mft invocation. Prettyprinting Metafont source.
diff --git a/Master/texmf/doc/info/dvipng.info b/Master/texmf/doc/info/dvipng.info
index 0b9be7c8220..7e25b004068 100644
--- a/Master/texmf/doc/info/dvipng.info
+++ b/Master/texmf/doc/info/dvipng.info
@@ -1,5 +1,4 @@
-This is dvipng.info, produced by makeinfo version 4.12 from
-../../../TeXlive-svn/texk/dvipng/dvipng.texi.
+This is dvipng.info, produced by makeinfo version 4.13 from dvipng.texi.
INFO-DIR-SECTION TeX
START-INFO-DIR-ENTRY
@@ -16,7 +15,7 @@ dvipng
This manual documents dvipng, a program to translate a DVI (DeVice
Independent) file into PNG (Portable Network Graphics).
- This file documents dvipng version 1.11
+ This file documents dvipng version 1.12
Corrections or perhaps rewrites of sections are _very welcome_.
@@ -327,7 +326,7 @@ File: dvipng.info, Node: Option summary, Next: Option details, Up: Command-li
Here is a handy summary of the options; it is printed out when you run
dvipng with no arguments or with the standard `--help' option.
- This is ./dvipng 1.10 Copyright 2002-2008 Jan-Ake Larsson
+ This is ./dvipng 1.12 Copyright 2002-2008 Jan-Ake Larsson
Usage: ./dvipng [OPTION]... FILENAME[.dvi]
Options are chosen to be similar to dvips' options where possible:
@@ -1056,29 +1055,29 @@ Index

Tag Table:
-Node: Top330
-Node: Introduction1225
-Node: Installation3464
-Node: Prerequisites3811
-Node: Configure6301
-Node: Build/install8340
-Node: Installation outside the texmf tree8808
-Node: Advice for non-privileged users9515
-Node: Basic usage10523
-Node: Command-line options11650
-Node: Option summary12074
-Node: Option details14383
-Node: Graphics29762
-Node: Encapsulated PostScript30327
-Node: Bitmapped graphics31670
-Node: Color32870
-Node: Color specifications33258
-Node: Color specials34357
-Node: Diagnosing problems35769
-Node: Contact information36252
-Node: Debug options36993
-Node: Credits38028
-Node: Copying39190
-Node: Index39970
+Node: Top297
+Node: Introduction1192
+Node: Installation3431
+Node: Prerequisites3778
+Node: Configure6268
+Node: Build/install8307
+Node: Installation outside the texmf tree8775
+Node: Advice for non-privileged users9482
+Node: Basic usage10490
+Node: Command-line options11617
+Node: Option summary12041
+Node: Option details14350
+Node: Graphics29729
+Node: Encapsulated PostScript30294
+Node: Bitmapped graphics31637
+Node: Color32837
+Node: Color specifications33225
+Node: Color specials34324
+Node: Diagnosing problems35736
+Node: Contact information36219
+Node: Debug options36960
+Node: Credits37995
+Node: Copying39157
+Node: Index39937

End Tag Table
diff --git a/Master/texmf/doc/info/dvips.info b/Master/texmf/doc/info/dvips.info
index 681a6779397..007024dca84 100644
--- a/Master/texmf/doc/info/dvips.info
+++ b/Master/texmf/doc/info/dvips.info
@@ -1,6 +1,7 @@
-This is dvips.info, produced by makeinfo version 4.12 from dvips.texi.
+This is ../../../texk/dvipsk/dvips.info, produced by makeinfo version
+4.13 from ../../../texk/dvipsk/dvips.texi.
-This manual documents Dvips version 5.97 (July 2008), a program to
+This manual documents Dvips version 5.98 (September 2009), a program to
translate a DVI file into PostScript. You may freely use, modify
and/or distribute this file.
@@ -17,7 +18,7 @@ File: dvips.info, Node: Top, Next: Why Dvips, Up: (dir)
Dvips
*****
-This manual documents Dvips version 5.97 (July 2008), a program to
+This manual documents Dvips version 5.98 (September 2009), a program to
translate a DVI file into PostScript. You may freely use, modify
and/or distribute this file.
@@ -724,7 +725,8 @@ reversal, use `-r0'. Such options are marked with a trailing `*'.
`-G*'
Shift non-printing characters (ASCII 0-32, 127) to higher-numbered
- positions. This may be useful sometimes.
+ positions. This was useful to work around bugs in old versions of
+ Adobe's PDF reader. It's more likely to cause problems nowadays.
`-h NAME'
Prepend NAME as an additional header file, or, if NAME is `-',
@@ -930,13 +932,18 @@ reversal, use `-r0'. Such options are marked with a trailing `*'.
once for `landscape'.
- In general, you should not use any `-t' option when using a
- `papersize' special, as some LaTeX packages do, e.g.,
- `hyperref.sty'.
+ `papersize' special, which some LaTeX packages (e.g.,
+ `hyperref') insert.
- - The exception is when using a nonstandard paper size that is
+ - One exception is when using a nonstandard paper size that is
not already defined in `config.ps'; in this case, you need to
specify `-t unknown'.
+ - Another exception is when producing multi-page files for
+ further processing; use `-t nopaper' to omit any paper size
+ information in the output. (If you just have a single page
+ document, you can use `-E' to get pure EPSF output.)
+
`-T HSIZE,VSIZE'
Set the paper size to (HSIZE,VSIZE), a comma-separated pair of
dimensions such as `.1in,-.3cm' (*note papersize special::). It
@@ -1208,6 +1215,10 @@ There is no provision for continuation lines.
`F'
Run as a filter. Same as `-f', *note Option details::.
+`G*'
+ Shift low-numbered characters; obsolete. Same as `-G', *note
+ Option details::.
+
`h HEADER'
Prepend HEADER to output. Same as `h-', *note Option details::.
@@ -1475,24 +1486,24 @@ For example:
When Dvips has a paper format name given on the command line, it
looks for a match by the NAME; when it has a `papersize' special, it
looks for a match by dimensions. The best match found (from the paper
-size information in the configuration file) is used. If nothing
-matches, a warning is printed and the first paper size is used. The
-dimensions must match within 5bp. Landscape mode for all paper sizes
-is automatically supported.
+size information in the configuration file) is used. The dimensions
+must match within 5bp.
+
+ If nothing matches, a warning is printed and the first paper size
+with zero dimensions is used; this should be the `unknown' paper size
+definition mentioned below, resulting in the actual dimensions being
+used.
+
+ Landscape mode for all paper sizes is automatically supported.
If your printer has a command to set a special paper size, then give
dimensions of `0in 0in'; the PostScript code that sets the paper size
can refer to the dimensions the user requested as `hsize' and `vsize';
these will be macros defined in the PostScript that return the
-requested size in default PostScript units. Virtually all of the
-PostScript commands you use here are device-dependent and degrade the
-portability of the file; that is why the default first paper size entry
-should not send any PostScript commands down (although a structured
-comment or two would be okay). Also, some printers want
+requested size in default PostScript units. Also, some printers want
`BeginPaperSize' comments and paper size setting commands; others (such
as the NeXT) want `PaperSize' comments and they will handle setting the
-paper size. There is no solution I could find that works for both
-(except maybe specifying both).
+paper size. So paper size entries should typically specify both.
When using a paper size that is not already defined in `config.ps',
you probably want to say `-t unknown' on the command line; the
@@ -1500,6 +1511,11 @@ you probably want to say `-t unknown' on the command line; the
PostScript incantation to set the PostScript page size, as just
described.
+ If you want no paper size information in the output at all, use
+`-t nopaper'. This is useful with multi-page output that will be
+processed further. If you just have a single page document, you can
+use `-E' to get pure EPSF output.
+
The Perl 5 script `contrib/configs/mkdvipspapers' in the
distribution directory may help in determining appropriate paper size
definitions.
@@ -3332,24 +3348,11 @@ and constructs. Each line has the format:
For example, the line
rpstrn StoneInformal <StoneInformal.pfb
- causes Dvips to download `StoneInformal.pfb' if your document (just
-as if it were a header file, *note Header files::) uses the font
-`StoneInformal'.
-
- If the `j' config file or command-line option is enabled,
-`StoneInformal.pfb' will be "partially downloaded"--only those
-characters your document actually uses will be extracted and downloaded,
-and the remainder discarded. *Note Option details::.
-
- Filenames of fonts that are partially downloaded are surrounded by
-curly braces (`{...}') in the progress report Dvips writes to standard
-output. Wholly-downloaded fonts appear inside angle brackets
-(`<...>'), like other downloaded files.
-
- Adobe Multiple Master fonts, such as Minion, cannot be partially
-downloaded. To partially download in general, but avoid partial
-downloading for individual fonts, use `<<' instead `<':
- pmnr8r Minion <<Minion.pfb
+ causes Dvips to download `StoneInformal.pfb' (just as if it were a
+header file, *note Header files::) if the DVI file (or a virtual font,
+*note Virtual fonts::) references the TFM file `rpstrn'. The
+PostScript `/FontName' of the font defined inside the `pfb' file should
+be `StoneInformal'.
You can generate transformed fonts with a line like this:
rpstrc StoneInformal <StoneInformal.pfb ".8 ExtendFont"
@@ -3387,6 +3390,16 @@ conversion yourself. In addition, Dvips scans the font to determine its
memory usage, just as it does for other header files (*note Header
files::).
+ If the `j' config file or command-line option is enabled (as it is
+by default), `StoneInformal.pfb' will be "partially downloaded"--only
+those characters your document actually uses will be extracted and
+downloaded, and the remainder discarded. *Note Option details::.
+
+ Adobe Multiple Master fonts, such as Minion, cannot be partially
+downloaded. To partially download in general, but avoid partial
+downloading for individual fonts, use `<<' instead `<':
+ pmnr8r Minion <<Minion.pfb
+
Here is a brief summary of how `psfonts.map' is read:
1. If a line is empty or begins with a space, percent, asterisk,
@@ -3417,10 +3430,12 @@ files::).
verbatim at the appropriate point. (And the double quotes
beginning and ending the word are removed.)
- 7. Otherwise the word is a name. The first such name is the TFM file
- that a virtual font file can refer to. If there is a second name,
- it is used as the PostScript name; if there is only one name, it
- is used for both the TeX name and the PostScript name.
+ 7. Otherwise the word is a name. The first such name is the TFM file,
+ that either a DVI file or a virtual font file can refer to. If
+ there is a second name, it is used as the PostScript name and
+ should match what is defined in the downloaded file; if there is
+ only one name, it is used for both the TeX name and the PostScript
+ name.

@@ -3760,12 +3775,12 @@ Index
* Menu:
* ! special (literal PS header): Literal headers. (line 6)
-* ! starting output filename: Option details. (line 223)
+* ! starting output filename: Option details. (line 224)
* " special (literal PostScript): " special. (line 6)
* %%BoundingBox: Bounding box. (line 17)
* %%Page, and multi-page information: PostScript hooks. (line 37)
-* %%Page, not generating: Option details. (line 197)
-* %%Page, removing: Option details. (line 153)
+* %%Page, not generating: Option details. (line 198)
+* %%Page, removing: Option details. (line 154)
* %%Page, required by Ghostview: Ghostscript installation.
(line 17)
* %%VMusage: Headers and memory usage.
@@ -3773,9 +3788,9 @@ Index
* %*Font: Fonts in figures. (line 6)
* (atend), bounding box specification: Bounding box. (line 28)
* +PSMAPFILE: Configuration file commands.
- (line 101)
+ (line 105)
* -: Option details. (line 11)
-* - as output filename: Option details. (line 223)
+* - as output filename: Option details. (line 224)
* --help <1>: Option details. (line 15)
* --help: Option summary. (line 7)
* --version: Option details. (line 18)
@@ -3794,71 +3809,71 @@ Index
* -F: Option details. (line 110)
* -f: Option details. (line 98)
* -G: Option details. (line 117)
-* -h NAME: Option details. (line 121)
-* -i: Option details. (line 126)
-* -j for partial font downloading: Option details. (line 139)
-* -K: Option details. (line 153)
-* -k for cropmarks: Option details. (line 145)
-* -l [=]NUM: Option details. (line 162)
-* -M: Option details. (line 183)
-* -m: Option details. (line 171)
-* -mode: Option details. (line 174)
-* -mode MODE: Option details. (line 174)
-* -N: Option details. (line 197)
-* -n NUM: Option details. (line 194)
-* -noomega: Option details. (line 205)
+* -h NAME: Option details. (line 122)
+* -i: Option details. (line 127)
+* -j for partial font downloading: Option details. (line 140)
+* -K: Option details. (line 154)
+* -k for cropmarks: Option details. (line 146)
+* -l [=]NUM: Option details. (line 163)
+* -M: Option details. (line 184)
+* -m: Option details. (line 172)
+* -mode: Option details. (line 175)
+* -mode MODE: Option details. (line 175)
+* -N: Option details. (line 198)
+* -n NUM: Option details. (line 195)
+* -noomega: Option details. (line 206)
* -O: Afm2tfm options. (line 41)
-* -o NAME: Option details. (line 218)
-* -O X-OFFSET,Y-OFFSET: Option details. (line 235)
-* -p [=]NUM: Option details. (line 253)
-* -P PRINTER: Option details. (line 267)
+* -o NAME: Option details. (line 219)
+* -O X-OFFSET,Y-OFFSET: Option details. (line 236)
+* -p [=]NUM: Option details. (line 254)
+* -P PRINTER: Option details. (line 268)
* -p PS-ENC <1>: Afm2tfm options. (line 46)
* -p PS-ENC: Changing PostScript encodings.
(line 6)
-* -pp FIRST-LAST: Option details. (line 262)
-* -pp RANGE: Option details. (line 262)
+* -pp FIRST-LAST: Option details. (line 263)
+* -pp RANGE: Option details. (line 263)
* -PPRINTER, and config file searching: Configuration file searching.
(line 27)
-* -q: Option details. (line 286)
-* -R: Option details. (line 293)
-* -r: Option details. (line 290)
-* -s: Option details. (line 301)
-* -S NUM: Option details. (line 308)
+* -q: Option details. (line 287)
+* -R: Option details. (line 294)
+* -r: Option details. (line 291)
+* -s: Option details. (line 302)
+* -S NUM: Option details. (line 309)
* -s SLANT: Afm2tfm options. (line 51)
* -T ENC-FILE: Changing both encodings.
(line 6)
-* -T HSIZE,VSIZE: Option details. (line 332)
-* -t PAPERTYPE: Option details. (line 313)
+* -T HSIZE,VSIZE: Option details. (line 338)
+* -t PAPERTYPE: Option details. (line 314)
* -T PS-TEX-ENC: Afm2tfm options. (line 61)
* -t TEX-ENC <1>: Afm2tfm options. (line 56)
* -t TEX-ENC: Changing TeX encodings.
(line 6)
* -u: Afm2tfm options. (line 65)
-* -U: Option details. (line 347)
-* -u PSMAPFILE: Option details. (line 339)
-* -V: Option details. (line 358)
-* -v: Option details. (line 355)
+* -U: Option details. (line 353)
+* -u PSMAPFILE: Option details. (line 345)
+* -V: Option details. (line 364)
+* -v: Option details. (line 361)
* -V VPL-FILE: Afm2tfm options. (line 74)
* -v VPL-FILE: Afm2tfm options. (line 71)
-* -X NUM: Option details. (line 375)
-* -x NUM: Option details. (line 367)
-* -Y NUM: Option details. (line 382)
+* -X NUM: Option details. (line 381)
+* -x NUM: Option details. (line 373)
+* -Y NUM: Option details. (line 388)
* -z: Hypertext. (line 6)
-* -Z for compressing bitmap fonts: Option details. (line 391)
-* -z for recognizing hyperdvi: Option details. (line 385)
-* ..-relative filenames: Option details. (line 293)
+* -Z for compressing bitmap fonts: Option details. (line 397)
+* -z for recognizing hyperdvi: Option details. (line 391)
+* ..-relative filenames: Option details. (line 294)
* .afm Adobe metric files: Metric files. (line 26)
* .dvipsrc, searched for: Configuration file searching.
(line 14)
-* .enc extension for encoding vectors: psfonts.map. (line 55)
+* .enc extension for encoding vectors: psfonts.map. (line 42)
* .lpro long prologue files: Header files. (line 12)
* .mf Metafont source files: Glyph files. (line 30)
* .NNNpk packed font bitmaps: Glyph files. (line 35)
* .pfa extension required for partial downloading: psfonts.map.
- (line 59)
+ (line 46)
* .pfa printer font ascii files: Glyph files. (line 25)
* .pfb extension required for partial downloading: psfonts.map.
- (line 59)
+ (line 46)
* .pfb printer font binary files: Glyph files. (line 25)
* .pfm printer font metric files: Metric files. (line 49)
* .pl property list files: Metric files. (line 39)
@@ -3869,11 +3884,11 @@ Index
* 612 792 bounding box size: Bounding box. (line 43)
* 8r encoding, and extra characters: Changing PostScript encodings.
(line 24)
-* 8r font encoding: psfonts.map. (line 44)
+* 8r font encoding: psfonts.map. (line 31)
* 8r.enc: Encodings. (line 35)
* < font downloading: psfonts.map. (line 11)
-* << whole font downloading: psfonts.map. (line 27)
-* <[ encoding vector downloading: psfonts.map. (line 49)
+* << whole font downloading: psfonts.map. (line 60)
+* <[ encoding vector downloading: psfonts.map. (line 36)
* =: ligature operation: Encoding file format.
(line 59)
* @ paper size config command: Configuration file commands.
@@ -3901,15 +3916,15 @@ Index
(line 21)
* A ring, Scandinavian letter: Reencoding with Afm2tfm.
(line 32)
-* a3 papertype: Option details. (line 313)
+* a3 papertype: Option details. (line 314)
* a4 paper size: Config file paper sizes.
- (line 79)
-* a4 papertype: Option details. (line 313)
+ (line 84)
+* a4 papertype: Option details. (line 314)
* A4size paper size: Config file paper sizes.
- (line 87)
-* absolute filenames, disabling: Option details. (line 293)
-* absolute page number, and -l: Option details. (line 162)
-* absolute page number, and -p: Option details. (line 253)
+ (line 92)
+* absolute filenames, disabling: Option details. (line 294)
+* absolute page number, and -l: Option details. (line 163)
+* absolute page number, and -p: Option details. (line 254)
* accents, in wrong position: Reencoding with Afm2tfm.
(line 32)
* accents, wrong: Afm2tfm options. (line 17)
@@ -3936,7 +3951,7 @@ Index
* b config command (#copies): Configuration file commands.
(line 24)
* base: Hypertext specials. (line 57)
-* base encoding, recommended: psfonts.map. (line 44)
+* base encoding, recommended: psfonts.map. (line 31)
* base fonts: Virtual fonts. (line 24)
* bbfig: Bounding box. (line 37)
* before header, inserting code: Including headers from TeX.
@@ -3954,7 +3969,7 @@ Index
* bop-hook <1>: PostScript hooks. (line 11)
* bop-hook <2>: EPSF scaling. (line 75)
* bop-hook: Paper trays. (line 6)
-* bop-hook, and offset pages: Option details. (line 248)
+* bop-hook, and offset pages: Option details. (line 249)
* boundary character: Encoding file format.
(line 41)
* bounding box, comment for: Bounding box. (line 6)
@@ -3998,21 +4013,21 @@ Index
(line 13)
* comments, in encoding files: Encoding file format.
(line 20)
-* comments, removing included: Option details. (line 153)
+* comments, removing included: Option details. (line 154)
* compilation: Installation. (line 6)
* compressed PostScript: Dynamic creation of graphics.
(line 6)
-* compressing bitmap fonts: Option details. (line 391)
+* compressing bitmap fonts: Option details. (line 397)
* Computer Modern in PostScript: Hypertext caveats. (line 6)
* Computer Modern, encoding of: Encodings. (line 15)
* condensed fonts: Afm2tfm options. (line 37)
* config.proto: config.ps installation.
(line 15)
-* config.ps: Option details. (line 267)
+* config.ps: Option details. (line 268)
* config.ps installation: config.ps installation.
(line 6)
* config.ps paper sizes: Config file paper sizes.
- (line 79)
+ (line 84)
* config.ps, searched for: Configuration file searching.
(line 10)
* configuration file options: Configuration file commands.
@@ -4038,8 +4053,8 @@ Index
* copies, duplicated page bodies: Option details. (line 31)
* copies, uncollated: Option details. (line 41)
* Crayola crayon box: Color macro files. (line 16)
-* crop.pro: Option details. (line 145)
-* cropmarks: Option details. (line 145)
+* crop.pro: Option details. (line 146)
+* cropmarks: Option details. (line 146)
* current font, in PostScript: PostScript typesetting.
(line 35)
* D config command (dpi): Configuration file commands.
@@ -4051,25 +4066,25 @@ Index
* debugging: Diagnosing problems. (line 6)
* debugging options: Debug options. (line 6)
* default resolutions: Configuration file commands.
- (line 123)
+ (line 127)
* default_texsizes Make variable: Configuration file commands.
- (line 139)
+ (line 143)
* Deutsch, Peter: Ghostscript installation.
(line 6)
* device dependency, and virtual fonts: Configuration file commands.
- (line 162)
+ (line 166)
* dictionary, CharStrings: PostScript typesetting.
(line 51)
* dictionary, PostScript language: PostScript typesetting.
(line 35)
* dictionary, SDict: Literal headers. (line 6)
* dictionary, userdict: Header files. (line 21)
-* distillation, and -z: Option details. (line 385)
+* distillation, and -z: Option details. (line 391)
* distiller, for PDF files: Hypertext. (line 11)
* dot accent: Reencoding with Afm2tfm.
(line 32)
* double-sided printing: Option details. (line 37)
-* downloading fonts partially: psfonts.map. (line 17)
+* downloading fonts partially: psfonts.map. (line 55)
* downloading PostScript fonts: psfonts.map. (line 6)
* Doyle, Mark: Hypertext. (line 21)
* draft copies: PostScript hooks. (line 16)
@@ -4088,7 +4103,7 @@ Index
* DVIPSHEADERS: Environment variables.
(line 31)
* DVIPSHEADERS, overrides H: Configuration file commands.
- (line 47)
+ (line 51)
* DVIPSMAKEPK: Environment variables.
(line 35)
* DVIPSRC: Environment variables.
@@ -4096,7 +4111,7 @@ Index
* DVIPSSIZES: Environment variables.
(line 46)
* DVIPSSIZES, overrides R: Configuration file commands.
- (line 136)
+ (line 140)
* dynamic creation of graphics: Dynamic creation of graphics.
(line 6)
* e config command (maxdrift): Configuration file commands.
@@ -4134,7 +4149,7 @@ Index
* error messages from printer: Printer errors. (line 6)
* even pages only: Option details. (line 37)
* examples of literal PostScript: Literal examples. (line 6)
-* expanded fonts <1>: psfonts.map. (line 32)
+* expanded fonts <1>: psfonts.map. (line 19)
* expanded fonts <2>: Afm2tfm options. (line 37)
* expanded fonts: Special font effects.
(line 24)
@@ -4154,14 +4169,14 @@ Index
(line 6)
* failure, to print at all: No output. (line 6)
* fallback resolutions: Configuration file commands.
- (line 123)
+ (line 127)
* figures and fonts: Fonts in figures. (line 6)
* figures, natural size: EPSF macros. (line 38)
* figures, scaling: EPSF scaling. (line 6)
* filter, running as a: Option details. (line 98)
-* first page printed: Option details. (line 253)
+* first page printed: Option details. (line 254)
* font concepts: Font concepts. (line 6)
-* font generation, avoiding: Option details. (line 183)
+* font generation, avoiding: Option details. (line 184)
* fontinst: Invoking afm2tfm. (line 13)
* fonts, as header files: Including headers from TeX.
(line 13)
@@ -4183,6 +4198,8 @@ Index
(line 34)
* fonts, system PostScript: PostScript font installation.
(line 24)
+* G character shifting config command: Configuration file commands.
+ (line 44)
* gf files: Glyph files. (line 41)
* gftopk: Glyph files. (line 41)
* Ghostscript installation: Ghostscript installation.
@@ -4193,7 +4210,7 @@ Index
(line 17)
* glyph files: Glyph files. (line 6)
* GLYPHFONTS, overrides P: Configuration file commands.
- (line 110)
+ (line 114)
* GNU Ghostscript: Ghostscript installation.
(line 13)
* gnuplot: Dynamic creation of graphics.
@@ -4203,16 +4220,16 @@ Index
* gs installation: Ghostscript installation.
(line 6)
* gsave/grestore, and literal PS: Literal examples. (line 27)
-* gsftopk: Option details. (line 359)
+* gsftopk: Option details. (line 365)
* h header downloading config command: Configuration file commands.
- (line 44)
+ (line 48)
* H header path config command: Configuration file commands.
- (line 47)
+ (line 51)
* Hafner, Jim: Color. (line 6)
-* header file, downloading: Option details. (line 121)
+* header file, downloading: Option details. (line 122)
* header files, defined: Header files. (line 6)
* header path, defining: Configuration file commands.
- (line 47)
+ (line 51)
* header=FILE \special: Including headers from TeX.
(line 6)
* headers and memory usage: Headers and memory usage.
@@ -4231,18 +4248,18 @@ Index
* hscale (psfile special option): psfile special. (line 30)
* hsize (psfile special option): psfile special. (line 24)
* html specials: Hypertext. (line 6)
-* html specials, and -z: Option details. (line 385)
+* html specials, and -z: Option details. (line 391)
* http://www.win.tue.nl/~dickie/idvi: Hypertext. (line 21)
* http://xxx.lanl.gov/hypertex: Hypertext. (line 21)
* Hungarian umlaut: Reencoding with Afm2tfm.
(line 32)
-* hyperdvi extensions, enabling: Option details. (line 385)
+* hyperdvi extensions, enabling: Option details. (line 391)
* hypertext and bitmap fonts: Hypertext caveats. (line 6)
* hypertext caveats: Hypertext caveats. (line 6)
* hypertext specials: Hypertext specials. (line 6)
* hypertext support: Hypertext. (line 6)
* i config command (pages/section): Configuration file commands.
- (line 51)
+ (line 55)
* idvi Java DVI reader: Hypertext. (line 21)
* Illustrator, workaround for: Including graphics fails.
(line 10)
@@ -4265,31 +4282,31 @@ Index
* inverted output: Small or inverted. (line 6)
* invoking Dvips: Invoking Dvips. (line 6)
* j config command (partial font downloading): Configuration file commands.
- (line 55)
+ (line 59)
* Java DVI reader: Hypertext. (line 21)
* Jeffrey, Alan: Invoking afm2tfm. (line 13)
-* K config command (comment-removeal): Configuration file commands.
- (line 59)
+* K config command (comment-removal): Configuration file commands.
+ (line 63)
* kerning, defined: Metric files. (line 15)
* KPATHSEA_DEBUG: Environment variables.
(line 18)
* landscape orientation, defined: Paper size and landscape.
(line 11)
-* landscape papertype: Option details. (line 313)
+* landscape papertype: Option details. (line 314)
* landscape, as \special: papersize special. (line 16)
-* last page printed: Option details. (line 162)
+* last page printed: Option details. (line 163)
* last-resort font scaling, with DVIPSSIZES: Environment variables.
(line 47)
* last-resort scaling, with R: Configuration file commands.
- (line 123)
-* ledger papertype: Option details. (line 313)
-* legal papertype: Option details. (line 313)
+ (line 127)
+* ledger papertype: Option details. (line 314)
+* legal papertype: Option details. (line 314)
* letter paper size: Config file paper sizes.
- (line 79)
-* letter papertype: Option details. (line 313)
+ (line 84)
+* letter papertype: Option details. (line 314)
* letterhead tray: Paper trays. (line 10)
* letterSize paper size: Config file paper sizes.
- (line 87)
+ (line 92)
* ligature operations: Encoding file format.
(line 54)
* ligature, defined: Metric files. (line 15)
@@ -4304,26 +4321,26 @@ Index
* lly (psfile special option): psfile special. (line 42)
* long documents not printing: Long documents fail. (line 6)
* low characters, shifting: Option details. (line 117)
-* lpr spooler, MS-DOS emulation: Option details. (line 223)
+* lpr spooler, MS-DOS emulation: Option details. (line 224)
* Lucida, installing: PostScript font installation.
(line 10)
* m config command (available memory): Configuration file commands.
- (line 63)
+ (line 67)
* M config command (mf mode): Configuration file commands.
- (line 82)
+ (line 86)
* macros for color: Color macro files. (line 6)
* macros for epsf inclusion <1>: EPSF macros. (line 6)
* macros for epsf inclusion: \includegraphics. (line 6)
* magnification, DVI: EPSF scaling. (line 63)
-* magnification, overriding DVI: Option details. (line 367)
-* magnification, vertical: Option details. (line 378)
+* magnification, overriding DVI: Option details. (line 373)
+* magnification, vertical: Option details. (line 384)
* mailcap and hypertext: Hypertext specials. (line 53)
-* manual feed: Option details. (line 171)
+* manual feed: Option details. (line 172)
* maxdrift: Option details. (line 71)
-* maximum pages printed: Option details. (line 194)
-* media: Option details. (line 313)
+* maximum pages printed: Option details. (line 195)
+* media: Option details. (line 314)
* memory available: Configuration file commands.
- (line 63)
+ (line 67)
* memory of printer exhausted: Printer errors. (line 14)
* memory usage, and headers: Headers and memory usage.
(line 6)
@@ -4332,45 +4349,47 @@ Index
(line 104)
* Metafont ligature operations: Encoding file format.
(line 54)
-* Metafont mode, specifying: Option details. (line 174)
+* Metafont mode, specifying: Option details. (line 175)
* Metafont source files: Glyph files. (line 30)
* metric files: Metric files. (line 6)
-* Minion typeface family: psfonts.map. (line 27)
-* missfont.log: Option details. (line 183)
-* MISSFONT_LOG: Option details. (line 186)
+* Minion typeface family: psfonts.map. (line 60)
+* missfont.log: Option details. (line 184)
+* MISSFONT_LOG: Option details. (line 187)
* Mitsubishi Shinko CHC-S446i printer: No output. (line 14)
* mkdvipspapers: Config file paper sizes.
- (line 75)
-* mktexpk, avoiding: Option details. (line 183)
+ (line 80)
+* mktexpk, avoiding: Option details. (line 184)
* mktexpk, changing name: Environment variables.
(line 36)
-* mode name, specifying: Option details. (line 174)
+* mode name, specifying: Option details. (line 175)
* Monotype fonts: PostScript font installation.
(line 10)
* Monotype fonts, installing: PostScript font installation.
(line 19)
-* mtpk: Option details. (line 359)
-* multiple master fonts: psfonts.map. (line 27)
-* multiple output files: Option details. (line 126)
+* mtpk: Option details. (line 365)
+* multiple master fonts: psfonts.map. (line 60)
+* multiple output files: Option details. (line 127)
* multiple paper trays: Paper trays. (line 6)
* Murphy, Tim: Hypertext specials. (line 20)
* N EPS-disabling config command: Configuration file commands.
- (line 85)
+ (line 89)
* name: Hypertext specials. (line 41)
-* narrow fonts: psfonts.map. (line 32)
+* narrow fonts: psfonts.map. (line 19)
* no output at all: No output. (line 6)
* non-printing characters, shifting: Option details. (line 117)
* non-resident fonts: psfonts.map. (line 6)
+* nopaper, paper format for -t: Config file paper sizes.
+ (line 75)
* O config command (offset): Configuration file commands.
- (line 98)
+ (line 102)
* o config command (output file): Configuration file commands.
- (line 90)
+ (line 94)
* oblique fonts: Special font effects.
(line 6)
* octal character codes: Afm2tfm options. (line 41)
* odd pages only: Option details. (line 27)
-* offset pages: Option details. (line 235)
-* Omega extensions: Option details. (line 205)
+* offset pages: Option details. (line 236)
+* Omega extensions: Option details. (line 206)
* option, details of: Option details. (line 6)
* options, debugging: Debug options. (line 6)
* options, Dvips: Invoking Dvips. (line 6)
@@ -4383,20 +4402,20 @@ Index
* output file, sectioning of: Headers and memory usage.
(line 6)
* output file, setting: Configuration file commands.
- (line 90)
-* output files, multiple: Option details. (line 126)
+ (line 94)
+* output files, multiple: Option details. (line 127)
* output, inverted: Small or inverted. (line 6)
* output, none: No output. (line 6)
-* output, redirecting: Option details. (line 218)
+* output, redirecting: Option details. (line 219)
* output, too small: Small or inverted. (line 6)
* p config command (font aliases): Configuration file commands.
- (line 101)
+ (line 105)
* P config command (PK path): Configuration file commands.
- (line 110)
-* page range: Option details. (line 262)
-* page, first printed: Option details. (line 253)
-* page, last printed: Option details. (line 162)
-* pages, maximum printed: Option details. (line 194)
+ (line 114)
+* page range: Option details. (line 263)
+* page, first printed: Option details. (line 254)
+* page, last printed: Option details. (line 163)
+* pages, maximum printed: Option details. (line 195)
* PaintType: Special font effects.
(line 50)
* Pantone colors: Color macro files. (line 16)
@@ -4407,32 +4426,32 @@ Index
* paper size, general: Paper size and landscape.
(line 6)
* paper trays: Paper trays. (line 6)
-* paper type: Option details. (line 313)
+* paper type: Option details. (line 314)
* papersize special: papersize special. (line 6)
-* papersize special, and no -t: Option details. (line 313)
-* partial font downloading: psfonts.map. (line 17)
+* papersize special, and no -t: Option details. (line 314)
+* partial font downloading: psfonts.map. (line 55)
* PDF files, font quality: Hypertext caveats. (line 6)
* PDF files, making <1>: Hypertext. (line 11)
* PDF files, making: Ghostscript installation.
(line 6)
-* PDF files, option for: Option details. (line 385)
+* PDF files, option for: Option details. (line 391)
* pdfmark: Hypertext. (line 6)
* pfa files: Glyph files. (line 25)
* pfb files: Glyph files. (line 25)
-* pfb files, automatically unpacked: psfonts.map. (line 62)
+* pfb files, automatically unpacked: psfonts.map. (line 49)
* pfm files: Metric files. (line 49)
* Phaser printer, used for color calibration: Color device configuration.
(line 18)
-* physical page number, and -l: Option details. (line 162)
-* physical page number, and -p: Option details. (line 253)
+* physical page number, and -l: Option details. (line 163)
+* physical page number, and -p: Option details. (line 254)
* physical page number, and bop-hook: PostScript hooks. (line 26)
* pipes, not readable: Option details. (line 98)
* pk files: Glyph files. (line 35)
* PKFONTS, overrides P: Configuration file commands.
- (line 110)
+ (line 114)
* plotfile, ps subspecial: ps special. (line 30)
* pltotf: Metric files. (line 39)
-* popen for output: Option details. (line 223)
+* popen for output: Option details. (line 224)
* portrait orientation, defined: Paper size and landscape.
(line 11)
* positioning accuracy: Option details. (line 71)
@@ -4443,8 +4462,8 @@ Index
* PostScript encoding, changing: Changing PostScript encodings.
(line 6)
* PostScript font alias file <1>: Configuration file commands.
- (line 101)
-* PostScript font alias file: Option details. (line 339)
+ (line 105)
+* PostScript font alias file: Option details. (line 345)
* PostScript fonts: PostScript fonts. (line 6)
* PostScript fonts, installing: PostScript font installation.
(line 6)
@@ -4470,9 +4489,9 @@ Index
(line 15)
* printer errors: Printer errors. (line 6)
* printer memory: Configuration file commands.
- (line 63)
+ (line 67)
* printer memory exhausted: Printer errors. (line 14)
-* printer offset: Option details. (line 235)
+* printer offset: Option details. (line 236)
* PRINTER, and config file searching: Configuration file searching.
(line 36)
* PRINTER, avoided with -f: Option details. (line 98)
@@ -4490,43 +4509,43 @@ Index
(line 24)
* psheaderdir: Header files. (line 12)
* psi character missing: Hypertext caveats. (line 55)
-* pstopk: Option details. (line 359)
+* pstopk: Option details. (line 365)
* Q config command (quiet): Configuration file commands.
- (line 117)
+ (line 121)
* q config command (quiet): Configuration file commands.
- (line 117)
-* quiet operation: Option details. (line 286)
+ (line 121)
+* quiet operation: Option details. (line 287)
* r config command (page reversal): Configuration file commands.
- (line 120)
+ (line 124)
* R fallback resolution config command: Configuration file commands.
- (line 123)
+ (line 127)
* reencode/*.enc: Encodings. (line 35)
* reencoding: Reencoding with Afm2tfm.
(line 6)
-* reencoding PostScript fonts: psfonts.map. (line 37)
+* reencoding PostScript fonts: psfonts.map. (line 24)
* registered character, accessing: Changing PostScript encodings.
(line 18)
* remapping: Reencoding with Afm2tfm.
(line 6)
* resident fonts, different in different printers <1>: Configuration file commands.
- (line 101)
+ (line 105)
* resident fonts, different in different printers: Option details.
- (line 339)
-* resolution: Option details. (line 375)
+ (line 345)
+* resolution: Option details. (line 381)
* resolution, setting: Option details. (line 58)
-* reverse pagination: Option details. (line 290)
+* reverse pagination: Option details. (line 291)
* rhi (psfile special option): psfile special. (line 46)
* Rokicki, Tomas: Why Dvips. (line 68)
* rotate.tex: ps special. (line 34)
* rwi (psfile special option): psfile special. (line 46)
* S config command (pict path): Configuration file commands.
- (line 148)
+ (line 152)
* s config command (save/restore): Configuration file commands.
- (line 145)
+ (line 149)
* save/restore, and inverted output: Small or inverted. (line 6)
* save/restore, and literal PS: Literal examples. (line 27)
* save/restore, and specials: ps special. (line 6)
-* save/restore, generating global: Option details. (line 301)
+* save/restore, generating global: Option details. (line 302)
* scaleunit: psfile special. (line 67)
* scaling of figures: EPSF scaling. (line 6)
* scaling small caps: Afm2tfm options. (line 33)
@@ -4540,15 +4559,15 @@ Index
(line 6)
* sections of output file, and memory: Headers and memory usage.
(line 6)
-* sections output, in separate files: Option details. (line 126)
-* security: Option details. (line 293)
-* shell command execution, disabling: Option details. (line 293)
+* sections output, in separate files: Option details. (line 127)
+* security: Option details. (line 294)
+* shell command execution, disabling: Option details. (line 294)
* shell escape, in config file: Configuration file commands.
(line 33)
* Shinko CHC-S446i printer: No output. (line 14)
* show PostScript operator: PostScript typesetting.
(line 23)
-* silent operation: Option details. (line 286)
+* silent operation: Option details. (line 287)
* simplex mode on duplex printers: Including headers from the command line.
(line 13)
* slanted fonts: Special font effects.
@@ -4567,21 +4586,21 @@ Index
* specials, hypertext: Hypertext specials. (line 6)
* splines: Glyph files. (line 17)
* spooler, lacking: Option details. (line 110)
-* spooling to lpr on MS-DOS: Option details. (line 223)
+* spooling to lpr on MS-DOS: Option details. (line 224)
* standard I/O: Option details. (line 98)
* standard input, reading options from: Option details. (line 11)
-* standard output, output to: Option details. (line 218)
+* standard output, output to: Option details. (line 219)
* standard PostScript, required by Ghostview: Ghostscript installation.
(line 17)
* start-hook: PostScript hooks. (line 11)
-* structured comments: Option details. (line 197)
+* structured comments: Option details. (line 198)
* system in config file: Configuration file commands.
(line 33)
* T config command (TFM path): Configuration file commands.
- (line 153)
+ (line 157)
* Tektronix Phaser printer, used for color calibration: Color device configuration.
(line 18)
-* testpage.tex: Option details. (line 242)
+* testpage.tex: Option details. (line 243)
* TeX encoding, changing: Changing TeX encodings.
(line 6)
* TeX, including headers in: Including headers from TeX.
@@ -4589,13 +4608,13 @@ Index
* TEXCONFIG: Environment variables.
(line 55)
* TEXFONTS, overrides P: Configuration file commands.
- (line 110)
+ (line 114)
* TEXFONTS, overrides T: Configuration file commands.
- (line 153)
+ (line 157)
* TEXINPUTS, overrides S: Configuration file commands.
- (line 148)
+ (line 152)
* texmext.enc: Encodings. (line 35)
-* TEXMFOUTPUT: Option details. (line 186)
+* TEXMFOUTPUT: Option details. (line 187)
* texmital.enc: Encodings. (line 35)
* texmsym.enc <1>: Changing TeX encodings.
(line 16)
@@ -4603,15 +4622,15 @@ Index
* TEXPICTS: Environment variables.
(line 62)
* TEXPICTS, overrides S: Configuration file commands.
- (line 148)
+ (line 152)
* TEXPKS, overrides P: Configuration file commands.
- (line 110)
+ (line 114)
* TEXSIZES, overrides R: Configuration file commands.
- (line 136)
+ (line 140)
* text in figures, chopped off: EPSF clipping. (line 6)
* tfm files: Metric files. (line 31)
* TFMFONTS, overrides T: Configuration file commands.
- (line 153)
+ (line 157)
* tftopl: Metric files. (line 39)
* Theisen, Tim: Ghostscript installation.
(line 17)
@@ -4620,18 +4639,20 @@ Index
* trademark character, accessing: Changing PostScript encodings.
(line 18)
* trailing spaces, dropped: Hypertext caveats. (line 55)
-* TranScript: Option details. (line 197)
-* transforming downloaded fonts: psfonts.map. (line 32)
+* TranScript: Option details. (line 198)
+* transforming downloaded fonts: psfonts.map. (line 19)
* trouble: Diagnosing problems. (line 6)
* Type 1 fonts: Glyph files. (line 25)
* typesetting in PostScript: PostScript typesetting.
(line 6)
* U config command (Xerox 4045): Configuration file commands.
- (line 158)
+ (line 162)
* uncollated copies: Option details. (line 41)
* uncompressing PostScript: Dynamic creation of graphics.
(line 6)
* uniform resource locator: Hypertext specials. (line 20)
+* unknown, paper format for -t <1>: Config file paper sizes.
+ (line 69)
* unknown, paper format for -t: papersize special. (line 29)
* URL, definition: Hypertext specials. (line 27)
* URL, extended for TeX: Hypertext specials. (line 20)
@@ -4640,14 +4661,14 @@ Index
* user-definable colors: User-definable colors.
(line 6)
* userdict, and dictionary files: Header files. (line 21)
-* userdict, used for header files: Option details. (line 121)
+* userdict, used for header files: Option details. (line 122)
* V config command (vf path): Configuration file commands.
- (line 162)
+ (line 166)
* verbose EPSF processing: EPSF macros. (line 46)
* vf files: Virtual fonts. (line 16)
* virtual font expansion: Virtual fonts. (line 34)
* virtual font path: Configuration file commands.
- (line 162)
+ (line 166)
* virtual fonts: Virtual fonts. (line 6)
* virtual fonts, creating: Invoking afm2tfm. (line 13)
* VM exhausted: Printer errors. (line 14)
@@ -4660,104 +4681,104 @@ Index
* vscale (psfile special option): psfile special. (line 33)
* vsize (psfile special option): psfile special. (line 27)
* W config command (warning): Configuration file commands.
- (line 167)
+ (line 171)
* warning messages, defining: Configuration file commands.
- (line 167)
-* warnings, suppressing: Option details. (line 286)
-* whole font downloading: psfonts.map. (line 27)
-* wide fonts: psfonts.map. (line 32)
+ (line 171)
+* warnings, suppressing: Option details. (line 287)
+* whole font downloading: psfonts.map. (line 60)
+* wide fonts: psfonts.map. (line 19)
* X config command (horizontal resolution): Configuration file commands.
- (line 174)
-* Xerox 4045: Option details. (line 347)
+ (line 178)
+* Xerox 4045: Option details. (line 353)
* Y config command (vertical resolution): Configuration file commands.
- (line 177)
+ (line 181)
* Y&Y fonts, installing: PostScript font installation.
(line 19)
* Z config command (compression): Configuration file commands.
- (line 180)
+ (line 184)
* z config command (secure mode): Configuration file commands.
- (line 183)
-* | starting output filename: Option details. (line 223)
+ (line 187)
+* | starting output filename: Option details. (line 224)

Tag Table:
-Node: Top517
-Node: Why Dvips1261
-Node: Installation4709
-Node: config.ps installation5847
-Node: PostScript font installation8389
-Node: Ghostscript installation11263
-Node: Diagnosing problems12360
-Node: Debug options13455
-Node: No output14658
-Node: Small or inverted16126
-Node: Printer errors16845
-Node: Long documents fail18177
-Node: Including graphics fails18518
-Node: Invoking Dvips19756
-Node: Basic usage20347
-Node: Command-line options21331
-Node: Option summary21780
-Node: Option details23942
-Node: Environment variables42575
-Node: Config files45534
-Node: Configuration file searching46217
-Node: Configuration file commands49517
-Node: Paper size and landscape56534
-Node: papersize special58132
-Node: Config file paper sizes59541
-Node: Paper trays63613
-Node: Interaction with PostScript64947
-Node: PostScript figures65600
-Node: Bounding box66326
-Node: \includegraphics69697
-Node: EPSF macros71988
-Node: EPSF scaling73958
-Node: EPSF clipping76528
-Node: psfile special77170
-Node: Dynamic creation of graphics79563
-Node: Fonts in figures80881
-Node: Header files82541
-Node: Including headers from TeX83747
-Node: Including headers from the command line85781
-Node: Headers and memory usage86881
-Node: Literal PS87591
-Node: " special88173
-Node: ps special88914
-Node: Literal headers90412
-Node: PostScript hooks91127
-Node: Literal examples93217
-Node: Hypertext94669
-Node: Hypertext caveats96227
-Node: Hypertext specials100624
-Node: PostScript fonts103258
-Node: Font concepts104374
-Node: Metric files105541
-Node: Glyph files108367
-Node: Virtual fonts110723
-Node: Encodings112613
-Node: PostScript typesetting114995
-Node: Making a font available118077
-Node: Invoking afm2tfm123107
-Node: Changing font encodings124077
-Node: Changing TeX encodings124867
-Node: Changing PostScript encodings125967
-Node: Changing both encodings127311
-Node: Reencoding with Afm2tfm127984
-Node: Encoding file format131088
-Node: Special font effects135291
-Node: Afm2tfm options137554
-Node: psfonts.map140539
-Node: Color145263
-Node: Color macro files146307
-Node: User-definable colors149505
-Node: Color subtleties150780
-Node: Ted Turner152431
-Node: Color device configuration153656
-Node: Color support details156098
-Node: Color specifications156476
-Node: Color specials157879
-Node: Index160008
+Node: Top564
+Node: Why Dvips1313
+Node: Installation4761
+Node: config.ps installation5899
+Node: PostScript font installation8441
+Node: Ghostscript installation11315
+Node: Diagnosing problems12412
+Node: Debug options13507
+Node: No output14710
+Node: Small or inverted16178
+Node: Printer errors16897
+Node: Long documents fail18229
+Node: Including graphics fails18570
+Node: Invoking Dvips19808
+Node: Basic usage20399
+Node: Command-line options21383
+Node: Option summary21832
+Node: Option details23994
+Node: Environment variables42998
+Node: Config files45957
+Node: Configuration file searching46640
+Node: Configuration file commands49940
+Node: Paper size and landscape57053
+Node: papersize special58651
+Node: Config file paper sizes60060
+Node: Paper trays64215
+Node: Interaction with PostScript65549
+Node: PostScript figures66202
+Node: Bounding box66928
+Node: \includegraphics70299
+Node: EPSF macros72590
+Node: EPSF scaling74560
+Node: EPSF clipping77130
+Node: psfile special77772
+Node: Dynamic creation of graphics80165
+Node: Fonts in figures81483
+Node: Header files83143
+Node: Including headers from TeX84349
+Node: Including headers from the command line86383
+Node: Headers and memory usage87483
+Node: Literal PS88193
+Node: " special88775
+Node: ps special89516
+Node: Literal headers91014
+Node: PostScript hooks91729
+Node: Literal examples93819
+Node: Hypertext95271
+Node: Hypertext caveats96829
+Node: Hypertext specials101226
+Node: PostScript fonts103860
+Node: Font concepts104976
+Node: Metric files106143
+Node: Glyph files108969
+Node: Virtual fonts111325
+Node: Encodings113215
+Node: PostScript typesetting115597
+Node: Making a font available118679
+Node: Invoking afm2tfm123709
+Node: Changing font encodings124679
+Node: Changing TeX encodings125469
+Node: Changing PostScript encodings126569
+Node: Changing both encodings127913
+Node: Reencoding with Afm2tfm128586
+Node: Encoding file format131690
+Node: Special font effects135893
+Node: Afm2tfm options138156
+Node: psfonts.map141141
+Node: Color145873
+Node: Color macro files146917
+Node: User-definable colors150115
+Node: Color subtleties151390
+Node: Ted Turner153041
+Node: Color device configuration154266
+Node: Color support details156708
+Node: Color specifications157086
+Node: Color specials158489
+Node: Index160618

End Tag Table
diff --git a/Master/texmf/doc/info/fontname.info b/Master/texmf/doc/info/fontname.info
index ff1b5a430d8..14b93d87ea9 100644
--- a/Master/texmf/doc/info/fontname.info
+++ b/Master/texmf/doc/info/fontname.info
@@ -1,4 +1,4 @@
-This is fontname.info, produced by makeinfo version 4.11 from
+This is fontname.info, produced by makeinfo version 4.13 from
fontname.texi.
This document is in the public domain and may be used freely.
@@ -14,8 +14,8 @@ File: fontname.info, Node: Top, Next: Introduction, Up: (dir)
Filenames for TeX fonts
***********************
-This is Fontname, a naming scheme for (the base part of) external TeX
-font filenames. Last update 10 September 2005.
+This is the Fontname document, a naming scheme for (the base part of)
+external TeX font filenames. Last update 5 July 2009.
* Menu:
@@ -24,7 +24,6 @@ font filenames. Last update 10 September 2005.
* Long names:: A specification for long filenames.
* Font name lists:: Real fontnames for many existing fonts.
* Encodings:: Specifications for various encodings.
-* Font legalities:: Legal issues vary from country to country.
* General index:: Index.
--- The Detailed Node Listing ---
@@ -150,30 +149,25 @@ File: fontname.info, Node: References, Prev: History, Up: Introduction
Related files and distributions:
* The TeX Directory Structure (TDS) standard, available at
- (`ftp://tug.org/tex/tds' and `CTAN:/tds') specifies a directory
- tree for all TeX library files. The directory names given in
- *note Suppliers:: and *note Typefaces:: are intended to mesh with
- that standard.
+ (`http://tug.org/tds' and `CTAN:/tds') specifies a directory tree
+ for all TeX library files. The directory names given in *note
+ Suppliers:: and *note Typefaces:: are intended to mesh with that
+ standard.
* The `modes.mf' file (`ftp://tug.org/tex/modes.mf') contains
recommended mode names to use as directory names.
- * The PSfonts distribution (`CTAN:/fonts/psfonts') contains TeX
- support for many fonts, both commercially available and free.
-
- * The Fontinst distribution (`CTAN:/fonts/utilities/psfonts')
+ * The Fontinst distribution (`http://tug.org/applications/fontinst'
supports quite general creation of virtual fonts, named according
to the scheme given here.
- * The Dvips translator (original at
- `ftp://labrea.stanford.edu/pub/dvips*.tar.gz' and variation at
- `ftp://tug.org/tex/dvipsk.tar.gz') supports resident and
- downloadable PostScript fonts. Dvips was the first real
- application of Fontname 1. Dvips also includes Afm2tfm, another
+ * The Dvips translator (`http://tug.org/dvips') supports resident
+ and downloadable PostScript fonts. Dvips was the first place where
+ Fontname became widely known. Dvips also includes Afm2tfm, another
program that can create virtual fonts.
- * The Dviljk processor (`ftp://tug.org/tex/dviljk.tar.gz') contains
- TeX support for the fonts built into the LaserJet 4.
+ * The Dviljk processor (included in TeX Live) contains TeX support
+ for the fonts built into the LaserJet 4.
* `Designing New Typefaces with Metafont', by Richard Southall,
Stanford Computer Science Department Technical Report
@@ -187,13 +181,13 @@ File: fontname.info, Node: Filenames for fonts, Next: Long names, Prev: Intro
2 Filenames for fonts
*********************
-We must limit ourselves to eight character names, for compatibility with
-DOS filesystems and the ISO 9660 standard used for CD-ROM distribution.
-Names may consist of only the letters (monocase a-z), numerals (0-9),
-and underscore.
+In this scheme, names may consist of only the letters (monocase a-z),
+numerals (0-9), and underscore. Having two names which differ only in
+case is undesirable, since it results in clashes on common Windows
+filesystems.
- Here is the basic division of the eight characters (the spaces here
-are merely for readability):
+ Here is the basic scheme (the spaces here are merely for
+readability):
S TT W [V...] [N] [E] [DD]
@@ -223,11 +217,15 @@ E
DD
represents the design size (in decimal), and is omitted if the
font is linearly scaled. Mittelbach in `TUGboat' 13(1) proposes
- using hexadecimal or base-36 notation. I don't think the
- increased range makes up for the unreadability of the common sizes
- (e.g., 10pt fonts would have a suffix `a' (in hex), or `j' (in
- base 36)).
+ using hexadecimal or base-36 notation. In my opinion, the
+ increased range does not make up for the unreadability of the
+ common sizes (e.g., 10pt fonts would have a suffix `a' (in hex),
+ or `j' (in base 36)).
+
+ We used to try to limit font names to eight characters. This was
+never completely possible, and since DOS filesystems have become rare,
+it's no longer an issue.
The weight, variants, and width are probably all best taken from the
original name of the font, instead of trying to relate them to some
@@ -306,6 +304,7 @@ directory name, and comment.
u urw URW
v sil SIL
w wolfram Wolfram
+ y arkandis Arkandis Digital Foundry
z - bizarre (fontname is nonstandard)
- autofont Eddie Kohler's autofont program
- jknappen Joerg Knappen
@@ -371,7 +370,7 @@ supplier.
@c @mapfile{
@c email = "tex-fonts@tug.org",
-@c date = "21feb08",
+@c date = "22feb09",
@c url = "http://tug.org/fontname/typeface.map",
@c supported = "yes",
@c docstring = "Typeface abbreviations for the TeX Fontname scheme.",
@@ -605,6 +604,7 @@ im imago Imago
in industri Industria
io ionic Ionic b:News701BT
ip impressm Impressum
+ir Irianis IrianisADF
is italnos ItalianOldStyle
it italia Italia
iw ironwood Ironwood
@@ -863,6 +863,9 @@ ut utopia Utopia
uw usherwoo Usherwood
uy universi University
v0 vineta Vineta
+v1 venturissans VenturisSansADF
+v2 venturis2 VenturisADFNo2
+v3 venturissans2 VenturisSansADFNo2
va activa Activa
vc vectora Vectora
vd vandijck VanDijck
@@ -870,11 +873,13 @@ ve veraseri VeraSerif
vg visigoth Visigoth
vi victoria Victoria
vj veljovic Veljovic
+vl versaill Versailles
vm veramono VeraSansMono
vn verdana Verdana
-vl versaill Versailles
+vo venturisold VenturisOldADF
vr vagrnd VAGRounded
vs verasans VeraSans
+vt venturis VenturisADF
vv viva Viva
w0 weddingt WeddingT
w1 wiesbswi WiesbadenSwing
@@ -1192,7 +1197,7 @@ PostScript `Encoding' name.
obsolete [3=>7f] Fraction
obsolete [4 fax; now typeface `lx', Lucida Fax]
5 escape for (presently) phonetic encodings
- 6 escape for Cyrillic encodings [was `SemiSerif']
+ 6 escape for (mostly) Cyrillic encodings [was `SemiSerif']
7 escape for (mostly) 7-bit encodings
8 escape for (mostly) 8-bit encodings
9 escape for (presently) expert encodings [was oldstyle digits]
@@ -1232,6 +1237,7 @@ PostScript `Encoding' name.
6b Cyrillic part of ISO 8859-5, seven bits
6c T2C
6d Cyrillic CP866 encoding
+ 6g LGR Greek font encoding
6i ISO 8859-5
6k Cyrillic KOI8-R encoding
6m Cyrillic Macintosh encoding
@@ -1363,7 +1369,7 @@ benefit of DVI-reading programs in the same file. Comments start with
Besides allowing long names, this sort of mapping file has other
benefits. TeX source or DVI files can be more easily transported,
-because the font names in a particular file can be made work on every
+because the font names in a particular file can be made to work on every
system. Also, when combined with a consistent naming scheme, macros
could be written to access any of a number of fonts. Right now, each
font family has to have specialized macros written to deal with it.
@@ -11544,7 +11550,7 @@ accordingly:
uzdr Dingbats d050000l

-File: fontname.info, Node: Encodings, Next: Font legalities, Prev: Font name lists, Up: Top
+File: fontname.info, Node: Encodings, Next: General index, Prev: Font name lists, Up: Top
Appendix B Encodings
********************
@@ -12387,12 +12393,92 @@ File: fontname.info, Node: ec, Next: groff, Prev: dvips, Up: Encodings
B.5 `ec.enc': Cork encoding
===========================
+% @@psencodingfile@{
+% date = "6jul08",
+% filename = "ec.enc",
+% email = "tex-fonts@@tug.org",
+% docstring = "This is the EC (aka Cork aka T1) encoding vector
+% for 8-bit fonts to be used with TeX."
+% @}
+%
+% Names of the glyphs try to comply with:
+% Adobe Glyph List For New Fonts, ver. 1.6, 30 Januaury 2006
+% http://partners.adobe.com/public/developer/en/opentype/aglfn13.txt
+% but some exceptions are listed below.
+%
+% The following characters are not present in Unicode:
+% - /perthousandzero = used to compose /perthousand, /pertenthousand, ... out of /percent + this character
+% - Germandbls = now there is a related character in Unicode,
+% U+1E9E - LATIN CAPITAL LETTER SHARP S
+% but probably /S_S ligature name should be used instead
+%
+% The following two characters have different Unicode mappings than on the AGL:
+% - /tcedilla = U+0163 - LATIN SMALL LETTER T WITH CEDILLA
+% according to AGL it should be /tcommaaccent
+% - /Tcedilla = U+0162 - LATIN CAPITAL LETTER T WITH CEDILLA
+% according to AGL it should be /Tcommaaccent
+% But having /scedilla and /tcommaaccent mixed is even more ugly.
+%
+% The following characters are not present on the AGL:
+% - /dotlessj = U+0237 - LATIN SMALL LETTER DOTLESS J
+% - /cwm = U+200B - ZERO WIDTH SPACE
+% - /visiblespace = U+2423 - OPEN BOX
+%
+% The following ligatures are deprecated by recent AGL:
+% - /ff, /fi, /fl, /ffi, /ffl = /f_i and similar should have been used instead
+%
+% Special characters:
+% - /hyphen.alt = hanging hyphen char (half-width)
+% used when no micro-typographic extensions were available yet
+%
+% Other remarks:
+% - /Eth = U+00D0 - LATIN CAPITAL LETTER ETH
+% must also be used as /Dcroat
+% U+0110 - LATIN CAPITAL LETTER D WITH STROKE
+%
+% Misleading names and shapes of letters (that lead to different names in past)
+% - /lcaron = U+013E - LATIN SMALL LETTER L WITH CARON
+% /lquoteright
+% - /Lcaron = U+013D - LATIN CAPITAL LETTER L WITH CARON
+% /Lquoteright
+% - /dcaron = U+010F - LATIN SMALL LETTER D WITH CARON
+% /dquoteright
+% - /tcaron = U+0165 - LATIN SMALL LETTER T WITH CARON
+% /tquoteright
+% - /dcroat = U+0111 - LATIN SMALL LETTER D WITH STROKE
+% /dbar, /dmacron
+%
+% - /cwm - /bom, /zerowidthnobreakspace
+% - /underscore - /underline
+% - /hyphen.alt - /sfthyphen, /hyphen, /dash
+%
+%
+% Turkish & Romanian
+% --------------------
+% EC encoding has been defined to include /tcedilla and /scedilla.
+% For Turkish one needs /scedilla, while for Romanian one would need
+% "t with comma below" (/tcommaaccent) and "s with comma below" (/scommaaccent).
+% "t with cedilla" in not used in any language except in inferior
+% Romanian typography that can use cedillas instead of commas below.
+% AGL has a strange mapping as well.
%
-% This is the EC encoding.
+% Without adding an additional character, it is impossible to support both
+% languages at the same time, so EC is not really best choice for Romanians,
+% even though it can be "misused" if one replaces both /scedilla and /tcedilla
+% with /scommaaccent and /tcommaaccent.
%
-% These are the ligs and kerns in addition to those found in the
-% AFM file. (The only ligs in the Times-Roman.afm file are the
-% fi and fl ligatures.)
+% Characters that have been renamed in July 2008:
+% 0x18 /zeroinferior -> /perthousandzero
+% 0x20 U+2423 /visualspace -> /visiblespace (if font doesn't have it, use /space)
+% 0x7F U+002D /hyphen -> /hyphen.alt U+???
+% 0x8D U+014A /Ng -> /Eng
+% 0x9E U+0111 /dbar -> /dcroat
+% 0xAD U+014B /ng -> /eng
+% 0xB4 U+0165 /tquoteright -> /tcaron
+%
+% Although these ligatures and kerns are somewhat questionable to have
+% in an encoding file, they've been here forever, and they are
+% traditional in the TeX world, so we preserve them.
%
% LIGKERN space l =: lslash ; space L =: Lslash ;
% LIGKERN question quoteleft =: questiondown ; exclam quoteleft =: exclamdown ;
@@ -12414,60 +12500,263 @@ B.5 `ec.enc': Cork encoding
% LIGKERN comma comma =: quotedblbase ; less less =: guillemotleft ;
% LIGKERN greater greater =: guillemotright ;
%
-/ECEncoding [ % now 256 chars follow
-% 0x00
- /grave /acute /circumflex /tilde /dieresis /hungarumlaut /ring /caron
- /breve /macron /dotaccent /cedilla
- /ogonek /quotesinglbase /guilsinglleft /guilsinglright
-% 0x10
- /quotedblleft /quotedblright /quotedblbase /guillemotleft
- /guillemotright /endash /emdash /cwm
- /zeroinferior /dotlessi /dotlessj /ff /fi /fl /ffi /ffl
-% 0x20
- /visualspace /exclam /quotedbl /numbersign
- /dollar /percent /ampersand /quoteright
- /parenleft /parenright /asterisk /plus /comma /hyphen /period /slash
-% 0x30
- /zero /one /two /three /four /five /six /seven
- /eight /nine /colon /semicolon /less /equal /greater /question
-% 0x40
- /at /A /B /C /D /E /F /G /H /I /J /K /L /M /N /O
-% 0x50
- /P /Q /R /S /T /U /V /W
- /X /Y /Z /bracketleft /backslash /bracketright /asciicircum /underscore
-% 0x60
- /quoteleft /a /b /c /d /e /f /g /h /i /j /k /l /m /n /o
-% 0x70
- /p /q /r /s /t /u /v /w
- /x /y /z /braceleft /bar /braceright /asciitilde /hyphen
-% 0x80
- /Abreve /Aogonek /Cacute /Ccaron /Dcaron /Ecaron /Eogonek /Gbreve
- /Lacute /Lcaron /Lslash /Nacute /Ncaron /Ng /Ohungarumlaut /Racute
-% 0x90
- /Rcaron /Sacute /Scaron /Scedilla
- /Tcaron /Tcedilla /Uhungarumlaut /Uring
- /Ydieresis /Zacute /Zcaron /Zdotaccent /IJ /Idotaccent /dbar /section
-% 0xA0
- /abreve /aogonek /cacute /ccaron /dcaron /ecaron /eogonek /gbreve
- /lacute /lcaron /lslash /nacute /ncaron /ng /ohungarumlaut /racute
-% 0xB0
- /rcaron /sacute /scaron /scedilla
- /tquoteright /tcedilla /uhungarumlaut /uring
- /ydieresis /zacute /zcaron /zdotaccent /ij /exclamdown /questiondown /sterling
-% 0xC0
- /Agrave /Aacute /Acircumflex /Atilde /Adieresis /Aring /AE /Ccedilla
- /Egrave /Eacute /Ecircumflex /Edieresis
- /Igrave /Iacute /Icircumflex /Idieresis
-% 0xD0
- /Eth /Ntilde /Ograve /Oacute /Ocircumflex /Otilde /Odieresis /OE
- /Oslash /Ugrave /Uacute /Ucircumflex /Udieresis /Yacute /Thorn /Germandbls
-% 0xE0
- /agrave /aacute /acircumflex /atilde /adieresis /aring /ae /ccedilla
- /egrave /eacute /ecircumflex /edieresis
- /igrave /iacute /icircumflex /idieresis
-% 0xF0
- /eth /ntilde /ograve /oacute /ocircumflex /otilde /odieresis /oe
- /oslash /ugrave /uacute /ucircumflex /udieresis /yacute /thorn /germandbls
+/ECEncoding [ % now 256 chars follow
+/grave % 0x00 U+0060
+/acute % 0x01 U+00B4
+/circumflex % 0x02 U+02C6
+/tilde % 0x03 U+02DC
+/dieresis % 0x04 U+00A8
+/hungarumlaut % 0x05 U+02DD
+/ring % 0x06 U+02DA
+/caron % 0x07 U+02C7
+/breve % 0x08 U+02D8
+/macron % 0x09 U+00AF
+/dotaccent % 0x0A U+02D9
+/cedilla % 0x0B U+00B8
+/ogonek % 0x0C U+02DB
+/quotesinglbase % 0x0D U+201A
+/guilsinglleft % 0x0E U+2039
+/guilsinglright % 0x0F U+203A
+/quotedblleft % 0x10 U+201C
+/quotedblright % 0x11 U+201D
+/quotedblbase % 0x12 U+201E
+/guillemotleft % 0x13 U+00AB
+/guillemotright % 0x14 U+00BB
+/endash % 0x15 U+2013
+/emdash % 0x16 U+2014
+/cwm % 0x17 U+200B
+/perthousandzero % 0x18 ______
+/dotlessi % 0x19 U+0131
+/dotlessj % 0x1A U+0237
+/ff % 0x1B U+FB00
+/fi % 0x1C U+FB01
+/fl % 0x1D U+FB02
+/ffi % 0x1E U+FB03
+/ffl % 0x1F U+FB04
+/visiblespace % 0x20 U+2423
+/exclam % 0x21
+/quotedbl % 0x22
+/numbersign % 0x23
+/dollar % 0x24
+/percent % 0x25
+/ampersand % 0x26
+/quoteright % 0x27 U+2019
+/parenleft % 0x28
+/parenright % 0x29
+/asterisk % 0x2A
+/plus % 0x2B
+/comma % 0x2C
+/hyphen % 0x2D
+/period % 0x2E
+/slash % 0x2F
+/zero % 0x30
+/one % 0x31
+/two % 0x32
+/three % 0x33
+/four % 0x34
+/five % 0x35
+/six % 0x36
+/seven % 0x37
+/eight % 0x38
+/nine % 0x39
+/colon % 0x3A
+/semicolon % 0x3B
+/less % 0x3C
+/equal % 0x3D
+/greater % 0x3E
+/question % 0x3F
+/at % 0x40
+/A % 0x41
+/B % 0x42
+/C % 0x43
+/D % 0x44
+/E % 0x45
+/F % 0x46
+/G % 0x47
+/H % 0x48
+/I % 0x49
+/J % 0x4A
+/K % 0x4B
+/L % 0x4C
+/M % 0x4D
+/N % 0x4E
+/O % 0x4F
+/P % 0x50
+/Q % 0x51
+/R % 0x52
+/S % 0x53
+/T % 0x54
+/U % 0x55
+/V % 0x56
+/W % 0x57
+/X % 0x58
+/Y % 0x59
+/Z % 0x5A
+/bracketleft % 0x5B
+/backslash % 0x5C
+/bracketright % 0x5D
+/asciicircum % 0x5E
+/underscore % 0x5F
+/quoteleft % 0x60 U+2018
+/a % 0x61
+/b % 0x62
+/c % 0x63
+/d % 0x64
+/e % 0x65
+/f % 0x66
+/g % 0x67
+/h % 0x68
+/i % 0x69
+/j % 0x6A
+/k % 0x6B
+/l % 0x6C
+/m % 0x6D
+/n % 0x6E
+/o % 0x6F
+/p % 0x70
+/q % 0x71
+/r % 0x72
+/s % 0x73
+/t % 0x74
+/u % 0x75
+/v % 0x76
+/w % 0x77
+/x % 0x78
+/y % 0x79
+/z % 0x7A
+/braceleft % 0x7B
+/bar % 0x7C
+/braceright % 0x7D
+/asciitilde % 0x7E
+/hyphen.alt % 0x7F U+002D % U+????
+/Abreve % 0x80 U+0102
+/Aogonek % 0x81 U+0104
+/Cacute % 0x82 U+0106
+/Ccaron % 0x83 U+010C
+/Dcaron % 0x84 U+010E
+/Ecaron % 0x85 U+011A
+/Eogonek % 0x86 U+0118
+/Gbreve % 0x87 U+011E
+/Lacute % 0x88 U+0139
+/Lcaron % 0x89 U+013D
+/Lslash % 0x8A U+0141
+/Nacute % 0x8B U+0143
+/Ncaron % 0x8C U+0147
+/Eng % 0x8D U+014A
+/Ohungarumlaut % 0x8E U+0150
+/Racute % 0x8F U+0154
+/Rcaron % 0x90 U+0158
+/Sacute % 0x91 U+015A
+/Scaron % 0x92 U+0160
+/Scedilla % 0x93 U+015E
+/Tcaron % 0x94 U+0164
+/Tcedilla % 0x95 U+0162
+/Uhungarumlaut % 0x96 U+0170
+/Uring % 0x97 U+016E
+/Ydieresis % 0x98 U+0178
+/Zacute % 0x99 U+0179
+/Zcaron % 0x9A U+017D
+/Zdotaccent % 0x9B U+017B
+/IJ % 0x9C U+0132
+/Idotaccent % 0x9D U+0130
+/dcroat % 0x9E U+0111
+/section % 0x9F U+00A7
+/abreve % 0xA0 U+0103
+/aogonek % 0xA1 U+0105
+/cacute % 0xA2 U+0107
+/ccaron % 0xA3 U+010D
+/dcaron % 0xA4 U+010F
+/ecaron % 0xA5 U+011B
+/eogonek % 0xA6 U+0119
+/gbreve % 0xA7 U+011F
+/lacute % 0xA8 U+013A
+/lcaron % 0xA9 U+013E
+/lslash % 0xAA U+0142
+/nacute % 0xAB U+0144
+/ncaron % 0xAC U+0148
+/eng % 0xAD U+014B
+/ohungarumlaut % 0xAE U+0151
+/racute % 0xAF U+0155
+/rcaron % 0xB0 U+0159
+/sacute % 0xB1 U+015B
+/scaron % 0xB2 U+0161
+/scedilla % 0xB3 U+015F
+/tcaron % 0xB4 U+0165
+/tcedilla % 0xB5 U+0163
+/uhungarumlaut % 0xB6 U+0171
+/uring % 0xB7 U+016F
+/ydieresis % 0xB8 U+00FF
+/zacute % 0xB9 U+017A
+/zcaron % 0xBA U+017E
+/zdotaccent % 0xBB U+017C
+/ij % 0xBC U+0133
+/exclamdown % 0xBD U+00A1
+/questiondown % 0xBE U+00BF
+/sterling % 0xBF U+00A3
+/Agrave % 0xC0
+/Aacute % 0xC1
+/Acircumflex % 0xC2
+/Atilde % 0xC3
+/Adieresis % 0xC4
+/Aring % 0xC5
+/AE % 0xC6
+/Ccedilla % 0xC7
+/Egrave % 0xC8
+/Eacute % 0xC9
+/Ecircumflex % 0xCA
+/Edieresis % 0xCB
+/Igrave % 0xCC
+/Iacute % 0xCD
+/Icircumflex % 0xCE
+/Idieresis % 0xCF
+/Eth % 0xD0
+/Ntilde % 0xD1
+/Ograve % 0xD2
+/Oacute % 0xD3
+/Ocircumflex % 0xD4
+/Otilde % 0xD5
+/Odieresis % 0xD6
+/OE % 0xD7 U+0152
+/Oslash % 0xD8
+/Ugrave % 0xD9
+/Uacute % 0xDA
+/Ucircumflex % 0xDB
+/Udieresis % 0xDC
+/Yacute % 0xDD
+/Thorn % 0xDE
+/Germandbls % 0xDF (U+1E9E, /S_S)
+/agrave % 0xE0
+/aacute % 0xE1
+/acircumflex % 0xE2
+/atilde % 0xE3
+/adieresis % 0xE4
+/aring % 0xE5
+/ae % 0xE6
+/ccedilla % 0xE7
+/egrave % 0xE8
+/eacute % 0xE9
+/ecircumflex % 0xEA
+/edieresis % 0xEB
+/igrave % 0xEC
+/iacute % 0xED
+/icircumflex % 0xEE
+/idieresis % 0xEF
+/eth % 0xF0
+/ntilde % 0xF1
+/ograve % 0xF2
+/oacute % 0xF3
+/ocircumflex % 0xF4
+/otilde % 0xF5
+/odieresis % 0xF6
+/oe % 0xF7 U+0153
+/oslash % 0xF8
+/ugrave % 0xF9
+/uacute % 0xFA
+/ucircumflex % 0xFB
+/udieresis % 0xFC
+/yacute % 0xFD
+/thorn % 0xFE
+/germandbls % 0xFF U+00DF
] def

@@ -14304,15 +14593,14 @@ B.12 `texnansi.enc'
From Y&Y.
% @psencodingfile{
+% date = "22apr09",
+% filename = "texnansi.enc",
+% email = "tex-fonts@tug.org",
% author = "Y&Y, Inc.",
% version = "1.1",
-% date = "1 December 1996",
-% filename = "texnansi.enc",
-% email = "help@YandY.com",
-% address = "45 Walden Street // Concord, MA 01742, USA",
% codetable = "ISO/ASCII",
-% checksum = "xx",
-% docstring = "Encoding for fonts in Adobe Type 1 format for use with TeX."
+% docstring = "texnansi (aka LY1) encoding vector for Type 1 fonts to
+% be used with TeX, following ASCII and Windows ANSI."
% }
%
% The idea is to have all 228 characters normally included in Type 1 text
@@ -14357,268 +14645,271 @@ From Y&Y.
% into PFA form, to include the attached `texnansi.enc' encoding vector,
% and to then actually reencode the font based on that encoding vector.
%
+% Revised 2009 April 20 with doc changes only (Uni20AC -> uni20ac).
+% Revised 2009 March 9 with doc changes only.
% Revised 1996 June 1 by adding second position for `fl' to avoid Acrobat bug.
% Revised 1996 June 1 by adding second position for `fraction' for same reason.
-% Revised 1997 Oct 1 by adding cwm (used in boundary char TFM code)
-% Revised 1998 Mar 1 by adding Unicode for Euro character
+% Revised 1997 Oct 1 by adding cwm (used in boundary char TFM code).
+% Revised 1998 Mar 1 by adding Unicode for Euro character.
+% emacs-page
%
-/TeXnANSIEncoding [
-/.notdef % 0
-/Euro % /Uni20AC 1
-/.notdef % 2
-/.notdef % 3
-/fraction % 4
-/dotaccent % 5
-/hungarumlaut % 6
-/ogonek % 7
-/fl % 8
-/.notdef % /fraction % 9 not used (see 4), backward compatability only
-/cwm % 10 not used, except boundary char internally maybe
-/ff % 11
-/fi % 12
-/.notdef % /fl % 13 not used (see 8), backward compatability only
-/ffi % 14
-/ffl % 15
-/dotlessi % 16
-/dotlessj % 17
-/grave % 18
-/acute % 19
-/caron % 20
-/breve % 21
-/macron % 22
-/ring % 23
-/cedilla % 24
-/germandbls % 25
-/ae % 26
-/oe % 27
-/oslash % 28
-/AE % 29
-/OE % 30
-/Oslash % 31
-/space % 32 % /suppress in TeX text
-/exclam % 33
-/quotedbl % 34 % /quotedblright in TeX text
-/numbersign % 35
-/dollar % 36
-/percent % 37
-/ampersand % 38
-/quoteright % 39 % /quotesingle in ANSI
-/parenleft % 40
-/parenright % 41
-/asterisk % 42
-/plus % 43
-/comma % 44
-/hyphen % 45
-/period % 46
-/slash % 47
-/zero % 48
-/one % 49
-/two % 50
-/three % 51
-/four % 52
-/five % 53
-/six % 54
-/seven % 55
-/eight % 56
-/nine % 57
-/colon % 58
-/semicolon % 59
-/less % 60 % /exclamdown in Tex text
-/equal % 61
-/greater % 62 % /questiondown in TeX text
-/question % 63
-/at % 64
-/A % 65
-/B % 66
-/C % 67
-/D % 68
-/E % 69
-/F % 70
-/G % 71
-/H % 72
-/I % 73
-/J % 74
-/K % 75
-/L % 76
-/M % 77
-/N % 78
-/O % 79
-/P % 80
-/Q % 81
-/R % 82
-/S % 83
-/T % 84
-/U % 85
-/V % 86
-/W % 87
-/X % 88
-/Y % 89
-/Z % 90
-/bracketleft % 91
-/backslash % 92 % /quotedblleft in TeX text
-/bracketright % 93
-/circumflex % 94 % /asciicircum in ASCII
-/underscore % 95 % /dotaccent in TeX text
-/quoteleft % 96 % /grave accent in ANSI
-/a % 97
-/b % 98
-/c % 99
-/d % 100
-/e % 101
-/f % 102
-/g % 103
-/h % 104
-/i % 105
-/j % 106
-/k % 107
-/l % 108
-/m % 109
-/n % 110
-/o % 111
-/p % 112
-/q % 113
-/r % 114
-/s % 115
-/t % 116
-/u % 117
-/v % 118
-/w % 119
-/x % 120
-/y % 121
-/z % 122
-/braceleft % 123 % /endash in TeX text
-/bar % 124 % /emdash in TeX test
-/braceright % 125 % /hungarumlaut in TeX text
-/tilde % 126 % /asciitilde in ASCII
-/dieresis % 127 not used (see 168), use higher up instead
-/Lslash % 128 this position is unfortunate, but now too late to fix
-/quotesingle % 129
-/quotesinglbase % 130
-/florin % 131
-/quotedblbase % 132
-/ellipsis % 133
-/dagger % 134
-/daggerdbl % 135
-/circumflex % 136
-/perthousand % 137
-/Scaron % 138
-/guilsinglleft % 139
-/OE % 140
-/Zcaron % 141
-/asciicircum % 142
-/minus % 143
-/lslash % 144
-/quoteleft % 145
-/quoteright % 146
-/quotedblleft % 147
-/quotedblright % 148
-/bullet % 149
-/endash % 150
-/emdash % 151
-/tilde % 152
-/trademark % 153
-/scaron % 154
-/guilsinglright % 155
-/oe % 156
-/zcaron % 157
-/asciitilde % 158
-/Ydieresis % 159
-/nbspace % 160 % /space (no break space)
-/exclamdown % 161
-/cent % 162
-/sterling % 163
-/currency % 164
-/yen % 165
-/brokenbar % 166
-/section % 167
-/dieresis % 168
-/copyright % 169
-/ordfeminine % 170
-/guillemotleft % 171
-/logicalnot % 172
-/sfthyphen % 173 % /hyphen (hanging hyphen)
-/registered % 174
-/macron % 175
-/degree % 176
-/plusminus % 177
-/twosuperior % 178
-/threesuperior % 179
-/acute % 180
-/mu % 181
-/paragraph % 182
-/periodcentered % 183
-/cedilla % 184
-/onesuperior % 185
-/ordmasculine % 186
-/guillemotright % 187
-/onequarter % 188
-/onehalf % 189
-/threequarters % 190
-/questiondown % 191
-/Agrave % 192
-/Aacute % 193
-/Acircumflex % 194
-/Atilde % 195
-/Adieresis % 196
-/Aring % 197
-/AE % 198
-/Ccedilla % 199
-/Egrave % 200
-/Eacute % 201
-/Ecircumflex % 202
-/Edieresis % 203
-/Igrave % 204
-/Iacute % 205
-/Icircumflex % 206
-/Idieresis % 207
-/Eth % 208
-/Ntilde % 209
-/Ograve % 210
-/Oacute % 211
-/Ocircumflex % 212
-/Otilde % 213
-/Odieresis % 214
-/multiply % 215 % OE in T1
-/Oslash % 216
-/Ugrave % 217
-/Uacute % 218
-/Ucircumflex % 219
-/Udieresis % 220
-/Yacute % 221
-/Thorn % 222
-/germandbls % 223
-/agrave % 224
-/aacute % 225
-/acircumflex % 226
-/atilde % 227
-/adieresis % 228
-/aring % 229
-/ae % 230
-/ccedilla % 231
-/egrave % 232
-/eacute % 233
-/ecircumflex % 234
-/edieresis % 235
-/igrave % 236
-/iacute % 237
-/icircumflex % 238
-/idieresis % 239
-/eth % 240
-/ntilde % 241
-/ograve % 242
-/oacute % 243
-/ocircumflex % 244
-/otilde % 245
-/odieresis % 246
-/divide % 247 % oe in T1
-/oslash % 248
-/ugrave % 249
-/uacute % 250
-/ucircumflex % 251
-/udieresis % 252
-/yacute % 253
-/thorn % 254
-/ydieresis % 255 % germandbls in T1
+/TeXnANSIEncoding [ % now 256 chars follow
+/.notdef % 0x00 0
+/Euro % 0x01 1 /uni20AC
+/.notdef % 0x02 2
+/.notdef % 0x03 3
+/fraction % 0x04 4
+/dotaccent % 0x05 5
+/hungarumlaut % 0x06 6
+/ogonek % 0x07 7
+/fl % 0x08 8
+/.notdef % 0x09 9 /fraction at 4, backward compatibility only
+/cwm % 0x0A 10 not used, except boundary char internally
+/ff % 0x0B 11
+/fi % 0x0C 12
+/.notdef % 0x0D 13 /fl at 8, backward compatibility only
+/ffi % 0x0E 14
+/ffl % 0x0F 15
+/dotlessi % 0x10 16
+/dotlessj % 0x11 17
+/grave % 0x12 18
+/acute % 0x13 19
+/caron % 0x14 20
+/breve % 0x15 21
+/macron % 0x16 22
+/ring % 0x17 23
+/cedilla % 0x18 24
+/germandbls % 0x19 25
+/ae % 0x1A 26
+/oe % 0x1B 27
+/oslash % 0x1C 28
+/AE % 0x1D 29
+/OE % 0x1E 30
+/Oslash % 0x1F 31
+/space % 0x20 32 /suppress in TeX text
+/exclam % 0x21 33
+/quotedbl % 0x22 34 /quotedblright in TeX text
+/numbersign % 0x23 35
+/dollar % 0x24 36
+/percent % 0x25 37
+/ampersand % 0x26 38
+/quoteright % 0x27 39 /quotesingle in ANSI
+/parenleft % 0x28 40
+/parenright % 0x29 41
+/asterisk % 0x2A 42
+/plus % 0x2B 43
+/comma % 0x2C 44
+/hyphen % 0x2D 45
+/period % 0x2E 46
+/slash % 0x2F 47
+/zero % 0x30 48
+/one % 0x31 49
+/two % 0x32 50
+/three % 0x33 51
+/four % 0x34 52
+/five % 0x35 53
+/six % 0x36 54
+/seven % 0x37 55
+/eight % 0x38 56
+/nine % 0x39 57
+/colon % 0x3A 58
+/semicolon % 0x3B 59
+/less % 0x3C 60 /exclamdown in Tex text
+/equal % 0x3D 61
+/greater % 0x3E 62 /questiondown in TeX text
+/question % 0x3F 63
+/at % 0x40 64
+/A % 0x41 65
+/B % 0x42 66
+/C % 0x43 67
+/D % 0x44 68
+/E % 0x45 69
+/F % 0x46 70
+/G % 0x47 71
+/H % 0x48 72
+/I % 0x49 73
+/J % 0x4A 74
+/K % 0x4B 75
+/L % 0x4C 76
+/M % 0x4D 77
+/N % 0x4E 78
+/O % 0x4F 79
+/P % 0x50 80
+/Q % 0x51 81
+/R % 0x52 82
+/S % 0x53 83
+/T % 0x54 84
+/U % 0x55 85
+/V % 0x56 86
+/W % 0x57 87
+/X % 0x58 88
+/Y % 0x59 89
+/Z % 0x5A 90
+/bracketleft % 0x5B 91
+/backslash % 0x5C 92 /quotedblleft in TeX text
+/bracketright % 0x5D 93
+/circumflex % 0x5E 94 /asciicircum in ASCII
+/underscore % 0x5F 95 /dotaccent in TeX text
+/quoteleft % 0x60 96 /grave accent in ANSI
+/a % 0x61 97
+/b % 0x62 98
+/c % 0x63 99
+/d % 0x64 100
+/e % 0x65 101
+/f % 0x66 102
+/g % 0x67 103
+/h % 0x68 104
+/i % 0x69 105
+/j % 0x6A 106
+/k % 0x6B 107
+/l % 0x6C 108
+/m % 0x6D 109
+/n % 0x6E 110
+/o % 0x6F 111
+/p % 0x70 112
+/q % 0x71 113
+/r % 0x72 114
+/s % 0x73 115
+/t % 0x74 116
+/u % 0x75 117
+/v % 0x76 118
+/w % 0x77 119
+/x % 0x78 120
+/y % 0x79 121
+/z % 0x7A 122
+/braceleft % 0x7B 123 /endash in TeX text
+/bar % 0x7C 124 /emdash in TeX test
+/braceright % 0x7D 125 /hungarumlaut in TeX text
+/tilde % 0x7E 126 /asciitilde in ASCII
+/dieresis % 0x7F 127 also at 168
+/Lslash % 0x80 128 position is unfortunate, but too late to fix
+/quotesingle % 0x81 129
+/quotesinglbase % 0x82 130
+/florin % 0x83 131
+/quotedblbase % 0x84 132
+/ellipsis % 0x85 133
+/dagger % 0x86 134
+/daggerdbl % 0x87 135
+/circumflex % 0x88 136
+/perthousand % 0x89 137
+/Scaron % 0x8A 138
+/guilsinglleft % 0x8B 139
+/OE % 0x8C 140
+/Zcaron % 0x8D 141
+/asciicircum % 0x8E 142
+/minus % 0x8F 143
+/lslash % 0x90 144
+/quoteleft % 0x91 145
+/quoteright % 0x92 146
+/quotedblleft % 0x93 147
+/quotedblright % 0x94 148
+/bullet % 0x95 149
+/endash % 0x96 150
+/emdash % 0x97 151
+/tilde % 0x98 152
+/trademark % 0x99 153
+/scaron % 0x9A 154
+/guilsinglright % 0x9B 155
+/oe % 0x9C 156
+/zcaron % 0x9D 157
+/asciitilde % 0x9E 158
+/Ydieresis % 0x9F 159
+/nbspace % 0xA0 160 no break space
+/exclamdown % 0xA1 161
+/cent % 0xA2 162
+/sterling % 0xA3 163
+/currency % 0xA4 164
+/yen % 0xA5 165
+/brokenbar % 0xA6 166
+/section % 0xA7 167
+/dieresis % 0xA8 168
+/copyright % 0xA9 169
+/ordfeminine % 0xAA 170
+/guillemotleft % 0xAB 171
+/logicalnot % 0xAC 172
+/sfthyphen % 0xAD 173 /hyphen (hanging hyphen)
+/registered % 0xAE 174
+/macron % 0xAF 175
+/degree % 0xB0 176
+/plusminus % 0xB1 177
+/twosuperior % 0xB2 178
+/threesuperior % 0xB3 179
+/acute % 0xB4 180
+/mu % 0xB5 181
+/paragraph % 0xB6 182
+/periodcentered % 0xB7 183
+/cedilla % 0xB8 184
+/onesuperior % 0xB9 185
+/ordmasculine % 0xBA 186
+/guillemotright % 0xBB 187
+/onequarter % 0xBC 188
+/onehalf % 0xBD 189
+/threequarters % 0xBE 190
+/questiondown % 0xBF 191
+/Agrave % 0xC0 192
+/Aacute % 0xC1 193
+/Acircumflex % 0xC2 194
+/Atilde % 0xC3 195
+/Adieresis % 0xC4 196
+/Aring % 0xC5 197
+/AE % 0xC6 198
+/Ccedilla % 0xC7 199
+/Egrave % 0xC8 200
+/Eacute % 0xC9 201
+/Ecircumflex % 0xCA 202
+/Edieresis % 0xCB 203
+/Igrave % 0xCC 204
+/Iacute % 0xCD 205
+/Icircumflex % 0xCE 206
+/Idieresis % 0xCF 207
+/Eth % 0xD0 208
+/Ntilde % 0xD1 209
+/Ograve % 0xD2 210
+/Oacute % 0xD3 211
+/Ocircumflex % 0xD4 212
+/Otilde % 0xD5 213
+/Odieresis % 0xD6 214
+/multiply % 0xD7 215 OE in T1
+/Oslash % 0xD8 216
+/Ugrave % 0xD9 217
+/Uacute % 0xDA 218
+/Ucircumflex % 0xDB 219
+/Udieresis % 0xDC 220
+/Yacute % 0xDD 221
+/Thorn % 0xDE 222
+/germandbls % 0xDF 223
+/agrave % 0xE0 224
+/aacute % 0xE1 225
+/acircumflex % 0xE2 226
+/atilde % 0xE3 227
+/adieresis % 0xE4 228
+/aring % 0xE5 229
+/ae % 0xE6 230
+/ccedilla % 0xE7 231
+/egrave % 0xE8 232
+/eacute % 0xE9 233
+/ecircumflex % 0xEA 234
+/edieresis % 0xEB 235
+/igrave % 0xEC 236
+/iacute % 0xED 237
+/icircumflex % 0xEE 238
+/idieresis % 0xEF 239
+/eth % 0xF0 240
+/ntilde % 0xF1 241
+/ograve % 0xF2 242
+/oacute % 0xF3 243
+/ocircumflex % 0xF4 244
+/otilde % 0xF5 245
+/odieresis % 0xF6 246
+/divide % 0xF7 247 oe in T1
+/oslash % 0xF8 248
+/ugrave % 0xF9 249
+/uacute % 0xFA 250
+/ucircumflex % 0xFB 251
+/udieresis % 0xFC 252
+/yacute % 0xFD 253
+/thorn % 0xFE 254
+/ydieresis % 0xFF 255 germandbls in T1
] def

@@ -14631,22 +14922,28 @@ From Y&Y. `texnansi' without repeats.
% @psencodingfile{
% author = "Y&Y, Inc.",
-% version = "1.2",
-% date = "1 December 1998",
-% filename = "texnansix.enc",
-% email = "support@YandY.com",
-% address = "45 Walden Street // Concord, MA 01742, USA",
+% version = "1.3",
+% date = "22apr09",
+% filename = "texnansx.enc",
+% email = "tex-fonts@tug.org",
% codetable = "ISO/ASCII",
-% checksum = "xx",
% docstring = "Encoding for fonts in Adobe Type 1 format for use with TeX."
% }
+% MODIFIED FOR AFM2TFM to avoid repeated encodings, namely these
+% positions have become .notdef:
%
-% MODIFIED FOR AFM2TFM to avoid repeated encodings...
+% 137/circumflex 141/OE 146/quoteleft 147/quoteright 153/tilde 157/oe
+% 169/dieresis 176/macron 181/acute 185/cedilla 199/AE 217/Oslash
+% 224/germandbls 231/ae 249/oslash
%
+% 22apr09 document the precise differences from texnansi.
+% 17aug08 change /Uni20AC (wrong capitalization of /Uni) to /Euro for
+% consistency with other encodings. tex-live mail from Vasile Gaburici,
+% 16 Aug 2008 20:44:08.
%
/TeXnANSIEncoding [
/.notdef % 0
-/Uni20AC % /Euro 1
+/Euro % /uni20AC 1
/.notdef % 2
/.notdef % 3
/fraction % 4
@@ -15564,82 +15861,7 @@ B.15 `xt2.enc': typewriter OT1 + ISO Latin 2 extended
% LIGKERN f {} f ; f {} i ; f {} l ;

-File: fontname.info, Node: Font legalities, Next: General index, Prev: Encodings, Up: Top
-
-Appendix C Font legalities
-**************************
-
-This section owes a great deal to Charles Bigelow (co-designer with Kris
-Holmes of the Lucida typeface family, among others), who has generously
-answered our many queries about fonts and the law around the world with
-remarkable patience and understanding. (But he is naturally not
-responsible for any errors here, much less our opinions.)
-
- Fonts have always been treated rather strangely under the law, as
-befits their rather strange nature: letterforms are indivisibly both
-_useful_ and _artistic_. In most countries--in all countries until
-recently--utility has taken precedence; i.e., it has been legal to copy
-fonts without permission or fee.
-
- In any case, to the best of my knowledge, the situation in those
-countries which have adopted any sort of typeface protection is as
-follows. This was originally written in the early 1990's; these days,
-the situation is probably different, due to widespread adoption of
-software patents, among other things, but I lack specific information
-to include.
-
-United States
- Typeface designs can be patented, but not copyrighted. Only a few
- designs have been patented. (Lucida and Stone are the only ones I
- know of. I don't know what the grounds were for patenting Stone,
- but Lucida had some novel features in its design which make it
- reasonable to patent, given the acceptance of the patent system in
- the first place.)
-
- Particular programs which instantiate a font can be copyrighted
- just as any other computer program can. This is arguably wrong,
- since font programs are nothing but a description of the shapes,
- possibly with some simple hints, and there's only one basic way to
- describe the shapes in any given language. Thus, the creativity
- lies in making the shape right, not in making the computer program
- right, so it would seem that to be consistent, the copyright laws
- should protect the design, not the program--the opposite of the
- current situation.
-
-Germany
- Typeface designs have been copyrightable as original works of art
- since 1981. As a result, many (perhaps most) designs have been
- copyrighted there. The law is not retroactive, but German courts
- have upheld the intellectual property rights of designers of
- earlier fonts as well: In one case the heirs of Paul Renner
- (designer of Futura) won a suit against the Bauer foundry for
- arbitrarily discontinuing a portion of their royalties.
-
-England
- A copyright law passed in 1989 covers typeface designs first
- published in England (or published in Britain within 30 days of
- its publication elsewhere), and it _is_ retroactive. It's unclear
- how far back the law extends, but Times Roman, designed in the
- late 1920's and 1930's by Stanley Morison is probably covered.
- This does not mean GNU (for example) cannot have a Times Roman; it
- just means we cannot start with an English version, as the law
- does not forbid importing foreign versions of English typefaces.
-
-France
- The Romain du Roi typeface designed by Philippe Grandjean in 1702
- for the French royal family is protected, and perhaps other such
- "royal" designs. There is no protection for designs in general.
-
-
- In 1973 the international Vienna treaty on typeface design protection
-was proposed. France ratified it in 1974 or 1975, and Germany in 1981.
-The English law might constitute ratification, but this has not been
-settled. In any case, since at least four countries have to ratify it
-before it takes effect (and even then it takes effect only in those
-countries which ratify it), it is still of no consequence for now.
-
-
-File: fontname.info, Node: General index, Prev: Font legalities, Up: Top
+File: fontname.info, Node: General index, Prev: Encodings, Up: Top
General index
*************
@@ -15666,18 +15888,15 @@ General index
* Beebe, Nelson: History. (line 30)
* Beeton, Barbara: History. (line 30)
* Bernstein, Rocky: History. (line 30)
-* Bigelow, Charles: Font legalities. (line 6)
* bitstrea.map: Bitstream fonts. (line 6)
* bizarre font names: Suppliers. (line 31)
* Bouche, Thierry: History. (line 30)
* bright variant: Variants. (line 28)
* bugs, reporting: Introduction. (line 12)
* category codes: Long naming scheme. (line 34)
-* CD-ROM distribution: Filenames for fonts. (line 6)
* character scaling, automatic: Widths. (line 13)
* compression: Widths. (line 6)
* contributors: History. (line 30)
-* copyright on fonts: Font legalities. (line 6)
* Cork encoding: ec. (line 6)
* CP-1251 encoding: 6w. (line 6)
* Cugley, Damian: History. (line 30)
@@ -15686,15 +15905,13 @@ General index
* Cyrillic fonts: Variants. (line 86)
* design size specification: Filenames for fonts. (line 40)
* distribution: Introduction. (line 16)
-* DOS filesystems: Filenames for fonts. (line 6)
* dtc.map: DTC fonts. (line 6)
-* Dviljk translator: References. (line 31)
+* Dviljk translator: References. (line 26)
* Dvips encoding: dvips. (line 6)
-* Dvips translator: References. (line 24)
+* Dvips translator: References. (line 21)
* dvips.enc: dvips. (line 6)
* EC encoding: ec. (line 6)
* ec.enc: ec. (line 6)
-* eight-character limitation: Filenames for fonts. (line 6)
* encoding files: Introduction. (line 16)
* encoding vectors: Encodings. (line 6)
* encoding, Dvips: dvips. (line 6)
@@ -15713,7 +15930,6 @@ General index
* encodings, texnansi: texnansi. (line 6)
* encodings, texnansx: texnansx. (line 6)
* encodings, unspecified: Variants. (line 67)
-* England, font design protection law: Font legalities. (line 52)
* Ertner, Vincent: URW fonts. (line 6)
* escape for nonstandard names: Suppliers. (line 31)
* expansion: Widths. (line 6)
@@ -15723,30 +15939,23 @@ General index
* extension, TeX math encoding: texmext. (line 6)
* fax variant: Variants. (line 28)
* filenames, basics: Filenames for fonts. (line 11)
-* font copyrighting: Font legalities. (line 6)
* font scaling: Filenames for fonts. (line 40)
* font_coding_scheme: Long naming scheme. (line 30)
-* Fontinst distribution: References. (line 20)
+* Fontinst distribution: References. (line 17)
* FontName: Typefaces. (line 49)
* fontname mapping file: Name mapping file. (line 6)
* Fontname version 2: History. (line 14)
* foundries: Suppliers. (line 6)
-* France, font design protection law: Font legalities. (line 62)
-* Futura: Font legalities. (line 43)
* Garamond, versions of: Typefaces. (line 16)
-* Germany, font design protection law: Font legalities. (line 43)
-* Grandjean, Philippe: Font legalities. (line 62)
* Greek fonts: Variants. (line 86)
* Groff encoding: groff. (line 6)
* groff.enc: groff. (line 6)
* hexadecimal design size: Filenames for fonts. (line 40)
* history: History. (line 6)
-* Holmes, Kris: Font legalities. (line 6)
* Horn, Berthol: History. (line 30)
* individual font designers: Suppliers. (line 19)
* informal variant: Variants. (line 102)
* introduction: Introduction. (line 6)
-* ISO 9660: Filenames for fonts. (line 6)
* ISO Latin 2 extended and typewriter, TeX encoding: xt2. (line 6)
* ISO Latin 2 extended, TeX encoding: xl2. (line 6)
* italic, TeX math encoding: texmital. (line 6)
@@ -15755,10 +15964,8 @@ General index
* Knuth, Donald E.: Name mapping file. (line 28)
* Lang, Russell: History. (line 30)
* LaserJet 4 fonts: Variants. (line 67)
-* legalisms: Font legalities. (line 6)
* letterspacing: Variants. (line 17)
* ligatures and encodings: Variants. (line 53)
-* limitations: Filenames for fonts. (line 6)
* linotype.map: Linotype fonts. (line 6)
* long names: Long names. (line 6)
* long naming scheme: Long naming scheme. (line 6)
@@ -15766,7 +15973,6 @@ General index
* Lslash: Variants. (line 53)
* Lubalin, Herb: Suppliers. (line 9)
* Lucida Bright: 8r. (line 6)
-* Lucida, protection of: Font legalities. (line 25)
* MacKay, Pierre: History. (line 30)
* mapping file: Name mapping file. (line 6)
* mapping files: Introduction. (line 16)
@@ -15779,27 +15985,22 @@ General index
* Mittelbach, Frank: History. (line 6)
* modes.mf: References. (line 14)
* monotype.map: Monotype fonts. (line 6)
-* Morison, Stanley: Font legalities. (line 52)
* multiple variants: Variants. (line 9)
* nonstandard names, escape for: Suppliers. (line 31)
-* patenting of fonts: Font legalities. (line 6)
* phonetic encodings: Variants. (line 44)
* pi fonts: Typefaces. (line 42)
* PostScript encoding vectors: Encodings. (line 6)
* PostScript fonts, standard: Standard PostScript fonts.
(line 6)
-* PSfonts distribution: References. (line 17)
* qx encoding: qx. (line 6)
* qx.enc: qx. (line 6)
* Rahtz, Sebastian: History. (line 30)
* raw fonts: Suppliers. (line 25)
* references: References. (line 6)
* related files: References. (line 6)
-* Renner, Paul: Font legalities. (line 43)
* reporting bugs: Introduction. (line 12)
* Rivlin, Jean: History. (line 30)
* Rokicki, Tom: History. (line 30)
-* romain du roi: Font legalities. (line 62)
* sans variant: Variants. (line 117)
* Schoepf, Rainer: History. (line 6)
* schoolbook variant: Variants. (line 102)
@@ -15808,11 +16009,10 @@ General index
* semiserif variant: Variants. (line 28)
* small caps fonts: Variants. (line 17)
* small foundries: Suppliers. (line 19)
-* Southall, Richard: References. (line 34)
+* Southall, Richard: References. (line 29)
* standard PostScript fonts: Standard PostScript fonts.
(line 6)
* Stone Informal: Variants. (line 102)
-* Stone, protection of: Font legalities. (line 25)
* SuperFont: Variants. (line 44)
* supplier.map: Suppliers. (line 34)
* suppliers: Suppliers. (line 6)
@@ -15821,7 +16021,7 @@ General index
* T5 encoding: t5. (line 6)
* t5.enc: t5. (line 6)
* TDS standard: References. (line 8)
-* terminology: References. (line 34)
+* terminology: References. (line 29)
* TeX base encoding: 8r. (line 6)
* TeX Directory Structure standard: References. (line 8)
* TeX Latin 1 encoding: ec. (line 6)
@@ -15837,20 +16037,16 @@ General index
* texnansi.enc: texnansi. (line 6)
* texnansx encoding: texnansx. (line 6)
* texnansx.enc: texnansx. (line 6)
-* Times Roman, protection of: Font legalities. (line 52)
* type foundries: Suppliers. (line 6)
-* typeface design protection: Font legalities. (line 6)
* typeface.map: Typefaces. (line 49)
* typefaces: Typefaces. (line 6)
* typewriter variant: Variants. (line 117)
* unattributed fonts: Suppliers. (line 19)
-* United States, font design protection law: Font legalities. (line 25)
* URW fonts: URW fonts. (line 6)
* urw.map: URW fonts. (line 34)
* utilities: Introduction. (line 16)
* variant.map: Variants. (line 132)
* variants: Variants. (line 6)
-* Vienna treaty: Font legalities. (line 68)
* Vietnamese encoding: t5. (line 6)
* weight: Weights. (line 6)
* weight.map: Weights. (line 14)
@@ -15865,45 +16061,44 @@ General index

Tag Table:
Node: Top260
-Node: Introduction2037
-Node: History3104
-Node: References4919
-Node: Filenames for fonts6470
-Node: Suppliers8073
-Node: Typefaces10608
-Node: Weights31449
-Node: Variants32262
-Node: Widths42471
-Node: Long names43879
-Node: Name mapping file44438
-Node: Long naming scheme46016
-Node: Font name lists47772
-Node: Standard PostScript fonts48231
-Node: Adobe fonts49693
-Node: Apple fonts239673
-Node: Bitstream fonts240007
-Node: DTC fonts300771
-Node: ITC fonts301688
-Node: Linotype fonts347328
-Node: Monotype fonts603354
-Node: URW fonts689911
-Node: Encodings693110
-Node: 6w695170
-Node: 8a697655
-Node: 8r700165
-Node: dvips705149
-Node: ec708955
-Node: groff712470
-Node: t5717404
-Node: qx725355
-Node: texmext766827
-Node: texmsym770683
-Node: texmital773866
-Node: texnansi776600
-Node: texnansx783679
-Node: xl2788658
-Node: xt2793645
-Node: Font legalities798272
-Node: General index802095
+Node: Introduction1969
+Node: History3036
+Node: References4851
+Node: Filenames for fonts6171
+Node: Suppliers7913
+Node: Typefaces10494
+Node: Weights31520
+Node: Variants32333
+Node: Widths42613
+Node: Long names44021
+Node: Name mapping file44580
+Node: Long naming scheme46161
+Node: Font name lists47917
+Node: Standard PostScript fonts48376
+Node: Adobe fonts49838
+Node: Apple fonts239818
+Node: Bitstream fonts240152
+Node: DTC fonts300916
+Node: ITC fonts301833
+Node: Linotype fonts347473
+Node: Monotype fonts603499
+Node: URW fonts690056
+Node: Encodings693255
+Node: 6w695313
+Node: 8a697798
+Node: 8r700308
+Node: dvips705292
+Node: ec709098
+Node: groff720921
+Node: t5725855
+Node: qx733806
+Node: texmext775278
+Node: texmsym779134
+Node: texmital782317
+Node: texnansi785051
+Node: texnansx797470
+Node: xl2802819
+Node: xt2807806
+Node: General index812433

End Tag Table
diff --git a/Master/texmf/doc/info/kpathsea.info b/Master/texmf/doc/info/kpathsea.info
index 52e8fdc336f..6850dccfb61 100644
--- a/Master/texmf/doc/info/kpathsea.info
+++ b/Master/texmf/doc/info/kpathsea.info
@@ -1,10 +1,10 @@
-This is kpathsea.info, produced by makeinfo version 4.12 from
+This is kpathsea.info, produced by makeinfo version 4.13 from
kpathsea.texi.
This file documents the Kpathsea library for path searching.
Copyright (C) 1996, 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004,
-2005, 2007, 2008 Karl Berry & Olaf Weber.
+2005, 2007, 2008, 2009 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
@@ -18,7 +18,7 @@ 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 approved by the Free Software Foundation.
+translation approved by the TeX Users Group.
INFO-DIR-SECTION TeX
START-INFO-DIR-ENTRY
@@ -39,8 +39,8 @@ Kpathsea library
****************
This manual documents how to install and use the Kpathsea library for
-filename lookup. It corresponds to version 3.5.7, released in
-July 2008.
+filename lookup. It corresponds to version 5.0.0, released in
+June 2009.
* Menu:
@@ -60,8 +60,8 @@ File: kpathsea.info, Node: Introduction, Next: Installation, Prev: Top, Up:
1 Introduction
**************
-This manual corresponds to version 3.5.7 of the Kpathsea library,
-released in July 2008.
+This manual corresponds to version 5.0.0 of the Kpathsea library,
+released in June 2009.
The library's fundamental purpose is to return a filename from a
list of directories specified by the user, similar to what shells do
@@ -91,22 +91,14 @@ library, you must (offer to) distribute the source to the library,
along with any changes you have made, and allow anyone to modify the
library source and distribute their modifications. It does not mean
you have to distribute the source to your program, although we hope you
-will. See the files `GPL' and `LGPL' for the text of the GNU licenses.
+will. See the accompanying files for the text of the GNU licenses.
If you know enough about TeX to be reading this manual, then you (or
your institution) should consider joining the TeX Users Group (if
-you're already a member, great!). TUG produces the periodical
+you're already a member, thanks!). TUG produces the periodical
`TUGboat', sponsors an annual meeting and publishes the proceedings,
and arranges courses on TeX for all levels of users throughout the
-world. Anyway, here is the address:
-
- TeX Users Group
- P.O. Box 2311
- Portland OR 97208-2311
- USA
- phone: +1 503 223-9994
- fax: +1 503 223-3960
- email: <tug@tug.org>
+world. See `http://tug.org' for information.
* Menu:
@@ -1249,7 +1241,7 @@ This is `ftp://ftp.tug.org/tex/unixtex.ftp', last updated 26 December
2003. Also available as `http://www.tug.org/unixtex.ftp'. The IP
address is currently `[130.225.2.178]'. It is also in Kpathsea source
distributions as `etc/unixtex.ftp' (although the network version is
-usually newer). Mail <tex-k@mail.tug.org> with comments or questions.
+usually newer). Mail <tex-k@tug.org> with comments or questions.
Following are general instructions for Unix or other sites who wish
to acquire the Web2c distribution, (plain) TeX, LaTeX (2e), BibTeX,
@@ -1374,13 +1366,11 @@ Numerous organizations distribute various TeX CD-ROM's (and DVD's):
minimal TeX source distribution described in the previous section
(i.e., enough to print GNU documentation); email <gnu@gnu.org>.
- * Most Linux distributions include some TeX package based on Web2c;
- see the Linux documentation file `Distribution-HOWTO' for a
- comparison of Linux distributions, available (for example) via
- `http://www.linux.org'.
+ * Most GNU/Linux distributions include some TeX package based on TeX
+ Live.
If you know of additional TeX distributions to add to this list,
-please inform <tex-k@mail.tug.org>.
+please inform <tex-k@tug.org>.

File: kpathsea.info, Node: Other TeX packages, Prev: CD-ROM distribution, Up: unixtex.ftp
@@ -1417,7 +1407,7 @@ File: kpathsea.info, Node: Reporting bugs, Prev: unixtex.ftp, Up: Installatio
(A copy of this chapter is in the file `kpathsea/BUGS'.)
If you have problems or suggestions, please report them to
-<tex-k@mail.tug.org> using the bug checklist below.
+<tex-k@tug.org> using the bug checklist below.
Please report bugs in the documentation; not only factual errors or
inconsistent behavior, but unclear or incomplete explanations, typos,
@@ -1440,8 +1430,7 @@ File: kpathsea.info, Node: Bug checklist, Next: Mailing lists, Up: Reporting
Before reporting a bug, please check below to be sure it isn't already
known (*note Common problems::).
- Bug reports should be sent via electronic mail to
-<tex-k@mail.tug.org>.
+ Bug reports should be sent via electronic mail to <tex-k@tug.org>.
The general principle is that a good bug report includes all the
information necessary for reproduction. Therefore, to enable
@@ -1513,8 +1502,8 @@ File: kpathsea.info, Node: Mailing lists, Next: Debugging, Prev: Bug checklis
-------------------
Web2c and Kpathsea in general are discussed on the mailing list
-<tex-k@mail.tug.org>. To join, email <tex-k-request@mail.tug.org> with
-a line consisting of
+<tex-k@tug.org>. To join, email <tex-k-request@tug.org> with a line
+consisting of
subscribe YOU@YOUR.PREFERRED.EMAIL.ADDRESS
@@ -1531,14 +1520,11 @@ or not is read some of the archives from
Be aware that large data files are sometimes included in bug reports.
If this is a problem for you, do not join the list.
- If you only want announcements of new releases, not bug reports and
-discussion, join <tex-archive@math.utah.edu> (via mail to
-<tex-archive-request@math.utah.edu>).
-
If you are looking for general TeX help, such as how to use LaTeX,
-please use the mailing list <info-tex@shsu.edu> mailing list, which is
-gatewayed to the `comp.text.tex' Usenet newsgroup (or post to the
-newsgroup; the gateway is bidirectional).
+please use the mailing list <texhax@tug.org> mailing list
+(`http://lists.tug.org/texhax') which is gatewayed to the
+`comp.text.tex' Usenet newsgroup (or post to the newsgroup; the gateway
+is bidirectional).

File: kpathsea.info, Node: Debugging, Next: Logging, Prev: Mailing lists, Up: Reporting bugs
@@ -1560,8 +1546,8 @@ program-specific debugging options as well.
You can also set the environment variable `KPATHSEA_DEBUG'; in this
case, you should use the numbers below. If you run the program under a
-debugger and set the variable `kpathsea_debug', also use the numbers
-below.
+debugger and set the instance variable `kpse->debug', also use the
+numbers below.
In any case, by far the simplest value to use is `-1', which will
turn on all debugging output. This is usually better than guessing
@@ -2441,7 +2427,7 @@ more work.
500 regular files, `st_nlink' will be 3, and Kpathsea has to stat every
one of those 501 entries. Therein lies slowness.
- You can disable the trick by undefining `UNIX_ST_LINK' in
+ You can disable the trick by undefining `ST_NLINK_TRICK' in
`kpathsea/config.h'. (It is undefined by default except under Unix.)
Unfortunately, in some cases files in leaf directories are `stat''d:
@@ -2691,15 +2677,17 @@ filename, and returns the first file found.
Here's the current list of recognized names and the associated
suffixes. *Note Supported file formats::, for more information on
each of these.
+
gf: gf
pk: pk
- bitmap font
+ bitmap font:
+ tfm: .tfm
afm: .afm
base: .base
bib: .bib
bst: .bst
cnf: .cnf
- ls-R: ls-R
+ ls-R: ls-R ls-r
fmt: .fmt
map: .map
mem: .mem
@@ -2708,40 +2696,42 @@ filename, and returns the first file found.
mft: .mft
mp: .mp
mppool: .pool
- MetaPost support
+ MetaPost support:
ocp: .ocp
ofm: .ofm .tfm
opl: .opl
otp: .otp
ovf: .ovf
ovp: .ovp
- graphic/figure: .eps .epsi
- tex: .tex
- TeX system documentation
+ graphic/figure: .eps .epsi
+ tex: .tex .sty .cls .fd .aux .bbl .def .clo .ldf
+ TeX system documentation:
texpool: .pool
- TeX system sources
- PostScript header/font: .pro
- Troff fonts
- tfm: .tfm
+ TeX system sources: .dtx .ins
+ PostScript header: .pro
+ Troff fonts:
type1 fonts: .pfa .pfb
vf: .vf
- dvips config
+ dvips config:
ist: .ist
- truetype fonts: .ttf .ttc
- type42 fonts
- web2c files
- other text files
- other binary files
- misc fonts
- web: .web
- cweb: .w .web
- enc: .enc
- cmap: .cmap
- sfd: .sfd
- opentype fonts
- pdftex config
+ truetype fonts: .ttf .ttc .TTF .TTC
+ type42 fonts: .t42 .T42
+ web2c files:
+ other text files:
+ other binary files:
+ misc fonts:
+ web: .web .ch
+ cweb: .w .web .ch
+ enc files: .enc
+ cmap files:
+ subfont definition files: .sfd
+ opentype fonts: .otf
+ pdftex config:
lig files: .lig
- texmfscripts
+ texmfscripts:
+ lua: .luc .luctex .texluc .lua .luatex .texlua
+ font feature files: .fea
+ cid maps: .cid .cidmap
This option and `--path' are mutually exclusive.
@@ -2884,6 +2874,9 @@ their corresponding format:
`texmf.cnf'
`cnf'
+`XDvi'
+ `other text files'
+
A user-specified format will override the above defaults.
@@ -3012,8 +3005,8 @@ environment variables with an underscore, e.g., `TEXINPUTS_latex'
(web2c)bibtex invocation.) `BIBINPUTS', `TEXBIB'; suffix `.bib'.
`bst'
- (BibTeX style file, *note Basic BibTeX style files: (web2c)Basic
- BibTeX style files.) `BSTINPUTS'; suffix `.bst'.
+ (BibTeX style, *note Basic BibTeX style files: (web2c)Basic BibTeX
+ style files.) `BSTINPUTS'; suffix `.bst'.
`cmap'
(character map files) `CMAPFONTS'; suffix `.cmap'.
@@ -3037,6 +3030,13 @@ environment variables with an underscore, e.g., `TEXINPUTS_latex'
(TeX memory dump, *note Memory dumps: (web2c)Memory dumps.)
`TEXFORMATS', `TEXMFINI'; suffix `.fmt'.
+`font cid map'
+ (CJK mapping) `FONTCIDMAPS' suffix `.cid'.
+
+`font feature files'
+ (primarily for OpenType font features) `FONTFEATURES' suffix
+ `.fea'.
+
`gf'
(generic font bitmap, *note Glyph files: (dvips)Glyph files.)
`PROGRAMFONTS', `GFFONTS', `GLYPHFONTS', `TEXFONTS'; suffix `gf'.
@@ -3083,6 +3083,14 @@ environment variables with an underscore, e.g., `TEXINPUTS_latex'
(font-related files that don't fit the other categories)
`MISCFONTS'
+`mlbib'
+ (MlBibTeX bibliography source) `MLBIBINPUTS', `BIBINPUTS',
+ `TEXBIB'; suffixes `.mlbib', `.mlbib'.
+
+`mlbst'
+ (MlBibTeX style) `MLBSTINPUTS', `BSTINPUTS'; suffixes `.mlbst',
+ `.bst'.
+
`mp'
(MetaPost source, *note mpost invocation: (web2c)mpost invocation.)
`MPINPUTS'; suffix `.mp'.
@@ -3248,7 +3256,7 @@ tried; the difference is the order in which they are tried.
*already* have an extension. A name without an extension (e.g., `tex
story') will always have an extension added first.
- This algorithm is implemented in the routine `kpse_find_file' in
+ This algorithm is implemented in the routine `kpathsea_find_file' in
`kpathsea/tex-file.c'. You can watch it in action with the debugging
options (*note Debugging::).
@@ -3278,7 +3286,7 @@ first successful lookup.
4. Look for FALLBACK.DPI, where FALLBACK is some last-resort font
(typically `cmr10').
- This is implemented in `kpse_find_glyph_format' in
+ This is implemented in `kpathsea_find_glyph' in
`kpathsea/tex-glyph.c'.
* Menu:
@@ -3396,9 +3404,8 @@ to find fonts at their stated size or not at all.
Finally, if the font cannot be found even at the fallback
resolutions, Kpathsea looks for a fallback font, typically `cmr10'.
-Programs must enable this feature by assigning to the global variable
-`kpse_fallback_font' or calling `kpse_init_prog' (*note Calling
-sequence::); the default is no fallback font.
+Programs must enable this feature by calling `kpathsea_init_prog'
+(*note Calling sequence::); the default is no fallback font.

File: kpathsea.info, Node: Suppressing warnings, Prev: Glyph lookup, Up: TeX support
@@ -3459,16 +3466,24 @@ File: kpathsea.info, Node: Programming overview, Next: Calling sequence, Up:
5.1 Programming overview
========================
-Aside from this manual, your best source of information is the source to
-the programs I've modified to use Kpathsea (*note Introduction::). Of
-those, Dviljk is probably the simplest, and hence a good place to start.
+Aside from this manual, your best source of information is the source
+to the programs that use Kpathsea (*note Introduction::). Of those,
+Dviljk is probably the simplest, and hence a good place to start.
Xdvik adds VF support and the complication of X resources. Dvipsk adds
the complication of its own config files. Web2c is source code I also
-maintain, so it uses Kpathsea rather straightforwardly, but is of course
-complicated by the Web to C translation. Finally, Kpsewhich is a small
-utility program whose sole purpose is to exercise the main
+maintain, so it uses Kpathsea rather straightforwardly, but is of
+course complicated by the Web to C translation. Finally, Kpsewhich is
+a small utility program whose sole purpose is to exercise the main
path-searching functionality.
+ When looking at these program sources, you should know that previous
+versions of the library had a different programming interface, to
+support re-entrancy. In that interface the library function names were
+prefixed with `kpse_' instead of `kpathsea_', and they did not need an
+instance variable as first argument. This change was made in 2009.
+Some of the programs mentioned above may still be using the previous
+interface.
+
Beyond these examples, the `.h' files in the Kpathsea source
describe the interfaces and functionality (and of course the `.c' files
define the actual routines, which are the ultimate documentation).
@@ -3507,40 +3522,39 @@ File: kpathsea.info, Node: Calling sequence, Next: Program-specific files, Pr
The typical way to use Kpathsea in your program goes something like
this:
- 1. Call `kpse_set_program_name' with `argv[0]' as the first argument;
- the second argument is a string or `NULL'. The second argument is
- used by Kpathsea as the program name for the `.PROGRAM' feature of
- config files (*note Config files::). If the second argument is
- `NULL', the value of the first argument is used. This function
- must be called before any other use of the Kpathsea library.
-
- `kpse_set_program_name' always sets the global variables
- `program_invocation_name' and `program_invocation_short_name'.
- These variables are used in the error message macros defined in
- `kpathsea/lib.h'. It sets the global variable `kpse_program_name'
- to the program name it uses.
+ 1. Call `kpathsea_new' to create a new library instance. This variable
+ must be passed as the first argument to all the following library
+ functions. The rest of this manual will be using `kpse' as a
+ placeholder for the name of this variable.
+
+ 2. Call `kpathsea_set_program_name' with `argv[0]' as the second
+ argument; the third argument is a string or `NULL'. The third
+ argument is used by Kpathsea as the program name for the
+ `.PROGRAM' feature of config files (*note Config files::). If the
+ third argument is `NULL', the value of the second argument is
+ used. This function must be called before any other use of the
+ Kpathsea library.
+
+ `kpathsea_set_program_name' always sets the variables
+ `kpse->invocation_name' and `kpse->invocation_short_name'. These
+ variables are used in the error message macros defined in
+ `kpathsea/lib.h'. It sets the variable `kpse->program_name' to
+ the program name it uses.
It also initializes debugging options based on the environment
variable `KPATHSEA_DEBUG' (if that is set).
- Finally, it sets the variables `SELFAUTOLOC', `SELFAUTODIR' and
- `SELFAUTOPARENT' to the location, parent and grandparent directory
- of the executable, removing `.' and `..' path elements and
- resolving symbolic links. These are used in the default
- configuration file to allow people to invoke TeX from anywhere.
- You can use `kpsewhich --expand-var=\$SELFAUTOLOC', etc., to see
- the values.
-
- 2. The `kpse_set_progname' is deprecated. A call to
- `kpse_set_progname' with `argv[0]' is equivalent to a call of
- `kpse_set_program_name' with first argument `argv[0]' and second
- argument `NULL'. The function is deprecated because it cannot
- ensure that the `.PROGRAM' feature of config files will always
- work (*note Config files::).
+ Finally, it sets the environment variables `SELFAUTOLOC',
+ `SELFAUTODIR' and `SELFAUTOPARENT' to the location, parent and
+ grandparent directory of the executable, removing `.' and `..' path
+ elements and resolving symbolic links. These are used in the
+ default configuration file to allow people to invoke TeX from
+ anywhere. You can use `kpsewhich --expand-var=\$SELFAUTOLOC',
+ etc., to see the values.
3. Set debugging options. *Note Debugging::. If your program doesn't
have a debugging option already, you can define one and set
- `kpathsea_debug' to the number that the user supplies (as in Dviljk
+ `kpse->debug' to the number that the user supplies (as in Dviljk
and Web2c), or you can just omit this altogether (people can
always set `KPATHSEA_DEBUG'). If you do have runtime debugging
already, you need to merge Kpathsea's options with yours (as in
@@ -3548,12 +3562,12 @@ this:
4. If your program has its own configuration files that can define
search paths, you should assign those paths to the `client_path'
- member in the appropriate element of the `kpse_format_info' array.
- (This array is indexed by file type; see `tex-file.h'.) See
- `resident.c' in Dvipsk for an example.
+ member in the appropriate element of the `kpse->format_info'
+ array. (This array is indexed by file type; see `tex-file.h'.)
+ See `resident.c' in Dvipsk for an example.
- 5. Call `kpse_init_prog' (see `proginit.c'). It's useful for the DVI
- drivers, at least, but for other programs it may be simpler to
+ 5. Call `kpathsea_init_prog' (see `proginit.c'). It's useful for the
+ DVI drivers, at least, but for other programs it may be simpler to
extract the parts of it that actually apply. This does not
initialize any paths, it just looks for (and sets) certain
environment variables and other random information. (A search
@@ -3562,26 +3576,28 @@ this:
the BibTeX search paths in a DVI driver.)
6. The routine to actually find a file of type FORMAT is
- `kpse_find_FORMAT', defined in `tex-file.h'. These are macros that
- expand to a call to `kpse_find_file'. You can call, say,
- `kpse_find_tfm' after doing only the first of the initialization
- steps above--Kpathsea automatically reads the `texmf.cnf' generic
- config files, looks for environment variables, and does expansions
- at the first lookup.
-
- 7. To find PK and/or GF bitmap fonts, the routines are `kpse_find_pk',
- `kpse_find_gf' and `kpse_find_glyph', defined in `tex-glyph.h'.
- These return a structure in addition to the resultant filename,
- because fonts can be found in so many ways. See the documentation
- in the source.
+ `kpathsea_find_file'. You can call `kpathsea_find_file' after
+ doing only the first and second of the initialization steps
+ above--Kpathsea automatically reads the `texmf.cnf' generic config
+ files, looks for environment variables, and does expansions at the
+ first lookup.
+
+ 7. To find PK and/or GF bitmap fonts, the routine is
+ `kpathsea_find_glyph', defined in `tex-glyph.h'. This returns a
+ structure in addition to the resultant filename, because fonts can
+ be found in so many ways. See the documentation in the source.
8. To actually open a file, not just return a filename, call
- `kpse_open_file'. This function takes the name to look up and a
- Kpathsea file format as arguments, and returns the usual `FILE *'.
- It always assumes the file must exist, and thus will search the
- disk if necessary (unless the search path specified `!!', etc.).
- In other words, if you are looking up a VF or some other file that
- need not exist, don't use this.
+ `kpathsea_open_file'. This function takes the name to look up and
+ a Kpathsea file format as arguments, and returns the usual `FILE
+ *'. It always assumes the file must exist, and thus will search
+ the disk if necessary (unless the search path specified `!!',
+ etc.). In other words, if you are looking up a VF or some other
+ file that need not exist, don't use this.
+
+ 9. To close the kpathsea library instance you are using, call
+ `kpathsea_finish'. This function closes any open log files and
+ frees the memory used by the instance.
Kpathsea also provides many utility routines. Some are generic: hash
@@ -3617,7 +3633,8 @@ That is to say, the name of the variable is constructed by converting
the name of the program to upper case, and appending `INPUTS'.
The only difference between these two formats is whether
-`kpse_open_file' will open the files it finds in text or binary mode.
+`kpathsea_open_file' will open the files it finds in text or binary
+mode.

File: kpathsea.info, Node: Programming with config files, Prev: Program-specific files, Up: Programming
@@ -3630,22 +3647,22 @@ file that Kpathsea uses for your program. This helps installers by
keeping all configuration in one place.
To retrieve a value VAR from config files, the best way is to call
-`kpse_var_value' on the string `VAR'. This will look first for an
+`kpathsea_var_value' on the string `VAR'. This will look first for an
environment variable VAR, then a config file value. The result will be
the value found or `NULL'. This function is declared in
`kpathsea/variable.h'. For an example, see the `shell_escape' code in
`web2c/lib/texmfmp.c'.
The routine to do variable expansion in the context of a search path
-(as opposed to simply retrieving a value) is `kpse_var_expand', also
+(as opposed to simply retrieving a value) is `kpathsea_var_expand', also
declared in `kpathsea/variable.h'. It's generally only necessary to
set the search path structure components as explained in the previous
section, rather than using this yourself.
If for some reason you want to retrieve a value _only_ from a config
file, not automatically looking for a corresponding environment
-variable, call `kpse_cnf_get' (declared in `kpathsea/cnf.h') with the
-string VAR.
+variable, call `kpathsea_cnf_get' (declared in `kpathsea/cnf.h') with
+the string VAR.
No initialization calls are needed.
@@ -3680,20 +3697,20 @@ Index
(line 38)
* --help: Standard options. (line 8)
* --interactive: Path searching options.
- (line 106)
+ (line 110)
* --mode=STRING: Path searching options.
- (line 117)
+ (line 121)
* --must-exist: Path searching options.
- (line 122)
+ (line 126)
* --path=STRING: Path searching options.
- (line 127)
+ (line 131)
* --progname=NAME: Path searching options.
- (line 136)
+ (line 140)
* --show-path=NAME: Auxiliary tasks. (line 41)
* --srcdir, for building multiple architectures: configure scenarios.
(line 18)
* --subdir=STRING: Path searching options.
- (line 141)
+ (line 145)
* --var-value=VARIABLE: Auxiliary tasks. (line 12)
* --version: Standard options. (line 10)
* --with options: configure options. (line 16)
@@ -3714,9 +3731,9 @@ Index
* -g, compiling without: configure scenarios. (line 32)
* -L option to ls: ls-R. (line 38)
* -mktex=FILETYPE: Path searching options.
- (line 111)
+ (line 115)
* -no-mktex=FILETYPE: Path searching options.
- (line 111)
+ (line 115)
* -O, compiling with: configure scenarios. (line 32)
* -static: ShellWidgetClass. (line 43)
* . directories, ignored: ls-R. (line 33)
@@ -3731,6 +3748,8 @@ Index
(line 28)
* .bst: Supported file formats.
(line 32)
+* .cid: Supported file formats.
+ (line 58)
* .cmap: Supported file formats.
(line 36)
* .cnf: Supported file formats.
@@ -3738,61 +3757,67 @@ Index
* .enc: Supported file formats.
(line 51)
* .eps: Supported file formats.
- (line 62)
+ (line 69)
* .epsi: Supported file formats.
- (line 62)
+ (line 69)
+* .fea: Supported file formats.
+ (line 61)
* .fmt: Supported file formats.
(line 54)
* .ist: Supported file formats.
- (line 67)
+ (line 74)
* .lig: Supported file formats.
- (line 71)
+ (line 78)
* .map: Supported file formats.
- (line 77)
+ (line 84)
* .mem: Supported file formats.
- (line 80)
+ (line 87)
* .mf: Supported file formats.
- (line 88)
+ (line 95)
* .mft: Supported file formats.
- (line 96)
+ (line 103)
+* .mlbib: Supported file formats.
+ (line 111)
+* .mlbst: Supported file formats.
+ (line 115)
* .mp: Supported file formats.
- (line 104)
+ (line 119)
* .ocp: Supported file formats.
- (line 112)
+ (line 127)
* .ofm: Supported file formats.
- (line 116)
+ (line 131)
* .opl: Supported file formats.
- (line 123)
+ (line 138)
* .otp: Supported file formats.
- (line 126)
+ (line 141)
* .ovf: Supported file formats.
- (line 129)
+ (line 144)
* .ovp: Supported file formats.
- (line 132)
+ (line 147)
* .pfa: Supported file formats.
- (line 184)
+ (line 199)
* .pfb: Supported file formats.
- (line 184)
+ (line 199)
* .pk: Supported file formats.
- (line 139)
+ (line 154)
* .pool: Supported file formats.
- (line 92)
+ (line 99)
* .pro: Supported file formats.
- (line 145)
+ (line 160)
* .rhosts, writable by TeX: Security. (line 10)
* .sfd: Supported file formats.
- (line 149)
+ (line 164)
* .tex: Supported file formats.
- (line 152)
+ (line 167)
* .tex file, included in ls-R: ls-R. (line 33)
* .tfm: Supported file formats.
- (line 172)
+ (line 187)
* .ttc: Supported file formats.
- (line 181)
+ (line 196)
* .ttf: Supported file formats.
- (line 181)
+ (line 196)
* .vf: Supported file formats.
- (line 192)
+ (line 207)
* .w: Supported file formats.
(line 43)
* .web: Supported file formats.
@@ -3839,6 +3864,8 @@ Index
* announcement mailing list: Mailing lists. (line 6)
* ANSI C: TeX or Metafont failing.
(line 30)
+* API, re-entrant: Programming overview.
+ (line 16)
* append-only directories and mktexpk: Security. (line 36)
* appendonlydir: mktex configuration. (line 61)
* architecture-(in)dependent files, installing only: Installing files.
@@ -3846,9 +3873,9 @@ Index
* architectures, compiling multiple: configure scenarios. (line 18)
* arguments to mktex: mktex script arguments.
(line 6)
-* argv[0]: Calling sequence. (line 9)
+* argv[0]: Calling sequence. (line 14)
* ash, losing with configure: configure shells. (line 19)
-* autoconf, recommended: Calling sequence. (line 93)
+* autoconf, recommended: Calling sequence. (line 94)
* automounter, and configuration: configure scenarios. (line 29)
* automounter, and ls-R: ls-R. (line 40)
* auxiliary tasks: Auxiliary tasks. (line 6)
@@ -3876,9 +3903,9 @@ Index
* bug checklist: Bug checklist. (line 6)
* bug mailing list: Mailing lists. (line 6)
* bugs, reporting: Reporting bugs. (line 6)
-* c-*.h: Calling sequence. (line 93)
+* c-*.h: Calling sequence. (line 94)
* c-auto.h: Programming overview.
- (line 25)
+ (line 33)
* c-auto.in: Running configure. (line 6)
* cache of fonts, local: Security. (line 22)
* calling sequence: Calling sequence. (line 6)
@@ -3891,13 +3918,13 @@ Index
* CD-ROM distributions: CD-ROM distribution. (line 6)
* CFLAGS: configure environment.
(line 14)
-* ChangeLog entry: Bug checklist. (line 56)
+* ChangeLog entry: Bug checklist. (line 55)
* checklist for bug reports: Bug checklist. (line 6)
* checksum: Suppressing warnings.
(line 16)
* circle fonts: Fontmap. (line 19)
* clean Make target: Cleaning up. (line 15)
-* client_path in kpse_format_info: Calling sequence. (line 48)
+* client_path in kpse->format_info: Calling sequence. (line 47)
* CMAPFONTS: Supported file formats.
(line 36)
* cmr10, as fallback font: Fallback font. (line 15)
@@ -3913,7 +3940,7 @@ Index
* common features in glyph lookup: Basic glyph lookup. (line 6)
* common problems: Common problems. (line 6)
* comp.sys.sun.admin FAQ: ShellWidgetClass. (line 6)
-* comp.text.tex: Mailing lists. (line 29)
+* comp.text.tex: Mailing lists. (line 25)
* compilation: Installation. (line 6)
* compilation value, source for path: Path sources. (line 20)
* compiler bugs: TeX or Metafont failing.
@@ -3929,19 +3956,19 @@ Index
* conditions for use: Introduction. (line 31)
* config files: Config files. (line 6)
* config files, for Kpathsea-using programs: Calling sequence.
- (line 48)
+ (line 47)
* config files, programming with: Programming with config files.
(line 6)
* config.h: Programming overview.
- (line 25)
-* config.log: Bug checklist. (line 28)
+ (line 33)
+* config.log: Bug checklist. (line 27)
* config.ps: Specially-recognized files.
(line 16)
* config.ps, search path for: Supported file formats.
(line 47)
-* config.status: Bug checklist. (line 31)
+* config.status: Bug checklist. (line 30)
* configuration: Installation. (line 6)
-* configuration bugs: Bug checklist. (line 31)
+* configuration bugs: Bug checklist. (line 30)
* configuration compiler options: configure environment.
(line 23)
* configuration file, source for path: Path sources. (line 17)
@@ -3952,12 +3979,12 @@ Index
* configure options: configure options. (line 6)
* configure options for mktex scripts: mktex configuration. (line 12)
* configure, running: Running configure. (line 6)
-* context diff: Bug checklist. (line 56)
+* context diff: Bug checklist. (line 55)
* continuation character: Config files. (line 31)
-* core dumps, reporting: Bug checklist. (line 62)
+* core dumps, reporting: Bug checklist. (line 61)
* CPPFLAGS: configure environment.
(line 22)
-* crashes, reporting: Bug checklist. (line 62)
+* crashes, reporting: Bug checklist. (line 61)
* CTAN, defined: Electronic distribution.
(line 6)
* CTAN.sites: Electronic distribution.
@@ -3969,10 +3996,10 @@ Index
* database, for filenames: Filename database. (line 6)
* database, format of: Database format. (line 6)
* debug.h: Debugging. (line 6)
-* debugger: Bug checklist. (line 62)
+* debugger: Bug checklist. (line 61)
* debugging: Debugging. (line 6)
* debugging options, in Kpathsea-using program: Calling sequence.
- (line 40)
+ (line 39)
* debugging output: Debugging. (line 27)
* debugging with -g, disabling: configure scenarios. (line 32)
* DEC shells and configure: configure shells. (line 25)
@@ -4013,7 +4040,7 @@ Index
* dlsym: dlopen. (line 6)
* dlsym.c: dlopen. (line 21)
* doc files: Supported file formats.
- (line 158)
+ (line 173)
* DOS compatible names: mktex configuration. (line 69)
* DOS support: Custom installation. (line 19)
* DOS TeX implementations: Other TeX packages. (line 6)
@@ -4028,9 +4055,9 @@ Index
* dvipdfmx.cfg: Specially-recognized files.
(line 19)
* DVIPSFONTS: Supported file formats.
- (line 227)
+ (line 242)
* DVIPSHEADERS: Supported file formats.
- (line 184)
+ (line 199)
* DVIPSMAKEPK: mktex script names. (line 32)
* DVIPSSIZES: Fallback font. (line 6)
* dynamic creation of files: mktex scripts. (line 6)
@@ -4053,10 +4080,10 @@ Index
* environment variables, old: Unable to find files.
(line 14)
* epoch, seconds since: Logging. (line 15)
-* error message macros: Calling sequence. (line 16)
+* error message macros: Calling sequence. (line 22)
* excessive startup time: Slow path searching. (line 6)
* expand.c: Brace expansion. (line 26)
-* expanding symlinks: Calling sequence. (line 25)
+* expanding symlinks: Calling sequence. (line 31)
* expansion, default: Default expansion. (line 6)
* expansion, path element: Searching overview. (line 43)
* expansion, search path: Path expansion. (line 6)
@@ -4084,7 +4111,7 @@ Index
* file lookup: File lookup. (line 6)
* file permissions: Security. (line 47)
* file types, registering new: Programming overview.
- (line 31)
+ (line 39)
* filename aliases: Filename aliases. (line 6)
* filename database: Filename database. (line 6)
* filename database generation: Filename database generation.
@@ -4104,13 +4131,17 @@ Index
(line 6)
* font of last resort: Fallback font. (line 6)
* font set, infinite: mktex scripts. (line 6)
+* FONTCIDMAPS: Supported file formats.
+ (line 58)
+* FONTFEATURES: Supported file formats.
+ (line 61)
* fontmap files: Fontmap. (line 6)
* fontmaps: mktex configuration. (line 87)
* fontname: mktex configuration. (line 88)
* fontnames, arbitrary length: Fontmap. (line 15)
* fonts, being created: Simple installation. (line 79)
* FOOINPUTS: Supported file formats.
- (line 209)
+ (line 224)
* fopen, redefined: Debugging. (line 54)
* format of external database: Database format. (line 6)
* Free Software Foundation: CD-ROM distribution. (line 12)
@@ -4123,20 +4154,20 @@ Index
* fundamental purpose of Kpathsea: Introduction. (line 6)
* gcc, compiling with: configure environment.
(line 11)
-* gdb, recommended: Bug checklist. (line 62)
+* gdb, recommended: Bug checklist. (line 61)
* generation of filename database: Filename database generation.
(line 6)
* get_applicationShellWidgetClass: ShellWidgetClass. (line 6)
* get_wmShellWidgetClass: ShellWidgetClass. (line 6)
* gf: Supported file formats.
- (line 58)
+ (line 65)
* GFFONTS: Supported file formats.
- (line 58)
+ (line 65)
* globally writable directories: Security. (line 30)
* glyph lookup: Glyph lookup. (line 6)
* glyph lookup bitmap tolerance: Basic glyph lookup. (line 15)
* GLYPHFONTS: Supported file formats.
- (line 58)
+ (line 65)
* glyphlist.txt: Specially-recognized files.
(line 25)
* GNU C compiler bugs: TeX or Metafont failing.
@@ -4145,9 +4176,9 @@ Index
* group-writable directories: Security. (line 40)
* GSFTOPK_DEBUG (128): Debugging. (line 88)
* hash table buckets, printing: Debugging. (line 105)
-* hash table routines: Calling sequence. (line 86)
+* hash table routines: Calling sequence. (line 87)
* hash_summary_only variable for debugging: Debugging. (line 105)
-* help, mailing list for general TeX: Mailing lists. (line 29)
+* help, mailing list for general TeX: Mailing lists. (line 25)
* HIER: Default path features.
(line 41)
* history of Kpathsea: History. (line 6)
@@ -4160,9 +4191,9 @@ Index
(line 6)
* include fontmap directive: Fontmap. (line 33)
* INDEXSTYLE: Supported file formats.
- (line 67)
-* info-tex@shsu.edu: Mailing lists. (line 29)
-* input lines, reading: Calling sequence. (line 86)
+ (line 74)
+* info-tex@shsu.edu: Mailing lists. (line 25)
+* input lines, reading: Calling sequence. (line 87)
* install-data Make target: Installing files. (line 28)
* install-exec Make target: Installing files. (line 23)
* installation: Installation. (line 6)
@@ -4178,7 +4209,7 @@ Index
* installation, simple: Simple installation. (line 6)
* installing files: Installing files. (line 6)
* interactive query: Path searching options.
- (line 106)
+ (line 110)
* interface, not frozen: Introduction. (line 27)
* introduction: Introduction. (line 6)
* kdebug:: Debugging. (line 105)
@@ -4189,23 +4220,37 @@ Index
* Knuth, Donald E., original author: Electronic distribution.
(line 25)
* Korn shell, losing with configure: configure shells. (line 14)
+* kpathsae_var_value: Programming with config files.
+ (line 10)
* Kpathsea config file, source for path: Path sources. (line 17)
* Kpathsea version number: Kpathsea application distributions.
(line 6)
* kpathsea.h: Programming overview.
- (line 16)
+ (line 24)
* kpathsea/HIER: Default path features.
(line 41)
* kpathsea/README.CONFIGURE: Running configure. (line 15)
-* KPATHSEA_DEBUG: Calling sequence. (line 22)
-* kpathsea_debug: Debugging. (line 18)
+* kpathsea_cnf_get: Programming with config files.
+ (line 23)
+* KPATHSEA_DEBUG <1>: Calling sequence. (line 28)
* KPATHSEA_DEBUG: Debugging. (line 18)
-* kpathsea_debug: Debugging. (line 6)
-* kpathsea_debug variable: Calling sequence. (line 40)
+* kpathsea_find_file <1>: Calling sequence. (line 62)
+* kpathsea_find_file: File lookup. (line 37)
+* kpathsea_find_glyph: Glyph lookup. (line 26)
+* kpathsea_finish: Calling sequence. (line 82)
+* kpathsea_init_prog <1>: Calling sequence. (line 53)
+* kpathsea_init_prog: Fallback font. (line 15)
+* kpathsea_new: Calling sequence. (line 9)
+* kpathsea_open_file: Calling sequence. (line 74)
+* kpathsea_set_program_name: Calling sequence. (line 14)
* KPATHSEA_WARNING: Config files. (line 18)
+* kpse->debug: Debugging. (line 6)
+* kpse->debug variable: Calling sequence. (line 39)
+* kpse->format_info: Calling sequence. (line 47)
+* kpse->invocation_name: Calling sequence. (line 22)
+* kpse->invocation_short_name: Calling sequence. (line 22)
+* kpse->program_name: Calling sequence. (line 22)
* KPSE_BITMAP_TOLERANCE: Basic glyph lookup. (line 15)
-* kpse_cnf_get: Programming with config files.
- (line 23)
* KPSE_DEBUG_EXPAND (16): Debugging. (line 68)
* KPSE_DEBUG_FOPEN (4): Debugging. (line 53)
* KPSE_DEBUG_HASH (2): Debugging. (line 46)
@@ -4214,22 +4259,9 @@ Index
* KPSE_DEBUG_STAT (1): Debugging. (line 38)
* KPSE_DEBUG_VARS (64): Debugging. (line 83)
* KPSE_DOT expansion: KPSE_DOT expansion. (line 6)
-* kpse_fallback_font: Fallback font. (line 15)
-* kpse_find_*: Calling sequence. (line 63)
-* kpse_find_file <1>: Calling sequence. (line 63)
-* kpse_find_file: File lookup. (line 37)
-* kpse_find_glyph_format: Glyph lookup. (line 26)
-* kpse_format_info: Calling sequence. (line 48)
* kpse_format_info_type: Debugging. (line 61)
-* kpse_init_prog: Calling sequence. (line 54)
* kpse_init_prog, and MAKETEX_MODE: Default path features.
(line 25)
-* kpse_open_file: Calling sequence. (line 77)
-* kpse_program_name: Calling sequence. (line 16)
-* kpse_set_progname: Calling sequence. (line 33)
-* kpse_set_program_name: Calling sequence. (line 9)
-* kpse_var_value: Programming with config files.
- (line 10)
* kpsewhich: Invoking kpsewhich. (line 6)
* Kpsewhich, and debugging: Debugging. (line 31)
* ksh, losing with configure: configure shells. (line 14)
@@ -4237,7 +4269,7 @@ Index
* LaserJet drive: Kpathsea application distributions.
(line 13)
* last-resort font: Fallback font. (line 6)
-* LaTeX help mailing list: Mailing lists. (line 29)
+* LaTeX help mailing list: Mailing lists. (line 25)
* lcircle10: Fontmap. (line 19)
* LDFLAGS: configure environment.
(line 38)
@@ -4255,8 +4287,8 @@ Index
* libucb, avoiding: Running make. (line 44)
* license for using the library: Introduction. (line 31)
* LIGFONTS: Supported file formats.
- (line 71)
-* lines, reading arbitrary-length: Calling sequence. (line 86)
+ (line 78)
+* lines, reading arbitrary-length: Calling sequence. (line 87)
* Linux File System Standard: mktex configuration. (line 114)
* Linux shells and configure: configure shells. (line 19)
* Linux, using Web2c: CD-ROM distribution. (line 16)
@@ -4272,7 +4304,7 @@ Index
* lostchar: Suppressing warnings.
(line 19)
* ls-R: Supported file formats.
- (line 74)
+ (line 81)
* ls-R and AFS: Installing files. (line 40)
* ls-R database file: ls-R. (line 6)
* ls-R, simplest build: ls-R. (line 18)
@@ -4292,7 +4324,7 @@ Index
* MAKETEX_FINE_DEBUG (1024): Debugging. (line 100)
* MAKETEX_MODE: Default path features.
(line 19)
-* memory allocation routines: Calling sequence. (line 86)
+* memory allocation routines: Calling sequence. (line 87)
* metafont driver files: mktex configuration. (line 94)
* Metafont failures: TeX or Metafont failing.
(line 6)
@@ -4305,15 +4337,15 @@ Index
* MFBASES: Supported file formats.
(line 24)
* MFINPUTS: Supported file formats.
- (line 88)
+ (line 95)
* MFPOOL: Supported file formats.
- (line 92)
+ (line 99)
* MFTINPUTS: Supported file formats.
- (line 96)
+ (line 103)
* mirrors, FTP: Electronic distribution.
(line 13)
* MISCFONTS: Supported file formats.
- (line 100)
+ (line 107)
* mismatched checksum warnings: Suppressing warnings.
(line 17)
* missfont.log: mktex script names. (line 35)
@@ -4338,17 +4370,21 @@ Index
(line 12)
* mktextex: mktex script names. (line 27)
* mktextfm: mktex script names. (line 30)
+* MLBIBINPUTS: Supported file formats.
+ (line 111)
+* MLBSTINPUTS: Supported file formats.
+ (line 115)
* mode directory, omitting: mktex configuration. (line 99)
* Morgan, Tim: History. (line 12)
* mostlyclean Make target: Cleaning up. (line 10)
* MPINPUTS: Supported file formats.
- (line 104)
+ (line 119)
* MPMEMS: Supported file formats.
- (line 80)
+ (line 87)
* MPPOOL: Supported file formats.
- (line 108)
+ (line 123)
* MPSUPPORT: Supported file formats.
- (line 84)
+ (line 91)
* MT_FEATURES: mktex configuration. (line 40)
* multiple architectures, compiling on: configure scenarios. (line 18)
* multiple architectures, directories for: configure scenarios.
@@ -4360,7 +4396,7 @@ Index
* NetBSD configure error: Empty Makefiles. (line 6)
* NetBSD shells and configure: configure shells. (line 19)
* Neumann, Gustaf: History. (line 57)
-* newsgroup for TeX: Mailing lists. (line 29)
+* newsgroup for TeX: Mailing lists. (line 25)
* NeXT sed error: Empty Makefiles. (line 6)
* NeXT, lacking X11: Kpathsea application distributions.
(line 6)
@@ -4374,20 +4410,20 @@ Index
* non-Unix operating systems: Custom installation. (line 19)
* none: Suppressing warnings.
(line 23)
-* null pointers, dereferencing: Bug checklist. (line 62)
+* null pointers, dereferencing: Bug checklist. (line 61)
* numeric debugging values: Debugging. (line 34)
* obtaining TeX: unixtex.ftp. (line 6)
* obtaining Web2c by ftp: Electronic distribution.
(line 6)
* obtaining Web2c on CD-ROM: CD-ROM distribution. (line 6)
* OCPINPUTS: Supported file formats.
- (line 112)
+ (line 127)
* OFMFONTS: Supported file formats.
- (line 116)
+ (line 131)
* online Metafont display, spurious: Unable to generate fonts.
(line 36)
* OPENTYPEFONTS: Supported file formats.
- (line 120)
+ (line 135)
* OpenWin libraries, dynamic linking problems: ShellWidgetClass.
(line 6)
* optimization caveat: TeX or Metafont failing.
@@ -4398,14 +4434,14 @@ Index
* OS/2 support: Custom installation. (line 19)
* other TeX distributions: Other TeX packages. (line 6)
* OTPINPUTS: Supported file formats.
- (line 126)
+ (line 141)
* overview of path searching: Searching overview. (line 6)
* overview of programming with Kpathsea: Programming overview.
(line 6)
* OVFFONTS: Supported file formats.
- (line 129)
+ (line 144)
* OVPFONTS: Supported file formats.
- (line 132)
+ (line 147)
* patches, Sun OpenWin: ShellWidgetClass. (line 29)
* path expansion: Path expansion. (line 6)
* path searching: Path searching. (line 6)
@@ -4424,7 +4460,7 @@ Index
(line 27)
* paths.h, creating: Running make. (line 6)
* pathsearch.h: Programming overview.
- (line 16)
+ (line 24)
* pc Pascal compiler: History. (line 12)
* PCL driver: Kpathsea application distributions.
(line 13)
@@ -4435,14 +4471,14 @@ Index
* pdftex.cfg: Specially-recognized files.
(line 34)
* PDFTEXCONFIG: Supported file formats.
- (line 136)
+ (line 151)
* pdftexconfig.tex: Specially-recognized files.
(line 34)
* permission denied: Searching overview. (line 56)
* permissions, directory: Security. (line 51)
* permissions, file: Security. (line 47)
* PKFONTS: Supported file formats.
- (line 139)
+ (line 154)
* plain.base: Unable to generate fonts.
(line 46)
* pointer combination warnings: Pointer combination warnings.
@@ -4461,11 +4497,9 @@ Index
* problems, common: Common problems. (line 6)
* proginit.c: Default path features.
(line 25)
-* proginit.h: Calling sequence. (line 54)
+* proginit.h: Calling sequence. (line 53)
* program-varying paths: Supported file formats.
(line 12)
-* program_invocation_name: Calling sequence. (line 16)
-* program_invocation_short_name: Calling sequence. (line 16)
* programming overview: Programming overview.
(line 6)
* programming with config files: Programming with config files.
@@ -4475,12 +4509,14 @@ Index
* proof mode: Unable to generate fonts.
(line 36)
* PSHEADERS: Supported file formats.
- (line 145)
+ (line 160)
* pxp Pascal preprocessor: History. (line 12)
* quoting variable values: Variable expansion. (line 17)
+* re-entrant API: Programming overview.
+ (line 16)
* readable: Suppressing warnings.
(line 26)
-* reading arbitrary-length lines: Calling sequence. (line 86)
+* reading arbitrary-length lines: Calling sequence. (line 87)
* README.CONFIGURE: Running configure. (line 15)
* README.mirrors: Electronic distribution.
(line 13)
@@ -4488,7 +4524,7 @@ Index
* relative filenames: Searching overview. (line 52)
* relative filenames in ls-R: Installing files. (line 40)
* reporting bugs: Reporting bugs. (line 6)
-* resident.c: Calling sequence. (line 48)
+* resident.c: Calling sequence. (line 47)
* resolution, setting: Path searching options.
(line 17)
* resolutions, last-resort: Fallback font. (line 6)
@@ -4510,13 +4546,13 @@ Index
* searching the disk: Searching overview. (line 22)
* security considerations: Security. (line 6)
* sed error from configure: Empty Makefiles. (line 6)
-* SELFAUTODIR: Calling sequence. (line 25)
-* SELFAUTOLOC: Calling sequence. (line 25)
-* SELFAUTOPARENT: Calling sequence. (line 25)
-* sending patches: Bug checklist. (line 56)
+* SELFAUTODIR: Calling sequence. (line 31)
+* SELFAUTOLOC: Calling sequence. (line 31)
+* SELFAUTOPARENT: Calling sequence. (line 31)
+* sending patches: Bug checklist. (line 55)
* setgid scripts: Security. (line 40)
* SFDFONTS: Supported file formats.
- (line 149)
+ (line 164)
* sh5, ok with configure: configure shells. (line 25)
* shared library, making: Shared library. (line 6)
* shell scripts as configuration files: Config files. (line 72)
@@ -4532,20 +4568,22 @@ Index
* slow startup time: Slow path searching. (line 6)
* Solaris BSD compatibility, not: Running make. (line 44)
* source files: Supported file formats.
- (line 161)
+ (line 176)
* sources for search paths: Path sources. (line 6)
* special: Suppressing warnings.
(line 30)
* st_nlink: Subdirectory expansion.
(line 26)
-* stack trace: Bug checklist. (line 62)
+* ST_NLINK_TRICK: Subdirectory expansion.
+ (line 38)
+* stack trace: Bug checklist. (line 61)
* standalone path searching: Invoking kpsewhich. (line 6)
* standard error and debugging output: Debugging. (line 27)
* standard options: Standard options. (line 6)
* startup time, excessive: Slow path searching. (line 6)
* static linking: ShellWidgetClass. (line 39)
* static linking and dlsym: dlopen. (line 6)
-* string routines: Calling sequence. (line 86)
+* string routines: Calling sequence. (line 87)
* strip: mktex configuration. (line 108)
* stripsupplier: mktex configuration. (line 102)
* striptypeface: mktex configuration. (line 105)
@@ -4565,19 +4603,19 @@ Index
* symbolic links not found: Unable to find files.
(line 21)
* symbolic links, and ls-R: ls-R. (line 38)
-* symlinks, resolving: Calling sequence. (line 25)
+* symlinks, resolving: Calling sequence. (line 31)
* system C compiler bugs: TeX or Metafont failing.
(line 19)
* system dependencies: Running configure. (line 6)
* system V universe: Running make. (line 44)
* T1FONTS: Supported file formats.
- (line 184)
+ (line 199)
* T1INPUTS: Supported file formats.
- (line 184)
+ (line 199)
* T42FONTS: Supported file formats.
- (line 189)
+ (line 204)
* tcfmgr.map: Specially-recognized files.
- (line 44)
+ (line 47)
* TDS: TeX directory structure.
(line 6)
* testing, post-installation: Installation testing.
@@ -4593,20 +4631,19 @@ Index
(line 6)
* TeX file lookup: File lookup. (line 6)
* TeX glyph lookup: Glyph lookup. (line 6)
-* TeX help mailing list: Mailing lists. (line 29)
+* TeX help mailing list: Mailing lists. (line 25)
* TeX hierarchy, one: configure scenarios. (line 13)
* TeX Live CD-ROM: CD-ROM distribution. (line 8)
* TeX support: TeX support. (line 6)
* TeX Users Group: Introduction. (line 39)
-* tex-archive@math.utah.edu: Mailing lists. (line 25)
* tex-file.c: File lookup. (line 37)
* tex-file.h: Programming overview.
- (line 16)
+ (line 24)
* tex-glyph.c: Glyph lookup. (line 26)
* tex-glyph.h: Programming overview.
- (line 16)
-* tex-k-request@mail.tug.org: Mailing lists. (line 7)
-* tex-k@mail.tug.org (bug address): Reporting bugs. (line 8)
+ (line 24)
+* tex-k-request@tug.org: Mailing lists. (line 7)
+* tex-k@tug.org (bug address): Reporting bugs. (line 8)
* TEX_HUSH <1>: Suppressing warnings.
(line 6)
* TEX_HUSH: Searching overview. (line 56)
@@ -4615,18 +4652,18 @@ Index
* TEXCONFIG: Supported file formats.
(line 47)
* TEXDOCS: Supported file formats.
- (line 158)
+ (line 173)
* TEXFONTMAPS: Supported file formats.
- (line 77)
+ (line 84)
* TEXFONTS: Supported file formats.
- (line 58)
+ (line 65)
* texfonts.map: Fontmap. (line 6)
* TEXFORMATS: Supported file formats.
(line 54)
* TEXINDEXSTYLE: Supported file formats.
- (line 67)
+ (line 74)
* TEXINPUTS: Supported file formats.
- (line 62)
+ (line 69)
* TEXMF: TeX directory structure.
(line 6)
* texmf.cnf: Specially-recognized files.
@@ -4648,29 +4685,29 @@ Index
(line 39)
* TEXMFCNF: Config files. (line 6)
* TEXMFDBS <1>: Supported file formats.
- (line 74)
+ (line 81)
* TEXMFDBS: ls-R. (line 6)
* TEXMFINI: Supported file formats.
(line 24)
* TEXMFLOG: Logging. (line 10)
* TEXMFOUTPUT: mktex script names. (line 40)
* TEXMFSCRIPTS: Supported file formats.
- (line 164)
+ (line 179)
* TEXMFVAR: mktex configuration. (line 124)
* texmfvar: mktex configuration. (line 123)
* TEXPICTS: Supported file formats.
- (line 62)
+ (line 69)
* TEXPKS: Supported file formats.
- (line 139)
+ (line 154)
* TEXPOOL: Supported file formats.
- (line 168)
+ (line 183)
* TEXPSHEADERS: Supported file formats.
- (line 145)
+ (line 160)
* TEXSIZES: Fallback font. (line 6)
* TEXSOURCES: Supported file formats.
- (line 161)
+ (line 176)
* TFMFONTS: Supported file formats.
- (line 172)
+ (line 187)
* tilde expansion: Tilde expansion. (line 6)
* tilde.c: Tilde expansion. (line 25)
* time system call: Logging. (line 15)
@@ -4679,15 +4716,14 @@ Index
* trailing / in home directory: Tilde expansion. (line 19)
* trailing colons: Default expansion. (line 6)
* TRFONTS: Supported file formats.
- (line 177)
+ (line 192)
* trick for detecting leaf directories: Subdirectory expansion.
(line 22)
* trojan horse attack: Security. (line 10)
* try_std_extension_first: File lookup. (line 24)
* TTFONTS: Supported file formats.
- (line 181)
+ (line 196)
* tug.org: unixtex.ftp. (line 6)
-* tug@tug.org: Introduction. (line 46)
* typeface directory, omitting: mktex configuration. (line 106)
* ucbinclude, avoiding: Running make. (line 44)
* Ultrix shells and configure: configure shells. (line 25)
@@ -4695,10 +4731,8 @@ Index
(line 6)
* unable to generate fonts: Unable to generate fonts.
(line 6)
-* uname: Bug checklist. (line 21)
+* uname: Bug checklist. (line 20)
* universe, BSD vs. system V: Running make. (line 44)
-* UNIX_ST_LINK: Subdirectory expansion.
- (line 38)
* unixtex.ftp: unixtex.ftp. (line 6)
* unknown special warnings: Suppressing warnings.
(line 31)
@@ -4709,7 +4743,7 @@ Index
* usage patterns, finding: Logging. (line 6)
* USE_TEXMFVAR: mktex configuration. (line 129)
* USE_VARTEXFONTS: mktex configuration. (line 119)
-* Usenet TeX newsgroup: Mailing lists. (line 29)
+* Usenet TeX newsgroup: Mailing lists. (line 25)
* USERPROFILE, as ~ expansion: Tilde expansion. (line 6)
* varfonts: mktex configuration. (line 113)
* variable expansion: Variable expansion. (line 6)
@@ -4720,10 +4754,10 @@ Index
* VAX 11/750: History. (line 12)
* version number, of Kpathsea: Kpathsea application distributions.
(line 6)
-* version numbers, determining: Bug checklist. (line 16)
+* version numbers, determining: Bug checklist. (line 15)
* VF files, not found: Searching overview. (line 31)
* VFFONTS: Supported file formats.
- (line 192)
+ (line 207)
* VMS support: Custom installation. (line 19)
* VMS TeX implementations: Other TeX packages. (line 6)
* Vojta, Paul: History. (line 30)
@@ -4737,10 +4771,10 @@ Index
(line 6)
* wcstombs: dlopen. (line 6)
* WEB2C: Supported file formats.
- (line 200)
+ (line 215)
* Weber, Olaf: History. (line 74)
* WEBINPUTS: Supported file formats.
- (line 196)
+ (line 211)
* whitespace, in fontmap files: Fontmap. (line 28)
* whitespace, not ignored on continuation lines: Config files.
(line 31)
@@ -4755,8 +4789,10 @@ Index
* XCFLAGS: Running make. (line 26)
* XCPPFLAGS: Running make. (line 22)
* XDEFS: Running make. (line 23)
+* XDvi: Specially-recognized files.
+ (line 41)
* XDVIFONTS: Supported file formats.
- (line 227)
+ (line 242)
* XDVIMAKEPK: mktex script names. (line 32)
* XDVISIZES: Fallback font. (line 6)
* XLDFLAGS: Running make. (line 29)
@@ -4771,86 +4807,86 @@ Index

Tag Table:
-Node: Top1552
-Node: Introduction2195
-Node: History4171
-Node: Installation8263
-Node: Simple installation9053
-Node: Custom installation12636
-Node: Disk space13810
-Node: Kpathsea application distributions14694
-Node: Changing search paths15809
-Node: Default path features16991
-Node: Default path generation19127
-Node: Running configure20570
-Node: configure shells21621
-Node: configure options22673
-Node: configure environment24180
-Node: configure scenarios25982
-Node: Shared library27568
-Node: Running make28582
-Node: Installing files30629
-Node: Cleaning up32576
-Node: Filename database generation33624
-Node: mktex scripts34191
-Node: mktex configuration35468
-Node: mktex script names41287
-Node: mktex script arguments42678
-Node: Installation testing43568
-Node: Security43932
-Node: TeX directory structure46499
-Node: unixtex.ftp50921
-Node: Electronic distribution52936
-Node: CD-ROM distribution55701
-Node: Other TeX packages56671
-Node: Reporting bugs57967
-Node: Bug checklist58707
-Node: Mailing lists62409
-Node: Debugging63768
-Node: Logging68840
-Node: Common problems70710
-Node: Unable to find files71541
-Node: Slow path searching73952
-Node: Unable to generate fonts75329
-Node: TeX or Metafont failing77838
-Node: Empty Makefiles79716
-Node: XtStrings80946
-Node: dlopen81782
-Node: ShellWidgetClass82600
-Node: Pointer combination warnings84232
-Node: Path searching84621
-Node: Searching overview85268
-Node: Path sources88664
-Node: Config files89735
-Node: Path expansion93380
-Node: Default expansion94329
-Node: Variable expansion96399
-Node: Tilde expansion97802
-Node: Brace expansion98782
-Node: KPSE_DOT expansion99887
-Node: Subdirectory expansion100400
-Node: Filename database102749
-Node: ls-R103803
-Node: Filename aliases106697
-Node: Database format107875
-Node: Invoking kpsewhich108888
-Node: Path searching options109833
-Node: Specially-recognized files116853
-Node: Auxiliary tasks118177
-Node: Standard options120002
-Node: TeX support120322
-Node: Supported file formats121613
-Node: File lookup128761
-Node: Glyph lookup130489
-Node: Basic glyph lookup131616
-Node: Fontmap132495
-Node: Fallback font135112
-Node: Suppressing warnings136077
-Node: Programming137182
-Node: Programming overview137695
-Node: Calling sequence139971
-Node: Program-specific files144963
-Node: Programming with config files146001
-Node: Index147301
+Node: Top1549
+Node: Introduction2192
+Node: History4014
+Node: Installation8106
+Node: Simple installation8896
+Node: Custom installation12479
+Node: Disk space13653
+Node: Kpathsea application distributions14537
+Node: Changing search paths15652
+Node: Default path features16834
+Node: Default path generation18970
+Node: Running configure20413
+Node: configure shells21464
+Node: configure options22516
+Node: configure environment24023
+Node: configure scenarios25825
+Node: Shared library27411
+Node: Running make28425
+Node: Installing files30472
+Node: Cleaning up32419
+Node: Filename database generation33467
+Node: mktex scripts34034
+Node: mktex configuration35311
+Node: mktex script names41130
+Node: mktex script arguments42521
+Node: Installation testing43411
+Node: Security43775
+Node: TeX directory structure46342
+Node: unixtex.ftp50764
+Node: Electronic distribution52774
+Node: CD-ROM distribution55539
+Node: Other TeX packages56354
+Node: Reporting bugs57650
+Node: Bug checklist58385
+Node: Mailing lists62082
+Node: Debugging63291
+Node: Logging68369
+Node: Common problems70239
+Node: Unable to find files71070
+Node: Slow path searching73481
+Node: Unable to generate fonts74858
+Node: TeX or Metafont failing77367
+Node: Empty Makefiles79245
+Node: XtStrings80475
+Node: dlopen81311
+Node: ShellWidgetClass82129
+Node: Pointer combination warnings83761
+Node: Path searching84150
+Node: Searching overview84797
+Node: Path sources88193
+Node: Config files89264
+Node: Path expansion92909
+Node: Default expansion93858
+Node: Variable expansion95928
+Node: Tilde expansion97331
+Node: Brace expansion98311
+Node: KPSE_DOT expansion99416
+Node: Subdirectory expansion99929
+Node: Filename database102280
+Node: ls-R103334
+Node: Filename aliases106228
+Node: Database format107406
+Node: Invoking kpsewhich108419
+Node: Path searching options109364
+Node: Specially-recognized files116639
+Node: Auxiliary tasks117995
+Node: Standard options119820
+Node: TeX support120140
+Node: Supported file formats121431
+Node: File lookup128947
+Node: Glyph lookup130679
+Node: Basic glyph lookup131803
+Node: Fontmap132682
+Node: Fallback font135299
+Node: Suppressing warnings136212
+Node: Programming137317
+Node: Programming overview137830
+Node: Calling sequence140524
+Node: Program-specific files145492
+Node: Programming with config files146534
+Node: Index147846

End Tag Table
diff --git a/Master/texmf/doc/info/web2c.info b/Master/texmf/doc/info/web2c.info
index c10f40efd81..708cb6e1ad1 100644
--- a/Master/texmf/doc/info/web2c.info
+++ b/Master/texmf/doc/info/web2c.info
@@ -1,4 +1,5 @@
-This is web2c.info, produced by makeinfo version 4.12 from web2c.texi.
+This is ../../../../texk/web2c/doc/web2c.info, produced by makeinfo
+version 4.13 from ../../../../texk/web2c/doc/web2c.texi.
INFO-DIR-SECTION TeX
START-INFO-DIR-ENTRY
@@ -7,20 +8,16 @@ END-INFO-DIR-ENTRY
INFO-DIR-SECTION Individual utilities
START-INFO-DIR-ENTRY
* bibtex: (web2c)bibtex invocation. Maintaining bibliographies.
-* dmp: (web2c)dmp invocation. Troff->MPX (MetaPost pictures).
* dvicopy: (web2c)dvicopy invocation. Virtual font expansion
* dvitomp: (web2c)dvitomp invocation. DVI to MPX (MetaPost pictures).
* dvitype: (web2c)dvitype invocation. DVI to human-readable text.
* gftodvi: (web2c)gftodvi invocation. Generic font proofsheets.
* gftopk: (web2c)gftopk invocation. Generic to packed fonts.
* gftype: (web2c)gftype invocation. GF to human-readable text.
-* makempx: (web2c)makempx invocation. MetaPost label typesetting.
* mf: (web2c)mf invocation. Creating typeface families.
* mft: (web2c)mft invocation. Prettyprinting Metafont source.
* mltex: (web2c)MLTeX. Multi-lingual TeX.
* mpost: (web2c)mpost invocation. Creating technical diagrams.
-* mpto: (web2c)mpto invocation. MetaPost label extraction.
-* newer: (web2c)newer invocation. Compare modification times.
* patgen: (web2c)patgen invocation. Creating hyphenation patterns.
* pktogf: (web2c)pktogf invocation. Packed to generic fonts.
* pktype: (web2c)pktype invocation. PK to human-readable text.
@@ -38,7 +35,7 @@ END-INFO-DIR-ENTRY
Web2c, an implementation of Donald Knuth's TeX system.
Copyright (C) 1996, 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004,
-2005, 2007 Karl Berry & Olaf Weber.
+2005, 2007, 2008, 2009 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
@@ -62,7 +59,7 @@ Web2c
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 7.5.7, released in July 2008.
+corresponds to Web2c version 2009, released in July 2009.
* Menu:
@@ -86,8 +83,7 @@ File: web2c.info, Node: Introduction, Next: Installation, Prev: Top, Up: Top
1 Introduction
**************
-This manual corresponds to version 7.5.7 of Web2c, released in
-July 2008.
+This manual corresponds to version 2009 of Web2c, released in July 2009.
"Web2c" is the name of a TeX implementation, originally for Unix,
but now also running under DOS, Amiga, and other operating systems. By
@@ -132,7 +128,7 @@ other people have contributed; their names are listed in the
`ChangeLog' files.
Other acknowledgements: The University of Massachusetts at Boston
-(particularly Rick Martin and Bob Morris) has provided computers and ftp
+(particularly Rick Martin and Bob Morris) provided computers and ftp
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,
@@ -934,6 +930,7 @@ are available.
* Initial TeX:: Making format files.
* Formats:: Major TeX macro packages.
* Languages and hyphenation:: TeX supports many human languages.
+* Shell escapes:: DVI output to a socket.
* IPC and TeX:: DVI output to a socket.
* TeX extensions:: Changes to the TeX language.
@@ -1048,8 +1045,9 @@ suffice.)
`-mktex=FILETYPE'
`-no-mktex=FILETYPE'
- Turn on or off the `mktex' script associated with FILETYPE. The
- only values that make sense for FILETYPE are `tex' and `tfm'.
+ Turn on or off the `mktex' script associated with FILETYPE. For
+ TeX proper, FILETYPE can only be `tex' and `tfm', but for pdfTeX
+ and luaTeX, it can also be `pk'.
`-mltex'
If we are `INITEX' (*note Initial and virgin::), enable MLTeX
@@ -1065,21 +1063,16 @@ suffice.)
`-shell-escape'
`-no-shell-escape'
- Enable (or disable) the `\write18{SHELL-COMMAND}' feature. This
- is also enabled if the environment variable or config file value
- `shell_escape' is set to `t' (but the `-no-shell-escape' command
- line option overrides this). (For backwards compatibility, `y'
- and `1' are accepted as synonyms of `t'). It is disabled by
- default to avoid security problems. When enabled, the
- SHELL-COMMAND string (which first undergoes the usual TeX
- expansions, just as in `\special') is passed to the command shell
- (via the C library function `system'). The output of
- SHELL-COMMAND is not diverted anywhere, so it will not appear in
- the log file. The system call either happens at `\output' time or
- right away, according to the absence or presence of the
- `\immediate' prefix, as usual for `\write'. (If you as a TeX
- administrator wish to implement more stringent rules on what can
- be executed, you will need to modify `tex.ch'.)
+`-shell-restricted'
+ Enable, or disable, or enable with restrictions the
+ `\write18{SHELL-COMMAND}' feature for external executing shell
+ commands. *Note Shell escapes::.
+
+`-enable-write18'
+`-disable-write18'
+ Synonyms for `-shell-escape' and `-no-shell-escape', for
+ compatibility with MiKTeX. (MiKTeX also accepts both pairs of
+ options.) *Note Shell escapes::.
`-src-specials'
`-src-specials=STRING'
@@ -1214,7 +1207,7 @@ slitex

-File: web2c.info, Node: Languages and hyphenation, Next: IPC and TeX, Prev: Formats, Up: TeX
+File: web2c.info, Node: Languages and hyphenation, Next: Shell escapes, Prev: Formats, Up: TeX
4.4 Languages and hyphenation
=============================
@@ -1472,13 +1465,89 @@ Frank Liang (*note References::), and also the `patgen.web' source file.
The only options are `-help' and `-version' (*note Common options::).

-File: web2c.info, Node: IPC and TeX, Next: TeX extensions, Prev: Languages and hyphenation, Up: TeX
+File: web2c.info, Node: Shell escapes, Next: IPC and TeX, Prev: Languages and hyphenation, Up: TeX
+
+4.5 Shell escapes
+=================
+
+TeX can execute "shell escapes", that is, arbitrary shell commands.
+Although tremendously useful, this also has obvious security
+implications. Therefore, as of TeX Live 2009, a "restricted" mode for
+shell escapes is the default mode of operation, which allows executing
+only certain commands, as specified in the `texmf.cnf' configuration
+file.
-4.5 IPC and TeX
+ * Unrestricted shell escapes are allowed if the option
+ `--shell-escape' is specified, or if the environment variable or
+ config file value `shell_escape' is set to `t' or `y' and `1'.
+
+ * Restricted shell escapes are allowed if `shell_escape' is set to
+ `p'. This is the default.
+
+ * Shell escapes are completely disabled if `--no-shell-escape' is
+ specified, or if `shell_escape' is set to anything else.
+
+ When enabled, the TeX construct to execute a system command is
+`\write18{SHELL-COMMAND}'; for example:
+
+ \write18{echo "hello, world"}
+
+ From TeX's point of view, this is a normal `\write' command, and is
+therefore subject to the usual TeX expansions. Also, the system call
+either happens during the `\output' routine or right away, according to
+the absence or presence of the `\immediate' prefix, as usual for
+`\write'.
+
+ The SHELL-COMMAND string is passed to the command shell (via the C
+library function `system'). The output of SHELL-COMMAND is not
+diverted anywhere, so it will not appear in the log file, or anywhere
+but the terminal output. The exit status of the system call is also
+not available to TeX.
+
+ In unrestricted mode, the argument is simply passed straight to
+`system' unaltered.
+
+ In restricted mode, ASCII double quote characters (") should always
+be used in the argument to `\write18' where quoting of arguments is
+needed, as in the example above. This is to achieve some measure of
+system independence. On Unix systems, these are replaced with single
+quote (') characters to avoid insecure further expansion. Care is also
+taken on Windows to avoid additional expansions (from, e.g., `...`).
+Mismatched quotation marks in the command string result in a diagnostic
+message in the log file; no execution is performed.
+
+ After quotation processing, if the first word (delimited by a space
+or tab) of the command is in the list specified by the
+`shell_escape_commands' configuration value, the command is executed.
+Otherwise it is not. In any case, a message is written to the log file.
+
+ The `shell_escape_commands' value is a comma-separated list of
+words. Whitespace is significant, and typically should not be present.
+The default definition looks like this, but with more commands included:
+
+ shell_escape_commands = bibtex,dvips,epstopdf,...,tex
+
+ pdfTeX and luaTeX support reading (via `\input' and `\openin') and
+writing (via `\openout') from pipes if the first character is `|'. The
+following command is then treated exactly the same as the argument to
+`\write18'. In these engines, the primitive variable `\pdfshellescape'
+is set to 0 if shell escapes are disabled, 1 if they are enabled, and 2
+if they are enabled with restrictions.
+
+ The purpose of this feature is to make it possible for TeX documents
+to perform useful external actions in the common case of an individual
+user running a known document on his or her own machine. In such
+environments as CGI scripts or wikis where the input has to be
+considered untrustworthy, shell escapes should be completely disabled.
+
+
+File: web2c.info, Node: IPC and TeX, Next: TeX extensions, Prev: Shell escapes, Up: TeX
+
+4.6 IPC and TeX
===============
-(Sorry, but I'm not going to write this unless someone actually uses
-this feature. Let me know.)
+(If anyone uses this feature and needs documentation, write
+<tex-k@tug.org>.)
This functionality is available only if the `--enable-ipc' option
was specified to `configure' during installation of Web2c (*note
@@ -1491,38 +1560,34 @@ its socket operations. This may be helpful if you are, well, debugging.

File: web2c.info, Node: TeX extensions, Prev: IPC and TeX, Up: TeX
-4.6 TeX extensions
+4.7 TeX extensions
==================
The base TeX program has been extended in many ways. Here's a partial
-list. Please send information on extensions not listed here to the
-address in *note Reporting bugs: (kpathsea)Reporting bugs.
+list.
e-TeX
- Adds many new primitives, including right-to-left typesetting.
- Available from `http://www.vms.rhbnc.ac.uk/e-TeX/' and
- `CTAN:/systems/e-tex'.
+ Adds many new primitives, including right-to-left typesetting and
+ more registers. Now frozen.
Omega
- Adds Unicode support, right-to-left typesetting, and more.
- Available from `http://www.ens.fr/omega' and `CTAN:/systems/omega'.
+Aleph
+ These add 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. Neither is actively
+ maintained.
pdfTeX
- A variant of TeX that produces PDF instead of DVI files. It also
- includes primitives for hypertext and micro-typography. Available
- from `CTAN:/systems/pdftex'.
-
-`TeX--XeT'
- Adds primitives and DVI opcodes for right-to-left typesetting (as
- used in Arabic, for example). An old version for TeX 3.1415 is
- available from `CTAN:/systems/knuth/tex--xet'. A newer version is
- included in e-TeX.
-
-File-handling TeX
- Adds primitives for creating multiple DVI files in a single run;
- and appending to output files as well as overwriting. Web2c
- implementation available in the distribution file
- `web2c/contrib/file-handling-tex'.
+ Can produce PDF as well as DVI files. It also incorporates the
+ e-TeX extensions, new primitives for hypertext and
+ micro-typography, reading/writing from pipes, and much more. Home
+ page: `http://pdftex.org'.
+
+luaTeX
+ Based on pdfTeX, this also embeds the Lua programming language
+ (`http://lua.org') and opens up the TeX typesetting engine to
+ control from Lua. Home page: `http://luatex.org'.
+

File: web2c.info, Node: Metafont, Next: MetaPost, Prev: TeX, Up: Top
@@ -1705,7 +1770,7 @@ of memory used is approximately four times the total length of the
If you have a device not included in `modes.mf', please see comments
in that file for how to create the new definition, and please send the
-definition to <tex-fonts@mail.tug.org> to get it included in the next
+definition to <tex-fonts@math.utah.edu> to get it included in the next
release of `modes.mf'.
Usually, when you run Metafont you must supply the name of a mode
@@ -1985,11 +2050,7 @@ supported) and a number of other subsidiary programs, described below.
* mpost invocation:: Invoking MetaPost.
* Initial MetaPost:: Making mems.
-* makempx invocation:: Create MPX files for labels.
* dvitomp invocation:: DVI-to-MPX translation.
-* dmp invocation:: Ditroff-to-MPX translation.
-* mpto invocation:: Extracting labels from MetaPost programs.
-* newer invocation:: Is one file newer than another?

File: web2c.info, Node: mpost invocation, Next: Initial MetaPost, Up: MetaPost
@@ -2043,17 +2104,15 @@ with any other PostScript figures. For example, with this TeX command:
The MetaPost construct
btex ... TEX-INPUT ... etex
- calls MakeMPX to generate a MPX file containing a MetaPost picture
-expression corresponding to TEX-INPUT (*note makempx invocation::).
+ generates a MetaPost picture expression corresponding to TEX-INPUT.
The construct
verbatimtex ... TEX-INPUT ... etex
- simply passes the TEX-INPUT through to MakeMPX and thus to TeX. For
-example, if you are using LaTeX, your MetaPost input file must start
-with a `verbatimtex' block that gives the necessary `\documentclass'
-(or `\documentstyle') `\begin{document}' command. You will also need
-to set the enviroment variable `TEX' to `latex' (*note makempx
-invocation::).
+ simply passes the TEX-INPUT through to TeX. For example, if you are
+using LaTeX, your MetaPost input file must start with a `verbatimtex'
+block that gives the necessary `\documentclass' (or `\documentstyle')
+`\begin{document}' command. You will also need to set the enviroment
+variable `TEX' to `latex'.
TEX-INPUT need not be specifically TeX input; it could also be
Troff. In that case, you will need the `-m pictures' Troff macro
@@ -2061,9 +2120,6 @@ package (unfortunately absent from many Troff implementations), or an
equivalent such as the `-m pspic' macros from GNU groff described in
grops(1).
- Other typesetters can be supported with no change to MetaPost itself;
-only MakeMPX needs to be updated.
-
Naturally, you must use fonts that are supported by the typesetter;
specifically, you'll probably want to use standard PostScript fonts with
Troff. And only the TeX system understands Computer Modern or other
@@ -2108,8 +2164,7 @@ opens a security hole. *Note tex invocation::.
`-T'
`-troff'
- Set the `prologues' internal variable to `1', and use `makempx
- -troff' to generate MPX files.
+ Set the `prologues' internal variable to `1'.
`-tex=TEXPROGRAM'
When this option is given, the program TEXPROGRAM is used to
@@ -2117,7 +2172,7 @@ opens a security hole. *Note tex invocation::.

-File: web2c.info, Node: Initial MetaPost, Next: makempx invocation, Prev: mpost invocation, Up: MetaPost
+File: web2c.info, Node: Initial MetaPost, Next: dvitomp invocation, Prev: mpost invocation, Up: MetaPost
6.2 Initial MetaPost
====================
@@ -2155,113 +2210,13 @@ page for MetaFun, other MetaPost-related things, and lots more from
Pragma: `http://www.pragma-ade.com/'.

-File: web2c.info, Node: makempx invocation, Next: dvitomp invocation, Prev: Initial MetaPost, Up: MetaPost
-
-6.3 MakeMPX: Support MetaPost labels
-====================================
-
-In MetaPost, labels can be typeset using any document processor; the
-Web2c implementation supports TeX and Troff. MakeMPX translates the
-labels from the typesetting language back into low-level MetaPost
-commands in a so-called "mpx file", so text can be manipulated like
-other graphic objects. It is invoked automatically by MetaPost.
-Synopsis:
-
- makempx [-troff] MPFILE MPXFILE
-
-The input comes from MPFILE (no path searching is done), and the output
-goes to MPXFILE. However, if the file MPXFILE already exists, and is
-newer than MPFILE, then nothing is done (presumably the file is
-up-to-date).
-
- Otherwise:
- 1. MPto is run to extract the label text from the MetaPost source
- file MPFILE (*note mpto invocation::).
-
- 2. The typesetting program itself is run, either TeX or Troff (see
- below). If TeX, and the file named by the `MPTEXPRE' environment
- variable exists (`mptexpre.tex' by default), that file is
- prepended to the input from the MetaPost file.
-
- 3. The typesetter output (a DVI file in the case of TeX, Ditroff
- output for Troff) is translated back to MetaPost, by DVItoMP
- (*note dvitomp invocation::) or DMP (*note dmp invocation::)
- respectively.
-
- If any of the above steps fail, for example if there was a
-typesetting mistake in the original MPFILE, output may be left in files
-named `mpxerr.{log,tex,dvi}' (TeX) or `mpxerr{,.t}' (Troff), so you can
-diagnose the problem.
-
- The `-troff' option to MPto selects the Troff commands, rather than
-TeX. MetaPost supplies this automatically if the `-T' or `-troff'
-option was specified to MetaPost.
-
- The MPX file created by MakeMPX is a sequence of MetaPost picture
-expressions, one for every label in the original MetaPost input file.
-
- The names of the commands run by MakeMPX, and the directory added to
-the shell search `PATH' for the commands' location, are overridden by
-environment variables. Here is a list:
-
-`MAKEMPX_BINDIR'
- The directory added to the `PATH'. Default is the `$(bindir)'
- Make directory, which in turn is set from the configure-time
- `--bindir', `--exec-prefix' and `--prefix' options; if nothing
- else is specified, the default is file `/usr/local'.
-
-`NEWER'
- The command run to determine if MPXFILE is out of date with respect
- to MPFILE; default is `newer'.
-
-`MPTOTEX'
- The command run to extract MetaPost labels in TeX format; default
- is `mpto -tex'.
-
-`MPTOTR'
- Likewise, for Troff; default is `mpto -troff'.
-
-`DVITOMP'
- The command run to convert TeX output back to MetaPost; default is
- `dvitomp'.
-
-`DMP'
- Likewise, for Troff; default is `dmp'.
-
-`TEX'
- The command run to typeset the labels in TeX; the default is
- `etex', set in `texmf.cnf'. If you use LaTeX, set this to
- `latex', and supply an appropriate `verbatimtex' header in the MP
- source (*note mpost invocation::). Or put `%&latex' as the first
- line of your LaTeX source.
-
-`TROFF'
- Likewise, for Troff; default is `'eqn -d\$\$ | troff -Tpost''. You
- may need to replace `-Tpost' by `-TTERM', where TERM is the
- PostScript device name for your Troff implementation, e.g., `ps'
- or `psc'; see troff(1).
-
- If you change this, you will also need to set the `TRFONTS'
- environment variable or configuration value to point to the
- appropriate font directory, traditionally `/usr/lib/font/devTERM'.
-
- One more complication is whether the troff programs have a `g'
- prefix. On Windows, TeX Live supports both ways: `makempx.exe' is
- built to use `gsoelim.exe', `geqn.exe', and `gtroff.exe', while
- `makempx-without-g-prefix.exe' is built to use `soelim.exe',
- `eqn.exe', and `troff.exe'. MetaPost users on Windows using troff
- for their labels should arrange to run the proper binary.
-
-
-
-File: web2c.info, Node: dvitomp invocation, Next: dmp invocation, Prev: makempx invocation, Up: MetaPost
+File: web2c.info, Node: dvitomp invocation, Prev: Initial MetaPost, Up: MetaPost
-6.4 DVItoMP: DVI to MPX conversion
+6.3 DVItoMP: DVI to MPX conversion
==================================
DVItoMP converts DVI files into low-level MetaPost commands in a
-so-called MPX file. This program is generally invoked only by MakeMPX
-(*note makempx invocation::). Synopsis:
+so-called MPX file. Synopsis:
dvitomp DVIFILE[.dvi] [MPXFILE[.mpx]]
@@ -2275,148 +2230,6 @@ NAME' and `color pop', outputting them as `withcolor' MetaPost commands.
The only options are `-help' and `-version' (*note Common options::).

-File: web2c.info, Node: dmp invocation, Next: mpto invocation, Prev: dvitomp invocation, Up: MetaPost
-
-6.5 DMP: Ditroff to MPX conversion
-==================================
-
-DMP converts device-independent Troff (ditroff) output files into
-low-level MetaPost commands in a so-called MPX file. This program is
-generally invoked by MakeMPX (*note makempx invocation::). Synopsis:
-
- dmp [DITROFF-FILE [MPXFILE]]
-
-If DITROFF-FILE is not specified, input comes from standard input; and
-if MPXFILE is not specified, output goes to standard output.
-
- DMP was written to process the output of a Troff pipeline fed the
-output of `mpto -troff' (*note mpto invocation::). DMP understands all
-the `DC' graphics functions that `dpost' does, but it ignores `x X'
-device control functions such as `x X SetColor:...', `x X BeginPath:',
-and `x X DrawPath:...'.
-
- The available font names are defined in the support file
-`trfonts.map', which DMP looks for along the `MPSUPPORT' path.
-
- Another support file `trchars.adj', also looked for along the
-`MPSUPPORT' path, contains a character adjustment table which should
-reflect the shift amounts found in the standard PostScript prologue for
-Troff and dpost found in the `TRFONTS' directory. Such an adjustment
-table is unnecessary for some Troff implementations, in which case
-`trchars.adj' should be replaced by an empty file--but it must still
-exist.
-
- DMP was written for one particular Troff implementation, and it
-unfortunately has many built-in assumptions about the output and fonts
-file formats used by Troff, which may not be satisfied in other
-environments. In particular, GNU groff uses some extensions in its file
-formats described in groff_font(5) and groff_out(5) which make its
-output completely unusable for DMP. On the other hand, the Troff
-version found in Sun Solaris 2.x, and perhaps other systems derived from
-System V R4, works fine with the default settings.
-
- If you run into trouble and want to adapt DMP to other systems, you
-might have to try the following (this is primarily for hackers):
-
- * If DMP complains about a missing font table (e.g., `Cannot find
- TR'), your Troff may not support the device `post'.
-
- Check troff(1) for the devices supported by your Troff and set the
- `TROFF' environment variable appropriately (see above). Also,
- locate the appropriate font directory and set the `TRFONTS'
- variable as needed.
-
- * If DMP complains about a missing font description file (e.g., `Font
- TR was not in map file'), your version of Troff may be using
- internal font names different from those in the distributed
- `trfonts.map'; e.g., TR and TI instead of R and I for Times-Roman
- and Times-Italic.
-
- In this case, you may have to adapt `trfonts.map' and perhaps also
- `trchars.adj' in the MetaPost support directory
- (`texmf/metapost/support' by default).
-
- * If DMP still complains that it cannot parse the font description
- files or the Troff output (e.g., `TR has a bad line in its
- description file', you are probably out of luck and have to hack
- the DMP program (in `web2c/mpware/dmp.c').
-
- Such problems may be caused by subtle differences in the file
- formats, such as use of tabs vs. spaces as field separators or
- decimal vs. octal vs. hex format for font metric data.
-
- A reasonably good description of the expected Troff file formats
- can be found in AT&T technical report CSTR-54 (`Troff User's
- Manual', Revised 1992). Documentation on the subtle differences
- in other Troff implementation is harder to find except for GNU
- groff, where it's all documented in the above-mentioned
- groff_font(5) and groff_out(5).
-
- Any contributions to improve the portability of DMP or to make it
- work with GNU groff are welcome, of course.
-
-
- (Some of the above description was edited from the `dmp.c' source
-file, written by John Hobby.)
-
- The only options are `--help' and `--version' (*note Common
-options::).
-
-
-File: web2c.info, Node: mpto invocation, Next: newer invocation, Prev: dmp invocation, Up: MetaPost
-
-6.6 MPto: Extract labels from MetaPost input
-============================================
-
-MPto extracts the labels from a MetaPost input file; this is the
-contents of any `btex...etex' and `verbatimtex...etex' sections. This
-program is generally invoked by MakeMPX (*note makempx invocation::).
-Synopsis:
-
- mpto [OPTION]... MPFILE
-
-The input comes from MPFILE; no path searching is done. The output
-goes to standard output. Leading and trailing spaces and tabs are
-removed, and various predefined typesetter commands are included at the
-beginning of and end of the file and of each section.
-
- The program accepts the following options, as well as the standard
-`-help' and `-version' (*note Common options::):
-`-troff'
- Surround the MetaPost sections with Troff commands.
-
-`-tex'
- Surround the MetaPost sections with TeX commands. This is the
- default.
-
-
-File: web2c.info, Node: newer invocation, Prev: mpto invocation, Up: MetaPost
-
-6.7 Newer: Compare file modification times
-==========================================
-
-Newer compares file modification times. Synopsis:
-
- newer SRC1 [ SRC2 ... SRCN ] TARGET
-
-Newer exits successfully if the files SRC1 ... SRCN exist and at least
-one of them is not older than DEPENDENT, i.e., the modification time
-(mtime) of at least one of the source files is greater than or the same
-as that of DEPENDENT. Newer also exits successfully if the file
-DEPENDENT doesn't exist. *Note Attribute Meanings: (libc)Attribute
-Meanings.
-
- The program accepts the following option, as well as the standard
-`--help' and `--version' (*note Common options::):
-`--quiet'
- Return result only, do not print any output.
-
-`--verbose'
- List missing source files to STDERR. This is the default.
-
- This is used by MakeMPX (*note makempx invocation::).
-
-
File: web2c.info, Node: BibTeX, Next: WEB, Prev: MetaPost, Up: Top
7 BibTeX: Bibliographies
@@ -2543,9 +2356,8 @@ File: web2c.info, Node: WEB, Next: DVI utilities, Prev: BibTeX, Up: Top
produce both a compilable program and a well-formatted document
describing the program in as much detail as you wish to prepare.
Writing in this kind of dual-purpose language is called "literate
-programming". (The Usenet newsgroup `comp.programming.literate' and
-the mailing list <litprog@shsu.edu> are devoted to this subject; they
-are gatewayed to each other.)
+programming". (The Usenet newsgroup `comp.programming.literate' is
+devoted to this subject.)
WEB-like languages have been implemented with many pairs of base
languages: Cweb provides C and Troff (*note References::); CWEB provides
@@ -3635,7 +3447,7 @@ Appendix B References
21. [Knu89] Donald E. Knuth. The errors of TeX. `Software--Practice
and Experience', 19(7):607-681, July 1989. This is an updated
- version of iteKnuth:1988:ET.
+ version of Knuth:1988:ET.
22. [Knu90] Donald Knuth. Virtual Fonts: More Fun for Grand Wizards.
`TUGboat', 11(1):13-23, April 1990.
@@ -3689,8 +3501,6 @@ Index
(line 6)
* --enable-ipc configure option: tex invocation. (line 101)
* --help common option: Common options. (line 11)
-* --quiet (newer): newer invocation. (line 20)
-* --verbose (newer): newer invocation. (line 23)
* --verbose common option: Common options. (line 15)
* --version common option: Common options. (line 18)
* --with-editor=CMD: Editor invocation. (line 10)
@@ -3727,7 +3537,9 @@ Index
* -charcode-format=TYPE: tftopl invocation. (line 28)
* -D compiler options: Compile-time options.
(line 6)
+* -disable-write18: tex invocation. (line 136)
* -dpi=REAL: dvitype invocation. (line 24)
+* -enable-write18: tex invocation. (line 135)
* -enc: tex invocation. (line 95)
* -file-line-error: Common options. (line 25)
* -file-line-error-style: Common options. (line 26)
@@ -3759,15 +3571,15 @@ Index
* -mixedcase: tangle invocation. (line 35)
* -mktex=FILETYPE <1>: mf invocation. (line 87)
* -mktex=FILETYPE: tex invocation. (line 111)
-* -mltex: tex invocation. (line 115)
+* -mltex: tex invocation. (line 116)
* -mnemonics: gftype invocation. (line 29)
* -no-file-line-error: Common options. (line 26)
* -no-mktex=FILETYPE <1>: mf invocation. (line 87)
* -no-mktex=FILETYPE: tex invocation. (line 111)
* -no-parse-first-line: Common options. (line 78)
-* -no-shell-escape: tex invocation. (line 128)
+* -no-shell-escape: tex invocation. (line 129)
* -oem: Common options. (line 108)
-* -output-comment=STRING: tex invocation. (line 120)
+* -output-comment=STRING: tex invocation. (line 121)
* -output-directory <1>: Output file location.
(line 15)
* -output-directory: Common options. (line 67)
@@ -3780,18 +3592,16 @@ Index
(line 18)
* -progname=STRING: Common options. (line 83)
* -recorder: Common options. (line 90)
-* -shell-escape: tex invocation. (line 127)
+* -shell-escape: tex invocation. (line 128)
+* -shell-restricted: tex invocation. (line 130)
* -show-opcodes: dvitype invocation. (line 56)
* -strict: tangle invocation. (line 46)
* -style=MFTFILE: mft invocation. (line 68)
-* -T: mpost invocation. (line 117)
+* -T: mpost invocation. (line 112)
* -terse: bibtex invocation. (line 28)
-* -tex: mpto invocation. (line 24)
-* -tex=TEXPROGRAM: mpost invocation. (line 121)
+* -tex=TEXPROGRAM: mpost invocation. (line 115)
* -translate-file=TCXFILE: Common options. (line 96)
-* -troff <1>: mpto invocation. (line 21)
-* -troff <2>: makempx invocation. (line 39)
-* -troff: mpost invocation. (line 117)
+* -troff: mpost invocation. (line 112)
* -underline: tangle invocation. (line 41)
* -uppercase: tangle invocation. (line 35)
* -x: weave invocation. (line 22)
@@ -3829,25 +3639,30 @@ Index
* \countN: dvicopy invocation. (line 28)
* \font and dynamic generation: tex invocation. (line 44)
* \fontdimen: tftopl invocation. (line 100)
-* \immediate\write18: tex invocation. (line 128)
+* \immediate\write18: Shell escapes. (line 6)
* \input filenames: \input filenames. (line 6)
+* \input, and pipes: Shell escapes. (line 63)
* \mag <1>: dvitype invocation. (line 28)
* \mag: dvicopy invocation. (line 20)
+* \openin, and pipes: Shell escapes. (line 63)
* \openout and security: tex invocation. (line 51)
+* \openout, and pipes: Shell escapes. (line 63)
+* \output routine, and \write: Shell escapes. (line 28)
+* \pdfshellescape: Shell escapes. (line 63)
* \string: \input filenames. (line 60)
* \tracingcharsubdef and MLTeX: \tracingcharsubdef. (line 6)
* \tracinglostchars and MLTeX: \tracingcharsubdef. (line 11)
-* \write18 shell escape extension: tex invocation. (line 128)
+* \write18 shell escape extension: Shell escapes. (line 6)
* ^^ notation, avoiding: TCX files. (line 88)
* `Computer Modern Typefaces', production of: mft invocation. (line 75)
* abbrv.bst: Basic BibTeX style files.
(line 16)
* accented character: TCX files. (line 6)
* accents, hyphenating words with: MLTeX. (line 6)
-* acknowledgements: Introduction. (line 51)
+* acknowledgements: Introduction. (line 50)
* acm.bst: Basic BibTeX style files.
(line 19)
-* Ada, WEB for: WEB. (line 14)
+* Ada, WEB for: WEB. (line 13)
* additional Make targets: Additional targets. (line 6)
* AFM to TFM conversion: Font utilities available elsewhere.
(line 12)
@@ -3862,7 +3677,6 @@ Index
* AMSTeX: Formats. (line 39)
* apalike.bst: Basic BibTeX style files.
(line 25)
-* Arabic typesetting: TeX extensions. (line 25)
* architecture dependencies: Hardware and memory dumps.
(line 6)
* array limit, fixed: Runtime options. (line 36)
@@ -3871,7 +3685,7 @@ Index
(line 22)
* autotrace: Font utilities available elsewhere.
(line 46)
-* Awk, WEB for: WEB. (line 14)
+* Awk, WEB for: WEB. (line 13)
* base file, determining: Determining the memory dump to use.
(line 6)
* base files: Initial Metafont. (line 6)
@@ -3887,8 +3701,7 @@ Index
* BDF and GF conversion: Font utilities available elsewhere.
(line 15)
* beginfig: mpost invocation. (line 37)
-* BeginPath ditroff command: dmp invocation. (line 15)
-* Berry, Karl: Introduction. (line 41)
+* Berry, Karl: Introduction. (line 40)
* BIBINPUTS, search path for bib files: bibtex invocation. (line 18)
* bibliographies, creating: BibTeX. (line 6)
* bibliography: References. (line 6)
@@ -3902,12 +3715,10 @@ Index
(line 6)
* binaries, linking: Common options. (line 83)
* blank lines, in TCX files: TCX files. (line 67)
-* Bourne shell commands in TeX: tex invocation. (line 128)
* boxes, memory for: Runtime options. (line 20)
* breakpoints, memory for: Runtime options. (line 20)
-* Breitenlohner, Peter: Introduction. (line 9)
+* Breitenlohner, Peter: Introduction. (line 8)
* BSTINPUTS, search path for bst files: bibtex invocation. (line 18)
-* btex and label extraction: mpto invocation. (line 6)
* btex for MetaPost labels: mpost invocation. (line 50)
* btxdoc.bib: bibtex invocation. (line 48)
* btxdoc.tex: bibtex invocation. (line 42)
@@ -3917,8 +3728,6 @@ Index
* byte swapping: Hardware and memory dumps.
(line 13)
* c-sources Makefile target: Additional targets. (line 12)
-* captions, extracting from MetaPost input: mpto invocation. (line 6)
-* captions, for MetaPost: makempx invocation. (line 6)
* change files, and MFT: mft invocation. (line 64)
* change files, and Tangle: tangle invocation. (line 11)
* change files, and Weave: weave invocation. (line 14)
@@ -3941,17 +3750,16 @@ Index
* cmbase.mf: Initial Metafont. (line 28)
* cmbase.mft: mft invocation. (line 75)
* cmmf.base not recommended: Initial Metafont. (line 28)
-* color, in DVItoMP: dvitomp invocation. (line 16)
+* color, in DVItoMP: dvitomp invocation. (line 15)
* comments, in TCX files: TCX files. (line 71)
* comments, MFT control: mft invocation. (line 24)
* common options: Common options. (line 6)
* commonalities: Commonalities. (line 6)
-* comparing file modification times: newer invocation. (line 6)
* compilation: Installation. (line 6)
* compile-time options <1>: Compile-time options.
(line 6)
* compile-time options: configure options. (line 6)
-* Computer Modern fonts, and Troff: mpost invocation. (line 73)
+* Computer Modern fonts, and Troff: mpost invocation. (line 68)
* Computer Modern macros: Initial Metafont. (line 28)
* configuration: Installation. (line 6)
* configuration file reading: Path searching. (line 6)
@@ -3978,10 +3786,9 @@ Index
* cross-references, omitting: weave invocation. (line 22)
* current directory, used for output: Output file location.
(line 6)
-* Curtis, Pavel: Introduction. (line 41)
-* CWEB: WEB. (line 14)
-* Cweb: WEB. (line 14)
-* D C ditroff graphics: dmp invocation. (line 15)
+* Curtis, Pavel: Introduction. (line 40)
+* CWEB: WEB. (line 13)
+* Cweb: WEB. (line 13)
* date and time, in memory dumps: Hardware and memory dumps.
(line 30)
* debugging DVI utilities: dvitype invocation. (line 56)
@@ -3996,30 +3803,20 @@ Index
* directory structure: Installation. (line 34)
* DISPLAY: Online Metafont graphics.
(line 73)
-* ditroff output, converting to MPX: dmp invocation. (line 6)
-* DMP <1>: dmp invocation. (line 6)
-* DMP: makempx invocation. (line 71)
-* DMP, invoked by MakeMPX: makempx invocation. (line 29)
-* dmp.c: dmp invocation. (line 82)
* dot files, written by TeX programs: tex invocation. (line 51)
-* downloading of fonts for MetaPost labels: mpost invocation. (line 78)
-* dpost: dmp invocation. (line 15)
+* downloading of fonts for MetaPost labels: mpost invocation. (line 73)
* DrawingServant: Online Metafont graphics.
(line 35)
-* DrawPath ditroff command: dmp invocation. (line 15)
* dump file: Common options. (line 34)
* dumping memory: Memory dumps. (line 6)
-* DVI comment, specifying: tex invocation. (line 120)
+* DVI comment, specifying: tex invocation. (line 121)
* DVI files, converting to MPX: dvitomp invocation. (line 6)
-* DVI files, creating multiple: TeX extensions. (line 31)
* DVI files, explained: Font file formats. (line 30)
* DVI format definition: DVI utilities. (line 14)
* DVI opcodes, showing: dvitype invocation. (line 56)
* DVI utilities: DVI utilities. (line 6)
* dvicopy: dvicopy invocation. (line 6)
* dvitomp: dvitomp invocation. (line 6)
-* DVITOMP: makempx invocation. (line 67)
-* DVItoMP, invoked by MakeMPX: makempx invocation. (line 29)
* dvitype DVI validation: dvitype invocation. (line 6)
* dvitype output example: dvitype output example.
(line 6)
@@ -4032,7 +3829,7 @@ Index
* dynamic packing variable: pktype invocation. (line 44)
* e response at error prompt: Editor invocation. (line 6)
* e-circumflex: \charsubdef. (line 21)
-* e-TeX: TeX extensions. (line 11)
+* e-TeX: TeX extensions. (line 10)
* e.mft: mft invocation. (line 75)
* EC fonts <1>: mf invocation. (line 24)
* EC fonts: tex invocation. (line 44)
@@ -4051,9 +3848,9 @@ Index
* escapement, horizontal <1>: gftype invocation. (line 107)
* escapement, horizontal: pktype invocation. (line 57)
* escapement, vertical: gftype invocation. (line 107)
-* etex and label extraction: mpto invocation. (line 6)
* etex for MetaPost labels: mpost invocation. (line 50)
* executables, shared initial and virgin: Initial and virgin. (line 6)
+* exit status, of shell escape: Shell escapes. (line 34)
* expanded plain format: Formats. (line 54)
* extensions to TeX: TeX extensions. (line 6)
* extra_mem_bot: Runtime options. (line 19)
@@ -4061,9 +3858,7 @@ Index
* FAMILY property: tftopl invocation. (line 96)
* Ferguson, Michael: MLTeX. (line 6)
* file formats for fonts: Font file formats. (line 6)
-* file mtimes, comparing: newer invocation. (line 6)
* file recorder: Common options. (line 90)
-* File-handling TeX: TeX extensions. (line 31)
* filename conventions, in input files: \input filenames. (line 6)
* filenames starting with -: Option conventions. (line 19)
* first line of the main input file: Common options. (line 96)
@@ -4085,7 +3880,7 @@ Index
* font aliases: Path searching. (line 15)
* font character code, translating: TCX files. (line 102)
* font design: Metafont. (line 6)
-* font downloading for MetaPost labels: mpost invocation. (line 78)
+* font downloading for MetaPost labels: mpost invocation. (line 73)
* font file formats: Font file formats. (line 6)
* font proofs: gftodvi invocation. (line 6)
* font utilities: Font utilities. (line 6)
@@ -4105,9 +3900,9 @@ Index
* fraction routines: Compile-time options.
(line 22)
* Free Software Foundation documentation system: Formats. (line 47)
-* freedom of Web2c: Introduction. (line 23)
+* freedom of Web2c: Introduction. (line 22)
* ftp.math.utah.edu: bibtex invocation. (line 54)
-* generating source specials: tex invocation. (line 146)
+* generating source specials: tex invocation. (line 142)
* geometric designs: Metafont. (line 6)
* geometric font scaling: Font file formats. (line 22)
* geometry for Metafont: Online Metafont graphics.
@@ -4142,13 +3937,12 @@ Index
* headerbyte information: tftopl invocation. (line 96)
* height, in pixels: pktype invocation. (line 62)
* help, online: Common options. (line 11)
-* Henry, Patrick: Introduction. (line 23)
+* Henry, Patrick: Introduction. (line 22)
* Herberts, Mathias: Online Metafont graphics.
(line 20)
* hex character codes, in TCX files: TCX files. (line 78)
-* history: Introduction. (line 41)
-* Hobby, John <1>: dmp invocation. (line 82)
-* Hobby, John: Introduction. (line 9)
+* history: Introduction. (line 40)
+* Hobby, John: Introduction. (line 8)
* horizontal escapement <1>: gftype invocation. (line 107)
* horizontal escapement: pktype invocation. (line 57)
* hp2627: Online Metafont graphics.
@@ -4160,10 +3954,11 @@ Index
* human-readable text, converting PK to: pktype invocation. (line 6)
* human-readable text, converting TFM to: tftopl invocation. (line 6)
* human-readable text, converting VF to: vftovp invocation. (line 6)
+* hypertext: TeX extensions. (line 21)
* hyphenation and languages: Languages and hyphenation.
(line 6)
* hyphenation patterns, creating: patgen invocation. (line 6)
-* ice cream: Introduction. (line 23)
+* ice cream: Introduction. (line 22)
* identifier case: tangle invocation. (line 35)
* identifier collisions: tangle invocation. (line 46)
* identifier length: tangle invocation. (line 27)
@@ -4197,13 +3992,11 @@ Index
* kerning table, in TFM files: tftopl invocation. (line 102)
* keyboard character code, translating: TCX files. (line 102)
* Knuth, Donald E. <1>: mft invocation. (line 58)
-* Knuth, Donald E.: Introduction. (line 9)
+* Knuth, Donald E.: Introduction. (line 8)
* KPATHSEA_DEBUG: Common options. (line 60)
* KRN property: tftopl invocation. (line 102)
* label font: gftodvi invocation. (line 36)
* LABEL property: tftopl invocation. (line 102)
-* labels, extracting from MetaPost input: mpto invocation. (line 6)
-* labels, for MetaPost: makempx invocation. (line 6)
* language support in TeX: Languages and hyphenation.
(line 6)
* languages, hyphenation rules for: patgen invocation. (line 6)
@@ -4213,7 +4006,7 @@ Index
* left side bearing <1>: gftype invocation. (line 82)
* left side bearing: pktype invocation. (line 66)
* legalisms: Legalisms. (line 6)
-* licensing terms: Introduction. (line 23)
+* licensing terms: Introduction. (line 22)
* LIG property: tftopl invocation. (line 102)
* ligature table, in TFM files: tftopl invocation. (line 102)
* LIGTABLE property: tftopl invocation. (line 102)
@@ -4221,10 +4014,11 @@ Index
* links to binaries: Determining the memory dump to use.
(line 32)
* literate programming: WEB. (line 6)
-* litprog@shsu.edu: WEB. (line 6)
* LittleEndian machines: Hardware and memory dumps.
(line 6)
* log file, BibTeX: bibtex invocation. (line 14)
+* Lua: TeX extensions. (line 27)
+* luaTeX: TeX extensions. (line 27)
* machine dependencies: Hardware and memory dumps.
(line 6)
* machine-readable, converting property lists to <1>: vptovf invocation.
@@ -4239,9 +4033,7 @@ Index
* magnification: dvicopy invocation. (line 20)
* main_memory: Runtime options. (line 15)
* Make targets, additional: Additional targets. (line 6)
-* makempx: makempx invocation. (line 6)
-* MAKEMPX_BINDIR: makempx invocation. (line 50)
-* Martin, Rick: Introduction. (line 51)
+* Martin, Rick: Introduction. (line 50)
* Mathematical Reviews: Formats. (line 39)
* mathematical typesetting: TeX. (line 6)
* mem file, determining: Determining the memory dump to use.
@@ -4281,9 +4073,7 @@ Index
* MetaPost and plain Metafont compatibility: Initial MetaPost.
(line 25)
* MetaPost input files: mpost invocation. (line 31)
-* MetaPost input, extracting labels from: mpto invocation. (line 6)
* MetaPost invocation: mpost invocation. (line 6)
-* MetaPost labels: makempx invocation. (line 6)
* MetaPost source, prettyprinting: mft invocation. (line 80)
* MetaPost, initial: Initial MetaPost. (line 6)
* MetaPost, TeX, and Metafont: Three programs. (line 6)
@@ -4300,17 +4090,18 @@ Index
* MFTERM: Online Metafont graphics.
(line 11)
* mftmac.tex: mft invocation. (line 6)
+* micro-typography: TeX extensions. (line 21)
* mktexmf, disabling: mf invocation. (line 24)
* mktextfM, disabling: tex invocation. (line 44)
* mltex: MLTeX. (line 6)
-* MLTeX, enabling: tex invocation. (line 115)
+* MLTeX, enabling: tex invocation. (line 116)
* mode needed to run Metafont: mf invocation. (line 48)
* mode_def: Modes. (line 15)
* mode_setup: Modes. (line 15)
* modes file needed for Metafont: Modes. (line 6)
* modes.mf recommended modes file: Modes. (line 10)
-* Morgan, Tim: Introduction. (line 41)
-* Morris, Bob: Introduction. (line 51)
+* Morgan, Tim: Introduction. (line 40)
+* Morris, Bob: Introduction. (line 50)
* MPEDIT: Editor invocation. (line 10)
* mpgraph.ps: mpost invocation. (line 19)
* mpman.ps: mpost invocation. (line 6)
@@ -4318,31 +4109,15 @@ Index
* mpost, reason for name change: Installation. (line 19)
* mpost.mem: Initial MetaPost. (line 16)
* mpout: mpost invocation. (line 37)
-* mproof.tex: mpost invocation. (line 78)
-* MPSUPPORT: dmp invocation. (line 21)
-* MPto: mpto invocation. (line 6)
-* MPto, invoked by MakeMPX: makempx invocation. (line 21)
-* MPTOTEX: makempx invocation. (line 60)
-* MPTOTR: makempx invocation. (line 64)
+* mproof.tex: mpost invocation. (line 73)
* mptrap Make target: Additional targets. (line 41)
* mptrap test: Triptrap. (line 6)
* mptrap.readme: Triptrap. (line 6)
-* mpx file, defined: makempx invocation. (line 43)
* MPX files, converting from DVI files: dvitomp invocation. (line 6)
-* MPX files, creating from ditroff output: dmp invocation. (line 6)
-* mpxerr: makempx invocation. (line 34)
-* mpxerr.dvi: makempx invocation. (line 34)
-* mpxerr.log: makempx invocation. (line 34)
-* mpxerr.t: makempx invocation. (line 34)
-* mpxerr.tex: makempx invocation. (line 34)
-* mtimes of files, comparing: newer invocation. (line 6)
* Multi-lingual TeX: MLTeX. (line 6)
-* multiple DVI files, creating: TeX extensions. (line 31)
* N tilde: \charsubdef. (line 37)
* new graphics support for Metafont: Online Metafont graphics.
(line 77)
-* NEWER: makempx invocation. (line 56)
-* newer file comparison: newer invocation. (line 6)
* newrow GF command: gftype invocation. (line 93)
* next: Online Metafont graphics.
(line 34)
@@ -4352,8 +4127,7 @@ Index
* NUL, not allowed in filenames: \input filenames. (line 35)
* octal character codes, in TCX files: TCX files. (line 78)
* offset for overflow labels: gftodvi invocation. (line 59)
-* older-than, file comparisons: newer invocation. (line 6)
-* Omega: TeX extensions. (line 16)
+* Omega: TeX extensions. (line 15)
* online Metafont graphics: Online Metafont graphics.
(line 6)
* opcodes, showing DVI: dvitype invocation. (line 56)
@@ -4366,7 +4140,7 @@ Index
* output file location: Output file location.
(line 6)
* output files, written by TeX programs: tex invocation. (line 51)
-* output_comment for DVI files: tex invocation. (line 120)
+* output_comment for DVI files: tex invocation. (line 121)
* overflow label offset: gftodvi invocation. (line 59)
* packet length: pktype invocation. (line 50)
* page, starting <1>: dvitype invocation. (line 50)
@@ -4376,15 +4150,15 @@ Index
* patgen: patgen invocation. (line 6)
* path searching: Path searching. (line 6)
* path searching debugging: Common options. (line 60)
-* PDF: TeX extensions. (line 20)
-* pdfTeX: TeX extensions. (line 20)
+* PDF: TeX extensions. (line 21)
+* pdfTeX: TeX extensions. (line 21)
* permissions, legal: Legalisms. (line 6)
* PFA and PFB conversion: Font utilities available elsewhere.
(line 39)
* pfaedit: Font utilities available elsewhere.
(line 30)
* PiCTeX, increasing memory for: Runtime options. (line 20)
-* picture expressions: makempx invocation. (line 43)
+* pipes, reading and writing: Shell escapes. (line 63)
* pixel height: pktype invocation. (line 62)
* pixel width: pktype invocation. (line 62)
* PK bitmaps from PostScript: Font utilities available elsewhere.
@@ -4417,7 +4191,7 @@ Index
(line 50)
* pooltype: pooltype invocation. (line 6)
* portable filenames: \input filenames. (line 41)
-* PostScript fonts, and Troff: mpost invocation. (line 73)
+* PostScript fonts, and Troff: mpost invocation. (line 68)
* PostScript meets Metafont: MetaPost. (line 6)
* PostScript output: mpost invocation. (line 37)
* PostScript to PK bitmaps: Font utilities available elsewhere.
@@ -4431,17 +4205,16 @@ Index
* predefined macros and memory dumps: Memory dumps. (line 6)
* prettyprinting Metafont source: mft invocation. (line 6)
* prettyprinting WEB programs: weave invocation. (line 6)
-* primitives, new: TeX extensions. (line 11)
+* primitives, new: TeX extensions. (line 10)
* printable characters, specifying: TCX files. (line 88)
* printer characteristics, for Metafont: Modes. (line 6)
* production use: Initial and virgin. (line 20)
* program name, determines memory dump: Determining the memory dump to use.
(line 32)
-* program names, special <1>: tex invocation. (line 115)
+* program names, special <1>: tex invocation. (line 116)
* program names, special: Common options. (line 45)
-* prologues: mpost invocation. (line 117)
-* prologues and Troff in MetaPost: makempx invocation. (line 39)
-* prologues, and EPSF output: mpost invocation. (line 88)
+* prologues: mpost invocation. (line 112)
+* prologues, and EPSF output: mpost invocation. (line 83)
* proof mode: mf invocation. (line 48)
* proof sheets, of fonts: gftodvi invocation. (line 6)
* property list format: tftopl invocation. (line 44)
@@ -4449,12 +4222,12 @@ Index
* property list, converting VF to virtual: vftovp invocation. (line 6)
* ps2pk: Font utilities available elsewhere.
(line 35)
-* psfonts.map, read by MetaPost: mpost invocation. (line 88)
+* psfonts.map, read by MetaPost: mpost invocation. (line 83)
* PXL files, explained: Font file formats. (line 40)
* pxtoch: Font utilities available elsewhere.
(line 23)
* Raichle, Bernd: MLTeX. (line 6)
-* reading, additional: Introduction. (line 59)
+* reading, additional: Introduction. (line 58)
* readonly directory, running TeX in: Output file location.
(line 15)
* reallocation of arrays: Runtime options. (line 36)
@@ -4465,13 +4238,13 @@ Index
(line 39)
* Regis graphics support: Online Metafont graphics.
(line 40)
-* regression testing: tex invocation. (line 120)
+* regression testing: tex invocation. (line 121)
* repeated rows: pktype invocation. (line 76)
* representation of strings: pooltype invocation. (line 30)
+* restricted shell escapes: Shell escapes. (line 6)
* right side bearing <1>: gftype invocation. (line 82)
* right side bearing: pktype invocation. (line 66)
-* right-to-left typesetting: TeX extensions. (line 25)
-* Rokicki, Tomas: Introduction. (line 41)
+* Rokicki, Tomas: Introduction. (line 40)
* run length encoded bitmaps <1>: gftype invocation. (line 89)
* run length encoded bitmaps: pktype invocation. (line 76)
* runtime options: Runtime options. (line 6)
@@ -4482,13 +4255,13 @@ Index
(line 42)
* security, and \openout: tex invocation. (line 51)
* security, and output files: tex invocation. (line 51)
-* security, and shell escapes: tex invocation. (line 128)
-* SetColor ditroff command: dmp invocation. (line 15)
+* security, and shell escapes: Shell escapes. (line 6)
* shapes: Metafont. (line 6)
* sharing memory dumps: Hardware and memory dumps.
(line 6)
-* shell commands in TeX: tex invocation. (line 128)
-* shell_escape enabling in TeX: tex invocation. (line 128)
+* shell commands in TeX: Shell escapes. (line 6)
+* shell_escape enabling in TeX: Shell escapes. (line 6)
+* shell_escape_commands: Shell escapes. (line 52)
* siam.bst: Basic BibTeX style files.
(line 35)
* side bearings <1>: gftype invocation. (line 82)
@@ -4500,14 +4273,14 @@ Index
* smode and dynamic Metafont mode definition: Modes. (line 28)
* sockets: IPC and TeX. (line 6)
* space-terminated filenames: \input filenames. (line 10)
-* Spiderweb: WEB. (line 14)
-* Stallman, Richard: Introduction. (line 51)
+* Spiderweb: WEB. (line 13)
+* Stallman, Richard: Introduction. (line 50)
* starting page <1>: dvitype invocation. (line 50)
* starting page: dvicopy invocation. (line 28)
* Steele Jr., Guy L.: Hardware and memory dumps.
(line 34)
* stopping at the first error: Common options. (line 41)
-* strategy, overall: Introduction. (line 17)
+* strategy, overall: Introduction. (line 16)
* string numbers, displaying: pooltype invocation. (line 6)
* string pool, writing: tangle invocation. (line 16)
* string representation: pooltype invocation. (line 30)
@@ -4526,7 +4299,8 @@ Index
* swapping bytes: Hardware and memory dumps.
(line 13)
* syntax of TCX files: TCX files. (line 66)
-* system C library function: tex invocation. (line 128)
+* system C library function: Shell escapes. (line 6)
+* system command: Shell escapes. (line 6)
* T1 encoding and ISO input: TCX files. (line 49)
* Tachikawa, Elizabeth: Font file formats. (line 63)
* tangle: tangle invocation. (line 6)
@@ -4542,7 +4316,6 @@ Index
(line 11)
* terminator for filenames: \input filenames. (line 10)
* terse output: bibtex invocation. (line 28)
-* TEX: makempx invocation. (line 74)
* tex: tex invocation. (line 6)
* TeX, bibliographies for: bibtex invocation. (line 54)
* TeX, creating from Metafont: mft invocation. (line 6)
@@ -4554,8 +4327,7 @@ Index
* TeX, input files found: tex invocation. (line 20)
* TeX, invocation: tex invocation. (line 6)
* TeX, Metafont, and MetaPost: Three programs. (line 6)
-* TeX, Web2c implementation of: Introduction. (line 9)
-* TeX--XeT: TeX extensions. (line 25)
+* TeX, Web2c implementation of: Introduction. (line 8)
* tex.fmt: Initial TeX. (line 15)
* TEXBIB, search path for bib files: bibtex invocation. (line 18)
* TEXEDIT: Editor invocation. (line 10)
@@ -4568,7 +4340,6 @@ Index
* TEXMFOUTPUT, used if . unwritable: Output file location.
(line 19)
* texput: tex invocation. (line 35)
-* text, extracting from MetaPost input: mpto invocation. (line 6)
* TFM files, converting property lists to: pltotf invocation. (line 6)
* TFM files, explained: Font file formats. (line 13)
* TFM files, memory for: Runtime options. (line 25)
@@ -4585,19 +4356,17 @@ Index
(line 60)
* torture tests: Triptrap. (line 6)
* translation file for TeX, specifying: Common options. (line 96)
-* translation from WEB to C: Introduction. (line 17)
+* translation from WEB to C: Introduction. (line 16)
* trap Make target: Additional targets. (line 41)
* trap test: Triptrap. (line 6)
* trapman.tex: Triptrap. (line 6)
-* trchars.adj: dmp invocation. (line 24)
-* Trickey, Howard: Introduction. (line 41)
+* Trickey, Howard: Introduction. (line 40)
* trip Make target: Additional targets. (line 41)
* trip test: Triptrap. (line 6)
* tripman.tex: Triptrap. (line 6)
* triptrap Make target: Additional targets. (line 41)
-* TROFF: makempx invocation. (line 81)
-* Troff, and MetaPost: mpost invocation. (line 73)
-* Troff, WEB for: WEB. (line 14)
+* Troff, and MetaPost: mpost invocation. (line 68)
+* Troff, WEB for: WEB. (line 13)
* Trojan horses and TeX programs: tex invocation. (line 51)
* TUGboat bibliography: bibtex invocation. (line 54)
* Type 1 conversion: Font utilities available elsewhere.
@@ -4611,7 +4380,7 @@ Index
* typeface specimen sheets: Font utilities available elsewhere.
(line 42)
* typesetting: TeX. (line 6)
-* Unicode: TeX extensions. (line 16)
+* Unicode: TeX extensions. (line 15)
* Unicode input: tex invocation. (line 95)
* uniterm: Online Metafont graphics.
(line 50)
@@ -4624,7 +4393,6 @@ Index
* validation, of PK files: pktype invocation. (line 6)
* validation, of TFM files: tftopl invocation. (line 6)
* validation, of VF files: vftovp invocation. (line 6)
-* verbatimtex MetaPost command: mpto invocation. (line 6)
* verbose BibTeX output, suppressing: bibtex invocation. (line 28)
* verbosity, enabling: Common options. (line 15)
* version number, finding: Common options. (line 18)
@@ -4640,13 +4408,14 @@ Index
* vptovf: vptovf invocation. (line 6)
* weave: weave invocation. (line 6)
* WEB: WEB. (line 6)
+* web environments, and security: Shell escapes. (line 70)
* WEB pool files, displaying: pooltype invocation. (line 6)
* WEB programs, compiling: tangle invocation. (line 6)
* WEB programs, typesetting: weave invocation. (line 6)
* WEB2C, search path for TCX files: TCX files. (line 36)
-* Weber, Olaf: Introduction. (line 41)
+* Weber, Olaf: Introduction. (line 40)
* webmac.tex: weave invocation. (line 22)
-* webman.tex: WEB. (line 14)
+* webman.tex: WEB. (line 13)
* whitespace, in TCX files: TCX files. (line 69)
* whitespace-terminated filenames: \input filenames. (line 10)
* width, device-independent <1>: gftype invocation. (line 113)
@@ -4664,7 +4433,6 @@ Index
(line 66)
* X toolkits and Metafont: Online Metafont graphics.
(line 60)
-* x X ditroff device control: dmp invocation. (line 15)
* xampl.bib: bibtex invocation. (line 51)
* xbfe, bitmap font editor: Font utilities available elsewhere.
(line 23)
@@ -4688,78 +4456,75 @@ Index

Tag Table:
-Node: Top3053
-Node: Introduction4048
-Node: Installation7225
-Node: configure options9389
-Node: Compile-time options11471
-Node: Additional targets12597
-Node: Triptrap13878
-Node: Runtime options15407
-Node: Commonalities17179
-Node: Option conventions17784
-Node: Common options19008
-Node: Path searching23520
-Node: Output file location24542
-Node: Three programs25582
-Node: Initial and virgin26341
-Node: Memory dumps27441
-Node: Creating memory dumps27908
-Node: Determining the memory dump to use29169
-Node: Hardware and memory dumps30793
-Node: Editor invocation33262
-Node: \input filenames33992
-Node: TeX36985
-Node: tex invocation38075
-Node: Initial TeX46007
-Node: Formats47496
-Node: Languages and hyphenation50435
-Node: MLTeX50863
-Node: \charsubdef52358
-Node: \tracingcharsubdef54684
-Node: TCX files55259
-Node: patgen invocation60683
-Node: IPC and TeX61400
-Node: TeX extensions62001
-Node: Metafont63302
-Node: mf invocation64590
-Node: Initial Metafont68473
-Node: Modes70226
-Node: Online Metafont graphics72481
-Node: gftodvi invocation75754
-Node: mft invocation78576
-Node: MetaPost82631
-Node: mpost invocation83652
-Node: Initial MetaPost88837
-Node: makempx invocation90648
-Node: dvitomp invocation94653
-Node: dmp invocation95424
-Node: mpto invocation99445
-Node: newer invocation100427
-Node: BibTeX101364
-Node: bibtex invocation101725
-Node: Basic BibTeX style files104050
-Node: WEB105392
-Node: tangle invocation106675
-Node: weave invocation108798
-Node: pooltype invocation110206
-Node: DVI utilities111336
-Node: dvicopy invocation112280
-Node: dvitype invocation113578
-Node: dvitype output example115933
-Node: Font utilities118984
-Node: Font file formats120164
-Node: gftopk invocation123463
-Node: pktogf invocation124667
-Node: pktype invocation125846
-Node: gftype invocation128681
-Node: tftopl invocation133197
-Node: pltotf invocation137831
-Node: vftovp invocation138896
-Node: vptovf invocation141180
-Node: Font utilities available elsewhere142234
-Node: Legalisms144642
-Node: References146813
-Node: Index151198
+Node: Top2812
+Node: Introduction3806
+Node: Installation6978
+Node: configure options9142
+Node: Compile-time options11224
+Node: Additional targets12350
+Node: Triptrap13631
+Node: Runtime options15160
+Node: Commonalities16932
+Node: Option conventions17537
+Node: Common options18761
+Node: Path searching23273
+Node: Output file location24295
+Node: Three programs25335
+Node: Initial and virgin26094
+Node: Memory dumps27194
+Node: Creating memory dumps27661
+Node: Determining the memory dump to use28922
+Node: Hardware and memory dumps30546
+Node: Editor invocation33015
+Node: \input filenames33745
+Node: TeX36738
+Node: tex invocation37884
+Node: Initial TeX45257
+Node: Formats46746
+Node: Languages and hyphenation49685
+Node: MLTeX50115
+Node: \charsubdef51610
+Node: \tracingcharsubdef53936
+Node: TCX files54511
+Node: patgen invocation59935
+Node: Shell escapes60652
+Node: IPC and TeX64216
+Node: TeX extensions64786
+Node: Metafont65765
+Node: mf invocation67053
+Node: Initial Metafont70936
+Node: Modes72689
+Node: Online Metafont graphics74945
+Node: gftodvi invocation78218
+Node: mft invocation81040
+Node: MetaPost85095
+Node: mpost invocation85857
+Node: Initial MetaPost90765
+Node: dvitomp invocation92576
+Node: BibTeX93241
+Node: bibtex invocation93602
+Node: Basic BibTeX style files95927
+Node: WEB97269
+Node: tangle invocation98477
+Node: weave invocation100600
+Node: pooltype invocation102008
+Node: DVI utilities103138
+Node: dvicopy invocation104082
+Node: dvitype invocation105380
+Node: dvitype output example107735
+Node: Font utilities110786
+Node: Font file formats111966
+Node: gftopk invocation115265
+Node: pktogf invocation116469
+Node: pktype invocation117648
+Node: gftype invocation120483
+Node: tftopl invocation124999
+Node: pltotf invocation129633
+Node: vftovp invocation130698
+Node: vptovf invocation132982
+Node: Font utilities available elsewhere134036
+Node: Legalisms136444
+Node: References138615
+Node: Index142997

End Tag Table
diff --git a/Master/texmf/doc/kpathsea/kpathsea.html b/Master/texmf/doc/kpathsea/kpathsea.html
index 499c0bc006c..eefbdad9b89 100644
--- a/Master/texmf/doc/kpathsea/kpathsea.html
+++ b/Master/texmf/doc/kpathsea/kpathsea.html
@@ -3,14 +3,14 @@
<title>Kpathsea: A library for path searching</title>
<meta http-equiv="Content-Type" content="text/html">
<meta name="description" content="Kpathsea: A library for path searching">
-<meta name="generator" content="makeinfo 4.12">
+<meta name="generator" content="makeinfo 4.13">
<link title="Top" rel="top" href="#Top">
<link href="http://www.gnu.org/software/texinfo/" rel="generator-home" title="Texinfo Homepage">
<!--
This file documents the Kpathsea library for path searching.
Copyright (C) 1996, 1997, 1998, 1999, 2000, 2001, 2002, 2003,
-2004, 2005, 2007, 2008 Karl Berry & Olaf Weber.
+2004, 2005, 2007, 2008, 2009 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
@@ -25,7 +25,7 @@ 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
-approved by the Free Software Foundation.-->
+approved by the TeX Users Group.-->
<meta http-equiv="Content-Style-Type" content="text/css">
<style type="text/css"><!--
pre.display { font-family:inherit }
@@ -165,8 +165,8 @@ approved by the Free Software Foundation.-->
<div class="node">
-<p><hr>
<a name="Top"></a>
+<p><hr>
Next:&nbsp;<a rel="next" accesskey="n" href="#Introduction">Introduction</a>,
Up:&nbsp;<a rel="up" accesskey="u" href="#dir">(dir)</a>
@@ -175,8 +175,8 @@ Up:&nbsp;<a rel="up" accesskey="u" href="#dir">(dir)</a>
<h2 class="unnumbered">Kpathsea library</h2>
<p>This manual documents how to install and use the Kpathsea library for
-filename lookup. It corresponds to version 3.5.7,
-released in July 2008.
+filename lookup. It corresponds to version 5.0.0,
+released in June 2009.
<ul class="menu">
<li><a accesskey="1" href="#Introduction">Introduction</a>: Overview.
@@ -191,8 +191,8 @@ released in July 2008.
</ul>
<div class="node">
-<p><hr>
<a name="Introduction"></a>
+<p><hr>
Next:&nbsp;<a rel="next" accesskey="n" href="#Installation">Installation</a>,
Previous:&nbsp;<a rel="previous" accesskey="p" href="#Top">Top</a>,
Up:&nbsp;<a rel="up" accesskey="u" href="#Top">Top</a>
@@ -202,8 +202,8 @@ Up:&nbsp;<a rel="up" accesskey="u" href="#Top">Top</a>
<h2 class="chapter">1 Introduction</h2>
<p><a name="index-introduction-1"></a><a name="index-fundamental-purpose-of-Kpathsea-2"></a>
-This manual corresponds to version 3.5.7 of the Kpathsea
-library, released in July 2008.
+This manual corresponds to version 5.0.0 of the Kpathsea
+library, released in June 2009.
<p>The library's fundamental purpose is to return a filename from a list of
directories specified by the user, similar to what shells do when
@@ -230,46 +230,37 @@ them to us (see <a href="#Reporting-bugs">Reporting bugs</a>).
you must (offer to) distribute the source to the library, along with any
changes you have made, and allow anyone to modify the library source and
distribute their modifications. It does not mean you have to distribute
-the source to your program, although we hope you will. See the files
-<samp><span class="file">GPL</span></samp> and <samp><span class="file">LGPL</span></samp> for the text of the GNU licenses.
+the source to your program, although we hope you will. See the
+accompanying files for the text of the GNU licenses.
<p><a name="index-g_t_0040TeX_007b_007d-Users-Group-10"></a>If you know enough about TeX to be reading this manual, then you (or
your institution) should consider joining the TeX Users Group (if
-you're already a member, great!). TUG produces the periodical
+you're already a member, thanks!). TUG produces the periodical
<cite>TUGboat</cite>, sponsors an annual meeting and publishes the
proceedings, and arranges courses on TeX for all levels of users
-throughout the world. Anyway, here is the address:
-
- <p><a name="index-tug_0040_0040tug_002eorg-11"></a>
-<pre class="display"> TeX Users Group
- P.O. Box 2311
- Portland OR 97208-2311
- USA
- phone: +1 503 223-9994
- fax: +1 503 223-3960
- email: <a href="mailto:tug@tug.org">tug@tug.org</a>
-</pre>
- <ul class="menu">
+throughout the world. See <a href="http://tug.org">http://tug.org</a> for information.
+
+<ul class="menu">
<li><a accesskey="1" href="#History">History</a>
</ul>
<div class="node">
-<p><hr>
<a name="History"></a>
+<p><hr>
Up:&nbsp;<a rel="up" accesskey="u" href="#Introduction">Introduction</a>
</div>
<h3 class="section">1.1 History</h3>
-<p><a name="index-history-of-Kpathsea-12"></a>
-<a name="index-Knuth_002c-Donald-E_002e-13"></a>(This section is for those people who are curious about how the library
+<p><a name="index-history-of-Kpathsea-11"></a>
+<a name="index-Knuth_002c-Donald-E_002e-12"></a>(This section is for those people who are curious about how the library
came about.) (If you like to read historical accounts of software, we
urge you to seek out the GNU Autoconf manual and the &ldquo;Errors of
TeX&rdquo; paper by Don Knuth, published in <cite>Software&mdash;Practice and
Experience</cite> 19(7), July 1989.)
- <p><a name="index-Morgan_002c-Tim-14"></a><a name="index-Rokicki_002c-Tom-15"></a><a name="index-Berry_002c-Karl-16"></a><a name="index-VAX-11_002f750-17"></a><a name="index-Sun-2-18"></a><a name="index-pxp-_0040r_007bPascal-preprocessor_007d-19"></a><a name="index-pc-_0040r_007bPascal-compiler_007d-20"></a>[Karl writes.] My first ChangeLog entry for Web2c seems to be February
+ <p><a name="index-Morgan_002c-Tim-13"></a><a name="index-Rokicki_002c-Tom-14"></a><a name="index-Berry_002c-Karl-15"></a><a name="index-VAX-11_002f750-16"></a><a name="index-Sun-2-17"></a><a name="index-pxp-_0040r_007bPascal-preprocessor_007d-18"></a><a name="index-pc-_0040r_007bPascal-compiler_007d-19"></a>[Karl writes.] My first ChangeLog entry for Web2c seems to be February
1990, but I may have done some work before then. In any case, Tim
Morgan and I were jointly maintaining it for a time. (I should mention
here that Tim had made Web2c into a real distribution long before I had
@@ -287,7 +278,7 @@ to implement subdirectory searching, since I couldn't stand putting
everything in one big directory, and also couldn't stand having to
explicitly specify <samp><span class="file">cm</span></samp>, <samp><span class="file">pandora</span></samp>, <small class="dots">...</small> in a path.
- <p><a name="index-Vojta_002c-Paul-21"></a>In the first incarnation, I just hacked separately on each
+ <p><a name="index-Vojta_002c-Paul-20"></a>In the first incarnation, I just hacked separately on each
program&mdash;that was the original subdirectory searching code in both Xdvi
and Dvips, though I think Paul Vojta has completely rewritten Xdvi's
support by now. That is, I tried to go with the flow in each program,
@@ -302,19 +293,19 @@ weren't yet a library, though. I just kept things up to date with shell
scripts. (I was developing on a 386 running ISC 2.2 at the time, and so
didn't have symbolic links. An awful experience.)
- <p><a name="index-MacKenzie_002c-David-22"></a>The ChangeLogs for Xdvik and Dvipsk record initial releases of those
+ <p><a name="index-MacKenzie_002c-David-21"></a>The ChangeLogs for Xdvik and Dvipsk record initial releases of those
distributions in May and June 1992. I think it was because I was tired
of the different configuration strategies of each program, not so much
because of the path searching. (Autoconf was being developed by David
MacKenzie and others, and I was adapting it to TeX and friends.)
- <p><a name="index-zuhn_002c-david-23"></a>I started to make a separate library that other programs could link with
+ <p><a name="index-zuhn_002c-david-22"></a>I started to make a separate library that other programs could link with
on my birthday in April 1993, according to the ChangeLog. I don't
remember exactly why I finally took the time to make it a separate
library; a conversation with david zuhn that initiated it. Just seemed
like it was time.
- <p><a name="index-Walsh_002c-Norman-24"></a><a name="index-Neumann_002c-Gustaf-25"></a>Dviljk got started in March 1994 after I bought a Laserjet 4. (Kpathsea
+ <p><a name="index-Walsh_002c-Norman-23"></a><a name="index-Neumann_002c-Gustaf-24"></a>Dviljk got started in March 1994 after I bought a Laserjet 4. (Kpathsea
work got suspended while Norm Walsh and I, with Gustaf Neumann's help,
implemented a way for TeX to get at all those neat builtin LJ4 fonts
<small class="dots">...</small> such a treat to have something to typeset in besides Palatino!)
@@ -330,14 +321,14 @@ smaller than a company with a million-dollar-a-year legal budget. Which
is actually what I think is likely to happen, but that's another
story<small class="dots">...</small>)
- <p><a name="index-Weber_002c-Olaf-26"></a>[Olaf writes.] At the end of 1997, UNIX is still alive and kicking,
+ <p><a name="index-Weber_002c-Olaf-25"></a>[Olaf writes.] At the end of 1997, UNIX is still alive and kicking,
individuals still develop software, and Web2c development still
continues. Karl had been looking for some time for someone to take up
part of the burden, and I volunteered.
<div class="node">
-<p><hr>
<a name="Installation"></a>
+<p><hr>
Next:&nbsp;<a rel="next" accesskey="n" href="#Path-searching">Path searching</a>,
Previous:&nbsp;<a rel="previous" accesskey="p" href="#Introduction">Introduction</a>,
Up:&nbsp;<a rel="up" accesskey="u" href="#Top">Top</a>
@@ -346,7 +337,7 @@ Up:&nbsp;<a rel="up" accesskey="u" href="#Top">Top</a>
<h2 class="chapter">2 Installation</h2>
-<p><a name="index-installation-27"></a><a name="index-configuration-28"></a><a name="index-compilation-29"></a>
+<p><a name="index-installation-26"></a><a name="index-configuration-27"></a><a name="index-compilation-28"></a>
(A copy of this chapter is in the distribution file <samp><span class="file">kpathsea/INSTALL</span></samp>.)
<p>The procedure for Kpathsea (and Web2c, etc.) configuration and
@@ -362,8 +353,8 @@ installation follows. If you encounter trouble, see <a href="#Common-problems">
</ul>
<div class="node">
-<p><hr>
<a name="Simple-installation"></a>
+<p><hr>
Next:&nbsp;<a rel="next" accesskey="n" href="#Custom-installation">Custom installation</a>,
Up:&nbsp;<a rel="up" accesskey="u" href="#Installation">Installation</a>
@@ -371,8 +362,8 @@ Up:&nbsp;<a rel="up" accesskey="u" href="#Installation">Installation</a>
<h3 class="section">2.1 Simple installation</h3>
-<p><a name="index-simple-installation-30"></a><a name="index-installation_002c-simple-31"></a>
-<a name="index-precompiled-executables_002c-instead-of-installation-32"></a><a name="index-installation_002c-getting-executables-instead-of-33"></a>Installing TeX and friends for the first time can be a daunting
+<p><a name="index-simple-installation-29"></a><a name="index-installation_002c-simple-30"></a>
+<a name="index-precompiled-executables_002c-instead-of-installation-31"></a><a name="index-installation_002c-getting-executables-instead-of-32"></a>Installing TeX and friends for the first time can be a daunting
experience. Thus, you may prefer to skip this whole thing and just get
precompiled executables: see <a href="#unixtex_002eftp">unixtex.ftp</a>.
@@ -426,7 +417,7 @@ faster. This line will rebuild it every midnight:
</pre>
<p>See <a href="#Filename-database-generation">Filename database generation</a>, and <a href="#Filename-database">Filename database</a>.
- <li><a name="index-printer-configuration-files-34"></a><a name="index-PostScript-fonts_002c-additional-35"></a><a name="index-color-printers_002c-configuring-36"></a>If you're installing Dvips, you also need to set up configuration files
+ <li><a name="index-printer-configuration-files-33"></a><a name="index-PostScript-fonts_002c-additional-34"></a><a name="index-color-printers_002c-configuring-35"></a>If you're installing Dvips, you also need to set up configuration files
for your printers and make any additional PostScript fonts available.
See <a href="dvips.html#Installation">Installation</a>. If you have any color printers,
see <a href="dvips.html#Color-device-configuration">Color device configuration</a>.
@@ -443,14 +434,14 @@ see <a href="#mktex-configuration">mktex configuration</a>.
<p>See <a href="#mktex-scripts">mktex scripts</a>.
- <li><a name="index-fonts_002c-being-created-37"></a><a name="index-mktexpk-_0040r_007b_002c-initial-runs_007d-38"></a><a name="index-tests_002c-simple-39"></a>For some simple tests, try &lsquo;<samp><span class="samp">tex story \\bye</span></samp>&rsquo; and &lsquo;<samp><span class="samp">latex
+ <li><a name="index-fonts_002c-being-created-36"></a><a name="index-mktexpk-_0040r_007b_002c-initial-runs_007d-37"></a><a name="index-tests_002c-simple-38"></a>For some simple tests, try &lsquo;<samp><span class="samp">tex story \\bye</span></samp>&rsquo; and &lsquo;<samp><span class="samp">latex
sample2e</span></samp>&rsquo;. Then run <samp><span class="file">xdvi story</span></samp> or <samp><span class="file">dvips sample2e</span></samp> on the
resulting DVI files to preview/print the documents. See <a href="#Installation-testing">Installation testing</a>.
</ol>
<div class="node">
-<p><hr>
<a name="Custom-installation"></a>
+<p><hr>
Next:&nbsp;<a rel="next" accesskey="n" href="#Security">Security</a>,
Previous:&nbsp;<a rel="previous" accesskey="p" href="#Simple-installation">Simple installation</a>,
Up:&nbsp;<a rel="up" accesskey="u" href="#Installation">Installation</a>
@@ -459,7 +450,7 @@ Up:&nbsp;<a rel="up" accesskey="u" href="#Installation">Installation</a>
<h3 class="section">2.2 Custom installation</h3>
-<p><a name="index-custom-installation-40"></a><a name="index-installation_002c-customized-41"></a>
+<p><a name="index-custom-installation-39"></a><a name="index-installation_002c-customized-40"></a>
Most sites need to modify the default installation procedure in some
way, perhaps merely changing the prefix from &lsquo;<samp><span class="samp">/usr/local</span></samp>&rsquo;, perhaps
adding extra compiler or loader options to work around <code>configure</code>
@@ -472,7 +463,7 @@ additional distribution-specific information:
<li><samp><span class="file">xdvik/INSTALL</span></samp>.
</ul>
- <p><a name="index-non_002dUnix-operating-systems-42"></a><a name="index-Amiga-support-43"></a><a name="index-DOS-support-44"></a><a name="index-OS_002f2-support-45"></a><a name="index-VMS-support-46"></a>These instructions are for Unix systems. Other operating-system
+ <p><a name="index-non_002dUnix-operating-systems-41"></a><a name="index-Amiga-support-42"></a><a name="index-DOS-support-43"></a><a name="index-OS_002f2-support-44"></a><a name="index-VMS-support-45"></a>These instructions are for Unix systems. Other operating-system
specific distributions have their own instructions. The code base
itself supports Amiga, DOS, OS/2, and VMS.
@@ -493,8 +484,8 @@ the simplest installation), but with much more detail.
</ul>
<div class="node">
-<p><hr>
<a name="Disk-space"></a>
+<p><hr>
Next:&nbsp;<a rel="next" accesskey="n" href="#Kpathsea-application-distributions">Kpathsea application distributions</a>,
Up:&nbsp;<a rel="up" accesskey="u" href="#Custom-installation">Custom installation</a>
@@ -502,7 +493,7 @@ Up:&nbsp;<a rel="up" accesskey="u" href="#Custom-installation">Custom installati
<h4 class="subsection">2.2.1 Disk space</h4>
-<p><a name="index-disk-space_002c-needed-47"></a><a name="index-total-disk-space-48"></a><a name="index-size-of-distribution-archives-49"></a>Here is a table showing the disk space needed for each distribution
+<p><a name="index-disk-space_002c-needed-46"></a><a name="index-total-disk-space-47"></a><a name="index-size-of-distribution-archives-48"></a>Here is a table showing the disk space needed for each distribution
(described in the next section). The `(totals)' line reflects the
&lsquo;<samp><span class="samp">texk</span></samp>&rsquo; source distribution and &lsquo;<samp><span class="samp">texklib</span></samp>&rsquo;; the individual
distributions don't enter into it. Sizes are in megabytes. All numbers
@@ -520,8 +511,8 @@ are approximate.
<br></td></tr></table>
<div class="node">
-<p><hr>
<a name="Kpathsea-application-distributions"></a>
+<p><hr>
Next:&nbsp;<a rel="next" accesskey="n" href="#Changing-search-paths">Changing search paths</a>,
Previous:&nbsp;<a rel="previous" accesskey="p" href="#Disk-space">Disk space</a>,
Up:&nbsp;<a rel="up" accesskey="u" href="#Custom-installation">Custom installation</a>
@@ -530,35 +521,35 @@ Up:&nbsp;<a rel="up" accesskey="u" href="#Custom-installation">Custom installati
<h4 class="subsection">2.2.2 Kpathsea application distributions</h4>
-<p><a name="index-distributions_002c-compiling-simultaneously-50"></a><a name="index-version-number_002c-of-Kpathsea-51"></a><a name="index-Kpathsea-version-number-52"></a>
-<a name="index-distributions_002c-not-compiling-53"></a><a name="index-NeXT_002c-lacking-X11-54"></a><a name="index-X11_002c-lacking-on-NeXT-55"></a>The archive <a href="ftp://ftp.tug.org/tex/texk.tar.gz">ftp://ftp.tug.org/tex/texk.tar.gz</a> contains all of the
+<p><a name="index-distributions_002c-compiling-simultaneously-49"></a><a name="index-version-number_002c-of-Kpathsea-50"></a><a name="index-Kpathsea-version-number-51"></a>
+<a name="index-distributions_002c-not-compiling-52"></a><a name="index-NeXT_002c-lacking-X11-53"></a><a name="index-X11_002c-lacking-on-NeXT-54"></a>The archive <a href="ftp://ftp.tug.org/tex/texk.tar.gz">ftp://ftp.tug.org/tex/texk.tar.gz</a> contains all of the
Kpathsea applications I maintain, and the library itself. For example,
since NeXT does not generally support X11, you'd probably want to skip
&lsquo;<samp><span class="samp">xdvik</span></samp>&rsquo; (or simply remove it after unpacking <samp><span class="file">texk.tar.gz</span></samp>.
If you are not interested in all of them, you can also retrieve them
separately:
- <p><a name="index-DVI-drivers-56"></a>
+ <p><a name="index-DVI-drivers-55"></a>
<dl>
-<dt><samp><span class="file">dviljk.tar.gz</span></samp><dd><a name="index-PCL-driver-57"></a><a name="index-LaserJet-drive-58"></a>DVI to PCL, for LaserJet printers.
+<dt><samp><span class="file">dviljk.tar.gz</span></samp><dd><a name="index-PCL-driver-56"></a><a name="index-LaserJet-drive-57"></a>DVI to PCL, for LaserJet printers.
- <br><dt><samp><span class="file">dvipsk.tar.gz</span></samp><dd><a name="index-PDF-generation-59"></a><a name="index-PostScript-driver-60"></a>DVI to PostScript, for previewers, printers, or PDF generation.
+ <br><dt><samp><span class="file">dvipsk.tar.gz</span></samp><dd><a name="index-PDF-generation-58"></a><a name="index-PostScript-driver-59"></a>DVI to PostScript, for previewers, printers, or PDF generation.
<br><dt><samp><span class="file">web2c.tar.gz</span></samp><dd>The software needed to compile TeX and friends.
<br><dt><samp><span class="file">web.tar.gz</span></samp><dd>The original WEB source files, also used in compilation.
- <br><dt><samp><span class="file">xdvik.tar.gz</span></samp><dd><a name="index-X11-previewer-61"></a>DVI previewing under the X window system.
+ <br><dt><samp><span class="file">xdvik.tar.gz</span></samp><dd><a name="index-X11-previewer-60"></a>DVI previewing under the X window system.
</dl>
- <p><a name="index-Babel-62"></a><a name="index-non_002dEnglish-typesetting-63"></a>If you want to use the Babel LaTeX package for support of non-English
+ <p><a name="index-Babel-61"></a><a name="index-non_002dEnglish-typesetting-62"></a>If you want to use the Babel LaTeX package for support of non-English
typesetting, you may need to retrieve additional files. See the file
<samp><span class="file">install.txt</span></samp> in the Babel distribution.
<div class="node">
-<p><hr>
<a name="Changing-search-paths"></a>
+<p><hr>
Next:&nbsp;<a rel="next" accesskey="n" href="#Running-configure">Running configure</a>,
Previous:&nbsp;<a rel="previous" accesskey="p" href="#Kpathsea-application-distributions">Kpathsea application distributions</a>,
Up:&nbsp;<a rel="up" accesskey="u" href="#Custom-installation">Custom installation</a>
@@ -567,7 +558,7 @@ Up:&nbsp;<a rel="up" accesskey="u" href="#Custom-installation">Custom installati
<h4 class="subsection">2.2.3 Changing search paths</h4>
-<p><a name="index-search-paths_002c-changing-default-64"></a><a name="index-paths_002c-changing-default-65"></a><a name="index-texmf_002ein_0040r_007b_002c-editing_007d-66"></a>If the search paths for your installation differ from the standard
+<p><a name="index-search-paths_002c-changing-default-63"></a><a name="index-paths_002c-changing-default-64"></a><a name="index-texmf_002ein_0040r_007b_002c-editing_007d-65"></a>If the search paths for your installation differ from the standard
TeX directory structure (see <a href="tds.html#Top">Introduction</a>), edit the file <samp><span class="file">kpathsea/texmf.in</span></samp>
as desired, before running <code>configure</code>. For example, if you have
all your fonts or macros in one big directory.
@@ -593,8 +584,8 @@ doing this.
</ul>
<div class="node">
-<p><hr>
<a name="Default-path-features"></a>
+<p><hr>
Next:&nbsp;<a rel="next" accesskey="n" href="#Default-path-generation">Default path generation</a>,
Up:&nbsp;<a rel="up" accesskey="u" href="#Changing-search-paths">Changing search paths</a>
@@ -602,7 +593,7 @@ Up:&nbsp;<a rel="up" accesskey="u" href="#Changing-search-paths">Changing search
<h5 class="subsubsection">2.2.3.1 Default path features</h5>
-<p><a name="index-default-path-features-67"></a><a name="index-features_002c-of-default-paths-68"></a>
+<p><a name="index-default-path-features-66"></a><a name="index-features_002c-of-default-paths-67"></a>
The purpose of having all the different files described in the section
above is to avoid having the same information in more than one place. If
you change the installation directories or top-level prefix at
@@ -616,13 +607,13 @@ all the variable definitions, thus overriding the submakes. (The
definitions are repeated so you can run Make in the subdirectories, if
you should have occasion to.)
- <p><a name="index-MAKETEX_005fMODE-69"></a><a name="index-paths_002c-device-name-included-in-70"></a>By default, the bitmap font paths end with &lsquo;<samp><span class="samp">/$MAKETEX_MODE</span></samp>&rsquo;, thus
+ <p><a name="index-MAKETEX_005fMODE-68"></a><a name="index-paths_002c-device-name-included-in-69"></a>By default, the bitmap font paths end with &lsquo;<samp><span class="samp">/$MAKETEX_MODE</span></samp>&rsquo;, thus
including the device name (usually a Metafont mode name such as
&lsquo;<samp><span class="samp">ljfour</span></samp>&rsquo;). This distinguishes two different devices with the same
resolution&mdash;a write/white from a write/black 300<span class="dmn">dpi</span> printer, for
example.
- <p><a name="index-kpse_005finit_005fprog_0040r_007b_002c-and-_0040code_007bMAKETEX_005fMODE_007d_007d-71"></a><a name="index-proginit_002ec-72"></a>However, since most sites don't have this complication, Kpathsea
+ <p><a name="index-kpse_005finit_005fprog_0040r_007b_002c-and-_0040code_007bMAKETEX_005fMODE_007d_007d-70"></a><a name="index-proginit_002ec-71"></a>However, since most sites don't have this complication, Kpathsea
(specifically, the <code>kpse_init_prog</code> function in
<samp><span class="file">kpathsea/proginit.c</span></samp>) has a special case: if the mode has not been
explicitly set by the user (or in a configuration file), it sets
@@ -638,14 +629,14 @@ is mode-independent (e.g., <code>pktype</code>).
<p>See <a href="#mktex-script-arguments">mktex script arguments</a>, for how this interacts with <code>mktexpk</code>.
- <p><a name="index-HIER-73"></a><a name="index-kpathsea_002fHIER-74"></a>See <a href="#TeX-directory-structure">TeX directory structure</a>, for a
+ <p><a name="index-HIER-72"></a><a name="index-kpathsea_002fHIER-73"></a>See <a href="#TeX-directory-structure">TeX directory structure</a>, for a
description of the default arrangement of the input files that comprise
the TeX system. The file <samp><span class="file">kpathsea/HIER</span></samp> is a copy of that
section.
<div class="node">
-<p><hr>
<a name="Default-path-generation"></a>
+<p><hr>
Previous:&nbsp;<a rel="previous" accesskey="p" href="#Default-path-features">Default path features</a>,
Up:&nbsp;<a rel="up" accesskey="u" href="#Changing-search-paths">Changing search paths</a>
@@ -653,29 +644,29 @@ Up:&nbsp;<a rel="up" accesskey="u" href="#Changing-search-paths">Changing search
<h5 class="subsubsection">2.2.3.2 Default path generation</h5>
-<p><a name="index-default-paths_002c-changing-75"></a><a name="index-paths_002c-changing-default-76"></a><a name="index-installation_002c-changing-default-directories-77"></a><a name="index-directories_002c-changing-default-installation-78"></a>
+<p><a name="index-default-paths_002c-changing-74"></a><a name="index-paths_002c-changing-default-75"></a><a name="index-installation_002c-changing-default-directories-76"></a><a name="index-directories_002c-changing-default-installation-77"></a>
This section describes how the default paths are constructed.
<p>You may wish to ignore the whole mess and simply edit <samp><span class="file">texmf.cnf</span></samp>
after it is installed, perhaps even copying it into place beforehand so
you can complete the installation, if it seems necessary.
- <p><a name="index-default-paths_002c-how-they_0027re-made-79"></a>To summarize the chain of events that go into defining the default paths:
+ <p><a name="index-default-paths_002c-how-they_0027re-made-78"></a>To summarize the chain of events that go into defining the default paths:
<ol type=1 start=1>
<li>&lsquo;<samp><span class="samp">configure</span></samp>&rsquo; creates a <samp><span class="file">Makefile</span></samp> from each <samp><span class="file">Makefile.in</span></samp>.
- <li><a name="index-texmf_002esed-80"></a>When Make runs in the <samp><span class="file">kpathsea</span></samp> directory, it creates a file
+ <li><a name="index-texmf_002esed-79"></a>When Make runs in the <samp><span class="file">kpathsea</span></samp> directory, it creates a file
<samp><span class="file">texmf.sed</span></samp> that substitutes the Make value of <code>$(var)</code> for a
string <code>@var@</code>. The variables in question are the one that
define the installation directories.
- <li><a name="index-texmf_002ein-81"></a><a name="index-texmf_002ecnf_0040r_007b_002c-generated_007d-82"></a><samp><span class="file">texmf.sed</span></samp> (together with a little extra magic&mdash;see
+ <li><a name="index-texmf_002ein-80"></a><a name="index-texmf_002ecnf_0040r_007b_002c-generated_007d-81"></a><samp><span class="file">texmf.sed</span></samp> (together with a little extra magic&mdash;see
<samp><span class="file">kpathsea/Makefile</span></samp>) is applied to <samp><span class="file">texmf.in</span></samp> to generate
<samp><span class="file">texmf.cnf</span></samp>. This is the file that will eventually be installed
and used.
- <li><a name="index-paths_002eh-83"></a>The definitions in <samp><span class="file">texmf.cnf</span></samp> are recast as C <code>#define</code>'s in
+ <li><a name="index-paths_002eh-82"></a>The definitions in <samp><span class="file">texmf.cnf</span></samp> are recast as C <code>#define</code>'s in
<samp><span class="file">paths.h</span></samp>. These values will be the compile-time defaults; they
are not used at runtime unless no <samp><span class="file">texmf.cnf</span></samp> file can be found.
@@ -685,8 +676,8 @@ are not used at runtime unless no <samp><span class="file">texmf.cnf</span></sam
</ol>
<div class="node">
-<p><hr>
<a name="Running-configure"></a>
+<p><hr>
Next:&nbsp;<a rel="next" accesskey="n" href="#Running-make">Running make</a>,
Previous:&nbsp;<a rel="previous" accesskey="p" href="#Changing-search-paths">Changing search paths</a>,
Up:&nbsp;<a rel="up" accesskey="u" href="#Custom-installation">Custom installation</a>
@@ -695,7 +686,7 @@ Up:&nbsp;<a rel="up" accesskey="u" href="#Custom-installation">Custom installati
<h4 class="subsection">2.2.4 Running <code>configure</code></h4>
-<p><a name="index-configure_0040r_007b_002c-running_007d-84"></a><a name="index-c_002dauto_002ein-85"></a><a name="index-Makefile_002ein-86"></a><a name="index-ac_005finclude_0040r_007b_002c-Autoconf-extension_007d-87"></a><a name="index-g_t_0040_0040_0040var_007bvar_007d_0040_0040-substitutions-88"></a><a name="index-system-dependencies-89"></a>Run <code>sh configure </code><var>options</var> (in the top-level directory, the
+<p><a name="index-configure_0040r_007b_002c-running_007d-83"></a><a name="index-c_002dauto_002ein-84"></a><a name="index-Makefile_002ein-85"></a><a name="index-ac_005finclude_0040r_007b_002c-Autoconf-extension_007d-86"></a><a name="index-g_t_0040_0040_0040var_007bvar_007d_0040_0040-substitutions-87"></a><a name="index-system-dependencies-88"></a>Run <code>sh configure </code><var>options</var> (in the top-level directory, the
one containing <samp><span class="file">kpathsea/</span></samp>), possibly using a shell other than
<code>sh</code> (see <a href="#configure-shells">configure shells</a>).
@@ -705,7 +696,7 @@ corresponding <samp><span class="file">c-auto.in</span></samp>. It also creates
the corresponding <samp><span class="file">Makefile.in</span></samp>, doing &lsquo;<samp><span class="samp">@</span><var>var</var><span class="samp">@</span></samp>&rsquo; and
&lsquo;<samp><span class="samp">ac_include</span></samp>&rsquo; substitutions).
- <p><a name="index-README_002eCONFIGURE-90"></a><a name="index-kpathsea_002fREADME_002eCONFIGURE-91"></a><code>configure</code> is the best place to control the configuration,
+ <p><a name="index-README_002eCONFIGURE-89"></a><a name="index-kpathsea_002fREADME_002eCONFIGURE-90"></a><code>configure</code> is the best place to control the configuration,
compilation, and installed location of the software, either via
command-line options, or by setting environment variables before
invoking it. For example, you can disable <code>mktexpk</code> by default
@@ -721,8 +712,8 @@ See <a href="#configure-options">configure options</a>.
</ul>
<div class="node">
-<p><hr>
<a name="configure-shells"></a>
+<p><hr>
Next:&nbsp;<a rel="next" accesskey="n" href="#configure-options">configure options</a>,
Up:&nbsp;<a rel="up" accesskey="u" href="#Running-configure">Running configure</a>
@@ -730,7 +721,7 @@ Up:&nbsp;<a rel="up" accesskey="u" href="#Running-configure">Running configure</
<h5 class="subsubsection">2.2.4.1 <code>configure</code> shells</h5>
-<p><a name="index-shells-and-_0040code_007bconfigure_007d-92"></a><a name="index-bash_0040r_007b_002c-recommended-for-running-_0040code_007bconfigure_007d_007d-93"></a>
+<p><a name="index-shells-and-_0040code_007bconfigure_007d-91"></a><a name="index-bash_0040r_007b_002c-recommended-for-running-_0040code_007bconfigure_007d_007d-92"></a>
Considerable effort has gone into trying to ensure that the
<code>configure</code> scripts can be run by most Bourne shell variants.
If <code>sh</code> runs into trouble, your best bet is to use Bash, the GNU
@@ -739,22 +730,22 @@ Bourne-again shell (see <a href="bash.html#Top">Top</a>).
<p>Bourne shell variants for which problems have been reported in the past
are:
<dl>
-<dt><code>ksh</code><dd><a name="index-ksh_0040r_007b_002c-losing-with-_0040code_007bconfigure_007d_007d-94"></a><a name="index-bsh_0040r_007b_002c-ok-with-_0040code_007bconfigure_007d_007d-95"></a><a name="index-Korn-shell_0040r_007b_002c-losing-with-_0040code_007bconfigure_007d_007d-96"></a><a name="index-AIX-shells-and-_0040code_007bconfigure_007d-97"></a>Old versions of the Korn shell may fail to handle the scripts. The Korn
+<dt><code>ksh</code><dd><a name="index-ksh_0040r_007b_002c-losing-with-_0040code_007bconfigure_007d_007d-93"></a><a name="index-bsh_0040r_007b_002c-ok-with-_0040code_007bconfigure_007d_007d-94"></a><a name="index-Korn-shell_0040r_007b_002c-losing-with-_0040code_007bconfigure_007d_007d-95"></a><a name="index-AIX-shells-and-_0040code_007bconfigure_007d-96"></a>Old versions of the Korn shell may fail to handle the scripts. The Korn
shell may be installed as <samp><span class="file">/bin/sh</span></samp> on AIX, in which case
<samp><span class="file">/bin/bsh</span></samp> may serve instead.
- <br><dt><code>ash</code><dd><a name="index-ash_0040r_007b_002c-losing-with-_0040code_007bconfigure_007d_007d-98"></a><a name="index-NetBSD-shells-and-_0040code_007bconfigure_007d-99"></a><a name="index-FreeBSD-shells-and-_0040code_007bconfigure_007d-100"></a><a name="index-Linux-shells-and-_0040code_007bconfigure_007d-101"></a>Old versions of ash are unable to handle the scripts. Ash is sometimes
+ <br><dt><code>ash</code><dd><a name="index-ash_0040r_007b_002c-losing-with-_0040code_007bconfigure_007d_007d-97"></a><a name="index-NetBSD-shells-and-_0040code_007bconfigure_007d-98"></a><a name="index-FreeBSD-shells-and-_0040code_007bconfigure_007d-99"></a><a name="index-Linux-shells-and-_0040code_007bconfigure_007d-100"></a>Old versions of ash are unable to handle the scripts. Ash is sometimes
installed as <samp><span class="file">/bin/sh</span></samp> on NetBSD, FreeBSD, and Linux systems.
<samp><span class="file">/bin/bash</span></samp> should be available for those systems, but might not be
part of a default installation.
- <br><dt><span class="roman">Ultrix</span><code> /bin/sh</code><dd><a name="index-DEC-shells-and-_0040code_007bconfigure_007d-102"></a><a name="index-Ultrix-shells-and-_0040code_007bconfigure_007d-103"></a><a name="index-sh5_0040r_007b_002c-ok-with-_0040code_007bconfigure_007d_007d-104"></a><samp><span class="file">/bin/sh</span></samp> under Ultrix is a DEC-grown shell that is notably
+ <br><dt><span class="roman">Ultrix</span><code> /bin/sh</code><dd><a name="index-DEC-shells-and-_0040code_007bconfigure_007d-101"></a><a name="index-Ultrix-shells-and-_0040code_007bconfigure_007d-102"></a><a name="index-sh5_0040r_007b_002c-ok-with-_0040code_007bconfigure_007d_007d-103"></a><samp><span class="file">/bin/sh</span></samp> under Ultrix is a DEC-grown shell that is notably
deficient in many ways. <samp><span class="file">/bin/sh5</span></samp> may be necessary.
</dl>
<div class="node">
-<p><hr>
<a name="configure-options"></a>
+<p><hr>
Next:&nbsp;<a rel="next" accesskey="n" href="#configure-environment">configure environment</a>,
Previous:&nbsp;<a rel="previous" accesskey="p" href="#configure-shells">configure shells</a>,
Up:&nbsp;<a rel="up" accesskey="u" href="#Running-configure">Running configure</a>
@@ -763,7 +754,7 @@ Up:&nbsp;<a rel="up" accesskey="u" href="#Running-configure">Running configure</
<h5 class="subsubsection">2.2.4.2 <code>configure</code> options</h5>
-<p><a name="index-g_t_0040code_007bconfigure_007d-options-105"></a>
+<p><a name="index-g_t_0040code_007bconfigure_007d-options-104"></a>
For a complete list of all <code>configure</code> options, run &lsquo;<samp><span class="samp">configure
--help</span></samp>&rsquo; or see <a href="autoconf.html#Invoking-configure">Running <code>configure</code> scripts</a>, (a copy is in the file <samp><span class="file">kpathsea/README.CONFIGURE</span></samp>).
The generic options are listed first in the &lsquo;<samp><span class="samp">--help</span></samp>&rsquo; output, and
@@ -773,26 +764,26 @@ the package-specific options come last. The environment variables
<p>Options particularly likely to be useful are &lsquo;<samp><span class="samp">--prefix</span></samp>&rsquo;,
&lsquo;<samp><span class="samp">--datadir</span></samp>&rsquo;, and the like; see <a href="#configure-scenarios">configure scenarios</a>.
- <p><a name="index-g_t_002d_002dwith-_0040r_007boptions_007d-106"></a><a name="index-g_t_002d_002denable-_0040r_007boptions_007d-107"></a><a name="index-configuration-of-optional-features-108"></a><a name="index-options-to-_0040code_007bconfigure_007d-109"></a>This section gives pointers to descriptions of the &lsquo;<samp><span class="samp">--with</span></samp>&rsquo; and
+ <p><a name="index-g_t_002d_002dwith-_0040r_007boptions_007d-105"></a><a name="index-g_t_002d_002denable-_0040r_007boptions_007d-106"></a><a name="index-configuration-of-optional-features-107"></a><a name="index-options-to-_0040code_007bconfigure_007d-108"></a>This section gives pointers to descriptions of the &lsquo;<samp><span class="samp">--with</span></samp>&rsquo; and
&lsquo;<samp><span class="samp">--enable</span></samp>&rsquo; options to <code>configure</code> that Kpathsea-using programs
accept.
<dl>
<dt>&lsquo;<samp><span class="samp">--without-mktexmf-default</span></samp>&rsquo;<dt>&lsquo;<samp><span class="samp">--without-mktexpk-default</span></samp>&rsquo;<dt>&lsquo;<samp><span class="samp">--without-mktextfm-default</span></samp>&rsquo;<dt>&lsquo;<samp><span class="samp">--with-mktextex-default</span></samp>&rsquo;<dd>Enable or disable the dynamic generation programs. See <a href="#mktex-configuration">mktex configuration</a>.
- <br><dt>&lsquo;<samp><span class="samp">--enable-shared</span></samp>&rsquo;<dd><a name="index-g_t_002d_002denable_002dshared-110"></a>Build Kpathsea as a shared library, and link against it. Also build the
+ <br><dt>&lsquo;<samp><span class="samp">--enable-shared</span></samp>&rsquo;<dd><a name="index-g_t_002d_002denable_002dshared-109"></a>Build Kpathsea as a shared library, and link against it. Also build the
usual static library. See <a href="#Shared-library">Shared library</a>.
- <br><dt>&lsquo;<samp><span class="samp">--disable-static</span></samp>&rsquo;<dd><a name="index-g_t_002d_002ddisable_002dstatic-111"></a>Build only the shared library. Implies &lsquo;<samp><span class="samp">--enable-shared</span></samp>&rsquo;.
+ <br><dt>&lsquo;<samp><span class="samp">--disable-static</span></samp>&rsquo;<dd><a name="index-g_t_002d_002ddisable_002dstatic-110"></a>Build only the shared library. Implies &lsquo;<samp><span class="samp">--enable-shared</span></samp>&rsquo;.
- <br><dt>&lsquo;<samp><span class="samp">--enable-maintainer-mode</span></samp>&rsquo;<dd><a name="index-g_t_002d_002denable_002dmaintainer_002dmode-112"></a>Enables make targets that are useful for the maintainer and likely to be
+ <br><dt>&lsquo;<samp><span class="samp">--enable-maintainer-mode</span></samp>&rsquo;<dd><a name="index-g_t_002d_002denable_002dmaintainer_002dmode-111"></a>Enables make targets that are useful for the maintainer and likely to be
a pain for anyone else; the makefiles created when this option is
enabled may not work at all for you. You have been warned.
</dl>
<div class="node">
-<p><hr>
<a name="configure-environment"></a>
+<p><hr>
Next:&nbsp;<a rel="next" accesskey="n" href="#configure-scenarios">configure scenarios</a>,
Previous:&nbsp;<a rel="previous" accesskey="p" href="#configure-options">configure options</a>,
Up:&nbsp;<a rel="up" accesskey="u" href="#Running-configure">Running configure</a>
@@ -806,17 +797,17 @@ determining your system's characteristics, and substitutes for them in
<tt>Makefile</tt>'s:
<dl>
-<dt>&lsquo;<samp><span class="samp">CC</span></samp>&rsquo;<a name="index-CC-113"></a><dd><a name="index-gcc_0040r_007b_002c-compiling-with_007d-114"></a><a name="index-cc_0040r_007b_002c-compiling-with_007d-115"></a>The compiler to use: default is <code>gcc</code> if it's installed, otherwise
+<dt>&lsquo;<samp><span class="samp">CC</span></samp>&rsquo;<a name="index-CC-112"></a><dd><a name="index-gcc_0040r_007b_002c-compiling-with_007d-113"></a><a name="index-cc_0040r_007b_002c-compiling-with_007d-114"></a>The compiler to use: default is <code>gcc</code> if it's installed, otherwise
<code>cc</code>.
- <br><dt>&lsquo;<samp><span class="samp">CFLAGS</span></samp>&rsquo;<a name="index-CFLAGS-116"></a><dd><a name="index-compiler-options_002c-specifying-117"></a>Options to give the compiler: default is &lsquo;<samp><span class="samp">-g -O2</span></samp>&rsquo; for <code>gcc</code>,
+ <br><dt>&lsquo;<samp><span class="samp">CFLAGS</span></samp>&rsquo;<a name="index-CFLAGS-115"></a><dd><a name="index-compiler-options_002c-specifying-116"></a>Options to give the compiler: default is &lsquo;<samp><span class="samp">-g -O2</span></samp>&rsquo; for <code>gcc</code>,
&lsquo;<samp><span class="samp">-g</span></samp>&rsquo; otherwise. <code>CFLAGS</code> comes after any other options. You
may need to include <code>-w</code> here if your compilations commonly have
useless warnings (e.g., <code>NULL redefined</code>), or <code>configure</code> may
fail to detect the presence of header files (it takes the messages on
standard error to mean the header file doesn't exist).
- <br><dt>&lsquo;<samp><span class="samp">CPPFLAGS</span></samp>&rsquo;<a name="index-CPPFLAGS-118"></a><dd><a name="index-configuration-compiler-options-119"></a>Options to pass to the compiler preprocessor; this matters most for
+ <br><dt>&lsquo;<samp><span class="samp">CPPFLAGS</span></samp>&rsquo;<a name="index-CPPFLAGS-117"></a><dd><a name="index-configuration-compiler-options-118"></a>Options to pass to the compiler preprocessor; this matters most for
configuration, not the actual source compilation. The <code>configure</code>
script often does only preprocessing (e.g., to check for the existence
of <tt>#include</tt> files), and <code>CFLAGS</code> is not used for this. You may
@@ -824,21 +815,21 @@ need to set this to something like
&lsquo;<samp><span class="samp">-I/usr/local/include/wwwhatever</span></samp>&rsquo; if you have the libwww library
installed for hyper-xdvik (see <samp><span class="file">xdvik/INSTALL</span></samp>).
- <br><dt>&lsquo;<samp><span class="samp">DEFS</span></samp>&rsquo;<a name="index-DEFS-120"></a><dd><a name="index-preprocessor-options-121"></a>Additional preprocessor options, but not used by <code>configure</code>.
+ <br><dt>&lsquo;<samp><span class="samp">DEFS</span></samp>&rsquo;<a name="index-DEFS-119"></a><dd><a name="index-preprocessor-options-120"></a>Additional preprocessor options, but not used by <code>configure</code>.
Provided for enabling or disabling program features, as documented in
the various program-specific installation instructions. <code>DEFS</code>
comes before any compiler options included by the distribution
<samp><span class="file">Makefile</span></samp>s or by <code>configure</code>.
- <br><dt>&lsquo;<samp><span class="samp">LDFLAGS</span></samp>&rsquo;<a name="index-LDFLAGS-122"></a><dd><a name="index-loader-options-123"></a>Additional options to give to the loader. <code>LDFLAGS</code> comes before
+ <br><dt>&lsquo;<samp><span class="samp">LDFLAGS</span></samp>&rsquo;<a name="index-LDFLAGS-121"></a><dd><a name="index-loader-options-122"></a>Additional options to give to the loader. <code>LDFLAGS</code> comes before
any other linker options.
- <br><dt>&lsquo;<samp><span class="samp">LIBS</span></samp>&rsquo;<a name="index-LIBS-124"></a><dd><a name="index-libraries_002c-specifying-additional-125"></a>Additional libraries to link with.
+ <br><dt>&lsquo;<samp><span class="samp">LIBS</span></samp>&rsquo;<a name="index-LIBS-123"></a><dd><a name="index-libraries_002c-specifying-additional-124"></a>Additional libraries to link with.
</dl>
<div class="node">
-<p><hr>
<a name="configure-scenarios"></a>
+<p><hr>
Next:&nbsp;<a rel="next" accesskey="n" href="#Shared-library">Shared library</a>,
Previous:&nbsp;<a rel="previous" accesskey="p" href="#configure-environment">configure environment</a>,
Up:&nbsp;<a rel="up" accesskey="u" href="#Running-configure">Running configure</a>
@@ -855,27 +846,27 @@ many sites have no use for it, and it's a leading cause of configuration
problems.
<pre class="example"> configure --with-x
</pre>
- <li><a name="index-g_t_0040TeX_007b_007d-hierarchy_002c-one-126"></a>Putting the binaries, TeX files, GNU info files, etc. into a single
+ <li><a name="index-g_t_0040TeX_007b_007d-hierarchy_002c-one-125"></a>Putting the binaries, TeX files, GNU info files, etc. into a single
TeX hierarchy, say <samp><span class="file">/here/texmf</span></samp>, requires overriding defaults in
<code>configure</code>:
<pre class="example"> configure --prefix=/here/texmf --datadir=/here
</pre>
- <li><a name="index-multiple-architectures_002c-compiling-on-127"></a><a name="index-architectures_002c-compiling-multiple-128"></a><a name="index-symbolic-link-trees_002c-for-multiple-architectures-129"></a><a name="index-g_t_002d_002dsrcdir_0040r_007b_002c-for-building-multiple-architectures_007d-130"></a><a name="index-lndir-_0040r_007bfor-building-symlink-trees_007d-131"></a>You can compile on multiple architectures simultaneously either by
+ <li><a name="index-multiple-architectures_002c-compiling-on-126"></a><a name="index-architectures_002c-compiling-multiple-127"></a><a name="index-symbolic-link-trees_002c-for-multiple-architectures-128"></a><a name="index-g_t_002d_002dsrcdir_0040r_007b_002c-for-building-multiple-architectures_007d-129"></a><a name="index-lndir-_0040r_007bfor-building-symlink-trees_007d-130"></a>You can compile on multiple architectures simultaneously either by
building symbolic link trees with the <code>lndir</code> script from the X11
distribution, or with the &lsquo;<samp><span class="samp">--srcdir</span></samp>&rsquo; option:
<pre class="example"> configure --srcdir=<var>srcdir</var>
</pre>
- <li><a name="index-multiple-architectures_002c-directories-for-132"></a>If you are installing binaries for multiple architectures into a single
+ <li><a name="index-multiple-architectures_002c-directories-for-131"></a>If you are installing binaries for multiple architectures into a single
hierarchy, you will probably want to override the default <samp><span class="file">bin</span></samp> and
<samp><span class="file">lib</span></samp> directories, something like this:
<pre class="example"> configure --prefix=<var>texmf</var> --datadir=<var>texmf</var> \
--bindir=<var>texmf</var>/<var>arch</var>/bin --libdir=<var>texmf</var>/<var>arch</var>/lib
make texmf=<var>texmf</var>
</pre>
- <p><a name="index-depot-133"></a><a name="index-automounter_002c-and-configuration-134"></a>(Unless you make provisions for architecture-specific files in
+ <p><a name="index-depot-132"></a><a name="index-automounter_002c-and-configuration-133"></a>(Unless you make provisions for architecture-specific files in
other ways, e.g., with Depot or an automounter.)
- <li><a name="index-g_t_002dO_0040r_007b_002c-compiling-with_007d-135"></a><a name="index-g_t_002dg_0040r_007b_002c-compiling-without_007d-136"></a><a name="index-optimization_002c-enabling-137"></a><a name="index-debugging-with-_0040samp_007b_002dg_007d_002c-disabling-138"></a>To compile with optimization (to compile without debugging, remove the
+ <li><a name="index-g_t_002dO_0040r_007b_002c-compiling-with_007d-134"></a><a name="index-g_t_002dg_0040r_007b_002c-compiling-without_007d-135"></a><a name="index-optimization_002c-enabling-136"></a><a name="index-debugging-with-_0040samp_007b_002dg_007d_002c-disabling-137"></a>To compile with optimization (to compile without debugging, remove the
&lsquo;<samp><span class="samp">-g</span></samp>&rsquo;):
<pre class="example"> env CFLAGS="-g -O" sh configure ...
</pre>
@@ -883,8 +874,8 @@ other ways, e.g., with Depot or an automounter.)
</ul>
<div class="node">
-<p><hr>
<a name="Shared-library"></a>
+<p><hr>
Previous:&nbsp;<a rel="previous" accesskey="p" href="#configure-scenarios">configure scenarios</a>,
Up:&nbsp;<a rel="up" accesskey="u" href="#Running-configure">Running configure</a>
@@ -892,12 +883,12 @@ Up:&nbsp;<a rel="up" accesskey="u" href="#Running-configure">Running configure</
<h5 class="subsubsection">2.2.4.5 Shared library</h5>
-<p><a name="index-shared-library_002c-making-139"></a>
-<a name="index-g_t_002d_002denable_002dshared-140"></a>You can compile Kpathsea as a shared library on a few systems, by
+<p><a name="index-shared-library_002c-making-138"></a>
+<a name="index-g_t_002d_002denable_002dshared-139"></a>You can compile Kpathsea as a shared library on a few systems, by
specifying the option &lsquo;<samp><span class="samp">--enable-shared</span></samp>&rsquo; when you run
&lsquo;<samp><span class="samp">configure</span></samp>&rsquo;.
- <p><a name="index-code-sharing-141"></a>The main advantage in doing this is that the executables can then share
+ <p><a name="index-code-sharing-140"></a>The main advantage in doing this is that the executables can then share
the code, thus decreasing memory and disk space requirements.
<p>On some systems, you can record the location of shared libraries in a
@@ -912,8 +903,8 @@ default is very difficult, because of interactions with an existing
installed shared library.)
<div class="node">
-<p><hr>
<a name="Running-make"></a>
+<p><hr>
Next:&nbsp;<a rel="next" accesskey="n" href="#Installing-files">Installing files</a>,
Previous:&nbsp;<a rel="previous" accesskey="p" href="#Running-configure">Running configure</a>,
Up:&nbsp;<a rel="up" accesskey="u" href="#Custom-installation">Custom installation</a>
@@ -922,12 +913,12 @@ Up:&nbsp;<a rel="up" accesskey="u" href="#Custom-installation">Custom installati
<h4 class="subsection">2.2.5 Running <code>make</code></h4>
-<p><a name="index-make_0040r_007b_002c-running_007d-142"></a>
-<a name="index-texmf_002ecnf_0040r_007b_002c-creating_007d-143"></a><a name="index-paths_002eh_0040r_007b_002c-creating_007d-144"></a><code>make</code> (still in the top-level directory). This also creates the
+<p><a name="index-make_0040r_007b_002c-running_007d-141"></a>
+<a name="index-texmf_002ecnf_0040r_007b_002c-creating_007d-142"></a><a name="index-paths_002eh_0040r_007b_002c-creating_007d-143"></a><code>make</code> (still in the top-level directory). This also creates the
<samp><span class="file">texmf.cnf</span></samp> and <samp><span class="file">paths.h</span></samp> files that define the default search
paths, and (by default) the &lsquo;<samp><span class="samp">plain</span></samp>&rsquo; and &lsquo;<samp><span class="samp">latex</span></samp>&rsquo; TeX formats.
- <p><a name="index-fallback-resolutions_002c-overriding-145"></a>You can override directory names and other values at <code>make</code>-time.
+ <p><a name="index-fallback-resolutions_002c-overriding-144"></a>You can override directory names and other values at <code>make</code>-time.
<samp><span class="file">make/paths.make</span></samp> lists the variables most commonly reset. For
example, &lsquo;<samp><span class="samp">make default_texsizes=600</span></samp>&rsquo; changes the list of fallback
resolutions.
@@ -939,37 +930,37 @@ resolutions.
(<code>configure</code> does not use these.)
<dl>
-<dt>&lsquo;<samp><span class="samp">XCPPFLAGS</span></samp>&rsquo;<a name="index-XCPPFLAGS-146"></a><dt>&lsquo;<samp><span class="samp">XDEFS</span></samp>&rsquo;<a name="index-XDEFS-147"></a><dd><a name="index-preprocessor-options_002c-additional-148"></a>Preprocessor options.
+<dt>&lsquo;<samp><span class="samp">XCPPFLAGS</span></samp>&rsquo;<a name="index-XCPPFLAGS-145"></a><dt>&lsquo;<samp><span class="samp">XDEFS</span></samp>&rsquo;<a name="index-XDEFS-146"></a><dd><a name="index-preprocessor-options_002c-additional-147"></a>Preprocessor options.
- <br><dt>&lsquo;<samp><span class="samp">XCFLAGS</span></samp>&rsquo;<a name="index-XCFLAGS-149"></a><dd><a name="index-compiler-options_002c-additional-150"></a>Compiler options.
+ <br><dt>&lsquo;<samp><span class="samp">XCFLAGS</span></samp>&rsquo;<a name="index-XCFLAGS-148"></a><dd><a name="index-compiler-options_002c-additional-149"></a>Compiler options.
- <br><dt>&lsquo;<samp><span class="samp">XLDFLAGS</span></samp>&rsquo;<a name="index-XLDFLAGS-151"></a><dd><a name="index-loader-options_002c-initial-152"></a>Loader options (included at beginning of link commands).
+ <br><dt>&lsquo;<samp><span class="samp">XLDFLAGS</span></samp>&rsquo;<a name="index-XLDFLAGS-150"></a><dd><a name="index-loader-options_002c-initial-151"></a>Loader options (included at beginning of link commands).
- <br><dt>&lsquo;<samp><span class="samp">XLOADLIBES</span></samp>&rsquo;<a name="index-XLOADLIBES-153"></a><dd><a name="index-loader-options_002c-final-154"></a>More loader options (included at end of link commands).
+ <br><dt>&lsquo;<samp><span class="samp">XLOADLIBES</span></samp>&rsquo;<a name="index-XLOADLIBES-152"></a><dd><a name="index-loader-options_002c-final-153"></a>More loader options (included at end of link commands).
- <br><dt>&lsquo;<samp><span class="samp">XMAKEARGS</span></samp>&rsquo;<a name="index-XMAKEARGS-155"></a><dd><a name="index-Make-arguments_002c-additional-156"></a>Additional Make arguments passed to all sub-<code>make</code>'s. You may need
+ <br><dt>&lsquo;<samp><span class="samp">XMAKEARGS</span></samp>&rsquo;<a name="index-XMAKEARGS-154"></a><dd><a name="index-Make-arguments_002c-additional-155"></a>Additional Make arguments passed to all sub-<code>make</code>'s. You may need
to include assignments to the other variables here via <code>XMAKEARGS</code>;
for example: &lsquo;<samp><span class="samp">make XMAKEARGS="CFLAGS=-O XDEFS=-DA4"</span></samp>&rsquo;.
</dl>
- <p><a name="index-compiler_002c-changing-157"></a><a name="index-libraries_002c-changing-158"></a>It's generally a bad idea to use a different compiler (&lsquo;<samp><span class="samp">CC</span></samp>&rsquo;) or
+ <p><a name="index-compiler_002c-changing-156"></a><a name="index-libraries_002c-changing-157"></a>It's generally a bad idea to use a different compiler (&lsquo;<samp><span class="samp">CC</span></samp>&rsquo;) or
libraries (<code>LIBS</code>) for compilation than you did for configuration,
since the values <code>configure</code> determined may then be incorrect.
- <p><a name="index-universe_002c-BSD-vs_002e_0040_003a-system-V-159"></a><a name="index-BSD-universe-160"></a><a name="index-system-V-universe-161"></a><a name="index-Solaris-BSD-compatibility_002c-not-162"></a><a name="index-libucb_0040r_007b_002c-avoiding_007d-163"></a><a name="index-ucbinclude_0040r_007b_002c-avoiding_007d-164"></a>Adding compiler options to change the &ldquo;universe&rdquo; you are using
+ <p><a name="index-universe_002c-BSD-vs_002e_0040_003a-system-V-158"></a><a name="index-BSD-universe-159"></a><a name="index-system-V-universe-160"></a><a name="index-Solaris-BSD-compatibility_002c-not-161"></a><a name="index-libucb_0040r_007b_002c-avoiding_007d-162"></a><a name="index-ucbinclude_0040r_007b_002c-avoiding_007d-163"></a>Adding compiler options to change the &ldquo;universe&rdquo; you are using
(typically BSD vs. system V) is generally a cause of trouble. It's
best to use the native environment, whatever that is; <code>configure</code>
and the software usually adapt best to that. In particular, under
Solaris 2.x, you should not use the BSD-compatibility library
(<samp><span class="file">libucb</span></samp>) or include files (<samp><span class="file">ucbinclude</span></samp>).
- <p><a name="index-Babel-165"></a>If you want to use the Babel LaTeX package for support of non-English
+ <p><a name="index-Babel-164"></a>If you want to use the Babel LaTeX package for support of non-English
typesetting, you need to modify some files before making the LaTeX
format. See the file <samp><span class="file">install.txt</span></samp> in the Babel distribution.
<div class="node">
-<p><hr>
<a name="Installing-files"></a>
+<p><hr>
Next:&nbsp;<a rel="next" accesskey="n" href="#Cleaning-up">Cleaning up</a>,
Previous:&nbsp;<a rel="previous" accesskey="p" href="#Running-make">Running make</a>,
Up:&nbsp;<a rel="up" accesskey="u" href="#Custom-installation">Custom installation</a>
@@ -978,7 +969,7 @@ Up:&nbsp;<a rel="up" accesskey="u" href="#Custom-installation">Custom installati
<h4 class="subsection">2.2.6 Installing files</h4>
-<p><a name="index-installing-files-166"></a>
+<p><a name="index-installing-files-165"></a>
The basic command is the usual <code>make install</code>. For security
issues, see <a href="#Security">Security</a>.
@@ -995,19 +986,19 @@ should happen automatically.
<samp><span class="file">dir</span></samp> file I use is included in the distribution as
<samp><span class="file">etc/dir-example</span></samp>.
- <p><a name="index-multiple-architectures_002c-installing-on-167"></a><a name="index-architecture_002d_0028in_0029dependent-files_002c-installing-only-168"></a><a name="index-installation_002c-architecture_002d_0028in_0029dependent-files-only-169"></a>You may wish to use one of the following targets, especially if you are
+ <p><a name="index-multiple-architectures_002c-installing-on-166"></a><a name="index-architecture_002d_0028in_0029dependent-files_002c-installing-only-167"></a><a name="index-installation_002c-architecture_002d_0028in_0029dependent-files-only-168"></a>You may wish to use one of the following targets, especially if you are
installing on multiple architectures:
<ul>
-<li><a name="index-install_002dexec-_0040r_007bMake-target_007d-170"></a><code>make install-exec</code> to install in architecture-dependent
+<li><a name="index-install_002dexec-_0040r_007bMake-target_007d-169"></a><code>make install-exec</code> to install in architecture-dependent
directories, i.e., ones that depend on the <code>$(exec_prefix)</code> Make
variable. This includes links to binaries, libraries, etc., not just
&ldquo;executables&rdquo;.
- <li><a name="index-install_002ddata-_0040r_007bMake-target_007d-171"></a><code>make install-data</code> to install in architecture-independent
+ <li><a name="index-install_002ddata-_0040r_007bMake-target_007d-170"></a><code>make install-data</code> to install in architecture-independent
directories, such as documentation, configuration files, pool files, etc.
</ul>
- <p><a name="index-AFS-172"></a><a name="index-Andrew-File-System_002c-installing-with-173"></a><a name="index-g_t_002fafs_002f_0040dots_007b_007d-_0040r_007b_002c-installing-into_007d-174"></a>If you use the Andrew File System, the normal path (e.g.,
+ <p><a name="index-AFS-171"></a><a name="index-Andrew-File-System_002c-installing-with-172"></a><a name="index-g_t_002fafs_002f_0040dots_007b_007d-_0040r_007b_002c-installing-into_007d-173"></a>If you use the Andrew File System, the normal path (e.g.,
<var>prefix</var>/bin) only gets you to a read-only copy of the files, and
you must specify a different path for installation. The best way to do this
is by setting the &lsquo;<samp><span class="samp">prefix</span></samp>&rsquo; variable on the <code>make</code> command
@@ -1016,13 +1007,13 @@ line. The sequence becomes something like this:
make
make install prefix=/afs/.<var>system.name</var>/system/1.3/@sys/whatever
</pre>
- <p><a name="index-ls_002dR-_0040r_007band-AFS_007d-175"></a><a name="index-relative-filenames-in-_0040file_007bls_002dR_007d-176"></a>With AFS, you will definitely want to use relative filenames in
+ <p><a name="index-ls_002dR-_0040r_007band-AFS_007d-174"></a><a name="index-relative-filenames-in-_0040file_007bls_002dR_007d-175"></a>With AFS, you will definitely want to use relative filenames in
<samp><span class="file">ls-R</span></samp> (see <a href="#Filename-database">Filename database</a>), not absolute filenames. This
is done by default, but check anyway.
<div class="node">
-<p><hr>
<a name="Cleaning-up"></a>
+<p><hr>
Next:&nbsp;<a rel="next" accesskey="n" href="#Filename-database-generation">Filename database generation</a>,
Previous:&nbsp;<a rel="previous" accesskey="p" href="#Installing-files">Installing files</a>,
Up:&nbsp;<a rel="up" accesskey="u" href="#Custom-installation">Custom installation</a>
@@ -1031,33 +1022,33 @@ Up:&nbsp;<a rel="up" accesskey="u" href="#Custom-installation">Custom installati
<h4 class="subsection">2.2.7 Cleaning up</h4>
-<p><a name="index-distclean-_0040r_007bMake-target_007d-177"></a>The basic command is <code>make distclean</code>. This removes all files
+<p><a name="index-distclean-_0040r_007bMake-target_007d-176"></a>The basic command is <code>make distclean</code>. This removes all files
created by the build.
<p>Alternatively,
<ul>
-<li><a name="index-mostlyclean-_0040r_007bMake-target_007d-178"></a><code>make mostlyclean</code> if you intend to compile on another
+<li><a name="index-mostlyclean-_0040r_007bMake-target_007d-177"></a><code>make mostlyclean</code> if you intend to compile on another
architecture. For Web2C, since the generated C files are portable,
they are not removed. If the <code>lex</code> vs. <code>flex</code> situation
is going to be different on the next machine, <code>rm
web2c/lex.yy.c</code>.
- <li><a name="index-clean-_0040r_007bMake-target_007d-179"></a><code>make clean</code> to remove files created by compiling, but leave
+ <li><a name="index-clean-_0040r_007bMake-target_007d-178"></a><code>make clean</code> to remove files created by compiling, but leave
configuration files and Makefiles.
- <li><a name="index-maintainer_002dclean-_0040r_007bMake-target_007d-180"></a><code>make maintainer-clean</code> to remove everything that the Makefiles can
+ <li><a name="index-maintainer_002dclean-_0040r_007bMake-target_007d-179"></a><code>make maintainer-clean</code> to remove everything that the Makefiles can
rebuild. This is more than &lsquo;<samp><span class="samp">distclean</span></samp>&rsquo; removes, and you should
only use it if you are thoroughly conversant with (and have the necessary
versions of) Autoconf.
- <li><a name="index-extraclean-_0040r_007bMake-target_007d-181"></a><code>make extraclean</code> to remove other junk, e.g., core files, log
+ <li><a name="index-extraclean-_0040r_007bMake-target_007d-180"></a><code>make extraclean</code> to remove other junk, e.g., core files, log
files, patch rejects. This is independent of the other &lsquo;<samp><span class="samp">clean</span></samp>&rsquo;
targets.
</ul>
<div class="node">
-<p><hr>
<a name="Filename-database-generation"></a>
+<p><hr>
Next:&nbsp;<a rel="next" accesskey="n" href="#mktex-scripts">mktex scripts</a>,
Previous:&nbsp;<a rel="previous" accesskey="p" href="#Cleaning-up">Cleaning up</a>,
Up:&nbsp;<a rel="up" accesskey="u" href="#Custom-installation">Custom installation</a>
@@ -1066,7 +1057,7 @@ Up:&nbsp;<a rel="up" accesskey="u" href="#Custom-installation">Custom installati
<h4 class="subsection">2.2.8 Filename database generation</h4>
-<p><a name="index-filename-database-generation-182"></a><a name="index-generation-of-filename-database-183"></a>
+<p><a name="index-filename-database-generation-181"></a><a name="index-generation-of-filename-database-182"></a>
You will probably want to set up a <code>cron</code> entry on the appropriate
machine(s) to rebuild the filename database nightly or so, as in:
<pre class="example"> 0 0 * * * cd <var>texmf</var> &amp;&amp; <var>/bindir</var>/mktexlsr
@@ -1078,8 +1069,8 @@ newly-created files on the fly, it can't hurt to make sure you get a
fresh version every so often.
<div class="node">
-<p><hr>
<a name="mktex-scripts"></a>
+<p><hr>
Next:&nbsp;<a rel="next" accesskey="n" href="#Installation-testing">Installation testing</a>,
Previous:&nbsp;<a rel="previous" accesskey="p" href="#Filename-database-generation">Filename database generation</a>,
Up:&nbsp;<a rel="up" accesskey="u" href="#Custom-installation">Custom installation</a>
@@ -1088,8 +1079,8 @@ Up:&nbsp;<a rel="up" accesskey="u" href="#Custom-installation">Custom installati
<h4 class="subsection">2.2.9 <samp><span class="file">mktex</span></samp> scripts</h4>
-<p><a name="index-g_t_0040file_007bmktex_007d-scripts-184"></a><a name="index-scripts-for-file-creation-185"></a>
-<a name="index-font-set_002c-infinite-186"></a><a name="index-dynamic-creation-of-files-187"></a><a name="index-Sauter-fonts_002c-and-dynamic-source-creation-188"></a><a name="index-EC-fonts_002c-and-dynamic-source-creation-189"></a>If Kpathsea cannot otherwise find a file, for some file types it is
+<p><a name="index-g_t_0040file_007bmktex_007d-scripts-183"></a><a name="index-scripts-for-file-creation-184"></a>
+<a name="index-font-set_002c-infinite-185"></a><a name="index-dynamic-creation-of-files-186"></a><a name="index-Sauter-fonts_002c-and-dynamic-source-creation-187"></a><a name="index-EC-fonts_002c-and-dynamic-source-creation-188"></a>If Kpathsea cannot otherwise find a file, for some file types it is
configured by default to invoke an external program to create it
dynamically (see <a href="#mktex-configuration">mktex configuration</a>). These are collectively
known as <code>mktex</code><dfn> scripts</dfn>, since most of them are named
@@ -1117,8 +1108,8 @@ diagnostics to standard error.
</ul>
<div class="node">
-<p><hr>
<a name="mktex-configuration"></a>
+<p><hr>
Next:&nbsp;<a rel="next" accesskey="n" href="#mktex-script-names">mktex script names</a>,
Up:&nbsp;<a rel="up" accesskey="u" href="#mktex-scripts">mktex scripts</a>
@@ -1126,14 +1117,14 @@ Up:&nbsp;<a rel="up" accesskey="u" href="#mktex-scripts">mktex scripts</a>
<h5 class="subsubsection">2.2.9.1 <samp><span class="file">mktex</span></samp> configuration</h5>
-<p><a name="index-g_t_0040file_007bmktex_007d-script-configuration-190"></a><a name="index-configuration-of-_0040file_007bmktex_007d-scripts-191"></a><a name="index-enabling-_0040file_007bmktex_007d-scripts-192"></a><a name="index-disabling-_0040file_007bmktex_007d-scripts-193"></a>
+<p><a name="index-g_t_0040file_007bmktex_007d-script-configuration-189"></a><a name="index-configuration-of-_0040file_007bmktex_007d-scripts-190"></a><a name="index-enabling-_0040file_007bmktex_007d-scripts-191"></a><a name="index-disabling-_0040file_007bmktex_007d-scripts-192"></a>
The list of file types and program names that can run an external
program to create missing files is listed in the next section. In the
absence of <code>configure</code> options specifying otherwise, everything
but <samp><span class="file">mktextex</span></samp> will be enabled by default. The <code>configure</code>
options to change the defaults are:
- <p><a name="index-g_t_0040code_007bconfigure_007d-options-for-_0040file_007bmktex_007d-scripts-194"></a><a name="index-g_t_002d_002dwithout_002dmktexfmt_002ddefault-195"></a><a name="index-g_t_002d_002dwithout_002dmktexmf_002ddefault-196"></a><a name="index-g_t_002d_002dwithout_002dmktexocp_002ddefault-197"></a><a name="index-g_t_002d_002dwithout_002dmktexofm_002ddefault-198"></a><a name="index-g_t_002d_002dwithout_002dmktexpk_002ddefault-199"></a><a name="index-g_t_002d_002dwithout_002dmktextfm_002ddefault-200"></a><a name="index-g_t_002d_002dwith_002dmktextex_002ddefault-201"></a>
+ <p><a name="index-g_t_0040code_007bconfigure_007d-options-for-_0040file_007bmktex_007d-scripts-193"></a><a name="index-g_t_002d_002dwithout_002dmktexfmt_002ddefault-194"></a><a name="index-g_t_002d_002dwithout_002dmktexmf_002ddefault-195"></a><a name="index-g_t_002d_002dwithout_002dmktexocp_002ddefault-196"></a><a name="index-g_t_002d_002dwithout_002dmktexofm_002ddefault-197"></a><a name="index-g_t_002d_002dwithout_002dmktexpk_002ddefault-198"></a><a name="index-g_t_002d_002dwithout_002dmktextfm_002ddefault-199"></a><a name="index-g_t_002d_002dwith_002dmktextex_002ddefault-200"></a>
<pre class="example"> --without-mktexfmt-default
--without-mktexmf-default
--without-mktexocp-default
@@ -1146,12 +1137,12 @@ options to change the defaults are:
or configuration file value named for the script is set; e.g.,
<samp><span class="file">MKTEXPK</span></samp> (see <a href="#mktex-script-arguments">mktex script arguments</a>).
- <p><a name="index-fmtutils_002ecnf-202"></a><code>mktexfmt</code> reads a file <samp><span class="file">fmtutil.cnf</span></samp>, typically located in
+ <p><a name="index-fmtutils_002ecnf-201"></a><code>mktexfmt</code> reads a file <samp><span class="file">fmtutil.cnf</span></samp>, typically located in
<samp><span class="file">texmf/web2c/</span></samp> to glean its configuration information. The rest
of the files and features in this section are primarily intended for
the font generation scripts.
- <p><a name="index-mktex_002ecnf-203"></a><a name="index-mktex_002eopt-204"></a><a name="index-site-overrides-for-_0040code_007bmktex_0040dots_007b_007d_007d-205"></a>As distributed, all the scripts source a file
+ <p><a name="index-mktex_002ecnf-202"></a><a name="index-mktex_002eopt-203"></a><a name="index-site-overrides-for-_0040code_007bmktex_0040dots_007b_007d_007d-204"></a>As distributed, all the scripts source a file
<samp><span class="file">texmf/web2c/mktex.cnf</span></samp> if it exists, so you can override various
defaults.
See <samp><span class="file">mktex.opt</span></samp>, for instance, which defines the default mode,
@@ -1163,7 +1154,7 @@ it's an arbitrary Bourne shell script. The distribution contains a
sample <samp><span class="file">mktex.cnf</span></samp> for you to copy and modify as you please (it
is not installed anywhere).
- <p><a name="index-mktex_002eopt-206"></a><a name="index-MT_005fFEATURES-207"></a>In addition, you can configure a number of features with the
+ <p><a name="index-mktex_002eopt-205"></a><a name="index-MT_005fFEATURES-206"></a>In addition, you can configure a number of features with the
<code>MT_FEATURES</code> variable, which you can define:
<ul>
@@ -1189,12 +1180,12 @@ directory is used.
<p>The &lsquo;<samp><span class="samp">appendonlydir</span></samp>&rsquo; option is enabled by default.
<dl>
-<dt>&lsquo;<samp><span class="samp">appendonlydir</span></samp>&rsquo;<a name="index-appendonlydir-208"></a><dd><a name="index-directories_002c-making-append_002donly-209"></a><a name="index-mktexdir-210"></a>Tell <code>mktexdir</code> to create directories append-only, i.e., set
+<dt>&lsquo;<samp><span class="samp">appendonlydir</span></samp>&rsquo;<a name="index-appendonlydir-207"></a><dd><a name="index-directories_002c-making-append_002donly-208"></a><a name="index-mktexdir-209"></a>Tell <code>mktexdir</code> to create directories append-only, i.e., set
their sticky bit (see <a href="coreutils.html#Mode-Structure">Mode Structure</a>). This feature is silently ignored on non-Unix platforms
(e.g. Windows/NT and MS-DOS) which don't support similar functionality.
This feature is enabled by default.
- <br><dt>&lsquo;<samp><span class="samp">dosnames</span></samp>&rsquo;<a name="index-dosnames-211"></a><dd><a name="index-g_t8_002e3-filenames_002c-using-212"></a><a name="index-DOS-compatible-names-213"></a><a name="index-dpi_0040var_007bnnn_007d-directories-214"></a>Use 8.3 names; e.g., <samp><span class="file">dpi600/cmr10.pk</span></samp> instead of
+ <br><dt>&lsquo;<samp><span class="samp">dosnames</span></samp>&rsquo;<a name="index-dosnames-210"></a><dd><a name="index-g_t8_002e3-filenames_002c-using-211"></a><a name="index-DOS-compatible-names-212"></a><a name="index-dpi_0040var_007bnnn_007d-directories-213"></a>Use 8.3 names; e.g., <samp><span class="file">dpi600/cmr10.pk</span></samp> instead of
<samp><span class="file">cmr10.600pk</span></samp>. Note that this feature only affects filenames that
would otherwise clash with other TeX-related filenames; <samp><span class="file">mktex</span></samp>
scripts do nothing about filenames which exceed the 8+3 MS-DOS limits
@@ -1212,47 +1203,47 @@ TeX-related files and are therefore unchanged.
<samp><span class="file">mktex.opt</span></samp>, but only if you use the <samp><span class="file">mktex</span></samp> shell scripts;
the emulation programs don't consult <samp><span class="file">mktex.opt</span></samp>.
- <br><dt>&lsquo;<samp><span class="samp">fontmaps</span></samp>&rsquo;<a name="index-fontmaps-215"></a><dd><a name="index-fontmaps-216"></a><a name="index-fontname-217"></a>Instead of deriving the location of a font in the destination tree from
+ <br><dt>&lsquo;<samp><span class="samp">fontmaps</span></samp>&rsquo;<a name="index-fontmaps-214"></a><dd><a name="index-fontmaps-215"></a><a name="index-fontname-216"></a>Instead of deriving the location of a font in the destination tree from
the location of the sources, the aliases and directory names from the
Fontname distribution are used. (see <a href="fontname.html#Top">Introduction</a>).
- <br><dt>&lsquo;<samp><span class="samp">nomfdrivers</span></samp>&rsquo;<a name="index-nomfdrivers-218"></a><dd><a name="index-metafont-driver-files-219"></a>Let mktexpk and mktextfm create metafont driver files in a temporary
+ <br><dt>&lsquo;<samp><span class="samp">nomfdrivers</span></samp>&rsquo;<a name="index-nomfdrivers-217"></a><dd><a name="index-metafont-driver-files-218"></a>Let mktexpk and mktextfm create metafont driver files in a temporary
directory. These will be used for just one metafont run and not
installed permanently.
- <br><dt>&lsquo;<samp><span class="samp">nomode</span></samp>&rsquo;<a name="index-nomode-220"></a><dd><a name="index-mode-directory_002c-omitting-221"></a>Omit the directory level for the mode name; this is fine as long as
+ <br><dt>&lsquo;<samp><span class="samp">nomode</span></samp>&rsquo;<a name="index-nomode-219"></a><dd><a name="index-mode-directory_002c-omitting-220"></a>Omit the directory level for the mode name; this is fine as long as
you generate fonts for only one mode.
- <br><dt>&lsquo;<samp><span class="samp">stripsupplier</span></samp>&rsquo;<a name="index-stripsupplier-222"></a><dd><a name="index-supplier-directory_002c-omitting-223"></a>Omit the font supplier name directory level.
+ <br><dt>&lsquo;<samp><span class="samp">stripsupplier</span></samp>&rsquo;<a name="index-stripsupplier-221"></a><dd><a name="index-supplier-directory_002c-omitting-222"></a>Omit the font supplier name directory level.
- <br><dt>&lsquo;<samp><span class="samp">striptypeface</span></samp>&rsquo;<a name="index-striptypeface-224"></a><dd><a name="index-typeface-directory_002c-omitting-225"></a>Omit the font typeface name directory level.
+ <br><dt>&lsquo;<samp><span class="samp">striptypeface</span></samp>&rsquo;<a name="index-striptypeface-223"></a><dd><a name="index-typeface-directory_002c-omitting-224"></a>Omit the font typeface name directory level.
- <br><dt>&lsquo;<samp><span class="samp">strip</span></samp>&rsquo;<a name="index-strip-226"></a><dd><a name="index-supplier-directory_002c-omitting-227"></a><a name="index-typeface-directory_002c-omitting-228"></a>Omit the font supplier and typeface name directory levels. This feature
+ <br><dt>&lsquo;<samp><span class="samp">strip</span></samp>&rsquo;<a name="index-strip-225"></a><dd><a name="index-supplier-directory_002c-omitting-226"></a><a name="index-typeface-directory_002c-omitting-227"></a>Omit the font supplier and typeface name directory levels. This feature
is deprecated in favour of &lsquo;<samp><span class="samp">stripsupplier</span></samp>&rsquo; and &lsquo;<samp><span class="samp">striptypeface</span></samp>&rsquo;.
- <br><dt>&lsquo;<samp><span class="samp">varfonts</span></samp>&rsquo;<a name="index-varfonts-229"></a><dd><a name="index-g_t_002fvar_002ftmp_002ftexfonts-230"></a><a name="index-VARTEXFONTS-231"></a><a name="index-Linux-File-System-Standard-232"></a>When this option is enabled, fonts that would otherwise be written in
+ <br><dt>&lsquo;<samp><span class="samp">varfonts</span></samp>&rsquo;<a name="index-varfonts-228"></a><dd><a name="index-g_t_002fvar_002ftmp_002ftexfonts-229"></a><a name="index-VARTEXFONTS-230"></a><a name="index-Linux-File-System-Standard-231"></a>When this option is enabled, fonts that would otherwise be written in
system texmf tree go to the <code>VARTEXFONTS</code> tree instead. The
default value in <samp><span class="file">kpathsea/Makefile.in</span></samp> is
<samp><span class="file">/var/tmp/texfonts</span></samp>. The <cite>Linux File System Standard</cite>
recommends <samp><span class="file">/var/tex/fonts</span></samp>.
- <p><a name="index-USE_005fVARTEXFONTS-233"></a>The &lsquo;<samp><span class="samp">varfonts</span></samp>&rsquo; setting in <code>MT_FEATURES</code> is overridden by the
+ <p><a name="index-USE_005fVARTEXFONTS-232"></a>The &lsquo;<samp><span class="samp">varfonts</span></samp>&rsquo; setting in <code>MT_FEATURES</code> is overridden by the
<code>USE_VARTEXFONTS</code> environment variable: if set to &lsquo;<samp><span class="samp">1</span></samp>&rsquo;, the
feature is enabled, and if set to &lsquo;<samp><span class="samp">0</span></samp>&rsquo;, the feature is disabled.
- <br><dt>&lsquo;<samp><span class="samp">texmfvar</span></samp>&rsquo;<a name="index-texmfvar-234"></a><dd><a name="index-TEXMFVAR-235"></a>Force generated files that would go into a system tree (as defined by
+ <br><dt>&lsquo;<samp><span class="samp">texmfvar</span></samp>&rsquo;<a name="index-texmfvar-233"></a><dd><a name="index-TEXMFVAR-234"></a>Force generated files that would go into a system tree (as defined by
<code>SYSTEXMF</code>) into <code>TEXMFVAR</code>. Starting with teTeX-3.0, the
variable <code>TEXMFVAR</code> is always set. The &lsquo;<samp><span class="samp">varfonts</span></samp>&rsquo; feature takes
precedence if also set.
- <p><a name="index-USE_005fTEXMFVAR-236"></a>The &lsquo;<samp><span class="samp">texmfvar</span></samp>&rsquo; setting in <code>MT_FEATURES</code> is overridden by the
+ <p><a name="index-USE_005fTEXMFVAR-235"></a>The &lsquo;<samp><span class="samp">texmfvar</span></samp>&rsquo; setting in <code>MT_FEATURES</code> is overridden by the
<code>USE_TEXMFVAR</code> environment variable: if set to &lsquo;<samp><span class="samp">1</span></samp>&rsquo;, the
feature is enabled, and if set to &lsquo;<samp><span class="samp">0</span></samp>&rsquo;, the feature is disabled.
</dl>
<div class="node">
-<p><hr>
<a name="mktex-script-names"></a>
+<p><hr>
Next:&nbsp;<a rel="next" accesskey="n" href="#mktex-script-arguments">mktex script arguments</a>,
Previous:&nbsp;<a rel="previous" accesskey="p" href="#mktex-configuration">mktex configuration</a>,
Up:&nbsp;<a rel="up" accesskey="u" href="#mktex-scripts">mktex scripts</a>
@@ -1261,46 +1252,46 @@ Up:&nbsp;<a rel="up" accesskey="u" href="#mktex-scripts">mktex scripts</a>
<h5 class="subsubsection">2.2.9.2 <samp><span class="file">mktex</span></samp> script names</h5>
-<p><a name="index-g_t_0040file_007bmktex_007d-script-names-237"></a><a name="index-names-for-_0040file_007bmktex_007d-scripts-238"></a>
+<p><a name="index-g_t_0040file_007bmktex_007d-script-names-236"></a><a name="index-names-for-_0040file_007bmktex_007d-scripts-237"></a>
The following table shows the default name of the script for each
of the file types which support runtime generation.
<dl>
-<dt><samp><span class="file">mktexfmt</span></samp><dd><a name="index-mktexfmt-239"></a><a name="index-fmtutil-240"></a>(&lsquo;<samp><span class="samp">.fmt</span></samp>&rsquo;, &lsquo;<samp><span class="samp">.base</span></samp>&rsquo;, &lsquo;<samp><span class="samp">.mem</span></samp>&rsquo;) TeX/Metafont/MetaPost
+<dt><samp><span class="file">mktexfmt</span></samp><dd><a name="index-mktexfmt-238"></a><a name="index-fmtutil-239"></a>(&lsquo;<samp><span class="samp">.fmt</span></samp>&rsquo;, &lsquo;<samp><span class="samp">.base</span></samp>&rsquo;, &lsquo;<samp><span class="samp">.mem</span></samp>&rsquo;) TeX/Metafont/MetaPost
formats. This script is also named <samp><span class="command">fmtutil</span></samp>, and reads
<samp><span class="file">fmtutil.cnf</span></samp> for configuration information.
- <br><dt><samp><span class="file">mktexmf</span></samp><dd><a name="index-mktexmf-241"></a>(&lsquo;<samp><span class="samp">.mf</span></samp>&rsquo;) Metafont input files.
+ <br><dt><samp><span class="file">mktexmf</span></samp><dd><a name="index-mktexmf-240"></a>(&lsquo;<samp><span class="samp">.mf</span></samp>&rsquo;) Metafont input files.
- <br><dt><samp><span class="file">mkocp</span></samp><dd><a name="index-mkocp-242"></a>(&lsquo;<samp><span class="samp">.ocp</span></samp>&rsquo;) Omega compiled process files.
+ <br><dt><samp><span class="file">mkocp</span></samp><dd><a name="index-mkocp-241"></a>(&lsquo;<samp><span class="samp">.ocp</span></samp>&rsquo;) Omega compiled process files.
- <br><dt><samp><span class="file">mkofm</span></samp><dd><a name="index-mkofm-243"></a>(&lsquo;<samp><span class="samp">.ofm</span></samp>&rsquo;) Omega font metric files.
+ <br><dt><samp><span class="file">mkofm</span></samp><dd><a name="index-mkofm-242"></a>(&lsquo;<samp><span class="samp">.ofm</span></samp>&rsquo;) Omega font metric files.
- <br><dt><samp><span class="file">mktexpk</span></samp><dd><a name="index-mktexpk-244"></a>(&lsquo;<samp><span class="samp">pk</span></samp>&rsquo;) Glyph fonts.
+ <br><dt><samp><span class="file">mktexpk</span></samp><dd><a name="index-mktexpk-243"></a>(&lsquo;<samp><span class="samp">pk</span></samp>&rsquo;) Glyph fonts.
- <br><dt><samp><span class="file">mktextex</span></samp><dd><a name="index-mktextex-245"></a>(&lsquo;<samp><span class="samp">.tex</span></samp>&rsquo;) TeX input files (disabled by default).
+ <br><dt><samp><span class="file">mktextex</span></samp><dd><a name="index-mktextex-244"></a>(&lsquo;<samp><span class="samp">.tex</span></samp>&rsquo;) TeX input files (disabled by default).
- <br><dt><samp><span class="file">mktextfm</span></samp><dd><a name="index-mktextfm-246"></a>(&lsquo;<samp><span class="samp">.tfm</span></samp>&rsquo;) TFM files.
+ <br><dt><samp><span class="file">mktextfm</span></samp><dd><a name="index-mktextfm-245"></a>(&lsquo;<samp><span class="samp">.tfm</span></samp>&rsquo;) TFM files.
</dl>
- <p><a name="index-DVIPSMAKEPK-247"></a><a name="index-XDVIMAKEPK-248"></a><a name="index-DVILJMAKEPK-249"></a>These names can be overridden by an environment variable specific
+ <p><a name="index-DVIPSMAKEPK-246"></a><a name="index-XDVIMAKEPK-247"></a><a name="index-DVILJMAKEPK-248"></a>These names can be overridden by an environment variable specific
to the program&mdash;for example, <code>DVIPSMAKEPK</code> for Dvipsk.
<!-- next two paragraphs are repeated in dvips.texi -->
- <p><a name="index-missfont_002elog-250"></a><a name="index-failed-_0040code_007bmktex_0040dots_007b_007d_007d-script-invocation-251"></a>If a <code>mktex...</code> script fails, the invocation is appended to a
+ <p><a name="index-missfont_002elog-249"></a><a name="index-failed-_0040code_007bmktex_0040dots_007b_007d_007d-script-invocation-250"></a>If a <code>mktex...</code> script fails, the invocation is appended to a
file <samp><span class="file">missfont.log</span></samp> (by default) in the current directory. You can
then execute the log file to create the missing files after fixing the
problem.
- <p><a name="index-TEXMFOUTPUT-252"></a><a name="index-MISSFONT_005fLOG-253"></a>If the current directory is not writable and the environment variable or
+ <p><a name="index-TEXMFOUTPUT-251"></a><a name="index-MISSFONT_005fLOG-252"></a>If the current directory is not writable and the environment variable or
configuration file value <code>TEXMFOUTPUT</code> is set, its value is
used. Otherwise, nothing is written. The name &lsquo;<samp><span class="samp">missfont.log</span></samp>&rsquo; is
overridden by the <code>MISSFONT_LOG</code> environment variable or
configuration file value.
<div class="node">
-<p><hr>
<a name="mktex-script-arguments"></a>
+<p><hr>
Previous:&nbsp;<a rel="previous" accesskey="p" href="#mktex-script-names">mktex script names</a>,
Up:&nbsp;<a rel="up" accesskey="u" href="#mktex-scripts">mktex scripts</a>
@@ -1308,7 +1299,7 @@ Up:&nbsp;<a rel="up" accesskey="u" href="#mktex-scripts">mktex scripts</a>
<h5 class="subsubsection">2.2.9.3 <samp><span class="file">mktex</span></samp> script arguments</h5>
-<p><a name="index-arguments-to-_0040file_007bmktex_007d-254"></a>
+<p><a name="index-arguments-to-_0040file_007bmktex_007d-253"></a>
The first argument to a <samp><span class="file">mktex</span></samp> script is always the name
of the file to be created.
@@ -1328,8 +1319,8 @@ script.
</dl>
<div class="node">
-<p><hr>
<a name="Installation-testing"></a>
+<p><hr>
Previous:&nbsp;<a rel="previous" accesskey="p" href="#mktex-scripts">mktex scripts</a>,
Up:&nbsp;<a rel="up" accesskey="u" href="#Custom-installation">Custom installation</a>
@@ -1337,14 +1328,14 @@ Up:&nbsp;<a rel="up" accesskey="u" href="#Custom-installation">Custom installati
<h4 class="subsection">2.2.10 Installation testing</h4>
-<p><a name="index-testing_002c-post_002dinstallation-255"></a><a name="index-installation-testing-256"></a>
+<p><a name="index-testing_002c-post_002dinstallation-254"></a><a name="index-installation-testing-255"></a>
Besides the tests listed in <a href="#Simple-installation">Simple installation</a>, you can try
running &lsquo;<samp><span class="samp">make check</span></samp>&rsquo;. This includes the torture tests (trip, trap,
and mptrap) that come with Web2c (see <a href="web2c.html#Triptrap">Triptrap</a>).
<div class="node">
-<p><hr>
<a name="Security"></a>
+<p><hr>
Next:&nbsp;<a rel="next" accesskey="n" href="#TeX-directory-structure">TeX directory structure</a>,
Previous:&nbsp;<a rel="previous" accesskey="p" href="#Custom-installation">Custom installation</a>,
Up:&nbsp;<a rel="up" accesskey="u" href="#Installation">Installation</a>
@@ -1353,12 +1344,12 @@ Up:&nbsp;<a rel="up" accesskey="u" href="#Installation">Installation</a>
<h3 class="section">2.3 Security</h3>
-<p><a name="index-security-considerations-257"></a>
+<p><a name="index-security-considerations-256"></a>
None of the programs in the TeX system require any special system
privileges, so there's no first-level security concern of people gaining
illegitimate root access.
- <p><a name="index-trojan-horse-attack-258"></a><a name="index-g_t_002erhosts_0040r_007b_002c-writable-by-_0040TeX_007b_007d_007d-259"></a>A TeX document, however, can write to arbitrary files, e.g.,
+ <p><a name="index-trojan-horse-attack-257"></a><a name="index-g_t_002erhosts_0040r_007b_002c-writable-by-_0040TeX_007b_007d_007d-258"></a>A TeX document, however, can write to arbitrary files, e.g.,
<samp><span class="file">~/.rhosts</span></samp>, and thus an unwitting user who runs TeX on a random
document is vulnerable to a trojan horse attack. This loophole is
closed by default, but you can be permissive if you so desire in
@@ -1368,7 +1359,7 @@ the same issue.
<p>Dvips, Xdvi, and TeX can also execute shell commands under some
circumstances. To disable this, see the &lsquo;<samp><span class="samp">-R</span></samp>&rsquo; option in <a href="dvips.html#Option-details">Option details</a>, the xdvi man page, and <a href="web2c.html#tex-invocation">tex invocation</a>, respectively.
- <p><a name="index-local-cache-of-fonts-260"></a><a name="index-cache-of-fonts_002c-local-261"></a>Another security issue arises because it's very useful&mdash;almost
+ <p><a name="index-local-cache-of-fonts-259"></a><a name="index-cache-of-fonts_002c-local-260"></a>Another security issue arises because it's very useful&mdash;almost
necessary&mdash;to make arbitrary fonts on user demand with <code>mktexpk</code>
and friends. Where do these files get installed? By default, the
<code>mktexpk</code> distributed with Kpathsea assumes a world-writable
@@ -1376,35 +1367,35 @@ and friends. Where do these files get installed? By default, the
it may not suit your situation because it means that a local cache of
fonts is created on every machine.
- <p><a name="index-globally-writable-directories-262"></a>To avoid this duplication, many people consider a shared, globally
+ <p><a name="index-globally-writable-directories-261"></a>To avoid this duplication, many people consider a shared, globally
writable font tree desirable, in spite of the potential security
problems. To do this you should change the value of <code>VARTEXFONTS</code>
in <samp><span class="file">texmf.cnf</span></samp> to refer to some globally known directory.
See <a href="#mktex-configuration">mktex configuration</a>.
- <p><a name="index-append_002donly-directories-and-_0040code_007bmktexpk_007d-263"></a>The first restriction you can apply is to make newly-created directories
+ <p><a name="index-append_002donly-directories-and-_0040code_007bmktexpk_007d-262"></a>The first restriction you can apply is to make newly-created directories
under <samp><span class="file">texmf</span></samp> be append-only with an option in <samp><span class="file">mktex.cnf</span></samp>.
See <a href="#mktex-configuration">mktex configuration</a>.
- <p><a name="index-group_002dwritable-directories-264"></a><a name="index-setgid-scripts-265"></a>Another approach is to establish a group (or user) for TeX files,
+ <p><a name="index-group_002dwritable-directories-263"></a><a name="index-setgid-scripts-264"></a>Another approach is to establish a group (or user) for TeX files,
make the <samp><span class="file">texmf</span></samp> tree writable only to that group (or user), and
make <code>mktexpk</code> et al. setgid to that group (or setuid to that
user). Then users must invoke the scripts to install things. (If
you're worried about the inevitable security holes in scripts, then you
could write a C wrapper to exec the script.)
- <p><a name="index-file-permissions-266"></a><a name="index-permissions_002c-file-267"></a>The <samp><span class="file">mktex...</span></samp> scripts install files with the same read and
+ <p><a name="index-file-permissions-265"></a><a name="index-permissions_002c-file-266"></a>The <samp><span class="file">mktex...</span></samp> scripts install files with the same read and
write permissions as the directory they are installed in. The
executable, sgid, suid, and sticky bits are always cleared.
- <p><a name="index-directory-permissions-268"></a><a name="index-permissions_002c-directory-269"></a>Any directories created by the <samp><span class="file">mktex...</span></samp> scripts have the
+ <p><a name="index-directory-permissions-267"></a><a name="index-permissions_002c-directory-268"></a>Any directories created by the <samp><span class="file">mktex...</span></samp> scripts have the
same permissions as their parent directory, unless the
<code>appendonlydir</code> feature is used, in which case the sticky bit is
always set.
<div class="node">
-<p><hr>
<a name="TeX-directory-structure"></a>
+<p><hr>
Next:&nbsp;<a rel="next" accesskey="n" href="#unixtex_002eftp">unixtex.ftp</a>,
Previous:&nbsp;<a rel="previous" accesskey="p" href="#Security">Security</a>,
Up:&nbsp;<a rel="up" accesskey="u" href="#Installation">Installation</a>
@@ -1413,7 +1404,7 @@ Up:&nbsp;<a rel="up" accesskey="u" href="#Installation">Installation</a>
<h3 class="section">2.4 TeX directory structure</h3>
-<p><a name="index-TEXMF-270"></a><a name="index-g_t_0040TeX_007b_007d-directory-structure-271"></a><a name="index-directory-structure_002c-for-_0040TeX_007b_007d-files-272"></a><a name="index-skeleton-_0040TeX_007b_007d-directory-273"></a><a name="index-TDS-274"></a>
+<p><a name="index-TEXMF-269"></a><a name="index-g_t_0040TeX_007b_007d-directory-structure-270"></a><a name="index-directory-structure_002c-for-_0040TeX_007b_007d-files-271"></a><a name="index-skeleton-_0040TeX_007b_007d-directory-272"></a><a name="index-TDS-273"></a>
This section describes the default installation hierarchy of the
distribution. It conforms to both the GNU coding standards and the
TeX directory structure (TDS) standard. For rationale and further
@@ -1499,9 +1490,9 @@ the TDS document:
/usr/local/share/texmf/web2c/texmf.cnf
</pre>
<div class="node">
-<p><hr>
<a name="unixtex.ftp"></a>
<a name="unixtex_002eftp"></a>
+<p><hr>
Next:&nbsp;<a rel="next" accesskey="n" href="#Reporting-bugs">Reporting bugs</a>,
Previous:&nbsp;<a rel="previous" accesskey="p" href="#TeX-directory-structure">TeX directory structure</a>,
Up:&nbsp;<a rel="up" accesskey="u" href="#Installation">Installation</a>
@@ -1510,13 +1501,13 @@ Up:&nbsp;<a rel="up" accesskey="u" href="#Installation">Installation</a>
<h3 class="section">2.5 <samp><span class="file">unixtex.ftp</span></samp>: Obtaining TeX</h3>
-<p><a name="index-obtaining-_0040TeX_007b_007d-275"></a><a name="index-retrieving-_0040TeX_007b_007d-276"></a>
-<a name="index-unixtex_002eftp-277"></a><a name="index-tug_002eorg-278"></a><a name="index-www_002etug_002eorg-279"></a><a name="index-ftp_002etug_002eorg-280"></a>This
+<p><a name="index-obtaining-_0040TeX_007b_007d-274"></a><a name="index-retrieving-_0040TeX_007b_007d-275"></a>
+<a name="index-unixtex_002eftp-276"></a><a name="index-tug_002eorg-277"></a><a name="index-www_002etug_002eorg-278"></a><a name="index-ftp_002etug_002eorg-279"></a>This
is <a href="ftp://ftp.tug.org/tex/unixtex.ftp">ftp://ftp.tug.org/tex/unixtex.ftp</a>, last updated 26 December
2003. Also available as <a href="http://www.tug.org/unixtex.ftp">http://www.tug.org/unixtex.ftp</a>. The
IP address is currently <code>[130.225.2.178]</code>. It is also in
Kpathsea source distributions as <samp><span class="file">etc/unixtex.ftp</span></samp> (although the
-network version is usually newer). Mail <a href="mailto:tex-k@mail.tug.org">tex-k@mail.tug.org</a>
+network version is usually newer). Mail <a href="mailto:tex-k@tug.org">tex-k@tug.org</a>
with comments or questions.
<p>Following are general instructions for Unix or other sites who wish to
@@ -1555,8 +1546,8 @@ sources, see <a href="#Installation">Installation</a>. A copy is in the distrib
<!-- * Tape distribution:: -->
<!-- used to be in this menu. -->
<div class="node">
-<p><hr>
<a name="Electronic-distribution"></a>
+<p><hr>
Next:&nbsp;<a rel="next" accesskey="n" href="#CD_002dROM-distribution">CD-ROM distribution</a>,
Up:&nbsp;<a rel="up" accesskey="u" href="#unixtex_002eftp">unixtex.ftp</a>
@@ -1564,27 +1555,27 @@ Up:&nbsp;<a rel="up" accesskey="u" href="#unixtex_002eftp">unixtex.ftp</a>
<h4 class="subsection">2.5.1 Electronic distribution</h4>
-<p><a name="index-ftp-retrieval-281"></a><a name="index-obtaining-Web2c-by-ftp-282"></a><a name="index-distributions_002c-via-ftp-283"></a>
-<a name="index-CTAN_002c-defined-284"></a><a name="index-backbone-of-CTAN-285"></a>In many places we refer to <var>CTAN:</var>. This is <em>both</em> a host name
+<p><a name="index-ftp-retrieval-280"></a><a name="index-obtaining-Web2c-by-ftp-281"></a><a name="index-distributions_002c-via-ftp-282"></a>
+<a name="index-CTAN_002c-defined-283"></a><a name="index-backbone-of-CTAN-284"></a>In many places we refer to <var>CTAN:</var>. This is <em>both</em> a host name
and a directory name. Here are the primary locations:
<pre class="example"> <a href="ftp://ctan.tug.org/tex-archive/">ftp://ctan.tug.org/tex-archive/</a> <span class="roman">(Vermont, USA)</span>
<a href="ftp://ftp.dante.de/tex-archive/">ftp://ftp.dante.de/tex-archive/</a> <span class="roman">(Germany)</span>
<a href="ftp://ftp.tex.ac.uk/tex-archive/">ftp://ftp.tex.ac.uk/tex-archive/</a> <span class="roman">(England)</span>
</pre>
- <p class="noindent"><a name="index-README_002emirrors-286"></a><a name="index-CTAN_002esites-287"></a><a name="index-mirrors_002c-FTP-288"></a>CTAN has many mirrors worldwide; see the top-level file
+ <p class="noindent"><a name="index-README_002emirrors-285"></a><a name="index-CTAN_002esites-286"></a><a name="index-mirrors_002c-FTP-287"></a>CTAN has many mirrors worldwide; see the top-level file
<samp><span class="file">README.mirrors</span></samp> from one of the sites above or see
<a href="http://www.tug.org/CTAN.sites">http://www.tug.org/CTAN.sites</a>.
- <p><a name="index-World-Wide-Web-CTAN-access-289"></a><a name="index-email-CTAN-access-290"></a><a name="index-NFS-CTAN-access-291"></a>You can also access CTAN via the World Wide Web, electronic
+ <p><a name="index-World-Wide-Web-CTAN-access-288"></a><a name="index-email-CTAN-access-289"></a><a name="index-NFS-CTAN-access-290"></a>You can also access CTAN via the World Wide Web, electronic
mail, or NFS. The same <samp><span class="file">README.mirrors</span></samp> file explains how.
- <p><a name="index-binary-mode_002c-for-file-transfers-292"></a>You will need to retrieve some or all of the following archives,
+ <p><a name="index-binary-mode_002c-for-file-transfers-291"></a>You will need to retrieve some or all of the following archives,
depending on your needs (don't forget to set binary mode for file
transfers):
<dl>
-<dt><samp><var>CTAN:</var><span class="file">/systems/web2c/web.tar.gz</span></samp><dd><a name="index-Knuth_002c-Donald-E_002e_002c-original-author-293"></a>The original WEB source files, written primarily by Don Knuth. Required
+<dt><samp><var>CTAN:</var><span class="file">/systems/web2c/web.tar.gz</span></samp><dd><a name="index-Knuth_002c-Donald-E_002e_002c-original-author-292"></a>The original WEB source files, written primarily by Don Knuth. Required
unless you already have this <samp><span class="file">web</span></samp> version. (The WEB sources
change irregularly with respect to Web2c itself.) Unpacks into
<samp><span class="file">web2c-</span><var>version</var></samp>.
@@ -1628,9 +1619,9 @@ a working system. These are available in teTeX.
else) from the <samp><span class="file">tex/</span></samp> directory on that host.
<div class="node">
-<p><hr>
<a name="CD-ROM-distribution"></a>
<a name="CD_002dROM-distribution"></a>
+<p><hr>
Next:&nbsp;<a rel="next" accesskey="n" href="#Other-TeX-packages">Other TeX packages</a>,
Previous:&nbsp;<a rel="previous" accesskey="p" href="#Electronic-distribution">Electronic distribution</a>,
Up:&nbsp;<a rel="up" accesskey="u" href="#unixtex_002eftp">unixtex.ftp</a>
@@ -1639,15 +1630,15 @@ Up:&nbsp;<a rel="up" accesskey="u" href="#unixtex_002eftp">unixtex.ftp</a>
<h4 class="subsection">2.5.2 CD-ROM distribution</h4>
-<p><a name="index-CD_002dROM-distributions-294"></a><a name="index-obtaining-Web2c-on-CD_002dROM-295"></a><a name="index-distributions_002c-on-CD_002dROM-296"></a>
+<p><a name="index-CD_002dROM-distributions-293"></a><a name="index-obtaining-Web2c-on-CD_002dROM-294"></a><a name="index-distributions_002c-on-CD_002dROM-295"></a>
Numerous organizations distribute various TeX CD-ROM's (and DVD's):
<ul>
-<li><a name="index-g_t_0040TeX_007b_007d-Live-CD_002dROM-297"></a>Virtually all the TeX user groups collaborate to produce the
+<li><a name="index-g_t_0040TeX_007b_007d-Live-CD_002dROM-296"></a>Virtually all the TeX user groups collaborate to produce the
<cite>TeX Live</cite> distribution once a year; see
<a href="http://www.tug.org/texlive/">http://www.tug.org/texlive/</a> for more information.
- <li><a name="index-Free-Software-Foundation-298"></a><a name="index-FSF-Source-Code-CD_002dROM-299"></a>The Free Software Foundation's <cite>Source Code CD-ROM</cite> contains the
+ <li><a name="index-Free-Software-Foundation-297"></a><a name="index-FSF-Source-Code-CD_002dROM-298"></a>The Free Software Foundation's <cite>Source Code CD-ROM</cite> contains the
minimal TeX source distribution described in the previous section
(i.e., enough to print GNU documentation); email
<a href="mailto:gnu@gnu.org">gnu@gnu.org</a>.
@@ -1674,18 +1665,16 @@ minimal TeX source distribution described in the previous section
<!-- Walnut Creek's @TeX{} CD-ROM is also a copy of CTAN; email -->
<!-- @email{info@@cdrom.com} or see -->
<!-- @url{http://www.cdrom.com:/titles/tex.html}. -->
- <li><a name="index-Linux_002c-using-Web2c-300"></a>Most Linux distributions include some TeX package based on
-Web2c; see the Linux documentation file &lsquo;<samp><span class="samp">Distribution-HOWTO</span></samp>&rsquo; for a
-comparison of Linux distributions, available (for example) via
-<a href="http://www.linux.org">http://www.linux.org</a>.
+ <li><a name="index-Linux_002c-using-Web2c-299"></a>Most GNU/Linux distributions include some TeX package based on
+TeX Live.
</ul>
<p>If you know of additional TeX distributions to add to this
-list, please inform <a href="mailto:tex-k@mail.tug.org">tex-k@mail.tug.org</a>.
+list, please inform <a href="mailto:tex-k@tug.org">tex-k@tug.org</a>.
<div class="node">
-<p><hr>
<a name="Other-TeX-packages"></a>
+<p><hr>
Previous:&nbsp;<a rel="previous" accesskey="p" href="#CD_002dROM-distribution">CD-ROM distribution</a>,
Up:&nbsp;<a rel="up" accesskey="u" href="#unixtex_002eftp">unixtex.ftp</a>
@@ -1693,8 +1682,8 @@ Up:&nbsp;<a rel="up" accesskey="u" href="#unixtex_002eftp">unixtex.ftp</a>
<h4 class="subsection">2.5.3 Other TeX packages</h4>
-<p><a name="index-other-_0040TeX_007b_007d-distributions-301"></a><a name="index-g_t_0040TeX_007b_007d-distributions-besides-Web2c-302"></a>
-<a name="index-Amiga-_0040TeX_007b_007d-implementations-303"></a><a name="index-Acorn-_0040TeX_007b_007d-implementations-304"></a><a name="index-VMS-_0040TeX_007b_007d-implementations-305"></a><a name="index-Macintosh-_0040TeX_007b_007d-implementations-306"></a><a name="index-DOS-_0040TeX_007b_007d-implementations-307"></a><a name="index-Windows-_0040TeX_007b_007d-implementations-308"></a>Many other TeX implementations are available in
+<p><a name="index-other-_0040TeX_007b_007d-distributions-300"></a><a name="index-g_t_0040TeX_007b_007d-distributions-besides-Web2c-301"></a>
+<a name="index-Amiga-_0040TeX_007b_007d-implementations-302"></a><a name="index-Acorn-_0040TeX_007b_007d-implementations-303"></a><a name="index-VMS-_0040TeX_007b_007d-implementations-304"></a><a name="index-Macintosh-_0040TeX_007b_007d-implementations-305"></a><a name="index-DOS-_0040TeX_007b_007d-implementations-306"></a><a name="index-Windows-_0040TeX_007b_007d-implementations-307"></a>Many other TeX implementations are available in
<samp><var>CTAN:</var><span class="file">/systems</span></samp>, including ready-to-run distributions for
Unix, Amiga, Acorn, VMS, Macintosh, DOS, and Windows (in various forms).
Although Web2c has support in the source code for many operating
@@ -1702,12 +1691,12 @@ systems, and in fact some of the other distributions are based on it,
it's unlikely to work as distributed on anything but Unix. (Please
contribute improvements!)
- <p><a name="index-te_0040TeX_007b_007d-309"></a><a name="index-precompiled-Unix-binaries-310"></a>The principal user-oriented Unix distribution based on Web2c is the
+ <p><a name="index-te_0040TeX_007b_007d-308"></a><a name="index-precompiled-Unix-binaries-309"></a>The principal user-oriented Unix distribution based on Web2c is the
teTeX distribution. It includes complete sources, and runs on
all modern Unix variants, including Linux. It contains many
TeX-related programs besides those in the core Web2c.
- <p><a name="index-labrea_002estanford_002eedu-311"></a><a name="index-Knuth_002c-Donald-E_002e_002c-archive-of-programs-by-312"></a>The host <tt>labrea.stanford.edu</tt> is the original source for the files
+ <p><a name="index-labrea_002estanford_002eedu-310"></a><a name="index-Knuth_002c-Donald-E_002e_002c-archive-of-programs-by-311"></a>The host <tt>labrea.stanford.edu</tt> is the original source for the files
for which Donald Knuth is directly responsible: <samp><span class="file">tex.web</span></samp>,
<samp><span class="file">plain.tex</span></samp>, etc. However, unless you want to build your TeX
library tree ab initio, it is more reliable and less work to retrieve
@@ -1717,8 +1706,8 @@ Stanford TeX project, so do not rely on all the files available at
that ftp site being up-to-date.
<div class="node">
-<p><hr>
<a name="Reporting-bugs"></a>
+<p><hr>
Previous:&nbsp;<a rel="previous" accesskey="p" href="#unixtex_002eftp">unixtex.ftp</a>,
Up:&nbsp;<a rel="up" accesskey="u" href="#Installation">Installation</a>
@@ -1726,11 +1715,11 @@ Up:&nbsp;<a rel="up" accesskey="u" href="#Installation">Installation</a>
<h3 class="section">2.6 Reporting bugs</h3>
-<p><a name="index-reporting-bugs-313"></a><a name="index-bugs_002c-reporting-314"></a>
+<p><a name="index-reporting-bugs-312"></a><a name="index-bugs_002c-reporting-313"></a>
(A copy of this chapter is in the file <samp><span class="file">kpathsea/BUGS</span></samp>.)
- <p><a name="index-tex_002dk_0040_0040mail_002etug_002eorg-_0040r_007b_0028bug-address_0029_007d-315"></a><a name="index-bug-address-316"></a>If you have problems or suggestions, please report them to
-<a href="mailto:tex-k@mail.tug.org">tex-k@mail.tug.org</a> using the bug checklist below.
+ <p><a name="index-tex_002dk_0040_0040tug_002eorg-_0040r_007b_0028bug-address_0029_007d-314"></a><a name="index-bug-address-315"></a>If you have problems or suggestions, please report them to
+<a href="mailto:tex-k@tug.org">tex-k@tug.org</a> using the bug checklist below.
<p>Please report bugs in the documentation; not only factual errors or
inconsistent behavior, but unclear or incomplete explanations, typos,
@@ -1745,8 +1734,8 @@ wrong fonts, <small class="dots">...</small>
</ul>
<div class="node">
-<p><hr>
<a name="Bug-checklist"></a>
+<p><hr>
Next:&nbsp;<a rel="next" accesskey="n" href="#Mailing-lists">Mailing lists</a>,
Up:&nbsp;<a rel="up" accesskey="u" href="#Reporting-bugs">Reporting bugs</a>
@@ -1754,35 +1743,35 @@ Up:&nbsp;<a rel="up" accesskey="u" href="#Reporting-bugs">Reporting bugs</a>
<h4 class="subsection">2.6.1 Bug checklist</h4>
-<p><a name="index-checklist-for-bug-reports-317"></a><a name="index-bug-checklist-318"></a>
+<p><a name="index-checklist-for-bug-reports-316"></a><a name="index-bug-checklist-317"></a>
Before reporting a bug, please check below to be sure it isn't already
known (see <a href="#Common-problems">Common problems</a>).
<p>Bug reports should be sent via electronic mail to
-<a href="mailto:tex-k@mail.tug.org">tex-k@mail.tug.org</a>.
+<a href="mailto:tex-k@tug.org">tex-k@tug.org</a>.
<p>The general principle is that a good bug report includes all the
information necessary for reproduction. Therefore, to enable
investigation, your report should include the following:
<ul>
-<li><a name="index-version-numbers_002c-determining-319"></a>The version number(s) of the program(s) involved, and of Kpathsea
+<li><a name="index-version-numbers_002c-determining-318"></a>The version number(s) of the program(s) involved, and of Kpathsea
itself. You can get the former by giving a sole option &lsquo;<samp><span class="samp">--version</span></samp>&rsquo;
to the program, and the latter by running &lsquo;<samp><span class="samp">kpsewhich --version</span></samp>&rsquo;.
The <samp><span class="file">NEWS</span></samp> and <samp><span class="file">ChangeLog</span></samp> files also contain the version
number.
- <li><a name="index-uname-320"></a>The hardware, operating system (including version number), compiler, and
+ <li><a name="index-uname-319"></a>The hardware, operating system (including version number), compiler, and
<code>make</code> program you are using (the output of <code>uname -a</code> is a
start on the first two, though often incomplete). If the bug involves
the X window system, include X version and supplier information as well
(examples: X11R6 from MIT; X11R4 from HP; OpenWindows 3.3 bundled with
SunOS 4.1.4).
- <li><a name="index-config_002elog-321"></a>Any options you gave to <code>configure</code>. This is recorded in the
+ <li><a name="index-config_002elog-320"></a>Any options you gave to <code>configure</code>. This is recorded in the
<samp><span class="file">config.status</span></samp> files.
- <p><a name="index-configuration-bugs-322"></a><a name="index-config_002estatus-323"></a>If you are reporting a bug in &lsquo;<samp><span class="samp">configure</span></samp>&rsquo; itself, it's probably
+ <p><a name="index-configuration-bugs-321"></a><a name="index-config_002estatus-322"></a>If you are reporting a bug in &lsquo;<samp><span class="samp">configure</span></samp>&rsquo; itself, it's probably
system-dependent, and it will be unlikely the maintainers can do
anything useful if you merely report that thus-and-such is broken.
Therefore, you need to do some additional work: for some bugs, you can
@@ -1807,12 +1796,12 @@ file (and any EPS or other files it uses)&mdash;TeX source files are
helpful, but the DVI file is necessary, because that's the actual
program input.
- <li><a name="index-context-diff-324"></a><a name="index-sending-patches-325"></a><a name="index-ChangeLog-_0040r_007bentry_007d-326"></a>If you are sending a patch (do so if you can!), please do so in the form
+ <li><a name="index-context-diff-323"></a><a name="index-sending-patches-324"></a><a name="index-ChangeLog-_0040r_007bentry_007d-325"></a>If you are sending a patch (do so if you can!), please do so in the form
of a context diff (&lsquo;<samp><span class="samp">diff -c</span></samp>&rsquo;) against the original distribution
source. Any other form of diff is either not as complete or harder for
me to understand. Please also include a <samp><span class="file">ChangeLog</span></samp> entry.
- <li><a name="index-stack-trace-327"></a><a name="index-debugger-328"></a><a name="index-crashes_002c-reporting-329"></a><a name="index-core-dumps_002c-reporting-330"></a><a name="index-null-pointers_002c-dereferencing-331"></a><a name="index-gdb_0040r_007b_002c-recommended_007d-332"></a>If the bug involved is an actual crash (i.e., core dump), it is easy and
+ <li><a name="index-stack-trace-326"></a><a name="index-debugger-327"></a><a name="index-crashes_002c-reporting-328"></a><a name="index-core-dumps_002c-reporting-329"></a><a name="index-null-pointers_002c-dereferencing-330"></a><a name="index-gdb_0040r_007b_002c-recommended_007d-331"></a>If the bug involved is an actual crash (i.e., core dump), it is easy and
useful to include a stack trace from a debugger (I recommend the GNU
debugger GDB, available from <a href="ftp://prep.ai.mit.edu/pub/gnu">ftp://prep.ai.mit.edu/pub/gnu</a>). If
the cause is apparent (a <code>NULL</code> value being dereferenced, for
@@ -1826,8 +1815,8 @@ diagnosing, or fixing the bug.
</ul>
<div class="node">
-<p><hr>
<a name="Mailing-lists"></a>
+<p><hr>
Next:&nbsp;<a rel="next" accesskey="n" href="#Debugging">Debugging</a>,
Previous:&nbsp;<a rel="previous" accesskey="p" href="#Bug-checklist">Bug checklist</a>,
Up:&nbsp;<a rel="up" accesskey="u" href="#Reporting-bugs">Reporting bugs</a>
@@ -1836,10 +1825,10 @@ Up:&nbsp;<a rel="up" accesskey="u" href="#Reporting-bugs">Reporting bugs</a>
<h4 class="subsection">2.6.2 Mailing lists</h4>
-<p><a name="index-mailing-lists-333"></a><a name="index-bug-mailing-list-334"></a><a name="index-announcement-mailing-list-335"></a>
+<p><a name="index-mailing-lists-332"></a><a name="index-bug-mailing-list-333"></a><a name="index-announcement-mailing-list-334"></a>
Web2c and Kpathsea in general are discussed on the mailing list
-<a href="mailto:tex-k@mail.tug.org">tex-k@mail.tug.org</a>.
-<a name="index-tex_002dk_002drequest_0040_0040mail_002etug_002eorg-336"></a>To join, email <a href="mailto:tex-k-request@mail.tug.org">tex-k-request@mail.tug.org</a> with a line
+<a href="mailto:tex-k@tug.org">tex-k@tug.org</a>.
+<a name="index-tex_002dk_002drequest_0040_0040tug_002eorg-335"></a>To join, email <a href="mailto:tex-k-request@tug.org">tex-k-request@tug.org</a> with a line
consisting of
<pre class="example"> subscribe <var>you</var>@<var>your.preferred.email.address</var>
@@ -1856,18 +1845,15 @@ read some of the archives from <a href="ftp://ftp.tug.org/mail/archives/tex-k/">
<p>Be aware that large data files are sometimes included in bug reports.
If this is a problem for you, do not join the list.
- <p><a name="index-tex_002darchive_0040_0040math_002eutah_002eedu-337"></a><a name="index-announcement-mailing-list-338"></a>If you only want announcements of new releases, not bug reports and
-discussion, join <a href="mailto:tex-archive@math.utah.edu">tex-archive@math.utah.edu</a> (via mail to
-<a href="mailto:tex-archive-request@math.utah.edu">tex-archive-request@math.utah.edu</a>).
-
- <p><a name="index-g_t_0040TeX_007b_007d-help-mailing-list-339"></a><a name="index-La_0040TeX_007b_007d-help-mailing-list-340"></a><a name="index-Usenet-_0040TeX_007b_007d-newsgroup-341"></a><a name="index-newsgroup-for-_0040TeX_007b_007d-342"></a><a name="index-help_002c-mailing-list-for-general-_0040TeX_007b_007d-343"></a><a name="index-info_002dtex_0040_0040shsu_002eedu-344"></a><a name="index-comp_002etext_002etex-345"></a>If you are looking for general TeX help, such as how to use LaTeX,
-please use the mailing list <a href="mailto:info-tex@shsu.edu">info-tex@shsu.edu</a> mailing list,
-which is gatewayed to the &lsquo;<samp><span class="samp">comp.text.tex</span></samp>&rsquo; Usenet newsgroup (or post
-to the newsgroup; the gateway is bidirectional).
+ <p><a name="index-g_t_0040TeX_007b_007d-help-mailing-list-336"></a><a name="index-La_0040TeX_007b_007d-help-mailing-list-337"></a><a name="index-Usenet-_0040TeX_007b_007d-newsgroup-338"></a><a name="index-newsgroup-for-_0040TeX_007b_007d-339"></a><a name="index-help_002c-mailing-list-for-general-_0040TeX_007b_007d-340"></a><a name="index-info_002dtex_0040_0040shsu_002eedu-341"></a><a name="index-comp_002etext_002etex-342"></a>If you are looking for general TeX help, such as how to use
+LaTeX, please use the mailing list <a href="mailto:texhax@tug.org">texhax@tug.org</a> mailing
+list (<a href="http://lists.tug.org/texhax">http://lists.tug.org/texhax</a>) which is gatewayed to the
+&lsquo;<samp><span class="samp">comp.text.tex</span></samp>&rsquo; Usenet newsgroup (or post to the newsgroup; the
+gateway is bidirectional).
<div class="node">
-<p><hr>
<a name="Debugging"></a>
+<p><hr>
Next:&nbsp;<a rel="next" accesskey="n" href="#Logging">Logging</a>,
Previous:&nbsp;<a rel="previous" accesskey="p" href="#Mailing-lists">Mailing lists</a>,
Up:&nbsp;<a rel="up" accesskey="u" href="#Reporting-bugs">Reporting bugs</a>
@@ -1876,8 +1862,8 @@ Up:&nbsp;<a rel="up" accesskey="u" href="#Reporting-bugs">Reporting bugs</a>
<h4 class="subsection">2.6.3 Debugging</h4>
-<p><a name="index-debugging-346"></a><a name="index-runtime-debugging-347"></a><a name="index-options-for-debugging-348"></a>
-<a name="index-kpathsea_005fdebug-349"></a><a name="index-debug_002eh-350"></a>Kpathsea provides a number of runtime debugging options, detailed below
+<p><a name="index-debugging-343"></a><a name="index-runtime-debugging-344"></a><a name="index-options-for-debugging-345"></a>
+<a name="index-kpse_002d_003edebug-346"></a><a name="index-debug_002eh-347"></a>Kpathsea provides a number of runtime debugging options, detailed below
by their names and corresponding numeric values. When the files you
expect aren't being found, the thing to do is enable these options and
examine the output.
@@ -1889,57 +1875,57 @@ than those below). It's best to give the &lsquo;<samp><span class="samp">-d</sp
first, for maximal output. Dvipsk and Xdvik have additional
program-specific debugging options as well.
- <p><a name="index-KPATHSEA_005fDEBUG-351"></a><a name="index-kpathsea_005fdebug-352"></a>You can also set the environment variable <code>KPATHSEA_DEBUG</code>; in this
+ <p><a name="index-KPATHSEA_005fDEBUG-348"></a><a name="index-kpse_002d_003edebug-349"></a>You can also set the environment variable <code>KPATHSEA_DEBUG</code>; in this
case, you should use the numbers below. If you run the program under a
-debugger and set the variable <code>kpathsea_debug</code>, also use the numbers
+debugger and set the instance variable <code>kpse-&gt;debug</code>, also use the numbers
below.
- <p><a name="index-g_t_002d1-_0040r_007bdebugging-value_007d-353"></a>In any case, by far the simplest value to use is &lsquo;<samp><span class="samp">-1</span></samp>&rsquo;, which will
+ <p><a name="index-g_t_002d1-_0040r_007bdebugging-value_007d-350"></a>In any case, by far the simplest value to use is &lsquo;<samp><span class="samp">-1</span></samp>&rsquo;, which will
turn on all debugging output. This is usually better than guessing
which particular values will yield the output you need.
- <p><a name="index-debugging-output-354"></a><a name="index-standard-error-and-debugging-output-355"></a>Debugging output always goes to standard error, so you can redirect it
+ <p><a name="index-debugging-output-351"></a><a name="index-standard-error-and-debugging-output-352"></a>Debugging output always goes to standard error, so you can redirect it
easily. For example, in Bourne-compatible shells:
<pre class="example"> dvips -d -1 ... 2&gt;/tmp/debug
</pre>
- <p><a name="index-Kpsewhich_002c-and-debugging-356"></a>It is sometimes helpful to run the standalone Kpsewhich utility
+ <p><a name="index-Kpsewhich_002c-and-debugging-353"></a>It is sometimes helpful to run the standalone Kpsewhich utility
(see <a href="#Invoking-kpsewhich">Invoking kpsewhich</a>), instead of the original program.
- <p><a name="index-numeric-debugging-values-357"></a>In any case, you can <em>not</em> use the <em>names</em> below; you must
+ <p><a name="index-numeric-debugging-values-354"></a>In any case, you can <em>not</em> use the <em>names</em> below; you must
always use somebody's numbers. (Sorry.) To set more than one
option, just sum the corresponding numbers.
<dl>
-<dt><code>KPSE_DEBUG_STAT </code><span class="roman">(1)</span><a name="index-KPSE_005fDEBUG_005fSTAT-_0040r_007b_00281_0029_007d-358"></a><dd>Report &lsquo;<samp><span class="samp">stat</span></samp>&rsquo;(2) calls. This is useful for verifying that your
+<dt><code>KPSE_DEBUG_STAT </code><span class="roman">(1)</span><a name="index-KPSE_005fDEBUG_005fSTAT-_0040r_007b_00281_0029_007d-355"></a><dd>Report &lsquo;<samp><span class="samp">stat</span></samp>&rsquo;(2) calls. This is useful for verifying that your
directory structure is not forcing Kpathsea to do many additional file
tests (see <a href="#Slow-path-searching">Slow path searching</a>, and see <a href="#Subdirectory-expansion">Subdirectory expansion</a>). If you are using an up-to-date <samp><span class="file">ls-R</span></samp> database
(see <a href="#Filename-database">Filename database</a>), this should produce no output unless a
nonexistent file that must exist is searched for.
- <br><dt><code>KPSE_DEBUG_HASH </code><span class="roman">(2)</span><a name="index-KPSE_005fDEBUG_005fHASH-_0040r_007b_00282_0029_007d-359"></a><dd>Report lookups in all hash tables: <samp><span class="file">ls-R</span></samp> and <samp><span class="file">aliases</span></samp>
+ <br><dt><code>KPSE_DEBUG_HASH </code><span class="roman">(2)</span><a name="index-KPSE_005fDEBUG_005fHASH-_0040r_007b_00282_0029_007d-356"></a><dd>Report lookups in all hash tables: <samp><span class="file">ls-R</span></samp> and <samp><span class="file">aliases</span></samp>
(see <a href="#Filename-database">Filename database</a>); font aliases (see <a href="#Fontmap">Fontmap</a>); and config
file values (see <a href="#Config-files">Config files</a>). Useful when expected values are not
being found, e.g.., file searches are looking at the disk instead of
using <samp><span class="file">ls-R</span></samp>.
- <br><dt><code>KPSE_DEBUG_FOPEN </code><span class="roman">(4)</span><a name="index-KPSE_005fDEBUG_005fFOPEN-_0040r_007b_00284_0029_007d-360"></a><dd><a name="index-fopen_0040r_007b_002c-redefined_007d-361"></a>Report file openings and closings. Especially useful when your system's
+ <br><dt><code>KPSE_DEBUG_FOPEN </code><span class="roman">(4)</span><a name="index-KPSE_005fDEBUG_005fFOPEN-_0040r_007b_00284_0029_007d-357"></a><dd><a name="index-fopen_0040r_007b_002c-redefined_007d-358"></a>Report file openings and closings. Especially useful when your system's
file table is full, for seeing which files have been opened but never
closed. In case you want to set breakpoints in a debugger: this works by
redefining &lsquo;<samp><span class="samp">fopen</span></samp>&rsquo; (&lsquo;<samp><span class="samp">fclose</span></samp>&rsquo;) to be &lsquo;<samp><span class="samp">kpse_fopen_trace</span></samp>&rsquo;
(&lsquo;<samp><span class="samp">kpse_fclose_trace</span></samp>&rsquo;).
- <br><dt><code>KPSE_DEBUG_PATHS </code><span class="roman">(8)</span><a name="index-KPSE_005fDEBUG_005fPATHS-_0040r_007b_00288_0029_007d-362"></a><dd><a name="index-kpse_005fformat_005finfo_005ftype-363"></a>Report general path information for each file type Kpathsea is asked to
+ <br><dt><code>KPSE_DEBUG_PATHS </code><span class="roman">(8)</span><a name="index-KPSE_005fDEBUG_005fPATHS-_0040r_007b_00288_0029_007d-359"></a><dd><a name="index-kpse_005fformat_005finfo_005ftype-360"></a>Report general path information for each file type Kpathsea is asked to
search. This is useful when you are trying to track down how a
particular path got defined&mdash;from <samp><span class="file">texmf.cnf</span></samp>, <samp><span class="file">config.ps</span></samp>,
an environment variable, the compile-time default, etc. This is the
contents of the <code>kpse_format_info_type</code> structure defined in
<samp><span class="file">tex-file.h</span></samp>.
- <br><dt><code>KPSE_DEBUG_EXPAND </code><span class="roman">(16)</span><a name="index-KPSE_005fDEBUG_005fEXPAND-_0040r_007b_002816_0029_007d-364"></a><dd>Report the directory list corresponding to each path element Kpathsea
+ <br><dt><code>KPSE_DEBUG_EXPAND </code><span class="roman">(16)</span><a name="index-KPSE_005fDEBUG_005fEXPAND-_0040r_007b_002816_0029_007d-361"></a><dd>Report the directory list corresponding to each path element Kpathsea
searches. This is only relevant when Kpathsea searches the disk, since
<samp><span class="file">ls-R</span></samp> searches don't look through directory lists in this way.
- <br><dt><code>KPSE_DEBUG_SEARCH </code><span class="roman">(32)</span><a name="index-KPSE_005fDEBUG_005fSEARCH-_0040r_007b_002832_0029_007d-365"></a><dd>Report on each file search: the name of the file searched for, the path
+ <br><dt><code>KPSE_DEBUG_SEARCH </code><span class="roman">(32)</span><a name="index-KPSE_005fDEBUG_005fSEARCH-_0040r_007b_002832_0029_007d-362"></a><dd>Report on each file search: the name of the file searched for, the path
searched in, whether or not the file must exist (when drivers search for
<samp><span class="file">cmr10.vf</span></samp>, it need not exist), and whether or not we are
collecting all occurrences of the file in the path (as with, e.g.,
@@ -1947,12 +1933,12 @@ collecting all occurrences of the file in the path (as with, e.g.,
most lookups). This can help you correlate what Kpathsea is doing with
what is in your input file.
- <br><dt><code>KPSE_DEBUG_VARS </code><span class="roman">(64)</span><a name="index-KPSE_005fDEBUG_005fVARS-_0040r_007b_002864_0029_007d-366"></a><dd>Report the value of each variable Kpathsea looks up. This is useful for
+ <br><dt><code>KPSE_DEBUG_VARS </code><span class="roman">(64)</span><a name="index-KPSE_005fDEBUG_005fVARS-_0040r_007b_002864_0029_007d-363"></a><dd>Report the value of each variable Kpathsea looks up. This is useful for
verifying that variables do indeed obtain their correct values.
- <br><dt><code>GSFTOPK_DEBUG </code><span class="roman">(128)</span><a name="index-GSFTOPK_005fDEBUG-_0040r_007b_0028128_0029_007d-367"></a><dd>Activates debugging printout specific to <code>gsftopk</code> program.
+ <br><dt><code>GSFTOPK_DEBUG </code><span class="roman">(128)</span><a name="index-GSFTOPK_005fDEBUG-_0040r_007b_0028128_0029_007d-364"></a><dd>Activates debugging printout specific to <code>gsftopk</code> program.
- <br><dt><code>MAKETEX_DEBUG </code><span class="roman">(512)</span><a name="index-MAKETEX_005fDEBUG-_0040r_007b_0028512_0029_007d-368"></a><dd>If you use the optional <code>mktex</code> programs instead of the
+ <br><dt><code>MAKETEX_DEBUG </code><span class="roman">(512)</span><a name="index-MAKETEX_005fDEBUG-_0040r_007b_0028512_0029_007d-365"></a><dd>If you use the optional <code>mktex</code> programs instead of the
traditional shell scripts, this will report the name of the site file
(<samp><span class="file">mktex.cnf</span></samp> by default) which is read, directories created by
<code>mktexdir</code>, the full path of the <samp><span class="file">ls-R</span></samp> database built by
@@ -1960,19 +1946,19 @@ traditional shell scripts, this will report the name of the site file
parameters from <code>mktexnam</code>, filenames added by
<code>mktexupd</code>, and some subsidiary commands run by the programs.
- <br><dt><code>MAKETEX_FINE_DEBUG </code><span class="roman">(1024)</span><a name="index-MAKETEX_005fFINE_005fDEBUG-_0040r_007b_00281024_0029_007d-369"></a><dd>When the optional <code>mktex</code> programs are used, this will print
+ <br><dt><code>MAKETEX_FINE_DEBUG </code><span class="roman">(1024)</span><a name="index-MAKETEX_005fFINE_005fDEBUG-_0040r_007b_00281024_0029_007d-366"></a><dd>When the optional <code>mktex</code> programs are used, this will print
additional debugging info from functions internal to these programs.
</dl>
- <p><a name="index-g_t_0040samp_007bkdebug_003a_007d-370"></a><a name="index-hash_005fsummary_005fonly-_0040r_007bvariable-for-debugging_007d-371"></a><a name="index-hash-table-buckets_002c-printing-372"></a>Debugging output from Kpathsea is always written to standard error, and
+ <p><a name="index-g_t_0040samp_007bkdebug_003a_007d-367"></a><a name="index-hash_005fsummary_005fonly-_0040r_007bvariable-for-debugging_007d-368"></a><a name="index-hash-table-buckets_002c-printing-369"></a>Debugging output from Kpathsea is always written to standard error, and
begins with the string &lsquo;<samp><span class="samp">kdebug:</span></samp>&rsquo;. (Except for hash table buckets,
which just start with the number, but you can only get that output
running under a debugger. See comments at the <code>hash_summary_only</code>
variable in <samp><span class="file">kpathsea/db.c</span></samp>.)
<div class="node">
-<p><hr>
<a name="Logging"></a>
+<p><hr>
Next:&nbsp;<a rel="next" accesskey="n" href="#Common-problems">Common problems</a>,
Previous:&nbsp;<a rel="previous" accesskey="p" href="#Debugging">Debugging</a>,
Up:&nbsp;<a rel="up" accesskey="u" href="#Reporting-bugs">Reporting bugs</a>
@@ -1981,18 +1967,18 @@ Up:&nbsp;<a rel="up" accesskey="u" href="#Reporting-bugs">Reporting bugs</a>
<h4 class="subsection">2.6.4 Logging</h4>
-<p><a name="index-log-file-373"></a>
-<a name="index-logging-successful-searches-374"></a><a name="index-recording-successful-searches-375"></a><a name="index-usage-patterns_002c-finding-376"></a><a name="index-disk-usage_002c-reducing-377"></a>Kpathsea can record the time and filename found for each successful
+<p><a name="index-log-file-370"></a>
+<a name="index-logging-successful-searches-371"></a><a name="index-recording-successful-searches-372"></a><a name="index-usage-patterns_002c-finding-373"></a><a name="index-disk-usage_002c-reducing-374"></a>Kpathsea can record the time and filename found for each successful
search. This may be useful in finding good candidates for deletion when
your filesystem is full, or in discovering usage patterns
at your site.
- <p><a name="index-TEXMFLOG-378"></a>To do this, define the environment or config file variable
+ <p><a name="index-TEXMFLOG-375"></a>To do this, define the environment or config file variable
<code>TEXMFLOG</code>. The value is the name of the file to append the
information to. The file is created if it doesn't exist, and appended
to if it does.
- <p><a name="index-epoch_002c-seconds-since-379"></a><a name="index-time-_0040r_007bsystem-call_007d-380"></a>Each successful search turns into one line in the log file: two words
+ <p><a name="index-epoch_002c-seconds-since-376"></a><a name="index-time-_0040r_007bsystem-call_007d-377"></a>Each successful search turns into one line in the log file: two words
separated by a space. The first word is the time of the search, as the
integer number of seconds since &ldquo;the epoch&rdquo;, i.e., UTC midnight 1
January 1970 (more precisely, the result of the <code>time</code> system
@@ -2009,7 +1995,7 @@ call). The second word is the filename.
774455889 /usr/local/share/texmf/fonts/pk/ljfour/public/cm/cmr10.600pk
774455889 /usr/local/share/texmf/dvips/texc.pro
</pre>
- <p><a name="index-privacy_002c-semblance-of-381"></a>Only filenames that are absolute are recorded, to preserve
+ <p><a name="index-privacy_002c-semblance-of-378"></a>Only filenames that are absolute are recorded, to preserve
some semblance of privacy.
<p>In addition to this Kpathsea-specific logging, <samp><span class="command">pdftex</span></samp>
@@ -2022,8 +2008,8 @@ call, thus including opening and closing files. It might be named
else.
<div class="node">
-<p><hr>
<a name="Common-problems"></a>
+<p><hr>
Previous:&nbsp;<a rel="previous" accesskey="p" href="#Logging">Logging</a>,
Up:&nbsp;<a rel="up" accesskey="u" href="#Reporting-bugs">Reporting bugs</a>
@@ -2031,7 +2017,7 @@ Up:&nbsp;<a rel="up" accesskey="u" href="#Reporting-bugs">Reporting bugs</a>
<h4 class="subsection">2.6.5 Common problems</h4>
-<p><a name="index-common-problems-382"></a><a name="index-problems_002c-common-383"></a><a name="index-FAQ_002c-Kpathsea-384"></a>
+<p><a name="index-common-problems-379"></a><a name="index-problems_002c-common-380"></a><a name="index-FAQ_002c-Kpathsea-381"></a>
Here are some common problems with configuration, compilation, linking,
execution, <small class="dots">...</small>
@@ -2049,8 +2035,8 @@ execution, <small class="dots">...</small>
</ul>
<div class="node">
-<p><hr>
<a name="Unable-to-find-files"></a>
+<p><hr>
Next:&nbsp;<a rel="next" accesskey="n" href="#Slow-path-searching">Slow path searching</a>,
Up:&nbsp;<a rel="up" accesskey="u" href="#Common-problems">Common problems</a>
@@ -2058,7 +2044,7 @@ Up:&nbsp;<a rel="up" accesskey="u" href="#Common-problems">Common problems</a>
<h5 class="subsubsection">2.6.5.1 Unable to find files</h5>
-<p><a name="index-unable-to-find-files-385"></a><a name="index-files_002c-unable-to-find-386"></a>
+<p><a name="index-unable-to-find-files-382"></a><a name="index-files_002c-unable-to-find-383"></a>
If a program complains it cannot find fonts (or other input files), any
of several things might be wrong. In any case, you may find the
debugging options helpful. See <a href="#Debugging">Debugging</a>.
@@ -2068,13 +2054,13 @@ debugging options helpful. See <a href="#Debugging">Debugging</a>.
fonts and input files are distributed separately from the programs.
See <a href="#unixtex_002eftp">unixtex.ftp</a>.
- <li><a name="index-g_t_002fetc_002fprofile-387"></a><a name="index-environment-variables_002c-old-388"></a>You have (perhaps unknowingly) told Kpathsea to use search paths that
+ <li><a name="index-g_t_002fetc_002fprofile-384"></a><a name="index-environment-variables_002c-old-385"></a>You have (perhaps unknowingly) told Kpathsea to use search paths that
don't reflect where the files actually are. One common cause is having
environment variables set from a previous installation, thus overriding
what you carefully set in <samp><span class="file">texmf.cnf</span></samp> (see <a href="#Supported-file-formats">Supported file formats</a>). System <samp><span class="file">/etc/profile</span></samp> or other files such may be the
culprit.
- <li><a name="index-symbolic-links-not-found-389"></a><a name="index-leaf-directories-wrongly-guessed-390"></a>Your files reside in a directory that is only pointed to via a symbolic
+ <li><a name="index-symbolic-links-not-found-386"></a><a name="index-leaf-directories-wrongly-guessed-387"></a>Your files reside in a directory that is only pointed to via a symbolic
link, in a leaf directory and is not listed in <samp><span class="file">ls-R</span></samp>.
<p>Unfortunately, Kpathsea's subdirectory searching has an irremediable
@@ -2105,8 +2091,8 @@ fonts by hand with Metafont, or to grab them from a CTAN site
</ul>
<div class="node">
-<p><hr>
<a name="Slow-path-searching"></a>
+<p><hr>
Next:&nbsp;<a rel="next" accesskey="n" href="#Unable-to-generate-fonts">Unable to generate fonts</a>,
Previous:&nbsp;<a rel="previous" accesskey="p" href="#Unable-to-find-files">Unable to find files</a>,
Up:&nbsp;<a rel="up" accesskey="u" href="#Common-problems">Common problems</a>
@@ -2115,7 +2101,7 @@ Up:&nbsp;<a rel="up" accesskey="u" href="#Common-problems">Common problems</a>
<h5 class="subsubsection">2.6.5.2 Slow path searching</h5>
-<p><a name="index-excessive-startup-time-391"></a><a name="index-slow-startup-time-392"></a><a name="index-startup-time_002c-excessive-393"></a>
+<p><a name="index-excessive-startup-time-388"></a><a name="index-slow-startup-time-389"></a><a name="index-startup-time_002c-excessive-390"></a>
If your program takes an excessively long time to find fonts or other
input files, but does eventually succeed, here are some possible culprits:
@@ -2142,8 +2128,8 @@ the dozens of TFM, PK, or whatever files reside.
precisely when the disk or network is being pounded. See <a href="#Debugging">Debugging</a>.
<div class="node">
-<p><hr>
<a name="Unable-to-generate-fonts"></a>
+<p><hr>
Next:&nbsp;<a rel="next" accesskey="n" href="#TeX-or-Metafont-failing">TeX or Metafont failing</a>,
Previous:&nbsp;<a rel="previous" accesskey="p" href="#Slow-path-searching">Slow path searching</a>,
Up:&nbsp;<a rel="up" accesskey="u" href="#Common-problems">Common problems</a>
@@ -2152,14 +2138,14 @@ Up:&nbsp;<a rel="up" accesskey="u" href="#Common-problems">Common problems</a>
<h5 class="subsubsection">2.6.5.3 Unable to generate fonts</h5>
-<p><a name="index-unable-to-generate-fonts-394"></a><a name="index-font-generation-failures-395"></a>
+<p><a name="index-unable-to-generate-fonts-391"></a><a name="index-font-generation-failures-392"></a>
Metafont outputs fonts in bitmap format, tuned for a particular
device at a particular resolution, in order to allow for the
highest-possible quality of output. Some DVI-to-whatever programs,
such as Dvips, try to generate these on the fly when they are needed,
but this generation may fail in several cases.
- <p><a name="index-g_t_0040code_007bmktexpk_007d-can_0027t-guess-mode-396"></a>If <code>mktexpk</code> runs, but fails with this error:
+ <p><a name="index-g_t_0040code_007bmktexpk_007d-can_0027t-guess-mode-393"></a>If <code>mktexpk</code> runs, but fails with this error:
<pre class="example"> mktexpk: Can't guess mode for <var>nnn</var> dpi devices.
mktexpk: Use a config file to specify the mode, or update me.
</pre>
@@ -2177,14 +2163,14 @@ a configuration file:
<pre class="example"> D 360
M lqmed
</pre>
- <p><a name="index-Metafont-using-the-wrong-device-397"></a><a name="index-device_002c-wrong-398"></a>If Metafont runs, but generates fonts at the wrong resolution or for
+ <p><a name="index-Metafont-using-the-wrong-device-394"></a><a name="index-device_002c-wrong-395"></a>If Metafont runs, but generates fonts at the wrong resolution or for
the wrong device, most likely <code>mktexpk</code>'s built-in guess for the
mode is wrong, and you should override it as above.
<p>See <a href="ftp://ftp.tug.org/tex/modes.mf">ftp://ftp.tug.org/tex/modes.mf</a> for a list of resolutions and
mode names for most devices (additional submissions are welcome).
- <p><a name="index-g_t_002e2602gf-399"></a><a name="index-g_t2602gf-400"></a><a name="index-Metafont-making-too_002dlarge-fonts-401"></a><a name="index-proof-mode-402"></a><a name="index-online-Metafont-display_002c-spurious-403"></a>If Metafont runs but generates fonts at a resolution of 2602<span class="dmn">dpi</span>
+ <p><a name="index-g_t_002e2602gf-396"></a><a name="index-g_t2602gf-397"></a><a name="index-Metafont-making-too_002dlarge-fonts-398"></a><a name="index-proof-mode-399"></a><a name="index-online-Metafont-display_002c-spurious-400"></a>If Metafont runs but generates fonts at a resolution of 2602<span class="dmn">dpi</span>
(and prints out the name of each character as well as just a character
number, and maybe tries to display the characters), then your Metafont
base file probably hasn't been made properly. (It's using the default
@@ -2194,19 +2180,19 @@ a file <samp><span class="file">modes.mf</span></samp>, run the following comman
<pre class="example"> inimf "plain; input modes; dump"
</pre>
- <p class="noindent"><a name="index-plain_002ebase-404"></a>Then copy the <samp><span class="file">plain.base</span></samp> file from the current directory to where
+ <p class="noindent"><a name="index-plain_002ebase-401"></a>Then copy the <samp><span class="file">plain.base</span></samp> file from the current directory to where
the base files are stored on your system
(<samp><span class="file">/usr/local/share/texmf/web2c</span></samp> by default), and make a link
(either hard or soft) from <samp><span class="file">plain.base</span></samp> to <samp><span class="file">mf.base</span></samp> in that
directory.
See <a href="web2c.html#inimf-invocation">inimf invocation</a>.
- <p><a name="index-Metafont-installation-405"></a>If <code>mf</code> is a command not found at all by <code>mktexpk</code>, then you
+ <p><a name="index-Metafont-installation-402"></a>If <code>mf</code> is a command not found at all by <code>mktexpk</code>, then you
need to install Metafont (see <a href="#unixtex_002eftp">unixtex.ftp</a>).
<div class="node">
-<p><hr>
<a name="TeX-or-Metafont-failing"></a>
+<p><hr>
Next:&nbsp;<a rel="next" accesskey="n" href="#Empty-Makefiles">Empty Makefiles</a>,
Previous:&nbsp;<a rel="previous" accesskey="p" href="#Unable-to-generate-fonts">Unable to generate fonts</a>,
Up:&nbsp;<a rel="up" accesskey="u" href="#Common-problems">Common problems</a>
@@ -2215,7 +2201,7 @@ Up:&nbsp;<a rel="up" accesskey="u" href="#Common-problems">Common problems</a>
<h5 class="subsubsection">2.6.5.4 TeX or Metafont failing</h5>
-<p><a name="index-g_t_0040TeX_007b_007d-failures-406"></a><a name="index-Metafont-failures-407"></a><a name="index-compiler-bugs-408"></a>If TeX or Metafont get a segmentation fault or otherwise fail while
+<p><a name="index-g_t_0040TeX_007b_007d-failures-403"></a><a name="index-Metafont-failures-404"></a><a name="index-compiler-bugs-405"></a>If TeX or Metafont get a segmentation fault or otherwise fail while
running a normal input file, the problem is usually a compiler bug
(unlikely as that may sound). Even if the trip and trap tests are
passed, problems may lurk. Optimization occasionally causes trouble in
@@ -2224,21 +2210,21 @@ programs other than TeX and Metafont themselves, too.
<p>Insufficient swap space may also cause core dumps or other erratic
behavior.
- <p><a name="index-optimization-caveat-409"></a>For a workaround, if you enabled any optimization flags, it's best to
+ <p><a name="index-optimization-caveat-406"></a>For a workaround, if you enabled any optimization flags, it's best to
omit optimization entirely. In any case, the way to find the facts is
to run the program under the debugger and see where it's failing.
- <p><a name="index-GNU-C-compiler-bugs-410"></a><a name="index-system-C-compiler-bugs-411"></a>Also, if you have trouble with a system C compiler, I advise trying the
+ <p><a name="index-GNU-C-compiler-bugs-407"></a><a name="index-system-C-compiler-bugs-408"></a>Also, if you have trouble with a system C compiler, I advise trying the
GNU C compiler. And vice versa, unfortunately; but in that case I also
recommend reporting a bug to the GCC mailing list; see <a href="gcc.html#Bugs">Bugs</a>.
- <p><a name="index-compiler-bugs_002c-finding-412"></a>To report compiler bugs effectively requires perseverance and
+ <p><a name="index-compiler-bugs_002c-finding-409"></a>To report compiler bugs effectively requires perseverance and
perspicacity: you must find the miscompiled line, and that usually
involves delving backwards in time from the point of error, checking
through TeX's (or whatever program's) data structures. Things are
not helped by all-too-common bugs in the debugger itself. Good luck.
- <p><a name="index-ANSI-C-413"></a><a name="index-HP_002dUX_002c-compiling-on-414"></a><a name="index-compiling-on-HP_002dUX-415"></a>One known cause of trouble is the way arrays are handled. Some of the
+ <p><a name="index-ANSI-C-410"></a><a name="index-HP_002dUX_002c-compiling-on-411"></a><a name="index-compiling-on-HP_002dUX-412"></a>One known cause of trouble is the way arrays are handled. Some of the
Pascal arrays have a lower index other than 0, and the C code will take
the pointer to the allocated memory, subtract the lower index, and use
the resulting pointer for the array. While this trick often works, ANSI
@@ -2247,8 +2233,8 @@ mchines when the native compiler is used, unless the &lsquo;<samp><span class="s
switch was specified. Using GCC will work on this platform as well.
<div class="node">
-<p><hr>
<a name="Empty-Makefiles"></a>
+<p><hr>
Next:&nbsp;<a rel="next" accesskey="n" href="#XtStrings">XtStrings</a>,
Previous:&nbsp;<a rel="previous" accesskey="p" href="#TeX-or-Metafont-failing">TeX or Metafont failing</a>,
Up:&nbsp;<a rel="up" accesskey="u" href="#Common-problems">Common problems</a>
@@ -2257,7 +2243,7 @@ Up:&nbsp;<a rel="up" accesskey="u" href="#Common-problems">Common problems</a>
<h5 class="subsubsection">2.6.5.5 Empty Makefiles</h5>
-<p><a name="index-Makefiles_002c-empty-416"></a><a name="index-sed-_0040r_007berror-from-_0040code_007bconfigure_007d_007d-417"></a><a name="index-configure-_0040r_007berror-from-_0040code_007bsed_007d_007d-418"></a><a name="index-NetBSD-_0040code_007bconfigure_007d-error-419"></a><a name="index-FreeBSD-_0040code_007bconfigure_007d-error-420"></a><a name="index-Mach10-_0040code_007bconfigure_007d-error-421"></a><a name="index-AIX-4_002e1-_0040code_007bconfigure_007d-error-422"></a><a name="index-NeXT-_0040code_007bsed_007d-error-423"></a>
+<p><a name="index-Makefiles_002c-empty-413"></a><a name="index-sed-_0040r_007berror-from-_0040code_007bconfigure_007d_007d-414"></a><a name="index-configure-_0040r_007berror-from-_0040code_007bsed_007d_007d-415"></a><a name="index-NetBSD-_0040code_007bconfigure_007d-error-416"></a><a name="index-FreeBSD-_0040code_007bconfigure_007d-error-417"></a><a name="index-Mach10-_0040code_007bconfigure_007d-error-418"></a><a name="index-AIX-4_002e1-_0040code_007bconfigure_007d-error-419"></a><a name="index-NeXT-_0040code_007bsed_007d-error-420"></a>
On some systems (NetBSD, FreeBSD, AIX 4.1, and Mach10), <code>configure</code>
may fail to properly create the Makefiles. Instead, you get an error
which looks something like this:
@@ -2286,8 +2272,8 @@ command. In that case the error may look like this:
can get GNU <code>sed</code> from the same places as Bash.
<div class="node">
-<p><hr>
<a name="XtStrings"></a>
+<p><hr>
Next:&nbsp;<a rel="next" accesskey="n" href="#dlopen">dlopen</a>,
Previous:&nbsp;<a rel="previous" accesskey="p" href="#Empty-Makefiles">Empty Makefiles</a>,
Up:&nbsp;<a rel="up" accesskey="u" href="#Common-problems">Common problems</a>
@@ -2296,7 +2282,7 @@ Up:&nbsp;<a rel="up" accesskey="u" href="#Common-problems">Common problems</a>
<h5 class="subsubsection">2.6.5.6 <code>XtStrings</code></h5>
-<p><a name="index-XtStrings-424"></a>You may find that linking X programs results in an error from the linker
+<p><a name="index-XtStrings-421"></a>You may find that linking X programs results in an error from the linker
that &lsquo;<samp><span class="samp">XtStrings</span></samp>&rsquo; is undefined, something like this:
<pre class="example"> gcc -o virmf ...
@@ -2313,8 +2299,8 @@ options &lsquo;<samp><span class="samp">--x-includes=</span><var>path</var></sam
&lsquo;<samp><span class="samp">--x-libraries=</span><var>path</var></samp>&rsquo; to explicitly specify them.
<div class="node">
-<p><hr>
<a name="dlopen"></a>
+<p><hr>
Next:&nbsp;<a rel="next" accesskey="n" href="#ShellWidgetClass">ShellWidgetClass</a>,
Previous:&nbsp;<a rel="previous" accesskey="p" href="#XtStrings">XtStrings</a>,
Up:&nbsp;<a rel="up" accesskey="u" href="#Common-problems">Common problems</a>
@@ -2323,7 +2309,7 @@ Up:&nbsp;<a rel="up" accesskey="u" href="#Common-problems">Common problems</a>
<h5 class="subsubsection">2.6.5.7 <code>dlopen</code></h5>
-<p><a name="index-static-linking-and-_0040code_007bdlsym_007d-425"></a><a name="index-dlopen-426"></a><a name="index-dlsym-427"></a><a name="index-dlclose-428"></a><a name="index-wcstombs-429"></a><a name="index-libdl_002ea-430"></a>(This section adapted from the file <samp><span class="file">dlsym.c</span></samp> in the X distribution.)
+<p><a name="index-static-linking-and-_0040code_007bdlsym_007d-422"></a><a name="index-dlopen-423"></a><a name="index-dlsym-424"></a><a name="index-dlclose-425"></a><a name="index-wcstombs-426"></a><a name="index-libdl_002ea-427"></a>(This section adapted from the file <samp><span class="file">dlsym.c</span></samp> in the X distribution.)
<p>The <code>Xlib</code> library uses the standard C function <code>wcstombs</code>.
Under SunOS 4.1, <code>wcstombs</code> uses the &lsquo;<samp><span class="samp">dlsym</span></samp>&rsquo; interface defined
@@ -2339,12 +2325,12 @@ when you link:
void *dlsym() { return 0; }
int dlclose() { return -1; }
</pre>
- <p><a name="index-dlsym_002ec-431"></a>These are contained in the <samp><span class="file">dlsym.c</span></samp> file in the MIT X
+ <p><a name="index-dlsym_002ec-428"></a>These are contained in the <samp><span class="file">dlsym.c</span></samp> file in the MIT X
distribution.
<div class="node">
-<p><hr>
<a name="ShellWidgetClass"></a>
+<p><hr>
Next:&nbsp;<a rel="next" accesskey="n" href="#Pointer-combination-warnings">Pointer combination warnings</a>,
Previous:&nbsp;<a rel="previous" accesskey="p" href="#dlopen">dlopen</a>,
Up:&nbsp;<a rel="up" accesskey="u" href="#Common-problems">Common problems</a>
@@ -2353,15 +2339,15 @@ Up:&nbsp;<a rel="up" accesskey="u" href="#Common-problems">Common problems</a>
<h5 class="subsubsection">2.6.5.8 <code>ShellWidgetClass</code></h5>
-<p><a name="index-dynamic-linking-problems-with-OpenWin-libraries-432"></a><a name="index-OpenWin-libraries_002c-dynamic-linking-problems-433"></a><a name="index-get_005fwmShellWidgetClass-434"></a><a name="index-get_005fapplicationShellWidgetClass-435"></a>
-<a name="index-comp_002esys_002esun_002eadmin-_0040r_007bFAQ_007d-436"></a><a name="index-FAQ_002c-_0040t_007bcomp_002esys_002esun_002eadmin_007d-437"></a>(This section adapted from the <tt>comp.sys.sun.admin</tt> FAQ.)
+<p><a name="index-dynamic-linking-problems-with-OpenWin-libraries-429"></a><a name="index-OpenWin-libraries_002c-dynamic-linking-problems-430"></a><a name="index-get_005fwmShellWidgetClass-431"></a><a name="index-get_005fapplicationShellWidgetClass-432"></a>
+<a name="index-comp_002esys_002esun_002eadmin-_0040r_007bFAQ_007d-433"></a><a name="index-FAQ_002c-_0040t_007bcomp_002esys_002esun_002eadmin_007d-434"></a>(This section adapted from the <tt>comp.sys.sun.admin</tt> FAQ.)
<p>If you are linking with Sun's OpenWindows libraries in SunOS 4.1.x, you
may get undefined symbols <code>_get_wmShellWidgetClass</code> and
<code>_get_applicationShellWidgetClass</code> when linking. This problem does
not arise using the standard MIT X libraries under SunOS.
- <p><a name="index-Xmu-_0040r_007blibrary-problems_007d-438"></a>The cause is bugs in the <code>Xmu</code> shared library as shipped from Sun.
+ <p><a name="index-Xmu-_0040r_007blibrary-problems_007d-435"></a>The cause is bugs in the <code>Xmu</code> shared library as shipped from Sun.
There are several fixes:
<ul>
@@ -2379,7 +2365,7 @@ compiling Xdvi, see the <code>-DNOTOOL</code> option in <samp><span class="file"
</ul>
- <p><a name="index-Sun-OpenWin-patches-439"></a><a name="index-patches_002c-Sun-OpenWin-440"></a>Here is the information for getting the two patches:
+ <p><a name="index-Sun-OpenWin-patches-436"></a><a name="index-patches_002c-Sun-OpenWin-437"></a>Here is the information for getting the two patches:
<pre class="display"> Patch ID: 100512-02
Bug ID's: 1086793, 1086912, 1074766
@@ -2389,18 +2375,18 @@ compiling Xdvi, see the <code>-DNOTOOL</code> option in <samp><span class="file"
Bug ID: 1087332
Description: 4.1.x OpenWindows 3.0 undefined symbols when using shared <code>libXmu</code>.
</pre>
- <p><a name="index-static-linking-441"></a>The way to statically link with <code>libXmu</code> depends on whether you are
+ <p><a name="index-static-linking-438"></a>The way to statically link with <code>libXmu</code> depends on whether you are
using a Sun compiler (e.g., <code>cc</code>) or <code>gcc</code>. If the latter,
alter the <code>x_libs</code> Make variable to include
- <p><a name="index-g_t_002dstatic-442"></a><a name="index-g_t_002ddynamic-443"></a>
+ <p><a name="index-g_t_002dstatic-439"></a><a name="index-g_t_002ddynamic-440"></a>
<pre class="example"> -static -lXmu -dynamic
</pre>
- <p><a name="index-g_t_002dBstatic-444"></a><a name="index-g_t_002dBdynamic-445"></a>If you are using the Sun compiler, use &lsquo;<samp><span class="samp">-Bstatic</span></samp>&rsquo; and &lsquo;<samp><span class="samp">-Bdynamic</span></samp>&rsquo;.
+ <p><a name="index-g_t_002dBstatic-441"></a><a name="index-g_t_002dBdynamic-442"></a>If you are using the Sun compiler, use &lsquo;<samp><span class="samp">-Bstatic</span></samp>&rsquo; and &lsquo;<samp><span class="samp">-Bdynamic</span></samp>&rsquo;.
<div class="node">
-<p><hr>
<a name="Pointer-combination-warnings"></a>
+<p><hr>
Previous:&nbsp;<a rel="previous" accesskey="p" href="#ShellWidgetClass">ShellWidgetClass</a>,
Up:&nbsp;<a rel="up" accesskey="u" href="#Common-problems">Common problems</a>
@@ -2408,7 +2394,7 @@ Up:&nbsp;<a rel="up" accesskey="u" href="#Common-problems">Common problems</a>
<h5 class="subsubsection">2.6.5.9 Pointer combination warnings</h5>
-<p><a name="index-warnings_002c-pointer-combinations-446"></a><a name="index-pointer-combination-warnings-447"></a><a name="index-illegal-pointer-combination-warnings-448"></a><a name="index-cc-_0040r_007bwarnings_007d-449"></a>When compiling with old C compilers, you may get some warnings about
+<p><a name="index-warnings_002c-pointer-combinations-443"></a><a name="index-pointer-combination-warnings-444"></a><a name="index-illegal-pointer-combination-warnings-445"></a><a name="index-cc-_0040r_007bwarnings_007d-446"></a>When compiling with old C compilers, you may get some warnings about
&ldquo;illegal pointer combinations&rdquo;. These are spurious; just ignore them.
I decline to clutter up the source with casts to get rid of them.
@@ -2466,8 +2452,8 @@ I decline to clutter up the source with casts to get rid of them.
<!-- * Empty Makefiles:: If configure gives you sed errors. -->
<!-- * wchar_t:: For wchar_t difficulties. -->
<div class="node">
-<p><hr>
<a name="Path-searching"></a>
+<p><hr>
Next:&nbsp;<a rel="next" accesskey="n" href="#TeX-support">TeX support</a>,
Previous:&nbsp;<a rel="previous" accesskey="p" href="#Installation">Installation</a>,
Up:&nbsp;<a rel="up" accesskey="u" href="#Top">Top</a>
@@ -2476,7 +2462,7 @@ Up:&nbsp;<a rel="up" accesskey="u" href="#Top">Top</a>
<h2 class="chapter">3 Path searching</h2>
-<p><a name="index-path-searching-450"></a>
+<p><a name="index-path-searching-447"></a>
This chapter describes the generic path searching mechanism Kpathsea
provides. For information about searching for particular file types
(e.g., TeX fonts), see the next chapter.
@@ -2490,8 +2476,8 @@ provides. For information about searching for particular file types
</ul>
<div class="node">
-<p><hr>
<a name="Searching-overview"></a>
+<p><hr>
Next:&nbsp;<a rel="next" accesskey="n" href="#Path-sources">Path sources</a>,
Up:&nbsp;<a rel="up" accesskey="u" href="#Path-searching">Path searching</a>
@@ -2499,24 +2485,24 @@ Up:&nbsp;<a rel="up" accesskey="u" href="#Path-searching">Path searching</a>
<h3 class="section">3.1 Searching overview</h3>
-<p><a name="index-searching-overview-451"></a><a name="index-path-searching_002c-overview-452"></a><a name="index-overview-of-path-searching-453"></a>
-<a name="index-search-path_002c-defined-454"></a>A <dfn>search path</dfn> is a colon-separated list of <dfn>path elements</dfn>,
+<p><a name="index-searching-overview-448"></a><a name="index-path-searching_002c-overview-449"></a><a name="index-overview-of-path-searching-450"></a>
+<a name="index-search-path_002c-defined-451"></a>A <dfn>search path</dfn> is a colon-separated list of <dfn>path elements</dfn>,
which are directory names with a few extra frills. A search path can
come from (a combination of) many sources; see below. To look up a file
&lsquo;<samp><span class="samp">foo</span></samp>&rsquo; along a path &lsquo;<samp><span class="samp">.:/dir</span></samp>&rsquo;, Kpathsea checks each element of
the path in turn: first <samp><span class="file">./foo</span></samp>, then <samp><span class="file">/dir/foo</span></samp>, returning
the first match (or possibly all matches).
- <p><a name="index-magic-characters-455"></a><a name="index-g_t_003a-_0040r_007bmay-not-be-_003a_007d-456"></a><a name="index-g_t_002f-_0040r_007bmay-not-be-_002f_007d-457"></a>The &ldquo;colon&rdquo; and &ldquo;slash&rdquo; mentioned here aren't necessarily &lsquo;<samp><span class="samp">:</span></samp>&rsquo;
+ <p><a name="index-magic-characters-452"></a><a name="index-g_t_003a-_0040r_007bmay-not-be-_003a_007d-453"></a><a name="index-g_t_002f-_0040r_007bmay-not-be-_002f_007d-454"></a>The &ldquo;colon&rdquo; and &ldquo;slash&rdquo; mentioned here aren't necessarily &lsquo;<samp><span class="samp">:</span></samp>&rsquo;
and &lsquo;<samp><span class="samp">/</span></samp>&rsquo; on non-Unix systems. Kpathsea tries to adapt to other
operating systems' conventions.
- <p><a name="index-database-search-458"></a><a name="index-searching-the-database-459"></a>To check a particular path element <var>e</var>, Kpathsea first sees if a
+ <p><a name="index-database-search-455"></a><a name="index-searching-the-database-456"></a>To check a particular path element <var>e</var>, Kpathsea first sees if a
prebuilt database (see <a href="#Filename-database">Filename database</a>) applies to <var>e</var>, i.e.,
if the database is in a directory that is a prefix of <var>e</var>. If so,
the path specification is matched against the contents of the database.
- <p><a name="index-floating-directories-460"></a><a name="index-filesystem-search-461"></a><a name="index-disk-search-462"></a><a name="index-searching-the-disk-463"></a>If the database does not exist, or does not apply to this path element,
+ <p><a name="index-floating-directories-457"></a><a name="index-filesystem-search-458"></a><a name="index-disk-search-459"></a><a name="index-searching-the-disk-460"></a>If the database does not exist, or does not apply to this path element,
or contains no matches, the filesystem is searched (if this was not
forbidden by the specification with &lsquo;<samp><span class="samp">!!</span></samp>&rsquo; and if the file being
searched for must exist). Kpathsea constructs the list of directories
@@ -2525,7 +2511,7 @@ file being searched for. (To help speed future lookups of files in the
same directory, the directory in which a file is found is floated to the
top of the directory list.)
- <p><a name="index-must-exist-464"></a><a name="index-VF-files_002c-not-found-465"></a><a name="index-cmr10_002evf-466"></a><a name="index-g_t_005copenin-467"></a>The &ldquo;file must exist&rdquo; condition comes into play with VF files and
+ <p><a name="index-must-exist-461"></a><a name="index-VF-files_002c-not-found-462"></a><a name="index-cmr10_002evf-463"></a><a name="index-g_t_005copenin-464"></a>The &ldquo;file must exist&rdquo; condition comes into play with VF files and
input files read by the TeX &lsquo;<samp><span class="samp">\openin</span></samp>&rsquo; command. These files
might very well not exist (consider <samp><span class="file">cmr10.vf</span></samp>), and so it would
be wrong to search the disk for them. Therefore, if you fail to
@@ -2538,7 +2524,7 @@ avoids possibly-expensive processing of path specifications that are
never needed on a particular run. (Unless the search explicitly
requested all matches.)
- <p><a name="index-expansion_002c-path-element-468"></a>Although the simplest and most common path element is a directory name,
+ <p><a name="index-expansion_002c-path-element-465"></a>Although the simplest and most common path element is a directory name,
Kpathsea supports additional features in search paths: layered default
values, environment variable names, config file values, users' home
directories, and recursive subdirectory searching. Thus, we say that
@@ -2547,11 +2533,11 @@ magic specifications into the basic directory name or names. This
process is described in the sections below. It happens in the same
order as the sections.
- <p><a name="index-absolute-filenames-469"></a><a name="index-relative-filenames-470"></a><a name="index-explicitly-relative-filenames-471"></a><a name="index-filenames_002c-absolute-or-explicitly-relative-472"></a>Exception to all of the above: If the filename being searched for is
+ <p><a name="index-absolute-filenames-466"></a><a name="index-relative-filenames-467"></a><a name="index-explicitly-relative-filenames-468"></a><a name="index-filenames_002c-absolute-or-explicitly-relative-469"></a>Exception to all of the above: If the filename being searched for is
absolute or explicitly relative, i.e., starts with &lsquo;<samp><span class="samp">/</span></samp>&rsquo; or &lsquo;<samp><span class="samp">./</span></samp>&rsquo;
or &lsquo;<samp><span class="samp">../</span></samp>&rsquo;, Kpathsea simply checks if that file exists.
- <p><a name="index-permission-denied-473"></a><a name="index-unreadable-files-474"></a><a name="index-access-warnings-475"></a><a name="index-warnings_002c-file-access-476"></a><a name="index-lost_002bfound-_0040r_007bdirectory_007d-477"></a><a name="index-TEX_005fHUSH-478"></a>Ordinarily, if Kpathsea tries to access a file or directory that
+ <p><a name="index-permission-denied-470"></a><a name="index-unreadable-files-471"></a><a name="index-access-warnings-472"></a><a name="index-warnings_002c-file-access-473"></a><a name="index-lost_002bfound-_0040r_007bdirectory_007d-474"></a><a name="index-TEX_005fHUSH-475"></a>Ordinarily, if Kpathsea tries to access a file or directory that
cannot be read, it gives a warning. This is so you will be alerted to
directories or files that accidentally lack any read permission (for
example, a <samp><span class="file">lost+found</span></samp> directory). If you prefer not to see
@@ -2563,8 +2549,8 @@ these warnings, include the value &lsquo;<samp><span class="samp">readable</span
algorithm when searching for a file of a particular type (see <a href="#File-lookup">File lookup</a>, and <a href="#Glyph-lookup">Glyph lookup</a>).
<div class="node">
-<p><hr>
<a name="Path-sources"></a>
+<p><hr>
Next:&nbsp;<a rel="next" accesskey="n" href="#Path-expansion">Path expansion</a>,
Previous:&nbsp;<a rel="previous" accesskey="p" href="#Searching-overview">Searching overview</a>,
Up:&nbsp;<a rel="up" accesskey="u" href="#Path-searching">Path searching</a>
@@ -2573,12 +2559,12 @@ Up:&nbsp;<a rel="up" accesskey="u" href="#Path-searching">Path searching</a>
<h3 class="section">3.2 Path sources</h3>
-<p><a name="index-path-sources-479"></a><a name="index-sources-for-search-paths-480"></a>
+<p><a name="index-path-sources-476"></a><a name="index-sources-for-search-paths-477"></a>
A search path can come from many sources. In the order in which
Kpathsea uses them:
<ol type=1 start=1>
-<li><a name="index-environment-variable_002c-source-for-path-481"></a>A user-set environment variable, e.g., <code>TEXINPUTS</code>.
+<li><a name="index-environment-variable_002c-source-for-path-478"></a>A user-set environment variable, e.g., <code>TEXINPUTS</code>.
Environment variables with an underscore and the program name appended
override; for example, <code>TEXINPUTS_latex</code> overrides <code>TEXINPUTS</code>
if the program being run is named &lsquo;<samp><span class="samp">latex</span></samp>&rsquo;.
@@ -2586,10 +2572,10 @@ if the program being run is named &lsquo;<samp><span class="samp">latex</span></
<li>A program-specific configuration file, e.g., an &lsquo;<samp><span class="samp">S /a:/b</span></samp>&rsquo; line in
Dvips' <samp><span class="file">config.ps</span></samp> (see <a href="dvips.html#Config-files">Config files</a>).
- <li><a name="index-configuration-file_002c-source-for-path-482"></a><a name="index-Kpathsea-config-file_002c-source-for-path-483"></a><a name="index-texmf_002ecnf_0040r_007b_002c-source-for-path_007d-484"></a>A line in a Kpathsea configuration file <samp><span class="file">texmf.cnf</span></samp>, e.g.,
+ <li><a name="index-configuration-file_002c-source-for-path-479"></a><a name="index-Kpathsea-config-file_002c-source-for-path-480"></a><a name="index-texmf_002ecnf_0040r_007b_002c-source-for-path_007d-481"></a>A line in a Kpathsea configuration file <samp><span class="file">texmf.cnf</span></samp>, e.g.,
&lsquo;<samp><span class="samp">TEXINPUTS=/c:/d</span></samp>&rsquo; (see below).
- <li><a name="index-compilation-value_002c-source-for-path-485"></a>The compile-time default (specified in <samp><span class="file">kpathsea/paths.h</span></samp>).
+ <li><a name="index-compilation-value_002c-source-for-path-482"></a>The compile-time default (specified in <samp><span class="file">kpathsea/paths.h</span></samp>).
</ol>
<p>You can see each of these values for a given search path by using the
@@ -2602,16 +2588,16 @@ debugging options (see <a href="#Debugging">Debugging</a>).
</ul>
<div class="node">
-<p><hr>
<a name="Config-files"></a>
+<p><hr>
Up:&nbsp;<a rel="up" accesskey="u" href="#Path-sources">Path sources</a>
</div>
<h4 class="subsection">3.2.1 Config files</h4>
-<p><a name="index-config-files-486"></a><a name="index-texmf_002ecnf_0040r_007b_002c-definition-for_007d-487"></a>
-<a name="index-runtime-configuration-files-488"></a><a name="index-TEXMFCNF-489"></a>As mentioned above, Kpathsea reads <dfn>runtime configuration files</dfn>
+<p><a name="index-config-files-483"></a><a name="index-texmf_002ecnf_0040r_007b_002c-definition-for_007d-484"></a>
+<a name="index-runtime-configuration-files-485"></a><a name="index-TEXMFCNF-486"></a>As mentioned above, Kpathsea reads <dfn>runtime configuration files</dfn>
named <samp><span class="file">texmf.cnf</span></samp> for search path and other definitions. The
search path used to look for these configuration files is named
<code>TEXMFCNF</code>, and is constructed in the usual way, as described
@@ -2624,7 +2610,7 @@ just the first one found; definitions in earlier files override those in
later files. Thus, if the search path is &lsquo;<samp><span class="samp">.:$TEXMF</span></samp>&rsquo;, values from
<samp><span class="file">./texmf.cnf</span></samp> override those from <samp><span class="file">$TEXMF/texmf.cnf</span></samp>.
- <p><a name="index-KPATHSEA_005fWARNING-490"></a><a name="index-warning_002c-about-missing-_0040file_007btexmf_002ecnf_007d-491"></a><a name="index-g_t_0040file_007btexmf_002ecnf_007d-missing_002c-warning-about-492"></a>If Kpathsea cannot find any <samp><span class="file">texmf.cnf</span></samp> file, it reports a
+ <p><a name="index-KPATHSEA_005fWARNING-487"></a><a name="index-warning_002c-about-missing-_0040file_007btexmf_002ecnf_007d-488"></a><a name="index-g_t_0040file_007btexmf_002ecnf_007d-missing_002c-warning-about-489"></a>If Kpathsea cannot find any <samp><span class="file">texmf.cnf</span></samp> file, it reports a
warning including all the directories it checked. If you don't want
to see this warning, set the environment variable
<samp><span class="env">KPATHSEA_WARNING</span></samp> to the single character &lsquo;<samp><span class="samp">0</span></samp>&rsquo; (zero, not
@@ -2635,11 +2621,11 @@ to look at the distributed <samp><span class="file">texmf.cnf</span></samp>, whi
mentions most features. The format of <samp><span class="file">texmf.cnf</span></samp> files follows:
<ul>
-<li><a name="index-comments_002c-in-_0040file_007btexmf_002ecnf_007d-493"></a>Comments start with &lsquo;<samp><span class="samp">%</span></samp>&rsquo; and continue to the end of the line.
+<li><a name="index-comments_002c-in-_0040file_007btexmf_002ecnf_007d-490"></a>Comments start with &lsquo;<samp><span class="samp">%</span></samp>&rsquo; and continue to the end of the line.
- <li><a name="index-blank-lines_002c-in-_0040file_007btexmf_002ecnf_007d-494"></a>Blank lines are ignored.
+ <li><a name="index-blank-lines_002c-in-_0040file_007btexmf_002ecnf_007d-491"></a>Blank lines are ignored.
- <li><a name="index-backslash_002dnewline-495"></a><a name="index-continuation-character-496"></a><a name="index-whitespace_002c-not-ignored-on-continuation-lines-497"></a><a name="index-g_t_005c_0040r_007b_002c-line-continuation-in-_0040file_007btexmf_002ecnf_007d_007d-498"></a>A &lsquo;<samp><span class="samp">\</span></samp>&rsquo; at the end of a line acts as a continuation character, i.e.,
+ <li><a name="index-backslash_002dnewline-492"></a><a name="index-continuation-character-493"></a><a name="index-whitespace_002c-not-ignored-on-continuation-lines-494"></a><a name="index-g_t_005c_0040r_007b_002c-line-continuation-in-_0040file_007btexmf_002ecnf_007d_007d-495"></a>A &lsquo;<samp><span class="samp">\</span></samp>&rsquo; at the end of a line acts as a continuation character, i.e.,
the next line is appended. Whitespace at the beginning of continuation
lines is not ignored.
@@ -2649,7 +2635,7 @@ lines is not ignored.
</pre>
<p class="noindent">where the &lsquo;<samp><span class="samp">=</span></samp>&rsquo; and surrounding whitespace is optional.
- <li><a name="index-identifiers_002c-characters-valid-in-499"></a>The <var>variable</var> name may contain any character other than whitespace,
+ <li><a name="index-identifiers_002c-characters-valid-in-496"></a>The <var>variable</var> name may contain any character other than whitespace,
&lsquo;<samp><span class="samp">=</span></samp>&rsquo;, or &lsquo;<samp><span class="samp">.</span></samp>&rsquo;, but sticking to &lsquo;<samp><span class="samp">A-Za-z_</span></samp>&rsquo; is safest.
<li>If &lsquo;<samp><span class="samp">.</span><var>progname</var></samp>&rsquo; is present, the definition only
@@ -2658,7 +2644,7 @@ component of <code>argv[0]</code> is) <var>progname</var> or
<samp><var>progname</var><span class="file">.exe</span></samp>. This allows different flavors of TeX to
have different search paths, for example.
- <li><a name="index-right_002dhand-side-of-variable-assignments-500"></a><var>value</var> may contain any characters except &lsquo;<samp><span class="samp">%</span></samp>&rsquo; and &lsquo;<samp><span class="samp">@</span></samp>&rsquo;.
+ <li><a name="index-right_002dhand-side-of-variable-assignments-497"></a><var>value</var> may contain any characters except &lsquo;<samp><span class="samp">%</span></samp>&rsquo; and &lsquo;<samp><span class="samp">@</span></samp>&rsquo;.
(These restrictions are only necessary because of the processing done on
<samp><span class="file">texmf.cnf</span></samp> at build time, so you can stick those characters in
after installation if you have to.) The &lsquo;<samp><span class="samp">$</span><var>var</var><span class="samp">.</span><var>prog</var></samp>&rsquo;
@@ -2684,7 +2670,7 @@ these points:
TEXINPUTS.latex2e = $latex2e_inputs
TEXINPUTS.latex = $latex2e_inputs
</pre>
- <p><a name="index-shell-scripts-as-configuration-files-501"></a><a name="index-configuration-files-as-shell-scripts_002e-502"></a>Although this format has obvious similarities to Bourne shell
+ <p><a name="index-shell-scripts-as-configuration-files-498"></a><a name="index-configuration-files-as-shell-scripts_002e-499"></a>Although this format has obvious similarities to Bourne shell
scripts&mdash;change the comment character to <code>#</code>, disallow spaces
around the <code>=</code>, and get rid of the <code>.</code><var>name</var> convention,
and it could be run through the shell. But there seemed little
@@ -2692,11 +2678,11 @@ advantage to doing this, since all the information would have to passed
back to Kpathsea and parsed there anyway, since the <code>sh</code> process
couldn't affect its parent's environment.
- <p><a name="index-cnf_002ec-503"></a>The implementation of all this is in <samp><span class="file">kpathsea/cnf.c</span></samp>.
+ <p><a name="index-cnf_002ec-500"></a>The implementation of all this is in <samp><span class="file">kpathsea/cnf.c</span></samp>.
<div class="node">
-<p><hr>
<a name="Path-expansion"></a>
+<p><hr>
Next:&nbsp;<a rel="next" accesskey="n" href="#Filename-database">Filename database</a>,
Previous:&nbsp;<a rel="previous" accesskey="p" href="#Path-sources">Path sources</a>,
Up:&nbsp;<a rel="up" accesskey="u" href="#Path-searching">Path searching</a>
@@ -2705,7 +2691,7 @@ Up:&nbsp;<a rel="up" accesskey="u" href="#Path-searching">Path searching</a>
<h3 class="section">3.3 Path expansion</h3>
-<p><a name="index-path-expansion-504"></a><a name="index-expansion_002c-search-path-505"></a>
+<p><a name="index-path-expansion-501"></a><a name="index-expansion_002c-search-path-502"></a>
Kpathsea recognizes certain special characters and constructions in
search paths, similar to that in shells. As a general example:
&lsquo;<samp><span class="samp">~$USER/{foo,bar}//baz</span></samp>&rsquo; expands to all subdirectories under
@@ -2723,8 +2709,8 @@ in the sections below.
</ul>
<div class="node">
-<p><hr>
<a name="Default-expansion"></a>
+<p><hr>
Next:&nbsp;<a rel="next" accesskey="n" href="#Variable-expansion">Variable expansion</a>,
Up:&nbsp;<a rel="up" accesskey="u" href="#Path-expansion">Path expansion</a>
@@ -2732,7 +2718,7 @@ Up:&nbsp;<a rel="up" accesskey="u" href="#Path-expansion">Path expansion</a>
<h4 class="subsection">3.3.1 Default expansion</h4>
-<p><a name="index-g_t_003a_003a-_0040r_007bexpansion_007d-506"></a><a name="index-doubled-colons-507"></a><a name="index-leading-colons-508"></a><a name="index-trailing-colons-509"></a><a name="index-extra-colons-510"></a><a name="index-default-expansion-511"></a><a name="index-expansion_002c-default-512"></a>
+<p><a name="index-g_t_003a_003a-_0040r_007bexpansion_007d-503"></a><a name="index-doubled-colons-504"></a><a name="index-leading-colons-505"></a><a name="index-trailing-colons-506"></a><a name="index-extra-colons-507"></a><a name="index-default-expansion-508"></a><a name="index-expansion_002c-default-509"></a>
If the highest-priority search path (see <a href="#Path-sources">Path sources</a>) contains an
<dfn>extra colon</dfn> (i.e., leading, trailing, or doubled), Kpathsea
inserts at that point the next-highest-priority search path that is
@@ -2769,20 +2755,20 @@ Or, with Dvips' configuration files, that an extra colon in
This doesn't happen. It's not clear this would be desirable in all
cases, and trying to devise a way to specify the path to which the extra
colon should expand seemed truly baroque.
-<a name="index-Bach_002c-Johann-Sebastian-513"></a>
+<a name="index-Bach_002c-Johann-Sebastian-510"></a>
Technicality: Since it would be useless to insert the default value in
more than one place, Kpathsea changes only one extra &lsquo;<samp><span class="samp">:</span></samp>&rsquo; and leaves
any others in place (they will eventually be ignored). Kpathsea checks
first for a leading &lsquo;<samp><span class="samp">:</span></samp>&rsquo;, then a trailing &lsquo;<samp><span class="samp">:</span></samp>&rsquo;, then a doubled
&lsquo;<samp><span class="samp">:</span></samp>&rsquo;.
- <p><a name="index-kdefault_002ec-514"></a>You can trace this by debugging &ldquo;paths&rdquo; (see <a href="#Debugging">Debugging</a>).
+ <p><a name="index-kdefault_002ec-511"></a>You can trace this by debugging &ldquo;paths&rdquo; (see <a href="#Debugging">Debugging</a>).
Default expansion is implemented in the source file
<samp><span class="file">kpathsea/kdefault.c</span></samp>.
<div class="node">
-<p><hr>
<a name="Variable-expansion"></a>
+<p><hr>
Next:&nbsp;<a rel="next" accesskey="n" href="#Tilde-expansion">Tilde expansion</a>,
Previous:&nbsp;<a rel="previous" accesskey="p" href="#Default-expansion">Default expansion</a>,
Up:&nbsp;<a rel="up" accesskey="u" href="#Path-expansion">Path expansion</a>
@@ -2791,7 +2777,7 @@ Up:&nbsp;<a rel="up" accesskey="u" href="#Path-expansion">Path expansion</a>
<h4 class="subsection">3.3.2 Variable expansion</h4>
-<p><a name="index-g_t_0024-_0040r_007bexpansion_007d-515"></a><a name="index-environment-variables-in-paths-516"></a><a name="index-variable-expansion-517"></a><a name="index-expansion_002c-variable-518"></a><a name="index-texmf_002ecnf_0040r_007b_002c-and-variable-expansion_007d-519"></a>
+<p><a name="index-g_t_0024-_0040r_007bexpansion_007d-512"></a><a name="index-environment-variables-in-paths-513"></a><a name="index-variable-expansion-514"></a><a name="index-expansion_002c-variable-515"></a><a name="index-texmf_002ecnf_0040r_007b_002c-and-variable-expansion_007d-516"></a>
&lsquo;<samp><span class="samp">$foo</span></samp>&rsquo; or &lsquo;<samp><span class="samp">${foo}</span></samp>&rsquo; in a path element is replaced by (1) the
value of an environment variable &lsquo;<samp><span class="samp">foo</span></samp>&rsquo; (if defined); (2) the value
of &lsquo;<samp><span class="samp">foo</span></samp>&rsquo; from <samp><span class="file">texmf.cnf</span></samp> (if defined); (3) the empty string.
@@ -2803,7 +2789,7 @@ of everything up to the next &lsquo;<samp><span class="samp">}</span></samp>&rsq
variable names). Otherwise, Kpathsea gives a warning and ignores the
&lsquo;<samp><span class="samp">$</span></samp>&rsquo; and its following character.
- <p><a name="index-quoting-variable-values-520"></a><a name="index-shell-variables-521"></a>You must quote the <tt>$</tt>'s and braces as necessary for your shell.
+ <p><a name="index-quoting-variable-values-517"></a><a name="index-shell-variables-518"></a>You must quote the <tt>$</tt>'s and braces as necessary for your shell.
<em>Shell</em> variable values cannot be seen by Kpathsea, i.e., ones
defined by <code>set</code> in C shells and without <code>export</code> in Bourne
shells.
@@ -2820,12 +2806,12 @@ shells.
for general variable expansions. These are only recognized when search
paths are initialized (see <a href="#Path-sources">Path sources</a>).
- <p><a name="index-variable_002ec-522"></a>Variable expansion is implemented in the source file
+ <p><a name="index-variable_002ec-519"></a>Variable expansion is implemented in the source file
<samp><span class="file">kpathsea/variable.c</span></samp>.
<div class="node">
-<p><hr>
<a name="Tilde-expansion"></a>
+<p><hr>
Next:&nbsp;<a rel="next" accesskey="n" href="#Brace-expansion">Brace expansion</a>,
Previous:&nbsp;<a rel="previous" accesskey="p" href="#Variable-expansion">Variable expansion</a>,
Up:&nbsp;<a rel="up" accesskey="u" href="#Path-expansion">Path expansion</a>
@@ -2834,8 +2820,8 @@ Up:&nbsp;<a rel="up" accesskey="u" href="#Path-expansion">Path expansion</a>
<h4 class="subsection">3.3.3 Tilde expansion</h4>
-<p><a name="index-g_t_007e-_0040r_007bexpansion_007d-523"></a><a name="index-home-directories-in-paths-524"></a><a name="index-tilde-expansion-525"></a><a name="index-expansion_002c-tilde-526"></a>
-<a name="index-HOME_0040r_007b_002c-as-_007e-expansion_007d-527"></a><a name="index-USERPROFILE_0040r_007b_002c-as-_007e-expansion_007d-528"></a>A leading &lsquo;<samp><span class="samp">~</span></samp>&rsquo; in a path element is replaced by the value of the
+<p><a name="index-g_t_007e-_0040r_007bexpansion_007d-520"></a><a name="index-home-directories-in-paths-521"></a><a name="index-tilde-expansion-522"></a><a name="index-expansion_002c-tilde-523"></a>
+<a name="index-HOME_0040r_007b_002c-as-_007e-expansion_007d-524"></a><a name="index-USERPROFILE_0040r_007b_002c-as-_007e-expansion_007d-525"></a>A leading &lsquo;<samp><span class="samp">~</span></samp>&rsquo; in a path element is replaced by the value of the
environment variable <code>HOME</code>, or <samp><span class="file">.</span></samp> if <code>HOME</code> is not
set. On Windows, the environment variable <code>USERPROFILE</code> is
checked instead of <code>HOME</code>.
@@ -2849,17 +2835,17 @@ checked instead of <code>HOME</code>.
<p class="noindent">will prepend a directory <samp><span class="file">mymacros</span></samp> in your home
directory to the default path.
- <p><a name="index-g_t_0040t_007broot_007d-user-529"></a><a name="index-trailing-_0040samp_007b_002f_007d-in-home-directory-530"></a><a name="index-g_t_002f_0040r_007b_002c-trailing-in-home-directory_007d-531"></a>As a special case, if a home directory ends in &lsquo;<samp><span class="samp">/</span></samp>&rsquo;, the trailing
+ <p><a name="index-g_t_0040t_007broot_007d-user-526"></a><a name="index-trailing-_0040samp_007b_002f_007d-in-home-directory-527"></a><a name="index-g_t_002f_0040r_007b_002c-trailing-in-home-directory_007d-528"></a>As a special case, if a home directory ends in &lsquo;<samp><span class="samp">/</span></samp>&rsquo;, the trailing
slash is dropped, to avoid inadvertently creating a &lsquo;<samp><span class="samp">//</span></samp>&rsquo; construct
in the path. For example, if the home directory of the user &lsquo;<samp><span class="samp">root</span></samp>&rsquo;
is &lsquo;<samp><span class="samp">/</span></samp>&rsquo;, the path element &lsquo;<samp><span class="samp">~root/mymacros</span></samp>&rsquo; expands to just
&lsquo;<samp><span class="samp">/mymacros</span></samp>&rsquo;, not &lsquo;<samp><span class="samp">//mymacros</span></samp>&rsquo;.
- <p><a name="index-tilde_002ec-532"></a>Tilde expansion is implemented in the source file <samp><span class="file">kpathsea/tilde.c</span></samp>.
+ <p><a name="index-tilde_002ec-529"></a>Tilde expansion is implemented in the source file <samp><span class="file">kpathsea/tilde.c</span></samp>.
<div class="node">
-<p><hr>
<a name="Brace-expansion"></a>
+<p><hr>
Next:&nbsp;<a rel="next" accesskey="n" href="#KPSE_005fDOT-expansion">KPSE_DOT expansion</a>,
Previous:&nbsp;<a rel="previous" accesskey="p" href="#Tilde-expansion">Tilde expansion</a>,
Up:&nbsp;<a rel="up" accesskey="u" href="#Path-expansion">Path expansion</a>
@@ -2868,7 +2854,7 @@ Up:&nbsp;<a rel="up" accesskey="u" href="#Path-expansion">Path expansion</a>
<h4 class="subsection">3.3.4 Brace expansion</h4>
-<p><a name="index-g_t_0040_007b-_0040r_007bexpansion_007d-533"></a><a name="index-brace-expansion-534"></a>
+<p><a name="index-g_t_0040_007b-_0040r_007bexpansion_007d-530"></a><a name="index-brace-expansion-531"></a>
&lsquo;<samp><span class="samp">x{</span><var>a</var><span class="samp">,</span><var>b</var><span class="samp">}y</span></samp>&rsquo; expands to &lsquo;<samp><span class="samp">x</span><var>a</var><span class="samp">y:x</span><var>b</var><span class="samp">y</span></samp>&rsquo;.
For example:
@@ -2884,22 +2870,22 @@ separator on the current system; e.g., on a DOS system, it's &lsquo;<samp><span
&lsquo;<samp><span class="samp">x{A,B}{1,2}y</span></samp>&rsquo; expands to &lsquo;<samp><span class="samp">x{A,B}1y:x{A,B}2y</span></samp>&rsquo;, which
expands to &lsquo;<samp><span class="samp">xA1y:xB1y:xA2y:xB2y</span></samp>&rsquo;.
- <p><a name="index-multiple-_0040TeX_007b_007d-hierarchies-535"></a>This feature can be used to implement multiple TeX hierarchies, by
+ <p><a name="index-multiple-_0040TeX_007b_007d-hierarchies-532"></a>This feature can be used to implement multiple TeX hierarchies, by
assigning a brace list to <code>$TEXMF</code>, as mentioned in
<samp><span class="file">texmf.in</span></samp>.
<p>You can also use the path separator in stead of the comma. The last
example could have been written &lsquo;<samp><span class="samp">x{A:B}{1:2}y</span></samp>&rsquo;.
- <p><a name="index-expand_002ec-536"></a>Brace expansion is implemented in the source file
+ <p><a name="index-expand_002ec-533"></a>Brace expansion is implemented in the source file
<samp><span class="file">kpathsea/expand.c</span></samp>. It is a modification of the Bash sources, and
is thus covered by the GNU General Public License, rather than the
Library General Public License that covers the rest of Kpathsea.
<div class="node">
-<p><hr>
<a name="KPSE_DOT-expansion"></a>
<a name="KPSE_005fDOT-expansion"></a>
+<p><hr>
Next:&nbsp;<a rel="next" accesskey="n" href="#Subdirectory-expansion">Subdirectory expansion</a>,
Previous:&nbsp;<a rel="previous" accesskey="p" href="#Brace-expansion">Brace expansion</a>,
Up:&nbsp;<a rel="up" accesskey="u" href="#Path-expansion">Path expansion</a>
@@ -2908,7 +2894,7 @@ Up:&nbsp;<a rel="up" accesskey="u" href="#Path-expansion">Path expansion</a>
<h4 class="subsection">3.3.5 <code>KPSE_DOT</code> expansion</h4>
-<p><a name="index-KPSE_005fDOT-_0040r_007bexpansion_007d-537"></a>
+<p><a name="index-KPSE_005fDOT-_0040r_007bexpansion_007d-534"></a>
When <code>KPSE_DOT</code> is defined in the environment, it names a directory
that should be considered the current directory for the purpose of
looking up files in the search paths. This feature is needed by the
@@ -2916,8 +2902,8 @@ looking up files in the search paths. This feature is needed by the
change the working directory. You should not ever define it yourself.
<div class="node">
-<p><hr>
<a name="Subdirectory-expansion"></a>
+<p><hr>
Previous:&nbsp;<a rel="previous" accesskey="p" href="#KPSE_005fDOT-expansion">KPSE_DOT expansion</a>,
Up:&nbsp;<a rel="up" accesskey="u" href="#Path-expansion">Path expansion</a>
@@ -2925,8 +2911,8 @@ Up:&nbsp;<a rel="up" accesskey="u" href="#Path-expansion">Path expansion</a>
<h4 class="subsection">3.3.6 Subdirectory expansion</h4>
-<p><a name="index-g_t_002f_002f-538"></a><a name="index-subdirectory-searching-539"></a><a name="index-expansion_002c-subdirectory-540"></a>
-<a name="index-alphabetical-order_002c-not-541"></a>Two or more consecutive slashes in a path element following a directory
+<p><a name="index-g_t_002f_002f-535"></a><a name="index-subdirectory-searching-536"></a><a name="index-expansion_002c-subdirectory-537"></a>
+<a name="index-alphabetical-order_002c-not-538"></a>Two or more consecutive slashes in a path element following a directory
<var>d</var> is replaced by all subdirectories of <var>d</var>: first those
subdirectories directly under <var>d</var>, then the subsubdirectories under
those, and so on. At each level, the order in which the directories are
@@ -2943,10 +2929,10 @@ subdirectories which match those components are included. For example,
<p>&lsquo;<samp><span class="samp">//</span></samp>&rsquo; at the beginning of a path is ignored; you didn't really want
to search every directory on the system, did you?
- <p><a name="index-trick-for-detecting-leaf-directories-542"></a><a name="index-leaf-directory-trick-543"></a><a name="index-Farwell_002c-Matthew-544"></a><a name="index-MacKenzie_002c-David-545"></a>I should mention one related implementation trick, which I took from GNU
+ <p><a name="index-trick-for-detecting-leaf-directories-539"></a><a name="index-leaf-directory-trick-540"></a><a name="index-Farwell_002c-Matthew-541"></a><a name="index-MacKenzie_002c-David-542"></a>I should mention one related implementation trick, which I took from GNU
find. Matthew Farwell suggested it, and David MacKenzie implemented it.
- <p><a name="index-st_005fnlink-546"></a>The trick is that in every real Unix implementation (as opposed to the
+ <p><a name="index-st_005fnlink-543"></a>The trick is that in every real Unix implementation (as opposed to the
POSIX specification), a directory which contains no subdirectories will
have exactly two links (namely, one for <samp><span class="file">.</span></samp> and one for <samp><span class="file">..</span></samp>).
That is to say, the <code>st_nlink</code> field in the &lsquo;<samp><span class="samp">stat</span></samp>&rsquo; structure
@@ -2958,10 +2944,10 @@ and do no more work.
regular files, <code>st_nlink</code> will be 3, and Kpathsea has to stat every
one of those 501 entries. Therein lies slowness.
- <p><a name="index-UNIX_005fST_005fLINK-547"></a>You can disable the trick by undefining <code>UNIX_ST_LINK</code> in
+ <p><a name="index-ST_005fNLINK_005fTRICK-544"></a>You can disable the trick by undefining <code>ST_NLINK_TRICK</code> in
<samp><span class="file">kpathsea/config.h</span></samp>. (It is undefined by default except under Unix.)
- <p><a name="index-elt_002ddirs_002ec-548"></a>Unfortunately, in some cases files in leaf directories are
+ <p><a name="index-elt_002ddirs_002ec-545"></a>Unfortunately, in some cases files in leaf directories are
<code>stat</code>'d: if the path specification is, say,
&lsquo;<samp><span class="samp">$TEXMF/fonts//pk//</span></samp>&rsquo;, then files in a subdirectory
&lsquo;<samp><span class="samp">.../pk</span></samp>&rsquo;, even if it is a leaf, are checked. The reason cannot
@@ -2970,12 +2956,12 @@ be explained without reference to the implementation, so read
curious. And if you can find a way to <em>solve</em> the problem, please
let me know.
- <p><a name="index-elt_002ddirs_002ec-549"></a>Subdirectory expansion is implemented in the source file
+ <p><a name="index-elt_002ddirs_002ec-546"></a>Subdirectory expansion is implemented in the source file
<samp><span class="file">kpathsea/elt-dirs.c</span></samp>.
<div class="node">
-<p><hr>
<a name="Filename-database"></a>
+<p><hr>
Next:&nbsp;<a rel="next" accesskey="n" href="#Invoking-kpsewhich">Invoking kpsewhich</a>,
Previous:&nbsp;<a rel="previous" accesskey="p" href="#Path-expansion">Path expansion</a>,
Up:&nbsp;<a rel="up" accesskey="u" href="#Path-searching">Path searching</a>
@@ -2984,7 +2970,7 @@ Up:&nbsp;<a rel="up" accesskey="u" href="#Path-searching">Path searching</a>
<h3 class="section">3.4 Filename database (<code>ls-R</code>)</h3>
-<p><a name="index-filename-database-550"></a><a name="index-database_002c-for-filenames-551"></a><a name="index-externally_002dbuilt-filename-database-552"></a>
+<p><a name="index-filename-database-547"></a><a name="index-database_002c-for-filenames-548"></a><a name="index-externally_002dbuilt-filename-database-549"></a>
Kpathsea goes to some lengths to minimize disk accesses for searches
(see <a href="#Subdirectory-expansion">Subdirectory expansion</a>). Nevertheless, in practice searching
each possible directory in typical TeX installations takes an
@@ -3008,9 +2994,9 @@ source file <samp><span class="file">kpathsea/db.c</span></samp>.
</ul>
<div class="node">
-<p><hr>
<a name="ls-R"></a>
<a name="ls_002dR"></a>
+<p><hr>
Next:&nbsp;<a rel="next" accesskey="n" href="#Filename-aliases">Filename aliases</a>,
Up:&nbsp;<a rel="up" accesskey="u" href="#Filename-database">Filename database</a>
@@ -3018,7 +3004,7 @@ Up:&nbsp;<a rel="up" accesskey="u" href="#Filename-database">Filename database</
<h4 class="subsection">3.4.1 <samp><span class="file">ls-R</span></samp></h4>
-<p><a name="index-ls_002dR-_0040r_007bdatabase-file_007d-553"></a><a name="index-TEXMFDBS-554"></a>
+<p><a name="index-ls_002dR-_0040r_007bdatabase-file_007d-550"></a><a name="index-TEXMFDBS-551"></a>
As mentioned above, you must name the main filename database
<samp><span class="file">ls-R</span></samp>. You can put one at the root of each TeX installation
hierarchy you wish to search (<code>$TEXMF</code> by default); most sites have
@@ -3032,10 +3018,10 @@ hierarchies.
follow symbolic links as necessary, etc. It's also invoked by the
distributed &lsquo;<samp><span class="samp">mktex...</span></samp>&rsquo; scripts.
- <p><a name="index-ls_002dR_0040r_007b_002c-simplest-build_007d-555"></a>At its simplest, though, you can build <samp><span class="file">ls-R</span></samp> with the command
+ <p><a name="index-ls_002dR_0040r_007b_002c-simplest-build_007d-552"></a>At its simplest, though, you can build <samp><span class="file">ls-R</span></samp> with the command
<pre class="example"> cd <var>/your/texmf/root</var> &amp;&amp; ls -LAR ./ &gt;ls-R
</pre>
- <p class="noindent"><a name="index-g_t_002d_002dcolor_003dtty-556"></a><a name="index-g_t_002fetc_002fprofile-_0040r_007band-aliases_007d-557"></a>presuming your <code>ls</code> produces the right output format (see the
+ <p class="noindent"><a name="index-g_t_002d_002dcolor_003dtty-553"></a><a name="index-g_t_002fetc_002fprofile-_0040r_007band-aliases_007d-554"></a>presuming your <code>ls</code> produces the right output format (see the
section below). GNU <code>ls</code>, for example, outputs in this format.
Also presuming your <code>ls</code> hasn't been aliased in a system file
(e.g., <samp><span class="file">/etc/profile</span></samp>) to something problematic, e.g., &lsquo;<samp><span class="samp">ls
@@ -3048,26 +3034,26 @@ almost certainly want to invoke it via <code>cron</code>, so when you make
changes in the installed files (say if you install a new LaTeX
package), <samp><span class="file">ls-R</span></samp> will be automatically updated.
- <p><a name="index-g_t_002dA-_0040r_007boption-to-_0040code_007bls_007d_007d-558"></a><a name="index-dot-files-559"></a><a name="index-g_t_002e-_0040r_007bfiles_007d-560"></a><a name="index-g_t_002e-_0040r_007bdirectories_002c-ignored_007d-561"></a><a name="index-g_t_002etex-_0040r_007bfile_002c-included-in-_0040file_007bls_002dR_007d_007d-562"></a>The &lsquo;<samp><span class="samp">-A</span></samp>&rsquo; option to <code>ls</code> includes files beginning with &lsquo;<samp><span class="samp">.</span></samp>&rsquo;
+ <p><a name="index-g_t_002dA-_0040r_007boption-to-_0040code_007bls_007d_007d-555"></a><a name="index-dot-files-556"></a><a name="index-g_t_002e-_0040r_007bfiles_007d-557"></a><a name="index-g_t_002e-_0040r_007bdirectories_002c-ignored_007d-558"></a><a name="index-g_t_002etex-_0040r_007bfile_002c-included-in-_0040file_007bls_002dR_007d_007d-559"></a>The &lsquo;<samp><span class="samp">-A</span></samp>&rsquo; option to <code>ls</code> includes files beginning with &lsquo;<samp><span class="samp">.</span></samp>&rsquo;
(except for <samp><span class="file">.</span></samp> and <samp><span class="file">..</span></samp>), such as the file <samp><span class="file">.tex</span></samp>
included with the LaTeX tools package. (On the other hand,
<em>directories</em> whose names begin with &lsquo;<samp><span class="samp">.</span></samp>&rsquo; are always ignored.)
- <p><a name="index-symbolic-links_002c-and-_0040file_007bls_002dR_007d-563"></a><a name="index-g_t_002dL-_0040r_007boption-to-_0040code_007bls_007d_007d-564"></a>If your system does not support symbolic links, omit the &lsquo;<samp><span class="samp">-L</span></samp>&rsquo;.
+ <p><a name="index-symbolic-links_002c-and-_0040file_007bls_002dR_007d-560"></a><a name="index-g_t_002dL-_0040r_007boption-to-_0040code_007bls_007d_007d-561"></a>If your system does not support symbolic links, omit the &lsquo;<samp><span class="samp">-L</span></samp>&rsquo;.
- <p><a name="index-automounter_002c-and-_0040file_007bls_002dR_007d-565"></a><a name="index-NFS-and-_0040file_007bls_002dR_007d-566"></a><code>ls -LAR </code><var>/your/texmf/root</var> will also work. But using
+ <p><a name="index-automounter_002c-and-_0040file_007bls_002dR_007d-562"></a><a name="index-NFS-and-_0040file_007bls_002dR_007d-563"></a><code>ls -LAR </code><var>/your/texmf/root</var> will also work. But using
&lsquo;<samp><span class="samp">./</span></samp>&rsquo; avoids embedding absolute pathnames, so the hierarchy can be
easily transported. It also avoids possible trouble with automounters
or other network filesystem conventions.
- <p><a name="index-warning-about-unusable-_0040file_007bls_002dR_007d-567"></a><a name="index-unusable-_0040file_007bls_002dR_007d-warning-568"></a>Kpathsea warns you if it finds an <samp><span class="file">ls-R</span></samp> file, but the file does
+ <p><a name="index-warning-about-unusable-_0040file_007bls_002dR_007d-564"></a><a name="index-unusable-_0040file_007bls_002dR_007d-warning-565"></a>Kpathsea warns you if it finds an <samp><span class="file">ls-R</span></samp> file, but the file does
not contain any usable entries. The usual culprit is running plain
&lsquo;<samp><span class="samp">ls -R</span></samp>&rsquo; instead of &lsquo;<samp><span class="samp">ls -LR ./</span></samp>&rsquo; or &lsquo;<samp><span class="samp">ls -R
</span><var>/your/texmf/root</var></samp>&rsquo;. Another possibility is some system directory
name starting with a &lsquo;<samp><span class="samp">.</span></samp>&rsquo; (perhaps if you are using AFS); Kpathsea
ignores everything under such directories.
- <p><a name="index-g_t_0021_0021-_0040r_007bin-path-specifications_007d-569"></a><a name="index-disk-searching_002c-avoiding-570"></a>Because the database may be out-of-date for a particular run, if a file
+ <p><a name="index-g_t_0021_0021-_0040r_007bin-path-specifications_007d-566"></a><a name="index-disk-searching_002c-avoiding-567"></a>Because the database may be out-of-date for a particular run, if a file
is not found in the database, by default Kpathsea goes ahead and
searches the disk. If a particular path element begins with &lsquo;<samp><span class="samp">!!</span></samp>&rsquo;,
however, <em>only</em> the database will be searched for that element,
@@ -3077,8 +3063,8 @@ searched. Because this can surprise users (&ldquo;I see the font
is not in any of the default search paths.
<div class="node">
-<p><hr>
<a name="Filename-aliases"></a>
+<p><hr>
Next:&nbsp;<a rel="next" accesskey="n" href="#Database-format">Database format</a>,
Previous:&nbsp;<a rel="previous" accesskey="p" href="#ls_002dR">ls-R</a>,
Up:&nbsp;<a rel="up" accesskey="u" href="#Filename-database">Filename database</a>
@@ -3087,7 +3073,7 @@ Up:&nbsp;<a rel="up" accesskey="u" href="#Filename-database">Filename database</
<h4 class="subsection">3.4.2 Filename aliases</h4>
-<p><a name="index-filename-aliases-571"></a><a name="index-aliases_002c-for-filenames-572"></a>
+<p><a name="index-filename-aliases-568"></a><a name="index-aliases_002c-for-filenames-569"></a>
In some circumstances, you may wish to find a file under several names.
For example, suppose a TeX document was created using a DOS system
and tries to read <samp><span class="file">longtabl.sty</span></samp>. But now it's being run on a Unix
@@ -3116,8 +3102,8 @@ ignored in <samp><span class="file">aliases</span></samp>, to allow for comments
aliases.
<div class="node">
-<p><hr>
<a name="Database-format"></a>
+<p><hr>
Previous:&nbsp;<a rel="previous" accesskey="p" href="#Filename-aliases">Filename aliases</a>,
Up:&nbsp;<a rel="up" accesskey="u" href="#Filename-database">Filename database</a>
@@ -3125,7 +3111,7 @@ Up:&nbsp;<a rel="up" accesskey="u" href="#Filename-database">Filename database</
<h4 class="subsection">3.4.3 Database format</h4>
-<p><a name="index-format-of-external-database-573"></a><a name="index-database_002c-format-of-574"></a>
+<p><a name="index-format-of-external-database-570"></a><a name="index-database_002c-format-of-571"></a>
The &ldquo;database&rdquo; read by Kpathsea is a line-oriented file of plain
text. The format is that generated by GNU (and most other) <code>ls</code>
programs given the &lsquo;<samp><span class="samp">-R</span></samp>&rsquo; option, as follows.
@@ -3166,8 +3152,8 @@ about 30K bytes) on my system:
...
</pre>
<div class="node">
-<p><hr>
<a name="Invoking-kpsewhich"></a>
+<p><hr>
Previous:&nbsp;<a rel="previous" accesskey="p" href="#Filename-database">Filename database</a>,
Up:&nbsp;<a rel="up" accesskey="u" href="#Path-searching">Path searching</a>
@@ -3175,7 +3161,7 @@ Up:&nbsp;<a rel="up" accesskey="u" href="#Path-searching">Path searching</a>
<h3 class="section">3.5 <code>kpsewhich</code>: Standalone path searching</h3>
-<p><a name="index-kpsewhich-575"></a><a name="index-path-searching_002c-standalone-576"></a><a name="index-standalone-path-searching-577"></a>
+<p><a name="index-kpsewhich-572"></a><a name="index-path-searching_002c-standalone-573"></a><a name="index-standalone-path-searching-574"></a>
The Kpsewhich program exercises the path searching functionality
independent of any particular application. This can also be useful as a
sort of <code>find</code> program to locate files in your TeX hierarchies,
@@ -3197,8 +3183,8 @@ abbreviation is accepted.
</ul>
<div class="node">
-<p><hr>
<a name="Path-searching-options"></a>
+<p><hr>
Next:&nbsp;<a rel="next" accesskey="n" href="#Specially_002drecognized-files">Specially-recognized files</a>,
Up:&nbsp;<a rel="up" accesskey="u" href="#Invoking-kpsewhich">Invoking kpsewhich</a>
@@ -3206,21 +3192,21 @@ Up:&nbsp;<a rel="up" accesskey="u" href="#Invoking-kpsewhich">Invoking kpsewhich
<h4 class="subsection">3.5.1 Path searching options</h4>
-<p><a name="index-path-searching-options-578"></a>
+<p><a name="index-path-searching-options-575"></a>
Kpsewhich looks up each non-option argument on the command line as a
filename, and returns the first file found.
<p>Various options alter the path searching behavior:
<dl>
-<dt>&lsquo;<samp><span class="samp">--all</span></samp>&rsquo;<dd><a name="index-g_t_002d_002dall-579"></a><a name="index-all-matches_002c-finding-580"></a>Report all matches found, one per line. By default, if there is more
+<dt>&lsquo;<samp><span class="samp">--all</span></samp>&rsquo;<dd><a name="index-g_t_002d_002dall-576"></a><a name="index-all-matches_002c-finding-577"></a>Report all matches found, one per line. By default, if there is more
than one match, just one will be reported (chosen effectively at random).
- <br><dt>&lsquo;<samp><span class="samp">--dpi=</span><var>num</var></samp>&rsquo;<dd><a name="index-g_t_002d_002ddpi_003d_0040var_007bnum_007d-581"></a><a name="index-g_t_002dD-_0040var_007bnum_007d-582"></a><a name="index-resolution_002c-setting-583"></a>Set the resolution to <var>num</var>; this only affects &lsquo;<samp><span class="samp">gf</span></samp>&rsquo; and
+ <br><dt>&lsquo;<samp><span class="samp">--dpi=</span><var>num</var></samp>&rsquo;<dd><a name="index-g_t_002d_002ddpi_003d_0040var_007bnum_007d-578"></a><a name="index-g_t_002dD-_0040var_007bnum_007d-579"></a><a name="index-resolution_002c-setting-580"></a>Set the resolution to <var>num</var>; this only affects &lsquo;<samp><span class="samp">gf</span></samp>&rsquo; and
&lsquo;<samp><span class="samp">pk</span></samp>&rsquo; lookups. &lsquo;<samp><span class="samp">-D</span></samp>&rsquo; is a synonym, for compatibility with
Dvips. Default is 600.
- <br><dt>&lsquo;<samp><span class="samp">--engine=</span><var>name</var></samp>&rsquo;<dd><a name="index-g_t_002d_002dengine_003d_0040var_007bname_007d-584"></a><a name="index-engine-name-585"></a>Set the engine name to <var>name</var>. By default it is not set. The
+ <br><dt>&lsquo;<samp><span class="samp">--engine=</span><var>name</var></samp>&rsquo;<dd><a name="index-g_t_002d_002dengine_003d_0040var_007bname_007d-581"></a><a name="index-engine-name-582"></a>Set the engine name to <var>name</var>. By default it is not set. The
engine name is used in some search paths to allow files with the same
name but used by different engines to coexist.
@@ -3236,7 +3222,7 @@ indeterminate which one is returned. (The &lsquo;<samp><span class="samp">/</sp
a normal recursive search along the path where the dumps are stored,
namely &lsquo;<samp><span class="samp">$TEXMF/web2c{/$engine,}</span></samp>&rsquo;.)
- <br><dt>&lsquo;<samp><span class="samp">--format=</span><var>name</var></samp>&rsquo;<dd><a name="index-g_t_002d_002dformat_003d_0040var_007bname_007d-586"></a>Set the format for lookup to <var>name</var>. By default, the format is
+ <br><dt>&lsquo;<samp><span class="samp">--format=</span><var>name</var></samp>&rsquo;<dd><a name="index-g_t_002d_002dformat_003d_0040var_007bname_007d-583"></a>Set the format for lookup to <var>name</var>. By default, the format is
guessed from the filename, with &lsquo;<samp><span class="samp">tex</span></samp>&rsquo; being used if nothing else
fits. The recognized filename extensions (including any leading
&lsquo;<samp><span class="samp">.</span></samp>&rsquo;) are also allowable <var>name</var>s.
@@ -3248,15 +3234,17 @@ sake of the shell.)
<p>Here's the current list of recognized names and the associated suffixes.
See <a href="#Supported-file-formats">Supported file formats</a>, for more information on each of these.
+
<pre class="example"> gf: gf
pk: pk
- bitmap font
+ bitmap font:
+ tfm: .tfm
afm: .afm
base: .base
bib: .bib
bst: .bst
cnf: .cnf
- ls-R: ls-R
+ ls-R: ls-R ls-r
fmt: .fmt
map: .map
mem: .mem
@@ -3265,70 +3253,72 @@ See <a href="#Supported-file-formats">Supported file formats</a>, for more infor
mft: .mft
mp: .mp
mppool: .pool
- MetaPost support
+ MetaPost support:
ocp: .ocp
ofm: .ofm .tfm
opl: .opl
otp: .otp
ovf: .ovf
ovp: .ovp
- graphic/figure: .eps .epsi
- tex: .tex
- TeX system documentation
+ graphic/figure: .eps .epsi
+ tex: .tex .sty .cls .fd .aux .bbl .def .clo .ldf
+ TeX system documentation:
texpool: .pool
- TeX system sources
- PostScript header/font: .pro
- Troff fonts
- tfm: .tfm
+ TeX system sources: .dtx .ins
+ PostScript header: .pro
+ Troff fonts:
type1 fonts: .pfa .pfb
vf: .vf
- dvips config
+ dvips config:
ist: .ist
- truetype fonts: .ttf .ttc
- type42 fonts
- web2c files
- other text files
- other binary files
- misc fonts
- web: .web
- cweb: .w .web
- enc: .enc
- cmap: .cmap
- sfd: .sfd
- opentype fonts
- pdftex config
+ truetype fonts: .ttf .ttc .TTF .TTC
+ type42 fonts: .t42 .T42
+ web2c files:
+ other text files:
+ other binary files:
+ misc fonts:
+ web: .web .ch
+ cweb: .w .web .ch
+ enc files: .enc
+ cmap files:
+ subfont definition files: .sfd
+ opentype fonts: .otf
+ pdftex config:
lig files: .lig
- texmfscripts
+ texmfscripts:
+ lua: .luc .luctex .texluc .lua .luatex .texlua
+ font feature files: .fea
+ cid maps: .cid .cidmap
</pre>
<p>This option and &lsquo;<samp><span class="samp">--path</span></samp>&rsquo; are mutually exclusive.
- <br><dt>&lsquo;<samp><span class="samp">--interactive</span></samp>&rsquo;<dd><a name="index-g_t_002d_002dinteractive-587"></a><a name="index-interactive-query-588"></a>After processing the command line, read additional filenames to look up
+ <br><dt>&lsquo;<samp><span class="samp">--interactive</span></samp>&rsquo;<dd><a name="index-g_t_002d_002dinteractive-584"></a><a name="index-interactive-query-585"></a>After processing the command line, read additional filenames to look up
from standard input.
- <br><dt>&lsquo;<samp><span class="samp">-mktex=</span><var>filetype</var></samp>&rsquo;<dt>&lsquo;<samp><span class="samp">-no-mktex=</span><var>filetype</var></samp>&rsquo;<dd><a name="index-g_t_002dmktex_003d_0040var_007bfiletype_007d-589"></a><a name="index-g_t_002dno_002dmktex_003d_0040var_007bfiletype_007d-590"></a>Turn on or off the &lsquo;<samp><span class="samp">mktex</span></samp>&rsquo; script associated with <var>filetype</var>.
+ <br><dt>&lsquo;<samp><span class="samp">-mktex=</span><var>filetype</var></samp>&rsquo;<dt>&lsquo;<samp><span class="samp">-no-mktex=</span><var>filetype</var></samp>&rsquo;<dd><a name="index-g_t_002dmktex_003d_0040var_007bfiletype_007d-586"></a><a name="index-g_t_002dno_002dmktex_003d_0040var_007bfiletype_007d-587"></a>Turn on or off the &lsquo;<samp><span class="samp">mktex</span></samp>&rsquo; script associated with <var>filetype</var>.
The only values that make sense for <var>filetype</var> are &lsquo;<samp><span class="samp">pk</span></samp>&rsquo;,
&lsquo;<samp><span class="samp">mf</span></samp>&rsquo;, &lsquo;<samp><span class="samp">tex</span></samp>&rsquo;, and &lsquo;<samp><span class="samp">tfm</span></samp>&rsquo;. By default, all are off in
Kpsewhich. See <a href="#mktex-scripts">mktex scripts</a>.
- <br><dt>&lsquo;<samp><span class="samp">--mode=</span><var>string</var></samp>&rsquo;<dd><a name="index-g_t_002d_002dmode_003d_0040var_007bstring_007d-591"></a>Set the mode name to <var>string</var>; this also only affects &lsquo;<samp><span class="samp">gf</span></samp>&rsquo; and
+ <br><dt>&lsquo;<samp><span class="samp">--mode=</span><var>string</var></samp>&rsquo;<dd><a name="index-g_t_002d_002dmode_003d_0040var_007bstring_007d-588"></a>Set the mode name to <var>string</var>; this also only affects &lsquo;<samp><span class="samp">gf</span></samp>&rsquo; and
&lsquo;<samp><span class="samp">pk</span></samp>&rsquo; lookups. No default: any mode will be found. See <a href="#mktex-script-arguments">mktex script arguments</a>.
- <br><dt>&lsquo;<samp><span class="samp">--must-exist</span></samp>&rsquo;<dd><a name="index-g_t_002d_002dmust_002dexist-592"></a>Do everything possible to find the files, notably including searching
+ <br><dt>&lsquo;<samp><span class="samp">--must-exist</span></samp>&rsquo;<dd><a name="index-g_t_002d_002dmust_002dexist-589"></a>Do everything possible to find the files, notably including searching
the disk. By default, only the <samp><span class="file">ls-R</span></samp> database is checked, in the
interest of efficiency.
- <br><dt>&lsquo;<samp><span class="samp">--path=</span><var>string</var></samp>&rsquo;<dd><a name="index-g_t_002d_002dpath_003d_0040var_007bstring_007d-593"></a>Search along the path <var>string</var> (colon-separated as usual), instead
+ <br><dt>&lsquo;<samp><span class="samp">--path=</span><var>string</var></samp>&rsquo;<dd><a name="index-g_t_002d_002dpath_003d_0040var_007bstring_007d-590"></a>Search along the path <var>string</var> (colon-separated as usual), instead
of guessing the search path from the filename. &lsquo;<samp><span class="samp">//</span></samp>&rsquo; and all the
usual expansions are supported (see <a href="#Path-expansion">Path expansion</a>). This option
and &lsquo;<samp><span class="samp">--format</span></samp>&rsquo; are mutually exclusive. To output the complete
directory expansion of a path, instead of doing a one-shot lookup, see
&lsquo;<samp><span class="samp">--expand-path</span></samp>&rsquo; and &lsquo;<samp><span class="samp">--show-path</span></samp>&rsquo; in the following section.
- <br><dt>&lsquo;<samp><span class="samp">--progname=</span><var>name</var></samp>&rsquo;<dd><a name="index-g_t_002d_002dprogname_003d_0040var_007bname_007d-594"></a>Set the program name to <var>name</var>; default is &lsquo;<samp><span class="samp">kpsewhich</span></samp>&rsquo;. This
+ <br><dt>&lsquo;<samp><span class="samp">--progname=</span><var>name</var></samp>&rsquo;<dd><a name="index-g_t_002d_002dprogname_003d_0040var_007bname_007d-591"></a>Set the program name to <var>name</var>; default is &lsquo;<samp><span class="samp">kpsewhich</span></samp>&rsquo;. This
can affect the search paths via the &lsquo;<samp><span class="samp">.</span><var>prognam</var></samp>&rsquo; feature in
configuration files (see <a href="#Config-files">Config files</a>).
- <br><dt>&lsquo;<samp><span class="samp">--subdir=</span><var>string</var></samp>&rsquo;<dd><a name="index-g_t_002d_002dsubdir_003d_0040var_007bstring_007d-595"></a>Report only those matches whose directory part <em>ends</em> with
+ <br><dt>&lsquo;<samp><span class="samp">--subdir=</span><var>string</var></samp>&rsquo;<dd><a name="index-g_t_002d_002dsubdir_003d_0040var_007bstring_007d-592"></a>Report only those matches whose directory part <em>ends</em> with
<var>string</var> (compared literally, except case is ignored on a
case-insensitive operating system). For example, suppose there are
two matches for a given name:
@@ -3392,9 +3382,9 @@ in <samp><span class="file">/some/coincidental/pkg1/path/</span></samp>, and we
</dl>
<div class="node">
-<p><hr>
<a name="Specially-recognized-files"></a>
<a name="Specially_002drecognized-files"></a>
+<p><hr>
Next:&nbsp;<a rel="next" accesskey="n" href="#Auxiliary-tasks">Auxiliary tasks</a>,
Previous:&nbsp;<a rel="previous" accesskey="p" href="#Path-searching-options">Path searching options</a>,
Up:&nbsp;<a rel="up" accesskey="u" href="#Invoking-kpsewhich">Invoking kpsewhich</a>
@@ -3414,35 +3404,37 @@ up to the caller to specify the desired format.
with their corresponding format:
-<a name="index-config_002eps-596"></a>
+<a name="index-config_002eps-593"></a>
<dl><dt><samp><span class="file">config.ps</span></samp><dd><code>dvips config</code>
- <p><a name="index-dvipdfmx_002ecfg-597"></a><br><dt><samp><span class="file">dvipdfmx.cfg</span></samp><dd>&lsquo;<samp><span class="samp">other text files</span></samp>&rsquo;
+ <p><a name="index-dvipdfmx_002ecfg-594"></a><br><dt><samp><span class="file">dvipdfmx.cfg</span></samp><dd>&lsquo;<samp><span class="samp">other text files</span></samp>&rsquo;
- <p><a name="index-fmtutil_002ecnf-598"></a><br><dt><samp><span class="file">fmtutil.cnf</span></samp><dd>&lsquo;<samp><span class="samp">web2c files</span></samp>&rsquo;
+ <p><a name="index-fmtutil_002ecnf-595"></a><br><dt><samp><span class="file">fmtutil.cnf</span></samp><dd>&lsquo;<samp><span class="samp">web2c files</span></samp>&rsquo;
- <p><a name="index-glyphlist_002etxt-599"></a><br><dt><samp><span class="file">glyphlist.txt</span></samp><dd>&lsquo;<samp><span class="samp">map</span></samp>&rsquo;
+ <p><a name="index-glyphlist_002etxt-596"></a><br><dt><samp><span class="file">glyphlist.txt</span></samp><dd>&lsquo;<samp><span class="samp">map</span></samp>&rsquo;
- <p><a name="index-mktex_002ecnf-600"></a><br><dt><samp><span class="file">mktex.cnf</span></samp><dd>&lsquo;<samp><span class="samp">web2c files</span></samp>&rsquo;
+ <p><a name="index-mktex_002ecnf-597"></a><br><dt><samp><span class="file">mktex.cnf</span></samp><dd>&lsquo;<samp><span class="samp">web2c files</span></samp>&rsquo;
- <p><a name="index-pdfglyphlist_002etxt-601"></a><br><dt><samp><span class="file">pdfglyphlist.txt</span></samp><dd>&lsquo;<samp><span class="samp">map</span></samp>&rsquo;
+ <p><a name="index-pdfglyphlist_002etxt-598"></a><br><dt><samp><span class="file">pdfglyphlist.txt</span></samp><dd>&lsquo;<samp><span class="samp">map</span></samp>&rsquo;
- <p><a name="index-pdftex_002ecfg-602"></a><a name="index-pdftexconfig_002etex-603"></a><br><dt><samp><span class="file">pdftex.cfg</span></samp><dd>&lsquo;<samp><span class="samp">pdftex config</span></samp>&rsquo; (although <samp><span class="file">pdftex.cfg</span></samp> is not used any more;
+ <p><a name="index-pdftex_002ecfg-599"></a><a name="index-pdftexconfig_002etex-600"></a><br><dt><samp><span class="file">pdftex.cfg</span></samp><dd>&lsquo;<samp><span class="samp">pdftex config</span></samp>&rsquo; (although <samp><span class="file">pdftex.cfg</span></samp> is not used any more;
look for the file <samp><span class="file">pdftexconfig.tex</span></samp> instead.)
- <p><a name="index-texmf_002ecnf-604"></a><br><dt><samp><span class="file">texmf.cnf</span></samp><dd>&lsquo;<samp><span class="samp">cnf</span></samp>&rsquo;
+ <p><a name="index-texmf_002ecnf-601"></a><br><dt><samp><span class="file">texmf.cnf</span></samp><dd>&lsquo;<samp><span class="samp">cnf</span></samp>&rsquo;
+
+ <p><a name="index-XDvi-602"></a><br><dt><samp><span class="file">XDvi</span></samp><dd>&lsquo;<samp><span class="samp">other text files</span></samp>&rsquo;
</dl>
<p>A user-specified format will override the above defaults.
- <p><a name="index-tcfmgr_002emap-605"></a>Another useful configuration file in this regard is <samp><span class="file">tcfmgr.map</span></samp>,
+ <p><a name="index-tcfmgr_002emap-603"></a>Another useful configuration file in this regard is <samp><span class="file">tcfmgr.map</span></samp>,
found in <samp><span class="file">texmf/texconfig/tcfmgr.map</span></samp>, which records various
information about the above configuration files (among others).
<div class="node">
-<p><hr>
<a name="Auxiliary-tasks"></a>
+<p><hr>
Next:&nbsp;<a rel="next" accesskey="n" href="#Standard-options">Standard options</a>,
Previous:&nbsp;<a rel="previous" accesskey="p" href="#Specially_002drecognized-files">Specially-recognized files</a>,
Up:&nbsp;<a rel="up" accesskey="u" href="#Invoking-kpsewhich">Invoking kpsewhich</a>
@@ -3451,26 +3443,26 @@ Up:&nbsp;<a rel="up" accesskey="u" href="#Invoking-kpsewhich">Invoking kpsewhich
<h4 class="subsection">3.5.3 Auxiliary tasks</h4>
-<p><a name="index-auxiliary-tasks-606"></a>
+<p><a name="index-auxiliary-tasks-604"></a>
Kpsewhich provides some additional features not strictly related to path
lookup:
<ul>
-<li><a name="index-g_t_002d_002ddebug_003d_0040var_007bnum_007d-607"></a>&lsquo;<samp><span class="samp">--debug=</span><var>num</var></samp>&rsquo; sets the debugging options to <var>num</var>.
+<li><a name="index-g_t_002d_002ddebug_003d_0040var_007bnum_007d-605"></a>&lsquo;<samp><span class="samp">--debug=</span><var>num</var></samp>&rsquo; sets the debugging options to <var>num</var>.
See <a href="#Debugging">Debugging</a>.
- <li><a name="index-g_t_002d_002dvar_002dvalue_003d_0040var_007bvariable_007d-608"></a>&lsquo;<samp><span class="samp">--var-value=</span><var>variable</var></samp>&rsquo; outputs the value of <var>variable</var>,
+ <li><a name="index-g_t_002d_002dvar_002dvalue_003d_0040var_007bvariable_007d-606"></a>&lsquo;<samp><span class="samp">--var-value=</span><var>variable</var></samp>&rsquo; outputs the value of <var>variable</var>,
expanding &lsquo;<samp><span class="samp">$</span></samp>&rsquo; (see <a href="#Variable-expansion">Variable expansion</a> and &lsquo;<samp><span class="samp">~</span></samp>&rsquo; (see <a href="#Tilde-expansion">Tilde expansion</a>) constructs, but not performing other expansions.
- <li><a name="index-g_t_002d_002dexpand_002dbraces_003d_0040var_007bstring_007d-609"></a>&lsquo;<samp><span class="samp">--expand-braces=</span><var>string</var></samp>&rsquo; outputs the variable and brace
+ <li><a name="index-g_t_002d_002dexpand_002dbraces_003d_0040var_007bstring_007d-607"></a>&lsquo;<samp><span class="samp">--expand-braces=</span><var>string</var></samp>&rsquo; outputs the variable and brace
expansion of <var>string</var>. See <a href="#Path-expansion">Path expansion</a>.
- <li><a name="index-g_t_002d_002dexpand_002dvar_003d_0040var_007bstring_007d-610"></a>&lsquo;<samp><span class="samp">--expand-var=</span><var>string</var></samp>&rsquo; outputs the variable and tilde
+ <li><a name="index-g_t_002d_002dexpand_002dvar_003d_0040var_007bstring_007d-608"></a>&lsquo;<samp><span class="samp">--expand-var=</span><var>string</var></samp>&rsquo; outputs the variable and tilde
expansion of <var>string</var>. For example, the &lsquo;<samp><span class="samp">mktex...</span></samp>&rsquo;
scripts run &lsquo;<samp><span class="samp">kpsewhich --expand-var='$TEXMF'</span></samp>&rsquo; to find the root of
the TeX system hierarchy. See <a href="#Path-expansion">Path expansion</a>.
- <li><a name="index-g_t_002d_002dexpand_002dpath_003d_0040var_007bstring_007d-611"></a>&lsquo;<samp><span class="samp">--expand-path=</span><var>string</var></samp>&rsquo; outputs the complete expansion of
+ <li><a name="index-g_t_002d_002dexpand_002dpath_003d_0040var_007bstring_007d-609"></a>&lsquo;<samp><span class="samp">--expand-path=</span><var>string</var></samp>&rsquo; outputs the complete expansion of
<var>string</var>, with each element separated by the usual path separator
on the current system (&lsquo;<samp><span class="samp">;</span></samp>&rsquo; on Windows, &lsquo;<samp><span class="samp">:</span></samp>&rsquo; otherwise).
This may be useful to construct a custom search path for a format not
@@ -3487,7 +3479,7 @@ already supported, see &lsquo;<samp><span class="samp">--show-path</span></samp>
<p>For one-shot uses of an arbitrary (not built in to Kpathsea) path, see
&lsquo;<samp><span class="samp">--path</span></samp>&rsquo; in the previous section.
- <li><a name="index-g_t_002d_002dshow_002dpath_003d_0040var_007bname_007d-612"></a>&lsquo;<samp><span class="samp">--show-path=</span><var>name</var></samp>&rsquo; shows the path that would be used for file
+ <li><a name="index-g_t_002d_002dshow_002dpath_003d_0040var_007bname_007d-610"></a>&lsquo;<samp><span class="samp">--show-path=</span><var>name</var></samp>&rsquo; shows the path that would be used for file
lookups of file type <var>name</var>. Either a filename extension
(&lsquo;<samp><span class="samp">pk</span></samp>&rsquo;, &lsquo;<samp><span class="samp">.vf</span></samp>&rsquo;, etc.) or an integer can be used, just as with
&lsquo;<samp><span class="samp">--format</span></samp>&rsquo;, described in the previous section.
@@ -3495,8 +3487,8 @@ lookups of file type <var>name</var>. Either a filename extension
</ul>
<div class="node">
-<p><hr>
<a name="Standard-options"></a>
+<p><hr>
Previous:&nbsp;<a rel="previous" accesskey="p" href="#Auxiliary-tasks">Auxiliary tasks</a>,
Up:&nbsp;<a rel="up" accesskey="u" href="#Invoking-kpsewhich">Invoking kpsewhich</a>
@@ -3504,18 +3496,18 @@ Up:&nbsp;<a rel="up" accesskey="u" href="#Invoking-kpsewhich">Invoking kpsewhich
<h4 class="subsection">3.5.4 Standard options</h4>
-<p><a name="index-standard-options-613"></a>
+<p><a name="index-standard-options-611"></a>
Kpsewhich accepts the standard GNU options:
<ul>
-<li><a name="index-g_t_002d_002dhelp-614"></a>&lsquo;<samp><span class="samp">--help</span></samp>&rsquo; prints a help message on standard output and exits.
+<li><a name="index-g_t_002d_002dhelp-612"></a>&lsquo;<samp><span class="samp">--help</span></samp>&rsquo; prints a help message on standard output and exits.
- <li><a name="index-g_t_002d_002dversion-615"></a>&lsquo;<samp><span class="samp">--version</span></samp>&rsquo; prints the Kpathsea version number and exits.
+ <li><a name="index-g_t_002d_002dversion-613"></a>&lsquo;<samp><span class="samp">--version</span></samp>&rsquo; prints the Kpathsea version number and exits.
</ul>
<div class="node">
-<p><hr>
<a name="TeX-support"></a>
+<p><hr>
Next:&nbsp;<a rel="next" accesskey="n" href="#Programming">Programming</a>,
Previous:&nbsp;<a rel="previous" accesskey="p" href="#Path-searching">Path searching</a>,
Up:&nbsp;<a rel="up" accesskey="u" href="#Top">Top</a>
@@ -3524,7 +3516,7 @@ Up:&nbsp;<a rel="up" accesskey="u" href="#Top">Top</a>
<h2 class="chapter">4 TeX support</h2>
-<p><a name="index-g_t_0040TeX_007b_007d-support-616"></a>
+<p><a name="index-g_t_0040TeX_007b_007d-support-614"></a>
Although the basic features in Kpathsea can be used for any type of path
searching, it came about (like all libraries) with a specific
application in mind: I wrote Kpathsea specifically for TeX system
@@ -3550,8 +3542,8 @@ file is named <samp><span class="file">cmr10.600pk</span></samp>, it will be fou
</ul>
<div class="node">
-<p><hr>
<a name="Supported-file-formats"></a>
+<p><hr>
Next:&nbsp;<a rel="next" accesskey="n" href="#File-lookup">File lookup</a>,
Up:&nbsp;<a rel="up" accesskey="u" href="#TeX-support">TeX support</a>
@@ -3559,15 +3551,15 @@ Up:&nbsp;<a rel="up" accesskey="u" href="#TeX-support">TeX support</a>
<h3 class="section">4.1 Supported file formats</h3>
-<p><a name="index-supported-file-formats-617"></a><a name="index-file-formats_002c-supported-618"></a>
-<a name="index-environment-variables-for-_0040TeX_007b_007d-619"></a><a name="index-g_t_0040TeX_007b_007d-environment-variables-620"></a>
+<p><a name="index-supported-file-formats-615"></a><a name="index-file-formats_002c-supported-616"></a>
+<a name="index-environment-variables-for-_0040TeX_007b_007d-617"></a><a name="index-g_t_0040TeX_007b_007d-environment-variables-618"></a>
Kpathsea has support for a number of file types. Each file type has a
list of environment and config file variables that are checked to define
the search path, and most have a default suffix that plays a role in
finding files (see the next section). Some also define additional
suffixes, and/or a program to be run to create missing files on the fly.
- <p><a name="index-program_002dvarying-paths-621"></a>Since environment variables containing periods, such as
+ <p><a name="index-program_002dvarying-paths-619"></a>Since environment variables containing periods, such as
&lsquo;<samp><span class="samp">TEXINPUTS.latex</span></samp>&rsquo;, are not allowed on some systems, Kpathsea looks
for environment variables with an underscore, e.g.,
&lsquo;<samp><span class="samp">TEXINPUTS_latex</span></samp>&rsquo; (see <a href="#Config-files">Config files</a>).
@@ -3575,192 +3567,208 @@ for environment variables with an underscore, e.g.,
<p>The following table lists the above information.
<dl>
-<dt>&lsquo;<samp><span class="samp">afm</span></samp>&rsquo;<dd><a name="index-g_t_002eafm-622"></a><a name="index-AFMFONTS-623"></a>(Adobe font metrics, see <a href="dvips.html#Metric-files">Metric files</a>)
+<dt>&lsquo;<samp><span class="samp">afm</span></samp>&rsquo;<dd><a name="index-g_t_002eafm-620"></a><a name="index-AFMFONTS-621"></a>(Adobe font metrics, see <a href="dvips.html#Metric-files">Metric files</a>)
<code>AFMFONTS</code>;
suffix &lsquo;<samp><span class="samp">.afm</span></samp>&rsquo;.
- <br><dt>&lsquo;<samp><span class="samp">base</span></samp>&rsquo;<dd><a name="index-g_t_002ebase-624"></a><a name="index-MFBASES-625"></a><a name="index-TEXMFINI-626"></a>(Metafont memory dump, see <a href="web2c.html#Memory-dumps">Memory dumps</a>)
+ <br><dt>&lsquo;<samp><span class="samp">base</span></samp>&rsquo;<dd><a name="index-g_t_002ebase-622"></a><a name="index-MFBASES-623"></a><a name="index-TEXMFINI-624"></a>(Metafont memory dump, see <a href="web2c.html#Memory-dumps">Memory dumps</a>)
<code>MFBASES</code>, <code>TEXMFINI</code>;
suffix &lsquo;<samp><span class="samp">.base</span></samp>&rsquo;.
- <br><dt>&lsquo;<samp><span class="samp">bib</span></samp>&rsquo;<dd><a name="index-g_t_002ebib-627"></a><a name="index-BIBINPUTS-628"></a><a name="index-TEXBIB-629"></a>(BibTeX bibliography source, see <a href="web2c.html#bibtex-invocation">bibtex invocation</a>)
+ <br><dt>&lsquo;<samp><span class="samp">bib</span></samp>&rsquo;<dd><a name="index-g_t_002ebib-625"></a><a name="index-BIBINPUTS-626"></a><a name="index-TEXBIB-627"></a>(BibTeX bibliography source, see <a href="web2c.html#bibtex-invocation">bibtex invocation</a>)
<code>BIBINPUTS</code>, <code>TEXBIB</code>;
suffix &lsquo;<samp><span class="samp">.bib</span></samp>&rsquo;.
- <br><dt>&lsquo;<samp><span class="samp">bst</span></samp>&rsquo;<dd><a name="index-g_t_002ebst-630"></a><a name="index-BSTINPUTS-631"></a>(BibTeX style file, see <a href="web2c.html#Basic-BibTeX-style-files">Basic BibTeX style files</a>)
+ <br><dt>&lsquo;<samp><span class="samp">bst</span></samp>&rsquo;<dd><a name="index-g_t_002ebst-628"></a><a name="index-BSTINPUTS-629"></a>(BibTeX style, see <a href="web2c.html#Basic-BibTeX-style-files">Basic BibTeX style files</a>)
<code>BSTINPUTS</code>;
suffix &lsquo;<samp><span class="samp">.bst</span></samp>&rsquo;.
- <br><dt>&lsquo;<samp><span class="samp">cmap</span></samp>&rsquo;<dd><a name="index-g_t_002ecmap-632"></a><a name="index-CMAPFONTS-633"></a>(character map files)
+ <br><dt>&lsquo;<samp><span class="samp">cmap</span></samp>&rsquo;<dd><a name="index-g_t_002ecmap-630"></a><a name="index-CMAPFONTS-631"></a>(character map files)
<code>CMAPFONTS</code>;
suffix &lsquo;<samp><span class="samp">.cmap</span></samp>&rsquo;.
- <br><dt>&lsquo;<samp><span class="samp">cnf</span></samp>&rsquo;<dd><a name="index-g_t_002ecnf-634"></a><a name="index-TEXMFCNF-635"></a>(Runtime configuration files, see <a href="#Config-files">Config files</a>)
+ <br><dt>&lsquo;<samp><span class="samp">cnf</span></samp>&rsquo;<dd><a name="index-g_t_002ecnf-632"></a><a name="index-TEXMFCNF-633"></a>(Runtime configuration files, see <a href="#Config-files">Config files</a>)
<code>TEXMFCNF</code>;
suffix &lsquo;<samp><span class="samp">.cnf</span></samp>&rsquo;.
- <br><dt>&lsquo;<samp><span class="samp">cweb</span></samp>&rsquo;<dd><a name="index-g_t_002ew-636"></a><a name="index-g_t_002eweb-637"></a><a name="index-CWEBINPUTS-638"></a>(CWEB input files)
+ <br><dt>&lsquo;<samp><span class="samp">cweb</span></samp>&rsquo;<dd><a name="index-g_t_002ew-634"></a><a name="index-g_t_002eweb-635"></a><a name="index-CWEBINPUTS-636"></a>(CWEB input files)
<code>CWEBINPUTS</code>;
suffixes &lsquo;<samp><span class="samp">.w</span></samp>&rsquo;, &lsquo;<samp><span class="samp">.web</span></samp>&rsquo;;
additional suffix &lsquo;<samp><span class="samp">.ch</span></samp>&rsquo;.
- <br><dt>&lsquo;<samp><span class="samp">dvips config</span></samp>&rsquo;<dd><a name="index-TEXCONFIG-639"></a><a name="index-config_002eps_0040r_007b_002c-search-path-for_007d-640"></a>(Dvips &lsquo;<samp><span class="samp">config.*</span></samp>&rsquo; files, such as <samp><span class="file">config.ps</span></samp>, see <a href="dvips.html#Config-files">Config files</a>)
+ <br><dt>&lsquo;<samp><span class="samp">dvips config</span></samp>&rsquo;<dd><a name="index-TEXCONFIG-637"></a><a name="index-config_002eps_0040r_007b_002c-search-path-for_007d-638"></a>(Dvips &lsquo;<samp><span class="samp">config.*</span></samp>&rsquo; files, such as <samp><span class="file">config.ps</span></samp>, see <a href="dvips.html#Config-files">Config files</a>)
<code>TEXCONFIG</code>.
- <br><dt>&lsquo;<samp><span class="samp">enc files</span></samp>&rsquo;<dd><a name="index-g_t_002eenc-641"></a><a name="index-ENCFONTS-642"></a>(encoding vectors)
+ <br><dt>&lsquo;<samp><span class="samp">enc files</span></samp>&rsquo;<dd><a name="index-g_t_002eenc-639"></a><a name="index-ENCFONTS-640"></a>(encoding vectors)
<code>ENCFONTS</code>;
suffix &lsquo;<samp><span class="samp">.enc</span></samp>&rsquo;.
- <br><dt>&lsquo;<samp><span class="samp">fmt</span></samp>&rsquo;<dd><a name="index-g_t_002efmt-643"></a><a name="index-TEXFORMATS-644"></a><a name="index-TEXMFINI-645"></a>(TeX memory dump, see <a href="web2c.html#Memory-dumps">Memory dumps</a>)
+ <br><dt>&lsquo;<samp><span class="samp">fmt</span></samp>&rsquo;<dd><a name="index-g_t_002efmt-641"></a><a name="index-TEXFORMATS-642"></a><a name="index-TEXMFINI-643"></a>(TeX memory dump, see <a href="web2c.html#Memory-dumps">Memory dumps</a>)
<code>TEXFORMATS</code>, <code>TEXMFINI</code>;
suffix &lsquo;<samp><span class="samp">.fmt</span></samp>&rsquo;.
- <br><dt>&lsquo;<samp><span class="samp">gf</span></samp>&rsquo;<dd><a name="index-gf-646"></a><a name="index-GFFONTS-647"></a><a name="index-GLYPHFONTS-648"></a><a name="index-TEXFONTS-649"></a>(generic font bitmap, see <a href="dvips.html#Glyph-files">Glyph files</a>)
+ <br><dt>&lsquo;<samp><span class="samp">font cid map</span></samp>&rsquo;<dd><a name="index-g_t_002ecid-644"></a><a name="index-FONTCIDMAPS-645"></a>(CJK mapping)
+<code>FONTCIDMAPS</code>
+suffix &lsquo;<samp><span class="samp">.cid</span></samp>&rsquo;.
+
+ <br><dt>&lsquo;<samp><span class="samp">font feature files</span></samp>&rsquo;<dd><a name="index-g_t_002efea-646"></a><a name="index-FONTFEATURES-647"></a>(primarily for OpenType font features)
+<code>FONTFEATURES</code>
+suffix &lsquo;<samp><span class="samp">.fea</span></samp>&rsquo;.
+
+ <br><dt>&lsquo;<samp><span class="samp">gf</span></samp>&rsquo;<dd><a name="index-gf-648"></a><a name="index-GFFONTS-649"></a><a name="index-GLYPHFONTS-650"></a><a name="index-TEXFONTS-651"></a>(generic font bitmap, see <a href="dvips.html#Glyph-files">Glyph files</a>)
<var>program</var><code>FONTS</code>, <code>GFFONTS</code>, <code>GLYPHFONTS</code>, <code>TEXFONTS</code>;
suffix &lsquo;<samp><span class="samp">gf</span></samp>&rsquo;.
- <br><dt>&lsquo;<samp><span class="samp">graphic/figure</span></samp>&rsquo;<dd><a name="index-g_t_002eeps-650"></a><a name="index-g_t_002eepsi-651"></a><a name="index-TEXPICTS-652"></a><a name="index-TEXINPUTS-653"></a>(Encapsulated PostScript figures, see <a href="dvips.html#PostScript-figures">PostScript figures</a>)
+ <br><dt>&lsquo;<samp><span class="samp">graphic/figure</span></samp>&rsquo;<dd><a name="index-g_t_002eeps-652"></a><a name="index-g_t_002eepsi-653"></a><a name="index-TEXPICTS-654"></a><a name="index-TEXINPUTS-655"></a>(Encapsulated PostScript figures, see <a href="dvips.html#PostScript-figures">PostScript figures</a>)
<code>TEXPICTS</code>, <code>TEXINPUTS</code>;
additional suffixes: &lsquo;<samp><span class="samp">.eps</span></samp>&rsquo;, &lsquo;<samp><span class="samp">.epsi</span></samp>&rsquo;.
- <br><dt>&lsquo;<samp><span class="samp">ist</span></samp>&rsquo;<dd><a name="index-g_t_002eist-654"></a><a name="index-TEXINDEXSTYLE-655"></a><a name="index-INDEXSTYLE-656"></a>(makeindex style files)
+ <br><dt>&lsquo;<samp><span class="samp">ist</span></samp>&rsquo;<dd><a name="index-g_t_002eist-656"></a><a name="index-TEXINDEXSTYLE-657"></a><a name="index-INDEXSTYLE-658"></a>(makeindex style files)
<code>TEXINDEXSTYLE</code>, <code>INDEXSTYLE</code>;
suffix &lsquo;<samp><span class="samp">.ist</span></samp>&rsquo;.
- <br><dt>&lsquo;<samp><span class="samp">lig files</span></samp>&rsquo;<dd><a name="index-g_t_002elig-657"></a><a name="index-LIGFONTS-658"></a>(ligature definition files)
+ <br><dt>&lsquo;<samp><span class="samp">lig files</span></samp>&rsquo;<dd><a name="index-g_t_002elig-659"></a><a name="index-LIGFONTS-660"></a>(ligature definition files)
<code>LIGFONTS</code>;
suffix &lsquo;<samp><span class="samp">.lig</span></samp>&rsquo;.
- <br><dt>&lsquo;<samp><span class="samp">ls-R</span></samp>&rsquo;<dd><a name="index-ls_002dR-659"></a><a name="index-TEXMFDBS-660"></a>(Filename databases, see <a href="#Filename-database">Filename database</a>)
+ <br><dt>&lsquo;<samp><span class="samp">ls-R</span></samp>&rsquo;<dd><a name="index-ls_002dR-661"></a><a name="index-TEXMFDBS-662"></a>(Filename databases, see <a href="#Filename-database">Filename database</a>)
<code>TEXMFDBS</code>.
- <br><dt>&lsquo;<samp><span class="samp">map</span></samp>&rsquo;<dd><a name="index-g_t_002emap-661"></a><a name="index-TEXFONTMAPS-662"></a>(Fontmaps, see <a href="#Fontmap">Fontmap</a>)
+ <br><dt>&lsquo;<samp><span class="samp">map</span></samp>&rsquo;<dd><a name="index-g_t_002emap-663"></a><a name="index-TEXFONTMAPS-664"></a>(Fontmaps, see <a href="#Fontmap">Fontmap</a>)
<code>TEXFONTMAPS</code>;
suffix &lsquo;<samp><span class="samp">.map</span></samp>&rsquo;.
- <br><dt>&lsquo;<samp><span class="samp">mem</span></samp>&rsquo;<dd><a name="index-g_t_002emem-663"></a><a name="index-MPMEMS-664"></a><a name="index-TEXMFINI-665"></a>(MetaPost memory dump, see <a href="web2c.html#Memory-dumps">Memory dumps</a>)
+ <br><dt>&lsquo;<samp><span class="samp">mem</span></samp>&rsquo;<dd><a name="index-g_t_002emem-665"></a><a name="index-MPMEMS-666"></a><a name="index-TEXMFINI-667"></a>(MetaPost memory dump, see <a href="web2c.html#Memory-dumps">Memory dumps</a>)
<code>MPMEMS</code>, <code>TEXMFINI</code>;
suffix &lsquo;<samp><span class="samp">.mem</span></samp>&rsquo;.
- <br><dt>&lsquo;<samp><span class="samp">MetaPost support</span></samp>&rsquo;<dd><a name="index-MPSUPPORT-666"></a>(MetaPost support files, used by DMP; see <a href="web2c.html#dmp-invocation">dmp invocation</a>)
+ <br><dt>&lsquo;<samp><span class="samp">MetaPost support</span></samp>&rsquo;<dd><a name="index-MPSUPPORT-668"></a>(MetaPost support files, used by DMP; see <a href="web2c.html#dmp-invocation">dmp invocation</a>)
<code>MPSUPPORT</code>.
- <br><dt>&lsquo;<samp><span class="samp">mf</span></samp>&rsquo;<dd><a name="index-g_t_002emf-667"></a><a name="index-MFINPUTS-668"></a>(Metafont source, see <a href="web2c.html#mf-invocation">mf invocation</a>)
+ <br><dt>&lsquo;<samp><span class="samp">mf</span></samp>&rsquo;<dd><a name="index-g_t_002emf-669"></a><a name="index-MFINPUTS-670"></a>(Metafont source, see <a href="web2c.html#mf-invocation">mf invocation</a>)
<code>MFINPUTS</code>;
suffix &lsquo;<samp><span class="samp">.mf</span></samp>&rsquo;;
dynamic creation program: <code>mktexmf</code>.
- <br><dt>&lsquo;<samp><span class="samp">mfpool</span></samp>&rsquo;<dd><a name="index-g_t_002epool-669"></a><a name="index-MFPOOL-670"></a>(Metafont program strings, see <a href="web2c.html#pooltype-invocation">pooltype invocation</a>)
+ <br><dt>&lsquo;<samp><span class="samp">mfpool</span></samp>&rsquo;<dd><a name="index-g_t_002epool-671"></a><a name="index-MFPOOL-672"></a>(Metafont program strings, see <a href="web2c.html#pooltype-invocation">pooltype invocation</a>)
<code>MFPOOL</code>, <code>TEXMFINI</code>;
suffix &lsquo;<samp><span class="samp">.pool</span></samp>&rsquo;.
- <br><dt>&lsquo;<samp><span class="samp">mft</span></samp>&rsquo;<dd><a name="index-g_t_002emft-671"></a><a name="index-MFTINPUTS-672"></a>(<code>MFT</code> style file, see <a href="web2c.html#mft-invocation">mft invocation</a>)
+ <br><dt>&lsquo;<samp><span class="samp">mft</span></samp>&rsquo;<dd><a name="index-g_t_002emft-673"></a><a name="index-MFTINPUTS-674"></a>(<code>MFT</code> style file, see <a href="web2c.html#mft-invocation">mft invocation</a>)
<code>MFTINPUTS</code>;
suffix &lsquo;<samp><span class="samp">.mft</span></samp>&rsquo;.
- <br><dt>&lsquo;<samp><span class="samp">misc fonts</span></samp>&rsquo;<dd><a name="index-MISCFONTS-673"></a>(font-related files that don't fit the other categories)
+ <br><dt>&lsquo;<samp><span class="samp">misc fonts</span></samp>&rsquo;<dd><a name="index-MISCFONTS-675"></a>(font-related files that don't fit the other categories)
<code>MISCFONTS</code>
- <br><dt>&lsquo;<samp><span class="samp">mp</span></samp>&rsquo;<dd><a name="index-g_t_002emp-674"></a><a name="index-MPINPUTS-675"></a>(MetaPost source, see <a href="web2c.html#mpost-invocation">mpost invocation</a>)
+ <br><dt>&lsquo;<samp><span class="samp">mlbib</span></samp>&rsquo;<dd><a name="index-g_t_002emlbib-676"></a><a name="index-MLBIBINPUTS-677"></a><a name="index-BIBINPUTS-678"></a><a name="index-TEXBIB-679"></a>(MlBibTeX bibliography source)
+<code>MLBIBINPUTS</code>, <code>BIBINPUTS</code>, <code>TEXBIB</code>;
+suffixes &lsquo;<samp><span class="samp">.mlbib</span></samp>&rsquo;, &lsquo;<samp><span class="samp">.mlbib</span></samp>&rsquo;.
+
+ <br><dt>&lsquo;<samp><span class="samp">mlbst</span></samp>&rsquo;<dd><a name="index-g_t_002emlbst-680"></a><a name="index-MLBSTINPUTS-681"></a><a name="index-BSTINPUTS-682"></a>(MlBibTeX style)
+<code>MLBSTINPUTS</code>, <code>BSTINPUTS</code>;
+suffixes &lsquo;<samp><span class="samp">.mlbst</span></samp>&rsquo;, &lsquo;<samp><span class="samp">.bst</span></samp>&rsquo;.
+
+ <br><dt>&lsquo;<samp><span class="samp">mp</span></samp>&rsquo;<dd><a name="index-g_t_002emp-683"></a><a name="index-MPINPUTS-684"></a>(MetaPost source, see <a href="web2c.html#mpost-invocation">mpost invocation</a>)
<code>MPINPUTS</code>;
suffix &lsquo;<samp><span class="samp">.mp</span></samp>&rsquo;.
- <br><dt>&lsquo;<samp><span class="samp">mppool</span></samp>&rsquo;<dd><a name="index-g_t_002epool-676"></a><a name="index-MPPOOL-677"></a>(MetaPost program strings, see <a href="web2c.html#pooltype-invocation">pooltype invocation</a>)
+ <br><dt>&lsquo;<samp><span class="samp">mppool</span></samp>&rsquo;<dd><a name="index-g_t_002epool-685"></a><a name="index-MPPOOL-686"></a>(MetaPost program strings, see <a href="web2c.html#pooltype-invocation">pooltype invocation</a>)
<code>MPPOOL</code>, <code>TEXMFINI</code>;
suffix &lsquo;<samp><span class="samp">.pool</span></samp>&rsquo;.
- <br><dt>&lsquo;<samp><span class="samp">ocp</span></samp>&rsquo;<dd><a name="index-g_t_002eocp-678"></a><a name="index-OCPINPUTS-679"></a>(Omega compiled process files)
+ <br><dt>&lsquo;<samp><span class="samp">ocp</span></samp>&rsquo;<dd><a name="index-g_t_002eocp-687"></a><a name="index-OCPINPUTS-688"></a>(Omega compiled process files)
<code>OCPINPUTS</code>; <br>
suffix &lsquo;<samp><span class="samp">.ocp</span></samp>&rsquo;;
dynamic creation program: <code>MakeOmegaOCP</code>.
- <br><dt>&lsquo;<samp><span class="samp">ofm</span></samp>&rsquo;<dd><a name="index-g_t_002eofm-680"></a><a name="index-OFMFONTS-681"></a>(Omega font metrics)
+ <br><dt>&lsquo;<samp><span class="samp">ofm</span></samp>&rsquo;<dd><a name="index-g_t_002eofm-689"></a><a name="index-OFMFONTS-690"></a>(Omega font metrics)
<code>OFMFONTS</code>, <code>TEXFONTS</code>; <br>
suffixes &lsquo;<samp><span class="samp">.ofm</span></samp>&rsquo;, &lsquo;<samp><span class="samp">.tfm</span></samp>&rsquo;;
dynamic creation program: <code>MakeOmegaOFM</code>.
- <br><dt>&lsquo;<samp><span class="samp">opentype fonts</span></samp>&rsquo;<dd><a name="index-OPENTYPEFONTS-682"></a>(OpenType fonts)
+ <br><dt>&lsquo;<samp><span class="samp">opentype fonts</span></samp>&rsquo;<dd><a name="index-OPENTYPEFONTS-691"></a>(OpenType fonts)
<code>OPENTYPEFONTS</code>.
- <br><dt>&lsquo;<samp><span class="samp">opl</span></samp>&rsquo;<dd><a name="index-g_t_002eopl-683"></a>(Omega property lists)
+ <br><dt>&lsquo;<samp><span class="samp">opl</span></samp>&rsquo;<dd><a name="index-g_t_002eopl-692"></a>(Omega property lists)
<code>OPLFONTS</code>, <code>TEXFONTS</code>;
suffix &lsquo;<samp><span class="samp">.opl</span></samp>&rsquo;.
- <br><dt>&lsquo;<samp><span class="samp">otp</span></samp>&rsquo;<dd><a name="index-g_t_002eotp-684"></a><a name="index-OTPINPUTS-685"></a>(Omega translation process files)
+ <br><dt>&lsquo;<samp><span class="samp">otp</span></samp>&rsquo;<dd><a name="index-g_t_002eotp-693"></a><a name="index-OTPINPUTS-694"></a>(Omega translation process files)
<code>OTPINPUTS</code>;
suffix &lsquo;<samp><span class="samp">.otp</span></samp>&rsquo;.
- <br><dt>&lsquo;<samp><span class="samp">ovf</span></samp>&rsquo;<dd><a name="index-g_t_002eovf-686"></a><a name="index-OVFFONTS-687"></a>(Omega virtual fonts)
+ <br><dt>&lsquo;<samp><span class="samp">ovf</span></samp>&rsquo;<dd><a name="index-g_t_002eovf-695"></a><a name="index-OVFFONTS-696"></a>(Omega virtual fonts)
<code>OVFFONTS</code>, <code>TEXFONTS</code>;
suffix &lsquo;<samp><span class="samp">.ovf</span></samp>&rsquo;.
- <br><dt>&lsquo;<samp><span class="samp">ovp</span></samp>&rsquo;<dd><a name="index-g_t_002eovp-688"></a><a name="index-OVPFONTS-689"></a>(Omega virtual property lists)
+ <br><dt>&lsquo;<samp><span class="samp">ovp</span></samp>&rsquo;<dd><a name="index-g_t_002eovp-697"></a><a name="index-OVPFONTS-698"></a>(Omega virtual property lists)
<code>OVPFONTS</code>, <code>TEXFONTS</code>;
suffix &lsquo;<samp><span class="samp">.ovp</span></samp>&rsquo;.
- <br><dt>&lsquo;<samp><span class="samp">pdftex config</span></samp>&rsquo;<dd><a name="index-PDFTEXCONFIG-690"></a>(PDFTeX-specific configuration files)
+ <br><dt>&lsquo;<samp><span class="samp">pdftex config</span></samp>&rsquo;<dd><a name="index-PDFTEXCONFIG-699"></a>(PDFTeX-specific configuration files)
<code>PDFTEXCONFIG</code>.
- <br><dt>&lsquo;<samp><span class="samp">pk</span></samp>&rsquo;<dd><a name="index-g_t_002epk-691"></a><a name="index-PKFONTS-692"></a><a name="index-TEXPKS-693"></a><a name="index-GLYPHFONTS-694"></a><a name="index-TEXFONTS-695"></a>(packed bitmap fonts, see <a href="dvips.html#Glyph-files">Glyph files</a>)
+ <br><dt>&lsquo;<samp><span class="samp">pk</span></samp>&rsquo;<dd><a name="index-g_t_002epk-700"></a><a name="index-PKFONTS-701"></a><a name="index-TEXPKS-702"></a><a name="index-GLYPHFONTS-703"></a><a name="index-TEXFONTS-704"></a>(packed bitmap fonts, see <a href="dvips.html#Glyph-files">Glyph files</a>)
<var>PROGRAM</var><code>FONTS</code> (<var>program</var> being &lsquo;<samp><span class="samp">XDVI</span></samp>&rsquo;, etc.),
<code>PKFONTS</code>, <code>TEXPKS</code>, <code>GLYPHFONTS</code>, <code>TEXFONTS</code>;
suffix &lsquo;<samp><span class="samp">pk</span></samp>&rsquo;;
dynamic creation program: <code>mktexpk</code>.
- <br><dt>&lsquo;<samp><span class="samp">PostScript header</span></samp>&rsquo;<dd><a name="index-g_t_002epro-696"></a><a name="index-TEXPSHEADERS-697"></a><a name="index-PSHEADERS-698"></a>(downloadable PostScript, see <a href="dvips.html#Header-files">Header files</a>)
+ <br><dt>&lsquo;<samp><span class="samp">PostScript header</span></samp>&rsquo;<dd><a name="index-g_t_002epro-705"></a><a name="index-TEXPSHEADERS-706"></a><a name="index-PSHEADERS-707"></a>(downloadable PostScript, see <a href="dvips.html#Header-files">Header files</a>)
<code>TEXPSHEADERS</code>, <code>PSHEADERS</code>;
additional suffix &lsquo;<samp><span class="samp">.pro</span></samp>&rsquo;.
- <br><dt>&lsquo;<samp><span class="samp">subfont definition files</span></samp>&rsquo;<dd><a name="index-g_t_002esfd-699"></a><a name="index-SFDFONTS-700"></a>(subfont definition files)
+ <br><dt>&lsquo;<samp><span class="samp">subfont definition files</span></samp>&rsquo;<dd><a name="index-g_t_002esfd-708"></a><a name="index-SFDFONTS-709"></a>(subfont definition files)
<code>SFDFONTS</code>
suffix &lsquo;<samp><span class="samp">.sfd</span></samp>&rsquo;.
- <br><dt>&lsquo;<samp><span class="samp">tex</span></samp>&rsquo;<dd><a name="index-g_t_002etex-701"></a><a name="index-TEXINPUTS-702"></a>(TeX source, see <a href="web2c.html#tex-invocation">tex invocation</a>)
+ <br><dt>&lsquo;<samp><span class="samp">tex</span></samp>&rsquo;<dd><a name="index-g_t_002etex-710"></a><a name="index-TEXINPUTS-711"></a>(TeX source, see <a href="web2c.html#tex-invocation">tex invocation</a>)
<code>TEXINPUTS</code>;
suffix &lsquo;<samp><span class="samp">.tex</span></samp>&rsquo;;
additional suffixes: none, because such a list cannot be complete;
dynamic creation program: <code>mktextex</code>.
- <br><dt>&lsquo;<samp><span class="samp">TeX system documentation</span></samp>&rsquo;<dd><a name="index-doc-files-703"></a><a name="index-TEXDOCS-704"></a>(Documentation files for the TeX system)
+ <br><dt>&lsquo;<samp><span class="samp">TeX system documentation</span></samp>&rsquo;<dd><a name="index-doc-files-712"></a><a name="index-TEXDOCS-713"></a>(Documentation files for the TeX system)
<code>TEXDOCS</code>.
- <br><dt>&lsquo;<samp><span class="samp">TeX system sources</span></samp>&rsquo;<dd><a name="index-source-files-705"></a><a name="index-TEXSOURCES-706"></a>(Source files for the TeX system)
+ <br><dt>&lsquo;<samp><span class="samp">TeX system sources</span></samp>&rsquo;<dd><a name="index-source-files-714"></a><a name="index-TEXSOURCES-715"></a>(Source files for the TeX system)
<code>TEXSOURCES</code>.
- <br><dt>&lsquo;<samp><span class="samp">texmfscripts</span></samp>&rsquo;<dd><a name="index-TEXMFSCRIPTS-707"></a>(Architecture-independent executables distributed in the texmf tree)
+ <br><dt>&lsquo;<samp><span class="samp">texmfscripts</span></samp>&rsquo;<dd><a name="index-TEXMFSCRIPTS-716"></a>(Architecture-independent executables distributed in the texmf tree)
<code>TEXMFSCRIPTS</code>.
- <br><dt>&lsquo;<samp><span class="samp">texpool</span></samp>&rsquo;<dd><a name="index-g_t_002epool-708"></a><a name="index-TEXPOOL-709"></a>(TeX program strings, see <a href="web2c.html#pooltype-invocation">pooltype invocation</a>)
+ <br><dt>&lsquo;<samp><span class="samp">texpool</span></samp>&rsquo;<dd><a name="index-g_t_002epool-717"></a><a name="index-TEXPOOL-718"></a>(TeX program strings, see <a href="web2c.html#pooltype-invocation">pooltype invocation</a>)
<code>TEXPOOL</code>, <code>TEXMFINI</code>;
suffix &lsquo;<samp><span class="samp">.pool</span></samp>&rsquo;.
- <br><dt>&lsquo;<samp><span class="samp">tfm</span></samp>&rsquo;<dd><a name="index-g_t_002etfm-710"></a><a name="index-TFMFONTS-711"></a><a name="index-TEXFONTS-712"></a>(TeX font metrics, see <a href="dvips.html#Metric-files">Metric files</a>)
+ <br><dt>&lsquo;<samp><span class="samp">tfm</span></samp>&rsquo;<dd><a name="index-g_t_002etfm-719"></a><a name="index-TFMFONTS-720"></a><a name="index-TEXFONTS-721"></a>(TeX font metrics, see <a href="dvips.html#Metric-files">Metric files</a>)
<code>TFMFONTS</code>, <code>TEXFONTS</code>;
suffix &lsquo;<samp><span class="samp">.tfm</span></samp>&rsquo;;
dynamic creation program: <code>mktextfm</code>.
- <br><dt>&lsquo;<samp><span class="samp">Troff fonts</span></samp>&rsquo;<dd><a name="index-TRFONTS-713"></a>(Troff fonts, used by DMP; see <a href="web2c.html#DMP-invocation">DMP invocation</a>)
+ <br><dt>&lsquo;<samp><span class="samp">Troff fonts</span></samp>&rsquo;<dd><a name="index-TRFONTS-722"></a>(Troff fonts, used by DMP; see <a href="web2c.html#DMP-invocation">DMP invocation</a>)
<code>TRFONTS</code>.
- <br><dt>&lsquo;<samp><span class="samp">truetype fonts</span></samp>&rsquo;<dd><a name="index-g_t_002ettf-714"></a><a name="index-g_t_002ettc-715"></a><a name="index-TTFONTS-716"></a>(TrueType outline fonts) <code>TTFONTS</code>; suffixes &lsquo;<samp><span class="samp">.ttf</span></samp>&rsquo;,
+ <br><dt>&lsquo;<samp><span class="samp">truetype fonts</span></samp>&rsquo;<dd><a name="index-g_t_002ettf-723"></a><a name="index-g_t_002ettc-724"></a><a name="index-TTFONTS-725"></a>(TrueType outline fonts) <code>TTFONTS</code>; suffixes &lsquo;<samp><span class="samp">.ttf</span></samp>&rsquo;,
&lsquo;<samp><span class="samp">.ttc</span></samp>&rsquo;.
- <br><dt>&lsquo;<samp><span class="samp">type1 fonts</span></samp>&rsquo;<dd><a name="index-g_t_002epfa-717"></a><a name="index-g_t_002epfb-718"></a><a name="index-T1FONTS-719"></a><a name="index-T1INPUTS-720"></a><a name="index-TEXPSHEADERS-721"></a><a name="index-DVIPSHEADERS-722"></a>(Type 1 PostScript outline fonts, see <a href="dvips.html#Glyph-files">Glyph files</a>)
+ <br><dt>&lsquo;<samp><span class="samp">type1 fonts</span></samp>&rsquo;<dd><a name="index-g_t_002epfa-726"></a><a name="index-g_t_002epfb-727"></a><a name="index-T1FONTS-728"></a><a name="index-T1INPUTS-729"></a><a name="index-TEXPSHEADERS-730"></a><a name="index-DVIPSHEADERS-731"></a>(Type 1 PostScript outline fonts, see <a href="dvips.html#Glyph-files">Glyph files</a>)
<code>T1FONTS</code>, <code>T1INPUTS</code>, <code>TEXPSHEADERS</code>, <code>DVIPSHEADERS</code>;
suffixes &lsquo;<samp><span class="samp">.pfa</span></samp>&rsquo;, &lsquo;<samp><span class="samp">.pfb</span></samp>&rsquo;.
- <br><dt>&lsquo;<samp><span class="samp">type42 fonts</span></samp>&rsquo;<dd><a name="index-T42FONTS-723"></a>(Type 42 PostScript outline fonts) <code>T42FONTS</code>.
+ <br><dt>&lsquo;<samp><span class="samp">type42 fonts</span></samp>&rsquo;<dd><a name="index-T42FONTS-732"></a>(Type 42 PostScript outline fonts) <code>T42FONTS</code>.
- <br><dt>&lsquo;<samp><span class="samp">vf</span></samp>&rsquo;<dd><a name="index-g_t_002evf-724"></a><a name="index-VFFONTS-725"></a><a name="index-TEXFONTS-726"></a>(virtual fonts, see <a href="dvips.html#Virtual-fonts">Virtual fonts</a>)
+ <br><dt>&lsquo;<samp><span class="samp">vf</span></samp>&rsquo;<dd><a name="index-g_t_002evf-733"></a><a name="index-VFFONTS-734"></a><a name="index-TEXFONTS-735"></a>(virtual fonts, see <a href="dvips.html#Virtual-fonts">Virtual fonts</a>)
<code>VFFONTS</code>, <code>TEXFONTS</code>;
suffix &lsquo;<samp><span class="samp">.vf</span></samp>&rsquo;.
- <br><dt>&lsquo;<samp><span class="samp">web</span></samp>&rsquo;<dd><a name="index-g_t_002eweb-727"></a><a name="index-WEBINPUTS-728"></a>(WEB input files)
+ <br><dt>&lsquo;<samp><span class="samp">web</span></samp>&rsquo;<dd><a name="index-g_t_002eweb-736"></a><a name="index-WEBINPUTS-737"></a>(WEB input files)
<code>WEBINPUTS</code>;
suffix &lsquo;<samp><span class="samp">.web</span></samp>&rsquo;;
additional suffix &lsquo;<samp><span class="samp">.ch</span></samp>&rsquo;.
- <br><dt>&lsquo;<samp><span class="samp">web2c files</span></samp>&rsquo;<dd><a name="index-WEB2C-729"></a>(files specific to the web2c implementation)
+ <br><dt>&lsquo;<samp><span class="samp">web2c files</span></samp>&rsquo;<dd><a name="index-WEB2C-738"></a>(files specific to the web2c implementation)
<code>WEB2C</code>.
</dl>
@@ -3771,10 +3779,10 @@ appending &lsquo;<samp><span class="samp">INPUTS</span></samp>&rsquo;. Assuming
this gives us the following table.
<dl>
-<dt>&lsquo;<samp><span class="samp">other text files</span></samp>&rsquo;<dd><a name="index-FOOINPUTS-730"></a>(text files used by &lsquo;<samp><span class="samp">foo</span></samp>&rsquo;)
+<dt>&lsquo;<samp><span class="samp">other text files</span></samp>&rsquo;<dd><a name="index-FOOINPUTS-739"></a>(text files used by &lsquo;<samp><span class="samp">foo</span></samp>&rsquo;)
<code>FOOINPUTS</code>.
- <br><dt>&lsquo;<samp><span class="samp">other binary files</span></samp>&rsquo;<dd><a name="index-FOOINPUTS-731"></a>(binary files used by &lsquo;<samp><span class="samp">foo</span></samp>&rsquo;)
+ <br><dt>&lsquo;<samp><span class="samp">other binary files</span></samp>&rsquo;<dd><a name="index-FOOINPUTS-740"></a>(binary files used by &lsquo;<samp><span class="samp">foo</span></samp>&rsquo;)
<code>FOOINPUTS</code>.
</dl>
@@ -3791,14 +3799,14 @@ non-metric) files.
<li>Each font format has a variable of its own.
- <li><a name="index-XDVIFONTS-732"></a><a name="index-DVIPSFONTS-733"></a>Each program has its own font override path as well; e.g.,
+ <li><a name="index-XDVIFONTS-741"></a><a name="index-DVIPSFONTS-742"></a>Each program has its own font override path as well; e.g.,
<code>DVIPSFONTS</code> for Dvipsk. Again, this is for bitmaps, not metrics.
</ul>
<div class="node">
-<p><hr>
<a name="File-lookup"></a>
+<p><hr>
Next:&nbsp;<a rel="next" accesskey="n" href="#Glyph-lookup">Glyph lookup</a>,
Previous:&nbsp;<a rel="previous" accesskey="p" href="#Supported-file-formats">Supported file formats</a>,
Up:&nbsp;<a rel="up" accesskey="u" href="#TeX-support">TeX support</a>
@@ -3807,7 +3815,7 @@ Up:&nbsp;<a rel="up" accesskey="u" href="#TeX-support">TeX support</a>
<h3 class="section">4.2 File lookup</h3>
-<p><a name="index-file-lookup-734"></a><a name="index-searching-for-files-735"></a><a name="index-g_t_0040TeX_007b_007d-file-lookup-736"></a>
+<p><a name="index-file-lookup-743"></a><a name="index-searching-for-files-744"></a><a name="index-g_t_0040TeX_007b_007d-file-lookup-745"></a>
This section describes how Kpathsea searches for most files (bitmap font
searches are the exception, as described in the next section).
@@ -3828,7 +3836,7 @@ the fontmaps. Example: given &lsquo;<samp><span class="samp">foo.bar</span></sa
run it (see <a href="#mktex-scripts">mktex scripts</a>).
</ol>
- <p><a name="index-extensions_002c-filename-737"></a><a name="index-suffixes_002c-filename-738"></a><a name="index-try_005fstd_005fextension_005ffirst-739"></a>The order in which we search for &ldquo;suffixed&rdquo; name (item&nbsp;1) or
+ <p><a name="index-extensions_002c-filename-746"></a><a name="index-suffixes_002c-filename-747"></a><a name="index-try_005fstd_005fextension_005ffirst-748"></a>The order in which we search for &ldquo;suffixed&rdquo; name (item&nbsp;1) or
the &ldquo;as-is&rdquo; name (item&nbsp;2) is controlled by the
<samp><span class="file">try_std_extension_first</span></samp> configuration value. The default set
in <samp><span class="file">texmf.cnf</span></samp> is true, since common suffixes are already
@@ -3842,13 +3850,13 @@ always tried; the difference is the order in which they are tried.
which *already* have an extension. A name without an extension (e.g.,
&lsquo;<samp><span class="samp">tex story</span></samp>&rsquo;) will always have an extension added first.
- <p><a name="index-tex_002dfile_002ec-740"></a><a name="index-kpse_005ffind_005ffile-741"></a>This algorithm is implemented in the routine <code>kpse_find_file</code> in
+ <p><a name="index-tex_002dfile_002ec-749"></a><a name="index-kpathsea_005ffind_005ffile-750"></a>This algorithm is implemented in the routine <code>kpathsea_find_file</code> in
<samp><span class="file">kpathsea/tex-file.c</span></samp>. You can watch it in action with the
debugging options (see <a href="#Debugging">Debugging</a>).
<div class="node">
-<p><hr>
<a name="Glyph-lookup"></a>
+<p><hr>
Next:&nbsp;<a rel="next" accesskey="n" href="#Suppressing-warnings">Suppressing warnings</a>,
Previous:&nbsp;<a rel="previous" accesskey="p" href="#File-lookup">File lookup</a>,
Up:&nbsp;<a rel="up" accesskey="u" href="#TeX-support">TeX support</a>
@@ -3857,7 +3865,7 @@ Up:&nbsp;<a rel="up" accesskey="u" href="#TeX-support">TeX support</a>
<h3 class="section">4.3 Glyph lookup</h3>
-<p><a name="index-glyph-lookup-742"></a><a name="index-searching-for-glyphs-743"></a><a name="index-g_t_0040TeX_007b_007d-glyph-lookup-744"></a>
+<p><a name="index-glyph-lookup-751"></a><a name="index-searching-for-glyphs-752"></a><a name="index-g_t_0040TeX_007b_007d-glyph-lookup-753"></a>
This section describes how Kpathsea searches for a bitmap font in GF or
PK format (or either) given a font name (e.g., &lsquo;<samp><span class="samp">cmr10</span></samp>&rsquo;) and a
resolution (e.g., 600).
@@ -3880,7 +3888,7 @@ generate the font (see <a href="#mktex-scripts">mktex scripts</a>)
last-resort font (typically &lsquo;<samp><span class="samp">cmr10</span></samp>&rsquo;).
</ol>
- <p><a name="index-tex_002dglyph_002ec-745"></a><a name="index-kpse_005ffind_005fglyph_005fformat-746"></a>This is implemented in <code>kpse_find_glyph_format</code> in
+ <p><a name="index-tex_002dglyph_002ec-754"></a><a name="index-kpathsea_005ffind_005fglyph-755"></a>This is implemented in <code>kpathsea_find_glyph</code> in
<samp><span class="file">kpathsea/tex-glyph.c</span></samp>.
<ul class="menu">
@@ -3890,8 +3898,8 @@ last-resort font (typically &lsquo;<samp><span class="samp">cmr10</span></samp>&
</ul>
<div class="node">
-<p><hr>
<a name="Basic-glyph-lookup"></a>
+<p><hr>
Next:&nbsp;<a rel="next" accesskey="n" href="#Fontmap">Fontmap</a>,
Up:&nbsp;<a rel="up" accesskey="u" href="#Glyph-lookup">Glyph lookup</a>
@@ -3899,7 +3907,7 @@ Up:&nbsp;<a rel="up" accesskey="u" href="#Glyph-lookup">Glyph lookup</a>
<h4 class="subsection">4.3.1 Basic glyph lookup</h4>
-<p><a name="index-basic-glyph-lookup-747"></a><a name="index-common-features-in-glyph-lookup-748"></a>
+<p><a name="index-basic-glyph-lookup-756"></a><a name="index-common-features-in-glyph-lookup-757"></a>
When Kpathsea looks for a bitmap font <var>name</var> at resolution <var>dpi</var>
in a format <var>format</var>, it first checks each directory in the search
path for a file &lsquo;<samp><var>name</var><span class="samp">.</span><var>dpi</var><var>format</var></samp>&rsquo;; for example,
@@ -3910,15 +3918,15 @@ path for a file &lsquo;<samp><var>name</var><span class="samp">.</span><var>dpi<
&lsquo;<samp><span class="samp">dpi600/cmr10.pk</span></samp>&rsquo;. This is how fonts are typically stored on
filesystems (such as DOS) that permit only three-character extensions.
- <p><a name="index-tolerance-for-glyph-lookup-749"></a><a name="index-glyph-lookup-bitmap-tolerance-750"></a><a name="index-KPSE_005fBITMAP_005fTOLERANCE-751"></a>If that fails, Kpathsea looks for a font with a close-enough <var>dpi</var>.
+ <p><a name="index-tolerance-for-glyph-lookup-758"></a><a name="index-glyph-lookup-bitmap-tolerance-759"></a><a name="index-KPSE_005fBITMAP_005fTOLERANCE-760"></a>If that fails, Kpathsea looks for a font with a close-enough <var>dpi</var>.
&ldquo;Close enough&rdquo; is defined by the macro <code>KPSE_BITMAP_TOLERANCE</code> in
<samp><span class="file">kpathsea/tex-glyph.h</span></samp> to be <var>dpi</var><code> / 500 + 1</code>. This is
slightly more than the 0.2% minimum allowed by the DVI standard
(<a href="<var>CTAN:</var>/dviware/driv-standard/level-0"><var>CTAN:</var>/dviware/driv-standard/level-0</a>).
<div class="node">
-<p><hr>
<a name="Fontmap"></a>
+<p><hr>
Next:&nbsp;<a rel="next" accesskey="n" href="#Fallback-font">Fallback font</a>,
Previous:&nbsp;<a rel="previous" accesskey="p" href="#Basic-glyph-lookup">Basic glyph lookup</a>,
Up:&nbsp;<a rel="up" accesskey="u" href="#Glyph-lookup">Glyph lookup</a>
@@ -3927,8 +3935,8 @@ Up:&nbsp;<a rel="up" accesskey="u" href="#Glyph-lookup">Glyph lookup</a>
<h4 class="subsection">4.3.2 Fontmap</h4>
-<p><a name="index-fontmap-files-752"></a><a name="index-font-alias-files-753"></a><a name="index-aliases-for-fonts-754"></a>
-<a name="index-texfonts_002emap-755"></a>If a bitmap font or metric file is not found with the original name (see
+<p><a name="index-fontmap-files-761"></a><a name="index-font-alias-files-762"></a><a name="index-aliases-for-fonts-763"></a>
+<a name="index-texfonts_002emap-764"></a>If a bitmap font or metric file is not found with the original name (see
the previous section), Kpathsea looks through any <dfn>fontmap</dfn> files
for an <dfn>alias</dfn> for the original font name. These files are named
<samp><span class="file">texfonts.map</span></samp> and searched for along the <code>TEXFONTMAPS</code>
@@ -3939,11 +3947,11 @@ are found are read; earlier definitions override later ones.
<ol type=1 start=1>
- <li><a name="index-fontnames_002c-arbitrary-length-756"></a>An alias name is limited in length only by available memory, not by your
+ <li><a name="index-fontnames_002c-arbitrary-length-765"></a>An alias name is limited in length only by available memory, not by your
filesystem. Therefore, if you want to ask for &lsquo;<samp><span class="samp">Times-Roman</span></samp>&rsquo;
instead of <samp><span class="file">ptmr</span></samp>, you can (you get &lsquo;<samp><span class="samp">ptmr8r</span></samp>&rsquo;).
- <li><a name="index-circle-fonts-757"></a><a name="index-lcircle10-758"></a>A few fonts have historically had multiple names: specifically,
+ <li><a name="index-circle-fonts-766"></a><a name="index-lcircle10-767"></a>A few fonts have historically had multiple names: specifically,
LaTeX's &ldquo;circle font&rdquo; has variously been known as <samp><span class="file">circle10</span></samp>,
<samp><span class="file">lcircle10</span></samp>, and <samp><span class="file">lcirc10</span></samp>. Aliases can make all the names
equivalent, so that it no longer matters what the name of the installed
@@ -3954,12 +3962,12 @@ file is; TeX documents will find their favorite name.
<p>The format of fontmap files is straightforward:
-<a name="index-comments_002c-in-fontmap-files-759"></a>
+<a name="index-comments_002c-in-fontmap-files-768"></a>
<ul><li>Comments start with &lsquo;<samp><span class="samp">%</span></samp>&rsquo; and continue to the end of the line.
-<a name="index-whitespace_002c-in-fontmap-files-760"></a><li>Blank lines are ignored.
+<a name="index-whitespace_002c-in-fontmap-files-769"></a><li>Blank lines are ignored.
<li>Each nonblank line is broken up into a series of <dfn>words</dfn>:
a sequence of non-whitespace characters.
-<a name="index-include-_0040r_007bfontmap-directive_007d-761"></a><li>If the first word is &lsquo;<samp><span class="samp">include</span></samp>&rsquo;, the second word is used as
+<a name="index-include-_0040r_007bfontmap-directive_007d-770"></a><li>If the first word is &lsquo;<samp><span class="samp">include</span></samp>&rsquo;, the second word is used as
a filename, and it is searched for and read.
<li>Otherwise, the first word on each line is the true filename;
<li>the second word is the alias;
@@ -3994,8 +4002,8 @@ The Fontname distribution has much more information on font naming
(see <a href="fontname.html#Introduction">Introduction</a>).
<div class="node">
-<p><hr>
<a name="Fallback-font"></a>
+<p><hr>
Previous:&nbsp;<a rel="previous" accesskey="p" href="#Fontmap">Fontmap</a>,
Up:&nbsp;<a rel="up" accesskey="u" href="#Glyph-lookup">Glyph lookup</a>
@@ -4003,8 +4011,8 @@ Up:&nbsp;<a rel="up" accesskey="u" href="#Glyph-lookup">Glyph lookup</a>
<h4 class="subsection">4.3.3 Fallback font</h4>
-<p><a name="index-fallback-font-762"></a><a name="index-fallback-resolutions-763"></a><a name="index-font-of-last-resort-764"></a><a name="index-resolutions_002c-last_002dresort-765"></a><a name="index-last_002dresort-font-766"></a>
-<a name="index-DVIPSSIZES-767"></a><a name="index-XDVISIZES-768"></a><a name="index-DVILJSIZES-769"></a><a name="index-TEXSIZES-770"></a><a name="index-default_005ftexsizes-771"></a>If a bitmap font cannot be found or created at the requested size,
+<p><a name="index-fallback-font-771"></a><a name="index-fallback-resolutions-772"></a><a name="index-font-of-last-resort-773"></a><a name="index-resolutions_002c-last_002dresort-774"></a><a name="index-last_002dresort-font-775"></a>
+<a name="index-DVIPSSIZES-776"></a><a name="index-XDVISIZES-777"></a><a name="index-DVILJSIZES-778"></a><a name="index-TEXSIZES-779"></a><a name="index-default_005ftexsizes-780"></a>If a bitmap font cannot be found or created at the requested size,
Kpathsea looks for the font at a set of <dfn>fallback resolutions</dfn>. You
specify these resolutions as a colon-separated list (like search paths).
Kpathsea looks first for a program-specific environment variable (e.g.,
@@ -4013,15 +4021,14 @@ Kpathsea looks first for a program-specific environment variable (e.g.,
variable <code>default_texsizes</code>). You can set this list to be empty if
you prefer to find fonts at their stated size or not at all.
- <p><a name="index-cmr10_0040r_007b_002c-as-fallback-font_007d-772"></a><a name="index-kpse_005ffallback_005ffont-773"></a>Finally, if the font cannot be found even at the fallback resolutions,
+ <p><a name="index-cmr10_0040r_007b_002c-as-fallback-font_007d-781"></a><a name="index-kpathsea_005finit_005fprog-782"></a>Finally, if the font cannot be found even at the fallback resolutions,
Kpathsea looks for a fallback font, typically <samp><span class="file">cmr10</span></samp>. Programs
-must enable this feature by assigning to the global variable
-<code>kpse_fallback_font</code> or calling <code>kpse_init_prog</code>
+must enable this feature by calling <code>kpathsea_init_prog</code>
(see <a href="#Calling-sequence">Calling sequence</a>); the default is no fallback font.
<div class="node">
-<p><hr>
<a name="Suppressing-warnings"></a>
+<p><hr>
Previous:&nbsp;<a rel="previous" accesskey="p" href="#Glyph-lookup">Glyph lookup</a>,
Up:&nbsp;<a rel="up" accesskey="u" href="#TeX-support">TeX support</a>
@@ -4029,8 +4036,8 @@ Up:&nbsp;<a rel="up" accesskey="u" href="#TeX-support">TeX support</a>
<h3 class="section">4.4 Suppressing warnings</h3>
-<p><a name="index-warnings_002c-suppressing-774"></a><a name="index-suppressing-warnings-775"></a>
-<a name="index-TEX_005fHUSH-776"></a>Kpathsea provides a way to suppress selected usually-harmless warnings;
+<p><a name="index-warnings_002c-suppressing-783"></a><a name="index-suppressing-warnings-784"></a>
+<a name="index-TEX_005fHUSH-785"></a>Kpathsea provides a way to suppress selected usually-harmless warnings;
this is useful at large sites where most users are not administrators,
and thus the warnings are merely a source of confusion, not a help. To
do this, you set the environment variable or configuration file value
@@ -4038,19 +4045,19 @@ do this, you set the environment variable or configuration file value
possibilities:
<dl>
-<dt>&lsquo;<samp><span class="samp">all</span></samp>&rsquo;<a name="index-all-777"></a><dd>Suppress everything possible.
+<dt>&lsquo;<samp><span class="samp">all</span></samp>&rsquo;<a name="index-all-786"></a><dd>Suppress everything possible.
- <br><dt>&lsquo;<samp><span class="samp">checksum</span></samp>&rsquo;<a name="index-checksum-778"></a><dd><a name="index-mismatched-checksum-warnings-779"></a>Suppress mismatched font checksum warnings.
+ <br><dt>&lsquo;<samp><span class="samp">checksum</span></samp>&rsquo;<a name="index-checksum-787"></a><dd><a name="index-mismatched-checksum-warnings-788"></a>Suppress mismatched font checksum warnings.
- <br><dt>&lsquo;<samp><span class="samp">lostchar</span></samp>&rsquo;<a name="index-lostchar-780"></a><dd><a name="index-missing-character-warnings-781"></a>Suppress warnings when a character is missing from a font that a DVI or
+ <br><dt>&lsquo;<samp><span class="samp">lostchar</span></samp>&rsquo;<a name="index-lostchar-789"></a><dd><a name="index-missing-character-warnings-790"></a>Suppress warnings when a character is missing from a font that a DVI or
VF file tries to typeset.
- <br><dt>&lsquo;<samp><span class="samp">none</span></samp>&rsquo;<a name="index-none-782"></a><dd>Don't suppress any warnings.
+ <br><dt>&lsquo;<samp><span class="samp">none</span></samp>&rsquo;<a name="index-none-791"></a><dd>Don't suppress any warnings.
- <br><dt>&lsquo;<samp><span class="samp">readable</span></samp>&rsquo;<a name="index-readable-783"></a><dd><a name="index-unreadable-file-warnings-784"></a>Suppress warnings about attempts to access a file whose permissions
+ <br><dt>&lsquo;<samp><span class="samp">readable</span></samp>&rsquo;<a name="index-readable-792"></a><dd><a name="index-unreadable-file-warnings-793"></a>Suppress warnings about attempts to access a file whose permissions
render it unreadable.
- <br><dt>&lsquo;<samp><span class="samp">special</span></samp>&rsquo;<a name="index-special-785"></a><dd><a name="index-unknown-special-warnings-786"></a><a name="index-g_t_005cspecial_0040r_007b_002c-suppressing-warnings-about_007d-787"></a>Suppresses warnings about an unimplemented or unparsable
+ <br><dt>&lsquo;<samp><span class="samp">special</span></samp>&rsquo;<a name="index-special-794"></a><dd><a name="index-unknown-special-warnings-795"></a><a name="index-g_t_005cspecial_0040r_007b_002c-suppressing-warnings-about_007d-796"></a>Suppresses warnings about an unimplemented or unparsable
&lsquo;<samp><span class="samp">\special</span></samp>&rsquo; command.
</dl>
@@ -4059,8 +4066,8 @@ variable value. Each driver implements its own checks where
appropriate.
<div class="node">
-<p><hr>
<a name="Programming"></a>
+<p><hr>
Next:&nbsp;<a rel="next" accesskey="n" href="#Index">Index</a>,
Previous:&nbsp;<a rel="previous" accesskey="p" href="#TeX-support">TeX support</a>,
Up:&nbsp;<a rel="up" accesskey="u" href="#Top">Top</a>
@@ -4080,8 +4087,8 @@ See <a href="#Introduction">Introduction</a>, for the conditions under which you
</ul>
<div class="node">
-<p><hr>
<a name="Programming-overview"></a>
+<p><hr>
Next:&nbsp;<a rel="next" accesskey="n" href="#Calling-sequence">Calling sequence</a>,
Up:&nbsp;<a rel="up" accesskey="u" href="#Programming">Programming</a>
@@ -4089,18 +4096,26 @@ Up:&nbsp;<a rel="up" accesskey="u" href="#Programming">Programming</a>
<h3 class="section">5.1 Programming overview</h3>
-<p><a name="index-programming-overview-788"></a><a name="index-overview-of-programming-with-Kpathsea-789"></a>
-Aside from this manual, your best source of information is the source to
-the programs I've modified to use Kpathsea (see <a href="#Introduction">Introduction</a>). Of
-those, Dviljk is probably the simplest, and hence a good place to start.
-Xdvik adds VF support and the complication of X resources. Dvipsk adds
-the complication of its own config files. Web2c is source code I also
-maintain, so it uses Kpathsea rather straightforwardly, but is of course
-complicated by the Web to C translation. Finally, Kpsewhich is a small
-utility program whose sole purpose is to exercise the main
+<p><a name="index-programming-overview-797"></a><a name="index-overview-of-programming-with-Kpathsea-798"></a>
+Aside from this manual, your best source of information is the source
+to the programs that use Kpathsea (see <a href="#Introduction">Introduction</a>). Of those,
+Dviljk is probably the simplest, and hence a good place to start.
+Xdvik adds VF support and the complication of X resources. Dvipsk
+adds the complication of its own config files. Web2c is source code I
+also maintain, so it uses Kpathsea rather straightforwardly, but is of
+course complicated by the Web to C translation. Finally, Kpsewhich is
+a small utility program whose sole purpose is to exercise the main
path-searching functionality.
- <p><a name="index-pathsearch_002eh-790"></a><a name="index-tex_002dfile_002eh-791"></a><a name="index-tex_002dglyph_002eh-792"></a><a name="index-kpathsea_002eh-793"></a>Beyond these examples, the <samp><span class="file">.h</span></samp> files in the Kpathsea source
+ <p><a name="index-re_002dentrant-API-799"></a><a name="index-API_002c-re_002dentrant-800"></a>When looking at these program sources, you should know that previous
+versions of the library had a different programming interface, to
+support re-entrancy. In that interface the library function names
+were prefixed with <code>kpse_</code> instead of <code>kpathsea_</code>, and they
+did not need an instance variable as first argument. This change was
+made in 2009. Some of the programs mentioned above may still be using
+the previous interface.
+
+ <p><a name="index-pathsearch_002eh-801"></a><a name="index-tex_002dfile_002eh-802"></a><a name="index-tex_002dglyph_002eh-803"></a><a name="index-kpathsea_002eh-804"></a>Beyond these examples, the <samp><span class="file">.h</span></samp> files in the Kpathsea source
describe the interfaces and functionality (and of course the <samp><span class="file">.c</span></samp>
files define the actual routines, which are the ultimate documentation).
<samp><span class="file">pathsearch.h</span></samp> declares the basic searching routine.
@@ -4109,13 +4124,13 @@ looking up particular kinds of files. In view of the way the headers
depend on each other, it is recommended to use <code>#include
&lt;kpathsea/kpathsea.h&gt;</code>, which includes every Kpathsea header.
- <p><a name="index-config_002eh-794"></a><a name="index-c_002dauto_002eh-795"></a>If you want to include only specific headers, you should still consider
+ <p><a name="index-config_002eh-805"></a><a name="index-c_002dauto_002eh-806"></a>If you want to include only specific headers, you should still consider
including <samp><span class="file">kpathsea/config.h</span></samp> before including any other Kpathsea
header, as it provides symbols used in the other headers. Note that
<samp><span class="file">kpathsea/config.h</span></samp> includes <samp><span class="file">kpathsea/c-auto.h</span></samp>, which is
generated by Autoconf.
- <p><a name="index-file-types_002c-registering-new-796"></a>The library provides no way for an external program to register new file
+ <p><a name="index-file-types_002c-registering-new-807"></a>The library provides no way for an external program to register new file
types: <samp><span class="file">tex-file.[ch]</span></samp> must be modified to do this. For example,
Kpathsea has support for looking up Dvips config files, even though no
program other than Dvips will likely ever want to do so. I felt this
@@ -4130,8 +4145,8 @@ contain libraries to read TFM, GF, and PK files, as do the programs
above, of course.
<div class="node">
-<p><hr>
<a name="Calling-sequence"></a>
+<p><hr>
Next:&nbsp;<a rel="next" accesskey="n" href="#Program_002dspecific-files">Program-specific files</a>,
Previous:&nbsp;<a rel="previous" accesskey="p" href="#Programming-overview">Programming overview</a>,
Up:&nbsp;<a rel="up" accesskey="u" href="#Programming">Programming</a>
@@ -4140,29 +4155,34 @@ Up:&nbsp;<a rel="up" accesskey="u" href="#Programming">Programming</a>
<h3 class="section">5.2 Calling sequence</h3>
-<p><a name="index-programming-with-Kpathsea-797"></a><a name="index-calling-sequence-798"></a>
+<p><a name="index-programming-with-Kpathsea-808"></a><a name="index-calling-sequence-809"></a>
The typical way to use Kpathsea in your program goes something like this:
<ol type=1 start=1>
- <li><a name="index-kpse_005fset_005fprogram_005fname-799"></a><a name="index-argv_005b0_005d-800"></a>Call <code>kpse_set_program_name</code> with <code>argv[0]</code> as the first
-argument; the second argument is a string or <code>NULL</code>. The second
+ <li><a name="index-kpathsea_005fnew-810"></a>Call <code>kpathsea_new</code> to create a new library instance. This variable
+must be passed as the first argument to all the following library functions.
+The rest of this manual will be using <code>kpse</code> as a placeholder for
+the name of this variable.
+
+ <li><a name="index-kpathsea_005fset_005fprogram_005fname-811"></a><a name="index-argv_005b0_005d-812"></a>Call <code>kpathsea_set_program_name</code> with <code>argv[0]</code> as the second
+argument; the third argument is a string or <code>NULL</code>. The third
argument is used by Kpathsea as the program name for the
<code>.</code><var>program</var> feature of config files (see <a href="#Config-files">Config files</a>).
-If the second argument is <code>NULL</code>, the value of the first argument
+If the third argument is <code>NULL</code>, the value of the second argument
is used. This function must be called before any other use of the
Kpathsea library.
- <p><a name="index-program_005finvocation_005fname-801"></a><a name="index-program_005finvocation_005fshort_005fname-802"></a><a name="index-kpse_005fprogram_005fname-803"></a><a name="index-error-message-macros-804"></a><code>kpse_set_program_name</code> always sets the global variables
-<code>program_invocation_name</code> and <code>program_invocation_short_name</code>.
+ <p><a name="index-kpse_002d_003einvocation_005fname-813"></a><a name="index-kpse_002d_003einvocation_005fshort_005fname-814"></a><a name="index-kpse_002d_003eprogram_005fname-815"></a><a name="index-error-message-macros-816"></a><code>kpathsea_set_program_name</code> always sets the variables
+<code>kpse-&gt;invocation_name</code> and <code>kpse-&gt;invocation_short_name</code>.
These variables are used in the error message macros defined in
-<samp><span class="file">kpathsea/lib.h</span></samp>. It sets the global variable
-<code>kpse_program_name</code> to the program name it uses.
+<samp><span class="file">kpathsea/lib.h</span></samp>. It sets the variable
+<code>kpse-&gt;program_name</code> to the program name it uses.
- <p><a name="index-KPATHSEA_005fDEBUG-805"></a>It also initializes debugging options based on the environment
+ <p><a name="index-KPATHSEA_005fDEBUG-817"></a>It also initializes debugging options based on the environment
variable <code>KPATHSEA_DEBUG</code> (if that is set).
- <p><a name="index-SELFAUTOLOC-806"></a><a name="index-SELFAUTODIR-807"></a><a name="index-SELFAUTOPARENT-808"></a><a name="index-symlinks_002c-resolving-809"></a><a name="index-expanding-symlinks-810"></a>Finally, it sets the variables <code>SELFAUTOLOC</code>, <code>SELFAUTODIR</code>
+ <p><a name="index-SELFAUTOLOC-818"></a><a name="index-SELFAUTODIR-819"></a><a name="index-SELFAUTOPARENT-820"></a><a name="index-symlinks_002c-resolving-821"></a><a name="index-expanding-symlinks-822"></a>Finally, it sets the environment variables <code>SELFAUTOLOC</code>, <code>SELFAUTODIR</code>
and <code>SELFAUTOPARENT</code> to the location, parent and grandparent
directory of the executable, removing <samp><span class="file">.</span></samp> and <samp><span class="file">..</span></samp> path
elements and resolving symbolic links. These are used in the default
@@ -4170,27 +4190,20 @@ configuration file to allow people to invoke TeX from anywhere. You
can use &lsquo;<samp><span class="samp">kpsewhich --expand-var=\$SELFAUTOLOC</span></samp>&rsquo;, etc., to see the
values.
- <li><a name="index-kpse_005fset_005fprogname-811"></a><a name="index-argv_005b0_005d-812"></a>The <code>kpse_set_progname</code> is deprecated. A call to
-<code>kpse_set_progname</code> with <code>argv[0]</code> is equivalent to a call of
-<code>kpse_set_program_name</code> with first argument <code>argv[0]</code> and
-second argument <code>NULL</code>. The function is deprecated because it
-cannot ensure that the <code>.</code><var>program</var> feature of config files
-will always work (see <a href="#Config-files">Config files</a>).
-
- <li><a name="index-kpathsea_005fdebug-_0040r_007bvariable_007d-813"></a><a name="index-debugging-options_002c-in-Kpathsea_002dusing-program-814"></a>Set debugging options. See <a href="#Debugging">Debugging</a>. If your program doesn't have a
+ <li><a name="index-kpse_002d_003edebug-_0040r_007bvariable_007d-823"></a><a name="index-debugging-options_002c-in-Kpathsea_002dusing-program-824"></a>Set debugging options. See <a href="#Debugging">Debugging</a>. If your program doesn't have a
debugging option already, you can define one and set
-<code>kpathsea_debug</code> to the number that the user supplies (as in Dviljk
+<code>kpse-&gt;debug</code> to the number that the user supplies (as in Dviljk
and Web2c), or you can just omit this altogether (people can always set
<code>KPATHSEA_DEBUG</code>). If you do have runtime debugging already, you
need to merge Kpathsea's options with yours (as in Dvipsk and Xdvik).
- <li><a name="index-client_005fpath-_0040r_007bin-_0040code_007bkpse_005fformat_005finfo_007d_007d-815"></a><a name="index-kpse_005fformat_005finfo-816"></a><a name="index-resident_002ec-817"></a><a name="index-config-files_002c-for-Kpathsea_002dusing-programs-818"></a>If your program has its own configuration files that can define search
+ <li><a name="index-client_005fpath-_0040r_007bin-_0040code_007bkpse_002d_003eformat_005finfo_007d_007d-825"></a><a name="index-kpse_002d_003eformat_005finfo-826"></a><a name="index-resident_002ec-827"></a><a name="index-config-files_002c-for-Kpathsea_002dusing-programs-828"></a>If your program has its own configuration files that can define search
paths, you should assign those paths to the <code>client_path</code> member in
-the appropriate element of the <code>kpse_format_info</code> array. (This
+the appropriate element of the <code>kpse-&gt;format_info</code> array. (This
array is indexed by file type; see <samp><span class="file">tex-file.h</span></samp>.) See
<samp><span class="file">resident.c</span></samp> in Dvipsk for an example.
- <li><a name="index-kpse_005finit_005fprog-819"></a><a name="index-proginit_002eh-820"></a>Call <code>kpse_init_prog</code> (see <samp><span class="file">proginit.c</span></samp>). It's useful for the
+ <li><a name="index-kpathsea_005finit_005fprog-829"></a><a name="index-proginit_002eh-830"></a>Call <code>kpathsea_init_prog</code> (see <samp><span class="file">proginit.c</span></samp>). It's useful for the
DVI drivers, at least, but for other programs it may be simpler to
extract the parts of it that actually apply. This does not initialize
any paths, it just looks for (and sets) certain environment variables
@@ -4198,47 +4211,50 @@ and other random information. (A search path is always initialized at
the first call to find a file of that type; this eliminates much useless
work, e.g., initializing the BibTeX search paths in a DVI driver.)
- <li><a name="index-kpse_005ffind_005f_002a-821"></a><a name="index-kpse_005ffind_005ffile-822"></a>The routine to actually find a file of type <var>format</var> is
-<code>kpse_find_</code><var>format</var>, defined in <samp><span class="file">tex-file.h</span></samp>. These are
-macros that expand to a call to <samp><span class="file">kpse_find_file</span></samp>. You can call,
-say, <code>kpse_find_tfm</code> after doing only the first of the
+ <li><a name="index-kpathsea_005ffind_005ffile-831"></a>The routine to actually find a file of type <var>format</var> is
+<samp><span class="file">kpathsea_find_file</span></samp>. You can call
+<code>kpathsea_find_file</code> after doing only the first and second of the
initialization steps above&mdash;Kpathsea automatically reads the
<samp><span class="file">texmf.cnf</span></samp> generic config files, looks for environment variables,
and does expansions at the first lookup.
- <li>To find PK and/or GF bitmap fonts, the routines are <code>kpse_find_pk</code>,
-<code>kpse_find_gf</code> and <code>kpse_find_glyph</code>, defined in
-<samp><span class="file">tex-glyph.h</span></samp>. These return a structure in addition to the
+ <li>To find PK and/or GF bitmap fonts, the routine
+is <code>kpathsea_find_glyph</code>, defined in
+<samp><span class="file">tex-glyph.h</span></samp>. This returns a structure in addition to the
resultant filename, because fonts can be found in so many ways. See the
documentation in the source.
- <li><a name="index-kpse_005fopen_005ffile-823"></a>To actually open a file, not just return a filename, call
-<code>kpse_open_file</code>. This function takes the name to look up and a
+ <li><a name="index-kpathsea_005fopen_005ffile-832"></a>To actually open a file, not just return a filename, call
+<code>kpathsea_open_file</code>. This function takes the name to look up and a
Kpathsea file format as arguments, and returns the usual <code>FILE *</code>.
It always assumes the file must exist, and thus will search the disk if
necessary (unless the search path specified &lsquo;<samp><span class="samp">!!</span></samp>&rsquo;, etc.). In other
words, if you are looking up a VF or some other file that need not
exist, don't use this.
+ <li><a name="index-kpathsea_005ffinish-833"></a>To close the kpathsea library instance you are using, call
+<code>kpathsea_finish</code>. This function closes any open log files and
+frees the memory used by the instance.
+
</ol>
- <p><a name="index-hash-table-routines-824"></a><a name="index-memory-allocation-routines-825"></a><a name="index-string-routines-826"></a><a name="index-reading-arbitrary_002dlength-lines-827"></a><a name="index-input-lines_002c-reading-828"></a><a name="index-lines_002c-reading-arbitrary_002dlength-829"></a>Kpathsea also provides many utility routines. Some are generic: hash
+ <p><a name="index-hash-table-routines-834"></a><a name="index-memory-allocation-routines-835"></a><a name="index-string-routines-836"></a><a name="index-reading-arbitrary_002dlength-lines-837"></a><a name="index-input-lines_002c-reading-838"></a><a name="index-lines_002c-reading-arbitrary_002dlength-839"></a>Kpathsea also provides many utility routines. Some are generic: hash
tables, memory allocation, string concatenation and copying, string
lists, reading input lines of arbitrary length, etc. Others are
filename-related: default path, tilde, and variable expansion,
<code>stat</code> calls, etc. (Perhaps someday I'll move the former to a
separate library.)
- <p><a name="index-c_002d_002a_002eh-830"></a><a name="index-autoconf_0040r_007b_002c-recommended_007d-831"></a>The <samp><span class="file">c-*.h</span></samp> header files can also help your program adapt to many
+ <p><a name="index-c_002d_002a_002eh-840"></a><a name="index-autoconf_0040r_007b_002c-recommended_007d-841"></a>The <samp><span class="file">c-*.h</span></samp> header files can also help your program adapt to many
different systems. You will almost certainly want to use Autoconf for
configuring your software if you use Kpathsea; I strongly recommend
using Autoconf regardless. It is available from
<a href="ftp://prep.ai.mit.edu/pub/gnu/">ftp://prep.ai.mit.edu/pub/gnu/</a>.
<div class="node">
-<p><hr>
<a name="Program-specific-files"></a>
<a name="Program_002dspecific-files"></a>
+<p><hr>
Next:&nbsp;<a rel="next" accesskey="n" href="#Programming-with-config-files">Programming with config files</a>,
Previous:&nbsp;<a rel="previous" accesskey="p" href="#Calling-sequence">Calling sequence</a>,
Up:&nbsp;<a rel="up" accesskey="u" href="#Programming">Programming</a>
@@ -4262,12 +4278,12 @@ That is to say, the name of the variable is constructed by converting
the name of the program to upper case, and appending <code>INPUTS</code>.
<p>The only difference between these two formats is whether
-<code>kpse_open_file</code> will open the files it finds in text or binary
+<code>kpathsea_open_file</code> will open the files it finds in text or binary
mode.
<div class="node">
-<p><hr>
<a name="Programming-with-config-files"></a>
+<p><hr>
Previous:&nbsp;<a rel="previous" accesskey="p" href="#Program_002dspecific-files">Program-specific files</a>,
Up:&nbsp;<a rel="up" accesskey="u" href="#Programming">Programming</a>
@@ -4275,34 +4291,34 @@ Up:&nbsp;<a rel="up" accesskey="u" href="#Programming">Programming</a>
<h3 class="section">5.4 Programming with config files</h3>
-<p><a name="index-programming-with-config-files-832"></a><a name="index-config-files_002c-programming-with-833"></a>
+<p><a name="index-programming-with-config-files-842"></a><a name="index-config-files_002c-programming-with-843"></a>
You can (and probably should) use the same <code>texmf.cnf</code>
configuration file that Kpathsea uses for your program. This helps
installers by keeping all configuration in one place.
- <p><a name="index-kpse_005fvar_005fvalue-834"></a><a name="index-variable_002eh-835"></a><a name="index-shell_005fescape_0040r_007b_002c-example-for-code_007d-836"></a>To retrieve a value <var>var</var> from config files, the best way is to call
-<code>kpse_var_value</code> on the string <var>var</var>. This will look
+ <p><a name="index-kpathsae_005fvar_005fvalue-844"></a><a name="index-variable_002eh-845"></a><a name="index-shell_005fescape_0040r_007b_002c-example-for-code_007d-846"></a>To retrieve a value <var>var</var> from config files, the best way is to call
+<code>kpathsea_var_value</code> on the string <var>var</var>. This will look
first for an environment variable <var>var</var>, then a config file value.
The result will be the value found or &lsquo;<samp><span class="samp">NULL</span></samp>&rsquo;. This function is
declared in <samp><span class="file">kpathsea/variable.h</span></samp>. For an example, see the
<code>shell_escape</code> code in <samp><span class="file">web2c/lib/texmfmp.c</span></samp>.
<p>The routine to do variable expansion in the context of a search path (as
-opposed to simply retrieving a value) is <code>kpse_var_expand</code>, also
+opposed to simply retrieving a value) is <code>kpathsea_var_expand</code>, also
declared in <samp><span class="file">kpathsea/variable.h</span></samp>. It's generally only necessary
to set the search path structure components as explained in the previous
section, rather than using this yourself.
- <p><a name="index-kpse_005fcnf_005fget-837"></a><a name="index-cnf_002eh-838"></a>If for some reason you want to retrieve a value <em>only</em> from a
+ <p><a name="index-kpathsea_005fcnf_005fget-847"></a><a name="index-cnf_002eh-848"></a>If for some reason you want to retrieve a value <em>only</em> from a
config file, not automatically looking for a corresponding environment
-variable, call <code>kpse_cnf_get</code> (declared in <samp><span class="file">kpathsea/cnf.h</span></samp>)
+variable, call <code>kpathsea_cnf_get</code> (declared in <samp><span class="file">kpathsea/cnf.h</span></samp>)
with the string <var>var</var>.
<p>No initialization calls are needed.
<div class="node">
-<p><hr>
<a name="Index"></a>
+<p><hr>
Previous:&nbsp;<a rel="previous" accesskey="p" href="#Programming">Programming</a>,
Up:&nbsp;<a rel="up" accesskey="u" href="#Top">Top</a>
@@ -4311,824 +4327,832 @@ Up:&nbsp;<a rel="up" accesskey="u" href="#Top">Top</a>
<h2 class="unnumbered">Index</h2>
<ul class="index-cp" compact>
-<li><a href="#index-g_t_0021_0021-_0040r_007bin-path-specifications_007d-569"><code>!! </code><span class="roman">in path specifications</span></a>: <a href="#ls_002dR">ls-R</a></li>
-<li><a href="#index-g_t_0024-_0040r_007bexpansion_007d-515"><code>$ </code><span class="roman">expansion</span></a>: <a href="#Variable-expansion">Variable expansion</a></li>
-<li><a href="#index-g_t_002d_002dall-579"><code>--all</code></a>: <a href="#Path-searching-options">Path searching options</a></li>
-<li><a href="#index-g_t_002d_002dcolor_003dtty-556"><code>--color=tty</code></a>: <a href="#ls_002dR">ls-R</a></li>
-<li><a href="#index-g_t_002d_002ddebug_003d_0040var_007bnum_007d-607"><code>--debug=</code><var>num</var></a>: <a href="#Auxiliary-tasks">Auxiliary tasks</a></li>
-<li><a href="#index-g_t_002d_002ddisable_002dstatic-111"><code>--disable-static</code></a>: <a href="#configure-options">configure options</a></li>
-<li><a href="#index-g_t_002d_002ddpi_003d_0040var_007bnum_007d-581"><code>--dpi=</code><var>num</var></a>: <a href="#Path-searching-options">Path searching options</a></li>
-<li><a href="#index-g_t_002d_002denable-_0040r_007boptions_007d-107"><code>--enable </code><span class="roman">options</span></a>: <a href="#configure-options">configure options</a></li>
-<li><a href="#index-g_t_002d_002denable_002dmaintainer_002dmode-112"><code>--enable-maintainer-mode</code></a>: <a href="#configure-options">configure options</a></li>
-<li><a href="#index-g_t_002d_002denable_002dshared-140"><code>--enable-shared</code></a>: <a href="#Shared-library">Shared library</a></li>
-<li><a href="#index-g_t_002d_002denable_002dshared-110"><code>--enable-shared</code></a>: <a href="#configure-options">configure options</a></li>
-<li><a href="#index-g_t_002d_002dengine_003d_0040var_007bname_007d-584"><code>--engine=</code><var>name</var></a>: <a href="#Path-searching-options">Path searching options</a></li>
-<li><a href="#index-g_t_002d_002dexpand_002dbraces_003d_0040var_007bstring_007d-609"><code>--expand-braces=</code><var>string</var></a>: <a href="#Auxiliary-tasks">Auxiliary tasks</a></li>
-<li><a href="#index-g_t_002d_002dexpand_002dpath_003d_0040var_007bstring_007d-611"><code>--expand-path=</code><var>string</var></a>: <a href="#Auxiliary-tasks">Auxiliary tasks</a></li>
-<li><a href="#index-g_t_002d_002dexpand_002dvar_003d_0040var_007bstring_007d-610"><code>--expand-var=</code><var>string</var></a>: <a href="#Auxiliary-tasks">Auxiliary tasks</a></li>
-<li><a href="#index-g_t_002d_002dformat_003d_0040var_007bname_007d-586"><code>--format=</code><var>name</var></a>: <a href="#Path-searching-options">Path searching options</a></li>
-<li><a href="#index-g_t_002d_002dhelp-614"><code>--help</code></a>: <a href="#Standard-options">Standard options</a></li>
-<li><a href="#index-g_t_002d_002dinteractive-587"><code>--interactive</code></a>: <a href="#Path-searching-options">Path searching options</a></li>
-<li><a href="#index-g_t_002d_002dmode_003d_0040var_007bstring_007d-591"><code>--mode=</code><var>string</var></a>: <a href="#Path-searching-options">Path searching options</a></li>
-<li><a href="#index-g_t_002d_002dmust_002dexist-592"><code>--must-exist</code></a>: <a href="#Path-searching-options">Path searching options</a></li>
-<li><a href="#index-g_t_002d_002dpath_003d_0040var_007bstring_007d-593"><code>--path=</code><var>string</var></a>: <a href="#Path-searching-options">Path searching options</a></li>
-<li><a href="#index-g_t_002d_002dprogname_003d_0040var_007bname_007d-594"><code>--progname=</code><var>name</var></a>: <a href="#Path-searching-options">Path searching options</a></li>
-<li><a href="#index-g_t_002d_002dshow_002dpath_003d_0040var_007bname_007d-612"><code>--show-path=</code><var>name</var></a>: <a href="#Auxiliary-tasks">Auxiliary tasks</a></li>
-<li><a href="#index-g_t_002d_002dsrcdir_0040r_007b_002c-for-building-multiple-architectures_007d-130"><code>--srcdir</code><span class="roman">, for building multiple architectures</span></a>: <a href="#configure-scenarios">configure scenarios</a></li>
-<li><a href="#index-g_t_002d_002dsubdir_003d_0040var_007bstring_007d-595"><code>--subdir=</code><var>string</var></a>: <a href="#Path-searching-options">Path searching options</a></li>
-<li><a href="#index-g_t_002d_002dvar_002dvalue_003d_0040var_007bvariable_007d-608"><code>--var-value=</code><var>variable</var></a>: <a href="#Auxiliary-tasks">Auxiliary tasks</a></li>
-<li><a href="#index-g_t_002d_002dversion-615"><code>--version</code></a>: <a href="#Standard-options">Standard options</a></li>
-<li><a href="#index-g_t_002d_002dwith-_0040r_007boptions_007d-106"><code>--with </code><span class="roman">options</span></a>: <a href="#configure-options">configure options</a></li>
-<li><a href="#index-g_t_002d_002dwith_002dmktextex_002ddefault-201"><code>--with-mktextex-default</code></a>: <a href="#mktex-configuration">mktex configuration</a></li>
-<li><a href="#index-g_t_002d_002dwithout_002dmktexfmt_002ddefault-195"><code>--without-mktexfmt-default</code></a>: <a href="#mktex-configuration">mktex configuration</a></li>
-<li><a href="#index-g_t_002d_002dwithout_002dmktexmf_002ddefault-196"><code>--without-mktexmf-default</code></a>: <a href="#mktex-configuration">mktex configuration</a></li>
-<li><a href="#index-g_t_002d_002dwithout_002dmktexocp_002ddefault-197"><code>--without-mktexocp-default</code></a>: <a href="#mktex-configuration">mktex configuration</a></li>
-<li><a href="#index-g_t_002d_002dwithout_002dmktexofm_002ddefault-198"><code>--without-mktexofm-default</code></a>: <a href="#mktex-configuration">mktex configuration</a></li>
-<li><a href="#index-g_t_002d_002dwithout_002dmktexpk_002ddefault-199"><code>--without-mktexpk-default</code></a>: <a href="#mktex-configuration">mktex configuration</a></li>
-<li><a href="#index-g_t_002d_002dwithout_002dmktextfm_002ddefault-200"><code>--without-mktextfm-default</code></a>: <a href="#mktex-configuration">mktex configuration</a></li>
-<li><a href="#index-g_t_002d1-_0040r_007bdebugging-value_007d-353"><code>-1 </code><span class="roman">debugging value</span></a>: <a href="#Debugging">Debugging</a></li>
-<li><a href="#index-g_t_002dA-_0040r_007boption-to-_0040code_007bls_007d_007d-558"><code>-A </code><span class="roman">option to </span><code>ls</code></a>: <a href="#ls_002dR">ls-R</a></li>
-<li><a href="#index-g_t_002dBdynamic-445"><code>-Bdynamic</code></a>: <a href="#ShellWidgetClass">ShellWidgetClass</a></li>
-<li><a href="#index-g_t_002dBstatic-444"><code>-Bstatic</code></a>: <a href="#ShellWidgetClass">ShellWidgetClass</a></li>
-<li><a href="#index-g_t_002dD-_0040var_007bnum_007d-582"><code>-D </code><var>num</var></a>: <a href="#Path-searching-options">Path searching options</a></li>
-<li><a href="#index-g_t_002ddynamic-443"><code>-dynamic</code></a>: <a href="#ShellWidgetClass">ShellWidgetClass</a></li>
-<li><a href="#index-g_t_002dg_0040r_007b_002c-compiling-without_007d-136"><code>-g</code><span class="roman">, compiling without</span></a>: <a href="#configure-scenarios">configure scenarios</a></li>
-<li><a href="#index-g_t_002dL-_0040r_007boption-to-_0040code_007bls_007d_007d-564"><code>-L </code><span class="roman">option to </span><code>ls</code></a>: <a href="#ls_002dR">ls-R</a></li>
-<li><a href="#index-g_t_002dmktex_003d_0040var_007bfiletype_007d-589"><code>-mktex=</code><var>filetype</var></a>: <a href="#Path-searching-options">Path searching options</a></li>
-<li><a href="#index-g_t_002dno_002dmktex_003d_0040var_007bfiletype_007d-590"><code>-no-mktex=</code><var>filetype</var></a>: <a href="#Path-searching-options">Path searching options</a></li>
-<li><a href="#index-g_t_002dO_0040r_007b_002c-compiling-with_007d-135"><code>-O</code><span class="roman">, compiling with</span></a>: <a href="#configure-scenarios">configure scenarios</a></li>
-<li><a href="#index-g_t_002dstatic-442"><code>-static</code></a>: <a href="#ShellWidgetClass">ShellWidgetClass</a></li>
-<li><a href="#index-g_t_002e-_0040r_007bdirectories_002c-ignored_007d-561"><code>. </code><span class="roman">directories, ignored</span></a>: <a href="#ls_002dR">ls-R</a></li>
-<li><a href="#index-g_t_002e-_0040r_007bfiles_007d-560"><code>. </code><span class="roman">files</span></a>: <a href="#ls_002dR">ls-R</a></li>
-<li><a href="#index-g_t_002e2602gf-399"><code>.2602gf</code></a>: <a href="#Unable-to-generate-fonts">Unable to generate fonts</a></li>
-<li><a href="#index-g_t_002eafm-622"><code>.afm</code></a>: <a href="#Supported-file-formats">Supported file formats</a></li>
-<li><a href="#index-g_t_002ebase-624"><code>.base</code></a>: <a href="#Supported-file-formats">Supported file formats</a></li>
-<li><a href="#index-g_t_002ebib-627"><code>.bib</code></a>: <a href="#Supported-file-formats">Supported file formats</a></li>
-<li><a href="#index-g_t_002ebst-630"><code>.bst</code></a>: <a href="#Supported-file-formats">Supported file formats</a></li>
-<li><a href="#index-g_t_002ecmap-632"><code>.cmap</code></a>: <a href="#Supported-file-formats">Supported file formats</a></li>
-<li><a href="#index-g_t_002ecnf-634"><code>.cnf</code></a>: <a href="#Supported-file-formats">Supported file formats</a></li>
-<li><a href="#index-g_t_002eenc-641"><code>.enc</code></a>: <a href="#Supported-file-formats">Supported file formats</a></li>
-<li><a href="#index-g_t_002eeps-650"><code>.eps</code></a>: <a href="#Supported-file-formats">Supported file formats</a></li>
-<li><a href="#index-g_t_002eepsi-651"><code>.epsi</code></a>: <a href="#Supported-file-formats">Supported file formats</a></li>
-<li><a href="#index-g_t_002efmt-643"><code>.fmt</code></a>: <a href="#Supported-file-formats">Supported file formats</a></li>
-<li><a href="#index-g_t_002eist-654"><code>.ist</code></a>: <a href="#Supported-file-formats">Supported file formats</a></li>
-<li><a href="#index-g_t_002elig-657"><code>.lig</code></a>: <a href="#Supported-file-formats">Supported file formats</a></li>
-<li><a href="#index-g_t_002emap-661"><code>.map</code></a>: <a href="#Supported-file-formats">Supported file formats</a></li>
-<li><a href="#index-g_t_002emem-663"><code>.mem</code></a>: <a href="#Supported-file-formats">Supported file formats</a></li>
-<li><a href="#index-g_t_002emf-667"><code>.mf</code></a>: <a href="#Supported-file-formats">Supported file formats</a></li>
-<li><a href="#index-g_t_002emft-671"><code>.mft</code></a>: <a href="#Supported-file-formats">Supported file formats</a></li>
-<li><a href="#index-g_t_002emp-674"><code>.mp</code></a>: <a href="#Supported-file-formats">Supported file formats</a></li>
-<li><a href="#index-g_t_002eocp-678"><code>.ocp</code></a>: <a href="#Supported-file-formats">Supported file formats</a></li>
-<li><a href="#index-g_t_002eofm-680"><code>.ofm</code></a>: <a href="#Supported-file-formats">Supported file formats</a></li>
-<li><a href="#index-g_t_002eopl-683"><code>.opl</code></a>: <a href="#Supported-file-formats">Supported file formats</a></li>
-<li><a href="#index-g_t_002eotp-684"><code>.otp</code></a>: <a href="#Supported-file-formats">Supported file formats</a></li>
-<li><a href="#index-g_t_002eovf-686"><code>.ovf</code></a>: <a href="#Supported-file-formats">Supported file formats</a></li>
-<li><a href="#index-g_t_002eovp-688"><code>.ovp</code></a>: <a href="#Supported-file-formats">Supported file formats</a></li>
-<li><a href="#index-g_t_002epfa-717"><code>.pfa</code></a>: <a href="#Supported-file-formats">Supported file formats</a></li>
-<li><a href="#index-g_t_002epfb-718"><code>.pfb</code></a>: <a href="#Supported-file-formats">Supported file formats</a></li>
-<li><a href="#index-g_t_002epk-691"><code>.pk</code></a>: <a href="#Supported-file-formats">Supported file formats</a></li>
-<li><a href="#index-g_t_002epool-669"><code>.pool</code></a>: <a href="#Supported-file-formats">Supported file formats</a></li>
-<li><a href="#index-g_t_002epro-696"><code>.pro</code></a>: <a href="#Supported-file-formats">Supported file formats</a></li>
-<li><a href="#index-g_t_002erhosts_0040r_007b_002c-writable-by-_0040TeX_007b_007d_007d-259"><code>.rhosts</code><span class="roman">, writable by TeX</span></a>: <a href="#Security">Security</a></li>
-<li><a href="#index-g_t_002esfd-699"><code>.sfd</code></a>: <a href="#Supported-file-formats">Supported file formats</a></li>
-<li><a href="#index-g_t_002etex-701"><code>.tex</code></a>: <a href="#Supported-file-formats">Supported file formats</a></li>
-<li><a href="#index-g_t_002etex-_0040r_007bfile_002c-included-in-_0040file_007bls_002dR_007d_007d-562"><code>.tex </code><span class="roman">file, included in </span><samp><span class="file">ls-R</span></samp></a>: <a href="#ls_002dR">ls-R</a></li>
-<li><a href="#index-g_t_002etfm-710"><code>.tfm</code></a>: <a href="#Supported-file-formats">Supported file formats</a></li>
-<li><a href="#index-g_t_002ettc-715"><code>.ttc</code></a>: <a href="#Supported-file-formats">Supported file formats</a></li>
-<li><a href="#index-g_t_002ettf-714"><code>.ttf</code></a>: <a href="#Supported-file-formats">Supported file formats</a></li>
-<li><a href="#index-g_t_002evf-724"><code>.vf</code></a>: <a href="#Supported-file-formats">Supported file formats</a></li>
-<li><a href="#index-g_t_002ew-636"><code>.w</code></a>: <a href="#Supported-file-formats">Supported file formats</a></li>
-<li><a href="#index-g_t_002eweb-637"><code>.web</code></a>: <a href="#Supported-file-formats">Supported file formats</a></li>
-<li><a href="#index-g_t_002f-_0040r_007bmay-not-be-_002f_007d-457"><code>/ </code><span class="roman">may not be /</span></a>: <a href="#Searching-overview">Searching overview</a></li>
-<li><a href="#index-g_t_002f_0040r_007b_002c-trailing-in-home-directory_007d-531"><code>/</code><span class="roman">, trailing in home directory</span></a>: <a href="#Tilde-expansion">Tilde expansion</a></li>
-<li><a href="#index-g_t_002f_002f-538"><code>//</code></a>: <a href="#Subdirectory-expansion">Subdirectory expansion</a></li>
-<li><a href="#index-g_t_002fafs_002f_0040dots_007b_007d-_0040r_007b_002c-installing-into_007d-174"><code>/afs/... </code><span class="roman">, installing into</span></a>: <a href="#Installing-files">Installing files</a></li>
-<li><a href="#index-g_t_002fetc_002fprofile-387"><code>/etc/profile</code></a>: <a href="#Unable-to-find-files">Unable to find files</a></li>
-<li><a href="#index-g_t_002fetc_002fprofile-_0040r_007band-aliases_007d-557"><code>/etc/profile </code><span class="roman">and aliases</span></a>: <a href="#ls_002dR">ls-R</a></li>
-<li><a href="#index-g_t_002fvar_002ftmp_002ftexfonts-230"><code>/var/tmp/texfonts</code></a>: <a href="#mktex-configuration">mktex configuration</a></li>
-<li><a href="#index-g_t2602gf-400"><code>2602gf</code></a>: <a href="#Unable-to-generate-fonts">Unable to generate fonts</a></li>
-<li><a href="#index-g_t8_002e3-filenames_002c-using-212">8.3 filenames, using</a>: <a href="#mktex-configuration">mktex configuration</a></li>
-<li><a href="#index-g_t_003a-_0040r_007bmay-not-be-_003a_007d-456"><code>: </code><span class="roman">may not be :</span></a>: <a href="#Searching-overview">Searching overview</a></li>
-<li><a href="#index-g_t_003a_003a-_0040r_007bexpansion_007d-506"><code>:: </code><span class="roman">expansion</span></a>: <a href="#Default-expansion">Default expansion</a></li>
-<li><a href="#index-g_t_0040_0040_0040var_007bvar_007d_0040_0040-substitutions-88">@<var>var</var>@ substitutions</a>: <a href="#Running-configure">Running configure</a></li>
-<li><a href="#index-g_t_005c_0040r_007b_002c-line-continuation-in-_0040file_007btexmf_002ecnf_007d_007d-498"><code>\</code><span class="roman">, line continuation in </span><samp><span class="file">texmf.cnf</span></samp></a>: <a href="#Config-files">Config files</a></li>
-<li><a href="#index-g_t_005copenin-467"><code>\openin</code></a>: <a href="#Searching-overview">Searching overview</a></li>
-<li><a href="#index-g_t_005cspecial_0040r_007b_002c-suppressing-warnings-about_007d-787"><code>\special</code><span class="roman">, suppressing warnings about</span></a>: <a href="#Suppressing-warnings">Suppressing warnings</a></li>
-<li><a href="#index-absolute-filenames-469">absolute filenames</a>: <a href="#Searching-overview">Searching overview</a></li>
-<li><a href="#index-ac_005finclude_0040r_007b_002c-Autoconf-extension_007d-87"><code>ac_include</code><span class="roman">, Autoconf extension</span></a>: <a href="#Running-configure">Running configure</a></li>
-<li><a href="#index-access-warnings-475">access warnings</a>: <a href="#Searching-overview">Searching overview</a></li>
-<li><a href="#index-Acorn-_0040TeX_007b_007d-implementations-304">Acorn TeX implementations</a>: <a href="#Other-TeX-packages">Other TeX packages</a></li>
-<li><a href="#index-AFMFONTS-623"><code>AFMFONTS</code></a>: <a href="#Supported-file-formats">Supported file formats</a></li>
-<li><a href="#index-AFS-172">AFS</a>: <a href="#Installing-files">Installing files</a></li>
-<li><a href="#index-AIX-4_002e1-_0040code_007bconfigure_007d-error-422">AIX 4.1 <code>configure</code> error</a>: <a href="#Empty-Makefiles">Empty Makefiles</a></li>
-<li><a href="#index-AIX-shells-and-_0040code_007bconfigure_007d-97">AIX shells and <code>configure</code></a>: <a href="#configure-shells">configure shells</a></li>
-<li><a href="#index-aliases-for-fonts-754">aliases for fonts</a>: <a href="#Fontmap">Fontmap</a></li>
-<li><a href="#index-aliases_002c-for-filenames-572">aliases, for filenames</a>: <a href="#Filename-aliases">Filename aliases</a></li>
-<li><a href="#index-all-777"><code>all</code></a>: <a href="#Suppressing-warnings">Suppressing warnings</a></li>
-<li><a href="#index-all-matches_002c-finding-580">all matches, finding</a>: <a href="#Path-searching-options">Path searching options</a></li>
-<li><a href="#index-alphabetical-order_002c-not-541">alphabetical order, not</a>: <a href="#Subdirectory-expansion">Subdirectory expansion</a></li>
-<li><a href="#index-Amiga-support-43">Amiga support</a>: <a href="#Custom-installation">Custom installation</a></li>
-<li><a href="#index-Amiga-_0040TeX_007b_007d-implementations-303">Amiga TeX implementations</a>: <a href="#Other-TeX-packages">Other TeX packages</a></li>
-<li><a href="#index-Andrew-File-System_002c-installing-with-173">Andrew File System, installing with</a>: <a href="#Installing-files">Installing files</a></li>
-<li><a href="#index-announcement-mailing-list-335">announcement mailing list</a>: <a href="#Mailing-lists">Mailing lists</a></li>
-<li><a href="#index-ANSI-C-413">ANSI C</a>: <a href="#TeX-or-Metafont-failing">TeX or Metafont failing</a></li>
-<li><a href="#index-append_002donly-directories-and-_0040code_007bmktexpk_007d-263">append-only directories and <code>mktexpk</code></a>: <a href="#Security">Security</a></li>
-<li><a href="#index-appendonlydir-208"><code>appendonlydir</code></a>: <a href="#mktex-configuration">mktex configuration</a></li>
-<li><a href="#index-architecture_002d_0028in_0029dependent-files_002c-installing-only-168">architecture-(in)dependent files, installing only</a>: <a href="#Installing-files">Installing files</a></li>
-<li><a href="#index-architectures_002c-compiling-multiple-128">architectures, compiling multiple</a>: <a href="#configure-scenarios">configure scenarios</a></li>
-<li><a href="#index-arguments-to-_0040file_007bmktex_007d-254">arguments to <samp><span class="file">mktex</span></samp></a>: <a href="#mktex-script-arguments">mktex script arguments</a></li>
-<li><a href="#index-argv_005b0_005d-800"><code>argv[0]</code></a>: <a href="#Calling-sequence">Calling sequence</a></li>
-<li><a href="#index-ash_0040r_007b_002c-losing-with-_0040code_007bconfigure_007d_007d-98"><code>ash</code><span class="roman">, losing with </span><code>configure</code></a>: <a href="#configure-shells">configure shells</a></li>
-<li><a href="#index-autoconf_0040r_007b_002c-recommended_007d-831"><code>autoconf</code><span class="roman">, recommended</span></a>: <a href="#Calling-sequence">Calling sequence</a></li>
-<li><a href="#index-automounter_002c-and-configuration-134">automounter, and configuration</a>: <a href="#configure-scenarios">configure scenarios</a></li>
-<li><a href="#index-automounter_002c-and-_0040file_007bls_002dR_007d-565">automounter, and <samp><span class="file">ls-R</span></samp></a>: <a href="#ls_002dR">ls-R</a></li>
-<li><a href="#index-auxiliary-tasks-606">auxiliary tasks</a>: <a href="#Auxiliary-tasks">Auxiliary tasks</a></li>
-<li><a href="#index-Babel-165">Babel</a>: <a href="#Running-make">Running make</a></li>
-<li><a href="#index-Babel-62">Babel</a>: <a href="#Kpathsea-application-distributions">Kpathsea application distributions</a></li>
-<li><a href="#index-Bach_002c-Johann-Sebastian-513">Bach, Johann Sebastian</a>: <a href="#Default-expansion">Default expansion</a></li>
-<li><a href="#index-backbone-of-CTAN-285">backbone of CTAN</a>: <a href="#Electronic-distribution">Electronic distribution</a></li>
-<li><a href="#index-backslash_002dnewline-495">backslash-newline</a>: <a href="#Config-files">Config files</a></li>
-<li><a href="#index-bash_0040r_007b_002c-recommended-for-running-_0040code_007bconfigure_007d_007d-93"><code>bash</code><span class="roman">, recommended for running </span><code>configure</code></a>: <a href="#configure-shells">configure shells</a></li>
-<li><a href="#index-basic-glyph-lookup-747">basic glyph lookup</a>: <a href="#Basic-glyph-lookup">Basic glyph lookup</a></li>
-<li><a href="#index-Berry_002c-Karl-16">Berry, Karl</a>: <a href="#History">History</a></li>
-<li><a href="#index-BIBINPUTS-628"><code>BIBINPUTS</code></a>: <a href="#Supported-file-formats">Supported file formats</a></li>
-<li><a href="#index-binary-mode_002c-for-file-transfers-292">binary mode, for file transfers</a>: <a href="#Electronic-distribution">Electronic distribution</a></li>
-<li><a href="#index-blank-lines_002c-in-_0040file_007btexmf_002ecnf_007d-494">blank lines, in <samp><span class="file">texmf.cnf</span></samp></a>: <a href="#Config-files">Config files</a></li>
-<li><a href="#index-brace-expansion-534">brace expansion</a>: <a href="#Brace-expansion">Brace expansion</a></li>
-<li><a href="#index-BSD-universe-160">BSD universe</a>: <a href="#Running-make">Running make</a></li>
-<li><a href="#index-bsh_0040r_007b_002c-ok-with-_0040code_007bconfigure_007d_007d-95"><code>bsh</code><span class="roman">, ok with </span><code>configure</code></a>: <a href="#configure-shells">configure shells</a></li>
-<li><a href="#index-BSTINPUTS-631"><code>BSTINPUTS</code></a>: <a href="#Supported-file-formats">Supported file formats</a></li>
-<li><a href="#index-bug-address-316">bug address</a>: <a href="#Reporting-bugs">Reporting bugs</a></li>
-<li><a href="#index-bug-checklist-318">bug checklist</a>: <a href="#Bug-checklist">Bug checklist</a></li>
-<li><a href="#index-bug-mailing-list-334">bug mailing list</a>: <a href="#Mailing-lists">Mailing lists</a></li>
-<li><a href="#index-bugs_002c-reporting-314">bugs, reporting</a>: <a href="#Reporting-bugs">Reporting bugs</a></li>
-<li><a href="#index-c_002d_002a_002eh-830"><code>c-*.h</code></a>: <a href="#Calling-sequence">Calling sequence</a></li>
-<li><a href="#index-c_002dauto_002eh-795"><code>c-auto.h</code></a>: <a href="#Programming-overview">Programming overview</a></li>
-<li><a href="#index-c_002dauto_002ein-85"><code>c-auto.in</code></a>: <a href="#Running-configure">Running configure</a></li>
-<li><a href="#index-cache-of-fonts_002c-local-261">cache of fonts, local</a>: <a href="#Security">Security</a></li>
-<li><a href="#index-calling-sequence-798">calling sequence</a>: <a href="#Calling-sequence">Calling sequence</a></li>
-<li><a href="#index-CC-113"><code>CC</code></a>: <a href="#configure-environment">configure environment</a></li>
-<li><a href="#index-cc-_0040r_007bwarnings_007d-449"><code>cc </code><span class="roman">warnings</span></a>: <a href="#Pointer-combination-warnings">Pointer combination warnings</a></li>
-<li><a href="#index-cc_0040r_007b_002c-compiling-with_007d-115"><code>cc</code><span class="roman">, compiling with</span></a>: <a href="#configure-environment">configure environment</a></li>
-<li><a href="#index-CD_002dROM-distributions-294">CD-ROM distributions</a>: <a href="#CD_002dROM-distribution">CD-ROM distribution</a></li>
-<li><a href="#index-CFLAGS-116"><code>CFLAGS</code></a>: <a href="#configure-environment">configure environment</a></li>
-<li><a href="#index-ChangeLog-_0040r_007bentry_007d-326"><code>ChangeLog </code><span class="roman">entry</span></a>: <a href="#Bug-checklist">Bug checklist</a></li>
-<li><a href="#index-checklist-for-bug-reports-317">checklist for bug reports</a>: <a href="#Bug-checklist">Bug checklist</a></li>
-<li><a href="#index-checksum-778"><code>checksum</code></a>: <a href="#Suppressing-warnings">Suppressing warnings</a></li>
-<li><a href="#index-circle-fonts-757">circle fonts</a>: <a href="#Fontmap">Fontmap</a></li>
-<li><a href="#index-clean-_0040r_007bMake-target_007d-179"><code>clean </code><span class="roman">Make target</span></a>: <a href="#Cleaning-up">Cleaning up</a></li>
-<li><a href="#index-client_005fpath-_0040r_007bin-_0040code_007bkpse_005fformat_005finfo_007d_007d-815"><code>client_path </code><span class="roman">in </span><code>kpse_format_info</code></a>: <a href="#Calling-sequence">Calling sequence</a></li>
-<li><a href="#index-CMAPFONTS-633"><code>CMAPFONTS</code></a>: <a href="#Supported-file-formats">Supported file formats</a></li>
-<li><a href="#index-cmr10_0040r_007b_002c-as-fallback-font_007d-772"><code>cmr10</code><span class="roman">, as fallback font</span></a>: <a href="#Fallback-font">Fallback font</a></li>
-<li><a href="#index-cmr10_002evf-466"><code>cmr10.vf</code></a>: <a href="#Searching-overview">Searching overview</a></li>
-<li><a href="#index-cnf_002ec-503"><code>cnf.c</code></a>: <a href="#Config-files">Config files</a></li>
-<li><a href="#index-cnf_002eh-838"><code>cnf.h</code></a>: <a href="#Programming-with-config-files">Programming with config files</a></li>
-<li><a href="#index-code-sharing-141">code sharing</a>: <a href="#Shared-library">Shared library</a></li>
-<li><a href="#index-color-printers_002c-configuring-36">color printers, configuring</a>: <a href="#Simple-installation">Simple installation</a></li>
-<li><a href="#index-comments_002c-in-fontmap-files-759">comments, in fontmap files</a>: <a href="#Fontmap">Fontmap</a></li>
-<li><a href="#index-comments_002c-in-_0040file_007btexmf_002ecnf_007d-493">comments, in <samp><span class="file">texmf.cnf</span></samp></a>: <a href="#Config-files">Config files</a></li>
+<li><a href="#index-g_t_0021_0021-_0040r_007bin-path-specifications_007d-566"><code>!! </code><span class="roman">in path specifications</span></a>: <a href="#ls_002dR">ls-R</a></li>
+<li><a href="#index-g_t_0024-_0040r_007bexpansion_007d-512"><code>$ </code><span class="roman">expansion</span></a>: <a href="#Variable-expansion">Variable expansion</a></li>
+<li><a href="#index-g_t_002d_002dall-576"><code>--all</code></a>: <a href="#Path-searching-options">Path searching options</a></li>
+<li><a href="#index-g_t_002d_002dcolor_003dtty-553"><code>--color=tty</code></a>: <a href="#ls_002dR">ls-R</a></li>
+<li><a href="#index-g_t_002d_002ddebug_003d_0040var_007bnum_007d-605"><code>--debug=</code><var>num</var></a>: <a href="#Auxiliary-tasks">Auxiliary tasks</a></li>
+<li><a href="#index-g_t_002d_002ddisable_002dstatic-110"><code>--disable-static</code></a>: <a href="#configure-options">configure options</a></li>
+<li><a href="#index-g_t_002d_002ddpi_003d_0040var_007bnum_007d-578"><code>--dpi=</code><var>num</var></a>: <a href="#Path-searching-options">Path searching options</a></li>
+<li><a href="#index-g_t_002d_002denable-_0040r_007boptions_007d-106"><code>--enable </code><span class="roman">options</span></a>: <a href="#configure-options">configure options</a></li>
+<li><a href="#index-g_t_002d_002denable_002dmaintainer_002dmode-111"><code>--enable-maintainer-mode</code></a>: <a href="#configure-options">configure options</a></li>
+<li><a href="#index-g_t_002d_002denable_002dshared-139"><code>--enable-shared</code></a>: <a href="#Shared-library">Shared library</a></li>
+<li><a href="#index-g_t_002d_002denable_002dshared-109"><code>--enable-shared</code></a>: <a href="#configure-options">configure options</a></li>
+<li><a href="#index-g_t_002d_002dengine_003d_0040var_007bname_007d-581"><code>--engine=</code><var>name</var></a>: <a href="#Path-searching-options">Path searching options</a></li>
+<li><a href="#index-g_t_002d_002dexpand_002dbraces_003d_0040var_007bstring_007d-607"><code>--expand-braces=</code><var>string</var></a>: <a href="#Auxiliary-tasks">Auxiliary tasks</a></li>
+<li><a href="#index-g_t_002d_002dexpand_002dpath_003d_0040var_007bstring_007d-609"><code>--expand-path=</code><var>string</var></a>: <a href="#Auxiliary-tasks">Auxiliary tasks</a></li>
+<li><a href="#index-g_t_002d_002dexpand_002dvar_003d_0040var_007bstring_007d-608"><code>--expand-var=</code><var>string</var></a>: <a href="#Auxiliary-tasks">Auxiliary tasks</a></li>
+<li><a href="#index-g_t_002d_002dformat_003d_0040var_007bname_007d-583"><code>--format=</code><var>name</var></a>: <a href="#Path-searching-options">Path searching options</a></li>
+<li><a href="#index-g_t_002d_002dhelp-612"><code>--help</code></a>: <a href="#Standard-options">Standard options</a></li>
+<li><a href="#index-g_t_002d_002dinteractive-584"><code>--interactive</code></a>: <a href="#Path-searching-options">Path searching options</a></li>
+<li><a href="#index-g_t_002d_002dmode_003d_0040var_007bstring_007d-588"><code>--mode=</code><var>string</var></a>: <a href="#Path-searching-options">Path searching options</a></li>
+<li><a href="#index-g_t_002d_002dmust_002dexist-589"><code>--must-exist</code></a>: <a href="#Path-searching-options">Path searching options</a></li>
+<li><a href="#index-g_t_002d_002dpath_003d_0040var_007bstring_007d-590"><code>--path=</code><var>string</var></a>: <a href="#Path-searching-options">Path searching options</a></li>
+<li><a href="#index-g_t_002d_002dprogname_003d_0040var_007bname_007d-591"><code>--progname=</code><var>name</var></a>: <a href="#Path-searching-options">Path searching options</a></li>
+<li><a href="#index-g_t_002d_002dshow_002dpath_003d_0040var_007bname_007d-610"><code>--show-path=</code><var>name</var></a>: <a href="#Auxiliary-tasks">Auxiliary tasks</a></li>
+<li><a href="#index-g_t_002d_002dsrcdir_0040r_007b_002c-for-building-multiple-architectures_007d-129"><code>--srcdir</code><span class="roman">, for building multiple architectures</span></a>: <a href="#configure-scenarios">configure scenarios</a></li>
+<li><a href="#index-g_t_002d_002dsubdir_003d_0040var_007bstring_007d-592"><code>--subdir=</code><var>string</var></a>: <a href="#Path-searching-options">Path searching options</a></li>
+<li><a href="#index-g_t_002d_002dvar_002dvalue_003d_0040var_007bvariable_007d-606"><code>--var-value=</code><var>variable</var></a>: <a href="#Auxiliary-tasks">Auxiliary tasks</a></li>
+<li><a href="#index-g_t_002d_002dversion-613"><code>--version</code></a>: <a href="#Standard-options">Standard options</a></li>
+<li><a href="#index-g_t_002d_002dwith-_0040r_007boptions_007d-105"><code>--with </code><span class="roman">options</span></a>: <a href="#configure-options">configure options</a></li>
+<li><a href="#index-g_t_002d_002dwith_002dmktextex_002ddefault-200"><code>--with-mktextex-default</code></a>: <a href="#mktex-configuration">mktex configuration</a></li>
+<li><a href="#index-g_t_002d_002dwithout_002dmktexfmt_002ddefault-194"><code>--without-mktexfmt-default</code></a>: <a href="#mktex-configuration">mktex configuration</a></li>
+<li><a href="#index-g_t_002d_002dwithout_002dmktexmf_002ddefault-195"><code>--without-mktexmf-default</code></a>: <a href="#mktex-configuration">mktex configuration</a></li>
+<li><a href="#index-g_t_002d_002dwithout_002dmktexocp_002ddefault-196"><code>--without-mktexocp-default</code></a>: <a href="#mktex-configuration">mktex configuration</a></li>
+<li><a href="#index-g_t_002d_002dwithout_002dmktexofm_002ddefault-197"><code>--without-mktexofm-default</code></a>: <a href="#mktex-configuration">mktex configuration</a></li>
+<li><a href="#index-g_t_002d_002dwithout_002dmktexpk_002ddefault-198"><code>--without-mktexpk-default</code></a>: <a href="#mktex-configuration">mktex configuration</a></li>
+<li><a href="#index-g_t_002d_002dwithout_002dmktextfm_002ddefault-199"><code>--without-mktextfm-default</code></a>: <a href="#mktex-configuration">mktex configuration</a></li>
+<li><a href="#index-g_t_002d1-_0040r_007bdebugging-value_007d-350"><code>-1 </code><span class="roman">debugging value</span></a>: <a href="#Debugging">Debugging</a></li>
+<li><a href="#index-g_t_002dA-_0040r_007boption-to-_0040code_007bls_007d_007d-555"><code>-A </code><span class="roman">option to </span><code>ls</code></a>: <a href="#ls_002dR">ls-R</a></li>
+<li><a href="#index-g_t_002dBdynamic-442"><code>-Bdynamic</code></a>: <a href="#ShellWidgetClass">ShellWidgetClass</a></li>
+<li><a href="#index-g_t_002dBstatic-441"><code>-Bstatic</code></a>: <a href="#ShellWidgetClass">ShellWidgetClass</a></li>
+<li><a href="#index-g_t_002dD-_0040var_007bnum_007d-579"><code>-D </code><var>num</var></a>: <a href="#Path-searching-options">Path searching options</a></li>
+<li><a href="#index-g_t_002ddynamic-440"><code>-dynamic</code></a>: <a href="#ShellWidgetClass">ShellWidgetClass</a></li>
+<li><a href="#index-g_t_002dg_0040r_007b_002c-compiling-without_007d-135"><code>-g</code><span class="roman">, compiling without</span></a>: <a href="#configure-scenarios">configure scenarios</a></li>
+<li><a href="#index-g_t_002dL-_0040r_007boption-to-_0040code_007bls_007d_007d-561"><code>-L </code><span class="roman">option to </span><code>ls</code></a>: <a href="#ls_002dR">ls-R</a></li>
+<li><a href="#index-g_t_002dmktex_003d_0040var_007bfiletype_007d-586"><code>-mktex=</code><var>filetype</var></a>: <a href="#Path-searching-options">Path searching options</a></li>
+<li><a href="#index-g_t_002dno_002dmktex_003d_0040var_007bfiletype_007d-587"><code>-no-mktex=</code><var>filetype</var></a>: <a href="#Path-searching-options">Path searching options</a></li>
+<li><a href="#index-g_t_002dO_0040r_007b_002c-compiling-with_007d-134"><code>-O</code><span class="roman">, compiling with</span></a>: <a href="#configure-scenarios">configure scenarios</a></li>
+<li><a href="#index-g_t_002dstatic-439"><code>-static</code></a>: <a href="#ShellWidgetClass">ShellWidgetClass</a></li>
+<li><a href="#index-g_t_002e-_0040r_007bdirectories_002c-ignored_007d-558"><code>. </code><span class="roman">directories, ignored</span></a>: <a href="#ls_002dR">ls-R</a></li>
+<li><a href="#index-g_t_002e-_0040r_007bfiles_007d-557"><code>. </code><span class="roman">files</span></a>: <a href="#ls_002dR">ls-R</a></li>
+<li><a href="#index-g_t_002e2602gf-396"><code>.2602gf</code></a>: <a href="#Unable-to-generate-fonts">Unable to generate fonts</a></li>
+<li><a href="#index-g_t_002eafm-620"><code>.afm</code></a>: <a href="#Supported-file-formats">Supported file formats</a></li>
+<li><a href="#index-g_t_002ebase-622"><code>.base</code></a>: <a href="#Supported-file-formats">Supported file formats</a></li>
+<li><a href="#index-g_t_002ebib-625"><code>.bib</code></a>: <a href="#Supported-file-formats">Supported file formats</a></li>
+<li><a href="#index-g_t_002ebst-628"><code>.bst</code></a>: <a href="#Supported-file-formats">Supported file formats</a></li>
+<li><a href="#index-g_t_002ecid-644"><code>.cid</code></a>: <a href="#Supported-file-formats">Supported file formats</a></li>
+<li><a href="#index-g_t_002ecmap-630"><code>.cmap</code></a>: <a href="#Supported-file-formats">Supported file formats</a></li>
+<li><a href="#index-g_t_002ecnf-632"><code>.cnf</code></a>: <a href="#Supported-file-formats">Supported file formats</a></li>
+<li><a href="#index-g_t_002eenc-639"><code>.enc</code></a>: <a href="#Supported-file-formats">Supported file formats</a></li>
+<li><a href="#index-g_t_002eeps-652"><code>.eps</code></a>: <a href="#Supported-file-formats">Supported file formats</a></li>
+<li><a href="#index-g_t_002eepsi-653"><code>.epsi</code></a>: <a href="#Supported-file-formats">Supported file formats</a></li>
+<li><a href="#index-g_t_002efea-646"><code>.fea</code></a>: <a href="#Supported-file-formats">Supported file formats</a></li>
+<li><a href="#index-g_t_002efmt-641"><code>.fmt</code></a>: <a href="#Supported-file-formats">Supported file formats</a></li>
+<li><a href="#index-g_t_002eist-656"><code>.ist</code></a>: <a href="#Supported-file-formats">Supported file formats</a></li>
+<li><a href="#index-g_t_002elig-659"><code>.lig</code></a>: <a href="#Supported-file-formats">Supported file formats</a></li>
+<li><a href="#index-g_t_002emap-663"><code>.map</code></a>: <a href="#Supported-file-formats">Supported file formats</a></li>
+<li><a href="#index-g_t_002emem-665"><code>.mem</code></a>: <a href="#Supported-file-formats">Supported file formats</a></li>
+<li><a href="#index-g_t_002emf-669"><code>.mf</code></a>: <a href="#Supported-file-formats">Supported file formats</a></li>
+<li><a href="#index-g_t_002emft-673"><code>.mft</code></a>: <a href="#Supported-file-formats">Supported file formats</a></li>
+<li><a href="#index-g_t_002emlbib-676"><code>.mlbib</code></a>: <a href="#Supported-file-formats">Supported file formats</a></li>
+<li><a href="#index-g_t_002emlbst-680"><code>.mlbst</code></a>: <a href="#Supported-file-formats">Supported file formats</a></li>
+<li><a href="#index-g_t_002emp-683"><code>.mp</code></a>: <a href="#Supported-file-formats">Supported file formats</a></li>
+<li><a href="#index-g_t_002eocp-687"><code>.ocp</code></a>: <a href="#Supported-file-formats">Supported file formats</a></li>
+<li><a href="#index-g_t_002eofm-689"><code>.ofm</code></a>: <a href="#Supported-file-formats">Supported file formats</a></li>
+<li><a href="#index-g_t_002eopl-692"><code>.opl</code></a>: <a href="#Supported-file-formats">Supported file formats</a></li>
+<li><a href="#index-g_t_002eotp-693"><code>.otp</code></a>: <a href="#Supported-file-formats">Supported file formats</a></li>
+<li><a href="#index-g_t_002eovf-695"><code>.ovf</code></a>: <a href="#Supported-file-formats">Supported file formats</a></li>
+<li><a href="#index-g_t_002eovp-697"><code>.ovp</code></a>: <a href="#Supported-file-formats">Supported file formats</a></li>
+<li><a href="#index-g_t_002epfa-726"><code>.pfa</code></a>: <a href="#Supported-file-formats">Supported file formats</a></li>
+<li><a href="#index-g_t_002epfb-727"><code>.pfb</code></a>: <a href="#Supported-file-formats">Supported file formats</a></li>
+<li><a href="#index-g_t_002epk-700"><code>.pk</code></a>: <a href="#Supported-file-formats">Supported file formats</a></li>
+<li><a href="#index-g_t_002epool-671"><code>.pool</code></a>: <a href="#Supported-file-formats">Supported file formats</a></li>
+<li><a href="#index-g_t_002epro-705"><code>.pro</code></a>: <a href="#Supported-file-formats">Supported file formats</a></li>
+<li><a href="#index-g_t_002erhosts_0040r_007b_002c-writable-by-_0040TeX_007b_007d_007d-258"><code>.rhosts</code><span class="roman">, writable by TeX</span></a>: <a href="#Security">Security</a></li>
+<li><a href="#index-g_t_002esfd-708"><code>.sfd</code></a>: <a href="#Supported-file-formats">Supported file formats</a></li>
+<li><a href="#index-g_t_002etex-710"><code>.tex</code></a>: <a href="#Supported-file-formats">Supported file formats</a></li>
+<li><a href="#index-g_t_002etex-_0040r_007bfile_002c-included-in-_0040file_007bls_002dR_007d_007d-559"><code>.tex </code><span class="roman">file, included in </span><samp><span class="file">ls-R</span></samp></a>: <a href="#ls_002dR">ls-R</a></li>
+<li><a href="#index-g_t_002etfm-719"><code>.tfm</code></a>: <a href="#Supported-file-formats">Supported file formats</a></li>
+<li><a href="#index-g_t_002ettc-724"><code>.ttc</code></a>: <a href="#Supported-file-formats">Supported file formats</a></li>
+<li><a href="#index-g_t_002ettf-723"><code>.ttf</code></a>: <a href="#Supported-file-formats">Supported file formats</a></li>
+<li><a href="#index-g_t_002evf-733"><code>.vf</code></a>: <a href="#Supported-file-formats">Supported file formats</a></li>
+<li><a href="#index-g_t_002ew-634"><code>.w</code></a>: <a href="#Supported-file-formats">Supported file formats</a></li>
+<li><a href="#index-g_t_002eweb-635"><code>.web</code></a>: <a href="#Supported-file-formats">Supported file formats</a></li>
+<li><a href="#index-g_t_002f-_0040r_007bmay-not-be-_002f_007d-454"><code>/ </code><span class="roman">may not be /</span></a>: <a href="#Searching-overview">Searching overview</a></li>
+<li><a href="#index-g_t_002f_0040r_007b_002c-trailing-in-home-directory_007d-528"><code>/</code><span class="roman">, trailing in home directory</span></a>: <a href="#Tilde-expansion">Tilde expansion</a></li>
+<li><a href="#index-g_t_002f_002f-535"><code>//</code></a>: <a href="#Subdirectory-expansion">Subdirectory expansion</a></li>
+<li><a href="#index-g_t_002fafs_002f_0040dots_007b_007d-_0040r_007b_002c-installing-into_007d-173"><code>/afs/... </code><span class="roman">, installing into</span></a>: <a href="#Installing-files">Installing files</a></li>
+<li><a href="#index-g_t_002fetc_002fprofile-384"><code>/etc/profile</code></a>: <a href="#Unable-to-find-files">Unable to find files</a></li>
+<li><a href="#index-g_t_002fetc_002fprofile-_0040r_007band-aliases_007d-554"><code>/etc/profile </code><span class="roman">and aliases</span></a>: <a href="#ls_002dR">ls-R</a></li>
+<li><a href="#index-g_t_002fvar_002ftmp_002ftexfonts-229"><code>/var/tmp/texfonts</code></a>: <a href="#mktex-configuration">mktex configuration</a></li>
+<li><a href="#index-g_t2602gf-397"><code>2602gf</code></a>: <a href="#Unable-to-generate-fonts">Unable to generate fonts</a></li>
+<li><a href="#index-g_t8_002e3-filenames_002c-using-211">8.3 filenames, using</a>: <a href="#mktex-configuration">mktex configuration</a></li>
+<li><a href="#index-g_t_003a-_0040r_007bmay-not-be-_003a_007d-453"><code>: </code><span class="roman">may not be :</span></a>: <a href="#Searching-overview">Searching overview</a></li>
+<li><a href="#index-g_t_003a_003a-_0040r_007bexpansion_007d-503"><code>:: </code><span class="roman">expansion</span></a>: <a href="#Default-expansion">Default expansion</a></li>
+<li><a href="#index-g_t_0040_0040_0040var_007bvar_007d_0040_0040-substitutions-87">@<var>var</var>@ substitutions</a>: <a href="#Running-configure">Running configure</a></li>
+<li><a href="#index-g_t_005c_0040r_007b_002c-line-continuation-in-_0040file_007btexmf_002ecnf_007d_007d-495"><code>\</code><span class="roman">, line continuation in </span><samp><span class="file">texmf.cnf</span></samp></a>: <a href="#Config-files">Config files</a></li>
+<li><a href="#index-g_t_005copenin-464"><code>\openin</code></a>: <a href="#Searching-overview">Searching overview</a></li>
+<li><a href="#index-g_t_005cspecial_0040r_007b_002c-suppressing-warnings-about_007d-796"><code>\special</code><span class="roman">, suppressing warnings about</span></a>: <a href="#Suppressing-warnings">Suppressing warnings</a></li>
+<li><a href="#index-absolute-filenames-466">absolute filenames</a>: <a href="#Searching-overview">Searching overview</a></li>
+<li><a href="#index-ac_005finclude_0040r_007b_002c-Autoconf-extension_007d-86"><code>ac_include</code><span class="roman">, Autoconf extension</span></a>: <a href="#Running-configure">Running configure</a></li>
+<li><a href="#index-access-warnings-472">access warnings</a>: <a href="#Searching-overview">Searching overview</a></li>
+<li><a href="#index-Acorn-_0040TeX_007b_007d-implementations-303">Acorn TeX implementations</a>: <a href="#Other-TeX-packages">Other TeX packages</a></li>
+<li><a href="#index-AFMFONTS-621"><code>AFMFONTS</code></a>: <a href="#Supported-file-formats">Supported file formats</a></li>
+<li><a href="#index-AFS-171">AFS</a>: <a href="#Installing-files">Installing files</a></li>
+<li><a href="#index-AIX-4_002e1-_0040code_007bconfigure_007d-error-419">AIX 4.1 <code>configure</code> error</a>: <a href="#Empty-Makefiles">Empty Makefiles</a></li>
+<li><a href="#index-AIX-shells-and-_0040code_007bconfigure_007d-96">AIX shells and <code>configure</code></a>: <a href="#configure-shells">configure shells</a></li>
+<li><a href="#index-aliases-for-fonts-763">aliases for fonts</a>: <a href="#Fontmap">Fontmap</a></li>
+<li><a href="#index-aliases_002c-for-filenames-569">aliases, for filenames</a>: <a href="#Filename-aliases">Filename aliases</a></li>
+<li><a href="#index-all-786"><code>all</code></a>: <a href="#Suppressing-warnings">Suppressing warnings</a></li>
+<li><a href="#index-all-matches_002c-finding-577">all matches, finding</a>: <a href="#Path-searching-options">Path searching options</a></li>
+<li><a href="#index-alphabetical-order_002c-not-538">alphabetical order, not</a>: <a href="#Subdirectory-expansion">Subdirectory expansion</a></li>
+<li><a href="#index-Amiga-support-42">Amiga support</a>: <a href="#Custom-installation">Custom installation</a></li>
+<li><a href="#index-Amiga-_0040TeX_007b_007d-implementations-302">Amiga TeX implementations</a>: <a href="#Other-TeX-packages">Other TeX packages</a></li>
+<li><a href="#index-Andrew-File-System_002c-installing-with-172">Andrew File System, installing with</a>: <a href="#Installing-files">Installing files</a></li>
+<li><a href="#index-announcement-mailing-list-334">announcement mailing list</a>: <a href="#Mailing-lists">Mailing lists</a></li>
+<li><a href="#index-ANSI-C-410">ANSI C</a>: <a href="#TeX-or-Metafont-failing">TeX or Metafont failing</a></li>
+<li><a href="#index-API_002c-re_002dentrant-800">API, re-entrant</a>: <a href="#Programming-overview">Programming overview</a></li>
+<li><a href="#index-append_002donly-directories-and-_0040code_007bmktexpk_007d-262">append-only directories and <code>mktexpk</code></a>: <a href="#Security">Security</a></li>
+<li><a href="#index-appendonlydir-207"><code>appendonlydir</code></a>: <a href="#mktex-configuration">mktex configuration</a></li>
+<li><a href="#index-architecture_002d_0028in_0029dependent-files_002c-installing-only-167">architecture-(in)dependent files, installing only</a>: <a href="#Installing-files">Installing files</a></li>
+<li><a href="#index-architectures_002c-compiling-multiple-127">architectures, compiling multiple</a>: <a href="#configure-scenarios">configure scenarios</a></li>
+<li><a href="#index-arguments-to-_0040file_007bmktex_007d-253">arguments to <samp><span class="file">mktex</span></samp></a>: <a href="#mktex-script-arguments">mktex script arguments</a></li>
+<li><a href="#index-argv_005b0_005d-812"><code>argv[0]</code></a>: <a href="#Calling-sequence">Calling sequence</a></li>
+<li><a href="#index-ash_0040r_007b_002c-losing-with-_0040code_007bconfigure_007d_007d-97"><code>ash</code><span class="roman">, losing with </span><code>configure</code></a>: <a href="#configure-shells">configure shells</a></li>
+<li><a href="#index-autoconf_0040r_007b_002c-recommended_007d-841"><code>autoconf</code><span class="roman">, recommended</span></a>: <a href="#Calling-sequence">Calling sequence</a></li>
+<li><a href="#index-automounter_002c-and-configuration-133">automounter, and configuration</a>: <a href="#configure-scenarios">configure scenarios</a></li>
+<li><a href="#index-automounter_002c-and-_0040file_007bls_002dR_007d-562">automounter, and <samp><span class="file">ls-R</span></samp></a>: <a href="#ls_002dR">ls-R</a></li>
+<li><a href="#index-auxiliary-tasks-604">auxiliary tasks</a>: <a href="#Auxiliary-tasks">Auxiliary tasks</a></li>
+<li><a href="#index-Babel-164">Babel</a>: <a href="#Running-make">Running make</a></li>
+<li><a href="#index-Babel-61">Babel</a>: <a href="#Kpathsea-application-distributions">Kpathsea application distributions</a></li>
+<li><a href="#index-Bach_002c-Johann-Sebastian-510">Bach, Johann Sebastian</a>: <a href="#Default-expansion">Default expansion</a></li>
+<li><a href="#index-backbone-of-CTAN-284">backbone of CTAN</a>: <a href="#Electronic-distribution">Electronic distribution</a></li>
+<li><a href="#index-backslash_002dnewline-492">backslash-newline</a>: <a href="#Config-files">Config files</a></li>
+<li><a href="#index-bash_0040r_007b_002c-recommended-for-running-_0040code_007bconfigure_007d_007d-92"><code>bash</code><span class="roman">, recommended for running </span><code>configure</code></a>: <a href="#configure-shells">configure shells</a></li>
+<li><a href="#index-basic-glyph-lookup-756">basic glyph lookup</a>: <a href="#Basic-glyph-lookup">Basic glyph lookup</a></li>
+<li><a href="#index-Berry_002c-Karl-15">Berry, Karl</a>: <a href="#History">History</a></li>
+<li><a href="#index-BIBINPUTS-626"><code>BIBINPUTS</code></a>: <a href="#Supported-file-formats">Supported file formats</a></li>
+<li><a href="#index-binary-mode_002c-for-file-transfers-291">binary mode, for file transfers</a>: <a href="#Electronic-distribution">Electronic distribution</a></li>
+<li><a href="#index-blank-lines_002c-in-_0040file_007btexmf_002ecnf_007d-491">blank lines, in <samp><span class="file">texmf.cnf</span></samp></a>: <a href="#Config-files">Config files</a></li>
+<li><a href="#index-brace-expansion-531">brace expansion</a>: <a href="#Brace-expansion">Brace expansion</a></li>
+<li><a href="#index-BSD-universe-159">BSD universe</a>: <a href="#Running-make">Running make</a></li>
+<li><a href="#index-bsh_0040r_007b_002c-ok-with-_0040code_007bconfigure_007d_007d-94"><code>bsh</code><span class="roman">, ok with </span><code>configure</code></a>: <a href="#configure-shells">configure shells</a></li>
+<li><a href="#index-BSTINPUTS-629"><code>BSTINPUTS</code></a>: <a href="#Supported-file-formats">Supported file formats</a></li>
+<li><a href="#index-bug-address-315">bug address</a>: <a href="#Reporting-bugs">Reporting bugs</a></li>
+<li><a href="#index-bug-checklist-317">bug checklist</a>: <a href="#Bug-checklist">Bug checklist</a></li>
+<li><a href="#index-bug-mailing-list-333">bug mailing list</a>: <a href="#Mailing-lists">Mailing lists</a></li>
+<li><a href="#index-bugs_002c-reporting-313">bugs, reporting</a>: <a href="#Reporting-bugs">Reporting bugs</a></li>
+<li><a href="#index-c_002d_002a_002eh-840"><code>c-*.h</code></a>: <a href="#Calling-sequence">Calling sequence</a></li>
+<li><a href="#index-c_002dauto_002eh-806"><code>c-auto.h</code></a>: <a href="#Programming-overview">Programming overview</a></li>
+<li><a href="#index-c_002dauto_002ein-84"><code>c-auto.in</code></a>: <a href="#Running-configure">Running configure</a></li>
+<li><a href="#index-cache-of-fonts_002c-local-260">cache of fonts, local</a>: <a href="#Security">Security</a></li>
+<li><a href="#index-calling-sequence-809">calling sequence</a>: <a href="#Calling-sequence">Calling sequence</a></li>
+<li><a href="#index-CC-112"><code>CC</code></a>: <a href="#configure-environment">configure environment</a></li>
+<li><a href="#index-cc-_0040r_007bwarnings_007d-446"><code>cc </code><span class="roman">warnings</span></a>: <a href="#Pointer-combination-warnings">Pointer combination warnings</a></li>
+<li><a href="#index-cc_0040r_007b_002c-compiling-with_007d-114"><code>cc</code><span class="roman">, compiling with</span></a>: <a href="#configure-environment">configure environment</a></li>
+<li><a href="#index-CD_002dROM-distributions-293">CD-ROM distributions</a>: <a href="#CD_002dROM-distribution">CD-ROM distribution</a></li>
+<li><a href="#index-CFLAGS-115"><code>CFLAGS</code></a>: <a href="#configure-environment">configure environment</a></li>
+<li><a href="#index-ChangeLog-_0040r_007bentry_007d-325"><code>ChangeLog </code><span class="roman">entry</span></a>: <a href="#Bug-checklist">Bug checklist</a></li>
+<li><a href="#index-checklist-for-bug-reports-316">checklist for bug reports</a>: <a href="#Bug-checklist">Bug checklist</a></li>
+<li><a href="#index-checksum-787"><code>checksum</code></a>: <a href="#Suppressing-warnings">Suppressing warnings</a></li>
+<li><a href="#index-circle-fonts-766">circle fonts</a>: <a href="#Fontmap">Fontmap</a></li>
+<li><a href="#index-clean-_0040r_007bMake-target_007d-178"><code>clean </code><span class="roman">Make target</span></a>: <a href="#Cleaning-up">Cleaning up</a></li>
+<li><a href="#index-client_005fpath-_0040r_007bin-_0040code_007bkpse_002d_003eformat_005finfo_007d_007d-825"><code>client_path </code><span class="roman">in </span><code>kpse-&gt;format_info</code></a>: <a href="#Calling-sequence">Calling sequence</a></li>
+<li><a href="#index-CMAPFONTS-631"><code>CMAPFONTS</code></a>: <a href="#Supported-file-formats">Supported file formats</a></li>
+<li><a href="#index-cmr10_0040r_007b_002c-as-fallback-font_007d-781"><code>cmr10</code><span class="roman">, as fallback font</span></a>: <a href="#Fallback-font">Fallback font</a></li>
+<li><a href="#index-cmr10_002evf-463"><code>cmr10.vf</code></a>: <a href="#Searching-overview">Searching overview</a></li>
+<li><a href="#index-cnf_002ec-500"><code>cnf.c</code></a>: <a href="#Config-files">Config files</a></li>
+<li><a href="#index-cnf_002eh-848"><code>cnf.h</code></a>: <a href="#Programming-with-config-files">Programming with config files</a></li>
+<li><a href="#index-code-sharing-140">code sharing</a>: <a href="#Shared-library">Shared library</a></li>
+<li><a href="#index-color-printers_002c-configuring-35">color printers, configuring</a>: <a href="#Simple-installation">Simple installation</a></li>
+<li><a href="#index-comments_002c-in-fontmap-files-768">comments, in fontmap files</a>: <a href="#Fontmap">Fontmap</a></li>
+<li><a href="#index-comments_002c-in-_0040file_007btexmf_002ecnf_007d-490">comments, in <samp><span class="file">texmf.cnf</span></samp></a>: <a href="#Config-files">Config files</a></li>
<li><a href="#index-comments_002c-making-5">comments, making</a>: <a href="#Introduction">Introduction</a></li>
-<li><a href="#index-common-features-in-glyph-lookup-748">common features in glyph lookup</a>: <a href="#Basic-glyph-lookup">Basic glyph lookup</a></li>
-<li><a href="#index-common-problems-382">common problems</a>: <a href="#Common-problems">Common problems</a></li>
-<li><a href="#index-comp_002esys_002esun_002eadmin-_0040r_007bFAQ_007d-436"><code>comp.sys.sun.admin </code><span class="roman">FAQ</span></a>: <a href="#ShellWidgetClass">ShellWidgetClass</a></li>
-<li><a href="#index-comp_002etext_002etex-345"><code>comp.text.tex</code></a>: <a href="#Mailing-lists">Mailing lists</a></li>
-<li><a href="#index-compilation-29">compilation</a>: <a href="#Installation">Installation</a></li>
-<li><a href="#index-compilation-value_002c-source-for-path-485">compilation value, source for path</a>: <a href="#Path-sources">Path sources</a></li>
-<li><a href="#index-compiler-bugs-408">compiler bugs</a>: <a href="#TeX-or-Metafont-failing">TeX or Metafont failing</a></li>
-<li><a href="#index-compiler-bugs_002c-finding-412">compiler bugs, finding</a>: <a href="#TeX-or-Metafont-failing">TeX or Metafont failing</a></li>
-<li><a href="#index-compiler-options_002c-additional-150">compiler options, additional</a>: <a href="#Running-make">Running make</a></li>
-<li><a href="#index-compiler-options_002c-specifying-117">compiler options, specifying</a>: <a href="#configure-environment">configure environment</a></li>
-<li><a href="#index-compiler_002c-changing-157">compiler, changing</a>: <a href="#Running-make">Running make</a></li>
-<li><a href="#index-compiling-on-HP_002dUX-415">compiling on HP-UX</a>: <a href="#TeX-or-Metafont-failing">TeX or Metafont failing</a></li>
+<li><a href="#index-common-features-in-glyph-lookup-757">common features in glyph lookup</a>: <a href="#Basic-glyph-lookup">Basic glyph lookup</a></li>
+<li><a href="#index-common-problems-379">common problems</a>: <a href="#Common-problems">Common problems</a></li>
+<li><a href="#index-comp_002esys_002esun_002eadmin-_0040r_007bFAQ_007d-433"><code>comp.sys.sun.admin </code><span class="roman">FAQ</span></a>: <a href="#ShellWidgetClass">ShellWidgetClass</a></li>
+<li><a href="#index-comp_002etext_002etex-342"><code>comp.text.tex</code></a>: <a href="#Mailing-lists">Mailing lists</a></li>
+<li><a href="#index-compilation-28">compilation</a>: <a href="#Installation">Installation</a></li>
+<li><a href="#index-compilation-value_002c-source-for-path-482">compilation value, source for path</a>: <a href="#Path-sources">Path sources</a></li>
+<li><a href="#index-compiler-bugs-405">compiler bugs</a>: <a href="#TeX-or-Metafont-failing">TeX or Metafont failing</a></li>
+<li><a href="#index-compiler-bugs_002c-finding-409">compiler bugs, finding</a>: <a href="#TeX-or-Metafont-failing">TeX or Metafont failing</a></li>
+<li><a href="#index-compiler-options_002c-additional-149">compiler options, additional</a>: <a href="#Running-make">Running make</a></li>
+<li><a href="#index-compiler-options_002c-specifying-116">compiler options, specifying</a>: <a href="#configure-environment">configure environment</a></li>
+<li><a href="#index-compiler_002c-changing-156">compiler, changing</a>: <a href="#Running-make">Running make</a></li>
+<li><a href="#index-compiling-on-HP_002dUX-412">compiling on HP-UX</a>: <a href="#TeX-or-Metafont-failing">TeX or Metafont failing</a></li>
<li><a href="#index-conditions-for-use-7">conditions for use</a>: <a href="#Introduction">Introduction</a></li>
-<li><a href="#index-config-files-486">config files</a>: <a href="#Config-files">Config files</a></li>
-<li><a href="#index-config-files_002c-for-Kpathsea_002dusing-programs-818">config files, for Kpathsea-using programs</a>: <a href="#Calling-sequence">Calling sequence</a></li>
-<li><a href="#index-config-files_002c-programming-with-833">config files, programming with</a>: <a href="#Programming-with-config-files">Programming with config files</a></li>
-<li><a href="#index-config_002eh-794"><code>config.h</code></a>: <a href="#Programming-overview">Programming overview</a></li>
-<li><a href="#index-config_002elog-321"><code>config.log</code></a>: <a href="#Bug-checklist">Bug checklist</a></li>
-<li><a href="#index-config_002eps-596"><code>config.ps</code></a>: <a href="#Specially_002drecognized-files">Specially-recognized files</a></li>
-<li><a href="#index-config_002eps_0040r_007b_002c-search-path-for_007d-640"><code>config.ps</code><span class="roman">, search path for</span></a>: <a href="#Supported-file-formats">Supported file formats</a></li>
-<li><a href="#index-config_002estatus-323"><code>config.status</code></a>: <a href="#Bug-checklist">Bug checklist</a></li>
-<li><a href="#index-configuration-28">configuration</a>: <a href="#Installation">Installation</a></li>
-<li><a href="#index-configuration-bugs-322">configuration bugs</a>: <a href="#Bug-checklist">Bug checklist</a></li>
-<li><a href="#index-configuration-compiler-options-119">configuration compiler options</a>: <a href="#configure-environment">configure environment</a></li>
-<li><a href="#index-configuration-file_002c-source-for-path-482">configuration file, source for path</a>: <a href="#Path-sources">Path sources</a></li>
-<li><a href="#index-configuration-files-as-shell-scripts_002e-502">configuration files as shell scripts.</a>: <a href="#Config-files">Config files</a></li>
-<li><a href="#index-configuration-of-_0040file_007bmktex_007d-scripts-191">configuration of <samp><span class="file">mktex</span></samp> scripts</a>: <a href="#mktex-configuration">mktex configuration</a></li>
-<li><a href="#index-configuration-of-optional-features-108">configuration of optional features</a>: <a href="#configure-options">configure options</a></li>
-<li><a href="#index-configure-_0040r_007berror-from-_0040code_007bsed_007d_007d-418"><code>configure </code><span class="roman">error from </span><code>sed</code></a>: <a href="#Empty-Makefiles">Empty Makefiles</a></li>
-<li><a href="#index-g_t_0040code_007bconfigure_007d-options-105"><code>configure</code> options</a>: <a href="#configure-options">configure options</a></li>
-<li><a href="#index-g_t_0040code_007bconfigure_007d-options-for-_0040file_007bmktex_007d-scripts-194"><code>configure</code> options for <samp><span class="file">mktex</span></samp> scripts</a>: <a href="#mktex-configuration">mktex configuration</a></li>
-<li><a href="#index-configure_0040r_007b_002c-running_007d-84"><code>configure</code><span class="roman">, running</span></a>: <a href="#Running-configure">Running configure</a></li>
-<li><a href="#index-context-diff-324">context diff</a>: <a href="#Bug-checklist">Bug checklist</a></li>
-<li><a href="#index-continuation-character-496">continuation character</a>: <a href="#Config-files">Config files</a></li>
-<li><a href="#index-core-dumps_002c-reporting-330">core dumps, reporting</a>: <a href="#Bug-checklist">Bug checklist</a></li>
-<li><a href="#index-CPPFLAGS-118"><code>CPPFLAGS</code></a>: <a href="#configure-environment">configure environment</a></li>
-<li><a href="#index-crashes_002c-reporting-329">crashes, reporting</a>: <a href="#Bug-checklist">Bug checklist</a></li>
-<li><a href="#index-CTAN_002c-defined-284">CTAN, defined</a>: <a href="#Electronic-distribution">Electronic distribution</a></li>
-<li><a href="#index-CTAN_002esites-287"><code>CTAN.sites</code></a>: <a href="#Electronic-distribution">Electronic distribution</a></li>
-<li><a href="#index-custom-installation-40">custom installation</a>: <a href="#Custom-installation">Custom installation</a></li>
-<li><a href="#index-CWEBINPUTS-638"><code>CWEBINPUTS</code></a>: <a href="#Supported-file-formats">Supported file formats</a></li>
-<li><a href="#index-database-search-458">database search</a>: <a href="#Searching-overview">Searching overview</a></li>
-<li><a href="#index-database_002c-for-filenames-551">database, for filenames</a>: <a href="#Filename-database">Filename database</a></li>
-<li><a href="#index-database_002c-format-of-574">database, format of</a>: <a href="#Database-format">Database format</a></li>
-<li><a href="#index-debug_002eh-350"><code>debug.h</code></a>: <a href="#Debugging">Debugging</a></li>
-<li><a href="#index-debugger-328">debugger</a>: <a href="#Bug-checklist">Bug checklist</a></li>
-<li><a href="#index-debugging-346">debugging</a>: <a href="#Debugging">Debugging</a></li>
-<li><a href="#index-debugging-options_002c-in-Kpathsea_002dusing-program-814">debugging options, in Kpathsea-using program</a>: <a href="#Calling-sequence">Calling sequence</a></li>
-<li><a href="#index-debugging-output-354">debugging output</a>: <a href="#Debugging">Debugging</a></li>
-<li><a href="#index-debugging-with-_0040samp_007b_002dg_007d_002c-disabling-138">debugging with &lsquo;<samp><span class="samp">-g</span></samp>&rsquo;, disabling</a>: <a href="#configure-scenarios">configure scenarios</a></li>
-<li><a href="#index-DEC-shells-and-_0040code_007bconfigure_007d-102">DEC shells and <code>configure</code></a>: <a href="#configure-shells">configure shells</a></li>
-<li><a href="#index-default-expansion-511">default expansion</a>: <a href="#Default-expansion">Default expansion</a></li>
-<li><a href="#index-default-path-features-67">default path features</a>: <a href="#Default-path-features">Default path features</a></li>
-<li><a href="#index-default-paths_002c-changing-75">default paths, changing</a>: <a href="#Default-path-generation">Default path generation</a></li>
-<li><a href="#index-default-paths_002c-how-they_0027re-made-79">default paths, how they're made</a>: <a href="#Default-path-generation">Default path generation</a></li>
-<li><a href="#index-default_005ftexsizes-771"><code>default_texsizes</code></a>: <a href="#Fallback-font">Fallback font</a></li>
-<li><a href="#index-DEFS-120"><code>DEFS</code></a>: <a href="#configure-environment">configure environment</a></li>
-<li><a href="#index-depot-133"><code>depot</code></a>: <a href="#configure-scenarios">configure scenarios</a></li>
-<li><a href="#index-device_002c-wrong-398">device, wrong</a>: <a href="#Unable-to-generate-fonts">Unable to generate fonts</a></li>
-<li><a href="#index-directories_002c-changing-default-installation-78">directories, changing default installation</a>: <a href="#Default-path-generation">Default path generation</a></li>
-<li><a href="#index-directories_002c-making-append_002donly-209">directories, making append-only</a>: <a href="#mktex-configuration">mktex configuration</a></li>
-<li><a href="#index-directory-permissions-268">directory permissions</a>: <a href="#Security">Security</a></li>
-<li><a href="#index-directory-structure_002c-for-_0040TeX_007b_007d-files-272">directory structure, for TeX files</a>: <a href="#TeX-directory-structure">TeX directory structure</a></li>
-<li><a href="#index-disabling-_0040file_007bmktex_007d-scripts-193">disabling <samp><span class="file">mktex</span></samp> scripts</a>: <a href="#mktex-configuration">mktex configuration</a></li>
-<li><a href="#index-disk-search-462">disk search</a>: <a href="#Searching-overview">Searching overview</a></li>
-<li><a href="#index-disk-searching_002c-avoiding-570">disk searching, avoiding</a>: <a href="#ls_002dR">ls-R</a></li>
-<li><a href="#index-disk-space_002c-needed-47">disk space, needed</a>: <a href="#Disk-space">Disk space</a></li>
-<li><a href="#index-disk-usage_002c-reducing-377">disk usage, reducing</a>: <a href="#Logging">Logging</a></li>
-<li><a href="#index-distclean-_0040r_007bMake-target_007d-177"><code>distclean </code><span class="roman">Make target</span></a>: <a href="#Cleaning-up">Cleaning up</a></li>
-<li><a href="#index-distributions_002c-compiling-simultaneously-50">distributions, compiling simultaneously</a>: <a href="#Kpathsea-application-distributions">Kpathsea application distributions</a></li>
-<li><a href="#index-distributions_002c-not-compiling-53">distributions, not compiling</a>: <a href="#Kpathsea-application-distributions">Kpathsea application distributions</a></li>
-<li><a href="#index-distributions_002c-on-CD_002dROM-296">distributions, on CD-ROM</a>: <a href="#CD_002dROM-distribution">CD-ROM distribution</a></li>
-<li><a href="#index-distributions_002c-via-ftp-283">distributions, via ftp</a>: <a href="#Electronic-distribution">Electronic distribution</a></li>
-<li><a href="#index-dlclose-428"><code>dlclose</code></a>: <a href="#dlopen">dlopen</a></li>
-<li><a href="#index-dlopen-426"><code>dlopen</code></a>: <a href="#dlopen">dlopen</a></li>
-<li><a href="#index-dlsym-427"><code>dlsym</code></a>: <a href="#dlopen">dlopen</a></li>
-<li><a href="#index-dlsym_002ec-431"><code>dlsym.c</code></a>: <a href="#dlopen">dlopen</a></li>
-<li><a href="#index-doc-files-703"><code>doc files</code></a>: <a href="#Supported-file-formats">Supported file formats</a></li>
-<li><a href="#index-DOS-compatible-names-213">DOS compatible names</a>: <a href="#mktex-configuration">mktex configuration</a></li>
-<li><a href="#index-DOS-support-44">DOS support</a>: <a href="#Custom-installation">Custom installation</a></li>
-<li><a href="#index-DOS-_0040TeX_007b_007d-implementations-307">DOS TeX implementations</a>: <a href="#Other-TeX-packages">Other TeX packages</a></li>
-<li><a href="#index-dosnames-211"><code>dosnames</code></a>: <a href="#mktex-configuration">mktex configuration</a></li>
-<li><a href="#index-dot-files-559">dot files</a>: <a href="#ls_002dR">ls-R</a></li>
-<li><a href="#index-doubled-colons-507">doubled colons</a>: <a href="#Default-expansion">Default expansion</a></li>
-<li><a href="#index-dpi_0040var_007bnnn_007d-directories-214"><code>dpi</code><var>nnn</var><code> directories</code></a>: <a href="#mktex-configuration">mktex configuration</a></li>
-<li><a href="#index-DVI-drivers-56">DVI drivers</a>: <a href="#Kpathsea-application-distributions">Kpathsea application distributions</a></li>
-<li><a href="#index-DVILJMAKEPK-249"><code>DVILJMAKEPK</code></a>: <a href="#mktex-script-names">mktex script names</a></li>
-<li><a href="#index-DVILJSIZES-769"><code>DVILJSIZES</code></a>: <a href="#Fallback-font">Fallback font</a></li>
-<li><a href="#index-dvipdfmx_002ecfg-597"><code>dvipdfmx.cfg</code></a>: <a href="#Specially_002drecognized-files">Specially-recognized files</a></li>
-<li><a href="#index-DVIPSFONTS-733"><code>DVIPSFONTS</code></a>: <a href="#Supported-file-formats">Supported file formats</a></li>
-<li><a href="#index-DVIPSHEADERS-722"><code>DVIPSHEADERS</code></a>: <a href="#Supported-file-formats">Supported file formats</a></li>
-<li><a href="#index-DVIPSMAKEPK-247"><code>DVIPSMAKEPK</code></a>: <a href="#mktex-script-names">mktex script names</a></li>
-<li><a href="#index-DVIPSSIZES-767"><code>DVIPSSIZES</code></a>: <a href="#Fallback-font">Fallback font</a></li>
-<li><a href="#index-dynamic-creation-of-files-187">dynamic creation of files</a>: <a href="#mktex-scripts">mktex scripts</a></li>
-<li><a href="#index-dynamic-linking-problems-with-OpenWin-libraries-432">dynamic linking problems with OpenWin libraries</a>: <a href="#ShellWidgetClass">ShellWidgetClass</a></li>
-<li><a href="#index-EC-fonts_002c-and-dynamic-source-creation-189">EC fonts, and dynamic source creation</a>: <a href="#mktex-scripts">mktex scripts</a></li>
-<li><a href="#index-elt_002ddirs_002ec-548"><code>elt-dirs.c</code></a>: <a href="#Subdirectory-expansion">Subdirectory expansion</a></li>
-<li><a href="#index-email-CTAN-access-290">email CTAN access</a>: <a href="#Electronic-distribution">Electronic distribution</a></li>
-<li><a href="#index-enabling-_0040file_007bmktex_007d-scripts-192">enabling <samp><span class="file">mktex</span></samp> scripts</a>: <a href="#mktex-configuration">mktex configuration</a></li>
-<li><a href="#index-ENCFONTS-642"><code>ENCFONTS</code></a>: <a href="#Supported-file-formats">Supported file formats</a></li>
-<li><a href="#index-engine-name-585">engine name</a>: <a href="#Path-searching-options">Path searching options</a></li>
-<li><a href="#index-environment-variable_002c-source-for-path-481">environment variable, source for path</a>: <a href="#Path-sources">Path sources</a></li>
-<li><a href="#index-environment-variables-for-_0040TeX_007b_007d-619">environment variables for TeX</a>: <a href="#Supported-file-formats">Supported file formats</a></li>
-<li><a href="#index-environment-variables-in-paths-516">environment variables in paths</a>: <a href="#Variable-expansion">Variable expansion</a></li>
-<li><a href="#index-environment-variables_002c-old-388">environment variables, old</a>: <a href="#Unable-to-find-files">Unable to find files</a></li>
-<li><a href="#index-epoch_002c-seconds-since-379">epoch, seconds since</a>: <a href="#Logging">Logging</a></li>
-<li><a href="#index-error-message-macros-804">error message macros</a>: <a href="#Calling-sequence">Calling sequence</a></li>
-<li><a href="#index-excessive-startup-time-391">excessive startup time</a>: <a href="#Slow-path-searching">Slow path searching</a></li>
-<li><a href="#index-expand_002ec-536"><code>expand.c</code></a>: <a href="#Brace-expansion">Brace expansion</a></li>
-<li><a href="#index-expanding-symlinks-810">expanding symlinks</a>: <a href="#Calling-sequence">Calling sequence</a></li>
-<li><a href="#index-expansion_002c-default-512">expansion, default</a>: <a href="#Default-expansion">Default expansion</a></li>
-<li><a href="#index-expansion_002c-path-element-468">expansion, path element</a>: <a href="#Searching-overview">Searching overview</a></li>
-<li><a href="#index-expansion_002c-search-path-505">expansion, search path</a>: <a href="#Path-expansion">Path expansion</a></li>
-<li><a href="#index-expansion_002c-subdirectory-540">expansion, subdirectory</a>: <a href="#Subdirectory-expansion">Subdirectory expansion</a></li>
-<li><a href="#index-expansion_002c-tilde-526">expansion, tilde</a>: <a href="#Tilde-expansion">Tilde expansion</a></li>
-<li><a href="#index-expansion_002c-variable-518">expansion, variable</a>: <a href="#Variable-expansion">Variable expansion</a></li>
-<li><a href="#index-explicitly-relative-filenames-471">explicitly relative filenames</a>: <a href="#Searching-overview">Searching overview</a></li>
-<li><a href="#index-extensions_002c-filename-737">extensions, filename</a>: <a href="#File-lookup">File lookup</a></li>
-<li><a href="#index-externally_002dbuilt-filename-database-552">externally-built filename database</a>: <a href="#Filename-database">Filename database</a></li>
-<li><a href="#index-extra-colons-510">extra colons</a>: <a href="#Default-expansion">Default expansion</a></li>
-<li><a href="#index-extraclean-_0040r_007bMake-target_007d-181"><code>extraclean </code><span class="roman">Make target</span></a>: <a href="#Cleaning-up">Cleaning up</a></li>
-<li><a href="#index-failed-_0040code_007bmktex_0040dots_007b_007d_007d-script-invocation-251">failed <code>mktex...</code> script invocation</a>: <a href="#mktex-script-names">mktex script names</a></li>
-<li><a href="#index-fallback-font-762">fallback font</a>: <a href="#Fallback-font">Fallback font</a></li>
-<li><a href="#index-fallback-resolutions-763">fallback resolutions</a>: <a href="#Fallback-font">Fallback font</a></li>
-<li><a href="#index-fallback-resolutions_002c-overriding-145">fallback resolutions, overriding</a>: <a href="#Running-make">Running make</a></li>
-<li><a href="#index-FAQ_002c-_0040t_007bcomp_002esys_002esun_002eadmin_007d-437">FAQ, <tt>comp.sys.sun.admin</tt></a>: <a href="#ShellWidgetClass">ShellWidgetClass</a></li>
-<li><a href="#index-FAQ_002c-Kpathsea-384">FAQ, Kpathsea</a>: <a href="#Common-problems">Common problems</a></li>
-<li><a href="#index-Farwell_002c-Matthew-544">Farwell, Matthew</a>: <a href="#Subdirectory-expansion">Subdirectory expansion</a></li>
-<li><a href="#index-features_002c-of-default-paths-68">features, of default paths</a>: <a href="#Default-path-features">Default path features</a></li>
-<li><a href="#index-file-formats_002c-supported-618">file formats, supported</a>: <a href="#Supported-file-formats">Supported file formats</a></li>
-<li><a href="#index-file-lookup-734">file lookup</a>: <a href="#File-lookup">File lookup</a></li>
-<li><a href="#index-file-permissions-266">file permissions</a>: <a href="#Security">Security</a></li>
-<li><a href="#index-file-types_002c-registering-new-796">file types, registering new</a>: <a href="#Programming-overview">Programming overview</a></li>
-<li><a href="#index-filename-aliases-571">filename aliases</a>: <a href="#Filename-aliases">Filename aliases</a></li>
-<li><a href="#index-filename-database-550">filename database</a>: <a href="#Filename-database">Filename database</a></li>
-<li><a href="#index-filename-database-generation-182">filename database generation</a>: <a href="#Filename-database-generation">Filename database generation</a></li>
-<li><a href="#index-filenames_002c-absolute-or-explicitly-relative-472">filenames, absolute or explicitly relative</a>: <a href="#Searching-overview">Searching overview</a></li>
-<li><a href="#index-files_002c-unable-to-find-386">files, unable to find</a>: <a href="#Unable-to-find-files">Unable to find files</a></li>
-<li><a href="#index-filesystem-search-461">filesystem search</a>: <a href="#Searching-overview">Searching overview</a></li>
-<li><a href="#index-floating-directories-460">floating directories</a>: <a href="#Searching-overview">Searching overview</a></li>
-<li><a href="#index-fmtutil-240"><code>fmtutil</code></a>: <a href="#mktex-script-names">mktex script names</a></li>
-<li><a href="#index-fmtutil_002ecnf-598"><code>fmtutil.cnf</code></a>: <a href="#Specially_002drecognized-files">Specially-recognized files</a></li>
-<li><a href="#index-fmtutils_002ecnf-202"><code>fmtutils.cnf</code></a>: <a href="#mktex-configuration">mktex configuration</a></li>
-<li><a href="#index-font-alias-files-753">font alias files</a>: <a href="#Fontmap">Fontmap</a></li>
-<li><a href="#index-font-generation-failures-395">font generation failures</a>: <a href="#Unable-to-generate-fonts">Unable to generate fonts</a></li>
-<li><a href="#index-font-of-last-resort-764">font of last resort</a>: <a href="#Fallback-font">Fallback font</a></li>
-<li><a href="#index-font-set_002c-infinite-186">font set, infinite</a>: <a href="#mktex-scripts">mktex scripts</a></li>
-<li><a href="#index-fontmap-files-752">fontmap files</a>: <a href="#Fontmap">Fontmap</a></li>
-<li><a href="#index-fontmaps-215"><code>fontmaps</code></a>: <a href="#mktex-configuration">mktex configuration</a></li>
-<li><a href="#index-fontname-217">fontname</a>: <a href="#mktex-configuration">mktex configuration</a></li>
-<li><a href="#index-fontnames_002c-arbitrary-length-756">fontnames, arbitrary length</a>: <a href="#Fontmap">Fontmap</a></li>
-<li><a href="#index-fonts_002c-being-created-37">fonts, being created</a>: <a href="#Simple-installation">Simple installation</a></li>
-<li><a href="#index-FOOINPUTS-730"><code>FOOINPUTS</code></a>: <a href="#Supported-file-formats">Supported file formats</a></li>
-<li><a href="#index-fopen_0040r_007b_002c-redefined_007d-361"><code>fopen</code><span class="roman">, redefined</span></a>: <a href="#Debugging">Debugging</a></li>
-<li><a href="#index-format-of-external-database-573">format of external database</a>: <a href="#Database-format">Database format</a></li>
-<li><a href="#index-Free-Software-Foundation-298">Free Software Foundation</a>: <a href="#CD_002dROM-distribution">CD-ROM distribution</a></li>
-<li><a href="#index-FreeBSD-_0040code_007bconfigure_007d-error-420">FreeBSD <code>configure</code> error</a>: <a href="#Empty-Makefiles">Empty Makefiles</a></li>
-<li><a href="#index-FreeBSD-shells-and-_0040code_007bconfigure_007d-100">FreeBSD shells and <code>configure</code></a>: <a href="#configure-shells">configure shells</a></li>
-<li><a href="#index-FSF-Source-Code-CD_002dROM-299">FSF Source Code CD-ROM</a>: <a href="#CD_002dROM-distribution">CD-ROM distribution</a></li>
-<li><a href="#index-ftp-retrieval-281">ftp retrieval</a>: <a href="#Electronic-distribution">Electronic distribution</a></li>
-<li><a href="#index-ftp_002etug_002eorg-280"><code>ftp.tug.org</code></a>: <a href="#unixtex_002eftp">unixtex.ftp</a></li>
+<li><a href="#index-config-files-483">config files</a>: <a href="#Config-files">Config files</a></li>
+<li><a href="#index-config-files_002c-for-Kpathsea_002dusing-programs-828">config files, for Kpathsea-using programs</a>: <a href="#Calling-sequence">Calling sequence</a></li>
+<li><a href="#index-config-files_002c-programming-with-843">config files, programming with</a>: <a href="#Programming-with-config-files">Programming with config files</a></li>
+<li><a href="#index-config_002eh-805"><code>config.h</code></a>: <a href="#Programming-overview">Programming overview</a></li>
+<li><a href="#index-config_002elog-320"><code>config.log</code></a>: <a href="#Bug-checklist">Bug checklist</a></li>
+<li><a href="#index-config_002eps-593"><code>config.ps</code></a>: <a href="#Specially_002drecognized-files">Specially-recognized files</a></li>
+<li><a href="#index-config_002eps_0040r_007b_002c-search-path-for_007d-638"><code>config.ps</code><span class="roman">, search path for</span></a>: <a href="#Supported-file-formats">Supported file formats</a></li>
+<li><a href="#index-config_002estatus-322"><code>config.status</code></a>: <a href="#Bug-checklist">Bug checklist</a></li>
+<li><a href="#index-configuration-27">configuration</a>: <a href="#Installation">Installation</a></li>
+<li><a href="#index-configuration-bugs-321">configuration bugs</a>: <a href="#Bug-checklist">Bug checklist</a></li>
+<li><a href="#index-configuration-compiler-options-118">configuration compiler options</a>: <a href="#configure-environment">configure environment</a></li>
+<li><a href="#index-configuration-file_002c-source-for-path-479">configuration file, source for path</a>: <a href="#Path-sources">Path sources</a></li>
+<li><a href="#index-configuration-files-as-shell-scripts_002e-499">configuration files as shell scripts.</a>: <a href="#Config-files">Config files</a></li>
+<li><a href="#index-configuration-of-_0040file_007bmktex_007d-scripts-190">configuration of <samp><span class="file">mktex</span></samp> scripts</a>: <a href="#mktex-configuration">mktex configuration</a></li>
+<li><a href="#index-configuration-of-optional-features-107">configuration of optional features</a>: <a href="#configure-options">configure options</a></li>
+<li><a href="#index-configure-_0040r_007berror-from-_0040code_007bsed_007d_007d-415"><code>configure </code><span class="roman">error from </span><code>sed</code></a>: <a href="#Empty-Makefiles">Empty Makefiles</a></li>
+<li><a href="#index-g_t_0040code_007bconfigure_007d-options-104"><code>configure</code> options</a>: <a href="#configure-options">configure options</a></li>
+<li><a href="#index-g_t_0040code_007bconfigure_007d-options-for-_0040file_007bmktex_007d-scripts-193"><code>configure</code> options for <samp><span class="file">mktex</span></samp> scripts</a>: <a href="#mktex-configuration">mktex configuration</a></li>
+<li><a href="#index-configure_0040r_007b_002c-running_007d-83"><code>configure</code><span class="roman">, running</span></a>: <a href="#Running-configure">Running configure</a></li>
+<li><a href="#index-context-diff-323">context diff</a>: <a href="#Bug-checklist">Bug checklist</a></li>
+<li><a href="#index-continuation-character-493">continuation character</a>: <a href="#Config-files">Config files</a></li>
+<li><a href="#index-core-dumps_002c-reporting-329">core dumps, reporting</a>: <a href="#Bug-checklist">Bug checklist</a></li>
+<li><a href="#index-CPPFLAGS-117"><code>CPPFLAGS</code></a>: <a href="#configure-environment">configure environment</a></li>
+<li><a href="#index-crashes_002c-reporting-328">crashes, reporting</a>: <a href="#Bug-checklist">Bug checklist</a></li>
+<li><a href="#index-CTAN_002c-defined-283">CTAN, defined</a>: <a href="#Electronic-distribution">Electronic distribution</a></li>
+<li><a href="#index-CTAN_002esites-286"><code>CTAN.sites</code></a>: <a href="#Electronic-distribution">Electronic distribution</a></li>
+<li><a href="#index-custom-installation-39">custom installation</a>: <a href="#Custom-installation">Custom installation</a></li>
+<li><a href="#index-CWEBINPUTS-636"><code>CWEBINPUTS</code></a>: <a href="#Supported-file-formats">Supported file formats</a></li>
+<li><a href="#index-database-search-455">database search</a>: <a href="#Searching-overview">Searching overview</a></li>
+<li><a href="#index-database_002c-for-filenames-548">database, for filenames</a>: <a href="#Filename-database">Filename database</a></li>
+<li><a href="#index-database_002c-format-of-571">database, format of</a>: <a href="#Database-format">Database format</a></li>
+<li><a href="#index-debug_002eh-347"><code>debug.h</code></a>: <a href="#Debugging">Debugging</a></li>
+<li><a href="#index-debugger-327">debugger</a>: <a href="#Bug-checklist">Bug checklist</a></li>
+<li><a href="#index-debugging-343">debugging</a>: <a href="#Debugging">Debugging</a></li>
+<li><a href="#index-debugging-options_002c-in-Kpathsea_002dusing-program-824">debugging options, in Kpathsea-using program</a>: <a href="#Calling-sequence">Calling sequence</a></li>
+<li><a href="#index-debugging-output-351">debugging output</a>: <a href="#Debugging">Debugging</a></li>
+<li><a href="#index-debugging-with-_0040samp_007b_002dg_007d_002c-disabling-137">debugging with &lsquo;<samp><span class="samp">-g</span></samp>&rsquo;, disabling</a>: <a href="#configure-scenarios">configure scenarios</a></li>
+<li><a href="#index-DEC-shells-and-_0040code_007bconfigure_007d-101">DEC shells and <code>configure</code></a>: <a href="#configure-shells">configure shells</a></li>
+<li><a href="#index-default-expansion-508">default expansion</a>: <a href="#Default-expansion">Default expansion</a></li>
+<li><a href="#index-default-path-features-66">default path features</a>: <a href="#Default-path-features">Default path features</a></li>
+<li><a href="#index-default-paths_002c-changing-74">default paths, changing</a>: <a href="#Default-path-generation">Default path generation</a></li>
+<li><a href="#index-default-paths_002c-how-they_0027re-made-78">default paths, how they're made</a>: <a href="#Default-path-generation">Default path generation</a></li>
+<li><a href="#index-default_005ftexsizes-780"><code>default_texsizes</code></a>: <a href="#Fallback-font">Fallback font</a></li>
+<li><a href="#index-DEFS-119"><code>DEFS</code></a>: <a href="#configure-environment">configure environment</a></li>
+<li><a href="#index-depot-132"><code>depot</code></a>: <a href="#configure-scenarios">configure scenarios</a></li>
+<li><a href="#index-device_002c-wrong-395">device, wrong</a>: <a href="#Unable-to-generate-fonts">Unable to generate fonts</a></li>
+<li><a href="#index-directories_002c-changing-default-installation-77">directories, changing default installation</a>: <a href="#Default-path-generation">Default path generation</a></li>
+<li><a href="#index-directories_002c-making-append_002donly-208">directories, making append-only</a>: <a href="#mktex-configuration">mktex configuration</a></li>
+<li><a href="#index-directory-permissions-267">directory permissions</a>: <a href="#Security">Security</a></li>
+<li><a href="#index-directory-structure_002c-for-_0040TeX_007b_007d-files-271">directory structure, for TeX files</a>: <a href="#TeX-directory-structure">TeX directory structure</a></li>
+<li><a href="#index-disabling-_0040file_007bmktex_007d-scripts-192">disabling <samp><span class="file">mktex</span></samp> scripts</a>: <a href="#mktex-configuration">mktex configuration</a></li>
+<li><a href="#index-disk-search-459">disk search</a>: <a href="#Searching-overview">Searching overview</a></li>
+<li><a href="#index-disk-searching_002c-avoiding-567">disk searching, avoiding</a>: <a href="#ls_002dR">ls-R</a></li>
+<li><a href="#index-disk-space_002c-needed-46">disk space, needed</a>: <a href="#Disk-space">Disk space</a></li>
+<li><a href="#index-disk-usage_002c-reducing-374">disk usage, reducing</a>: <a href="#Logging">Logging</a></li>
+<li><a href="#index-distclean-_0040r_007bMake-target_007d-176"><code>distclean </code><span class="roman">Make target</span></a>: <a href="#Cleaning-up">Cleaning up</a></li>
+<li><a href="#index-distributions_002c-compiling-simultaneously-49">distributions, compiling simultaneously</a>: <a href="#Kpathsea-application-distributions">Kpathsea application distributions</a></li>
+<li><a href="#index-distributions_002c-not-compiling-52">distributions, not compiling</a>: <a href="#Kpathsea-application-distributions">Kpathsea application distributions</a></li>
+<li><a href="#index-distributions_002c-on-CD_002dROM-295">distributions, on CD-ROM</a>: <a href="#CD_002dROM-distribution">CD-ROM distribution</a></li>
+<li><a href="#index-distributions_002c-via-ftp-282">distributions, via ftp</a>: <a href="#Electronic-distribution">Electronic distribution</a></li>
+<li><a href="#index-dlclose-425"><code>dlclose</code></a>: <a href="#dlopen">dlopen</a></li>
+<li><a href="#index-dlopen-423"><code>dlopen</code></a>: <a href="#dlopen">dlopen</a></li>
+<li><a href="#index-dlsym-424"><code>dlsym</code></a>: <a href="#dlopen">dlopen</a></li>
+<li><a href="#index-dlsym_002ec-428"><code>dlsym.c</code></a>: <a href="#dlopen">dlopen</a></li>
+<li><a href="#index-doc-files-712"><code>doc files</code></a>: <a href="#Supported-file-formats">Supported file formats</a></li>
+<li><a href="#index-DOS-compatible-names-212">DOS compatible names</a>: <a href="#mktex-configuration">mktex configuration</a></li>
+<li><a href="#index-DOS-support-43">DOS support</a>: <a href="#Custom-installation">Custom installation</a></li>
+<li><a href="#index-DOS-_0040TeX_007b_007d-implementations-306">DOS TeX implementations</a>: <a href="#Other-TeX-packages">Other TeX packages</a></li>
+<li><a href="#index-dosnames-210"><code>dosnames</code></a>: <a href="#mktex-configuration">mktex configuration</a></li>
+<li><a href="#index-dot-files-556">dot files</a>: <a href="#ls_002dR">ls-R</a></li>
+<li><a href="#index-doubled-colons-504">doubled colons</a>: <a href="#Default-expansion">Default expansion</a></li>
+<li><a href="#index-dpi_0040var_007bnnn_007d-directories-213"><code>dpi</code><var>nnn</var><code> directories</code></a>: <a href="#mktex-configuration">mktex configuration</a></li>
+<li><a href="#index-DVI-drivers-55">DVI drivers</a>: <a href="#Kpathsea-application-distributions">Kpathsea application distributions</a></li>
+<li><a href="#index-DVILJMAKEPK-248"><code>DVILJMAKEPK</code></a>: <a href="#mktex-script-names">mktex script names</a></li>
+<li><a href="#index-DVILJSIZES-778"><code>DVILJSIZES</code></a>: <a href="#Fallback-font">Fallback font</a></li>
+<li><a href="#index-dvipdfmx_002ecfg-594"><code>dvipdfmx.cfg</code></a>: <a href="#Specially_002drecognized-files">Specially-recognized files</a></li>
+<li><a href="#index-DVIPSFONTS-742"><code>DVIPSFONTS</code></a>: <a href="#Supported-file-formats">Supported file formats</a></li>
+<li><a href="#index-DVIPSHEADERS-731"><code>DVIPSHEADERS</code></a>: <a href="#Supported-file-formats">Supported file formats</a></li>
+<li><a href="#index-DVIPSMAKEPK-246"><code>DVIPSMAKEPK</code></a>: <a href="#mktex-script-names">mktex script names</a></li>
+<li><a href="#index-DVIPSSIZES-776"><code>DVIPSSIZES</code></a>: <a href="#Fallback-font">Fallback font</a></li>
+<li><a href="#index-dynamic-creation-of-files-186">dynamic creation of files</a>: <a href="#mktex-scripts">mktex scripts</a></li>
+<li><a href="#index-dynamic-linking-problems-with-OpenWin-libraries-429">dynamic linking problems with OpenWin libraries</a>: <a href="#ShellWidgetClass">ShellWidgetClass</a></li>
+<li><a href="#index-EC-fonts_002c-and-dynamic-source-creation-188">EC fonts, and dynamic source creation</a>: <a href="#mktex-scripts">mktex scripts</a></li>
+<li><a href="#index-elt_002ddirs_002ec-545"><code>elt-dirs.c</code></a>: <a href="#Subdirectory-expansion">Subdirectory expansion</a></li>
+<li><a href="#index-email-CTAN-access-289">email CTAN access</a>: <a href="#Electronic-distribution">Electronic distribution</a></li>
+<li><a href="#index-enabling-_0040file_007bmktex_007d-scripts-191">enabling <samp><span class="file">mktex</span></samp> scripts</a>: <a href="#mktex-configuration">mktex configuration</a></li>
+<li><a href="#index-ENCFONTS-640"><code>ENCFONTS</code></a>: <a href="#Supported-file-formats">Supported file formats</a></li>
+<li><a href="#index-engine-name-582">engine name</a>: <a href="#Path-searching-options">Path searching options</a></li>
+<li><a href="#index-environment-variable_002c-source-for-path-478">environment variable, source for path</a>: <a href="#Path-sources">Path sources</a></li>
+<li><a href="#index-environment-variables-for-_0040TeX_007b_007d-617">environment variables for TeX</a>: <a href="#Supported-file-formats">Supported file formats</a></li>
+<li><a href="#index-environment-variables-in-paths-513">environment variables in paths</a>: <a href="#Variable-expansion">Variable expansion</a></li>
+<li><a href="#index-environment-variables_002c-old-385">environment variables, old</a>: <a href="#Unable-to-find-files">Unable to find files</a></li>
+<li><a href="#index-epoch_002c-seconds-since-376">epoch, seconds since</a>: <a href="#Logging">Logging</a></li>
+<li><a href="#index-error-message-macros-816">error message macros</a>: <a href="#Calling-sequence">Calling sequence</a></li>
+<li><a href="#index-excessive-startup-time-388">excessive startup time</a>: <a href="#Slow-path-searching">Slow path searching</a></li>
+<li><a href="#index-expand_002ec-533"><code>expand.c</code></a>: <a href="#Brace-expansion">Brace expansion</a></li>
+<li><a href="#index-expanding-symlinks-822">expanding symlinks</a>: <a href="#Calling-sequence">Calling sequence</a></li>
+<li><a href="#index-expansion_002c-default-509">expansion, default</a>: <a href="#Default-expansion">Default expansion</a></li>
+<li><a href="#index-expansion_002c-path-element-465">expansion, path element</a>: <a href="#Searching-overview">Searching overview</a></li>
+<li><a href="#index-expansion_002c-search-path-502">expansion, search path</a>: <a href="#Path-expansion">Path expansion</a></li>
+<li><a href="#index-expansion_002c-subdirectory-537">expansion, subdirectory</a>: <a href="#Subdirectory-expansion">Subdirectory expansion</a></li>
+<li><a href="#index-expansion_002c-tilde-523">expansion, tilde</a>: <a href="#Tilde-expansion">Tilde expansion</a></li>
+<li><a href="#index-expansion_002c-variable-515">expansion, variable</a>: <a href="#Variable-expansion">Variable expansion</a></li>
+<li><a href="#index-explicitly-relative-filenames-468">explicitly relative filenames</a>: <a href="#Searching-overview">Searching overview</a></li>
+<li><a href="#index-extensions_002c-filename-746">extensions, filename</a>: <a href="#File-lookup">File lookup</a></li>
+<li><a href="#index-externally_002dbuilt-filename-database-549">externally-built filename database</a>: <a href="#Filename-database">Filename database</a></li>
+<li><a href="#index-extra-colons-507">extra colons</a>: <a href="#Default-expansion">Default expansion</a></li>
+<li><a href="#index-extraclean-_0040r_007bMake-target_007d-180"><code>extraclean </code><span class="roman">Make target</span></a>: <a href="#Cleaning-up">Cleaning up</a></li>
+<li><a href="#index-failed-_0040code_007bmktex_0040dots_007b_007d_007d-script-invocation-250">failed <code>mktex...</code> script invocation</a>: <a href="#mktex-script-names">mktex script names</a></li>
+<li><a href="#index-fallback-font-771">fallback font</a>: <a href="#Fallback-font">Fallback font</a></li>
+<li><a href="#index-fallback-resolutions-772">fallback resolutions</a>: <a href="#Fallback-font">Fallback font</a></li>
+<li><a href="#index-fallback-resolutions_002c-overriding-144">fallback resolutions, overriding</a>: <a href="#Running-make">Running make</a></li>
+<li><a href="#index-FAQ_002c-_0040t_007bcomp_002esys_002esun_002eadmin_007d-434">FAQ, <tt>comp.sys.sun.admin</tt></a>: <a href="#ShellWidgetClass">ShellWidgetClass</a></li>
+<li><a href="#index-FAQ_002c-Kpathsea-381">FAQ, Kpathsea</a>: <a href="#Common-problems">Common problems</a></li>
+<li><a href="#index-Farwell_002c-Matthew-541">Farwell, Matthew</a>: <a href="#Subdirectory-expansion">Subdirectory expansion</a></li>
+<li><a href="#index-features_002c-of-default-paths-67">features, of default paths</a>: <a href="#Default-path-features">Default path features</a></li>
+<li><a href="#index-file-formats_002c-supported-616">file formats, supported</a>: <a href="#Supported-file-formats">Supported file formats</a></li>
+<li><a href="#index-file-lookup-743">file lookup</a>: <a href="#File-lookup">File lookup</a></li>
+<li><a href="#index-file-permissions-265">file permissions</a>: <a href="#Security">Security</a></li>
+<li><a href="#index-file-types_002c-registering-new-807">file types, registering new</a>: <a href="#Programming-overview">Programming overview</a></li>
+<li><a href="#index-filename-aliases-568">filename aliases</a>: <a href="#Filename-aliases">Filename aliases</a></li>
+<li><a href="#index-filename-database-547">filename database</a>: <a href="#Filename-database">Filename database</a></li>
+<li><a href="#index-filename-database-generation-181">filename database generation</a>: <a href="#Filename-database-generation">Filename database generation</a></li>
+<li><a href="#index-filenames_002c-absolute-or-explicitly-relative-469">filenames, absolute or explicitly relative</a>: <a href="#Searching-overview">Searching overview</a></li>
+<li><a href="#index-files_002c-unable-to-find-383">files, unable to find</a>: <a href="#Unable-to-find-files">Unable to find files</a></li>
+<li><a href="#index-filesystem-search-458">filesystem search</a>: <a href="#Searching-overview">Searching overview</a></li>
+<li><a href="#index-floating-directories-457">floating directories</a>: <a href="#Searching-overview">Searching overview</a></li>
+<li><a href="#index-fmtutil-239"><code>fmtutil</code></a>: <a href="#mktex-script-names">mktex script names</a></li>
+<li><a href="#index-fmtutil_002ecnf-595"><code>fmtutil.cnf</code></a>: <a href="#Specially_002drecognized-files">Specially-recognized files</a></li>
+<li><a href="#index-fmtutils_002ecnf-201"><code>fmtutils.cnf</code></a>: <a href="#mktex-configuration">mktex configuration</a></li>
+<li><a href="#index-font-alias-files-762">font alias files</a>: <a href="#Fontmap">Fontmap</a></li>
+<li><a href="#index-font-generation-failures-392">font generation failures</a>: <a href="#Unable-to-generate-fonts">Unable to generate fonts</a></li>
+<li><a href="#index-font-of-last-resort-773">font of last resort</a>: <a href="#Fallback-font">Fallback font</a></li>
+<li><a href="#index-font-set_002c-infinite-185">font set, infinite</a>: <a href="#mktex-scripts">mktex scripts</a></li>
+<li><a href="#index-FONTCIDMAPS-645"><code>FONTCIDMAPS</code></a>: <a href="#Supported-file-formats">Supported file formats</a></li>
+<li><a href="#index-FONTFEATURES-647"><code>FONTFEATURES</code></a>: <a href="#Supported-file-formats">Supported file formats</a></li>
+<li><a href="#index-fontmap-files-761">fontmap files</a>: <a href="#Fontmap">Fontmap</a></li>
+<li><a href="#index-fontmaps-214"><code>fontmaps</code></a>: <a href="#mktex-configuration">mktex configuration</a></li>
+<li><a href="#index-fontname-216">fontname</a>: <a href="#mktex-configuration">mktex configuration</a></li>
+<li><a href="#index-fontnames_002c-arbitrary-length-765">fontnames, arbitrary length</a>: <a href="#Fontmap">Fontmap</a></li>
+<li><a href="#index-fonts_002c-being-created-36">fonts, being created</a>: <a href="#Simple-installation">Simple installation</a></li>
+<li><a href="#index-FOOINPUTS-739"><code>FOOINPUTS</code></a>: <a href="#Supported-file-formats">Supported file formats</a></li>
+<li><a href="#index-fopen_0040r_007b_002c-redefined_007d-358"><code>fopen</code><span class="roman">, redefined</span></a>: <a href="#Debugging">Debugging</a></li>
+<li><a href="#index-format-of-external-database-570">format of external database</a>: <a href="#Database-format">Database format</a></li>
+<li><a href="#index-Free-Software-Foundation-297">Free Software Foundation</a>: <a href="#CD_002dROM-distribution">CD-ROM distribution</a></li>
+<li><a href="#index-FreeBSD-_0040code_007bconfigure_007d-error-417">FreeBSD <code>configure</code> error</a>: <a href="#Empty-Makefiles">Empty Makefiles</a></li>
+<li><a href="#index-FreeBSD-shells-and-_0040code_007bconfigure_007d-99">FreeBSD shells and <code>configure</code></a>: <a href="#configure-shells">configure shells</a></li>
+<li><a href="#index-FSF-Source-Code-CD_002dROM-298">FSF Source Code CD-ROM</a>: <a href="#CD_002dROM-distribution">CD-ROM distribution</a></li>
+<li><a href="#index-ftp-retrieval-280">ftp retrieval</a>: <a href="#Electronic-distribution">Electronic distribution</a></li>
+<li><a href="#index-ftp_002etug_002eorg-279"><code>ftp.tug.org</code></a>: <a href="#unixtex_002eftp">unixtex.ftp</a></li>
<li><a href="#index-fundamental-purpose-of-Kpathsea-2">fundamental purpose of Kpathsea</a>: <a href="#Introduction">Introduction</a></li>
-<li><a href="#index-gcc_0040r_007b_002c-compiling-with_007d-114"><code>gcc</code><span class="roman">, compiling with</span></a>: <a href="#configure-environment">configure environment</a></li>
-<li><a href="#index-gdb_0040r_007b_002c-recommended_007d-332"><code>gdb</code><span class="roman">, recommended</span></a>: <a href="#Bug-checklist">Bug checklist</a></li>
-<li><a href="#index-generation-of-filename-database-183">generation of filename database</a>: <a href="#Filename-database-generation">Filename database generation</a></li>
-<li><a href="#index-get_005fapplicationShellWidgetClass-435"><code>get_applicationShellWidgetClass</code></a>: <a href="#ShellWidgetClass">ShellWidgetClass</a></li>
-<li><a href="#index-get_005fwmShellWidgetClass-434"><code>get_wmShellWidgetClass</code></a>: <a href="#ShellWidgetClass">ShellWidgetClass</a></li>
-<li><a href="#index-gf-646"><code>gf</code></a>: <a href="#Supported-file-formats">Supported file formats</a></li>
-<li><a href="#index-GFFONTS-647"><code>GFFONTS</code></a>: <a href="#Supported-file-formats">Supported file formats</a></li>
-<li><a href="#index-globally-writable-directories-262">globally writable directories</a>: <a href="#Security">Security</a></li>
-<li><a href="#index-glyph-lookup-742">glyph lookup</a>: <a href="#Glyph-lookup">Glyph lookup</a></li>
-<li><a href="#index-glyph-lookup-bitmap-tolerance-750">glyph lookup bitmap tolerance</a>: <a href="#Basic-glyph-lookup">Basic glyph lookup</a></li>
-<li><a href="#index-GLYPHFONTS-648"><code>GLYPHFONTS</code></a>: <a href="#Supported-file-formats">Supported file formats</a></li>
-<li><a href="#index-glyphlist_002etxt-599"><code>glyphlist.txt</code></a>: <a href="#Specially_002drecognized-files">Specially-recognized files</a></li>
-<li><a href="#index-GNU-C-compiler-bugs-410">GNU C compiler bugs</a>: <a href="#TeX-or-Metafont-failing">TeX or Metafont failing</a></li>
+<li><a href="#index-gcc_0040r_007b_002c-compiling-with_007d-113"><code>gcc</code><span class="roman">, compiling with</span></a>: <a href="#configure-environment">configure environment</a></li>
+<li><a href="#index-gdb_0040r_007b_002c-recommended_007d-331"><code>gdb</code><span class="roman">, recommended</span></a>: <a href="#Bug-checklist">Bug checklist</a></li>
+<li><a href="#index-generation-of-filename-database-182">generation of filename database</a>: <a href="#Filename-database-generation">Filename database generation</a></li>
+<li><a href="#index-get_005fapplicationShellWidgetClass-432"><code>get_applicationShellWidgetClass</code></a>: <a href="#ShellWidgetClass">ShellWidgetClass</a></li>
+<li><a href="#index-get_005fwmShellWidgetClass-431"><code>get_wmShellWidgetClass</code></a>: <a href="#ShellWidgetClass">ShellWidgetClass</a></li>
+<li><a href="#index-gf-648"><code>gf</code></a>: <a href="#Supported-file-formats">Supported file formats</a></li>
+<li><a href="#index-GFFONTS-649"><code>GFFONTS</code></a>: <a href="#Supported-file-formats">Supported file formats</a></li>
+<li><a href="#index-globally-writable-directories-261">globally writable directories</a>: <a href="#Security">Security</a></li>
+<li><a href="#index-glyph-lookup-751">glyph lookup</a>: <a href="#Glyph-lookup">Glyph lookup</a></li>
+<li><a href="#index-glyph-lookup-bitmap-tolerance-759">glyph lookup bitmap tolerance</a>: <a href="#Basic-glyph-lookup">Basic glyph lookup</a></li>
+<li><a href="#index-GLYPHFONTS-650"><code>GLYPHFONTS</code></a>: <a href="#Supported-file-formats">Supported file formats</a></li>
+<li><a href="#index-glyphlist_002etxt-596"><code>glyphlist.txt</code></a>: <a href="#Specially_002drecognized-files">Specially-recognized files</a></li>
+<li><a href="#index-GNU-C-compiler-bugs-407">GNU C compiler bugs</a>: <a href="#TeX-or-Metafont-failing">TeX or Metafont failing</a></li>
<li><a href="#index-GNU-General-Public-License-9">GNU General Public License</a>: <a href="#Introduction">Introduction</a></li>
-<li><a href="#index-group_002dwritable-directories-264">group-writable directories</a>: <a href="#Security">Security</a></li>
-<li><a href="#index-GSFTOPK_005fDEBUG-_0040r_007b_0028128_0029_007d-367"><code>GSFTOPK_DEBUG </code><span class="roman">(128)</span></a>: <a href="#Debugging">Debugging</a></li>
-<li><a href="#index-hash-table-buckets_002c-printing-372">hash table buckets, printing</a>: <a href="#Debugging">Debugging</a></li>
-<li><a href="#index-hash-table-routines-824">hash table routines</a>: <a href="#Calling-sequence">Calling sequence</a></li>
-<li><a href="#index-hash_005fsummary_005fonly-_0040r_007bvariable-for-debugging_007d-371"><code>hash_summary_only </code><span class="roman">variable for debugging</span></a>: <a href="#Debugging">Debugging</a></li>
-<li><a href="#index-help_002c-mailing-list-for-general-_0040TeX_007b_007d-343">help, mailing list for general TeX</a>: <a href="#Mailing-lists">Mailing lists</a></li>
-<li><a href="#index-HIER-73"><code>HIER</code></a>: <a href="#Default-path-features">Default path features</a></li>
-<li><a href="#index-history-of-Kpathsea-12">history of Kpathsea</a>: <a href="#History">History</a></li>
-<li><a href="#index-home-directories-in-paths-524">home directories in paths</a>: <a href="#Tilde-expansion">Tilde expansion</a></li>
-<li><a href="#index-HOME_0040r_007b_002c-as-_007e-expansion_007d-527"><code>HOME</code><span class="roman">, as ~ expansion</span></a>: <a href="#Tilde-expansion">Tilde expansion</a></li>
-<li><a href="#index-HP_002dUX_002c-compiling-on-414">HP-UX, compiling on</a>: <a href="#TeX-or-Metafont-failing">TeX or Metafont failing</a></li>
-<li><a href="#index-identifiers_002c-characters-valid-in-499">identifiers, characters valid in</a>: <a href="#Config-files">Config files</a></li>
-<li><a href="#index-illegal-pointer-combination-warnings-448">illegal pointer combination warnings</a>: <a href="#Pointer-combination-warnings">Pointer combination warnings</a></li>
-<li><a href="#index-include-_0040r_007bfontmap-directive_007d-761"><code>include </code><span class="roman">fontmap directive</span></a>: <a href="#Fontmap">Fontmap</a></li>
-<li><a href="#index-INDEXSTYLE-656"><code>INDEXSTYLE</code></a>: <a href="#Supported-file-formats">Supported file formats</a></li>
-<li><a href="#index-info_002dtex_0040_0040shsu_002eedu-344"><code>info-tex@shsu.edu</code></a>: <a href="#Mailing-lists">Mailing lists</a></li>
-<li><a href="#index-input-lines_002c-reading-828">input lines, reading</a>: <a href="#Calling-sequence">Calling sequence</a></li>
-<li><a href="#index-install_002ddata-_0040r_007bMake-target_007d-171"><code>install-data </code><span class="roman">Make target</span></a>: <a href="#Installing-files">Installing files</a></li>
-<li><a href="#index-install_002dexec-_0040r_007bMake-target_007d-170"><code>install-exec </code><span class="roman">Make target</span></a>: <a href="#Installing-files">Installing files</a></li>
-<li><a href="#index-installation-27">installation</a>: <a href="#Installation">Installation</a></li>
-<li><a href="#index-installation-testing-256">installation testing</a>: <a href="#Installation-testing">Installation testing</a></li>
-<li><a href="#index-installation_002c-architecture_002d_0028in_0029dependent-files-only-169">installation, architecture-(in)dependent files only</a>: <a href="#Installing-files">Installing files</a></li>
-<li><a href="#index-installation_002c-changing-default-directories-77">installation, changing default directories</a>: <a href="#Default-path-generation">Default path generation</a></li>
-<li><a href="#index-installation_002c-customized-41">installation, customized</a>: <a href="#Custom-installation">Custom installation</a></li>
-<li><a href="#index-installation_002c-getting-executables-instead-of-33">installation, getting executables instead of</a>: <a href="#Simple-installation">Simple installation</a></li>
-<li><a href="#index-installation_002c-simple-31">installation, simple</a>: <a href="#Simple-installation">Simple installation</a></li>
-<li><a href="#index-installing-files-166">installing files</a>: <a href="#Installing-files">Installing files</a></li>
-<li><a href="#index-interactive-query-588">interactive query</a>: <a href="#Path-searching-options">Path searching options</a></li>
+<li><a href="#index-group_002dwritable-directories-263">group-writable directories</a>: <a href="#Security">Security</a></li>
+<li><a href="#index-GSFTOPK_005fDEBUG-_0040r_007b_0028128_0029_007d-364"><code>GSFTOPK_DEBUG </code><span class="roman">(128)</span></a>: <a href="#Debugging">Debugging</a></li>
+<li><a href="#index-hash-table-buckets_002c-printing-369">hash table buckets, printing</a>: <a href="#Debugging">Debugging</a></li>
+<li><a href="#index-hash-table-routines-834">hash table routines</a>: <a href="#Calling-sequence">Calling sequence</a></li>
+<li><a href="#index-hash_005fsummary_005fonly-_0040r_007bvariable-for-debugging_007d-368"><code>hash_summary_only </code><span class="roman">variable for debugging</span></a>: <a href="#Debugging">Debugging</a></li>
+<li><a href="#index-help_002c-mailing-list-for-general-_0040TeX_007b_007d-340">help, mailing list for general TeX</a>: <a href="#Mailing-lists">Mailing lists</a></li>
+<li><a href="#index-HIER-72"><code>HIER</code></a>: <a href="#Default-path-features">Default path features</a></li>
+<li><a href="#index-history-of-Kpathsea-11">history of Kpathsea</a>: <a href="#History">History</a></li>
+<li><a href="#index-home-directories-in-paths-521">home directories in paths</a>: <a href="#Tilde-expansion">Tilde expansion</a></li>
+<li><a href="#index-HOME_0040r_007b_002c-as-_007e-expansion_007d-524"><code>HOME</code><span class="roman">, as ~ expansion</span></a>: <a href="#Tilde-expansion">Tilde expansion</a></li>
+<li><a href="#index-HP_002dUX_002c-compiling-on-411">HP-UX, compiling on</a>: <a href="#TeX-or-Metafont-failing">TeX or Metafont failing</a></li>
+<li><a href="#index-identifiers_002c-characters-valid-in-496">identifiers, characters valid in</a>: <a href="#Config-files">Config files</a></li>
+<li><a href="#index-illegal-pointer-combination-warnings-445">illegal pointer combination warnings</a>: <a href="#Pointer-combination-warnings">Pointer combination warnings</a></li>
+<li><a href="#index-include-_0040r_007bfontmap-directive_007d-770"><code>include </code><span class="roman">fontmap directive</span></a>: <a href="#Fontmap">Fontmap</a></li>
+<li><a href="#index-INDEXSTYLE-658"><code>INDEXSTYLE</code></a>: <a href="#Supported-file-formats">Supported file formats</a></li>
+<li><a href="#index-info_002dtex_0040_0040shsu_002eedu-341"><code>info-tex@shsu.edu</code></a>: <a href="#Mailing-lists">Mailing lists</a></li>
+<li><a href="#index-input-lines_002c-reading-838">input lines, reading</a>: <a href="#Calling-sequence">Calling sequence</a></li>
+<li><a href="#index-install_002ddata-_0040r_007bMake-target_007d-170"><code>install-data </code><span class="roman">Make target</span></a>: <a href="#Installing-files">Installing files</a></li>
+<li><a href="#index-install_002dexec-_0040r_007bMake-target_007d-169"><code>install-exec </code><span class="roman">Make target</span></a>: <a href="#Installing-files">Installing files</a></li>
+<li><a href="#index-installation-26">installation</a>: <a href="#Installation">Installation</a></li>
+<li><a href="#index-installation-testing-255">installation testing</a>: <a href="#Installation-testing">Installation testing</a></li>
+<li><a href="#index-installation_002c-architecture_002d_0028in_0029dependent-files-only-168">installation, architecture-(in)dependent files only</a>: <a href="#Installing-files">Installing files</a></li>
+<li><a href="#index-installation_002c-changing-default-directories-76">installation, changing default directories</a>: <a href="#Default-path-generation">Default path generation</a></li>
+<li><a href="#index-installation_002c-customized-40">installation, customized</a>: <a href="#Custom-installation">Custom installation</a></li>
+<li><a href="#index-installation_002c-getting-executables-instead-of-32">installation, getting executables instead of</a>: <a href="#Simple-installation">Simple installation</a></li>
+<li><a href="#index-installation_002c-simple-30">installation, simple</a>: <a href="#Simple-installation">Simple installation</a></li>
+<li><a href="#index-installing-files-165">installing files</a>: <a href="#Installing-files">Installing files</a></li>
+<li><a href="#index-interactive-query-585">interactive query</a>: <a href="#Path-searching-options">Path searching options</a></li>
<li><a href="#index-interface_002c-not-frozen-4">interface, not frozen</a>: <a href="#Introduction">Introduction</a></li>
<li><a href="#index-introduction-1">introduction</a>: <a href="#Introduction">Introduction</a></li>
-<li><a href="#index-g_t_0040samp_007bkdebug_003a_007d-370">&lsquo;<samp><span class="samp">kdebug:</span></samp>&rsquo;</a>: <a href="#Debugging">Debugging</a></li>
-<li><a href="#index-kdefault_002ec-514"><code>kdefault.c</code></a>: <a href="#Default-expansion">Default expansion</a></li>
-<li><a href="#index-Knuth_002c-Donald-E_002e-13">Knuth, Donald E.</a>: <a href="#History">History</a></li>
-<li><a href="#index-Knuth_002c-Donald-E_002e_002c-archive-of-programs-by-312">Knuth, Donald E., archive of programs by</a>: <a href="#Other-TeX-packages">Other TeX packages</a></li>
-<li><a href="#index-Knuth_002c-Donald-E_002e_002c-original-author-293">Knuth, Donald E., original author</a>: <a href="#Electronic-distribution">Electronic distribution</a></li>
-<li><a href="#index-Korn-shell_0040r_007b_002c-losing-with-_0040code_007bconfigure_007d_007d-96">Korn shell<span class="roman">, losing with </span><code>configure</code></a>: <a href="#configure-shells">configure shells</a></li>
-<li><a href="#index-Kpathsea-config-file_002c-source-for-path-483">Kpathsea config file, source for path</a>: <a href="#Path-sources">Path sources</a></li>
-<li><a href="#index-Kpathsea-version-number-52">Kpathsea version number</a>: <a href="#Kpathsea-application-distributions">Kpathsea application distributions</a></li>
-<li><a href="#index-kpathsea_002eh-793"><code>kpathsea.h</code></a>: <a href="#Programming-overview">Programming overview</a></li>
-<li><a href="#index-kpathsea_002fHIER-74"><code>kpathsea/HIER</code></a>: <a href="#Default-path-features">Default path features</a></li>
-<li><a href="#index-kpathsea_002fREADME_002eCONFIGURE-91"><code>kpathsea/README.CONFIGURE</code></a>: <a href="#Running-configure">Running configure</a></li>
-<li><a href="#index-KPATHSEA_005fDEBUG-805"><code>KPATHSEA_DEBUG</code></a>: <a href="#Calling-sequence">Calling sequence</a></li>
-<li><a href="#index-kpathsea_005fdebug-352"><code>kpathsea_debug</code></a>: <a href="#Debugging">Debugging</a></li>
-<li><a href="#index-KPATHSEA_005fDEBUG-351"><code>KPATHSEA_DEBUG</code></a>: <a href="#Debugging">Debugging</a></li>
-<li><a href="#index-kpathsea_005fdebug-349"><code>kpathsea_debug</code></a>: <a href="#Debugging">Debugging</a></li>
-<li><a href="#index-kpathsea_005fdebug-_0040r_007bvariable_007d-813"><code>kpathsea_debug </code><span class="roman">variable</span></a>: <a href="#Calling-sequence">Calling sequence</a></li>
-<li><a href="#index-KPATHSEA_005fWARNING-490"><code>KPATHSEA_WARNING</code></a>: <a href="#Config-files">Config files</a></li>
-<li><a href="#index-KPSE_005fBITMAP_005fTOLERANCE-751"><code>KPSE_BITMAP_TOLERANCE</code></a>: <a href="#Basic-glyph-lookup">Basic glyph lookup</a></li>
-<li><a href="#index-kpse_005fcnf_005fget-837"><code>kpse_cnf_get</code></a>: <a href="#Programming-with-config-files">Programming with config files</a></li>
-<li><a href="#index-KPSE_005fDEBUG_005fEXPAND-_0040r_007b_002816_0029_007d-364"><code>KPSE_DEBUG_EXPAND </code><span class="roman">(16)</span></a>: <a href="#Debugging">Debugging</a></li>
-<li><a href="#index-KPSE_005fDEBUG_005fFOPEN-_0040r_007b_00284_0029_007d-360"><code>KPSE_DEBUG_FOPEN </code><span class="roman">(4)</span></a>: <a href="#Debugging">Debugging</a></li>
-<li><a href="#index-KPSE_005fDEBUG_005fHASH-_0040r_007b_00282_0029_007d-359"><code>KPSE_DEBUG_HASH </code><span class="roman">(2)</span></a>: <a href="#Debugging">Debugging</a></li>
-<li><a href="#index-KPSE_005fDEBUG_005fPATHS-_0040r_007b_00288_0029_007d-362"><code>KPSE_DEBUG_PATHS </code><span class="roman">(8)</span></a>: <a href="#Debugging">Debugging</a></li>
-<li><a href="#index-KPSE_005fDEBUG_005fSEARCH-_0040r_007b_002832_0029_007d-365"><code>KPSE_DEBUG_SEARCH </code><span class="roman">(32)</span></a>: <a href="#Debugging">Debugging</a></li>
-<li><a href="#index-KPSE_005fDEBUG_005fSTAT-_0040r_007b_00281_0029_007d-358"><code>KPSE_DEBUG_STAT </code><span class="roman">(1)</span></a>: <a href="#Debugging">Debugging</a></li>
-<li><a href="#index-KPSE_005fDEBUG_005fVARS-_0040r_007b_002864_0029_007d-366"><code>KPSE_DEBUG_VARS </code><span class="roman">(64)</span></a>: <a href="#Debugging">Debugging</a></li>
-<li><a href="#index-KPSE_005fDOT-_0040r_007bexpansion_007d-537"><code>KPSE_DOT </code><span class="roman">expansion</span></a>: <a href="#KPSE_005fDOT-expansion">KPSE_DOT expansion</a></li>
-<li><a href="#index-kpse_005ffallback_005ffont-773"><code>kpse_fallback_font</code></a>: <a href="#Fallback-font">Fallback font</a></li>
-<li><a href="#index-kpse_005ffind_005f_002a-821"><code>kpse_find_*</code></a>: <a href="#Calling-sequence">Calling sequence</a></li>
-<li><a href="#index-kpse_005ffind_005ffile-822"><code>kpse_find_file</code></a>: <a href="#Calling-sequence">Calling sequence</a></li>
-<li><a href="#index-kpse_005ffind_005ffile-741"><code>kpse_find_file</code></a>: <a href="#File-lookup">File lookup</a></li>
-<li><a href="#index-kpse_005ffind_005fglyph_005fformat-746"><code>kpse_find_glyph_format</code></a>: <a href="#Glyph-lookup">Glyph lookup</a></li>
-<li><a href="#index-kpse_005fformat_005finfo-816"><code>kpse_format_info</code></a>: <a href="#Calling-sequence">Calling sequence</a></li>
-<li><a href="#index-kpse_005fformat_005finfo_005ftype-363"><code>kpse_format_info_type</code></a>: <a href="#Debugging">Debugging</a></li>
-<li><a href="#index-kpse_005finit_005fprog-819"><code>kpse_init_prog</code></a>: <a href="#Calling-sequence">Calling sequence</a></li>
-<li><a href="#index-kpse_005finit_005fprog_0040r_007b_002c-and-_0040code_007bMAKETEX_005fMODE_007d_007d-71"><code>kpse_init_prog</code><span class="roman">, and </span><code>MAKETEX_MODE</code></a>: <a href="#Default-path-features">Default path features</a></li>
-<li><a href="#index-kpse_005fopen_005ffile-823"><code>kpse_open_file</code></a>: <a href="#Calling-sequence">Calling sequence</a></li>
-<li><a href="#index-kpse_005fprogram_005fname-803"><code>kpse_program_name</code></a>: <a href="#Calling-sequence">Calling sequence</a></li>
-<li><a href="#index-kpse_005fset_005fprogname-811"><code>kpse_set_progname</code></a>: <a href="#Calling-sequence">Calling sequence</a></li>
-<li><a href="#index-kpse_005fset_005fprogram_005fname-799"><code>kpse_set_program_name</code></a>: <a href="#Calling-sequence">Calling sequence</a></li>
-<li><a href="#index-kpse_005fvar_005fvalue-834"><code>kpse_var_value</code></a>: <a href="#Programming-with-config-files">Programming with config files</a></li>
-<li><a href="#index-kpsewhich-575"><code>kpsewhich</code></a>: <a href="#Invoking-kpsewhich">Invoking kpsewhich</a></li>
-<li><a href="#index-Kpsewhich_002c-and-debugging-356">Kpsewhich, and debugging</a>: <a href="#Debugging">Debugging</a></li>
-<li><a href="#index-ksh_0040r_007b_002c-losing-with-_0040code_007bconfigure_007d_007d-94"><code>ksh</code><span class="roman">, losing with </span><code>configure</code></a>: <a href="#configure-shells">configure shells</a></li>
-<li><a href="#index-labrea_002estanford_002eedu-311"><code>labrea.stanford.edu</code></a>: <a href="#Other-TeX-packages">Other TeX packages</a></li>
-<li><a href="#index-LaserJet-drive-58">LaserJet drive</a>: <a href="#Kpathsea-application-distributions">Kpathsea application distributions</a></li>
-<li><a href="#index-last_002dresort-font-766">last-resort font</a>: <a href="#Fallback-font">Fallback font</a></li>
-<li><a href="#index-La_0040TeX_007b_007d-help-mailing-list-340">LaTeX help mailing list</a>: <a href="#Mailing-lists">Mailing lists</a></li>
-<li><a href="#index-lcircle10-758"><code>lcircle10</code></a>: <a href="#Fontmap">Fontmap</a></li>
-<li><a href="#index-LDFLAGS-122"><code>LDFLAGS</code></a>: <a href="#configure-environment">configure environment</a></li>
-<li><a href="#index-leading-colons-508">leading colons</a>: <a href="#Default-expansion">Default expansion</a></li>
-<li><a href="#index-leaf-directories-wrongly-guessed-390">leaf directories wrongly guessed</a>: <a href="#Unable-to-find-files">Unable to find files</a></li>
-<li><a href="#index-leaf-directory-trick-543">leaf directory trick</a>: <a href="#Subdirectory-expansion">Subdirectory expansion</a></li>
-<li><a href="#index-libdl_002ea-430"><code>libdl.a</code></a>: <a href="#dlopen">dlopen</a></li>
-<li><a href="#index-libraries_002c-changing-158">libraries, changing</a>: <a href="#Running-make">Running make</a></li>
-<li><a href="#index-libraries_002c-specifying-additional-125">libraries, specifying additional</a>: <a href="#configure-environment">configure environment</a></li>
-<li><a href="#index-LIBS-124"><code>LIBS</code></a>: <a href="#configure-environment">configure environment</a></li>
-<li><a href="#index-libucb_0040r_007b_002c-avoiding_007d-163"><code>libucb</code><span class="roman">, avoiding</span></a>: <a href="#Running-make">Running make</a></li>
+<li><a href="#index-g_t_0040samp_007bkdebug_003a_007d-367">&lsquo;<samp><span class="samp">kdebug:</span></samp>&rsquo;</a>: <a href="#Debugging">Debugging</a></li>
+<li><a href="#index-kdefault_002ec-511"><code>kdefault.c</code></a>: <a href="#Default-expansion">Default expansion</a></li>
+<li><a href="#index-Knuth_002c-Donald-E_002e-12">Knuth, Donald E.</a>: <a href="#History">History</a></li>
+<li><a href="#index-Knuth_002c-Donald-E_002e_002c-archive-of-programs-by-311">Knuth, Donald E., archive of programs by</a>: <a href="#Other-TeX-packages">Other TeX packages</a></li>
+<li><a href="#index-Knuth_002c-Donald-E_002e_002c-original-author-292">Knuth, Donald E., original author</a>: <a href="#Electronic-distribution">Electronic distribution</a></li>
+<li><a href="#index-Korn-shell_0040r_007b_002c-losing-with-_0040code_007bconfigure_007d_007d-95">Korn shell<span class="roman">, losing with </span><code>configure</code></a>: <a href="#configure-shells">configure shells</a></li>
+<li><a href="#index-kpathsae_005fvar_005fvalue-844"><code>kpathsae_var_value</code></a>: <a href="#Programming-with-config-files">Programming with config files</a></li>
+<li><a href="#index-Kpathsea-config-file_002c-source-for-path-480">Kpathsea config file, source for path</a>: <a href="#Path-sources">Path sources</a></li>
+<li><a href="#index-Kpathsea-version-number-51">Kpathsea version number</a>: <a href="#Kpathsea-application-distributions">Kpathsea application distributions</a></li>
+<li><a href="#index-kpathsea_002eh-804"><code>kpathsea.h</code></a>: <a href="#Programming-overview">Programming overview</a></li>
+<li><a href="#index-kpathsea_002fHIER-73"><code>kpathsea/HIER</code></a>: <a href="#Default-path-features">Default path features</a></li>
+<li><a href="#index-kpathsea_002fREADME_002eCONFIGURE-90"><code>kpathsea/README.CONFIGURE</code></a>: <a href="#Running-configure">Running configure</a></li>
+<li><a href="#index-kpathsea_005fcnf_005fget-847"><code>kpathsea_cnf_get</code></a>: <a href="#Programming-with-config-files">Programming with config files</a></li>
+<li><a href="#index-KPATHSEA_005fDEBUG-817"><code>KPATHSEA_DEBUG</code></a>: <a href="#Calling-sequence">Calling sequence</a></li>
+<li><a href="#index-KPATHSEA_005fDEBUG-348"><code>KPATHSEA_DEBUG</code></a>: <a href="#Debugging">Debugging</a></li>
+<li><a href="#index-kpathsea_005ffind_005ffile-831"><code>kpathsea_find_file</code></a>: <a href="#Calling-sequence">Calling sequence</a></li>
+<li><a href="#index-kpathsea_005ffind_005ffile-750"><code>kpathsea_find_file</code></a>: <a href="#File-lookup">File lookup</a></li>
+<li><a href="#index-kpathsea_005ffind_005fglyph-755"><code>kpathsea_find_glyph</code></a>: <a href="#Glyph-lookup">Glyph lookup</a></li>
+<li><a href="#index-kpathsea_005ffinish-833"><code>kpathsea_finish</code></a>: <a href="#Calling-sequence">Calling sequence</a></li>
+<li><a href="#index-kpathsea_005finit_005fprog-829"><code>kpathsea_init_prog</code></a>: <a href="#Calling-sequence">Calling sequence</a></li>
+<li><a href="#index-kpathsea_005finit_005fprog-782"><code>kpathsea_init_prog</code></a>: <a href="#Fallback-font">Fallback font</a></li>
+<li><a href="#index-kpathsea_005fnew-810"><code>kpathsea_new</code></a>: <a href="#Calling-sequence">Calling sequence</a></li>
+<li><a href="#index-kpathsea_005fopen_005ffile-832"><code>kpathsea_open_file</code></a>: <a href="#Calling-sequence">Calling sequence</a></li>
+<li><a href="#index-kpathsea_005fset_005fprogram_005fname-811"><code>kpathsea_set_program_name</code></a>: <a href="#Calling-sequence">Calling sequence</a></li>
+<li><a href="#index-KPATHSEA_005fWARNING-487"><code>KPATHSEA_WARNING</code></a>: <a href="#Config-files">Config files</a></li>
+<li><a href="#index-kpse_002d_003edebug-346"><code>kpse-&gt;debug</code></a>: <a href="#Debugging">Debugging</a></li>
+<li><a href="#index-kpse_002d_003edebug-_0040r_007bvariable_007d-823"><code>kpse-&gt;debug </code><span class="roman">variable</span></a>: <a href="#Calling-sequence">Calling sequence</a></li>
+<li><a href="#index-kpse_002d_003eformat_005finfo-826"><code>kpse-&gt;format_info</code></a>: <a href="#Calling-sequence">Calling sequence</a></li>
+<li><a href="#index-kpse_002d_003einvocation_005fname-813"><code>kpse-&gt;invocation_name</code></a>: <a href="#Calling-sequence">Calling sequence</a></li>
+<li><a href="#index-kpse_002d_003einvocation_005fshort_005fname-814"><code>kpse-&gt;invocation_short_name</code></a>: <a href="#Calling-sequence">Calling sequence</a></li>
+<li><a href="#index-kpse_002d_003eprogram_005fname-815"><code>kpse-&gt;program_name</code></a>: <a href="#Calling-sequence">Calling sequence</a></li>
+<li><a href="#index-KPSE_005fBITMAP_005fTOLERANCE-760"><code>KPSE_BITMAP_TOLERANCE</code></a>: <a href="#Basic-glyph-lookup">Basic glyph lookup</a></li>
+<li><a href="#index-KPSE_005fDEBUG_005fEXPAND-_0040r_007b_002816_0029_007d-361"><code>KPSE_DEBUG_EXPAND </code><span class="roman">(16)</span></a>: <a href="#Debugging">Debugging</a></li>
+<li><a href="#index-KPSE_005fDEBUG_005fFOPEN-_0040r_007b_00284_0029_007d-357"><code>KPSE_DEBUG_FOPEN </code><span class="roman">(4)</span></a>: <a href="#Debugging">Debugging</a></li>
+<li><a href="#index-KPSE_005fDEBUG_005fHASH-_0040r_007b_00282_0029_007d-356"><code>KPSE_DEBUG_HASH </code><span class="roman">(2)</span></a>: <a href="#Debugging">Debugging</a></li>
+<li><a href="#index-KPSE_005fDEBUG_005fPATHS-_0040r_007b_00288_0029_007d-359"><code>KPSE_DEBUG_PATHS </code><span class="roman">(8)</span></a>: <a href="#Debugging">Debugging</a></li>
+<li><a href="#index-KPSE_005fDEBUG_005fSEARCH-_0040r_007b_002832_0029_007d-362"><code>KPSE_DEBUG_SEARCH </code><span class="roman">(32)</span></a>: <a href="#Debugging">Debugging</a></li>
+<li><a href="#index-KPSE_005fDEBUG_005fSTAT-_0040r_007b_00281_0029_007d-355"><code>KPSE_DEBUG_STAT </code><span class="roman">(1)</span></a>: <a href="#Debugging">Debugging</a></li>
+<li><a href="#index-KPSE_005fDEBUG_005fVARS-_0040r_007b_002864_0029_007d-363"><code>KPSE_DEBUG_VARS </code><span class="roman">(64)</span></a>: <a href="#Debugging">Debugging</a></li>
+<li><a href="#index-KPSE_005fDOT-_0040r_007bexpansion_007d-534"><code>KPSE_DOT </code><span class="roman">expansion</span></a>: <a href="#KPSE_005fDOT-expansion">KPSE_DOT expansion</a></li>
+<li><a href="#index-kpse_005fformat_005finfo_005ftype-360"><code>kpse_format_info_type</code></a>: <a href="#Debugging">Debugging</a></li>
+<li><a href="#index-kpse_005finit_005fprog_0040r_007b_002c-and-_0040code_007bMAKETEX_005fMODE_007d_007d-70"><code>kpse_init_prog</code><span class="roman">, and </span><code>MAKETEX_MODE</code></a>: <a href="#Default-path-features">Default path features</a></li>
+<li><a href="#index-kpsewhich-572"><code>kpsewhich</code></a>: <a href="#Invoking-kpsewhich">Invoking kpsewhich</a></li>
+<li><a href="#index-Kpsewhich_002c-and-debugging-353">Kpsewhich, and debugging</a>: <a href="#Debugging">Debugging</a></li>
+<li><a href="#index-ksh_0040r_007b_002c-losing-with-_0040code_007bconfigure_007d_007d-93"><code>ksh</code><span class="roman">, losing with </span><code>configure</code></a>: <a href="#configure-shells">configure shells</a></li>
+<li><a href="#index-labrea_002estanford_002eedu-310"><code>labrea.stanford.edu</code></a>: <a href="#Other-TeX-packages">Other TeX packages</a></li>
+<li><a href="#index-LaserJet-drive-57">LaserJet drive</a>: <a href="#Kpathsea-application-distributions">Kpathsea application distributions</a></li>
+<li><a href="#index-last_002dresort-font-775">last-resort font</a>: <a href="#Fallback-font">Fallback font</a></li>
+<li><a href="#index-La_0040TeX_007b_007d-help-mailing-list-337">LaTeX help mailing list</a>: <a href="#Mailing-lists">Mailing lists</a></li>
+<li><a href="#index-lcircle10-767"><code>lcircle10</code></a>: <a href="#Fontmap">Fontmap</a></li>
+<li><a href="#index-LDFLAGS-121"><code>LDFLAGS</code></a>: <a href="#configure-environment">configure environment</a></li>
+<li><a href="#index-leading-colons-505">leading colons</a>: <a href="#Default-expansion">Default expansion</a></li>
+<li><a href="#index-leaf-directories-wrongly-guessed-387">leaf directories wrongly guessed</a>: <a href="#Unable-to-find-files">Unable to find files</a></li>
+<li><a href="#index-leaf-directory-trick-540">leaf directory trick</a>: <a href="#Subdirectory-expansion">Subdirectory expansion</a></li>
+<li><a href="#index-libdl_002ea-427"><code>libdl.a</code></a>: <a href="#dlopen">dlopen</a></li>
+<li><a href="#index-libraries_002c-changing-157">libraries, changing</a>: <a href="#Running-make">Running make</a></li>
+<li><a href="#index-libraries_002c-specifying-additional-124">libraries, specifying additional</a>: <a href="#configure-environment">configure environment</a></li>
+<li><a href="#index-LIBS-123"><code>LIBS</code></a>: <a href="#configure-environment">configure environment</a></li>
+<li><a href="#index-libucb_0040r_007b_002c-avoiding_007d-162"><code>libucb</code><span class="roman">, avoiding</span></a>: <a href="#Running-make">Running make</a></li>
<li><a href="#index-license-for-using-the-library-8">license for using the library</a>: <a href="#Introduction">Introduction</a></li>
-<li><a href="#index-LIGFONTS-658"><code>LIGFONTS</code></a>: <a href="#Supported-file-formats">Supported file formats</a></li>
-<li><a href="#index-lines_002c-reading-arbitrary_002dlength-829">lines, reading arbitrary-length</a>: <a href="#Calling-sequence">Calling sequence</a></li>
-<li><a href="#index-Linux-File-System-Standard-232">Linux File System Standard</a>: <a href="#mktex-configuration">mktex configuration</a></li>
-<li><a href="#index-Linux-shells-and-_0040code_007bconfigure_007d-101">Linux shells and <code>configure</code></a>: <a href="#configure-shells">configure shells</a></li>
-<li><a href="#index-Linux_002c-using-Web2c-300">Linux, using Web2c</a>: <a href="#CD_002dROM-distribution">CD-ROM distribution</a></li>
-<li><a href="#index-lndir-_0040r_007bfor-building-symlink-trees_007d-131"><code>lndir </code><span class="roman">for building symlink trees</span></a>: <a href="#configure-scenarios">configure scenarios</a></li>
-<li><a href="#index-loader-options-123">loader options</a>: <a href="#configure-environment">configure environment</a></li>
-<li><a href="#index-loader-options_002c-final-154">loader options, final</a>: <a href="#Running-make">Running make</a></li>
-<li><a href="#index-loader-options_002c-initial-152">loader options, initial</a>: <a href="#Running-make">Running make</a></li>
-<li><a href="#index-local-cache-of-fonts-260">local cache of fonts</a>: <a href="#Security">Security</a></li>
-<li><a href="#index-log-file-373">log file</a>: <a href="#Logging">Logging</a></li>
-<li><a href="#index-logging-successful-searches-374">logging successful searches</a>: <a href="#Logging">Logging</a></li>
-<li><a href="#index-lost_002bfound-_0040r_007bdirectory_007d-477"><code>lost+found </code><span class="roman">directory</span></a>: <a href="#Searching-overview">Searching overview</a></li>
-<li><a href="#index-lostchar-780"><code>lostchar</code></a>: <a href="#Suppressing-warnings">Suppressing warnings</a></li>
-<li><a href="#index-ls_002dR-659"><code>ls-R</code></a>: <a href="#Supported-file-formats">Supported file formats</a></li>
-<li><a href="#index-ls_002dR-_0040r_007band-AFS_007d-175"><code>ls-R </code><span class="roman">and AFS</span></a>: <a href="#Installing-files">Installing files</a></li>
-<li><a href="#index-ls_002dR-_0040r_007bdatabase-file_007d-553"><code>ls-R </code><span class="roman">database file</span></a>: <a href="#ls_002dR">ls-R</a></li>
-<li><a href="#index-ls_002dR_0040r_007b_002c-simplest-build_007d-555"><code>ls-R</code><span class="roman">, simplest build</span></a>: <a href="#ls_002dR">ls-R</a></li>
-<li><a href="#index-Mach10-_0040code_007bconfigure_007d-error-421">Mach10 <code>configure</code> error</a>: <a href="#Empty-Makefiles">Empty Makefiles</a></li>
-<li><a href="#index-Macintosh-_0040TeX_007b_007d-implementations-306">Macintosh TeX implementations</a>: <a href="#Other-TeX-packages">Other TeX packages</a></li>
-<li><a href="#index-MacKenzie_002c-David-545">MacKenzie, David</a>: <a href="#Subdirectory-expansion">Subdirectory expansion</a></li>
-<li><a href="#index-MacKenzie_002c-David-22">MacKenzie, David</a>: <a href="#History">History</a></li>
-<li><a href="#index-magic-characters-455">magic characters</a>: <a href="#Searching-overview">Searching overview</a></li>
-<li><a href="#index-mailing-lists-333">mailing lists</a>: <a href="#Mailing-lists">Mailing lists</a></li>
-<li><a href="#index-maintainer_002dclean-_0040r_007bMake-target_007d-180"><code>maintainer-clean </code><span class="roman">Make target</span></a>: <a href="#Cleaning-up">Cleaning up</a></li>
-<li><a href="#index-Make-arguments_002c-additional-156">Make arguments, additional</a>: <a href="#Running-make">Running make</a></li>
-<li><a href="#index-make_0040r_007b_002c-running_007d-142"><code>make</code><span class="roman">, running</span></a>: <a href="#Running-make">Running make</a></li>
-<li><a href="#index-Makefile_002ein-86"><code>Makefile.in</code></a>: <a href="#Running-configure">Running configure</a></li>
-<li><a href="#index-Makefiles_002c-empty-416">Makefiles, empty</a>: <a href="#Empty-Makefiles">Empty Makefiles</a></li>
-<li><a href="#index-MAKETEX_005fDEBUG-_0040r_007b_0028512_0029_007d-368"><code>MAKETEX_DEBUG </code><span class="roman">(512)</span></a>: <a href="#Debugging">Debugging</a></li>
-<li><a href="#index-MAKETEX_005fFINE_005fDEBUG-_0040r_007b_00281024_0029_007d-369"><code>MAKETEX_FINE_DEBUG </code><span class="roman">(1024)</span></a>: <a href="#Debugging">Debugging</a></li>
-<li><a href="#index-MAKETEX_005fMODE-69"><code>MAKETEX_MODE</code></a>: <a href="#Default-path-features">Default path features</a></li>
-<li><a href="#index-memory-allocation-routines-825">memory allocation routines</a>: <a href="#Calling-sequence">Calling sequence</a></li>
-<li><a href="#index-metafont-driver-files-219">metafont driver files</a>: <a href="#mktex-configuration">mktex configuration</a></li>
-<li><a href="#index-Metafont-failures-407">Metafont failures</a>: <a href="#TeX-or-Metafont-failing">TeX or Metafont failing</a></li>
-<li><a href="#index-Metafont-installation-405">Metafont installation</a>: <a href="#Unable-to-generate-fonts">Unable to generate fonts</a></li>
-<li><a href="#index-Metafont-making-too_002dlarge-fonts-401">Metafont making too-large fonts</a>: <a href="#Unable-to-generate-fonts">Unable to generate fonts</a></li>
-<li><a href="#index-Metafont-using-the-wrong-device-397">Metafont using the wrong device</a>: <a href="#Unable-to-generate-fonts">Unable to generate fonts</a></li>
-<li><a href="#index-MFBASES-625"><code>MFBASES</code></a>: <a href="#Supported-file-formats">Supported file formats</a></li>
-<li><a href="#index-MFINPUTS-668"><code>MFINPUTS</code></a>: <a href="#Supported-file-formats">Supported file formats</a></li>
-<li><a href="#index-MFPOOL-670"><code>MFPOOL</code></a>: <a href="#Supported-file-formats">Supported file formats</a></li>
-<li><a href="#index-MFTINPUTS-672"><code>MFTINPUTS</code></a>: <a href="#Supported-file-formats">Supported file formats</a></li>
-<li><a href="#index-mirrors_002c-FTP-288">mirrors, FTP</a>: <a href="#Electronic-distribution">Electronic distribution</a></li>
-<li><a href="#index-MISCFONTS-673"><code>MISCFONTS</code></a>: <a href="#Supported-file-formats">Supported file formats</a></li>
-<li><a href="#index-mismatched-checksum-warnings-779">mismatched checksum warnings</a>: <a href="#Suppressing-warnings">Suppressing warnings</a></li>
-<li><a href="#index-missfont_002elog-250"><code>missfont.log</code></a>: <a href="#mktex-script-names">mktex script names</a></li>
-<li><a href="#index-MISSFONT_005fLOG-253"><code>MISSFONT_LOG</code></a>: <a href="#mktex-script-names">mktex script names</a></li>
-<li><a href="#index-missing-character-warnings-781">missing character warnings</a>: <a href="#Suppressing-warnings">Suppressing warnings</a></li>
-<li><a href="#index-mkocp-242"><code>mkocp</code></a>: <a href="#mktex-script-names">mktex script names</a></li>
-<li><a href="#index-mkofm-243"><code>mkofm</code></a>: <a href="#mktex-script-names">mktex script names</a></li>
-<li><a href="#index-g_t_0040file_007bmktex_007d-script-configuration-190"><samp><span class="file">mktex</span></samp> script configuration</a>: <a href="#mktex-configuration">mktex configuration</a></li>
-<li><a href="#index-g_t_0040file_007bmktex_007d-script-names-237"><samp><span class="file">mktex</span></samp> script names</a>: <a href="#mktex-script-names">mktex script names</a></li>
-<li><a href="#index-g_t_0040file_007bmktex_007d-scripts-184"><samp><span class="file">mktex</span></samp> scripts</a>: <a href="#mktex-scripts">mktex scripts</a></li>
-<li><a href="#index-mktex_002ecnf-600"><code>mktex.cnf</code></a>: <a href="#Specially_002drecognized-files">Specially-recognized files</a></li>
-<li><a href="#index-mktex_002ecnf-203"><code>mktex.cnf</code></a>: <a href="#mktex-configuration">mktex configuration</a></li>
-<li><a href="#index-mktex_002eopt-204"><code>mktex.opt</code></a>: <a href="#mktex-configuration">mktex configuration</a></li>
-<li><a href="#index-mktexdir-210"><code>mktexdir</code></a>: <a href="#mktex-configuration">mktex configuration</a></li>
-<li><a href="#index-mktexfmt-239"><code>mktexfmt</code></a>: <a href="#mktex-script-names">mktex script names</a></li>
-<li><a href="#index-mktexmf-241"><code>mktexmf</code></a>: <a href="#mktex-script-names">mktex script names</a></li>
-<li><a href="#index-mktexpk-244"><code>mktexpk</code></a>: <a href="#mktex-script-names">mktex script names</a></li>
-<li><a href="#index-mktexpk-_0040r_007b_002c-initial-runs_007d-38"><code>mktexpk </code><span class="roman">, initial runs</span></a>: <a href="#Simple-installation">Simple installation</a></li>
-<li><a href="#index-g_t_0040code_007bmktexpk_007d-can_0027t-guess-mode-396"><code>mktexpk</code> can't guess mode</a>: <a href="#Unable-to-generate-fonts">Unable to generate fonts</a></li>
-<li><a href="#index-mktextex-245"><code>mktextex</code></a>: <a href="#mktex-script-names">mktex script names</a></li>
-<li><a href="#index-mktextfm-246"><code>mktextfm</code></a>: <a href="#mktex-script-names">mktex script names</a></li>
-<li><a href="#index-mode-directory_002c-omitting-221">mode directory, omitting</a>: <a href="#mktex-configuration">mktex configuration</a></li>
-<li><a href="#index-Morgan_002c-Tim-14">Morgan, Tim</a>: <a href="#History">History</a></li>
-<li><a href="#index-mostlyclean-_0040r_007bMake-target_007d-178"><code>mostlyclean </code><span class="roman">Make target</span></a>: <a href="#Cleaning-up">Cleaning up</a></li>
-<li><a href="#index-MPINPUTS-675"><code>MPINPUTS</code></a>: <a href="#Supported-file-formats">Supported file formats</a></li>
-<li><a href="#index-MPMEMS-664"><code>MPMEMS</code></a>: <a href="#Supported-file-formats">Supported file formats</a></li>
-<li><a href="#index-MPPOOL-677"><code>MPPOOL</code></a>: <a href="#Supported-file-formats">Supported file formats</a></li>
-<li><a href="#index-MPSUPPORT-666"><code>MPSUPPORT</code></a>: <a href="#Supported-file-formats">Supported file formats</a></li>
-<li><a href="#index-MT_005fFEATURES-207"><code>MT_FEATURES</code></a>: <a href="#mktex-configuration">mktex configuration</a></li>
-<li><a href="#index-multiple-architectures_002c-compiling-on-127">multiple architectures, compiling on</a>: <a href="#configure-scenarios">configure scenarios</a></li>
-<li><a href="#index-multiple-architectures_002c-directories-for-132">multiple architectures, directories for</a>: <a href="#configure-scenarios">configure scenarios</a></li>
-<li><a href="#index-multiple-architectures_002c-installing-on-167">multiple architectures, installing on</a>: <a href="#Installing-files">Installing files</a></li>
-<li><a href="#index-multiple-_0040TeX_007b_007d-hierarchies-535">multiple TeX hierarchies</a>: <a href="#Brace-expansion">Brace expansion</a></li>
-<li><a href="#index-must-exist-464">must exist</a>: <a href="#Searching-overview">Searching overview</a></li>
-<li><a href="#index-names-for-_0040file_007bmktex_007d-scripts-238">names for <samp><span class="file">mktex</span></samp> scripts</a>: <a href="#mktex-script-names">mktex script names</a></li>
-<li><a href="#index-NetBSD-_0040code_007bconfigure_007d-error-419">NetBSD <code>configure</code> error</a>: <a href="#Empty-Makefiles">Empty Makefiles</a></li>
-<li><a href="#index-NetBSD-shells-and-_0040code_007bconfigure_007d-99">NetBSD shells and <code>configure</code></a>: <a href="#configure-shells">configure shells</a></li>
-<li><a href="#index-Neumann_002c-Gustaf-25">Neumann, Gustaf</a>: <a href="#History">History</a></li>
-<li><a href="#index-newsgroup-for-_0040TeX_007b_007d-342">newsgroup for TeX</a>: <a href="#Mailing-lists">Mailing lists</a></li>
-<li><a href="#index-NeXT-_0040code_007bsed_007d-error-423">NeXT <code>sed</code> error</a>: <a href="#Empty-Makefiles">Empty Makefiles</a></li>
-<li><a href="#index-NeXT_002c-lacking-X11-54">NeXT, lacking X11</a>: <a href="#Kpathsea-application-distributions">Kpathsea application distributions</a></li>
-<li><a href="#index-NFS-and-_0040file_007bls_002dR_007d-566">NFS and <samp><span class="file">ls-R</span></samp></a>: <a href="#ls_002dR">ls-R</a></li>
-<li><a href="#index-NFS-CTAN-access-291">NFS CTAN access</a>: <a href="#Electronic-distribution">Electronic distribution</a></li>
-<li><a href="#index-nomfdrivers-218"><code>nomfdrivers</code></a>: <a href="#mktex-configuration">mktex configuration</a></li>
-<li><a href="#index-nomode-220"><code>nomode</code></a>: <a href="#mktex-configuration">mktex configuration</a></li>
-<li><a href="#index-non_002dEnglish-typesetting-63">non-English typesetting</a>: <a href="#Kpathsea-application-distributions">Kpathsea application distributions</a></li>
-<li><a href="#index-non_002dUnix-operating-systems-42">non-Unix operating systems</a>: <a href="#Custom-installation">Custom installation</a></li>
-<li><a href="#index-none-782"><code>none</code></a>: <a href="#Suppressing-warnings">Suppressing warnings</a></li>
-<li><a href="#index-null-pointers_002c-dereferencing-331">null pointers, dereferencing</a>: <a href="#Bug-checklist">Bug checklist</a></li>
-<li><a href="#index-numeric-debugging-values-357">numeric debugging values</a>: <a href="#Debugging">Debugging</a></li>
-<li><a href="#index-obtaining-_0040TeX_007b_007d-275">obtaining TeX</a>: <a href="#unixtex_002eftp">unixtex.ftp</a></li>
-<li><a href="#index-obtaining-Web2c-by-ftp-282">obtaining Web2c by ftp</a>: <a href="#Electronic-distribution">Electronic distribution</a></li>
-<li><a href="#index-obtaining-Web2c-on-CD_002dROM-295">obtaining Web2c on CD-ROM</a>: <a href="#CD_002dROM-distribution">CD-ROM distribution</a></li>
-<li><a href="#index-OCPINPUTS-679"><code>OCPINPUTS</code></a>: <a href="#Supported-file-formats">Supported file formats</a></li>
-<li><a href="#index-OFMFONTS-681"><code>OFMFONTS</code></a>: <a href="#Supported-file-formats">Supported file formats</a></li>
-<li><a href="#index-online-Metafont-display_002c-spurious-403">online Metafont display, spurious</a>: <a href="#Unable-to-generate-fonts">Unable to generate fonts</a></li>
-<li><a href="#index-OPENTYPEFONTS-682"><code>OPENTYPEFONTS</code></a>: <a href="#Supported-file-formats">Supported file formats</a></li>
-<li><a href="#index-OpenWin-libraries_002c-dynamic-linking-problems-433">OpenWin libraries, dynamic linking problems</a>: <a href="#ShellWidgetClass">ShellWidgetClass</a></li>
-<li><a href="#index-optimization-caveat-409">optimization caveat</a>: <a href="#TeX-or-Metafont-failing">TeX or Metafont failing</a></li>
-<li><a href="#index-optimization_002c-enabling-137">optimization, enabling</a>: <a href="#configure-scenarios">configure scenarios</a></li>
-<li><a href="#index-options-for-debugging-348">options for debugging</a>: <a href="#Debugging">Debugging</a></li>
-<li><a href="#index-options-to-_0040code_007bconfigure_007d-109">options to <code>configure</code></a>: <a href="#configure-options">configure options</a></li>
-<li><a href="#index-OS_002f2-support-45">OS/2 support</a>: <a href="#Custom-installation">Custom installation</a></li>
-<li><a href="#index-other-_0040TeX_007b_007d-distributions-301">other TeX distributions</a>: <a href="#Other-TeX-packages">Other TeX packages</a></li>
-<li><a href="#index-OTPINPUTS-685"><code>OTPINPUTS</code></a>: <a href="#Supported-file-formats">Supported file formats</a></li>
-<li><a href="#index-overview-of-path-searching-453">overview of path searching</a>: <a href="#Searching-overview">Searching overview</a></li>
-<li><a href="#index-overview-of-programming-with-Kpathsea-789">overview of programming with Kpathsea</a>: <a href="#Programming-overview">Programming overview</a></li>
-<li><a href="#index-OVFFONTS-687"><code>OVFFONTS</code></a>: <a href="#Supported-file-formats">Supported file formats</a></li>
-<li><a href="#index-OVPFONTS-689"><code>OVPFONTS</code></a>: <a href="#Supported-file-formats">Supported file formats</a></li>
-<li><a href="#index-patches_002c-Sun-OpenWin-440">patches, Sun OpenWin</a>: <a href="#ShellWidgetClass">ShellWidgetClass</a></li>
-<li><a href="#index-path-expansion-504">path expansion</a>: <a href="#Path-expansion">Path expansion</a></li>
-<li><a href="#index-path-searching-450">path searching</a>: <a href="#Path-searching">Path searching</a></li>
-<li><a href="#index-path-searching-options-578">path searching options</a>: <a href="#Path-searching-options">Path searching options</a></li>
-<li><a href="#index-path-searching_002c-overview-452">path searching, overview</a>: <a href="#Searching-overview">Searching overview</a></li>
-<li><a href="#index-path-searching_002c-standalone-576">path searching, standalone</a>: <a href="#Invoking-kpsewhich">Invoking kpsewhich</a></li>
-<li><a href="#index-path-sources-479">path sources</a>: <a href="#Path-sources">Path sources</a></li>
-<li><a href="#index-paths_002c-changing-default-76">paths, changing default</a>: <a href="#Default-path-generation">Default path generation</a></li>
-<li><a href="#index-paths_002c-changing-default-65">paths, changing default</a>: <a href="#Changing-search-paths">Changing search paths</a></li>
-<li><a href="#index-paths_002c-device-name-included-in-70">paths, device name included in</a>: <a href="#Default-path-features">Default path features</a></li>
-<li><a href="#index-paths_002eh-83"><code>paths.h</code></a>: <a href="#Default-path-generation">Default path generation</a></li>
-<li><a href="#index-paths_002eh_0040r_007b_002c-creating_007d-144"><code>paths.h</code><span class="roman">, creating</span></a>: <a href="#Running-make">Running make</a></li>
-<li><a href="#index-pathsearch_002eh-790"><code>pathsearch.h</code></a>: <a href="#Programming-overview">Programming overview</a></li>
-<li><a href="#index-pc-_0040r_007bPascal-compiler_007d-20"><code>pc </code><span class="roman">Pascal compiler</span></a>: <a href="#History">History</a></li>
-<li><a href="#index-PCL-driver-57">PCL driver</a>: <a href="#Kpathsea-application-distributions">Kpathsea application distributions</a></li>
-<li><a href="#index-PDF-generation-59">PDF generation</a>: <a href="#Kpathsea-application-distributions">Kpathsea application distributions</a></li>
-<li><a href="#index-pdfglyphlist_002etxt-601"><code>pdfglyphlist.txt</code></a>: <a href="#Specially_002drecognized-files">Specially-recognized files</a></li>
-<li><a href="#index-pdftex_002ecfg-602"><code>pdftex.cfg</code></a>: <a href="#Specially_002drecognized-files">Specially-recognized files</a></li>
-<li><a href="#index-PDFTEXCONFIG-690"><code>PDFTEXCONFIG</code></a>: <a href="#Supported-file-formats">Supported file formats</a></li>
-<li><a href="#index-pdftexconfig_002etex-603"><code>pdftexconfig.tex</code></a>: <a href="#Specially_002drecognized-files">Specially-recognized files</a></li>
-<li><a href="#index-permission-denied-473">permission denied</a>: <a href="#Searching-overview">Searching overview</a></li>
-<li><a href="#index-permissions_002c-directory-269">permissions, directory</a>: <a href="#Security">Security</a></li>
-<li><a href="#index-permissions_002c-file-267">permissions, file</a>: <a href="#Security">Security</a></li>
-<li><a href="#index-PKFONTS-692"><code>PKFONTS</code></a>: <a href="#Supported-file-formats">Supported file formats</a></li>
-<li><a href="#index-plain_002ebase-404"><code>plain.base</code></a>: <a href="#Unable-to-generate-fonts">Unable to generate fonts</a></li>
-<li><a href="#index-pointer-combination-warnings-447">pointer combination warnings</a>: <a href="#Pointer-combination-warnings">Pointer combination warnings</a></li>
-<li><a href="#index-PostScript-driver-60">PostScript driver</a>: <a href="#Kpathsea-application-distributions">Kpathsea application distributions</a></li>
-<li><a href="#index-PostScript-fonts_002c-additional-35">PostScript fonts, additional</a>: <a href="#Simple-installation">Simple installation</a></li>
-<li><a href="#index-precompiled-executables_002c-instead-of-installation-32">precompiled executables, instead of installation</a>: <a href="#Simple-installation">Simple installation</a></li>
-<li><a href="#index-precompiled-Unix-binaries-310">precompiled Unix binaries</a>: <a href="#Other-TeX-packages">Other TeX packages</a></li>
-<li><a href="#index-preprocessor-options-121">preprocessor options</a>: <a href="#configure-environment">configure environment</a></li>
-<li><a href="#index-preprocessor-options_002c-additional-148">preprocessor options, additional</a>: <a href="#Running-make">Running make</a></li>
-<li><a href="#index-printer-configuration-files-34">printer configuration files</a>: <a href="#Simple-installation">Simple installation</a></li>
-<li><a href="#index-privacy_002c-semblance-of-381">privacy, semblance of</a>: <a href="#Logging">Logging</a></li>
-<li><a href="#index-problems_002c-common-383">problems, common</a>: <a href="#Common-problems">Common problems</a></li>
-<li><a href="#index-proginit_002ec-72"><code>proginit.c</code></a>: <a href="#Default-path-features">Default path features</a></li>
-<li><a href="#index-proginit_002eh-820"><code>proginit.h</code></a>: <a href="#Calling-sequence">Calling sequence</a></li>
-<li><a href="#index-program_002dvarying-paths-621">program-varying paths</a>: <a href="#Supported-file-formats">Supported file formats</a></li>
-<li><a href="#index-program_005finvocation_005fname-801"><code>program_invocation_name</code></a>: <a href="#Calling-sequence">Calling sequence</a></li>
-<li><a href="#index-program_005finvocation_005fshort_005fname-802"><code>program_invocation_short_name</code></a>: <a href="#Calling-sequence">Calling sequence</a></li>
-<li><a href="#index-programming-overview-788">programming overview</a>: <a href="#Programming-overview">Programming overview</a></li>
-<li><a href="#index-programming-with-config-files-832">programming with config files</a>: <a href="#Programming-with-config-files">Programming with config files</a></li>
-<li><a href="#index-programming-with-Kpathsea-797">programming with Kpathsea</a>: <a href="#Calling-sequence">Calling sequence</a></li>
+<li><a href="#index-LIGFONTS-660"><code>LIGFONTS</code></a>: <a href="#Supported-file-formats">Supported file formats</a></li>
+<li><a href="#index-lines_002c-reading-arbitrary_002dlength-839">lines, reading arbitrary-length</a>: <a href="#Calling-sequence">Calling sequence</a></li>
+<li><a href="#index-Linux-File-System-Standard-231">Linux File System Standard</a>: <a href="#mktex-configuration">mktex configuration</a></li>
+<li><a href="#index-Linux-shells-and-_0040code_007bconfigure_007d-100">Linux shells and <code>configure</code></a>: <a href="#configure-shells">configure shells</a></li>
+<li><a href="#index-Linux_002c-using-Web2c-299">Linux, using Web2c</a>: <a href="#CD_002dROM-distribution">CD-ROM distribution</a></li>
+<li><a href="#index-lndir-_0040r_007bfor-building-symlink-trees_007d-130"><code>lndir </code><span class="roman">for building symlink trees</span></a>: <a href="#configure-scenarios">configure scenarios</a></li>
+<li><a href="#index-loader-options-122">loader options</a>: <a href="#configure-environment">configure environment</a></li>
+<li><a href="#index-loader-options_002c-final-153">loader options, final</a>: <a href="#Running-make">Running make</a></li>
+<li><a href="#index-loader-options_002c-initial-151">loader options, initial</a>: <a href="#Running-make">Running make</a></li>
+<li><a href="#index-local-cache-of-fonts-259">local cache of fonts</a>: <a href="#Security">Security</a></li>
+<li><a href="#index-log-file-370">log file</a>: <a href="#Logging">Logging</a></li>
+<li><a href="#index-logging-successful-searches-371">logging successful searches</a>: <a href="#Logging">Logging</a></li>
+<li><a href="#index-lost_002bfound-_0040r_007bdirectory_007d-474"><code>lost+found </code><span class="roman">directory</span></a>: <a href="#Searching-overview">Searching overview</a></li>
+<li><a href="#index-lostchar-789"><code>lostchar</code></a>: <a href="#Suppressing-warnings">Suppressing warnings</a></li>
+<li><a href="#index-ls_002dR-661"><code>ls-R</code></a>: <a href="#Supported-file-formats">Supported file formats</a></li>
+<li><a href="#index-ls_002dR-_0040r_007band-AFS_007d-174"><code>ls-R </code><span class="roman">and AFS</span></a>: <a href="#Installing-files">Installing files</a></li>
+<li><a href="#index-ls_002dR-_0040r_007bdatabase-file_007d-550"><code>ls-R </code><span class="roman">database file</span></a>: <a href="#ls_002dR">ls-R</a></li>
+<li><a href="#index-ls_002dR_0040r_007b_002c-simplest-build_007d-552"><code>ls-R</code><span class="roman">, simplest build</span></a>: <a href="#ls_002dR">ls-R</a></li>
+<li><a href="#index-Mach10-_0040code_007bconfigure_007d-error-418">Mach10 <code>configure</code> error</a>: <a href="#Empty-Makefiles">Empty Makefiles</a></li>
+<li><a href="#index-Macintosh-_0040TeX_007b_007d-implementations-305">Macintosh TeX implementations</a>: <a href="#Other-TeX-packages">Other TeX packages</a></li>
+<li><a href="#index-MacKenzie_002c-David-542">MacKenzie, David</a>: <a href="#Subdirectory-expansion">Subdirectory expansion</a></li>
+<li><a href="#index-MacKenzie_002c-David-21">MacKenzie, David</a>: <a href="#History">History</a></li>
+<li><a href="#index-magic-characters-452">magic characters</a>: <a href="#Searching-overview">Searching overview</a></li>
+<li><a href="#index-mailing-lists-332">mailing lists</a>: <a href="#Mailing-lists">Mailing lists</a></li>
+<li><a href="#index-maintainer_002dclean-_0040r_007bMake-target_007d-179"><code>maintainer-clean </code><span class="roman">Make target</span></a>: <a href="#Cleaning-up">Cleaning up</a></li>
+<li><a href="#index-Make-arguments_002c-additional-155">Make arguments, additional</a>: <a href="#Running-make">Running make</a></li>
+<li><a href="#index-make_0040r_007b_002c-running_007d-141"><code>make</code><span class="roman">, running</span></a>: <a href="#Running-make">Running make</a></li>
+<li><a href="#index-Makefile_002ein-85"><code>Makefile.in</code></a>: <a href="#Running-configure">Running configure</a></li>
+<li><a href="#index-Makefiles_002c-empty-413">Makefiles, empty</a>: <a href="#Empty-Makefiles">Empty Makefiles</a></li>
+<li><a href="#index-MAKETEX_005fDEBUG-_0040r_007b_0028512_0029_007d-365"><code>MAKETEX_DEBUG </code><span class="roman">(512)</span></a>: <a href="#Debugging">Debugging</a></li>
+<li><a href="#index-MAKETEX_005fFINE_005fDEBUG-_0040r_007b_00281024_0029_007d-366"><code>MAKETEX_FINE_DEBUG </code><span class="roman">(1024)</span></a>: <a href="#Debugging">Debugging</a></li>
+<li><a href="#index-MAKETEX_005fMODE-68"><code>MAKETEX_MODE</code></a>: <a href="#Default-path-features">Default path features</a></li>
+<li><a href="#index-memory-allocation-routines-835">memory allocation routines</a>: <a href="#Calling-sequence">Calling sequence</a></li>
+<li><a href="#index-metafont-driver-files-218">metafont driver files</a>: <a href="#mktex-configuration">mktex configuration</a></li>
+<li><a href="#index-Metafont-failures-404">Metafont failures</a>: <a href="#TeX-or-Metafont-failing">TeX or Metafont failing</a></li>
+<li><a href="#index-Metafont-installation-402">Metafont installation</a>: <a href="#Unable-to-generate-fonts">Unable to generate fonts</a></li>
+<li><a href="#index-Metafont-making-too_002dlarge-fonts-398">Metafont making too-large fonts</a>: <a href="#Unable-to-generate-fonts">Unable to generate fonts</a></li>
+<li><a href="#index-Metafont-using-the-wrong-device-394">Metafont using the wrong device</a>: <a href="#Unable-to-generate-fonts">Unable to generate fonts</a></li>
+<li><a href="#index-MFBASES-623"><code>MFBASES</code></a>: <a href="#Supported-file-formats">Supported file formats</a></li>
+<li><a href="#index-MFINPUTS-670"><code>MFINPUTS</code></a>: <a href="#Supported-file-formats">Supported file formats</a></li>
+<li><a href="#index-MFPOOL-672"><code>MFPOOL</code></a>: <a href="#Supported-file-formats">Supported file formats</a></li>
+<li><a href="#index-MFTINPUTS-674"><code>MFTINPUTS</code></a>: <a href="#Supported-file-formats">Supported file formats</a></li>
+<li><a href="#index-mirrors_002c-FTP-287">mirrors, FTP</a>: <a href="#Electronic-distribution">Electronic distribution</a></li>
+<li><a href="#index-MISCFONTS-675"><code>MISCFONTS</code></a>: <a href="#Supported-file-formats">Supported file formats</a></li>
+<li><a href="#index-mismatched-checksum-warnings-788">mismatched checksum warnings</a>: <a href="#Suppressing-warnings">Suppressing warnings</a></li>
+<li><a href="#index-missfont_002elog-249"><code>missfont.log</code></a>: <a href="#mktex-script-names">mktex script names</a></li>
+<li><a href="#index-MISSFONT_005fLOG-252"><code>MISSFONT_LOG</code></a>: <a href="#mktex-script-names">mktex script names</a></li>
+<li><a href="#index-missing-character-warnings-790">missing character warnings</a>: <a href="#Suppressing-warnings">Suppressing warnings</a></li>
+<li><a href="#index-mkocp-241"><code>mkocp</code></a>: <a href="#mktex-script-names">mktex script names</a></li>
+<li><a href="#index-mkofm-242"><code>mkofm</code></a>: <a href="#mktex-script-names">mktex script names</a></li>
+<li><a href="#index-g_t_0040file_007bmktex_007d-script-configuration-189"><samp><span class="file">mktex</span></samp> script configuration</a>: <a href="#mktex-configuration">mktex configuration</a></li>
+<li><a href="#index-g_t_0040file_007bmktex_007d-script-names-236"><samp><span class="file">mktex</span></samp> script names</a>: <a href="#mktex-script-names">mktex script names</a></li>
+<li><a href="#index-g_t_0040file_007bmktex_007d-scripts-183"><samp><span class="file">mktex</span></samp> scripts</a>: <a href="#mktex-scripts">mktex scripts</a></li>
+<li><a href="#index-mktex_002ecnf-597"><code>mktex.cnf</code></a>: <a href="#Specially_002drecognized-files">Specially-recognized files</a></li>
+<li><a href="#index-mktex_002ecnf-202"><code>mktex.cnf</code></a>: <a href="#mktex-configuration">mktex configuration</a></li>
+<li><a href="#index-mktex_002eopt-203"><code>mktex.opt</code></a>: <a href="#mktex-configuration">mktex configuration</a></li>
+<li><a href="#index-mktexdir-209"><code>mktexdir</code></a>: <a href="#mktex-configuration">mktex configuration</a></li>
+<li><a href="#index-mktexfmt-238"><code>mktexfmt</code></a>: <a href="#mktex-script-names">mktex script names</a></li>
+<li><a href="#index-mktexmf-240"><code>mktexmf</code></a>: <a href="#mktex-script-names">mktex script names</a></li>
+<li><a href="#index-mktexpk-243"><code>mktexpk</code></a>: <a href="#mktex-script-names">mktex script names</a></li>
+<li><a href="#index-mktexpk-_0040r_007b_002c-initial-runs_007d-37"><code>mktexpk </code><span class="roman">, initial runs</span></a>: <a href="#Simple-installation">Simple installation</a></li>
+<li><a href="#index-g_t_0040code_007bmktexpk_007d-can_0027t-guess-mode-393"><code>mktexpk</code> can't guess mode</a>: <a href="#Unable-to-generate-fonts">Unable to generate fonts</a></li>
+<li><a href="#index-mktextex-244"><code>mktextex</code></a>: <a href="#mktex-script-names">mktex script names</a></li>
+<li><a href="#index-mktextfm-245"><code>mktextfm</code></a>: <a href="#mktex-script-names">mktex script names</a></li>
+<li><a href="#index-MLBIBINPUTS-677"><code>MLBIBINPUTS</code></a>: <a href="#Supported-file-formats">Supported file formats</a></li>
+<li><a href="#index-MLBSTINPUTS-681"><code>MLBSTINPUTS</code></a>: <a href="#Supported-file-formats">Supported file formats</a></li>
+<li><a href="#index-mode-directory_002c-omitting-220">mode directory, omitting</a>: <a href="#mktex-configuration">mktex configuration</a></li>
+<li><a href="#index-Morgan_002c-Tim-13">Morgan, Tim</a>: <a href="#History">History</a></li>
+<li><a href="#index-mostlyclean-_0040r_007bMake-target_007d-177"><code>mostlyclean </code><span class="roman">Make target</span></a>: <a href="#Cleaning-up">Cleaning up</a></li>
+<li><a href="#index-MPINPUTS-684"><code>MPINPUTS</code></a>: <a href="#Supported-file-formats">Supported file formats</a></li>
+<li><a href="#index-MPMEMS-666"><code>MPMEMS</code></a>: <a href="#Supported-file-formats">Supported file formats</a></li>
+<li><a href="#index-MPPOOL-686"><code>MPPOOL</code></a>: <a href="#Supported-file-formats">Supported file formats</a></li>
+<li><a href="#index-MPSUPPORT-668"><code>MPSUPPORT</code></a>: <a href="#Supported-file-formats">Supported file formats</a></li>
+<li><a href="#index-MT_005fFEATURES-206"><code>MT_FEATURES</code></a>: <a href="#mktex-configuration">mktex configuration</a></li>
+<li><a href="#index-multiple-architectures_002c-compiling-on-126">multiple architectures, compiling on</a>: <a href="#configure-scenarios">configure scenarios</a></li>
+<li><a href="#index-multiple-architectures_002c-directories-for-131">multiple architectures, directories for</a>: <a href="#configure-scenarios">configure scenarios</a></li>
+<li><a href="#index-multiple-architectures_002c-installing-on-166">multiple architectures, installing on</a>: <a href="#Installing-files">Installing files</a></li>
+<li><a href="#index-multiple-_0040TeX_007b_007d-hierarchies-532">multiple TeX hierarchies</a>: <a href="#Brace-expansion">Brace expansion</a></li>
+<li><a href="#index-must-exist-461">must exist</a>: <a href="#Searching-overview">Searching overview</a></li>
+<li><a href="#index-names-for-_0040file_007bmktex_007d-scripts-237">names for <samp><span class="file">mktex</span></samp> scripts</a>: <a href="#mktex-script-names">mktex script names</a></li>
+<li><a href="#index-NetBSD-_0040code_007bconfigure_007d-error-416">NetBSD <code>configure</code> error</a>: <a href="#Empty-Makefiles">Empty Makefiles</a></li>
+<li><a href="#index-NetBSD-shells-and-_0040code_007bconfigure_007d-98">NetBSD shells and <code>configure</code></a>: <a href="#configure-shells">configure shells</a></li>
+<li><a href="#index-Neumann_002c-Gustaf-24">Neumann, Gustaf</a>: <a href="#History">History</a></li>
+<li><a href="#index-newsgroup-for-_0040TeX_007b_007d-339">newsgroup for TeX</a>: <a href="#Mailing-lists">Mailing lists</a></li>
+<li><a href="#index-NeXT-_0040code_007bsed_007d-error-420">NeXT <code>sed</code> error</a>: <a href="#Empty-Makefiles">Empty Makefiles</a></li>
+<li><a href="#index-NeXT_002c-lacking-X11-53">NeXT, lacking X11</a>: <a href="#Kpathsea-application-distributions">Kpathsea application distributions</a></li>
+<li><a href="#index-NFS-and-_0040file_007bls_002dR_007d-563">NFS and <samp><span class="file">ls-R</span></samp></a>: <a href="#ls_002dR">ls-R</a></li>
+<li><a href="#index-NFS-CTAN-access-290">NFS CTAN access</a>: <a href="#Electronic-distribution">Electronic distribution</a></li>
+<li><a href="#index-nomfdrivers-217"><code>nomfdrivers</code></a>: <a href="#mktex-configuration">mktex configuration</a></li>
+<li><a href="#index-nomode-219"><code>nomode</code></a>: <a href="#mktex-configuration">mktex configuration</a></li>
+<li><a href="#index-non_002dEnglish-typesetting-62">non-English typesetting</a>: <a href="#Kpathsea-application-distributions">Kpathsea application distributions</a></li>
+<li><a href="#index-non_002dUnix-operating-systems-41">non-Unix operating systems</a>: <a href="#Custom-installation">Custom installation</a></li>
+<li><a href="#index-none-791"><code>none</code></a>: <a href="#Suppressing-warnings">Suppressing warnings</a></li>
+<li><a href="#index-null-pointers_002c-dereferencing-330">null pointers, dereferencing</a>: <a href="#Bug-checklist">Bug checklist</a></li>
+<li><a href="#index-numeric-debugging-values-354">numeric debugging values</a>: <a href="#Debugging">Debugging</a></li>
+<li><a href="#index-obtaining-_0040TeX_007b_007d-274">obtaining TeX</a>: <a href="#unixtex_002eftp">unixtex.ftp</a></li>
+<li><a href="#index-obtaining-Web2c-by-ftp-281">obtaining Web2c by ftp</a>: <a href="#Electronic-distribution">Electronic distribution</a></li>
+<li><a href="#index-obtaining-Web2c-on-CD_002dROM-294">obtaining Web2c on CD-ROM</a>: <a href="#CD_002dROM-distribution">CD-ROM distribution</a></li>
+<li><a href="#index-OCPINPUTS-688"><code>OCPINPUTS</code></a>: <a href="#Supported-file-formats">Supported file formats</a></li>
+<li><a href="#index-OFMFONTS-690"><code>OFMFONTS</code></a>: <a href="#Supported-file-formats">Supported file formats</a></li>
+<li><a href="#index-online-Metafont-display_002c-spurious-400">online Metafont display, spurious</a>: <a href="#Unable-to-generate-fonts">Unable to generate fonts</a></li>
+<li><a href="#index-OPENTYPEFONTS-691"><code>OPENTYPEFONTS</code></a>: <a href="#Supported-file-formats">Supported file formats</a></li>
+<li><a href="#index-OpenWin-libraries_002c-dynamic-linking-problems-430">OpenWin libraries, dynamic linking problems</a>: <a href="#ShellWidgetClass">ShellWidgetClass</a></li>
+<li><a href="#index-optimization-caveat-406">optimization caveat</a>: <a href="#TeX-or-Metafont-failing">TeX or Metafont failing</a></li>
+<li><a href="#index-optimization_002c-enabling-136">optimization, enabling</a>: <a href="#configure-scenarios">configure scenarios</a></li>
+<li><a href="#index-options-for-debugging-345">options for debugging</a>: <a href="#Debugging">Debugging</a></li>
+<li><a href="#index-options-to-_0040code_007bconfigure_007d-108">options to <code>configure</code></a>: <a href="#configure-options">configure options</a></li>
+<li><a href="#index-OS_002f2-support-44">OS/2 support</a>: <a href="#Custom-installation">Custom installation</a></li>
+<li><a href="#index-other-_0040TeX_007b_007d-distributions-300">other TeX distributions</a>: <a href="#Other-TeX-packages">Other TeX packages</a></li>
+<li><a href="#index-OTPINPUTS-694"><code>OTPINPUTS</code></a>: <a href="#Supported-file-formats">Supported file formats</a></li>
+<li><a href="#index-overview-of-path-searching-450">overview of path searching</a>: <a href="#Searching-overview">Searching overview</a></li>
+<li><a href="#index-overview-of-programming-with-Kpathsea-798">overview of programming with Kpathsea</a>: <a href="#Programming-overview">Programming overview</a></li>
+<li><a href="#index-OVFFONTS-696"><code>OVFFONTS</code></a>: <a href="#Supported-file-formats">Supported file formats</a></li>
+<li><a href="#index-OVPFONTS-698"><code>OVPFONTS</code></a>: <a href="#Supported-file-formats">Supported file formats</a></li>
+<li><a href="#index-patches_002c-Sun-OpenWin-437">patches, Sun OpenWin</a>: <a href="#ShellWidgetClass">ShellWidgetClass</a></li>
+<li><a href="#index-path-expansion-501">path expansion</a>: <a href="#Path-expansion">Path expansion</a></li>
+<li><a href="#index-path-searching-447">path searching</a>: <a href="#Path-searching">Path searching</a></li>
+<li><a href="#index-path-searching-options-575">path searching options</a>: <a href="#Path-searching-options">Path searching options</a></li>
+<li><a href="#index-path-searching_002c-overview-449">path searching, overview</a>: <a href="#Searching-overview">Searching overview</a></li>
+<li><a href="#index-path-searching_002c-standalone-573">path searching, standalone</a>: <a href="#Invoking-kpsewhich">Invoking kpsewhich</a></li>
+<li><a href="#index-path-sources-476">path sources</a>: <a href="#Path-sources">Path sources</a></li>
+<li><a href="#index-paths_002c-changing-default-75">paths, changing default</a>: <a href="#Default-path-generation">Default path generation</a></li>
+<li><a href="#index-paths_002c-changing-default-64">paths, changing default</a>: <a href="#Changing-search-paths">Changing search paths</a></li>
+<li><a href="#index-paths_002c-device-name-included-in-69">paths, device name included in</a>: <a href="#Default-path-features">Default path features</a></li>
+<li><a href="#index-paths_002eh-82"><code>paths.h</code></a>: <a href="#Default-path-generation">Default path generation</a></li>
+<li><a href="#index-paths_002eh_0040r_007b_002c-creating_007d-143"><code>paths.h</code><span class="roman">, creating</span></a>: <a href="#Running-make">Running make</a></li>
+<li><a href="#index-pathsearch_002eh-801"><code>pathsearch.h</code></a>: <a href="#Programming-overview">Programming overview</a></li>
+<li><a href="#index-pc-_0040r_007bPascal-compiler_007d-19"><code>pc </code><span class="roman">Pascal compiler</span></a>: <a href="#History">History</a></li>
+<li><a href="#index-PCL-driver-56">PCL driver</a>: <a href="#Kpathsea-application-distributions">Kpathsea application distributions</a></li>
+<li><a href="#index-PDF-generation-58">PDF generation</a>: <a href="#Kpathsea-application-distributions">Kpathsea application distributions</a></li>
+<li><a href="#index-pdfglyphlist_002etxt-598"><code>pdfglyphlist.txt</code></a>: <a href="#Specially_002drecognized-files">Specially-recognized files</a></li>
+<li><a href="#index-pdftex_002ecfg-599"><code>pdftex.cfg</code></a>: <a href="#Specially_002drecognized-files">Specially-recognized files</a></li>
+<li><a href="#index-PDFTEXCONFIG-699"><code>PDFTEXCONFIG</code></a>: <a href="#Supported-file-formats">Supported file formats</a></li>
+<li><a href="#index-pdftexconfig_002etex-600"><code>pdftexconfig.tex</code></a>: <a href="#Specially_002drecognized-files">Specially-recognized files</a></li>
+<li><a href="#index-permission-denied-470">permission denied</a>: <a href="#Searching-overview">Searching overview</a></li>
+<li><a href="#index-permissions_002c-directory-268">permissions, directory</a>: <a href="#Security">Security</a></li>
+<li><a href="#index-permissions_002c-file-266">permissions, file</a>: <a href="#Security">Security</a></li>
+<li><a href="#index-PKFONTS-701"><code>PKFONTS</code></a>: <a href="#Supported-file-formats">Supported file formats</a></li>
+<li><a href="#index-plain_002ebase-401"><code>plain.base</code></a>: <a href="#Unable-to-generate-fonts">Unable to generate fonts</a></li>
+<li><a href="#index-pointer-combination-warnings-444">pointer combination warnings</a>: <a href="#Pointer-combination-warnings">Pointer combination warnings</a></li>
+<li><a href="#index-PostScript-driver-59">PostScript driver</a>: <a href="#Kpathsea-application-distributions">Kpathsea application distributions</a></li>
+<li><a href="#index-PostScript-fonts_002c-additional-34">PostScript fonts, additional</a>: <a href="#Simple-installation">Simple installation</a></li>
+<li><a href="#index-precompiled-executables_002c-instead-of-installation-31">precompiled executables, instead of installation</a>: <a href="#Simple-installation">Simple installation</a></li>
+<li><a href="#index-precompiled-Unix-binaries-309">precompiled Unix binaries</a>: <a href="#Other-TeX-packages">Other TeX packages</a></li>
+<li><a href="#index-preprocessor-options-120">preprocessor options</a>: <a href="#configure-environment">configure environment</a></li>
+<li><a href="#index-preprocessor-options_002c-additional-147">preprocessor options, additional</a>: <a href="#Running-make">Running make</a></li>
+<li><a href="#index-printer-configuration-files-33">printer configuration files</a>: <a href="#Simple-installation">Simple installation</a></li>
+<li><a href="#index-privacy_002c-semblance-of-378">privacy, semblance of</a>: <a href="#Logging">Logging</a></li>
+<li><a href="#index-problems_002c-common-380">problems, common</a>: <a href="#Common-problems">Common problems</a></li>
+<li><a href="#index-proginit_002ec-71"><code>proginit.c</code></a>: <a href="#Default-path-features">Default path features</a></li>
+<li><a href="#index-proginit_002eh-830"><code>proginit.h</code></a>: <a href="#Calling-sequence">Calling sequence</a></li>
+<li><a href="#index-program_002dvarying-paths-619">program-varying paths</a>: <a href="#Supported-file-formats">Supported file formats</a></li>
+<li><a href="#index-programming-overview-797">programming overview</a>: <a href="#Programming-overview">Programming overview</a></li>
+<li><a href="#index-programming-with-config-files-842">programming with config files</a>: <a href="#Programming-with-config-files">Programming with config files</a></li>
+<li><a href="#index-programming-with-Kpathsea-808">programming with Kpathsea</a>: <a href="#Calling-sequence">Calling sequence</a></li>
<li><a href="#index-programs-using-the-library-3">programs using the library</a>: <a href="#Introduction">Introduction</a></li>
-<li><a href="#index-proof-mode-402">proof mode</a>: <a href="#Unable-to-generate-fonts">Unable to generate fonts</a></li>
-<li><a href="#index-PSHEADERS-698"><code>PSHEADERS</code></a>: <a href="#Supported-file-formats">Supported file formats</a></li>
-<li><a href="#index-pxp-_0040r_007bPascal-preprocessor_007d-19"><code>pxp </code><span class="roman">Pascal preprocessor</span></a>: <a href="#History">History</a></li>
-<li><a href="#index-quoting-variable-values-520">quoting variable values</a>: <a href="#Variable-expansion">Variable expansion</a></li>
-<li><a href="#index-readable-783"><code>readable</code></a>: <a href="#Suppressing-warnings">Suppressing warnings</a></li>
-<li><a href="#index-reading-arbitrary_002dlength-lines-827">reading arbitrary-length lines</a>: <a href="#Calling-sequence">Calling sequence</a></li>
-<li><a href="#index-README_002eCONFIGURE-90"><code>README.CONFIGURE</code></a>: <a href="#Running-configure">Running configure</a></li>
-<li><a href="#index-README_002emirrors-286"><code>README.mirrors</code></a>: <a href="#Electronic-distribution">Electronic distribution</a></li>
-<li><a href="#index-recording-successful-searches-375">recording successful searches</a>: <a href="#Logging">Logging</a></li>
-<li><a href="#index-relative-filenames-470">relative filenames</a>: <a href="#Searching-overview">Searching overview</a></li>
-<li><a href="#index-relative-filenames-in-_0040file_007bls_002dR_007d-176">relative filenames in <samp><span class="file">ls-R</span></samp></a>: <a href="#Installing-files">Installing files</a></li>
-<li><a href="#index-reporting-bugs-313">reporting bugs</a>: <a href="#Reporting-bugs">Reporting bugs</a></li>
-<li><a href="#index-resident_002ec-817"><code>resident.c</code></a>: <a href="#Calling-sequence">Calling sequence</a></li>
-<li><a href="#index-resolution_002c-setting-583">resolution, setting</a>: <a href="#Path-searching-options">Path searching options</a></li>
-<li><a href="#index-resolutions_002c-last_002dresort-765">resolutions, last-resort</a>: <a href="#Fallback-font">Fallback font</a></li>
-<li><a href="#index-retrieving-_0040TeX_007b_007d-276">retrieving TeX</a>: <a href="#unixtex_002eftp">unixtex.ftp</a></li>
-<li><a href="#index-right_002dhand-side-of-variable-assignments-500">right-hand side of variable assignments</a>: <a href="#Config-files">Config files</a></li>
-<li><a href="#index-Rokicki_002c-Tom-15">Rokicki, Tom</a>: <a href="#History">History</a></li>
-<li><a href="#index-g_t_0040t_007broot_007d-user-529"><tt>root</tt> user</a>: <a href="#Tilde-expansion">Tilde expansion</a></li>
-<li><a href="#index-runtime-configuration-files-488">runtime configuration files</a>: <a href="#Config-files">Config files</a></li>
-<li><a href="#index-runtime-debugging-347">runtime debugging</a>: <a href="#Debugging">Debugging</a></li>
-<li><a href="#index-Sauter-fonts_002c-and-dynamic-source-creation-188">Sauter fonts, and dynamic source creation</a>: <a href="#mktex-scripts">mktex scripts</a></li>
-<li><a href="#index-scripts-for-file-creation-185">scripts for file creation</a>: <a href="#mktex-scripts">mktex scripts</a></li>
-<li><a href="#index-search-path_002c-defined-454">search path, defined</a>: <a href="#Searching-overview">Searching overview</a></li>
-<li><a href="#index-search-paths_002c-changing-default-64">search paths, changing default</a>: <a href="#Changing-search-paths">Changing search paths</a></li>
-<li><a href="#index-searching-for-files-735">searching for files</a>: <a href="#File-lookup">File lookup</a></li>
-<li><a href="#index-searching-for-glyphs-743">searching for glyphs</a>: <a href="#Glyph-lookup">Glyph lookup</a></li>
-<li><a href="#index-searching-overview-451">searching overview</a>: <a href="#Searching-overview">Searching overview</a></li>
-<li><a href="#index-searching-the-database-459">searching the database</a>: <a href="#Searching-overview">Searching overview</a></li>
-<li><a href="#index-searching-the-disk-463">searching the disk</a>: <a href="#Searching-overview">Searching overview</a></li>
-<li><a href="#index-security-considerations-257">security considerations</a>: <a href="#Security">Security</a></li>
-<li><a href="#index-sed-_0040r_007berror-from-_0040code_007bconfigure_007d_007d-417"><code>sed </code><span class="roman">error from </span><code>configure</code></a>: <a href="#Empty-Makefiles">Empty Makefiles</a></li>
-<li><a href="#index-SELFAUTODIR-807">SELFAUTODIR</a>: <a href="#Calling-sequence">Calling sequence</a></li>
-<li><a href="#index-SELFAUTOLOC-806">SELFAUTOLOC</a>: <a href="#Calling-sequence">Calling sequence</a></li>
-<li><a href="#index-SELFAUTOPARENT-808">SELFAUTOPARENT</a>: <a href="#Calling-sequence">Calling sequence</a></li>
-<li><a href="#index-sending-patches-325">sending patches</a>: <a href="#Bug-checklist">Bug checklist</a></li>
-<li><a href="#index-setgid-scripts-265">setgid scripts</a>: <a href="#Security">Security</a></li>
-<li><a href="#index-SFDFONTS-700"><code>SFDFONTS</code></a>: <a href="#Supported-file-formats">Supported file formats</a></li>
-<li><a href="#index-sh5_0040r_007b_002c-ok-with-_0040code_007bconfigure_007d_007d-104"><code>sh5</code><span class="roman">, ok with </span><code>configure</code></a>: <a href="#configure-shells">configure shells</a></li>
-<li><a href="#index-shared-library_002c-making-139">shared library, making</a>: <a href="#Shared-library">Shared library</a></li>
-<li><a href="#index-shell-scripts-as-configuration-files-501">shell scripts as configuration files</a>: <a href="#Config-files">Config files</a></li>
-<li><a href="#index-shell-variables-521">shell variables</a>: <a href="#Variable-expansion">Variable expansion</a></li>
-<li><a href="#index-shell_005fescape_0040r_007b_002c-example-for-code_007d-836"><code>shell_escape</code><span class="roman">, example for code</span></a>: <a href="#Programming-with-config-files">Programming with config files</a></li>
-<li><a href="#index-shells-and-_0040code_007bconfigure_007d-92">shells and <code>configure</code></a>: <a href="#configure-shells">configure shells</a></li>
-<li><a href="#index-simple-installation-30">simple installation</a>: <a href="#Simple-installation">Simple installation</a></li>
-<li><a href="#index-site-overrides-for-_0040code_007bmktex_0040dots_007b_007d_007d-205">site overrides for <code>mktex...</code></a>: <a href="#mktex-configuration">mktex configuration</a></li>
-<li><a href="#index-size-of-distribution-archives-49">size of distribution archives</a>: <a href="#Disk-space">Disk space</a></li>
-<li><a href="#index-skeleton-_0040TeX_007b_007d-directory-273">skeleton TeX directory</a>: <a href="#TeX-directory-structure">TeX directory structure</a></li>
-<li><a href="#index-slow-startup-time-392">slow startup time</a>: <a href="#Slow-path-searching">Slow path searching</a></li>
-<li><a href="#index-Solaris-BSD-compatibility_002c-not-162">Solaris BSD compatibility, not</a>: <a href="#Running-make">Running make</a></li>
-<li><a href="#index-source-files-705"><code>source files</code></a>: <a href="#Supported-file-formats">Supported file formats</a></li>
-<li><a href="#index-sources-for-search-paths-480">sources for search paths</a>: <a href="#Path-sources">Path sources</a></li>
-<li><a href="#index-special-785"><code>special</code></a>: <a href="#Suppressing-warnings">Suppressing warnings</a></li>
-<li><a href="#index-st_005fnlink-546"><code>st_nlink</code></a>: <a href="#Subdirectory-expansion">Subdirectory expansion</a></li>
-<li><a href="#index-stack-trace-327">stack trace</a>: <a href="#Bug-checklist">Bug checklist</a></li>
-<li><a href="#index-standalone-path-searching-577">standalone path searching</a>: <a href="#Invoking-kpsewhich">Invoking kpsewhich</a></li>
-<li><a href="#index-standard-error-and-debugging-output-355">standard error and debugging output</a>: <a href="#Debugging">Debugging</a></li>
-<li><a href="#index-standard-options-613">standard options</a>: <a href="#Standard-options">Standard options</a></li>
-<li><a href="#index-startup-time_002c-excessive-393">startup time, excessive</a>: <a href="#Slow-path-searching">Slow path searching</a></li>
-<li><a href="#index-static-linking-441">static linking</a>: <a href="#ShellWidgetClass">ShellWidgetClass</a></li>
-<li><a href="#index-static-linking-and-_0040code_007bdlsym_007d-425">static linking and <code>dlsym</code></a>: <a href="#dlopen">dlopen</a></li>
-<li><a href="#index-string-routines-826">string routines</a>: <a href="#Calling-sequence">Calling sequence</a></li>
-<li><a href="#index-strip-226"><code>strip</code></a>: <a href="#mktex-configuration">mktex configuration</a></li>
-<li><a href="#index-stripsupplier-222"><code>stripsupplier</code></a>: <a href="#mktex-configuration">mktex configuration</a></li>
-<li><a href="#index-striptypeface-224"><code>striptypeface</code></a>: <a href="#mktex-configuration">mktex configuration</a></li>
-<li><a href="#index-subdirectory-searching-539">subdirectory searching</a>: <a href="#Subdirectory-expansion">Subdirectory expansion</a></li>
-<li><a href="#index-suffixes_002c-filename-738">suffixes, filename</a>: <a href="#File-lookup">File lookup</a></li>
+<li><a href="#index-proof-mode-399">proof mode</a>: <a href="#Unable-to-generate-fonts">Unable to generate fonts</a></li>
+<li><a href="#index-PSHEADERS-707"><code>PSHEADERS</code></a>: <a href="#Supported-file-formats">Supported file formats</a></li>
+<li><a href="#index-pxp-_0040r_007bPascal-preprocessor_007d-18"><code>pxp </code><span class="roman">Pascal preprocessor</span></a>: <a href="#History">History</a></li>
+<li><a href="#index-quoting-variable-values-517">quoting variable values</a>: <a href="#Variable-expansion">Variable expansion</a></li>
+<li><a href="#index-re_002dentrant-API-799">re-entrant API</a>: <a href="#Programming-overview">Programming overview</a></li>
+<li><a href="#index-readable-792"><code>readable</code></a>: <a href="#Suppressing-warnings">Suppressing warnings</a></li>
+<li><a href="#index-reading-arbitrary_002dlength-lines-837">reading arbitrary-length lines</a>: <a href="#Calling-sequence">Calling sequence</a></li>
+<li><a href="#index-README_002eCONFIGURE-89"><code>README.CONFIGURE</code></a>: <a href="#Running-configure">Running configure</a></li>
+<li><a href="#index-README_002emirrors-285"><code>README.mirrors</code></a>: <a href="#Electronic-distribution">Electronic distribution</a></li>
+<li><a href="#index-recording-successful-searches-372">recording successful searches</a>: <a href="#Logging">Logging</a></li>
+<li><a href="#index-relative-filenames-467">relative filenames</a>: <a href="#Searching-overview">Searching overview</a></li>
+<li><a href="#index-relative-filenames-in-_0040file_007bls_002dR_007d-175">relative filenames in <samp><span class="file">ls-R</span></samp></a>: <a href="#Installing-files">Installing files</a></li>
+<li><a href="#index-reporting-bugs-312">reporting bugs</a>: <a href="#Reporting-bugs">Reporting bugs</a></li>
+<li><a href="#index-resident_002ec-827"><code>resident.c</code></a>: <a href="#Calling-sequence">Calling sequence</a></li>
+<li><a href="#index-resolution_002c-setting-580">resolution, setting</a>: <a href="#Path-searching-options">Path searching options</a></li>
+<li><a href="#index-resolutions_002c-last_002dresort-774">resolutions, last-resort</a>: <a href="#Fallback-font">Fallback font</a></li>
+<li><a href="#index-retrieving-_0040TeX_007b_007d-275">retrieving TeX</a>: <a href="#unixtex_002eftp">unixtex.ftp</a></li>
+<li><a href="#index-right_002dhand-side-of-variable-assignments-497">right-hand side of variable assignments</a>: <a href="#Config-files">Config files</a></li>
+<li><a href="#index-Rokicki_002c-Tom-14">Rokicki, Tom</a>: <a href="#History">History</a></li>
+<li><a href="#index-g_t_0040t_007broot_007d-user-526"><tt>root</tt> user</a>: <a href="#Tilde-expansion">Tilde expansion</a></li>
+<li><a href="#index-runtime-configuration-files-485">runtime configuration files</a>: <a href="#Config-files">Config files</a></li>
+<li><a href="#index-runtime-debugging-344">runtime debugging</a>: <a href="#Debugging">Debugging</a></li>
+<li><a href="#index-Sauter-fonts_002c-and-dynamic-source-creation-187">Sauter fonts, and dynamic source creation</a>: <a href="#mktex-scripts">mktex scripts</a></li>
+<li><a href="#index-scripts-for-file-creation-184">scripts for file creation</a>: <a href="#mktex-scripts">mktex scripts</a></li>
+<li><a href="#index-search-path_002c-defined-451">search path, defined</a>: <a href="#Searching-overview">Searching overview</a></li>
+<li><a href="#index-search-paths_002c-changing-default-63">search paths, changing default</a>: <a href="#Changing-search-paths">Changing search paths</a></li>
+<li><a href="#index-searching-for-files-744">searching for files</a>: <a href="#File-lookup">File lookup</a></li>
+<li><a href="#index-searching-for-glyphs-752">searching for glyphs</a>: <a href="#Glyph-lookup">Glyph lookup</a></li>
+<li><a href="#index-searching-overview-448">searching overview</a>: <a href="#Searching-overview">Searching overview</a></li>
+<li><a href="#index-searching-the-database-456">searching the database</a>: <a href="#Searching-overview">Searching overview</a></li>
+<li><a href="#index-searching-the-disk-460">searching the disk</a>: <a href="#Searching-overview">Searching overview</a></li>
+<li><a href="#index-security-considerations-256">security considerations</a>: <a href="#Security">Security</a></li>
+<li><a href="#index-sed-_0040r_007berror-from-_0040code_007bconfigure_007d_007d-414"><code>sed </code><span class="roman">error from </span><code>configure</code></a>: <a href="#Empty-Makefiles">Empty Makefiles</a></li>
+<li><a href="#index-SELFAUTODIR-819">SELFAUTODIR</a>: <a href="#Calling-sequence">Calling sequence</a></li>
+<li><a href="#index-SELFAUTOLOC-818">SELFAUTOLOC</a>: <a href="#Calling-sequence">Calling sequence</a></li>
+<li><a href="#index-SELFAUTOPARENT-820">SELFAUTOPARENT</a>: <a href="#Calling-sequence">Calling sequence</a></li>
+<li><a href="#index-sending-patches-324">sending patches</a>: <a href="#Bug-checklist">Bug checklist</a></li>
+<li><a href="#index-setgid-scripts-264">setgid scripts</a>: <a href="#Security">Security</a></li>
+<li><a href="#index-SFDFONTS-709"><code>SFDFONTS</code></a>: <a href="#Supported-file-formats">Supported file formats</a></li>
+<li><a href="#index-sh5_0040r_007b_002c-ok-with-_0040code_007bconfigure_007d_007d-103"><code>sh5</code><span class="roman">, ok with </span><code>configure</code></a>: <a href="#configure-shells">configure shells</a></li>
+<li><a href="#index-shared-library_002c-making-138">shared library, making</a>: <a href="#Shared-library">Shared library</a></li>
+<li><a href="#index-shell-scripts-as-configuration-files-498">shell scripts as configuration files</a>: <a href="#Config-files">Config files</a></li>
+<li><a href="#index-shell-variables-518">shell variables</a>: <a href="#Variable-expansion">Variable expansion</a></li>
+<li><a href="#index-shell_005fescape_0040r_007b_002c-example-for-code_007d-846"><code>shell_escape</code><span class="roman">, example for code</span></a>: <a href="#Programming-with-config-files">Programming with config files</a></li>
+<li><a href="#index-shells-and-_0040code_007bconfigure_007d-91">shells and <code>configure</code></a>: <a href="#configure-shells">configure shells</a></li>
+<li><a href="#index-simple-installation-29">simple installation</a>: <a href="#Simple-installation">Simple installation</a></li>
+<li><a href="#index-site-overrides-for-_0040code_007bmktex_0040dots_007b_007d_007d-204">site overrides for <code>mktex...</code></a>: <a href="#mktex-configuration">mktex configuration</a></li>
+<li><a href="#index-size-of-distribution-archives-48">size of distribution archives</a>: <a href="#Disk-space">Disk space</a></li>
+<li><a href="#index-skeleton-_0040TeX_007b_007d-directory-272">skeleton TeX directory</a>: <a href="#TeX-directory-structure">TeX directory structure</a></li>
+<li><a href="#index-slow-startup-time-389">slow startup time</a>: <a href="#Slow-path-searching">Slow path searching</a></li>
+<li><a href="#index-Solaris-BSD-compatibility_002c-not-161">Solaris BSD compatibility, not</a>: <a href="#Running-make">Running make</a></li>
+<li><a href="#index-source-files-714"><code>source files</code></a>: <a href="#Supported-file-formats">Supported file formats</a></li>
+<li><a href="#index-sources-for-search-paths-477">sources for search paths</a>: <a href="#Path-sources">Path sources</a></li>
+<li><a href="#index-special-794"><code>special</code></a>: <a href="#Suppressing-warnings">Suppressing warnings</a></li>
+<li><a href="#index-st_005fnlink-543"><code>st_nlink</code></a>: <a href="#Subdirectory-expansion">Subdirectory expansion</a></li>
+<li><a href="#index-ST_005fNLINK_005fTRICK-544"><code>ST_NLINK_TRICK</code></a>: <a href="#Subdirectory-expansion">Subdirectory expansion</a></li>
+<li><a href="#index-stack-trace-326">stack trace</a>: <a href="#Bug-checklist">Bug checklist</a></li>
+<li><a href="#index-standalone-path-searching-574">standalone path searching</a>: <a href="#Invoking-kpsewhich">Invoking kpsewhich</a></li>
+<li><a href="#index-standard-error-and-debugging-output-352">standard error and debugging output</a>: <a href="#Debugging">Debugging</a></li>
+<li><a href="#index-standard-options-611">standard options</a>: <a href="#Standard-options">Standard options</a></li>
+<li><a href="#index-startup-time_002c-excessive-390">startup time, excessive</a>: <a href="#Slow-path-searching">Slow path searching</a></li>
+<li><a href="#index-static-linking-438">static linking</a>: <a href="#ShellWidgetClass">ShellWidgetClass</a></li>
+<li><a href="#index-static-linking-and-_0040code_007bdlsym_007d-422">static linking and <code>dlsym</code></a>: <a href="#dlopen">dlopen</a></li>
+<li><a href="#index-string-routines-836">string routines</a>: <a href="#Calling-sequence">Calling sequence</a></li>
+<li><a href="#index-strip-225"><code>strip</code></a>: <a href="#mktex-configuration">mktex configuration</a></li>
+<li><a href="#index-stripsupplier-221"><code>stripsupplier</code></a>: <a href="#mktex-configuration">mktex configuration</a></li>
+<li><a href="#index-striptypeface-223"><code>striptypeface</code></a>: <a href="#mktex-configuration">mktex configuration</a></li>
+<li><a href="#index-subdirectory-searching-536">subdirectory searching</a>: <a href="#Subdirectory-expansion">Subdirectory expansion</a></li>
+<li><a href="#index-suffixes_002c-filename-747">suffixes, filename</a>: <a href="#File-lookup">File lookup</a></li>
<li><a href="#index-suggestions_002c-making-6">suggestions, making</a>: <a href="#Introduction">Introduction</a></li>
-<li><a href="#index-Sun-2-18">Sun 2</a>: <a href="#History">History</a></li>
-<li><a href="#index-Sun-OpenWin-patches-439">Sun OpenWin patches</a>: <a href="#ShellWidgetClass">ShellWidgetClass</a></li>
-<li><a href="#index-supplier-directory_002c-omitting-223">supplier directory, omitting</a>: <a href="#mktex-configuration">mktex configuration</a></li>
-<li><a href="#index-supported-file-formats-617">supported file formats</a>: <a href="#Supported-file-formats">Supported file formats</a></li>
-<li><a href="#index-suppressing-warnings-775">suppressing warnings</a>: <a href="#Suppressing-warnings">Suppressing warnings</a></li>
-<li><a href="#index-symbolic-link-trees_002c-for-multiple-architectures-129">symbolic link trees, for multiple architectures</a>: <a href="#configure-scenarios">configure scenarios</a></li>
-<li><a href="#index-symbolic-links-not-found-389">symbolic links not found</a>: <a href="#Unable-to-find-files">Unable to find files</a></li>
-<li><a href="#index-symbolic-links_002c-and-_0040file_007bls_002dR_007d-563">symbolic links, and <samp><span class="file">ls-R</span></samp></a>: <a href="#ls_002dR">ls-R</a></li>
-<li><a href="#index-symlinks_002c-resolving-809">symlinks, resolving</a>: <a href="#Calling-sequence">Calling sequence</a></li>
-<li><a href="#index-system-C-compiler-bugs-411">system C compiler bugs</a>: <a href="#TeX-or-Metafont-failing">TeX or Metafont failing</a></li>
-<li><a href="#index-system-dependencies-89">system dependencies</a>: <a href="#Running-configure">Running configure</a></li>
-<li><a href="#index-system-V-universe-161">system V universe</a>: <a href="#Running-make">Running make</a></li>
-<li><a href="#index-T1FONTS-719"><code>T1FONTS</code></a>: <a href="#Supported-file-formats">Supported file formats</a></li>
-<li><a href="#index-T1INPUTS-720"><code>T1INPUTS</code></a>: <a href="#Supported-file-formats">Supported file formats</a></li>
-<li><a href="#index-T42FONTS-723"><code>T42FONTS</code></a>: <a href="#Supported-file-formats">Supported file formats</a></li>
-<li><a href="#index-tcfmgr_002emap-605"><code>tcfmgr.map</code></a>: <a href="#Specially_002drecognized-files">Specially-recognized files</a></li>
-<li><a href="#index-TDS-274">TDS</a>: <a href="#TeX-directory-structure">TeX directory structure</a></li>
-<li><a href="#index-testing_002c-post_002dinstallation-255">testing, post-installation</a>: <a href="#Installation-testing">Installation testing</a></li>
-<li><a href="#index-tests_002c-simple-39">tests, simple</a>: <a href="#Simple-installation">Simple installation</a></li>
-<li><a href="#index-te_0040TeX_007b_007d-309">teTeX</a>: <a href="#Other-TeX-packages">Other TeX packages</a></li>
-<li><a href="#index-g_t_0040TeX_007b_007d-directory-structure-271">TeX directory structure</a>: <a href="#TeX-directory-structure">TeX directory structure</a></li>
-<li><a href="#index-g_t_0040TeX_007b_007d-distributions-besides-Web2c-302">TeX distributions besides Web2c</a>: <a href="#Other-TeX-packages">Other TeX packages</a></li>
-<li><a href="#index-g_t_0040TeX_007b_007d-environment-variables-620">TeX environment variables</a>: <a href="#Supported-file-formats">Supported file formats</a></li>
-<li><a href="#index-g_t_0040TeX_007b_007d-failures-406">TeX failures</a>: <a href="#TeX-or-Metafont-failing">TeX or Metafont failing</a></li>
-<li><a href="#index-g_t_0040TeX_007b_007d-file-lookup-736">TeX file lookup</a>: <a href="#File-lookup">File lookup</a></li>
-<li><a href="#index-g_t_0040TeX_007b_007d-glyph-lookup-744">TeX glyph lookup</a>: <a href="#Glyph-lookup">Glyph lookup</a></li>
-<li><a href="#index-g_t_0040TeX_007b_007d-help-mailing-list-339">TeX help mailing list</a>: <a href="#Mailing-lists">Mailing lists</a></li>
-<li><a href="#index-g_t_0040TeX_007b_007d-hierarchy_002c-one-126">TeX hierarchy, one</a>: <a href="#configure-scenarios">configure scenarios</a></li>
-<li><a href="#index-g_t_0040TeX_007b_007d-Live-CD_002dROM-297">TeX Live CD-ROM</a>: <a href="#CD_002dROM-distribution">CD-ROM distribution</a></li>
-<li><a href="#index-g_t_0040TeX_007b_007d-support-616">TeX support</a>: <a href="#TeX-support">TeX support</a></li>
+<li><a href="#index-Sun-2-17">Sun 2</a>: <a href="#History">History</a></li>
+<li><a href="#index-Sun-OpenWin-patches-436">Sun OpenWin patches</a>: <a href="#ShellWidgetClass">ShellWidgetClass</a></li>
+<li><a href="#index-supplier-directory_002c-omitting-222">supplier directory, omitting</a>: <a href="#mktex-configuration">mktex configuration</a></li>
+<li><a href="#index-supported-file-formats-615">supported file formats</a>: <a href="#Supported-file-formats">Supported file formats</a></li>
+<li><a href="#index-suppressing-warnings-784">suppressing warnings</a>: <a href="#Suppressing-warnings">Suppressing warnings</a></li>
+<li><a href="#index-symbolic-link-trees_002c-for-multiple-architectures-128">symbolic link trees, for multiple architectures</a>: <a href="#configure-scenarios">configure scenarios</a></li>
+<li><a href="#index-symbolic-links-not-found-386">symbolic links not found</a>: <a href="#Unable-to-find-files">Unable to find files</a></li>
+<li><a href="#index-symbolic-links_002c-and-_0040file_007bls_002dR_007d-560">symbolic links, and <samp><span class="file">ls-R</span></samp></a>: <a href="#ls_002dR">ls-R</a></li>
+<li><a href="#index-symlinks_002c-resolving-821">symlinks, resolving</a>: <a href="#Calling-sequence">Calling sequence</a></li>
+<li><a href="#index-system-C-compiler-bugs-408">system C compiler bugs</a>: <a href="#TeX-or-Metafont-failing">TeX or Metafont failing</a></li>
+<li><a href="#index-system-dependencies-88">system dependencies</a>: <a href="#Running-configure">Running configure</a></li>
+<li><a href="#index-system-V-universe-160">system V universe</a>: <a href="#Running-make">Running make</a></li>
+<li><a href="#index-T1FONTS-728"><code>T1FONTS</code></a>: <a href="#Supported-file-formats">Supported file formats</a></li>
+<li><a href="#index-T1INPUTS-729"><code>T1INPUTS</code></a>: <a href="#Supported-file-formats">Supported file formats</a></li>
+<li><a href="#index-T42FONTS-732"><code>T42FONTS</code></a>: <a href="#Supported-file-formats">Supported file formats</a></li>
+<li><a href="#index-tcfmgr_002emap-603"><code>tcfmgr.map</code></a>: <a href="#Specially_002drecognized-files">Specially-recognized files</a></li>
+<li><a href="#index-TDS-273">TDS</a>: <a href="#TeX-directory-structure">TeX directory structure</a></li>
+<li><a href="#index-testing_002c-post_002dinstallation-254">testing, post-installation</a>: <a href="#Installation-testing">Installation testing</a></li>
+<li><a href="#index-tests_002c-simple-38">tests, simple</a>: <a href="#Simple-installation">Simple installation</a></li>
+<li><a href="#index-te_0040TeX_007b_007d-308">teTeX</a>: <a href="#Other-TeX-packages">Other TeX packages</a></li>
+<li><a href="#index-g_t_0040TeX_007b_007d-directory-structure-270">TeX directory structure</a>: <a href="#TeX-directory-structure">TeX directory structure</a></li>
+<li><a href="#index-g_t_0040TeX_007b_007d-distributions-besides-Web2c-301">TeX distributions besides Web2c</a>: <a href="#Other-TeX-packages">Other TeX packages</a></li>
+<li><a href="#index-g_t_0040TeX_007b_007d-environment-variables-618">TeX environment variables</a>: <a href="#Supported-file-formats">Supported file formats</a></li>
+<li><a href="#index-g_t_0040TeX_007b_007d-failures-403">TeX failures</a>: <a href="#TeX-or-Metafont-failing">TeX or Metafont failing</a></li>
+<li><a href="#index-g_t_0040TeX_007b_007d-file-lookup-745">TeX file lookup</a>: <a href="#File-lookup">File lookup</a></li>
+<li><a href="#index-g_t_0040TeX_007b_007d-glyph-lookup-753">TeX glyph lookup</a>: <a href="#Glyph-lookup">Glyph lookup</a></li>
+<li><a href="#index-g_t_0040TeX_007b_007d-help-mailing-list-336">TeX help mailing list</a>: <a href="#Mailing-lists">Mailing lists</a></li>
+<li><a href="#index-g_t_0040TeX_007b_007d-hierarchy_002c-one-125">TeX hierarchy, one</a>: <a href="#configure-scenarios">configure scenarios</a></li>
+<li><a href="#index-g_t_0040TeX_007b_007d-Live-CD_002dROM-296">TeX Live CD-ROM</a>: <a href="#CD_002dROM-distribution">CD-ROM distribution</a></li>
+<li><a href="#index-g_t_0040TeX_007b_007d-support-614">TeX support</a>: <a href="#TeX-support">TeX support</a></li>
<li><a href="#index-g_t_0040TeX_007b_007d-Users-Group-10">TeX Users Group</a>: <a href="#Introduction">Introduction</a></li>
-<li><a href="#index-tex_002darchive_0040_0040math_002eutah_002eedu-337"><code>tex-archive@math.utah.edu</code></a>: <a href="#Mailing-lists">Mailing lists</a></li>
-<li><a href="#index-tex_002dfile_002ec-740"><code>tex-file.c</code></a>: <a href="#File-lookup">File lookup</a></li>
-<li><a href="#index-tex_002dfile_002eh-791"><code>tex-file.h</code></a>: <a href="#Programming-overview">Programming overview</a></li>
-<li><a href="#index-tex_002dglyph_002ec-745"><code>tex-glyph.c</code></a>: <a href="#Glyph-lookup">Glyph lookup</a></li>
-<li><a href="#index-tex_002dglyph_002eh-792"><code>tex-glyph.h</code></a>: <a href="#Programming-overview">Programming overview</a></li>
-<li><a href="#index-tex_002dk_002drequest_0040_0040mail_002etug_002eorg-336"><code>tex-k-request@mail.tug.org</code></a>: <a href="#Mailing-lists">Mailing lists</a></li>
-<li><a href="#index-tex_002dk_0040_0040mail_002etug_002eorg-_0040r_007b_0028bug-address_0029_007d-315"><code>tex-k@mail.tug.org </code><span class="roman">(bug address)</span></a>: <a href="#Reporting-bugs">Reporting bugs</a></li>
-<li><a href="#index-TEX_005fHUSH-776"><code>TEX_HUSH</code></a>: <a href="#Suppressing-warnings">Suppressing warnings</a></li>
-<li><a href="#index-TEX_005fHUSH-478"><code>TEX_HUSH</code></a>: <a href="#Searching-overview">Searching overview</a></li>
-<li><a href="#index-TEXBIB-629"><code>TEXBIB</code></a>: <a href="#Supported-file-formats">Supported file formats</a></li>
-<li><a href="#index-TEXCONFIG-639"><code>TEXCONFIG</code></a>: <a href="#Supported-file-formats">Supported file formats</a></li>
-<li><a href="#index-TEXDOCS-704"><code>TEXDOCS</code></a>: <a href="#Supported-file-formats">Supported file formats</a></li>
-<li><a href="#index-TEXFONTMAPS-662"><code>TEXFONTMAPS</code></a>: <a href="#Supported-file-formats">Supported file formats</a></li>
-<li><a href="#index-TEXFONTS-649"><code>TEXFONTS</code></a>: <a href="#Supported-file-formats">Supported file formats</a></li>
-<li><a href="#index-texfonts_002emap-755"><code>texfonts.map</code></a>: <a href="#Fontmap">Fontmap</a></li>
-<li><a href="#index-TEXFORMATS-644"><code>TEXFORMATS</code></a>: <a href="#Supported-file-formats">Supported file formats</a></li>
-<li><a href="#index-TEXINDEXSTYLE-655"><code>TEXINDEXSTYLE</code></a>: <a href="#Supported-file-formats">Supported file formats</a></li>
-<li><a href="#index-TEXINPUTS-653"><code>TEXINPUTS</code></a>: <a href="#Supported-file-formats">Supported file formats</a></li>
-<li><a href="#index-TEXMF-270"><code>TEXMF</code></a>: <a href="#TeX-directory-structure">TeX directory structure</a></li>
-<li><a href="#index-texmf_002ecnf-604"><code>texmf.cnf</code></a>: <a href="#Specially_002drecognized-files">Specially-recognized files</a></li>
-<li><a href="#index-g_t_0040file_007btexmf_002ecnf_007d-missing_002c-warning-about-492"><samp><span class="file">texmf.cnf</span></samp> missing, warning about</a>: <a href="#Config-files">Config files</a></li>
-<li><a href="#index-texmf_002ecnf_0040r_007b_002c-and-variable-expansion_007d-519"><code>texmf.cnf</code><span class="roman">, and variable expansion</span></a>: <a href="#Variable-expansion">Variable expansion</a></li>
-<li><a href="#index-texmf_002ecnf_0040r_007b_002c-creating_007d-143"><code>texmf.cnf</code><span class="roman">, creating</span></a>: <a href="#Running-make">Running make</a></li>
-<li><a href="#index-texmf_002ecnf_0040r_007b_002c-definition-for_007d-487"><code>texmf.cnf</code><span class="roman">, definition for</span></a>: <a href="#Config-files">Config files</a></li>
-<li><a href="#index-texmf_002ecnf_0040r_007b_002c-generated_007d-82"><code>texmf.cnf</code><span class="roman">, generated</span></a>: <a href="#Default-path-generation">Default path generation</a></li>
-<li><a href="#index-texmf_002ecnf_0040r_007b_002c-source-for-path_007d-484"><code>texmf.cnf</code><span class="roman">, source for path</span></a>: <a href="#Path-sources">Path sources</a></li>
-<li><a href="#index-texmf_002ein-81"><code>texmf.in</code></a>: <a href="#Default-path-generation">Default path generation</a></li>
-<li><a href="#index-texmf_002ein_0040r_007b_002c-editing_007d-66"><code>texmf.in</code><span class="roman">, editing</span></a>: <a href="#Changing-search-paths">Changing search paths</a></li>
-<li><a href="#index-texmf_002esed-80"><code>texmf.sed</code></a>: <a href="#Default-path-generation">Default path generation</a></li>
-<li><a href="#index-TEXMFCNF-635"><code>TEXMFCNF</code></a>: <a href="#Supported-file-formats">Supported file formats</a></li>
-<li><a href="#index-TEXMFCNF-489"><code>TEXMFCNF</code></a>: <a href="#Config-files">Config files</a></li>
-<li><a href="#index-TEXMFDBS-660"><code>TEXMFDBS</code></a>: <a href="#Supported-file-formats">Supported file formats</a></li>
-<li><a href="#index-TEXMFDBS-554"><code>TEXMFDBS</code></a>: <a href="#ls_002dR">ls-R</a></li>
-<li><a href="#index-TEXMFINI-626"><code>TEXMFINI</code></a>: <a href="#Supported-file-formats">Supported file formats</a></li>
-<li><a href="#index-TEXMFLOG-378"><code>TEXMFLOG</code></a>: <a href="#Logging">Logging</a></li>
-<li><a href="#index-TEXMFOUTPUT-252"><code>TEXMFOUTPUT</code></a>: <a href="#mktex-script-names">mktex script names</a></li>
-<li><a href="#index-TEXMFSCRIPTS-707"><code>TEXMFSCRIPTS</code></a>: <a href="#Supported-file-formats">Supported file formats</a></li>
-<li><a href="#index-TEXMFVAR-235"><code>TEXMFVAR</code></a>: <a href="#mktex-configuration">mktex configuration</a></li>
-<li><a href="#index-texmfvar-234"><code>texmfvar</code></a>: <a href="#mktex-configuration">mktex configuration</a></li>
-<li><a href="#index-TEXPICTS-652"><code>TEXPICTS</code></a>: <a href="#Supported-file-formats">Supported file formats</a></li>
-<li><a href="#index-TEXPKS-693"><code>TEXPKS</code></a>: <a href="#Supported-file-formats">Supported file formats</a></li>
-<li><a href="#index-TEXPOOL-709"><code>TEXPOOL</code></a>: <a href="#Supported-file-formats">Supported file formats</a></li>
-<li><a href="#index-TEXPSHEADERS-697"><code>TEXPSHEADERS</code></a>: <a href="#Supported-file-formats">Supported file formats</a></li>
-<li><a href="#index-TEXSIZES-770"><code>TEXSIZES</code></a>: <a href="#Fallback-font">Fallback font</a></li>
-<li><a href="#index-TEXSOURCES-706"><code>TEXSOURCES</code></a>: <a href="#Supported-file-formats">Supported file formats</a></li>
-<li><a href="#index-TFMFONTS-711"><code>TFMFONTS</code></a>: <a href="#Supported-file-formats">Supported file formats</a></li>
-<li><a href="#index-tilde-expansion-525">tilde expansion</a>: <a href="#Tilde-expansion">Tilde expansion</a></li>
-<li><a href="#index-tilde_002ec-532"><code>tilde.c</code></a>: <a href="#Tilde-expansion">Tilde expansion</a></li>
-<li><a href="#index-time-_0040r_007bsystem-call_007d-380"><code>time </code><span class="roman">system call</span></a>: <a href="#Logging">Logging</a></li>
-<li><a href="#index-tolerance-for-glyph-lookup-749">tolerance for glyph lookup</a>: <a href="#Basic-glyph-lookup">Basic glyph lookup</a></li>
-<li><a href="#index-total-disk-space-48">total disk space</a>: <a href="#Disk-space">Disk space</a></li>
-<li><a href="#index-trailing-_0040samp_007b_002f_007d-in-home-directory-530">trailing &lsquo;<samp><span class="samp">/</span></samp>&rsquo; in home directory</a>: <a href="#Tilde-expansion">Tilde expansion</a></li>
-<li><a href="#index-trailing-colons-509">trailing colons</a>: <a href="#Default-expansion">Default expansion</a></li>
-<li><a href="#index-TRFONTS-713"><code>TRFONTS</code></a>: <a href="#Supported-file-formats">Supported file formats</a></li>
-<li><a href="#index-trick-for-detecting-leaf-directories-542">trick for detecting leaf directories</a>: <a href="#Subdirectory-expansion">Subdirectory expansion</a></li>
-<li><a href="#index-trojan-horse-attack-258">trojan horse attack</a>: <a href="#Security">Security</a></li>
-<li><a href="#index-try_005fstd_005fextension_005ffirst-739"><code>try_std_extension_first</code></a>: <a href="#File-lookup">File lookup</a></li>
-<li><a href="#index-TTFONTS-716"><code>TTFONTS</code></a>: <a href="#Supported-file-formats">Supported file formats</a></li>
-<li><a href="#index-tug_002eorg-278"><code>tug.org</code></a>: <a href="#unixtex_002eftp">unixtex.ftp</a></li>
-<li><a href="#index-tug_0040_0040tug_002eorg-11"><code>tug@tug.org</code></a>: <a href="#Introduction">Introduction</a></li>
-<li><a href="#index-typeface-directory_002c-omitting-225">typeface directory, omitting</a>: <a href="#mktex-configuration">mktex configuration</a></li>
-<li><a href="#index-ucbinclude_0040r_007b_002c-avoiding_007d-164"><code>ucbinclude</code><span class="roman">, avoiding</span></a>: <a href="#Running-make">Running make</a></li>
-<li><a href="#index-Ultrix-shells-and-_0040code_007bconfigure_007d-103">Ultrix shells and <code>configure</code></a>: <a href="#configure-shells">configure shells</a></li>
-<li><a href="#index-unable-to-find-files-385">unable to find files</a>: <a href="#Unable-to-find-files">Unable to find files</a></li>
-<li><a href="#index-unable-to-generate-fonts-394">unable to generate fonts</a>: <a href="#Unable-to-generate-fonts">Unable to generate fonts</a></li>
-<li><a href="#index-uname-320"><code>uname</code></a>: <a href="#Bug-checklist">Bug checklist</a></li>
-<li><a href="#index-universe_002c-BSD-vs_002e_0040_003a-system-V-159">universe, BSD vs. system V</a>: <a href="#Running-make">Running make</a></li>
-<li><a href="#index-UNIX_005fST_005fLINK-547"><code>UNIX_ST_LINK</code></a>: <a href="#Subdirectory-expansion">Subdirectory expansion</a></li>
-<li><a href="#index-unixtex_002eftp-277"><code>unixtex.ftp</code></a>: <a href="#unixtex_002eftp">unixtex.ftp</a></li>
-<li><a href="#index-unknown-special-warnings-786">unknown special warnings</a>: <a href="#Suppressing-warnings">Suppressing warnings</a></li>
-<li><a href="#index-unreadable-file-warnings-784">unreadable file warnings</a>: <a href="#Suppressing-warnings">Suppressing warnings</a></li>
-<li><a href="#index-unreadable-files-474">unreadable files</a>: <a href="#Searching-overview">Searching overview</a></li>
-<li><a href="#index-unusable-_0040file_007bls_002dR_007d-warning-568">unusable <samp><span class="file">ls-R</span></samp> warning</a>: <a href="#ls_002dR">ls-R</a></li>
-<li><a href="#index-usage-patterns_002c-finding-376">usage patterns, finding</a>: <a href="#Logging">Logging</a></li>
-<li><a href="#index-USE_005fTEXMFVAR-236"><code>USE_TEXMFVAR</code></a>: <a href="#mktex-configuration">mktex configuration</a></li>
-<li><a href="#index-USE_005fVARTEXFONTS-233"><code>USE_VARTEXFONTS</code></a>: <a href="#mktex-configuration">mktex configuration</a></li>
-<li><a href="#index-Usenet-_0040TeX_007b_007d-newsgroup-341">Usenet TeX newsgroup</a>: <a href="#Mailing-lists">Mailing lists</a></li>
-<li><a href="#index-USERPROFILE_0040r_007b_002c-as-_007e-expansion_007d-528"><code>USERPROFILE</code><span class="roman">, as ~ expansion</span></a>: <a href="#Tilde-expansion">Tilde expansion</a></li>
-<li><a href="#index-varfonts-229"><code>varfonts</code></a>: <a href="#mktex-configuration">mktex configuration</a></li>
-<li><a href="#index-variable-expansion-517">variable expansion</a>: <a href="#Variable-expansion">Variable expansion</a></li>
-<li><a href="#index-variable_002ec-522"><code>variable.c</code></a>: <a href="#Variable-expansion">Variable expansion</a></li>
-<li><a href="#index-variable_002eh-835"><code>variable.h</code></a>: <a href="#Programming-with-config-files">Programming with config files</a></li>
-<li><a href="#index-VARTEXFONTS-231"><code>VARTEXFONTS</code></a>: <a href="#mktex-configuration">mktex configuration</a></li>
-<li><a href="#index-VAX-11_002f750-17">VAX 11/750</a>: <a href="#History">History</a></li>
-<li><a href="#index-version-number_002c-of-Kpathsea-51">version number, of Kpathsea</a>: <a href="#Kpathsea-application-distributions">Kpathsea application distributions</a></li>
-<li><a href="#index-version-numbers_002c-determining-319">version numbers, determining</a>: <a href="#Bug-checklist">Bug checklist</a></li>
-<li><a href="#index-VF-files_002c-not-found-465">VF files, not found</a>: <a href="#Searching-overview">Searching overview</a></li>
-<li><a href="#index-VFFONTS-725"><code>VFFONTS</code></a>: <a href="#Supported-file-formats">Supported file formats</a></li>
-<li><a href="#index-VMS-support-46">VMS support</a>: <a href="#Custom-installation">Custom installation</a></li>
-<li><a href="#index-VMS-_0040TeX_007b_007d-implementations-305">VMS TeX implementations</a>: <a href="#Other-TeX-packages">Other TeX packages</a></li>
-<li><a href="#index-Vojta_002c-Paul-21">Vojta, Paul</a>: <a href="#History">History</a></li>
-<li><a href="#index-Walsh_002c-Norman-24">Walsh, Norman</a>: <a href="#History">History</a></li>
-<li><a href="#index-warning-about-unusable-_0040file_007bls_002dR_007d-567">warning about unusable <samp><span class="file">ls-R</span></samp></a>: <a href="#ls_002dR">ls-R</a></li>
-<li><a href="#index-warning_002c-about-missing-_0040file_007btexmf_002ecnf_007d-491">warning, about missing <samp><span class="file">texmf.cnf</span></samp></a>: <a href="#Config-files">Config files</a></li>
-<li><a href="#index-warnings_002c-file-access-476">warnings, file access</a>: <a href="#Searching-overview">Searching overview</a></li>
-<li><a href="#index-warnings_002c-pointer-combinations-446">warnings, pointer combinations</a>: <a href="#Pointer-combination-warnings">Pointer combination warnings</a></li>
-<li><a href="#index-warnings_002c-suppressing-774">warnings, suppressing</a>: <a href="#Suppressing-warnings">Suppressing warnings</a></li>
-<li><a href="#index-wcstombs-429"><code>wcstombs</code></a>: <a href="#dlopen">dlopen</a></li>
-<li><a href="#index-WEB2C-729"><code>WEB2C</code></a>: <a href="#Supported-file-formats">Supported file formats</a></li>
-<li><a href="#index-Weber_002c-Olaf-26">Weber, Olaf</a>: <a href="#History">History</a></li>
-<li><a href="#index-WEBINPUTS-728"><code>WEBINPUTS</code></a>: <a href="#Supported-file-formats">Supported file formats</a></li>
-<li><a href="#index-whitespace_002c-in-fontmap-files-760">whitespace, in fontmap files</a>: <a href="#Fontmap">Fontmap</a></li>
-<li><a href="#index-whitespace_002c-not-ignored-on-continuation-lines-497">whitespace, not ignored on continuation lines</a>: <a href="#Config-files">Config files</a></li>
-<li><a href="#index-Windows-_0040TeX_007b_007d-implementations-308">Windows TeX implementations</a>: <a href="#Other-TeX-packages">Other TeX packages</a></li>
-<li><a href="#index-World-Wide-Web-CTAN-access-289">World Wide Web CTAN access</a>: <a href="#Electronic-distribution">Electronic distribution</a></li>
-<li><a href="#index-www_002etug_002eorg-279"><code>www.tug.org</code></a>: <a href="#unixtex_002eftp">unixtex.ftp</a></li>
-<li><a href="#index-X11-previewer-61">X11 previewer</a>: <a href="#Kpathsea-application-distributions">Kpathsea application distributions</a></li>
-<li><a href="#index-X11_002c-lacking-on-NeXT-55">X11, lacking on NeXT</a>: <a href="#Kpathsea-application-distributions">Kpathsea application distributions</a></li>
-<li><a href="#index-XCFLAGS-149"><code>XCFLAGS</code></a>: <a href="#Running-make">Running make</a></li>
-<li><a href="#index-XCPPFLAGS-146"><code>XCPPFLAGS</code></a>: <a href="#Running-make">Running make</a></li>
-<li><a href="#index-XDEFS-147"><code>XDEFS</code></a>: <a href="#Running-make">Running make</a></li>
-<li><a href="#index-XDVIFONTS-732"><code>XDVIFONTS</code></a>: <a href="#Supported-file-formats">Supported file formats</a></li>
-<li><a href="#index-XDVIMAKEPK-248"><code>XDVIMAKEPK</code></a>: <a href="#mktex-script-names">mktex script names</a></li>
-<li><a href="#index-XDVISIZES-768"><code>XDVISIZES</code></a>: <a href="#Fallback-font">Fallback font</a></li>
-<li><a href="#index-XLDFLAGS-151"><code>XLDFLAGS</code></a>: <a href="#Running-make">Running make</a></li>
-<li><a href="#index-XLOADLIBES-153"><code>XLOADLIBES</code></a>: <a href="#Running-make">Running make</a></li>
-<li><a href="#index-XMAKEARGS-155"><code>XMAKEARGS</code></a>: <a href="#Running-make">Running make</a></li>
-<li><a href="#index-Xmu-_0040r_007blibrary-problems_007d-438"><code>Xmu </code><span class="roman">library problems</span></a>: <a href="#ShellWidgetClass">ShellWidgetClass</a></li>
-<li><a href="#index-XtStrings-424"><code>XtStrings</code></a>: <a href="#XtStrings">XtStrings</a></li>
-<li><a href="#index-zuhn_002c-david-23">zuhn, david</a>: <a href="#History">History</a></li>
-<li><a href="#index-g_t_0040_007b-_0040r_007bexpansion_007d-533"><code>{ </code><span class="roman">expansion</span></a>: <a href="#Brace-expansion">Brace expansion</a></li>
-<li><a href="#index-g_t_007e-_0040r_007bexpansion_007d-523"><code>~ </code><span class="roman">expansion</span></a>: <a href="#Tilde-expansion">Tilde expansion</a></li>
+<li><a href="#index-tex_002dfile_002ec-749"><code>tex-file.c</code></a>: <a href="#File-lookup">File lookup</a></li>
+<li><a href="#index-tex_002dfile_002eh-802"><code>tex-file.h</code></a>: <a href="#Programming-overview">Programming overview</a></li>
+<li><a href="#index-tex_002dglyph_002ec-754"><code>tex-glyph.c</code></a>: <a href="#Glyph-lookup">Glyph lookup</a></li>
+<li><a href="#index-tex_002dglyph_002eh-803"><code>tex-glyph.h</code></a>: <a href="#Programming-overview">Programming overview</a></li>
+<li><a href="#index-tex_002dk_002drequest_0040_0040tug_002eorg-335"><code>tex-k-request@tug.org</code></a>: <a href="#Mailing-lists">Mailing lists</a></li>
+<li><a href="#index-tex_002dk_0040_0040tug_002eorg-_0040r_007b_0028bug-address_0029_007d-314"><code>tex-k@tug.org </code><span class="roman">(bug address)</span></a>: <a href="#Reporting-bugs">Reporting bugs</a></li>
+<li><a href="#index-TEX_005fHUSH-785"><code>TEX_HUSH</code></a>: <a href="#Suppressing-warnings">Suppressing warnings</a></li>
+<li><a href="#index-TEX_005fHUSH-475"><code>TEX_HUSH</code></a>: <a href="#Searching-overview">Searching overview</a></li>
+<li><a href="#index-TEXBIB-627"><code>TEXBIB</code></a>: <a href="#Supported-file-formats">Supported file formats</a></li>
+<li><a href="#index-TEXCONFIG-637"><code>TEXCONFIG</code></a>: <a href="#Supported-file-formats">Supported file formats</a></li>
+<li><a href="#index-TEXDOCS-713"><code>TEXDOCS</code></a>: <a href="#Supported-file-formats">Supported file formats</a></li>
+<li><a href="#index-TEXFONTMAPS-664"><code>TEXFONTMAPS</code></a>: <a href="#Supported-file-formats">Supported file formats</a></li>
+<li><a href="#index-TEXFONTS-651"><code>TEXFONTS</code></a>: <a href="#Supported-file-formats">Supported file formats</a></li>
+<li><a href="#index-texfonts_002emap-764"><code>texfonts.map</code></a>: <a href="#Fontmap">Fontmap</a></li>
+<li><a href="#index-TEXFORMATS-642"><code>TEXFORMATS</code></a>: <a href="#Supported-file-formats">Supported file formats</a></li>
+<li><a href="#index-TEXINDEXSTYLE-657"><code>TEXINDEXSTYLE</code></a>: <a href="#Supported-file-formats">Supported file formats</a></li>
+<li><a href="#index-TEXINPUTS-655"><code>TEXINPUTS</code></a>: <a href="#Supported-file-formats">Supported file formats</a></li>
+<li><a href="#index-TEXMF-269"><code>TEXMF</code></a>: <a href="#TeX-directory-structure">TeX directory structure</a></li>
+<li><a href="#index-texmf_002ecnf-601"><code>texmf.cnf</code></a>: <a href="#Specially_002drecognized-files">Specially-recognized files</a></li>
+<li><a href="#index-g_t_0040file_007btexmf_002ecnf_007d-missing_002c-warning-about-489"><samp><span class="file">texmf.cnf</span></samp> missing, warning about</a>: <a href="#Config-files">Config files</a></li>
+<li><a href="#index-texmf_002ecnf_0040r_007b_002c-and-variable-expansion_007d-516"><code>texmf.cnf</code><span class="roman">, and variable expansion</span></a>: <a href="#Variable-expansion">Variable expansion</a></li>
+<li><a href="#index-texmf_002ecnf_0040r_007b_002c-creating_007d-142"><code>texmf.cnf</code><span class="roman">, creating</span></a>: <a href="#Running-make">Running make</a></li>
+<li><a href="#index-texmf_002ecnf_0040r_007b_002c-definition-for_007d-484"><code>texmf.cnf</code><span class="roman">, definition for</span></a>: <a href="#Config-files">Config files</a></li>
+<li><a href="#index-texmf_002ecnf_0040r_007b_002c-generated_007d-81"><code>texmf.cnf</code><span class="roman">, generated</span></a>: <a href="#Default-path-generation">Default path generation</a></li>
+<li><a href="#index-texmf_002ecnf_0040r_007b_002c-source-for-path_007d-481"><code>texmf.cnf</code><span class="roman">, source for path</span></a>: <a href="#Path-sources">Path sources</a></li>
+<li><a href="#index-texmf_002ein-80"><code>texmf.in</code></a>: <a href="#Default-path-generation">Default path generation</a></li>
+<li><a href="#index-texmf_002ein_0040r_007b_002c-editing_007d-65"><code>texmf.in</code><span class="roman">, editing</span></a>: <a href="#Changing-search-paths">Changing search paths</a></li>
+<li><a href="#index-texmf_002esed-79"><code>texmf.sed</code></a>: <a href="#Default-path-generation">Default path generation</a></li>
+<li><a href="#index-TEXMFCNF-633"><code>TEXMFCNF</code></a>: <a href="#Supported-file-formats">Supported file formats</a></li>
+<li><a href="#index-TEXMFCNF-486"><code>TEXMFCNF</code></a>: <a href="#Config-files">Config files</a></li>
+<li><a href="#index-TEXMFDBS-662"><code>TEXMFDBS</code></a>: <a href="#Supported-file-formats">Supported file formats</a></li>
+<li><a href="#index-TEXMFDBS-551"><code>TEXMFDBS</code></a>: <a href="#ls_002dR">ls-R</a></li>
+<li><a href="#index-TEXMFINI-624"><code>TEXMFINI</code></a>: <a href="#Supported-file-formats">Supported file formats</a></li>
+<li><a href="#index-TEXMFLOG-375"><code>TEXMFLOG</code></a>: <a href="#Logging">Logging</a></li>
+<li><a href="#index-TEXMFOUTPUT-251"><code>TEXMFOUTPUT</code></a>: <a href="#mktex-script-names">mktex script names</a></li>
+<li><a href="#index-TEXMFSCRIPTS-716"><code>TEXMFSCRIPTS</code></a>: <a href="#Supported-file-formats">Supported file formats</a></li>
+<li><a href="#index-TEXMFVAR-234"><code>TEXMFVAR</code></a>: <a href="#mktex-configuration">mktex configuration</a></li>
+<li><a href="#index-texmfvar-233"><code>texmfvar</code></a>: <a href="#mktex-configuration">mktex configuration</a></li>
+<li><a href="#index-TEXPICTS-654"><code>TEXPICTS</code></a>: <a href="#Supported-file-formats">Supported file formats</a></li>
+<li><a href="#index-TEXPKS-702"><code>TEXPKS</code></a>: <a href="#Supported-file-formats">Supported file formats</a></li>
+<li><a href="#index-TEXPOOL-718"><code>TEXPOOL</code></a>: <a href="#Supported-file-formats">Supported file formats</a></li>
+<li><a href="#index-TEXPSHEADERS-706"><code>TEXPSHEADERS</code></a>: <a href="#Supported-file-formats">Supported file formats</a></li>
+<li><a href="#index-TEXSIZES-779"><code>TEXSIZES</code></a>: <a href="#Fallback-font">Fallback font</a></li>
+<li><a href="#index-TEXSOURCES-715"><code>TEXSOURCES</code></a>: <a href="#Supported-file-formats">Supported file formats</a></li>
+<li><a href="#index-TFMFONTS-720"><code>TFMFONTS</code></a>: <a href="#Supported-file-formats">Supported file formats</a></li>
+<li><a href="#index-tilde-expansion-522">tilde expansion</a>: <a href="#Tilde-expansion">Tilde expansion</a></li>
+<li><a href="#index-tilde_002ec-529"><code>tilde.c</code></a>: <a href="#Tilde-expansion">Tilde expansion</a></li>
+<li><a href="#index-time-_0040r_007bsystem-call_007d-377"><code>time </code><span class="roman">system call</span></a>: <a href="#Logging">Logging</a></li>
+<li><a href="#index-tolerance-for-glyph-lookup-758">tolerance for glyph lookup</a>: <a href="#Basic-glyph-lookup">Basic glyph lookup</a></li>
+<li><a href="#index-total-disk-space-47">total disk space</a>: <a href="#Disk-space">Disk space</a></li>
+<li><a href="#index-trailing-_0040samp_007b_002f_007d-in-home-directory-527">trailing &lsquo;<samp><span class="samp">/</span></samp>&rsquo; in home directory</a>: <a href="#Tilde-expansion">Tilde expansion</a></li>
+<li><a href="#index-trailing-colons-506">trailing colons</a>: <a href="#Default-expansion">Default expansion</a></li>
+<li><a href="#index-TRFONTS-722"><code>TRFONTS</code></a>: <a href="#Supported-file-formats">Supported file formats</a></li>
+<li><a href="#index-trick-for-detecting-leaf-directories-539">trick for detecting leaf directories</a>: <a href="#Subdirectory-expansion">Subdirectory expansion</a></li>
+<li><a href="#index-trojan-horse-attack-257">trojan horse attack</a>: <a href="#Security">Security</a></li>
+<li><a href="#index-try_005fstd_005fextension_005ffirst-748"><code>try_std_extension_first</code></a>: <a href="#File-lookup">File lookup</a></li>
+<li><a href="#index-TTFONTS-725"><code>TTFONTS</code></a>: <a href="#Supported-file-formats">Supported file formats</a></li>
+<li><a href="#index-tug_002eorg-277"><code>tug.org</code></a>: <a href="#unixtex_002eftp">unixtex.ftp</a></li>
+<li><a href="#index-typeface-directory_002c-omitting-224">typeface directory, omitting</a>: <a href="#mktex-configuration">mktex configuration</a></li>
+<li><a href="#index-ucbinclude_0040r_007b_002c-avoiding_007d-163"><code>ucbinclude</code><span class="roman">, avoiding</span></a>: <a href="#Running-make">Running make</a></li>
+<li><a href="#index-Ultrix-shells-and-_0040code_007bconfigure_007d-102">Ultrix shells and <code>configure</code></a>: <a href="#configure-shells">configure shells</a></li>
+<li><a href="#index-unable-to-find-files-382">unable to find files</a>: <a href="#Unable-to-find-files">Unable to find files</a></li>
+<li><a href="#index-unable-to-generate-fonts-391">unable to generate fonts</a>: <a href="#Unable-to-generate-fonts">Unable to generate fonts</a></li>
+<li><a href="#index-uname-319"><code>uname</code></a>: <a href="#Bug-checklist">Bug checklist</a></li>
+<li><a href="#index-universe_002c-BSD-vs_002e_0040_003a-system-V-158">universe, BSD vs. system V</a>: <a href="#Running-make">Running make</a></li>
+<li><a href="#index-unixtex_002eftp-276"><code>unixtex.ftp</code></a>: <a href="#unixtex_002eftp">unixtex.ftp</a></li>
+<li><a href="#index-unknown-special-warnings-795">unknown special warnings</a>: <a href="#Suppressing-warnings">Suppressing warnings</a></li>
+<li><a href="#index-unreadable-file-warnings-793">unreadable file warnings</a>: <a href="#Suppressing-warnings">Suppressing warnings</a></li>
+<li><a href="#index-unreadable-files-471">unreadable files</a>: <a href="#Searching-overview">Searching overview</a></li>
+<li><a href="#index-unusable-_0040file_007bls_002dR_007d-warning-565">unusable <samp><span class="file">ls-R</span></samp> warning</a>: <a href="#ls_002dR">ls-R</a></li>
+<li><a href="#index-usage-patterns_002c-finding-373">usage patterns, finding</a>: <a href="#Logging">Logging</a></li>
+<li><a href="#index-USE_005fTEXMFVAR-235"><code>USE_TEXMFVAR</code></a>: <a href="#mktex-configuration">mktex configuration</a></li>
+<li><a href="#index-USE_005fVARTEXFONTS-232"><code>USE_VARTEXFONTS</code></a>: <a href="#mktex-configuration">mktex configuration</a></li>
+<li><a href="#index-Usenet-_0040TeX_007b_007d-newsgroup-338">Usenet TeX newsgroup</a>: <a href="#Mailing-lists">Mailing lists</a></li>
+<li><a href="#index-USERPROFILE_0040r_007b_002c-as-_007e-expansion_007d-525"><code>USERPROFILE</code><span class="roman">, as ~ expansion</span></a>: <a href="#Tilde-expansion">Tilde expansion</a></li>
+<li><a href="#index-varfonts-228"><code>varfonts</code></a>: <a href="#mktex-configuration">mktex configuration</a></li>
+<li><a href="#index-variable-expansion-514">variable expansion</a>: <a href="#Variable-expansion">Variable expansion</a></li>
+<li><a href="#index-variable_002ec-519"><code>variable.c</code></a>: <a href="#Variable-expansion">Variable expansion</a></li>
+<li><a href="#index-variable_002eh-845"><code>variable.h</code></a>: <a href="#Programming-with-config-files">Programming with config files</a></li>
+<li><a href="#index-VARTEXFONTS-230"><code>VARTEXFONTS</code></a>: <a href="#mktex-configuration">mktex configuration</a></li>
+<li><a href="#index-VAX-11_002f750-16">VAX 11/750</a>: <a href="#History">History</a></li>
+<li><a href="#index-version-number_002c-of-Kpathsea-50">version number, of Kpathsea</a>: <a href="#Kpathsea-application-distributions">Kpathsea application distributions</a></li>
+<li><a href="#index-version-numbers_002c-determining-318">version numbers, determining</a>: <a href="#Bug-checklist">Bug checklist</a></li>
+<li><a href="#index-VF-files_002c-not-found-462">VF files, not found</a>: <a href="#Searching-overview">Searching overview</a></li>
+<li><a href="#index-VFFONTS-734"><code>VFFONTS</code></a>: <a href="#Supported-file-formats">Supported file formats</a></li>
+<li><a href="#index-VMS-support-45">VMS support</a>: <a href="#Custom-installation">Custom installation</a></li>
+<li><a href="#index-VMS-_0040TeX_007b_007d-implementations-304">VMS TeX implementations</a>: <a href="#Other-TeX-packages">Other TeX packages</a></li>
+<li><a href="#index-Vojta_002c-Paul-20">Vojta, Paul</a>: <a href="#History">History</a></li>
+<li><a href="#index-Walsh_002c-Norman-23">Walsh, Norman</a>: <a href="#History">History</a></li>
+<li><a href="#index-warning-about-unusable-_0040file_007bls_002dR_007d-564">warning about unusable <samp><span class="file">ls-R</span></samp></a>: <a href="#ls_002dR">ls-R</a></li>
+<li><a href="#index-warning_002c-about-missing-_0040file_007btexmf_002ecnf_007d-488">warning, about missing <samp><span class="file">texmf.cnf</span></samp></a>: <a href="#Config-files">Config files</a></li>
+<li><a href="#index-warnings_002c-file-access-473">warnings, file access</a>: <a href="#Searching-overview">Searching overview</a></li>
+<li><a href="#index-warnings_002c-pointer-combinations-443">warnings, pointer combinations</a>: <a href="#Pointer-combination-warnings">Pointer combination warnings</a></li>
+<li><a href="#index-warnings_002c-suppressing-783">warnings, suppressing</a>: <a href="#Suppressing-warnings">Suppressing warnings</a></li>
+<li><a href="#index-wcstombs-426"><code>wcstombs</code></a>: <a href="#dlopen">dlopen</a></li>
+<li><a href="#index-WEB2C-738"><code>WEB2C</code></a>: <a href="#Supported-file-formats">Supported file formats</a></li>
+<li><a href="#index-Weber_002c-Olaf-25">Weber, Olaf</a>: <a href="#History">History</a></li>
+<li><a href="#index-WEBINPUTS-737"><code>WEBINPUTS</code></a>: <a href="#Supported-file-formats">Supported file formats</a></li>
+<li><a href="#index-whitespace_002c-in-fontmap-files-769">whitespace, in fontmap files</a>: <a href="#Fontmap">Fontmap</a></li>
+<li><a href="#index-whitespace_002c-not-ignored-on-continuation-lines-494">whitespace, not ignored on continuation lines</a>: <a href="#Config-files">Config files</a></li>
+<li><a href="#index-Windows-_0040TeX_007b_007d-implementations-307">Windows TeX implementations</a>: <a href="#Other-TeX-packages">Other TeX packages</a></li>
+<li><a href="#index-World-Wide-Web-CTAN-access-288">World Wide Web CTAN access</a>: <a href="#Electronic-distribution">Electronic distribution</a></li>
+<li><a href="#index-www_002etug_002eorg-278"><code>www.tug.org</code></a>: <a href="#unixtex_002eftp">unixtex.ftp</a></li>
+<li><a href="#index-X11-previewer-60">X11 previewer</a>: <a href="#Kpathsea-application-distributions">Kpathsea application distributions</a></li>
+<li><a href="#index-X11_002c-lacking-on-NeXT-54">X11, lacking on NeXT</a>: <a href="#Kpathsea-application-distributions">Kpathsea application distributions</a></li>
+<li><a href="#index-XCFLAGS-148"><code>XCFLAGS</code></a>: <a href="#Running-make">Running make</a></li>
+<li><a href="#index-XCPPFLAGS-145"><code>XCPPFLAGS</code></a>: <a href="#Running-make">Running make</a></li>
+<li><a href="#index-XDEFS-146"><code>XDEFS</code></a>: <a href="#Running-make">Running make</a></li>
+<li><a href="#index-XDvi-602"><code>XDvi</code></a>: <a href="#Specially_002drecognized-files">Specially-recognized files</a></li>
+<li><a href="#index-XDVIFONTS-741"><code>XDVIFONTS</code></a>: <a href="#Supported-file-formats">Supported file formats</a></li>
+<li><a href="#index-XDVIMAKEPK-247"><code>XDVIMAKEPK</code></a>: <a href="#mktex-script-names">mktex script names</a></li>
+<li><a href="#index-XDVISIZES-777"><code>XDVISIZES</code></a>: <a href="#Fallback-font">Fallback font</a></li>
+<li><a href="#index-XLDFLAGS-150"><code>XLDFLAGS</code></a>: <a href="#Running-make">Running make</a></li>
+<li><a href="#index-XLOADLIBES-152"><code>XLOADLIBES</code></a>: <a href="#Running-make">Running make</a></li>
+<li><a href="#index-XMAKEARGS-154"><code>XMAKEARGS</code></a>: <a href="#Running-make">Running make</a></li>
+<li><a href="#index-Xmu-_0040r_007blibrary-problems_007d-435"><code>Xmu </code><span class="roman">library problems</span></a>: <a href="#ShellWidgetClass">ShellWidgetClass</a></li>
+<li><a href="#index-XtStrings-421"><code>XtStrings</code></a>: <a href="#XtStrings">XtStrings</a></li>
+<li><a href="#index-zuhn_002c-david-22">zuhn, david</a>: <a href="#History">History</a></li>
+<li><a href="#index-g_t_0040_007b-_0040r_007bexpansion_007d-530"><code>{ </code><span class="roman">expansion</span></a>: <a href="#Brace-expansion">Brace expansion</a></li>
+<li><a href="#index-g_t_007e-_0040r_007bexpansion_007d-520"><code>~ </code><span class="roman">expansion</span></a>: <a href="#Tilde-expansion">Tilde expansion</a></li>
</ul></body></html>
diff --git a/Master/texmf/doc/kpathsea/kpathsea.pdf b/Master/texmf/doc/kpathsea/kpathsea.pdf
index 14fb80d6e12..1461ebc91ce 100644
--- a/Master/texmf/doc/kpathsea/kpathsea.pdf
+++ b/Master/texmf/doc/kpathsea/kpathsea.pdf
Binary files differ
diff --git a/Master/texmf/doc/web2c/web2c.html b/Master/texmf/doc/web2c/web2c.html
index 3d74a3aa9ae..db13d9fec9b 100644
--- a/Master/texmf/doc/web2c/web2c.html
+++ b/Master/texmf/doc/web2c/web2c.html
@@ -3,7 +3,7 @@
<title>Web2c: A TeX implementation</title>
<meta http-equiv="Content-Type" content="text/html">
<meta name="description" content="Web2c: A TeX implementation">
-<meta name="generator" content="makeinfo 4.12">
+<meta name="generator" content="makeinfo 4.13">
<link title="Top" rel="top" href="#Top">
<link href="http://www.gnu.org/software/texinfo/" rel="generator-home" title="Texinfo Homepage">
<!--
@@ -11,7 +11,7 @@ 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 Karl Berry & Olaf Weber.
+2004, 2005, 2007, 2008, 2009 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
@@ -88,8 +88,9 @@ except that this permission notice may be stated in a translation-->
<li><a href="#TCX-files">4.4.2 TCX files: Character translations</a>
<li><a href="#patgen-invocation">4.4.3 Patgen: Creating hyphenation patterns</a>
</li></ul>
-<li><a href="#IPC-and-TeX">4.5 IPC and TeX</a>
-<li><a href="#TeX-extensions">4.6 TeX extensions</a>
+<li><a href="#Shell-escapes">4.5 Shell escapes</a>
+<li><a href="#IPC-and-TeX">4.6 IPC and TeX</a>
+<li><a href="#TeX-extensions">4.7 TeX extensions</a>
</li></ul>
<li><a name="toc_Metafont" href="#Metafont">5 Metafont: Creating typeface families</a>
<ul>
@@ -104,11 +105,7 @@ except that this permission notice may be stated in a translation-->
<ul>
<li><a href="#mpost-invocation">6.1 <code>mpost</code> invocation</a>
<li><a href="#Initial-MetaPost">6.2 Initial MetaPost</a>
-<li><a href="#makempx-invocation">6.3 MakeMPX: Support MetaPost labels</a>
-<li><a href="#dvitomp-invocation">6.4 DVItoMP: DVI to MPX conversion</a>
-<li><a href="#dmp-invocation">6.5 DMP: Ditroff to MPX conversion</a>
-<li><a href="#mpto-invocation">6.6 MPto: Extract labels from MetaPost input</a>
-<li><a href="#newer-invocation">6.7 Newer: Compare file modification times</a>
+<li><a href="#dvitomp-invocation">6.3 DVItoMP: DVI to MPX conversion</a>
</li></ul>
<li><a name="toc_BibTeX" href="#BibTeX">7 BibTeX: Bibliographies</a>
<ul>
@@ -151,8 +148,8 @@ except that this permission notice may be stated in a translation-->
<div class="node">
-<p><hr>
<a name="Top"></a>
+<p><hr>
Next:&nbsp;<a rel="next" accesskey="n" href="#Introduction">Introduction</a>,
Up:&nbsp;<a rel="up" accesskey="u" href="#dir">(dir)</a>
@@ -162,8 +159,8 @@ Up:&nbsp;<a rel="up" accesskey="u" href="#dir">(dir)</a>
<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 7.5.7, released in
-July 2008.
+corresponds to Web2c version 2009, released in
+July 2009.
<ul class="menu">
<li><a accesskey="1" href="#Introduction">Introduction</a>: A brief introduction.
@@ -182,8 +179,8 @@ July 2008.
</ul>
<div class="node">
-<p><hr>
<a name="Introduction"></a>
+<p><hr>
Next:&nbsp;<a rel="next" accesskey="n" href="#Installation">Installation</a>,
Previous:&nbsp;<a rel="previous" accesskey="p" href="#Top">Top</a>,
Up:&nbsp;<a rel="up" accesskey="u" href="#Top">Top</a>
@@ -193,8 +190,8 @@ Up:&nbsp;<a rel="up" accesskey="u" href="#Top">Top</a>
<h2 class="chapter">1 Introduction</h2>
<p><a name="index-introduction-1"></a>
-This manual corresponds to version 7.5.7 of Web2c, released in
-July 2008.
+This manual corresponds to version 2009 of Web2c, released in
+July 2009.
<p><a name="index-Knuth_002c-Donald-E_002e-2"></a><a name="index-g_t_0040TeX_007b_007d_002c-Web2c-implementation-of-3"></a><a name="index-Hobby_002c-John-4"></a><a name="index-Breitenlohner_002c-Peter-5"></a><dfn>Web2c</dfn> is the name of a TeX implementation, originally for Unix,
but now also running under DOS, Amiga, and other operating systems. By
@@ -239,7 +236,7 @@ other people have contributed; their names are listed in the
<samp><span class="file">ChangeLog</span></samp> files.
<p><a name="index-acknowledgements-19"></a><a name="index-Martin_002c-Rick-20"></a><a name="index-Morris_002c-Bob-21"></a><a name="index-Stallman_002c-Richard-22"></a>Other acknowledgements: The University of Massachusetts at Boston
-(particularly Rick Martin and Bob Morris) has provided computers and ftp
+(particularly Rick Martin and Bob Morris) provided computers and ftp
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,
@@ -249,8 +246,8 @@ TeX would not exist in the first place without Donald E. Knuth.
<p><a name="index-reading_002c-additional-23"></a>Further reading: See <a href="#References">References</a>.
<div class="node">
-<p><hr>
<a name="Installation"></a>
+<p><hr>
Next:&nbsp;<a rel="next" accesskey="n" href="#Commonalities">Commonalities</a>,
Previous:&nbsp;<a rel="previous" accesskey="p" href="#Introduction">Introduction</a>,
Up:&nbsp;<a rel="up" accesskey="u" href="#Top">Top</a>
@@ -308,8 +305,8 @@ as described in the first section below.
</ul>
<div class="node">
-<p><hr>
<a name="configure-options"></a>
+<p><hr>
Next:&nbsp;<a rel="next" accesskey="n" href="#Compile_002dtime-options">Compile-time options</a>,
Up:&nbsp;<a rel="up" accesskey="u" href="#Installation">Installation</a>
@@ -349,9 +346,9 @@ enabled. See <a href="#Online-Metafont-graphics">Online Metafont graphics</a>.
</dl>
<div class="node">
-<p><hr>
<a name="Compile-time-options"></a>
<a name="Compile_002dtime-options"></a>
+<p><hr>
Next:&nbsp;<a rel="next" accesskey="n" href="#Additional-targets">Additional targets</a>,
Previous:&nbsp;<a rel="previous" accesskey="p" href="#configure-options">configure options</a>,
Up:&nbsp;<a rel="up" accesskey="u" href="#Installation">Installation</a>
@@ -385,8 +382,8 @@ otherwise.
</dl>
<div class="node">
-<p><hr>
<a name="Additional-targets"></a>
+<p><hr>
Next:&nbsp;<a rel="next" accesskey="n" href="#Triptrap">Triptrap</a>,
Previous:&nbsp;<a rel="previous" accesskey="p" href="#Compile_002dtime-options">Compile-time options</a>,
Up:&nbsp;<a rel="up" accesskey="u" href="#Installation">Installation</a>
@@ -424,8 +421,8 @@ Make or install the Metafont <samp><span class="file">.base</span></samp> files.
</dl>
<div class="node">
-<p><hr>
<a name="Triptrap"></a>
+<p><hr>
Next:&nbsp;<a rel="next" accesskey="n" href="#Runtime-options">Runtime options</a>,
Previous:&nbsp;<a rel="previous" accesskey="p" href="#Additional-targets">Additional targets</a>,
Up:&nbsp;<a rel="up" accesskey="u" href="#Installation">Installation</a>
@@ -471,8 +468,8 @@ run &lsquo;<samp><span class="samp">make check</span></samp>&rsquo;. You can co
file <samp><span class="file">tests/check.log</span></samp> if you like.
<div class="node">
-<p><hr>
<a name="Runtime-options"></a>
+<p><hr>
Previous:&nbsp;<a rel="previous" accesskey="p" href="#Triptrap">Triptrap</a>,
Up:&nbsp;<a rel="up" accesskey="u" href="#Installation">Installation</a>
@@ -517,8 +514,8 @@ the other hand, the Web2c BibTeX implementation does do dynamic
reallocation of some arrays.)
<div class="node">
-<p><hr>
<a name="Commonalities"></a>
+<p><hr>
Next:&nbsp;<a rel="next" accesskey="n" href="#TeX">TeX</a>,
Previous:&nbsp;<a rel="previous" accesskey="p" href="#Installation">Installation</a>,
Up:&nbsp;<a rel="up" accesskey="u" href="#Top">Top</a>
@@ -540,8 +537,8 @@ program, so we describe all those pieces together, here.
</ul>
<div class="node">
-<p><hr>
<a name="Option-conventions"></a>
+<p><hr>
Next:&nbsp;<a rel="next" accesskey="n" href="#Common-options">Common options</a>,
Up:&nbsp;<a rel="up" accesskey="u" href="#Commonalities">Commonalities</a>
@@ -582,8 +579,8 @@ option; and specifies the filename <samp><span class="file">-myfile-</span></sam
<pre class="example"> -foo --bar -verb -abc=baz -quux karl --quux xyz -- -myfile-
</pre>
<div class="node">
-<p><hr>
<a name="Common-options"></a>
+<p><hr>
Next:&nbsp;<a rel="next" accesskey="n" href="#Path-searching">Path searching</a>,
Previous:&nbsp;<a rel="previous" accesskey="p" href="#Option-conventions">Option conventions</a>,
Up:&nbsp;<a rel="up" accesskey="u" href="#Commonalities">Commonalities</a>
@@ -680,8 +677,8 @@ OEM code page rather than the ANSI one to display their messages.
</dl>
<div class="node">
-<p><hr>
<a name="Path-searching"></a>
+<p><hr>
Next:&nbsp;<a rel="next" accesskey="n" href="#Output-file-location">Output file location</a>,
Previous:&nbsp;<a rel="previous" accesskey="p" href="#Common-options">Common options</a>,
Up:&nbsp;<a rel="up" accesskey="u" href="#Commonalities">Commonalities</a>
@@ -707,8 +704,8 @@ aliases for many widely available PostScript fonts by their PostScript
names.
<div class="node">
-<p><hr>
<a name="Output-file-location"></a>
+<p><hr>
Next:&nbsp;<a rel="next" accesskey="n" href="#Three-programs">Three programs</a>,
Previous:&nbsp;<a rel="previous" accesskey="p" href="#Path-searching">Path searching</a>,
Up:&nbsp;<a rel="up" accesskey="u" href="#Commonalities">Commonalities</a>
@@ -737,8 +734,8 @@ BibTeX) make an exception: if the config file value
written to the directory specified.
<div class="node">
-<p><hr>
<a name="Three-programs"></a>
+<p><hr>
Previous:&nbsp;<a rel="previous" accesskey="p" href="#Output-file-location">Output file location</a>,
Up:&nbsp;<a rel="up" accesskey="u" href="#Commonalities">Commonalities</a>
@@ -761,8 +758,8 @@ control some array sizes and other features are described in
</ul>
<div class="node">
-<p><hr>
<a name="Initial-and-virgin"></a>
+<p><hr>
Next:&nbsp;<a rel="next" accesskey="n" href="#Memory-dumps">Memory dumps</a>,
Up:&nbsp;<a rel="up" accesskey="u" href="#Three-programs">Three programs</a>
@@ -793,8 +790,8 @@ because it must do lengthy initializations that are encapsulated in the
memory dump file.
<div class="node">
-<p><hr>
<a name="Memory-dumps"></a>
+<p><hr>
Next:&nbsp;<a rel="next" accesskey="n" href="#Editor-invocation">Editor invocation</a>,
Previous:&nbsp;<a rel="previous" accesskey="p" href="#Initial-and-virgin">Initial and virgin</a>,
Up:&nbsp;<a rel="up" accesskey="u" href="#Three-programs">Three programs</a>
@@ -816,8 +813,8 @@ code.
</ul>
<div class="node">
-<p><hr>
<a name="Creating-memory-dumps"></a>
+<p><hr>
Next:&nbsp;<a rel="next" accesskey="n" href="#Determining-the-memory-dump-to-use">Determining the memory dump to use</a>,
Up:&nbsp;<a rel="up" accesskey="u" href="#Memory-dumps">Memory dumps</a>
@@ -855,8 +852,8 @@ pointing to an old one, for example, you will probably run into
difficulties.
<div class="node">
-<p><hr>
<a name="Determining-the-memory-dump-to-use"></a>
+<p><hr>
Next:&nbsp;<a rel="next" accesskey="n" href="#Hardware-and-memory-dumps">Hardware and memory dumps</a>,
Previous:&nbsp;<a rel="previous" accesskey="p" href="#Creating-memory-dumps">Creating memory dumps</a>,
Up:&nbsp;<a rel="up" accesskey="u" href="#Memory-dumps">Memory dumps</a>
@@ -902,8 +899,8 @@ foo</span></samp>&rsquo;, <samp><span class="file">latex.fmt</span></samp> will
</ol>
<div class="node">
-<p><hr>
<a name="Hardware-and-memory-dumps"></a>
+<p><hr>
Previous:&nbsp;<a rel="previous" accesskey="p" href="#Determining-the-memory-dump-to-use">Determining the memory dump to use</a>,
Up:&nbsp;<a rel="up" accesskey="u" href="#Memory-dumps">Memory dumps</a>
@@ -967,8 +964,8 @@ Jr. (see <a href="#References">References</a>).
}
</pre>
<div class="node">
-<p><hr>
<a name="Editor-invocation"></a>
+<p><hr>
Next:&nbsp;<a rel="next" accesskey="n" href="#g_t_005cinput-filenames">\input filenames</a>,
Previous:&nbsp;<a rel="previous" accesskey="p" href="#Memory-dumps">Memory dumps</a>,
Up:&nbsp;<a rel="up" accesskey="u" href="#Three-programs">Three programs</a>
@@ -992,9 +989,9 @@ not specified, the default is <code>vi +%d %s</code>.
and &lsquo;<samp><span class="samp">%s</span></samp>&rsquo; is replaced by the name of the current input file.
<div class="node">
-<p><hr>
<a name="%5cinput-filenames"></a>
<a name="g_t_005cinput-filenames"></a>
+<p><hr>
Previous:&nbsp;<a rel="previous" accesskey="p" href="#Editor-invocation">Editor invocation</a>,
Up:&nbsp;<a rel="up" accesskey="u" href="#Three-programs">Three programs</a>
@@ -1069,8 +1066,8 @@ suggestions above.) The place where they are most likely to be useful
is when typing interactively.
<div class="node">
-<p><hr>
<a name="TeX"></a>
+<p><hr>
Next:&nbsp;<a rel="next" accesskey="n" href="#Metafont">Metafont</a>,
Previous:&nbsp;<a rel="previous" accesskey="p" href="#Commonalities">Commonalities</a>,
Up:&nbsp;<a rel="up" accesskey="u" href="#Top">Top</a>
@@ -1097,13 +1094,14 @@ otherwise, are available.
<li><a accesskey="2" href="#Initial-TeX">Initial TeX</a>: Making format files.
<li><a accesskey="3" href="#Formats">Formats</a>: Major TeX macro packages.
<li><a accesskey="4" href="#Languages-and-hyphenation">Languages and hyphenation</a>: TeX supports many human languages.
-<li><a accesskey="5" href="#IPC-and-TeX">IPC and TeX</a>: DVI output to a socket.
-<li><a accesskey="6" href="#TeX-extensions">TeX extensions</a>: Changes to the TeX language.
+<li><a accesskey="5" href="#Shell-escapes">Shell escapes</a>: DVI output to a socket.
+<li><a accesskey="6" href="#IPC-and-TeX">IPC and TeX</a>: DVI output to a socket.
+<li><a accesskey="7" href="#TeX-extensions">TeX extensions</a>: Changes to the TeX language.
</ul>
<div class="node">
-<p><hr>
<a name="tex-invocation"></a>
+<p><hr>
Next:&nbsp;<a rel="next" accesskey="n" href="#Initial-TeX">Initial TeX</a>,
Up:&nbsp;<a rel="up" accesskey="u" href="#TeX">TeX</a>
@@ -1200,8 +1198,8 @@ 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.
<br><dt>&lsquo;<samp><span class="samp">-mktex=</span><var>filetype</var></samp>&rsquo;<dt>&lsquo;<samp><span class="samp">-no-mktex=</span><var>filetype</var></samp>&rsquo;<dd><a name="index-g_t_002dmktex_003d_0040var_007bfiletype_007d-253"></a><a name="index-g_t_002dno_002dmktex_003d_0040var_007bfiletype_007d-254"></a>Turn on or off the &lsquo;<samp><span class="samp">mktex</span></samp>&rsquo; script associated with <var>filetype</var>.
-The only values that make sense for <var>filetype</var> are &lsquo;<samp><span class="samp">tex</span></samp>&rsquo; and
-&lsquo;<samp><span class="samp">tfm</span></samp>&rsquo;.
+For TeX proper, <var>filetype</var> can only be &lsquo;<samp><span class="samp">tex</span></samp>&rsquo; and
+&lsquo;<samp><span class="samp">tfm</span></samp>&rsquo;, but for pdfTeX and luaTeX, it can also be &lsquo;<samp><span class="samp">pk</span></samp>&rsquo;.
<br><dt>&lsquo;<samp><span class="samp">-mltex</span></samp>&rsquo;<dd><a name="index-g_t_002dmltex-255"></a><a name="index-ML_0040TeX_007b_007d_002c-enabling-256"></a><a name="index-program-names_002c-special-257"></a>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
@@ -1213,24 +1211,15 @@ regression testing, you may not want the DVI file to have this spurious
difference. This is also taken from the environment variable and
config file value &lsquo;<samp><span class="samp">output_comment</span></samp>&rsquo;.
- <br><dt>&lsquo;<samp><span class="samp">-shell-escape</span></samp>&rsquo;<dd><a name="index-g_t_002dshell_002descape-262"></a><dt>&lsquo;<samp><span class="samp">-no-shell-escape</span></samp>&rsquo;<dd><a name="index-g_t_002dno_002dshell_002descape-263"></a><a name="index-shell-commands-in-_0040TeX_007b_007d-264"></a><a name="index-Bourne-shell-commands-in-_0040TeX_007b_007d-265"></a><a name="index-shell_005fescape-_0040r_007benabling-in-_0040TeX_007b_007d_007d-266"></a><a name="index-g_t_005cimmediate_005cwrite18-267"></a><a name="index-g_t_005cwrite18-_0040r_007bshell-escape-extension_007d-268"></a><a name="index-system-_0040r_007bC-library-function_007d-269"></a><a name="index-security_002c-and-shell-escapes-270"></a>Enable (or disable) the &lsquo;<samp><span class="samp">\write18{</span><var>shell-command</var><span class="samp">}</span></samp>&rsquo;
-feature. This is also enabled if the environment variable or config
-file value &lsquo;<samp><span class="samp">shell_escape</span></samp>&rsquo; is set to &lsquo;<samp><span class="samp">t</span></samp>&rsquo; (but the
-&lsquo;<samp><span class="samp">-no-shell-escape</span></samp>&rsquo; command line option overrides this). (For
-backwards compatibility, &lsquo;<samp><span class="samp">y</span></samp>&rsquo; and &lsquo;<samp><span class="samp">1</span></samp>&rsquo; are accepted as
-synonyms of &lsquo;<samp><span class="samp">t</span></samp>&rsquo;). It is disabled by default to avoid security
-problems. When enabled, the <var>shell-command</var> string (which first
-undergoes the usual TeX expansions, just as in &lsquo;<samp><span class="samp">\special</span></samp>&rsquo;) is
-passed to the command shell (via the C library function
-&lsquo;<samp><span class="samp">system</span></samp>&rsquo;). The output of <var>shell-command</var> is not diverted
-anywhere, so it will not appear in the log file. The system call
-either happens at &lsquo;<samp><span class="samp">\output</span></samp>&rsquo; time or right away, according to the
-absence or presence of the &lsquo;<samp><span class="samp">\immediate</span></samp>&rsquo; prefix, as usual for
-<code>\write</code>. (If you as a TeX administrator wish to implement
-more stringent rules on what can be executed, you will need to modify
-<samp><span class="file">tex.ch</span></samp>.)
-
- <br><dt>&lsquo;<samp><span class="samp">-src-specials</span></samp>&rsquo;<dt>&lsquo;<samp><span class="samp">-src-specials=</span><var>string</var></samp>&rsquo;<dd><a name="index-generating-source-specials-271"></a>This option makes TeX output specific source information using
+ <br><dt>&lsquo;<samp><span class="samp">-shell-escape</span></samp>&rsquo;<dd><a name="index-g_t_002dshell_002descape-262"></a><dt>&lsquo;<samp><span class="samp">-no-shell-escape</span></samp>&rsquo;<dd><a name="index-g_t_002dno_002dshell_002descape-263"></a><dt>&lsquo;<samp><span class="samp">-shell-restricted</span></samp>&rsquo;<dd><a name="index-g_t_002dshell_002drestricted-264"></a>Enable, or disable, or enable with restrictions the
+<code>\write18{</code><var>shell-command</var><code>}</code> feature for external executing
+shell commands. See <a href="#Shell-escapes">Shell escapes</a>.
+
+ <br><dt>&lsquo;<samp><span class="samp">-enable-write18</span></samp>&rsquo;<dd><a name="index-g_t_002denable_002dwrite18-265"></a><dt>&lsquo;<samp><span class="samp">-disable-write18</span></samp>&rsquo;<dd><a name="index-g_t_002ddisable_002dwrite18-266"></a>Synonyms for <samp><span class="option">-shell-escape</span></samp> and <samp><span class="option">-no-shell-escape</span></samp>, for
+compatibility with MiKTeX. (MiKTeX also accepts both pairs of
+options.) See <a href="#Shell-escapes">Shell escapes</a>.
+
+ <br><dt>&lsquo;<samp><span class="samp">-src-specials</span></samp>&rsquo;<dt>&lsquo;<samp><span class="samp">-src-specials=</span><var>string</var></samp>&rsquo;<dd><a name="index-generating-source-specials-267"></a>This option makes TeX output specific source information using
&lsquo;<samp><span class="samp">\special</span></samp>&rsquo; commands in the DVI file. These &lsquo;<samp><span class="samp">\special</span></samp>&rsquo; track
the current file name and line number.
@@ -1265,8 +1254,8 @@ hard-coded to always use the &lsquo;<samp><span class="samp">\special</span></sa
</dl>
<div class="node">
-<p><hr>
<a name="Initial-TeX"></a>
+<p><hr>
Next:&nbsp;<a rel="next" accesskey="n" href="#Formats">Formats</a>,
Previous:&nbsp;<a rel="previous" accesskey="p" href="#tex-invocation">tex invocation</a>,
Up:&nbsp;<a rel="up" accesskey="u" href="#TeX">TeX</a>
@@ -1275,8 +1264,8 @@ Up:&nbsp;<a rel="up" accesskey="u" href="#TeX">TeX</a>
<h3 class="section">4.2 Initial TeX</h3>
-<p><a name="index-initial-_0040TeX_007b_007d-272"></a><a name="index-g_t_0040TeX_007b_007d_002c-initial-273"></a>
-<a name="index-g_t_002efmt-274"></a><a name="index-fmt-files-275"></a>The <dfn>initial</dfn> form of TeX is invoked by &lsquo;<samp><span class="samp">tex -ini</span></samp>&rsquo;. It
+<p><a name="index-initial-_0040TeX_007b_007d-268"></a><a name="index-g_t_0040TeX_007b_007d_002c-initial-269"></a>
+<a name="index-g_t_002efmt-270"></a><a name="index-fmt-files-271"></a>The <dfn>initial</dfn> form of TeX is invoked by &lsquo;<samp><span class="samp">tex -ini</span></samp>&rsquo;. It
does lengthy initializations avoided by the &ldquo;virgin&rdquo; (<code>vir</code>)
form, so as to be capable of dumping &lsquo;<samp><span class="samp">.fmt</span></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>. In past releases, a separate program
@@ -1285,7 +1274,7 @@ no longer the case.
<p>For a list of options and other information, see <a href="#tex-invocation">tex invocation</a>.
- <p><a name="index-plain_002efmt-276"></a><a name="index-tex_002efmt-277"></a><a name="index-format-files-278"></a>Unlike Metafont and MetaPost, many format files are commonly used with
+ <p><a name="index-plain_002efmt-272"></a><a name="index-tex_002efmt-273"></a><a name="index-format-files-274"></a>Unlike Metafont and MetaPost, many format files are commonly used with
TeX. The standard one implementing the features described in the
<cite>TeXbook</cite> is &lsquo;<samp><span class="samp">plain.fmt</span></samp>&rsquo;, also known as &lsquo;<samp><span class="samp">tex.fmt</span></samp>&rsquo;
(again, see <a href="#Memory-dumps">Memory dumps</a>). It is created by default during
@@ -1305,8 +1294,8 @@ formats: <tt>plain latex amstex texinfo eplain</tt>. See <a href="#Formats">For
more details on TeX formats.
<div class="node">
-<p><hr>
<a name="Formats"></a>
+<p><hr>
Next:&nbsp;<a rel="next" accesskey="n" href="#Languages-and-hyphenation">Languages and hyphenation</a>,
Previous:&nbsp;<a rel="previous" accesskey="p" href="#Initial-TeX">Initial TeX</a>,
Up:&nbsp;<a rel="up" accesskey="u" href="#TeX">TeX</a>
@@ -1315,7 +1304,7 @@ Up:&nbsp;<a rel="up" accesskey="u" href="#TeX">TeX</a>
<h3 class="section">4.3 Formats</h3>
-<p><a name="index-formats-for-_0040TeX_007b_007d-279"></a><a name="index-g_t_0040TeX_007b_007d_002c-format-packages-for-280"></a><a name="index-macro-packages_002c-major-_0040TeX_007b_007d-281"></a>
+<p><a name="index-formats-for-_0040TeX_007b_007d-275"></a><a name="index-g_t_0040TeX_007b_007d_002c-format-packages-for-276"></a><a name="index-macro-packages_002c-major-_0040TeX_007b_007d-277"></a>
TeX <dfn>formats</dfn> are large collections of macros, often dumped
into a <samp><span class="file">.fmt</span></samp> file (see <a href="#Memory-dumps">Memory dumps</a>) by <code>tex -ini</code>
(see <a href="#Initial-TeX">Initial TeX</a>). A number of formats are in reasonably
@@ -1332,7 +1321,7 @@ contains most of these formats (although perhaps not the absolute latest
version), among other things.
<dl>
-<dt><tt>latex</tt><dd><a name="index-g_t_0040LaTeX_007b_007d-282"></a>The most widely used format. The current release is named `LaTeX
+<dt><tt>latex</tt><dd><a name="index-g_t_0040LaTeX_007b_007d-278"></a>The most widely used format. The current release is named `LaTeX
2e'; new versions are released approximately every six months, with
patches issued as needed. The old release was called `LaTeX 2.09',
and is no longer maintained or supported. LaTeX attempts to provide
@@ -1346,35 +1335,35 @@ 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>.
- <br><dt><tt>amstex</tt><dd><a name="index-AMS_0040TeX_007b_007d-283"></a><a name="index-American-Mathematical-Society_002c-typesetting-system-284"></a><a name="index-Mathematical-Reviews-285"></a>The official typesetting system of the American Mathematical Society.
+ <br><dt><tt>amstex</tt><dd><a name="index-AMS_0040TeX_007b_007d-279"></a><a name="index-American-Mathematical-Society_002c-typesetting-system-280"></a><a name="index-Mathematical-Reviews-281"></a>The official typesetting system of the American Mathematical Society.
Like LaTeX, it encourages generic markup commands. The AMS also
provides many LaTeX package for authors who prefer LaTeX. Taken
together, they are used to produce nearly all AMS publications, e.g.,
<cite>Mathematical Reviews</cite>. The AMSTeX home page:
<a href="http://www.ams.org/tex">http://www.ams.org/tex</a>.
- <br><dt><tt>texinfo</tt><dd><a name="index-Texinfo-286"></a><a name="index-Info-format-287"></a><a name="index-Free-Software-Foundation-documentation-system-288"></a>The documentation system developed and maintained by the Free Software
+ <br><dt><tt>texinfo</tt><dd><a name="index-Texinfo-282"></a><a name="index-Info-format-283"></a><a name="index-Free-Software-Foundation-documentation-system-284"></a>The documentation system developed and maintained by the Free Software
Foundation for their software manuals. It can be automatically
converted into plain text, a machine-readable on-line format called
`info', HTML, etc. The Texinfo home page:
<a href="http://www.gnu.org/software/texinfo">http://www.gnu.org/software/texinfo</a>.
- <br><dt><tt>eplain</tt><dd><a name="index-Eplain-289"></a><a name="index-expanded-plain-format-290"></a>The &ldquo;expanded plain&rdquo; format provides various common features (e.g.,
+ <br><dt><tt>eplain</tt><dd><a name="index-Eplain-285"></a><a name="index-expanded-plain-format-286"></a>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
high-level formatting. The Eplain home page:
<a href="http://www.tug.org/eplain">http://www.tug.org/eplain</a>.
- <br><dt><tt>slitex</tt><dd><a name="index-Sli_0040TeX_007b_007d-291"></a><a name="index-slides_002c-producing-292"></a>An obsolete LaTeX 2.09 format for making slides. It is replaced by
+ <br><dt><tt>slitex</tt><dd><a name="index-Sli_0040TeX_007b_007d-287"></a><a name="index-slides_002c-producing-288"></a>An obsolete LaTeX 2.09 format for making slides. It is replaced by
the &lsquo;<samp><span class="samp">slides</span></samp>&rsquo; document class, along with the &lsquo;<samp><span class="samp">beamer</span></samp>&rsquo;,
&lsquo;<samp><span class="samp">texpower</span></samp>&rsquo;, and other packages.
</dl>
<div class="node">
-<p><hr>
<a name="Languages-and-hyphenation"></a>
-Next:&nbsp;<a rel="next" accesskey="n" href="#IPC-and-TeX">IPC and TeX</a>,
+<p><hr>
+Next:&nbsp;<a rel="next" accesskey="n" href="#Shell-escapes">Shell escapes</a>,
Previous:&nbsp;<a rel="previous" accesskey="p" href="#Formats">Formats</a>,
Up:&nbsp;<a rel="up" accesskey="u" href="#TeX">TeX</a>
@@ -1382,7 +1371,7 @@ Up:&nbsp;<a rel="up" accesskey="u" href="#TeX">TeX</a>
<h3 class="section">4.4 Languages and hyphenation</h3>
-<p><a name="index-language-support-in-_0040TeX_007b_007d-293"></a><a name="index-human-languages_002c-supported-in-_0040TeX_007b_007d-294"></a><a name="index-hyphenation-and-languages-295"></a>
+<p><a name="index-language-support-in-_0040TeX_007b_007d-289"></a><a name="index-human-languages_002c-supported-in-_0040TeX_007b_007d-290"></a><a name="index-hyphenation-and-languages-291"></a>
TeX supports most natural languages. See also <a href="#TeX-extensions">TeX extensions</a>.
<ul class="menu">
@@ -1392,8 +1381,8 @@ TeX supports most natural languages. See also <a href="#TeX-extensions">TeX ext
</ul>
<div class="node">
-<p><hr>
<a name="MLTeX"></a>
+<p><hr>
Next:&nbsp;<a rel="next" accesskey="n" href="#patgen-invocation">patgen invocation</a>,
Up:&nbsp;<a rel="up" accesskey="u" href="#Languages-and-hyphenation">Languages and hyphenation</a>
@@ -1401,8 +1390,8 @@ Up:&nbsp;<a rel="up" accesskey="u" href="#Languages-and-hyphenation">Languages a
<h4 class="subsection">4.4.1 MLTeX: Multi-lingual TeX</h4>
-<p><a name="index-mltex-296"></a><a name="index-Multi_002dlingual-_0040TeX_007b_007d-297"></a>
-<a name="index-Ferguson_002c-Michael-298"></a><a name="index-Raichle_002c-Bernd-299"></a><a name="index-accents_002c-hyphenating-words-with-300"></a><a name="index-glyph-substitutions-301"></a><a name="index-substitutions-of-font-glyphs-302"></a>Multi-lingual TeX (<code>mltex</code>) is an extension of TeX originally
+<p><a name="index-mltex-292"></a><a name="index-Multi_002dlingual-_0040TeX_007b_007d-293"></a>
+<a name="index-Ferguson_002c-Michael-294"></a><a name="index-Raichle_002c-Bernd-295"></a><a name="index-accents_002c-hyphenating-words-with-296"></a><a name="index-glyph-substitutions-297"></a><a name="index-substitutions-of-font-glyphs-298"></a>Multi-lingual TeX (<code>mltex</code>) is an extension of TeX originally
written by Michael Ferguson and now updated and maintained by Bernd
Raichle. It allows the use of non-existing glyphs in a font by
declaring glyph substitutions. These are restricted to substitutions of
@@ -1431,9 +1420,9 @@ Aside from these, MLTeX is completely compatible with standard TeX.
</ul>
<div class="node">
-<p><hr>
<a name="%5ccharsubdef"></a>
<a name="g_t_005ccharsubdef"></a>
+<p><hr>
Next:&nbsp;<a rel="next" accesskey="n" href="#g_t_005ctracingcharsubdef">\tracingcharsubdef</a>,
Up:&nbsp;<a rel="up" accesskey="u" href="#MLTeX">MLTeX</a>
@@ -1441,7 +1430,7 @@ Up:&nbsp;<a rel="up" accesskey="u" href="#MLTeX">MLTeX</a>
<h5 class="subsubsection">4.4.1.1 <code>\charsubdef</code>: Character substitutions</h5>
-<p><a name="index-g_t_005ccharsubdef-_0040r_007band-ML_0040TeX_007b_007d_007d-303"></a>
+<p><a name="index-g_t_005ccharsubdef-_0040r_007band-ML_0040TeX_007b_007d_007d-299"></a>
The most important primitive MLTeX adds is <code>\charsubdef</code>, used
in a way reminiscent of <code>\chardef</code>:
<pre class="example"> \charsubdef <var>composite</var> [=] <var>accent</var> <var>base</var>
@@ -1458,7 +1447,7 @@ primitive, will be mapped to a font glyph or to an <code>\accent</code> glyph
construction.
<p>For example, if you assume glyph code 138
-<a name="index-e_002dcircumflex-304"></a>(decimal) for an e-circumflex
+<a name="index-e_002dcircumflex-300"></a>(decimal) for an e-circumflex
and you are using the Computer Modern fonts, which have the circumflex
accent in position 18 and lowercase `e' in the usual ASCII position 101
decimal, you would use <code>\charsubdef</code> as follows:
@@ -1476,7 +1465,7 @@ characters.
as a pair of zeros. For example:
<pre class="example"> \charsubdef '321 = 0 0 % disable N tilde
</pre>
- <p><a name="index-N-tilde-305"></a>(Octal <tt>'321</tt> is the ISO Latin-1 value for the Spanish N tilde.)
+ <p><a name="index-N-tilde-301"></a>(Octal <tt>'321</tt> is the ISO Latin-1 value for the Spanish N tilde.)
<p><code>\charsubdef</code> commands should only be given once. Although in
principle you can use <code>\charsubdef</code> at any time, the result is
@@ -1490,9 +1479,9 @@ construction at <code>\shipout</code>-time. In summary, the substitution is
accessed often, so changing it is not desirable, nor generally useful.)
<div class="node">
-<p><hr>
<a name="%5ctracingcharsubdef"></a>
<a name="g_t_005ctracingcharsubdef"></a>
+<p><hr>
Previous:&nbsp;<a rel="previous" accesskey="p" href="#g_t_005ccharsubdef">\charsubdef</a>,
Up:&nbsp;<a rel="up" accesskey="u" href="#MLTeX">MLTeX</a>
@@ -1500,18 +1489,18 @@ Up:&nbsp;<a rel="up" accesskey="u" href="#MLTeX">MLTeX</a>
<h5 class="subsubsection">4.4.1.2 <code>\tracingcharsubdef</code>: Substitution diagnostics</h5>
-<p><a name="index-g_t_005ctracingcharsubdef-_0040r_007band-ML_0040TeX_007b_007d_007d-306"></a><a name="index-redefined-character-substitutions-307"></a>To help diagnose problems with &lsquo;<samp><span class="samp">\charsubdef</span></samp>&rsquo;, MLTeX provides a
+<p><a name="index-g_t_005ctracingcharsubdef-_0040r_007band-ML_0040TeX_007b_007d_007d-302"></a><a name="index-redefined-character-substitutions-303"></a>To help diagnose problems with &lsquo;<samp><span class="samp">\charsubdef</span></samp>&rsquo;, MLTeX provides a
new primitive parameter, <code>\tracingcharsubdef</code>. If positive, every
use of <code>\charsubdef</code> will be reported. This can help track down
when a character is redefined.
- <p><a name="index-g_t_005ctracinglostchars-_0040r_007band-ML_0040TeX_007b_007d_007d-308"></a>In addition, if the TeX parameter <code>\tracinglostchars</code> is 100 or
+ <p><a name="index-g_t_005ctracinglostchars-_0040r_007band-ML_0040TeX_007b_007d_007d-304"></a>In addition, if the TeX parameter <code>\tracinglostchars</code> is 100 or
more, the character substitutions actually performed at
<code>\shipout</code>-time will be recorded.
<div class="node">
-<p><hr>
<a name="TCX-files"></a>
+<p><hr>
Previous:&nbsp;<a rel="previous" accesskey="p" href="#patgen-invocation">patgen invocation</a>,
Up:&nbsp;<a rel="up" accesskey="u" href="#Languages-and-hyphenation">Languages and hyphenation</a>
@@ -1519,8 +1508,8 @@ Up:&nbsp;<a rel="up" accesskey="u" href="#Languages-and-hyphenation">Languages a
<h4 class="subsection">4.4.2 TCX files: Character translations</h4>
-<p><a name="index-TCX-_0040r_007bcharacter-translation-files_007d-309"></a><a name="index-g_t_002etcx-_0040r_007bcharacter-translation-files_007d-310"></a><a name="index-character-translation-files-311"></a>
-<a name="index-international-characters-312"></a><a name="index-g_t8_002dbit-characters-313"></a><a name="index-accented-character-314"></a>TCX (TeX character translation) files help TeX support direct
+<p><a name="index-TCX-_0040r_007bcharacter-translation-files_007d-305"></a><a name="index-g_t_002etcx-_0040r_007bcharacter-translation-files_007d-306"></a><a name="index-character-translation-files-307"></a>
+<a name="index-international-characters-308"></a><a name="index-g_t8_002dbit-characters-309"></a><a name="index-accented-character-310"></a>TCX (TeX character translation) files help TeX support direct
input of 8-bit international characters if fonts containing those
characters are being used. Specifically, they map an input (keyboard)
character code to the internal TeX character code (a superset of
@@ -1551,7 +1540,7 @@ construction made out of two separate character glyphs. TCX files
involve no new primitives; it is not possible to specify
that an input (keyboard) character maps to more than one character.
- <p><a name="index-WEB2C_0040r_007b_002c-search-path-for-TCX-files_007d-315"></a>Information on specifying TCX files:
+ <p><a name="index-WEB2C_0040r_007b_002c-search-path-for-TCX-files_007d-311"></a>Information on specifying TCX files:
<ul>
<li>The best way to specify a TCX file is to list it explicitly in the
@@ -1566,7 +1555,7 @@ with the command-line option &lsquo;<samp><span class="samp">-translate-file=</s
<li>Initial TeX (see <a href="#Initial-TeX">Initial TeX</a>) ignores TCX files.
</ul>
- <p><a name="index-il1_002dt1_002etcx-316"></a><a name="index-il2_002dt1_002etcx-317"></a><a name="index-empty_002etcx-318"></a><a name="index-Cork-encoding-and-ISO-input-319"></a><a name="index-T1-encoding-and-ISO-input-320"></a>The Web2c distribution comes with a number of TCX files. Two
+ <p><a name="index-il1_002dt1_002etcx-312"></a><a name="index-il2_002dt1_002etcx-313"></a><a name="index-empty_002etcx-314"></a><a name="index-Cork-encoding-and-ISO-input-315"></a><a name="index-T1-encoding-and-ISO-input-316"></a>The Web2c distribution comes with a number of TCX files. Two
important ones are <samp><span class="file">il1-t1.tcx</span></samp> and <samp><span class="file">il2-t1.tcx</span></samp>, which
support ISO Latin 1 and ISO Latin 2, respectively, with Cork-encoded
fonts (a.k.a. the LaTeX T1 encoding). TCX files for Czech,
@@ -1584,20 +1573,20 @@ Thus:
latex --translate-file=empty.tcx somefile8.tex
&rArr; terminal etc. output with ^^ notation
</pre>
- <p><a name="index-syntax-of-TCX-files-321"></a>Syntax of TCX files:
+ <p><a name="index-syntax-of-TCX-files-317"></a>Syntax of TCX files:
<ol type=1 start=1>
-<li><a name="index-blank-lines_002c-in-TCX-files-322"></a>Line-oriented. Blank lines are ignored.
+<li><a name="index-blank-lines_002c-in-TCX-files-318"></a>Line-oriented. Blank lines are ignored.
- <li><a name="index-whitespace_002c-in-TCX-files-323"></a>Whitespace is ignored except as a separator.
+ <li><a name="index-whitespace_002c-in-TCX-files-319"></a>Whitespace is ignored except as a separator.
- <li><a name="index-comments_002c-in-TCX-files-324"></a>Comments start with &lsquo;<samp><span class="samp">%</span></samp>&rsquo; and continue to the end of the line.
+ <li><a name="index-comments_002c-in-TCX-files-320"></a>Comments start with &lsquo;<samp><span class="samp">%</span></samp>&rsquo; and continue to the end of the line.
<li>Otherwise, a line consists of one or two character codes, optionally
followed by 0 or 1. The last number indicates whether <var>dest</var> is
considered printable.
<pre class="example"> <var>src</var> [<var>dest</var> [<var>prnt</var>]]
</pre>
- <li><a name="index-character-codes_002c-in-TCX-files-325"></a><a name="index-octal-character-codes_002c-in-TCX-files-326"></a><a name="index-hex-character-codes_002c-in-TCX-files-327"></a><a name="index-decimal-character-codes_002c-in-TCX-files-328"></a>Each character code may be specified in octal with a leading &lsquo;<samp><span class="samp">0</span></samp>&rsquo;,
+ <li><a name="index-character-codes_002c-in-TCX-files-321"></a><a name="index-octal-character-codes_002c-in-TCX-files-322"></a><a name="index-hex-character-codes_002c-in-TCX-files-323"></a><a name="index-decimal-character-codes_002c-in-TCX-files-324"></a>Each character code may be specified in octal with a leading &lsquo;<samp><span class="samp">0</span></samp>&rsquo;,
hexadecimal with a leading &lsquo;<samp><span class="samp">0x</span></samp>&rsquo;, or decimal otherwise. Values must
be between 0 and 255, inclusive (decimal).
@@ -1608,7 +1597,7 @@ be between 0 and 255, inclusive (decimal).
definition that counts.
</ol>
- <p><a name="index-printable-characters_002c-specifying-329"></a><a name="index-g_t_005e_005e-_0040r_007bnotation_002c-avoiding_007d-330"></a>Finally, here's what happens: when TeX sees an input character with
+ <p><a name="index-printable-characters_002c-specifying-325"></a><a name="index-g_t_005e_005e-_0040r_007bnotation_002c-avoiding_007d-326"></a>Finally, here's what happens: when TeX sees an input character with
code <var>src</var>, it 1) changes <var>src</var> to <var>dest</var>; and 2) makes the
<var>dest</var> code &ldquo;printable&rdquo;, i.e., printed as-is in diagnostics and the
log file rather than in &lsquo;<samp><span class="samp">^^</span></samp>&rsquo; notation.
@@ -1622,10 +1611,10 @@ make the following characters printable: <code>^^I</code> (TAB), <code>^^J</code
(line feed), <code>^^M</code> (carriage return), and <code>^^?</code> (delete),
since TeX uses them in various ways.
- <p><a name="index-font-character-code_002c-translating-331"></a><a name="index-keyboard-character-code_002c-translating-332"></a>Thus, the idea is to specify the input (keyboard) character code for
+ <p><a name="index-font-character-code_002c-translating-327"></a><a name="index-keyboard-character-code_002c-translating-328"></a>Thus, the idea is to specify the input (keyboard) character code for
<var>src</var>, and the output (font) character code for <var>dest</var>.
- <p><a name="index-interaction-between-TCX-files-and-_0040samp_007b_002d8bit_007d_002e-333"></a>By default, only the printable ASCII characters are considered printable
+ <p><a name="index-interaction-between-TCX-files-and-_0040samp_007b_002d8bit_007d_002e-329"></a>By default, only the printable ASCII characters are considered printable
by TeX. If you specify the &lsquo;<samp><span class="samp">-8bit</span></samp>&rsquo; option, all characters are
considered printable by default. If you specify both the &lsquo;<samp><span class="samp">-8bit</span></samp>&rsquo;
option and a TCX file, then the TCX can set specific characters to be
@@ -1643,8 +1632,8 @@ characters become printable by default.
the dump is ignored and the data from the file used instead.
<div class="node">
-<p><hr>
<a name="patgen-invocation"></a>
+<p><hr>
Next:&nbsp;<a rel="next" accesskey="n" href="#TCX-files">TCX files</a>,
Previous:&nbsp;<a rel="previous" accesskey="p" href="#MLTeX">MLTeX</a>,
Up:&nbsp;<a rel="up" accesskey="u" href="#Languages-and-hyphenation">Languages and hyphenation</a>
@@ -1653,7 +1642,7 @@ Up:&nbsp;<a rel="up" accesskey="u" href="#Languages-and-hyphenation">Languages a
<h4 class="subsection">4.4.3 Patgen: Creating hyphenation patterns</h4>
-<p><a name="index-patgen-334"></a><a name="index-hyphenation-patterns_002c-creating-335"></a><a name="index-languages_002c-hyphenation-rules-for-336"></a>
+<p><a name="index-patgen-330"></a><a name="index-hyphenation-patterns_002c-creating-331"></a><a name="index-languages_002c-hyphenation-rules-for-332"></a>
Patgen creates hyphenation patterns from dictionary files for use with
TeX. Synopsis:
@@ -1685,69 +1674,153 @@ Frank Liang (see <a href="#References">References</a>), and also the <samp><span
<p>The only options are &lsquo;<samp><span class="samp">-help</span></samp>&rsquo; and &lsquo;<samp><span class="samp">-version</span></samp>&rsquo; (see <a href="#Common-options">Common options</a>).
<div class="node">
+<a name="Shell-escapes"></a>
<p><hr>
+Next:&nbsp;<a rel="next" accesskey="n" href="#IPC-and-TeX">IPC and TeX</a>,
+Previous:&nbsp;<a rel="previous" accesskey="p" href="#Languages-and-hyphenation">Languages and hyphenation</a>,
+Up:&nbsp;<a rel="up" accesskey="u" href="#TeX">TeX</a>
+
+</div>
+
+<h3 class="section">4.5 Shell escapes</h3>
+
+<p><a name="index-shell-commands-in-_0040TeX_007b_007d-333"></a><a name="index-security_002c-and-shell-escapes-334"></a><a name="index-restricted-shell-escapes-335"></a><a name="index-system-command-336"></a><a name="index-shell_005fescape-_0040r_007benabling-in-_0040TeX_007b_007d_007d-337"></a><a name="index-g_t_005cimmediate_005cwrite18-338"></a><a name="index-g_t_005cwrite18-_0040r_007bshell-escape-extension_007d-339"></a><a name="index-system-_0040r_007bC-library-function_007d-340"></a>
+TeX can execute <dfn>shell escapes</dfn>, that is, arbitrary shell
+commands. Although tremendously useful, this also has obvious
+security implications. Therefore, as of TeX Live 2009, a
+<dfn>restricted</dfn> mode for shell escapes is the default mode of
+operation, which allows executing only certain commands, as specified
+in the <samp><span class="file">texmf.cnf</span></samp> configuration file.
+
+ <ul>
+<li>Unrestricted shell escapes are allowed if the option
+<samp><span class="option">--shell-escape</span></samp> is specified, or if the environment variable
+or config file value <code>shell_escape</code> is set to &lsquo;<samp><span class="samp">t</span></samp>&rsquo; or
+&lsquo;<samp><span class="samp">y</span></samp>&rsquo; and &lsquo;<samp><span class="samp">1</span></samp>&rsquo;.
+
+ <li>Restricted shell escapes are allowed if <code>shell_escape</code> is set to
+&lsquo;<samp><span class="samp">p</span></samp>&rsquo;. This is the default.
+
+ <li>Shell escapes are completely disabled if <samp><span class="option">--no-shell-escape</span></samp> is
+specified, or if <code>shell_escape</code> is set to anything else.
+</ul>
+
+ <p>When enabled, the TeX construct to execute a system command is
+<code>\write18{</code><var>shell-command</var><code>}</code>; for example:
+
+<pre class="example"> \write18{echo "hello, world"}
+</pre>
+ <p><a name="index-g_t_005coutput-_0040r_007broutine_002c-and-_0040code_007b_005cwrite_007d_007d-341"></a>From TeX's point of view, this is a normal <code>\write</code> command,
+and is therefore subject to the usual TeX expansions. Also, the
+system call either happens during the &lsquo;<samp><span class="samp">\output</span></samp>&rsquo; routine or right
+away, according to the absence or presence of the <code>\immediate</code>
+prefix, as usual for <code>\write</code>.
+
+ <p><a name="index-exit-status_002c-of-shell-escape-342"></a>The <var>shell-command</var> string is passed to the command shell (via the
+C library function <code>system</code>). The output of <var>shell-command</var>
+is not diverted anywhere, so it will not appear in the log file, or
+anywhere but the terminal output. The exit status of the system call
+is also not available to TeX.
+
+ <p>In unrestricted mode, the argument is simply passed straight to
+<code>system</code> unaltered.
+
+ <p>In restricted mode, ASCII double quote characters (<tt>"</tt>) should
+always be used in the argument to <code>\write18</code> where quoting of
+arguments is needed, as in the example above. This is to achieve some
+measure of system independence. On Unix systems, these are replaced
+with single quote (<tt>'</tt>) characters to avoid insecure further
+expansion. Care is also taken on Windows to avoid additional
+expansions (from, e.g., <tt>`...`</tt>). Mismatched quotation marks
+in the command string result in a diagnostic message in the log file;
+no execution is performed.
+
+ <p><a name="index-shell_005fescape_005fcommands-343"></a>After quotation processing, if the first word (delimited by a space or
+tab) of the command is in the list specified by the
+<code>shell_escape_commands</code> configuration value, the command is
+executed. Otherwise it is not. In any case, a message is written to
+the log file.
+
+ <p>The <code>shell_escape_commands</code> value is a comma-separated list of
+words. Whitespace is significant, and typically should not be
+present. The default definition looks like this, but with more
+commands included:
+
+<pre class="example"> shell_escape_commands = bibtex,dvips,epstopdf,...,tex
+</pre>
+ <p><a name="index-pipes_002c-reading-and-writing-344"></a><a name="index-g_t_005copenin_0040r_007b_002c-and-pipes_007d-345"></a><a name="index-g_t_005cinput_0040r_007b_002c-and-pipes_007d-346"></a><a name="index-g_t_005copenout_0040r_007b_002c-and-pipes_007d-347"></a><a name="index-g_t_005cpdfshellescape-348"></a>pdfTeX and luaTeX support reading (via <code>\input</code> and
+<code>\openin</code>) and writing (via <code>\openout</code>) from pipes if the
+first character is &lsquo;<samp><span class="samp">|</span></samp>&rsquo;. The following command is then treated
+exactly the same as the argument to <code>\write18</code>. In these
+engines, the primitive variable <code>\pdfshellescape</code> is set to 0 if
+shell escapes are disabled, 1 if they are enabled, and 2 if they are
+enabled with restrictions.
+
+ <p><a name="index-web-environments_002c-and-security-349"></a>The purpose of this feature is to make it possible for TeX
+documents to perform useful external actions in the common case of an
+individual user running a known document on his or her own machine.
+In such environments as CGI scripts or wikis where the input has to be
+considered untrustworthy, shell escapes should be completely disabled.
+
+<div class="node">
<a name="IPC-and-TeX"></a>
+<p><hr>
Next:&nbsp;<a rel="next" accesskey="n" href="#TeX-extensions">TeX extensions</a>,
-Previous:&nbsp;<a rel="previous" accesskey="p" href="#Languages-and-hyphenation">Languages and hyphenation</a>,
+Previous:&nbsp;<a rel="previous" accesskey="p" href="#Shell-escapes">Shell escapes</a>,
Up:&nbsp;<a rel="up" accesskey="u" href="#TeX">TeX</a>
</div>
-<h3 class="section">4.5 IPC and TeX</h3>
+<h3 class="section">4.6 IPC and TeX</h3>
-<p><a name="index-IPC-337"></a><a name="index-sockets-338"></a>(Sorry, but I'm not going to write this unless someone actually uses
-this feature. Let me know.)
+<p><a name="index-IPC-350"></a><a name="index-sockets-351"></a>(If anyone uses this feature and needs documentation, write
+<a href="mailto:tex-k@tug.org">tex-k@tug.org</a>.)
<p>This functionality is available only if the &lsquo;<samp><span class="samp">--enable-ipc</span></samp>&rsquo; option
was specified to <code>configure</code> during installation of Web2c
(see <a href="#Installation">Installation</a>).
- <p><a name="index-IPC_005fDEBUG-339"></a>If you define <code>IPC_DEBUG</code> before compilation (e.g., with &lsquo;<samp><span class="samp">make
+ <p><a name="index-IPC_005fDEBUG-352"></a>If you define <code>IPC_DEBUG</code> before compilation (e.g., with &lsquo;<samp><span class="samp">make
XCFLAGS=-DIPC_DEBUG</span></samp>&rsquo;), TeX will print messages to standard error
about its socket operations. This may be helpful if you are, well,
debugging.
<div class="node">
-<p><hr>
<a name="TeX-extensions"></a>
+<p><hr>
Previous:&nbsp;<a rel="previous" accesskey="p" href="#IPC-and-TeX">IPC and TeX</a>,
Up:&nbsp;<a rel="up" accesskey="u" href="#TeX">TeX</a>
</div>
-<h3 class="section">4.6 TeX extensions</h3>
+<h3 class="section">4.7 TeX extensions</h3>
-<p><a name="index-extensions-to-_0040TeX_007b_007d-340"></a><a name="index-g_t_0040TeX_007b_007d_002c-extensions-to-341"></a>
+<p><a name="index-extensions-to-_0040TeX_007b_007d-353"></a><a name="index-g_t_0040TeX_007b_007d_002c-extensions-to-354"></a>
The base TeX program has been extended in many ways. Here's a
-partial list. Please send information on extensions not listed here to
-the address in <a href="kpathsea.html#Reporting-bugs">Reporting bugs</a>.
+partial list.
<dl>
-<dt>e-TeX<dd><a name="index-e_002d_0040TeX_007b_007d-342"></a><a name="index-primitives_002c-new-343"></a>Adds many new primitives, including right-to-left typesetting.
-Available from <a href="http://www.vms.rhbnc.ac.uk/e-TeX/">http://www.vms.rhbnc.ac.uk/e-TeX/</a> and
-<samp><var>CTAN:</var><span class="file">/systems/e-tex</span></samp>.
-
- <br><dt>Omega<dd><a name="index-Omega-344"></a><a name="index-Unicode-345"></a>Adds Unicode support, right-to-left typesetting, and more. Available
-from <a href="http://www.ens.fr/omega">http://www.ens.fr/omega</a> and <samp><var>CTAN:</var><span class="file">/systems/omega</span></samp>.
-
- <br><dt>pdfTeX<dd><a name="index-pdf_0040TeX_007b_007d-346"></a><a name="index-PDF-347"></a>A variant of TeX that produces PDF instead of DVI files. It also
-includes primitives for hypertext and micro-typography. Available from
-<samp><var>CTAN:</var><span class="file">/systems/pdftex</span></samp>.
-
- <br><dt>&lsquo;<samp><span class="samp">TeX--XeT</span></samp>&rsquo;<dd><a name="index-TeX_002d_002dXeT-348"></a><a name="index-Arabic-typesetting-349"></a><a name="index-right_002dto_002dleft-typesetting-350"></a>Adds primitives and DVI opcodes for right-to-left typesetting (as used
-in Arabic, for example). An old version for TeX 3.1415 is available
-from <samp><var>CTAN:</var><span class="file">/systems/knuth/tex--xet</span></samp>. A newer version is
-included in e-TeX.
-
- <br><dt>File-handling TeX<dd><a name="index-File_002dhandling-_0040TeX_007b_007d-351"></a><a name="index-DVI-files_002c-creating-multiple-352"></a><a name="index-multiple-DVI-files_002c-creating-353"></a>Adds primitives for creating multiple DVI files in a single run; and
-appending to output files as well as overwriting. Web2c implementation
-available in the distribution file
-<samp><span class="file">web2c/contrib/file-handling-tex</span></samp>.
-</dl>
+<dt>e-TeX<dd><a name="index-e_002d_0040TeX_007b_007d-355"></a><a name="index-primitives_002c-new-356"></a>Adds many new primitives, including right-to-left typesetting and more
+registers. Now frozen.
+
+ <br><dt>Omega<dt>Aleph<dd><a name="index-Omega-357"></a><a name="index-Unicode-358"></a>These add 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. Neither is actively maintained.
+
+ <br><dt>pdfTeX<dd><a name="index-pdf_0040TeX_007b_007d-359"></a><a name="index-PDF-360"></a><a name="index-micro_002dtypography-361"></a><a name="index-hypertext-362"></a>Can produce PDF as well as DVI files. It also incorporates the
+e-TeX extensions, new primitives for hypertext and
+micro-typography, reading/writing from pipes, and much more. Home
+page: <a href="http://pdftex.org">http://pdftex.org</a>.
+
+ <br><dt>luaTeX<dd><a name="index-lua_0040TeX_007b_007d-363"></a><a name="index-Lua-364"></a>Based on pdfTeX, this also embeds the Lua programming language
+(<a href="http://lua.org">http://lua.org</a>) and opens up the TeX typesetting engine to
+control from Lua. Home page: <a href="http://luatex.org">http://luatex.org</a>.
+
+ </dl>
<div class="node">
-<p><hr>
<a name="Metafont"></a>
+<p><hr>
Next:&nbsp;<a rel="next" accesskey="n" href="#MetaPost">MetaPost</a>,
Previous:&nbsp;<a rel="previous" accesskey="p" href="#TeX">TeX</a>,
Up:&nbsp;<a rel="up" accesskey="u" href="#Top">Top</a>
@@ -1756,7 +1829,7 @@ Up:&nbsp;<a rel="up" accesskey="u" href="#Top">Top</a>
<h2 class="chapter">5 Metafont: Creating typeface families</h2>
-<p><a name="index-Metafont-354"></a><a name="index-typeface-families-355"></a><a name="index-geometric-designs-356"></a><a name="index-shapes-357"></a><a name="index-font-design-358"></a>
+<p><a name="index-Metafont-365"></a><a name="index-typeface-families-366"></a><a name="index-geometric-designs-367"></a><a name="index-shapes-368"></a><a name="index-font-design-369"></a>
Metafont is a system for producing shapes; it was designed for producing
complete typeface families, but it can also produce geometric designs,
dingbats, etc. And it has considerable mathematical and
@@ -1781,8 +1854,8 @@ description of the Metafont language, see <cite>The METAFONTbook</cite>
</ul>
<div class="node">
-<p><hr>
<a name="mf-invocation"></a>
+<p><hr>
Next:&nbsp;<a rel="next" accesskey="n" href="#Initial-Metafont">Initial Metafont</a>,
Up:&nbsp;<a rel="up" accesskey="u" href="#Metafont">Metafont</a>
@@ -1790,7 +1863,7 @@ Up:&nbsp;<a rel="up" accesskey="u" href="#Metafont">Metafont</a>
<h3 class="section">5.1 <code>mf</code> invocation</h3>
-<p><a name="index-mf-359"></a><a name="index-Metafont-invocation-360"></a>
+<p><a name="index-mf-370"></a><a name="index-Metafont-invocation-371"></a>
Metafont (usually invoked as <code>mf</code>) reads character definitions
specified in the Metafont programming language, and outputs the
corresponding font. This section merely describes the options available
@@ -1810,7 +1883,7 @@ language, see <cite>The Metafontbook</cite> (see <a href="#References">Reference
</pre>
<p class="noindent">(The single quotes avoid unwanted interpretation by the shell.)
- <p><a name="index-g_t_002emf-361"></a><a name="index-Metafont-input-files-362"></a><a name="index-EC-fonts-363"></a><a name="index-mktexmf_0040r_007b_002c-disabling_007d-364"></a>Metafont searches the usual places for the main input file <var>mfname</var>
+ <p><a name="index-g_t_002emf-372"></a><a name="index-Metafont-input-files-373"></a><a name="index-EC-fonts-374"></a><a name="index-mktexmf_0040r_007b_002c-disabling_007d-375"></a>Metafont searches the usual places for the main input file <var>mfname</var>
(see <a href="kpathsea.html#Supported-file-formats">Supported file formats</a>), extending
<var>mfname</var> with <samp><span class="file">.mf</span></samp> if necessary. To see all the relevant
paths, set the environment variable <code>KPATHSEA_DEBUG</code> to &lsquo;<samp><span class="samp">-1</span></samp>&rsquo;
@@ -1820,7 +1893,7 @@ files you input. You can disable this at configure-time or runtime
(see <a href="kpathsea.html#mktex-configuration">mktex configuration</a>). This is mostly
for the sake of the EC fonts, which can be generated at any size.
- <p><a name="index-g_t_002e_0040var_007bnnn_007dgf-_0040r_007bgeneric-fonts_007d-365"></a><a name="index-mfput-366"></a><a name="index-GF-output-367"></a><a name="index-GF-files_002c-output-by-Metafont-368"></a><a name="index-PK-files_002c-not-output-by-Metafont-369"></a>Metafont writes the main GF output to the file
+ <p><a name="index-g_t_002e_0040var_007bnnn_007dgf-_0040r_007bgeneric-fonts_007d-376"></a><a name="index-mfput-377"></a><a name="index-GF-output-378"></a><a name="index-GF-files_002c-output-by-Metafont-379"></a><a name="index-PK-files_002c-not-output-by-Metafont-380"></a>Metafont writes the main GF output to the file
<samp><var>basemfname</var><span class="file">.</span><var>nnn</var><span class="file">gf</span></samp>, where <var>nnn</var> is the font
resolution in pixels per inch, and <var>basemfname</var> is the basename of
<var>mfname</var>, or &lsquo;<samp><span class="samp">mfput</span></samp>&rsquo; if no input file was specified. A GF file
@@ -1829,12 +1902,12 @@ converted immediately to PK files with GFtoPK (see <a href="#gftopk-invocation">
more compact. (Metafont output in GF format rather than PK for only
historical reasons.)
- <p><a name="index-g_t_002etfm-_0040r_007boutput_007d-370"></a><a name="index-TFM-files_002c-output-by-Metafont-371"></a>Metafont also usually writes a metric file in TFM format to
+ <p><a name="index-g_t_002etfm-_0040r_007boutput_007d-381"></a><a name="index-TFM-files_002c-output-by-Metafont-382"></a>Metafont also usually writes a metric file in TFM format to
<samp><var>basemfname</var><span class="file">.tfm</span></samp>. A TFM file contains character dimensions,
kerns, and ligatures, and spacing parameters. TeX reads only this
<tt>.tfm</tt> file, not the GF file.
- <p><a name="index-mode-needed-to-run-Metafont-372"></a><a name="index-proof-_0040r_007bmode_007d-373"></a><a name="index-g_t2602gf-374"></a><a name="index-g_t_002e2602gf-375"></a>The <var>mode</var> in the example command above is a name referring to a
+ <p><a name="index-mode-needed-to-run-Metafont-383"></a><a name="index-proof-_0040r_007bmode_007d-384"></a><a name="index-g_t2602gf-385"></a><a name="index-g_t_002e2602gf-386"></a>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
<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>
@@ -1861,13 +1934,13 @@ usual. For example:
<dt>&lsquo;<samp><span class="samp">-[no]-file-line-error</span></samp>&rsquo;<dt>&lsquo;<samp><span class="samp">-fmt=</span><var>fmtname</var></samp>&rsquo;<dt>&lsquo;<samp><span class="samp">-halt-on-error</span></samp>&rsquo;<dt>&lsquo;<samp><span class="samp">-ini</span></samp>&rsquo;<dt>&lsquo;<samp><span class="samp">-interaction=</span><var>string</var></samp>&rsquo;<dt>&lsquo;<samp><span class="samp">-jobname=</span><var>string</var></samp>&rsquo;<dt>&lsquo;<samp><span class="samp">-kpathsea-debug=</span><var>number</var></samp>&rsquo;<dt>&lsquo;<samp><span class="samp">-[no]parse-first-line</span></samp>&rsquo;<dt>&lsquo;<samp><span class="samp">-output-directory</span></samp>&rsquo;<dt>&lsquo;<samp><span class="samp">-progname=</span><var>string</var></samp>&rsquo;<dt>&lsquo;<samp><span class="samp">-recorder</span></samp>&rsquo;<dt>&lsquo;<samp><span class="samp">-translate-file=</span><var>tcxfile</var></samp>&rsquo;<dt>&lsquo;<samp><span class="samp">-8bit</span></samp>&rsquo;<dd>These options are common to TeX, Metafont, and MetaPost.
See <a href="#Common-options">Common options</a>.
- <br><dt>&lsquo;<samp><span class="samp">-mktex=</span><var>filetype</var></samp>&rsquo;<dt>&lsquo;<samp><span class="samp">-no-mktex=</span><var>filetype</var></samp>&rsquo;<dd><a name="index-g_t_002dmktex_003d_0040var_007bfiletype_007d-376"></a><a name="index-g_t_002dno_002dmktex_003d_0040var_007bfiletype_007d-377"></a>Turn on or off the &lsquo;<samp><span class="samp">mktex</span></samp>&rsquo; script associated with <var>filetype</var>.
+ <br><dt>&lsquo;<samp><span class="samp">-mktex=</span><var>filetype</var></samp>&rsquo;<dt>&lsquo;<samp><span class="samp">-no-mktex=</span><var>filetype</var></samp>&rsquo;<dd><a name="index-g_t_002dmktex_003d_0040var_007bfiletype_007d-387"></a><a name="index-g_t_002dno_002dmktex_003d_0040var_007bfiletype_007d-388"></a>Turn on or off the &lsquo;<samp><span class="samp">mktex</span></samp>&rsquo; script associated with <var>filetype</var>.
The only value that makes sense for <var>filetype</var> is &lsquo;<samp><span class="samp">mf</span></samp>&rsquo;.
</dl>
<div class="node">
-<p><hr>
<a name="Initial-Metafont"></a>
+<p><hr>
Next:&nbsp;<a rel="next" accesskey="n" href="#Modes">Modes</a>,
Previous:&nbsp;<a rel="previous" accesskey="p" href="#mf-invocation">mf invocation</a>,
Up:&nbsp;<a rel="up" accesskey="u" href="#Metafont">Metafont</a>
@@ -1876,8 +1949,8 @@ Up:&nbsp;<a rel="up" accesskey="u" href="#Metafont">Metafont</a>
<h3 class="section">5.2 Initial Metafont</h3>
-<p><a name="index-initial-Metafont-378"></a><a name="index-Metafont_002c-initial-379"></a>
-<a name="index-g_t_002ebase-380"></a><a name="index-base-files-381"></a><code>inimf</code> is the &ldquo;initial&rdquo; form of Metafont, which does lengthy
+<p><a name="index-initial-Metafont-389"></a><a name="index-Metafont_002c-initial-390"></a>
+<a name="index-g_t_002ebase-391"></a><a name="index-base-files-392"></a><code>inimf</code> is the &ldquo;initial&rdquo; form of Metafont, which does lengthy
initializations avoided by the &ldquo;virgin&rdquo; (<code>vir</code>) form, so as to
be capable of dumping &lsquo;<samp><span class="samp">.base</span></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>. In past releases, a separate program <samp><span class="command">inimf</span></samp> was
@@ -1885,7 +1958,7 @@ installed to invoke the initial form, but this is no longer the case.
<p>For a list of options and other information, see <a href="#mf-invocation">mf invocation</a>.
- <p><a name="index-plain_002ebase-382"></a><a name="index-mf_002ebase-383"></a>The only memory dump file commonly used with Metafont is the default
+ <p><a name="index-plain_002ebase-393"></a><a name="index-mf_002ebase-394"></a>The only memory dump file commonly used with Metafont is the default
&lsquo;<samp><span class="samp">plain.base</span></samp>&rsquo;, also known as &lsquo;<samp><span class="samp">mf.base</span></samp>&rsquo; (again, see <a href="#Memory-dumps">Memory dumps</a>). It is created by default during installation, but you can also
do so by hand if necessary (e.g., if a Metafont update is issued):
<pre class="example"> mf -ini '\input plain; input modes; dump'
@@ -1898,18 +1971,18 @@ Then install the resulting <samp><span class="file">plain.base</span></samp> in
<p>For an explanation of the additional <samp><span class="file">modes.mf</span></samp> file,
see <a href="#Modes">Modes</a>. This file has no counterpart in TeX or MetaPost.
- <p><a name="index-cmmf_002ebase-_0040r_007bnot-recommended_007d-384"></a><a name="index-cm_002ebase-385"></a><a name="index-cmbase_002emf-386"></a><a name="index-Computer-Modern-macros-387"></a><a name="index-base-files_002c-plain-only-388"></a>In the past, it was sometimes useful to create a base file
+ <p><a name="index-cmmf_002ebase-_0040r_007bnot-recommended_007d-395"></a><a name="index-cm_002ebase-396"></a><a name="index-cmbase_002emf-397"></a><a name="index-Computer-Modern-macros-398"></a><a name="index-base-files_002c-plain-only-399"></a>In the past, it was sometimes useful to create a base file
<samp><span class="file">cmmf.base</span></samp> (a.k.a. <samp><span class="file">cm.base</span></samp>), with the Computer Modern
macros also included in the base file. Nowadays, however, the
additional time required to read <samp><span class="file">cmbase.mf</span></samp> is exceedingly small,
usually not enough to be worth the administrative hassle of updating the
<samp><span class="file">cmmf.base</span></samp> file when you install a new version of <samp><span class="file">modes.mf</span></samp>.
-<a name="index-type-design_002c-personal-389"></a>People actually working on a typeface may still find it worthwhile to
+<a name="index-type-design_002c-personal-400"></a>People actually working on a typeface may still find it worthwhile to
create their own base file, of course.
<div class="node">
-<p><hr>
<a name="Modes"></a>
+<p><hr>
Next:&nbsp;<a rel="next" accesskey="n" href="#Online-Metafont-graphics">Online Metafont graphics</a>,
Previous:&nbsp;<a rel="previous" accesskey="p" href="#Initial-Metafont">Initial Metafont</a>,
Up:&nbsp;<a rel="up" accesskey="u" href="#Metafont">Metafont</a>
@@ -1918,16 +1991,16 @@ Up:&nbsp;<a rel="up" accesskey="u" href="#Metafont">Metafont</a>
<h3 class="section">5.3 Modes: Device definitions for Metafont</h3>
-<p><a name="index-modes-file-needed-for-Metafont-390"></a><a name="index-base-files_002c-need-mode-definitions-391"></a><a name="index-device-definitions_002c-for-Metafont-392"></a><a name="index-printer-characteristics_002c-for-Metafont-393"></a>Running Metafont and creating Metafont base files requires information
+<p><a name="index-modes-file-needed-for-Metafont-401"></a><a name="index-base-files_002c-need-mode-definitions-402"></a><a name="index-device-definitions_002c-for-Metafont-403"></a><a name="index-printer-characteristics_002c-for-Metafont-404"></a>Running Metafont and creating Metafont base files requires information
that TeX and MetaPost do not: <dfn>mode</dfn> definitions which specify
device characteristics, so Metafont can properly rasterize the shapes.
- <p><a name="index-modes_002emf-_0040r_007brecommended-modes-file_007d-394"></a>When making a base file, a file containing modes for locally-available
+ <p><a name="index-modes_002emf-_0040r_007brecommended-modes-file_007d-405"></a>When making a base file, a file containing modes for locally-available
devices should be input after <samp><span class="file">plain.mf</span></samp>. One commonly used file
is <a href="ftp://ftp.tug.org/tex/modes.mf">ftp://ftp.tug.org/tex/modes.mf</a>; it includes all known
definitions.
- <p><a name="index-small-Metafont-memory-and-modes-395"></a><a name="index-mode_005fdef-396"></a><a name="index-mode_005fsetup-397"></a>If, however, for some reason you have decreased the memory available in
+ <p><a name="index-small-Metafont-memory-and-modes-406"></a><a name="index-mode_005fdef-407"></a><a name="index-mode_005fsetup-408"></a>If, however, for some reason you have decreased the memory available in
your Metafont, you may need to copy <samp><span class="file">modes.mf</span></samp> and remove the
definitions irrelevant to you (probably most of them) instead of using
it directly. (Or, if you're a Metafont hacker, maybe you can suggest a
@@ -1937,10 +2010,10 @@ the <code>mode_def</code> names, and that's a lot.)
<p>If you have a device not included in <samp><span class="file">modes.mf</span></samp>, please see
comments in that file for how to create the new definition, and please
-send the definition to <a href="mailto:tex-fonts@mail.tug.org">tex-fonts@mail.tug.org</a> to get it included
+send the definition to <a href="mailto:tex-fonts@math.utah.edu">tex-fonts@math.utah.edu</a> to get it included
in the next release of <samp><span class="file">modes.mf</span></samp>.
- <p><a name="index-smode-_0040r_007band-dynamic-Metafont-mode-definition_007d-398"></a><a name="index-dynamic-Metafont-mode-definitions-with-_0040code_007bsmode_007d-399"></a>Usually, when you run Metafont you must supply the name of a mode that
+ <p><a name="index-smode-_0040r_007band-dynamic-Metafont-mode-definition_007d-409"></a><a name="index-dynamic-Metafont-mode-definitions-with-_0040code_007bsmode_007d-410"></a>Usually, when you run Metafont you must supply the name of a mode that
was dumped in the base file. But you can also define the mode
characteristics dynamically, by invoking Metafont with an assignment to
<code>smode</code> instead of <code>mode</code>, like this:
@@ -1966,8 +2039,8 @@ and <var>o</var>.)
<samp><span class="file">modes.mf</span></samp>, see page 269 of <cite>The Metafontbook</cite>.
<div class="node">
-<p><hr>
<a name="Online-Metafont-graphics"></a>
+<p><hr>
Next:&nbsp;<a rel="next" accesskey="n" href="#gftodvi-invocation">gftodvi invocation</a>,
Previous:&nbsp;<a rel="previous" accesskey="p" href="#Modes">Modes</a>,
Up:&nbsp;<a rel="up" accesskey="u" href="#Metafont">Metafont</a>
@@ -1976,13 +2049,13 @@ Up:&nbsp;<a rel="up" accesskey="u" href="#Metafont">Metafont</a>
<h3 class="section">5.4 Online Metafont graphics</h3>
-<p><a name="index-online-Metafont-graphics-400"></a><a name="index-Metafont-graphics-401"></a>
+<p><a name="index-online-Metafont-graphics-411"></a><a name="index-Metafont-graphics-412"></a>
The Web2c implementation of Metafont can do online graphics with a
number of devices. (See the Metafont manual for more information about
how to draw on your screen.) By default, no graphics support is
enabled.
- <p><a name="index-MFTERM-402"></a><a name="index-TERM-403"></a>Metafont examines the <code>MFTERM</code> environment variable or config file
+ <p><a name="index-MFTERM-413"></a><a name="index-TERM-414"></a>Metafont examines the <code>MFTERM</code> environment variable or config file
value at runtime, or the <code>TERM</code> environment variable if
<code>MFTERM</code> is not set, to determine the device support to use.
Naturally, only the devices for which support has been compiled in can
@@ -1992,64 +2065,64 @@ be selected.
and the corresponding <code>configure</code> option(s) in parentheses.
<dl>
-<dt><code>epsf</code><a name="index-epsf-404"></a><dd><a name="index-Herberts_002c-Mathias-405"></a><a name="index-g_t_002d_002dwith_002depsfwin-406"></a>(&lsquo;<samp><span class="samp">--with-epsfwin</span></samp>&rsquo;) Pseudo-window server for Encapsulated
+<dt><code>epsf</code><a name="index-epsf-415"></a><dd><a name="index-Herberts_002c-Mathias-416"></a><a name="index-g_t_002d_002dwith_002depsfwin-417"></a>(&lsquo;<samp><span class="samp">--with-epsfwin</span></samp>&rsquo;) Pseudo-window server for Encapsulated
PostScript (see <samp><span class="file">web2c/window/epsf.c</span></samp>). This device produces an
EPS file containing the graphics which would be displayed online on
other devices. The name of the EPS file defaults to metafont.eps but
can be changed by setting the MFEPSF environment variable to the new
filename. Contributed by Mathias Herberts.
- <br><dt><code>hp2627</code><a name="index-hp2627-407"></a><dd><a name="index-g_t_002d_002dwith_002dhp2627win-408"></a>(&lsquo;<samp><span class="samp">--with-hp2627win</span></samp>&rsquo;) HP2627a color graphics terminals.
+ <br><dt><code>hp2627</code><a name="index-hp2627-418"></a><dd><a name="index-g_t_002d_002dwith_002dhp2627win-419"></a>(&lsquo;<samp><span class="samp">--with-hp2627win</span></samp>&rsquo;) HP2627a color graphics terminals.
- <br><dt><code>mftalk</code><a name="index-mftalk-409"></a><dd><a name="index-g_t_002d_002dwith_002dmftalkwin-410"></a>(&lsquo;<samp><span class="samp">--with-mftalkwin</span></samp>&rsquo;) Generic window server (see
+ <br><dt><code>mftalk</code><a name="index-mftalk-420"></a><dd><a name="index-g_t_002d_002dwith_002dmftalkwin-421"></a>(&lsquo;<samp><span class="samp">--with-mftalkwin</span></samp>&rsquo;) Generic window server (see
<samp><span class="file">web2c/window/mftalk.c</span></samp>).
- <br><dt><code>next</code><a name="index-next-411"></a><dd><a name="index-DrawingServant-412"></a><a name="index-g_t_002d_002dwith_002dnext-413"></a>(&lsquo;<samp><span class="samp">--with-next</span></samp>&rsquo;) NeXT window system. This requires a separate
+ <br><dt><code>next</code><a name="index-next-422"></a><dd><a name="index-DrawingServant-423"></a><a name="index-g_t_002d_002dwith_002dnext-424"></a>(&lsquo;<samp><span class="samp">--with-next</span></samp>&rsquo;) NeXT window system. This requires a separate
program, called <code>DrawingServant</code>, available separately. See the
<samp><span class="file">web2c/window/next.c</span></samp>.
- <br><dt><code>regis</code><a name="index-regis-414"></a><dd><a name="index-g_t_002d_002dwith_002dregiswin-415"></a><a name="index-Regis-graphics-support-416"></a>(&lsquo;<samp><span class="samp">--with-regiswin</span></samp>&rsquo;) Regis terminals.
+ <br><dt><code>regis</code><a name="index-regis-425"></a><dd><a name="index-g_t_002d_002dwith_002dregiswin-426"></a><a name="index-Regis-graphics-support-427"></a>(&lsquo;<samp><span class="samp">--with-regiswin</span></samp>&rsquo;) Regis terminals.
- <br><dt><code>sun</code><a name="index-sun-417"></a><dd><a name="index-SunView-418"></a><a name="index-Suntools-419"></a><a name="index-g_t_002d_002dwith_002dsuntoolswin-420"></a><a name="index-sun_002dgfx_002ec-421"></a>(&lsquo;<samp><span class="samp">--with-suntoolswin</span></samp>&rsquo;) The old Suntools (not any flavor of X)
+ <br><dt><code>sun</code><a name="index-sun-428"></a><dd><a name="index-SunView-429"></a><a name="index-Suntools-430"></a><a name="index-g_t_002d_002dwith_002dsuntoolswin-431"></a><a name="index-sun_002dgfx_002ec-432"></a>(&lsquo;<samp><span class="samp">--with-suntoolswin</span></samp>&rsquo;) The old Suntools (not any flavor of X)
window system. (You can get the even older SunWindows <code>gfx</code> system
by using <samp><span class="file">sun-gfx.c</span></samp>.)
- <br><dt><code>tek</code><a name="index-tek-422"></a><dd><a name="index-Tektronix-423"></a><a name="index-g_t_002d_002dwith_002dtektronixwin-424"></a>(&lsquo;<samp><span class="samp">--with-tektronixwin</span></samp>&rsquo;) Tektronix terminals.
+ <br><dt><code>tek</code><a name="index-tek-433"></a><dd><a name="index-Tektronix-434"></a><a name="index-g_t_002d_002dwith_002dtektronixwin-435"></a>(&lsquo;<samp><span class="samp">--with-tektronixwin</span></samp>&rsquo;) Tektronix terminals.
- <p><a name="index-Poole_002c-Simon-425"></a><br><dt><code>uniterm</code><a name="index-uniterm-426"></a><dd><a name="index-Tektronix-4014-427"></a><a name="index-g_t_002d_002dwith_002dunitermwin-428"></a>(&lsquo;<samp><span class="samp">--with-unitermwin</span></samp>&rsquo;) Uniterm, Simon Poole's emulator of a smart
+ <p><a name="index-Poole_002c-Simon-436"></a><br><dt><code>uniterm</code><a name="index-uniterm-437"></a><dd><a name="index-Tektronix-4014-438"></a><a name="index-g_t_002d_002dwith_002dunitermwin-439"></a>(&lsquo;<samp><span class="samp">--with-unitermwin</span></samp>&rsquo;) Uniterm, Simon Poole's emulator of a smart
Tektronix 4014 terminal. This may work with regular Tektronix terminals
as well; it's faster than the driver &lsquo;<samp><span class="samp">--with-tek</span></samp>&rsquo; selects.
- <p><a name="index-NO_005fX11WIN-429"></a><a name="index-Xt-430"></a><a name="index-Xlib-431"></a><br><dt><code>xterm</code><a name="index-xterm-432"></a><dd><a name="index-g_t_002d_002dwith_002dx11win-433"></a><a name="index-g_t_002d_002dwith_002dx-434"></a><a name="index-g_t_002d_002dwith_002dx11-435"></a>(&lsquo;<samp><span class="samp">--with-x11win</span></samp>&rsquo;, &lsquo;<samp><span class="samp">--with-x</span></samp>&rsquo;, &lsquo;<samp><span class="samp">--with-x11</span></samp>&rsquo;) The X window
+ <p><a name="index-NO_005fX11WIN-440"></a><a name="index-Xt-441"></a><a name="index-Xlib-442"></a><br><dt><code>xterm</code><a name="index-xterm-443"></a><dd><a name="index-g_t_002d_002dwith_002dx11win-444"></a><a name="index-g_t_002d_002dwith_002dx-445"></a><a name="index-g_t_002d_002dwith_002dx11-446"></a>(&lsquo;<samp><span class="samp">--with-x11win</span></samp>&rsquo;, &lsquo;<samp><span class="samp">--with-x</span></samp>&rsquo;, &lsquo;<samp><span class="samp">--with-x11</span></samp>&rsquo;) The X window
system (version 11).
- <p><a name="index-g_t_002d_002dwith_002dx_002dtoolkit_003d_0040var_007bkit_007d-436"></a><a name="index-toolkits_002c-X-437"></a><a name="index-X-toolkits-and-Metafont-438"></a><a name="index-Xt-support-439"></a><a name="index-Xlib-support-440"></a>There are two variants of the X11 support, one that works with the Xt
+ <p><a name="index-g_t_002d_002dwith_002dx_002dtoolkit_003d_0040var_007bkit_007d-447"></a><a name="index-toolkits_002c-X-448"></a><a name="index-X-toolkits-and-Metafont-449"></a><a name="index-Xt-support-450"></a><a name="index-Xlib-support-451"></a>There are two variants of the X11 support, one that works with the Xt
toolkit, and another that works directly with Xlib. The Xt support is
more efficient and has more functionality, so it is the default. If you
must use the Xlib support, use &lsquo;<samp><span class="samp">configure --with-x
--with-x-toolkit=no</span></samp>&rsquo;.
- <p><a name="index-X-resources-441"></a><a name="index-X-class-name-for-Metafont-442"></a><a name="index-class-name-for-Metafont-443"></a><a name="index-geometry-for-Metafont-444"></a><a name="index-Metafont-geometry-445"></a><a name="index-g_t_002eXdefaults-446"></a><a name="index-g_t_002eXresources-447"></a><a name="index-g_t_002dgeometry_0040r_007b_002c-supported-with-Xt_007d-448"></a>You cannot specify any of the usual X options (e.g., &lsquo;<samp><span class="samp">-geometry</span></samp>&rsquo;)
+ <p><a name="index-X-resources-452"></a><a name="index-X-class-name-for-Metafont-453"></a><a name="index-class-name-for-Metafont-454"></a><a name="index-geometry-for-Metafont-455"></a><a name="index-Metafont-geometry-456"></a><a name="index-g_t_002eXdefaults-457"></a><a name="index-g_t_002eXresources-458"></a><a name="index-g_t_002dgeometry_0040r_007b_002c-supported-with-Xt_007d-459"></a>You cannot specify any of the usual X options (e.g., &lsquo;<samp><span class="samp">-geometry</span></samp>&rsquo;)
on the Metafont command line, but you can specify X resources in your
<samp><span class="file">~/.Xdefaults</span></samp> or <samp><span class="file">~/.Xresources</span></samp> file. The class name is
<code>Metafont</code>. If you're using the Xt support, all the usual X toolkit
resources are supported. If you're using the Xlib support, only the
<code>geometry</code> resource is supported.
- <p><a name="index-DISPLAY-449"></a>You specify the X display to which Metafont connects in the
+ <p><a name="index-DISPLAY-460"></a>You specify the X display to which Metafont connects in the
<code>DISPLAY</code> environment variable, as usual.
</dl>
- <p><a name="index-Metafont-online-support_002c-new-devices-450"></a><a name="index-new-graphics-support-for-Metafont-451"></a><a name="index-texmfmp_002ec-452"></a>Writing support for a new device is straightforward. Aside from defining
+ <p><a name="index-Metafont-online-support_002c-new-devices-461"></a><a name="index-new-graphics-support-for-Metafont-462"></a><a name="index-texmfmp_002ec-463"></a>Writing support for a new device is straightforward. Aside from defining
the basic drawing routines that Metafont uses (see <samp><span class="file">mf.web</span></samp>), you
only have to add another entry to the tables on the last page of
<samp><span class="file">web2c/lib/texmfmp.c</span></samp>. Or you can write an independent program and
use MFtalk (see <samp><span class="file">web2c/window/mftalk.c</span></samp>).
<div class="node">
-<p><hr>
<a name="gftodvi-invocation"></a>
+<p><hr>
Next:&nbsp;<a rel="next" accesskey="n" href="#mft-invocation">mft invocation</a>,
Previous:&nbsp;<a rel="previous" accesskey="p" href="#Online-Metafont-graphics">Online Metafont graphics</a>,
Up:&nbsp;<a rel="up" accesskey="u" href="#Metafont">Metafont</a>
@@ -2058,7 +2131,7 @@ Up:&nbsp;<a rel="up" accesskey="u" href="#Metafont">Metafont</a>
<h3 class="section">5.5 GFtoDVI: Character proofs of fonts</h3>
-<p><a name="index-gftodvi-453"></a><a name="index-character-proofs-of-fonts-454"></a><a name="index-font-proofs-455"></a><a name="index-proof-sheets_002c-of-fonts-456"></a>
+<p><a name="index-gftodvi-464"></a><a name="index-character-proofs-of-fonts-465"></a><a name="index-font-proofs-466"></a><a name="index-proof-sheets_002c-of-fonts-467"></a>
GFtoDVI makes <dfn>proof sheets</dfn> from a GF bitmap file as output by, for
example, Metafont (see <a href="#Metafont">Metafont</a>). This is an indispensable aid for
font designers or Metafont hackers. Synopsis:
@@ -2083,17 +2156,17 @@ with labels, titles, and annotations, as specified in Appendix H
<p>GFtoDVI uses several fonts besides <var>gfname</var> itself:
<ul>
-<li><a name="index-gray-font-457"></a><dfn>gray font</dfn> (default <samp><span class="file">gray</span></samp>): for the pixels that actually make
+<li><a name="index-gray-font-468"></a><dfn>gray font</dfn> (default <samp><span class="file">gray</span></samp>): for the pixels that actually make
up the character. Simply using black is not right, since then labels,
key points, and other information could not be shown.
- <li><a name="index-title-font-458"></a><dfn>title font</dfn> (default <samp><span class="file">cmr8</span></samp>): for the header information at
+ <li><a name="index-title-font-469"></a><dfn>title font</dfn> (default <samp><span class="file">cmr8</span></samp>): for the header information at
the top of each output page.
- <li><a name="index-label-font-459"></a><dfn>label font</dfn> (default <samp><span class="file">cmtt10</span></samp>): for the labels on key points
+ <li><a name="index-label-font-470"></a><dfn>label font</dfn> (default <samp><span class="file">cmtt10</span></samp>): for the labels on key points
of the figure.
- <li><a name="index-slant-font-460"></a><dfn>slant font</dfn> (no default): for diagonal lines, which are otherwise
+ <li><a name="index-slant-font-471"></a><dfn>slant font</dfn> (no default): for diagonal lines, which are otherwise
simulated using horizontal and vertical rules.
</ul>
@@ -2115,7 +2188,7 @@ should produce <samp><span class="file">rtest.dvi</span></samp>, which you proce
&lsquo;<samp><span class="samp">-verbose</span></samp>&rsquo;, &lsquo;<samp><span class="samp">-help</span></samp>&rsquo;, and &lsquo;<samp><span class="samp">-version</span></samp>&rsquo; (see <a href="#Common-options">Common options</a>):
<dl>
-<dt>&lsquo;<samp><span class="samp">-overflow-label-offset=</span><var>points</var></samp>&rsquo;<dd><a name="index-g_t_002doverflow_002dlabel_002doffset_003d_0040var_007bpoints_007d-461"></a><a name="index-overflow-label-offset-462"></a><a name="index-offset-for-overflow-labels-463"></a>Typeset the so-called overflow labels, if any, <var>points</var> TeX
+<dt>&lsquo;<samp><span class="samp">-overflow-label-offset=</span><var>points</var></samp>&rsquo;<dd><a name="index-g_t_002doverflow_002dlabel_002doffset_003d_0040var_007bpoints_007d-472"></a><a name="index-overflow-label-offset-473"></a><a name="index-offset-for-overflow-labels-474"></a>Typeset the so-called overflow labels, if any, <var>points</var> TeX
points from the right edge of the character bounding box. The default
is a little over two inches (ten million scaled points, to be precise).
Overflow equations are used to locate coordinates when their actual
@@ -2123,8 +2196,8 @@ position is too crowded with other information.
</dl>
<div class="node">
-<p><hr>
<a name="mft-invocation"></a>
+<p><hr>
Previous:&nbsp;<a rel="previous" accesskey="p" href="#gftodvi-invocation">gftodvi invocation</a>,
Up:&nbsp;<a rel="up" accesskey="u" href="#Metafont">Metafont</a>
@@ -2132,8 +2205,8 @@ Up:&nbsp;<a rel="up" accesskey="u" href="#Metafont">Metafont</a>
<h3 class="section">5.6 MFT: Prettyprinting Metafont source</h3>
-<p><a name="index-mft-464"></a><a name="index-Metafont-source_002c-prettyprinting-465"></a><a name="index-prettyprinting-Metafont-source-466"></a><a name="index-g_t_0040TeX_007b_007d_002c-creating-from-Metafont-467"></a>
-<a name="index-mftmac_002etex-468"></a>MFT translates a Metafont program into a TeX document suitable for
+<p><a name="index-mft-475"></a><a name="index-Metafont-source_002c-prettyprinting-476"></a><a name="index-prettyprinting-Metafont-source-477"></a><a name="index-g_t_0040TeX_007b_007d_002c-creating-from-Metafont-478"></a>
+<a name="index-mftmac_002etex-479"></a>MFT translates a Metafont program into a TeX document suitable for
typesetting, with the aid of TeX macros defined in the file
<samp><span class="file">mftmac.tex</span></samp>. Synopsis:
@@ -2152,7 +2225,7 @@ indentation and line breaks. Each line of input is translated
independently of the others.
<p>Further control is allowed via Metafont comments:
-<a name="index-comments_002c-MFT-control-469"></a>
+<a name="index-comments_002c-MFT-control-480"></a>
<ul>
<li>Metafont comments following a single &lsquo;<samp><span class="samp">%</span></samp>&rsquo; should be valid TeX
input. But Metafont material can be included within vertical bars in a
@@ -2189,27 +2262,27 @@ of such a line.
<li>Five or more &lsquo;<samp><span class="samp">%</span></samp>&rsquo; signs should not be used.
</ul>
- <p><a name="index-Knuth_002c-Donald-E_002e-470"></a>(The above description was edited from <samp><span class="file">mft.web</span></samp>, written by
+ <p><a name="index-Knuth_002c-Donald-E_002e-481"></a>(The above description was edited from <samp><span class="file">mft.web</span></samp>, written by
D.E.&nbsp;Knuth<!-- /@w -->.)
<p>The program accepts the following options, as well as the standard
&lsquo;<samp><span class="samp">-help</span></samp>&rsquo; and &lsquo;<samp><span class="samp">-version</span></samp>&rsquo; (see <a href="#Common-options">Common options</a>):
<dl>
-<dt>&lsquo;<samp><span class="samp">-change=</span><var>chfile</var><span class="samp">[.ch]</span></samp>&rsquo;<dd><a name="index-g_t_002dchange_003d_0040var_007bchfile_007d-471"></a><a name="index-change-files_002c-and-MFT-472"></a>Apply the change file <var>chfile</var> as with Tangle and Weave
+<dt>&lsquo;<samp><span class="samp">-change=</span><var>chfile</var><span class="samp">[.ch]</span></samp>&rsquo;<dd><a name="index-g_t_002dchange_003d_0040var_007bchfile_007d-482"></a><a name="index-change-files_002c-and-MFT-483"></a>Apply the change file <var>chfile</var> as with Tangle and Weave
(see <a href="#WEB">WEB</a>).
- <br><dt>&lsquo;<samp><span class="samp">-style=</span><var>mftfile</var><span class="samp">[.mft]</span></samp>&rsquo;<dd><a name="index-g_t_002dstyle_003d_0040var_007bmftfile_007d-473"></a><a name="index-style-files-474"></a><a name="index-plain_002emft-475"></a>Read <var>mftfile</var> before anything else; a MFT style file typically
+ <br><dt>&lsquo;<samp><span class="samp">-style=</span><var>mftfile</var><span class="samp">[.mft]</span></samp>&rsquo;<dd><a name="index-g_t_002dstyle_003d_0040var_007bmftfile_007d-484"></a><a name="index-style-files-485"></a><a name="index-plain_002emft-486"></a>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><span class="file">plain.mft</span></samp>, which defines this properly for programs
using plain Metafont. The MFT files is searched along the
<code>MFTINPUTS</code> path; see <a href="kpathsea.html#Supported-file-formats">Supported file formats</a>.
- <p><a name="index-cmbase_002emft-476"></a><a name="index-e_002emft-477"></a><a name="index-g_t_0040cite_007bComputer-Modern-Typefaces_007d_002c-production-of-478"></a>Other examples of MFT style files are <samp><span class="file">cmbase.mft</span></samp>, which defines
+ <p><a name="index-cmbase_002emft-487"></a><a name="index-e_002emft-488"></a><a name="index-g_t_0040cite_007bComputer-Modern-Typefaces_007d_002c-production-of-489"></a>Other examples of MFT style files are <samp><span class="file">cmbase.mft</span></samp>, which defines
formatting rules for the macros defined in <samp><span class="file">cm.base</span></samp>, and
<samp><span class="file">e.mft</span></samp>, which was used in the production of Knuth's Volume&nbsp;<!-- /@w -->E,
<cite>Computer Modern Typefaces</cite>.
- <p><a name="index-MetaPost-source_002c-prettyprinting-479"></a>Using an appropriate MFT style file, it is also possible to configure
+ <p><a name="index-MetaPost-source_002c-prettyprinting-490"></a>Using an appropriate MFT style file, it is also possible to configure
MFT for typesetting MetaPost sources. However, MFT does not search
the usual places for MetaPost input files.
</dl>
@@ -2219,8 +2292,8 @@ passed on verbatim to the TeX output file; it is up to you to
configure TeX to print these properly.
<div class="node">
-<p><hr>
<a name="MetaPost"></a>
+<p><hr>
Next:&nbsp;<a rel="next" accesskey="n" href="#BibTeX">BibTeX</a>,
Previous:&nbsp;<a rel="previous" accesskey="p" href="#Metafont">Metafont</a>,
Up:&nbsp;<a rel="up" accesskey="u" href="#Top">Top</a>
@@ -2229,7 +2302,7 @@ Up:&nbsp;<a rel="up" accesskey="u" href="#Top">Top</a>
<h2 class="chapter">6 MetaPost: Creating technical illustrations</h2>
-<p><a name="index-MetaPost-480"></a><a name="index-PostScript-meets-Metafont-481"></a><a name="index-Metafont-meets-PostScript-482"></a>MetaPost is a picture-drawing language similar to Metafont
+<p><a name="index-MetaPost-491"></a><a name="index-PostScript-meets-Metafont-492"></a><a name="index-Metafont-meets-PostScript-493"></a>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
outputs PostScript commands. It's primarily intended for creating
technical illustrations.
@@ -2241,16 +2314,12 @@ supported) and a number of other subsidiary programs, described below.
<ul class="menu">
<li><a accesskey="1" href="#mpost-invocation">mpost invocation</a>: Invoking MetaPost.
<li><a accesskey="2" href="#Initial-MetaPost">Initial MetaPost</a>: Making mems.
-<li><a accesskey="3" href="#makempx-invocation">makempx invocation</a>: Create MPX files for labels.
-<li><a accesskey="4" href="#dvitomp-invocation">dvitomp invocation</a>: DVI-to-MPX translation.
-<li><a accesskey="5" href="#dmp-invocation">dmp invocation</a>: Ditroff-to-MPX translation.
-<li><a accesskey="6" href="#mpto-invocation">mpto invocation</a>: Extracting labels from MetaPost programs.
-<li><a accesskey="7" href="#newer-invocation">newer invocation</a>: Is one file newer than another?
+<li><a accesskey="3" href="#dvitomp-invocation">dvitomp invocation</a>: DVI-to-MPX translation.
</ul>
<div class="node">
-<p><hr>
<a name="mpost-invocation"></a>
+<p><hr>
Next:&nbsp;<a rel="next" accesskey="n" href="#Initial-MetaPost">Initial MetaPost</a>,
Up:&nbsp;<a rel="up" accesskey="u" href="#MetaPost">MetaPost</a>
@@ -2258,8 +2327,8 @@ Up:&nbsp;<a rel="up" accesskey="u" href="#MetaPost">MetaPost</a>
<h3 class="section">6.1 <code>mpost</code> invocation</h3>
-<p><a name="index-mpost-483"></a><a name="index-MetaPost-invocation-484"></a>
-<a name="index-mpman_002eps-485"></a>MetaPost (installed as <code>mpost</code>) reads a series of pictures
+<p><a name="index-mpost-494"></a><a name="index-MetaPost-invocation-495"></a>
+<a name="index-mpman_002eps-496"></a>MetaPost (installed as <code>mpost</code>) reads a series of pictures
specified in the MetaPost programming language, and outputs
corresponding PostScript code. This section merely describes the
options available in the Web2c implementation. For a complete
@@ -2274,7 +2343,7 @@ also:
related information).
</ul>
- <p><a name="index-mpgraph_002eps-486"></a>Also, a standard MetaPost package for drawing graphs is documented in
+ <p><a name="index-mpgraph_002eps-497"></a>Also, a standard MetaPost package for drawing graphs is documented in
AT&amp;T technical report CSTR-164, available as the file <samp><span class="file">mpgraph.ps</span></samp>,
generally stored alongside <samp><span class="file">mpman.ps</span></samp>.
@@ -2286,13 +2355,13 @@ Synopses:
mpost [<var>option</var>]... \<var>first-line</var>
mpost [<var>option</var>]... &amp;<var>mem</var> <var>args</var>
</pre>
- <p><a name="index-g_t_002emp-487"></a><a name="index-MetaPost-input-files-488"></a>MetaPost searches the usual places for the main input file <var>mpname</var>
+ <p><a name="index-g_t_002emp-498"></a><a name="index-MetaPost-input-files-499"></a>MetaPost searches the usual places for the main input file <var>mpname</var>
(see <a href="kpathsea.html#Supported-file-formats">Supported file formats</a>), extending
<var>mpname</var> with <samp><span class="file">.mp</span></samp> if necessary. To see all the relevant
paths, set the environment variable <code>KPATHSEA_DEBUG</code> to &lsquo;<samp><span class="samp">-1</span></samp>&rsquo;
before running the program.
- <p><a name="index-beginfig-489"></a><a name="index-g_t_002e_0040var_007bnnn_007d-_0040r_007bPostScript-figures_007d-490"></a><a name="index-g_t_002etfm-_0040r_007boutput_007d-491"></a><a name="index-mpout-492"></a><a name="index-TFM-files_002c-output-by-MetaPost-493"></a><a name="index-PostScript-output-494"></a>MetaPost writes its PostScript output to a series of files
+ <p><a name="index-beginfig-500"></a><a name="index-g_t_002e_0040var_007bnnn_007d-_0040r_007bPostScript-figures_007d-501"></a><a name="index-g_t_002etfm-_0040r_007boutput_007d-502"></a><a name="index-mpout-503"></a><a name="index-TFM-files_002c-output-by-MetaPost-504"></a><a name="index-PostScript-output-505"></a>MetaPost writes its PostScript output to a series of files
<samp><var>basempname</var><span class="file">.</span><var>nnn</var></samp> (or perhaps
<samp><var>basempname</var><span class="file">.ps</span></samp>, very occasionally
<samp><var>basempname</var><span class="file">.tfm</span></samp>), where <var>nnn</var> are the figure numbers
@@ -2307,21 +2376,21 @@ with any other PostScript figures. For example, with this TeX command:
</pre>
<p class="noindent">or by using <samp><span class="file">epsf.tex</span></samp> (see <a href="dvips.html#EPSF-macros">EPSF macros</a>).
- <p><a name="index-btex-_0040r_007bfor-MetaPost-labels_007d-495"></a><a name="index-etex-_0040r_007bfor-MetaPost-labels_007d-496"></a>The MetaPost construct
+ <p><a name="index-btex-_0040r_007bfor-MetaPost-labels_007d-506"></a><a name="index-etex-_0040r_007bfor-MetaPost-labels_007d-507"></a>The MetaPost construct
<pre class="example"> btex ... <var>tex-input</var> ... etex
</pre>
- <p class="noindent">calls MakeMPX to generate a MPX file containing a MetaPost picture
-expression corresponding to <var>tex-input</var> (see <a href="#makempx-invocation">makempx invocation</a>).
+ <p class="noindent">generates a MetaPost picture expression corresponding to
+<var>tex-input</var>.
<p>The construct
<pre class="example"> verbatimtex ... <var>tex-input</var> ... etex
</pre>
- <p class="noindent">simply passes the <var>tex-input</var> through to MakeMPX and thus to
+ <p class="noindent">simply passes the <var>tex-input</var> through to
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><span class="samp">latex</span></samp>&rsquo; (see <a href="#makempx-invocation">makempx invocation</a>).
+enviroment variable <code>TEX</code> to &lsquo;<samp><span class="samp">latex</span></samp>&rsquo;.
<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><span class="samp">-m pictures</span></samp>&rsquo; Troff macro
@@ -2329,15 +2398,12 @@ package (unfortunately absent from many Troff implementations), or an
equivalent such as the &lsquo;<samp><span class="samp">-m pspic</span></samp>&rsquo; macros from GNU groff described
in grops(1).
- <p>Other typesetters can be supported with no change to MetaPost itself;
-only MakeMPX needs to be updated.
-
- <p><a name="index-PostScript-fonts_002c-and-Troff-497"></a><a name="index-Troff_002c-and-MetaPost-498"></a><a name="index-Computer-Modern-fonts_002c-and-Troff-499"></a>Naturally, you must use fonts that are supported by the typesetter;
+ <p><a name="index-PostScript-fonts_002c-and-Troff-508"></a><a name="index-Troff_002c-and-MetaPost-509"></a><a name="index-Computer-Modern-fonts_002c-and-Troff-510"></a>Naturally, you must use fonts that are supported by the typesetter;
specifically, you'll probably want to use standard PostScript fonts with
Troff. And only the TeX system understands Computer Modern or other
Metafont fonts; you can also use PostScript fonts with TeX, of course.
- <p><a name="index-mproof_002etex-500"></a><a name="index-downloading-of-fonts-for-MetaPost-labels-501"></a><a name="index-font-downloading-for-MetaPost-labels-502"></a>MetaPost-generated PostScript figures which do use Computer Modern fonts
+ <p><a name="index-mproof_002etex-511"></a><a name="index-downloading-of-fonts-for-MetaPost-labels-512"></a><a name="index-font-downloading-for-MetaPost-labels-513"></a>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="dvips.html#Fonts-in-figures">Fonts in figures</a>). To help with this, the MetaPost
@@ -2347,7 +2413,7 @@ typically called as:
</pre>
<p class="noindent">The resulting file <samp><span class="file">mproof.ps</span></samp> can then be printed or previewed.
- <p><a name="index-prologues_0040r_007b_002c-and-EPSF-output_007d-503"></a><a name="index-psfonts_002emap_0040r_007b_002c-read-by-MetaPost_007d-504"></a>To generate EPSF files, set the internal MetaPost variable
+ <p><a name="index-prologues_0040r_007b_002c-and-EPSF-output_007d-514"></a><a name="index-psfonts_002emap_0040r_007b_002c-read-by-MetaPost_007d-515"></a>To generate EPSF files, set the internal MetaPost variable
<code>prologues</code> positive. To make the output files self-contained, use
only standard PostScript fonts. MetaPost reads the same
<samp><span class="file">psfonts.map</span></samp> file as Dvips, to determine PostScript fonts that
@@ -2362,18 +2428,17 @@ opens a security hole. See <a href="#tex-invocation">tex invocation</a>.
<dt>&lsquo;<samp><span class="samp">-[no]-file-line-error</span></samp>&rsquo;<dt>&lsquo;<samp><span class="samp">-fmt=</span><var>fmtname</var></samp>&rsquo;<dt>&lsquo;<samp><span class="samp">-halt-on-error</span></samp>&rsquo;<dt>&lsquo;<samp><span class="samp">-ini</span></samp>&rsquo;<dt>&lsquo;<samp><span class="samp">-interaction=</span><var>string</var></samp>&rsquo;<dt>&lsquo;<samp><span class="samp">-jobname=</span><var>string</var></samp>&rsquo;<dt>&lsquo;<samp><span class="samp">-kpathsea-debug=</span><var>number</var></samp>&rsquo;<dt>&lsquo;<samp><span class="samp">-[no]parse-first-line</span></samp>&rsquo;<dt>&lsquo;<samp><span class="samp">-output-directory</span></samp>&rsquo;<dt>&lsquo;<samp><span class="samp">-progname=</span><var>string</var></samp>&rsquo;<dt>&lsquo;<samp><span class="samp">-recorder</span></samp>&rsquo;<dt>&lsquo;<samp><span class="samp">-translate-file=</span><var>tcxfile</var></samp>&rsquo;<dt>&lsquo;<samp><span class="samp">-8bit</span></samp>&rsquo;<dd>These options are common to TeX, Metafont, and MetaPost.
See <a href="#Common-options">Common options</a>.
- <br><dt>&lsquo;<samp><span class="samp">-T</span></samp>&rsquo;<dt>&lsquo;<samp><span class="samp">-troff</span></samp>&rsquo;<dd><a name="index-g_t_002dT-505"></a><a name="index-g_t_002dtroff-506"></a><a name="index-prologues-507"></a>Set the <code>prologues</code> internal variable to <code>1</code>, and use
-<code>makempx -troff</code> to generate MPX files.
+ <br><dt>&lsquo;<samp><span class="samp">-T</span></samp>&rsquo;<dt>&lsquo;<samp><span class="samp">-troff</span></samp>&rsquo;<dd><a name="index-g_t_002dT-516"></a><a name="index-g_t_002dtroff-517"></a><a name="index-prologues-518"></a>Set the <code>prologues</code> internal variable to <code>1</code>.
- <br><dt>&lsquo;<samp><span class="samp">-tex=</span><var>texprogram</var></samp>&rsquo;<dd><a name="index-g_t_002dtex_003d_0040var_007btexprogram_007d-508"></a>When this option is given, the program <var>texprogram</var> is used to
+ <br><dt>&lsquo;<samp><span class="samp">-tex=</span><var>texprogram</var></samp>&rsquo;<dd><a name="index-g_t_002dtex_003d_0040var_007btexprogram_007d-519"></a>When this option is given, the program <var>texprogram</var> is used to
typeset the labels.
</dl>
<div class="node">
-<p><hr>
<a name="Initial-MetaPost"></a>
-Next:&nbsp;<a rel="next" accesskey="n" href="#makempx-invocation">makempx invocation</a>,
+<p><hr>
+Next:&nbsp;<a rel="next" accesskey="n" href="#dvitomp-invocation">dvitomp invocation</a>,
Previous:&nbsp;<a rel="previous" accesskey="p" href="#mpost-invocation">mpost invocation</a>,
Up:&nbsp;<a rel="up" accesskey="u" href="#MetaPost">MetaPost</a>
@@ -2381,8 +2446,8 @@ Up:&nbsp;<a rel="up" accesskey="u" href="#MetaPost">MetaPost</a>
<h3 class="section">6.2 Initial MetaPost</h3>
-<p><a name="index-initial-MetaPost-509"></a><a name="index-MetaPost_002c-initial-510"></a>
-<a name="index-g_t_002emem-511"></a><a name="index-mem-files-512"></a><code>inimpost</code> is the &ldquo;initial&rdquo; form of MetaPost, which does
+<p><a name="index-initial-MetaPost-520"></a><a name="index-MetaPost_002c-initial-521"></a>
+<a name="index-g_t_002emem-522"></a><a name="index-mem-files-523"></a><code>inimpost</code> is the &ldquo;initial&rdquo; form of MetaPost, which does
lengthy initializations avoided by the &ldquo;virgin&rdquo; (<code>vir</code>) form,
so as to be capable of dumping <samp><span class="file">.mem</span></samp> 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>. In past releases, a separate program
@@ -2391,7 +2456,7 @@ longer the case.
<p>For a list of options and other information, see <a href="#mpost-invocation">mpost invocation</a>.
- <p><a name="index-plain_002emem-513"></a><a name="index-mpost_002emem-514"></a><a name="index-mem-files_002c-plain-only-515"></a>The principal memory dump file used with MetaPost is the default,
+ <p><a name="index-plain_002emem-524"></a><a name="index-mpost_002emem-525"></a><a name="index-mem-files_002c-plain-only-526"></a>The principal memory dump file used with MetaPost is the default,
<samp><span class="file">plain.mem</span></samp>, also known as <samp><span class="file">mpost.mem</span></samp> (again, see <a href="#Memory-dumps">Memory dumps</a>). It is created by default during installation, but you can
also do so by hand if necessary (e.g., if a <samp><span class="file">plain.mp</span></samp> update is
issued):
@@ -2402,7 +2467,7 @@ Then install the resulting <samp><span class="file">plain.mem</span></samp> in &
(<samp><span class="file">/usr/local/share/texmf/web2c</span></samp> by default), and link
<samp><span class="file">mpost.mem</span></samp> to it.
- <p><a name="index-Metafont_002c-compatibility-in-MetaPost-516"></a><a name="index-plain-Metafont_002c-compatibility-in-MetaPost-517"></a><a name="index-MetaPost-and-plain-Metafont-compatibility-518"></a><a name="index-mfplain_002emem-519"></a>MetaPost also provides a mem file with all the features of plain
+ <p><a name="index-Metafont_002c-compatibility-in-MetaPost-527"></a><a name="index-plain-Metafont_002c-compatibility-in-MetaPost-528"></a><a name="index-MetaPost-and-plain-Metafont-compatibility-529"></a><a name="index-mfplain_002emem-530"></a>MetaPost also provides a mem file with all the features of plain
Metafont, called <samp><span class="file">mfplain.mem</span></samp>. You can create that in the same
way; just replace &lsquo;<samp><span class="samp">plain</span></samp>&rsquo; in the above command with &lsquo;<samp><span class="samp">mfplain</span></samp>&rsquo;.
<samp><span class="file">mfplain.mem</span></samp> file lets you directly process Metafont source files
@@ -2410,126 +2475,24 @@ 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>).
- <p><a name="index-metafun_002emp-520"></a><a name="index-MetaFun_002c-enhanced-MetaPost-521"></a><a name="index-Pragma-ADE-522"></a>Another MetaPost mem file, named MetaFun, provides many advanced
+ <p><a name="index-metafun_002emp-531"></a><a name="index-MetaFun_002c-enhanced-MetaPost-532"></a><a name="index-Pragma-ADE-533"></a>Another MetaPost mem file, named MetaFun, provides many advanced
features. It was developed and maintained by Pragma ADE. The home
page for MetaFun, other MetaPost-related things, and lots more from
Pragma: <a href="http://www.pragma-ade.com/">http://www.pragma-ade.com/</a>.
<div class="node">
+<a name="dvitomp-invocation"></a>
<p><hr>
-<a name="makempx-invocation"></a>
-Next:&nbsp;<a rel="next" accesskey="n" href="#dvitomp-invocation">dvitomp invocation</a>,
Previous:&nbsp;<a rel="previous" accesskey="p" href="#Initial-MetaPost">Initial MetaPost</a>,
Up:&nbsp;<a rel="up" accesskey="u" href="#MetaPost">MetaPost</a>
</div>
-<h3 class="section">6.3 MakeMPX: Support MetaPost labels</h3>
-
-<p><a name="index-makempx-523"></a><a name="index-MetaPost-labels-524"></a><a name="index-captions_002c-for-MetaPost-525"></a><a name="index-labels_002c-for-MetaPost-526"></a>
-In MetaPost, labels can be typeset using any document processor; the
-Web2c implementation supports TeX and Troff. MakeMPX translates the
-labels from the typesetting language back into low-level MetaPost
-commands in a so-called <dfn>mpx file</dfn>, so text can be manipulated like
-other graphic objects. It is invoked automatically by MetaPost.
-Synopsis:
-
-<pre class="example"> makempx [-troff] <var>mpfile</var> <var>mpxfile</var>
-</pre>
- <p class="noindent">The input comes from <var>mpfile</var> (no path searching is done), and the
-output goes to <var>mpxfile</var>. However, if the file <var>mpxfile</var>
-already exists, and is newer than <var>mpfile</var>, then nothing is done
-(presumably the file is up-to-date).
-
- <p>Otherwise:
- <ol type=1 start=1>
-<li><a name="index-MPto_002c-invoked-by-MakeMPX-527"></a>MPto is run to extract the label text from the
-MetaPost source file <var>mpfile</var> (see <a href="#mpto-invocation">mpto invocation</a>).
-
- <li>The typesetting program itself is run, either TeX or Troff (see
-below). If TeX, and the file named by the <code>MPTEXPRE</code>
-environment variable exists (<samp><span class="file">mptexpre.tex</span></samp> by default), that file
-is prepended to the input from the MetaPost file.
-
- <li><a name="index-DVItoMP_002c-invoked-by-MakeMPX-528"></a><a name="index-DMP_002c-invoked-by-MakeMPX-529"></a>The typesetter output (a DVI file in the case of TeX, Ditroff output
-for Troff) is translated back to MetaPost, by DVItoMP (see <a href="#dvitomp-invocation">dvitomp invocation</a>) or DMP (see <a href="#dmp-invocation">dmp invocation</a>) respectively.
- </ol>
-
- <p><a name="index-mpxerr_002elog-530"></a><a name="index-mpxerr_002edvi-531"></a><a name="index-mpxerr_002etex-532"></a><a name="index-mpxerr_002et-533"></a><a name="index-mpxerr-534"></a>If any of the above steps fail, for example if there was a typesetting
-mistake in the original <var>mpfile</var>, output may be left in files named
-<samp><span class="file">mpxerr.{log,tex,dvi}</span></samp> (TeX) or <samp><span class="file">mpxerr{,.t}</span></samp> (Troff),
-so you can diagnose the problem.
-
- <p><a name="index-g_t_002dtroff-535"></a><a name="index-prologues-_0040r_007band-Troff-in-MetaPost_007d-536"></a>The &lsquo;<samp><span class="samp">-troff</span></samp>&rsquo; option to MPto selects the Troff commands, rather than
-TeX. MetaPost supplies this automatically if the &lsquo;<samp><span class="samp">-T</span></samp>&rsquo; or
-&lsquo;<samp><span class="samp">-troff</span></samp>&rsquo; option was specified to MetaPost.
-
- <p><a name="index-picture-expressions-537"></a><a name="index-mpx-file_002c-defined-538"></a>The MPX file created by MakeMPX is a sequence of MetaPost picture
-expressions, one for every label in the original MetaPost input file.
+<h3 class="section">6.3 DVItoMP: DVI to MPX conversion</h3>
- <p>The names of the commands run by MakeMPX, and the directory
-added to the shell search <code>PATH</code> for the commands' location, are
-overridden by environment variables. Here is a list:
-
- <dl>
-<dt><code>MAKEMPX_BINDIR</code><a name="index-MAKEMPX_005fBINDIR-539"></a><dd>The directory added to the <code>PATH</code>. Default is the &lsquo;<samp><span class="samp">$(bindir)</span></samp>&rsquo;
-Make directory, which in turn is set from the configure-time
-&lsquo;<samp><span class="samp">--bindir</span></samp>&rsquo;, &lsquo;<samp><span class="samp">--exec-prefix</span></samp>&rsquo; and &lsquo;<samp><span class="samp">--prefix</span></samp>&rsquo; options; if
-nothing else is specified, the default is file &lsquo;<samp><span class="samp">/usr/local</span></samp>&rsquo;.
-
- <br><dt><code>NEWER</code><a name="index-NEWER-540"></a><dd>The command run to determine if <var>mpxfile</var> is out of date with respect
-to <var>mpfile</var>; default is &lsquo;<samp><span class="samp">newer</span></samp>&rsquo;.
-
- <br><dt><code>MPTOTEX</code><a name="index-MPTOTEX-541"></a><dd>The command run to extract MetaPost labels in TeX format; default is
-&lsquo;<samp><span class="samp">mpto -tex</span></samp>&rsquo;.
-
- <br><dt><code>MPTOTR</code><a name="index-MPTOTR-542"></a><dd>Likewise, for Troff; default is &lsquo;<samp><span class="samp">mpto -troff</span></samp>&rsquo;.
-
- <br><dt><code>DVITOMP</code><a name="index-DVITOMP-543"></a><dd>The command run to convert TeX output back to MetaPost; default is
-&lsquo;<samp><span class="samp">dvitomp</span></samp>&rsquo;.
-
- <br><dt><code>DMP</code><a name="index-DMP-544"></a><dd>Likewise, for Troff; default is &lsquo;<samp><span class="samp">dmp</span></samp>&rsquo;.
-
- <br><dt><code>TEX</code><a name="index-TEX-545"></a><dd>The command run to typeset the labels in TeX; the default is
-&lsquo;<samp><span class="samp">etex</span></samp>&rsquo;, set in <samp><span class="file">texmf.cnf</span></samp>. If you use LaTeX, set this to
-<code>latex</code>, and supply an appropriate <code>verbatimtex</code> header in
-the MP source (see <a href="#mpost-invocation">mpost invocation</a>). Or put &lsquo;<samp><span class="samp">%&amp;latex</span></samp>&rsquo; as
-the first line of your LaTeX source.
-
- <br><dt><code>TROFF</code><a name="index-TROFF-546"></a><dd>Likewise, for Troff; default is &lsquo;<samp><span class="samp">'eqn -d\$\$ | troff -Tpost'</span></samp>&rsquo;. You
-may need to replace &lsquo;<samp><span class="samp">-Tpost</span></samp>&rsquo; by &lsquo;<samp><span class="samp">-T</span><var>term</var></samp>&rsquo;, where
-<var>term</var> is the PostScript device name for your Troff implementation,
-e.g., &lsquo;<samp><span class="samp">ps</span></samp>&rsquo; or &lsquo;<samp><span class="samp">psc</span></samp>&rsquo;; see troff(1).
-
- <p>If you change this, you will also need to set the <code>TRFONTS</code>
-environment variable or configuration value to point to the appropriate
-font directory, traditionally <samp><span class="file">/usr/lib/font/dev</span><var>term</var></samp>.
-
- <p>One more complication is whether the troff programs have a &lsquo;<samp><span class="samp">g</span></samp>&rsquo;
-prefix. On Windows, TeX Live supports both ways:
-<samp><span class="file">makempx.exe</span></samp> is built to use <samp><span class="file">gsoelim.exe</span></samp>,
-<samp><span class="file">geqn.exe</span></samp>, and <samp><span class="file">gtroff.exe</span></samp>, while
-<samp><span class="file">makempx-without-g-prefix.exe</span></samp> is built to use <samp><span class="file">soelim.exe</span></samp>,
-<samp><span class="file">eqn.exe</span></samp>, and <samp><span class="file">troff.exe</span></samp>. MetaPost users on Windows using
-troff for their labels should arrange to run the proper binary.
-
- </dl>
-
-<div class="node">
-<p><hr>
-<a name="dvitomp-invocation"></a>
-Next:&nbsp;<a rel="next" accesskey="n" href="#dmp-invocation">dmp invocation</a>,
-Previous:&nbsp;<a rel="previous" accesskey="p" href="#makempx-invocation">makempx invocation</a>,
-Up:&nbsp;<a rel="up" accesskey="u" href="#MetaPost">MetaPost</a>
-
-</div>
-
-<h3 class="section">6.4 DVItoMP: DVI to MPX conversion</h3>
-
-<p><a name="index-dvitomp-547"></a><a name="index-DVI-files_002c-converting-to-MPX-548"></a><a name="index-MPX-files_002c-converting-from-DVI-files-549"></a>
+<p><a name="index-dvitomp-534"></a><a name="index-DVI-files_002c-converting-to-MPX-535"></a><a name="index-MPX-files_002c-converting-from-DVI-files-536"></a>
DVItoMP converts DVI files into low-level MetaPost commands in a
-so-called MPX file. This program is generally invoked only by MakeMPX
-(see <a href="#makempx-invocation">makempx invocation</a>). Synopsis:
+so-called MPX file. Synopsis:
<pre class="example"> dvitomp <var>dvifile</var>[.dvi] [<var>mpxfile</var>[.mpx]]
</pre>
@@ -2537,171 +2500,15 @@ so-called MPX file. This program is generally invoked only by MakeMPX
<var>dvifile</var> extended with <samp><span class="file">.mpx</span></samp>, e.g., &lsquo;<samp><span class="samp">dvitomp
/wherever/foo.dvi</span></samp>&rsquo; creates <samp><span class="file">./foo.mpx</span></samp>.
- <p><a name="index-color_002c-in-DVItoMP-550"></a>DVItoMP supports Dvips-style color specials, such as &lsquo;<samp><span class="samp">color push
+ <p><a name="index-color_002c-in-DVItoMP-537"></a>DVItoMP supports Dvips-style color specials, such as &lsquo;<samp><span class="samp">color push
</span><var>name</var></samp>&rsquo; and &lsquo;<samp><span class="samp">color pop</span></samp>&rsquo;, outputting them as <code>withcolor</code>
MetaPost commands.
<p>The only options are &lsquo;<samp><span class="samp">-help</span></samp>&rsquo; and &lsquo;<samp><span class="samp">-version</span></samp>&rsquo; (see <a href="#Common-options">Common options</a>).
<div class="node">
-<p><hr>
-<a name="dmp-invocation"></a>
-Next:&nbsp;<a rel="next" accesskey="n" href="#mpto-invocation">mpto invocation</a>,
-Previous:&nbsp;<a rel="previous" accesskey="p" href="#dvitomp-invocation">dvitomp invocation</a>,
-Up:&nbsp;<a rel="up" accesskey="u" href="#MetaPost">MetaPost</a>
-
-</div>
-
-<h3 class="section">6.5 DMP: Ditroff to MPX conversion</h3>
-
-<p><a name="index-DMP-551"></a><a name="index-ditroff-output_002c-converting-to-MPX-552"></a><a name="index-MPX-files_002c-creating-from-ditroff-output-553"></a>
-DMP converts device-independent Troff (ditroff) output files into
-low-level MetaPost commands in a so-called MPX file. This program is
-generally invoked by MakeMPX (see <a href="#makempx-invocation">makempx invocation</a>). Synopsis:
-
-<pre class="example"> dmp [<var>ditroff-file</var> [<var>mpxfile</var>]]
-</pre>
- <p class="noindent">If <var>ditroff-file</var> is not specified, input comes from standard input;
-and if <var>mpxfile</var> is not specified, output goes to standard output.
-
- <p><a name="index-dpost-554"></a><a name="index-D-_0040var_007bc_007d-_0040r_007bditroff-graphics_007d-555"></a><a name="index-x-X-_0040r_007bditroff-device-control_007d-556"></a><a name="index-SetColor-_0040r_007bditroff-command_007d-557"></a><a name="index-BeginPath-_0040r_007bditroff-command_007d-558"></a><a name="index-DrawPath-_0040r_007bditroff-command_007d-559"></a>DMP was written to process the output of a Troff pipeline fed the output
-of <code>mpto -troff</code> (see <a href="#mpto-invocation">mpto invocation</a>). DMP understands all
-the &lsquo;<samp><span class="samp">D</span><var>c</var></samp>&rsquo; graphics functions that <code>dpost</code> does, but it
-ignores &lsquo;<samp><span class="samp">x X</span></samp>&rsquo; device control functions such as &lsquo;<samp><span class="samp">x X
-SetColor:...</span></samp>&rsquo;, &lsquo;<samp><span class="samp">x X BeginPath:</span></samp>&rsquo;, and &lsquo;<samp><span class="samp">x X
-DrawPath:...</span></samp>&rsquo;.
-
- <p><a name="index-MPSUPPORT-560"></a>The available font names are defined in the support file
-<samp><span class="file">trfonts.map</span></samp>, which DMP looks for along the <code>MPSUPPORT</code> path.
-
- <p><a name="index-trchars_002eadj-561"></a>Another support file <samp><span class="file">trchars.adj</span></samp>, also looked for along the
-<code>MPSUPPORT</code> path, contains a character adjustment table which
-should reflect the shift amounts found in the standard PostScript
-prologue for Troff and dpost found in the <code>TRFONTS</code> directory.
-Such an adjustment table is unnecessary for some Troff implementations,
-in which case <samp><span class="file">trchars.adj</span></samp> should be replaced by an empty
-file&mdash;but it must still exist.
-
- <p>DMP was written for one particular Troff implementation, and it
-unfortunately has many built-in assumptions about the output and fonts
-file formats used by Troff, which may not be satisfied in other
-environments. In particular, GNU groff uses some extensions in its file
-formats described in groff_font(5) and groff_out(5) which make its
-output completely unusable for DMP. On the other hand, the Troff
-version found in Sun Solaris 2.x, and perhaps other systems derived from
-System V R4, works fine with the default settings.
-
- <p>If you run into trouble and want to adapt DMP to other systems,
-you might have to try the following (this is primarily for hackers):
-
- <ul>
-<li>If DMP complains about a missing font table (e.g., &lsquo;<samp><span class="samp">Cannot find
-TR</span></samp>&rsquo;), your Troff may not support the device &lsquo;<samp><span class="samp">post</span></samp>&rsquo;.
-
- <p>Check troff(1) for the devices supported by your Troff and set the
-<code>TROFF</code> environment variable appropriately (see above). Also,
-locate the appropriate font directory and set the <code>TRFONTS</code>
-variable as needed.
-
- <li>If DMP complains about a missing font description file (e.g., &lsquo;<samp><span class="samp">Font
-TR was not in map file</span></samp>&rsquo;), your version of Troff may be using internal
-font names different from those in the distributed <samp><span class="file">trfonts.map</span></samp>;
-e.g., TR and TI instead of R and I for Times-Roman and Times-Italic.
-
- <p><a name="index-trchars_002eadj-562"></a>In this case, you may have to adapt <samp><span class="file">trfonts.map</span></samp> and perhaps also
-<samp><span class="file">trchars.adj</span></samp> in the MetaPost support directory
-(<samp><span class="file">texmf/metapost/support</span></samp> by default).
-
- <li>If DMP still complains that it cannot parse the font description files
-or the Troff output (e.g., &lsquo;<samp><span class="samp">TR has a bad line in its description
-file</span></samp>&rsquo;, you are probably out of luck and have to hack the DMP program (in
-<samp><span class="file">web2c/mpware/dmp.c</span></samp>).
-
- <p>Such problems may be caused by subtle differences in the file
-formats, such as use of tabs vs. spaces as field separators
-or decimal vs. octal vs. hex format for font metric data.
-
- <p>A reasonably good description of the expected Troff file formats can be
-found in AT&amp;T technical report CSTR-54 (<cite>Troff User's Manual</cite>,
-Revised 1992). Documentation on the subtle differences in other Troff
-implementation is harder to find except for GNU groff, where it's all
-documented in the above-mentioned groff_font(5) and groff_out(5).
-
- <p>Any contributions to improve the portability of DMP or to make it work
-with GNU groff are welcome, of course.
-
- </ul>
-
- <p><a name="index-dmp_002ec-563"></a><a name="index-Hobby_002c-John-564"></a>(Some of the above description was edited from the <samp><span class="file">dmp.c</span></samp> source
-file, written by John Hobby.)
-
- <p>The only options are &lsquo;<samp><span class="samp">--help</span></samp>&rsquo; and &lsquo;<samp><span class="samp">--version</span></samp>&rsquo; (see <a href="#Common-options">Common options</a>).
-
-<div class="node">
-<p><hr>
-<a name="mpto-invocation"></a>
-Next:&nbsp;<a rel="next" accesskey="n" href="#newer-invocation">newer invocation</a>,
-Previous:&nbsp;<a rel="previous" accesskey="p" href="#dmp-invocation">dmp invocation</a>,
-Up:&nbsp;<a rel="up" accesskey="u" href="#MetaPost">MetaPost</a>
-
-</div>
-
-<h3 class="section">6.6 MPto: Extract labels from MetaPost input</h3>
-
-<p><a name="index-MPto-565"></a><a name="index-labels_002c-extracting-from-MetaPost-input-566"></a><a name="index-captions_002c-extracting-from-MetaPost-input-567"></a><a name="index-text_002c-extracting-from-MetaPost-input-568"></a><a name="index-MetaPost-input_002c-extracting-labels-from-569"></a>
-<a name="index-btex-_0040r_007band-label-extraction_007d-570"></a><a name="index-etex-_0040r_007band-label-extraction_007d-571"></a><a name="index-verbatimtex-_0040r_007bMetaPost-command_007d-572"></a>MPto extracts the labels from a MetaPost input file; this is the
-contents of any <code>btex...etex</code> and <code>verbatimtex...etex</code>
-sections. This program is generally invoked by MakeMPX (see <a href="#makempx-invocation">makempx invocation</a>). Synopsis:
-
-<pre class="example"> mpto [<var>option</var>]... <var>mpfile</var>
-</pre>
- <p class="noindent">The input comes from <var>mpfile</var>; no path searching is done. The
-output goes to standard output. Leading and trailing spaces and tabs
-are removed, and various predefined typesetter commands are included at
-the beginning of and end of the file and of each section.
-
- <p>The program accepts the following options, as well as the standard
-&lsquo;<samp><span class="samp">-help</span></samp>&rsquo; and &lsquo;<samp><span class="samp">-version</span></samp>&rsquo; (see <a href="#Common-options">Common options</a>):
- <dl>
-<dt>&lsquo;<samp><span class="samp">-troff</span></samp>&rsquo;<dd><a name="index-g_t_002dtroff-573"></a>Surround the MetaPost sections with Troff commands.
-
- <br><dt>&lsquo;<samp><span class="samp">-tex</span></samp>&rsquo;<dd><a name="index-g_t_002dtex-574"></a>Surround the MetaPost sections with TeX commands. This is the default.
-</dl>
-
-<div class="node">
-<p><hr>
-<a name="newer-invocation"></a>
-Previous:&nbsp;<a rel="previous" accesskey="p" href="#mpto-invocation">mpto invocation</a>,
-Up:&nbsp;<a rel="up" accesskey="u" href="#MetaPost">MetaPost</a>
-
-</div>
-
-<h3 class="section">6.7 Newer: Compare file modification times</h3>
-
-<p><a name="index-newer-_0040r_007bfile-comparison_007d-575"></a><a name="index-comparing-file-modification-times-576"></a><a name="index-file-mtimes_002c-comparing-577"></a><a name="index-mtimes-of-files_002c-comparing-578"></a><a name="index-older_002dthan_002c-file-comparisons-579"></a>
-Newer compares file modification times. Synopsis:
-
-<pre class="example"> newer <var>src1</var> [ <var>src2</var> ... <var>srcN</var> ] <var>target</var>
-</pre>
- <p class="noindent">Newer exits successfully if the files <var>src1</var> ... <var>srcN</var> exist
-and at least one of them is not older than <var>dependent</var>, i.e., the
-modification time (mtime) of at least one of the source files
-is greater than or the same as that of <var>dependent</var>. Newer also
-exits successfully if the file <var>dependent</var> doesn't exist.
-See <a href="libc.html#Attribute-Meanings">Attribute Meanings</a>.
-
- <p>The program accepts the following option, as well as the standard
-&lsquo;<samp><span class="samp">--help</span></samp>&rsquo; and &lsquo;<samp><span class="samp">--version</span></samp>&rsquo; (see <a href="#Common-options">Common options</a>):
- <dl>
-<dt>&lsquo;<samp><span class="samp">--quiet</span></samp>&rsquo;<dd><a name="index-g_t_002d_002dquiet-_0028newer_0029-580"></a>Return result only, do not print any output.
-<br><dt>&lsquo;<samp><span class="samp">--verbose</span></samp>&rsquo;<dd><a name="index-g_t_002d_002dverbose-_0028newer_0029-581"></a>List missing source files to STDERR. This is the default.
-</dl>
-
- <p>This is used by MakeMPX (see <a href="#makempx-invocation">makempx invocation</a>).
-
-<div class="node">
-<p><hr>
<a name="BibTeX"></a>
+<p><hr>
Next:&nbsp;<a rel="next" accesskey="n" href="#WEB">WEB</a>,
Previous:&nbsp;<a rel="previous" accesskey="p" href="#MetaPost">MetaPost</a>,
Up:&nbsp;<a rel="up" accesskey="u" href="#Top">Top</a>
@@ -2710,7 +2517,7 @@ Up:&nbsp;<a rel="up" accesskey="u" href="#Top">Top</a>
<h2 class="chapter">7 BibTeX: Bibliographies</h2>
-<p><a name="index-bibliographies_002c-creating-582"></a><a name="index-Bib_0040TeX_007b_007d-583"></a>
+<p><a name="index-bibliographies_002c-creating-538"></a><a name="index-Bib_0040TeX_007b_007d-539"></a>
BibTeX automates much of the job of typesetting bibliographies, and
makes bibliography entries reusable in many different contexts.
@@ -2720,8 +2527,8 @@ makes bibliography entries reusable in many different contexts.
</ul>
<div class="node">
-<p><hr>
<a name="bibtex-invocation"></a>
+<p><hr>
Next:&nbsp;<a rel="next" accesskey="n" href="#Basic-BibTeX-style-files">Basic BibTeX style files</a>,
Up:&nbsp;<a rel="up" accesskey="u" href="#BibTeX">BibTeX</a>
@@ -2729,8 +2536,8 @@ Up:&nbsp;<a rel="up" accesskey="u" href="#BibTeX">BibTeX</a>
<h3 class="section">7.1 BibTeX invocation</h3>
-<p><a name="index-bibtex-584"></a>
-<a name="index-g_t_002ebbl-_0040r_007bbibliography-files_007d-585"></a><a name="index-g_t_002eaux-_0040r_007bcross_002dreference-files_007d-586"></a><a name="index-g_t_002ebib-_0040r_007bbibliography-databases_007d-587"></a>BibTeX creates a printable bibliography (<samp><span class="file">.bbl</span></samp>) file from
+<p><a name="index-bibtex-540"></a>
+<a name="index-g_t_002ebbl-_0040r_007bbibliography-files_007d-541"></a><a name="index-g_t_002eaux-_0040r_007bcross_002dreference-files_007d-542"></a><a name="index-g_t_002ebib-_0040r_007bbibliography-databases_007d-543"></a>BibTeX creates a printable bibliography (<samp><span class="file">.bbl</span></samp>) file from
references in a <samp><span class="file">.aux</span></samp> file, generally written by TeX or
LaTeX. The <samp><span class="file">.bbl</span></samp> file is then incorporated on a subsequent
run. The basic bibliographic information comes from <samp><span class="file">.bib</span></samp> files,
@@ -2739,12 +2546,12 @@ of the <samp><span class="file">.bbl</span></samp> file. Synopsis:
<pre class="example"> bibtex [<var>option</var>]... <var>auxfile</var>[.aux]
</pre>
- <p><a name="index-g_t_002eblg-_0040r_007bBib_0040TeX_007b_007d-log-file_007d-588"></a><a name="index-log-file_002c-Bib_0040TeX_007b_007d-589"></a>The output goes to the basename of <var>auxfile</var> extended with
+ <p><a name="index-g_t_002eblg-_0040r_007bBib_0040TeX_007b_007d-log-file_007d-544"></a><a name="index-log-file_002c-Bib_0040TeX_007b_007d-545"></a>The output goes to the basename of <var>auxfile</var> extended with
<samp><span class="file">.bbl</span></samp>; for example, &lsquo;<samp><span class="samp">bibtex /wherever/foo.aux</span></samp>&rsquo; creates
<samp><span class="file">./foo.bbl</span></samp>. BibTeX also writes a log file to the basename of
<var>auxfile</var> extended with &lsquo;<samp><span class="samp">.blg</span></samp>&rsquo;.
- <p><a name="index-g_t_005cbibliography-590"></a><a name="index-g_t_005cbibliographystyle-591"></a><a name="index-TEXBIB_0040r_007b_002c-search-path-for-bib-files_007d-592"></a><a name="index-BIBINPUTS_0040r_007b_002c-search-path-for-bib-files_007d-593"></a><a name="index-BSTINPUTS_0040r_007b_002c-search-path-for-bst-files_007d-594"></a>The names of the <samp><span class="file">.bib</span></samp> and <samp><span class="file">.bst</span></samp> files are specified in the
+ <p><a name="index-g_t_005cbibliography-546"></a><a name="index-g_t_005cbibliographystyle-547"></a><a name="index-TEXBIB_0040r_007b_002c-search-path-for-bib-files_007d-548"></a><a name="index-BIBINPUTS_0040r_007b_002c-search-path-for-bib-files_007d-549"></a><a name="index-BSTINPUTS_0040r_007b_002c-search-path-for-bst-files_007d-550"></a>The names of the <samp><span class="file">.bib</span></samp> and <samp><span class="file">.bst</span></samp> files are specified in the
<samp><span class="file">.aux</span></samp> file as well, via the <samp><span class="file">\bibliography</span></samp> and
<samp><span class="file">\bibliographystyle</span></samp> (La)TeX macros. BibTeX searches for
<samp><span class="file">.bib</span></samp> files using the <code>BIBINPUTS</code> and <code>TEXBIB</code> paths,
@@ -2754,9 +2561,9 @@ and for <samp><span class="file">.bst</span></samp> files using <code>BSTINPUTS<
<p>The program accepts the following options, as well as the standard
&lsquo;<samp><span class="samp">-help</span></samp>&rsquo; and &lsquo;<samp><span class="samp">-version</span></samp>&rsquo; (see <a href="#Common-options">Common options</a>):
<dl>
-<dt>&lsquo;<samp><span class="samp">-terse</span></samp>&rsquo;<dd><a name="index-g_t_002dterse-595"></a><a name="index-terse-output-596"></a><a name="index-verbose-Bib_0040TeX_007b_007d-output_002c-suppressing-597"></a>Suppress the program banner and progress reports normally output.
+<dt>&lsquo;<samp><span class="samp">-terse</span></samp>&rsquo;<dd><a name="index-g_t_002dterse-551"></a><a name="index-terse-output-552"></a><a name="index-verbose-Bib_0040TeX_007b_007d-output_002c-suppressing-553"></a>Suppress the program banner and progress reports normally output.
- <br><dt>&lsquo;<samp><span class="samp">-min-crossrefs=</span><var>n</var></samp>&rsquo;<dd><a name="index-g_t_002dmin_002dcrossrefs_003d_0040var_007bn_007d-598"></a><a name="index-cross_002dreferenced-bibliography-items-599"></a><a name="index-bibliography-items_002c-cross_002dreferenced-600"></a>If at least <var>n</var> (2 by default) bibliography entries refer to another
+ <br><dt>&lsquo;<samp><span class="samp">-min-crossrefs=</span><var>n</var></samp>&rsquo;<dd><a name="index-g_t_002dmin_002dcrossrefs_003d_0040var_007bn_007d-554"></a><a name="index-cross_002dreferenced-bibliography-items-555"></a><a name="index-bibliography-items_002c-cross_002dreferenced-556"></a>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
<tt>.bbl</tt> file, even if it was not explicitly referenced in the <tt>.aux</tt>
file. For example, <var>e</var> might be a conference proceedings as a whole,
@@ -2768,22 +2575,22 @@ large number.
<p>See also:
<dl>
-<dt><samp><span class="file">btxdoc.tex</span></samp><dd><a name="index-btxdoc_002etex-601"></a>Basic LaTeXable documentation for general BibTeX users.
+<dt><samp><span class="file">btxdoc.tex</span></samp><dd><a name="index-btxdoc_002etex-557"></a>Basic LaTeXable documentation for general BibTeX users.
- <br><dt><samp><span class="file">btxhak.tex</span></samp><dd><a name="index-btxhak_002etex-602"></a><a name="index-style-design_002c-for-Bib_0040TeX_007b_007d-603"></a>LaTeXable documentation for style designers.
+ <br><dt><samp><span class="file">btxhak.tex</span></samp><dd><a name="index-btxhak_002etex-558"></a><a name="index-style-design_002c-for-Bib_0040TeX_007b_007d-559"></a>LaTeXable documentation for style designers.
- <br><dt><samp><span class="file">btxdoc.bib</span></samp><dd><a name="index-btxdoc_002ebib-604"></a>BibTeX database file for the two above documents.
+ <br><dt><samp><span class="file">btxdoc.bib</span></samp><dd><a name="index-btxdoc_002ebib-560"></a>BibTeX database file for the two above documents.
- <br><dt><samp><span class="file">xampl.bib</span></samp><dd><a name="index-xampl_002ebib-605"></a>Example database file with all the standard entry types.
+ <br><dt><samp><span class="file">xampl.bib</span></samp><dd><a name="index-xampl_002ebib-561"></a>Example database file with all the standard entry types.
- <br><dt><samp><span class="file"><a href="ftp://ftp.math.utah.edu/pub/tex/bib/">ftp://ftp.math.utah.edu/pub/tex/bib/</a></span></samp><dd><a name="index-ftp_002emath_002eutah_002eedu-606"></a><a name="index-Bib_0040TeX_007b_007d-collection-607"></a><a name="index-TUGboat-bibliography-608"></a><a name="index-g_t_0040TeX_007b_007d_002c-bibliographies-for-609"></a>A very large <samp><span class="file">.bib</span></samp> and <samp><span class="file">.bst</span></samp> collection, including
+ <br><dt><samp><span class="file"><a href="ftp://ftp.math.utah.edu/pub/tex/bib/">ftp://ftp.math.utah.edu/pub/tex/bib/</a></span></samp><dd><a name="index-ftp_002emath_002eutah_002eedu-562"></a><a name="index-Bib_0040TeX_007b_007d-collection-563"></a><a name="index-TUGboat-bibliography-564"></a><a name="index-g_t_0040TeX_007b_007d_002c-bibliographies-for-565"></a>A very large <samp><span class="file">.bib</span></samp> and <samp><span class="file">.bst</span></samp> collection, including
references for all the standard TeX books and a complete bibliography
for TUGboat.
</dl>
<div class="node">
-<p><hr>
<a name="Basic-BibTeX-style-files"></a>
+<p><hr>
Previous:&nbsp;<a rel="previous" accesskey="p" href="#bibtex-invocation">bibtex invocation</a>,
Up:&nbsp;<a rel="up" accesskey="u" href="#BibTeX">BibTeX</a>
@@ -2791,42 +2598,42 @@ Up:&nbsp;<a rel="up" accesskey="u" href="#BibTeX">BibTeX</a>
<h3 class="section">7.2 Basic BibTeX style files</h3>
-<p><a name="index-basic-Bib_0040TeX_007b_007d-style-files-610"></a><a name="index-Bib_0040TeX_007b_007d-style-files-611"></a>
+<p><a name="index-basic-Bib_0040TeX_007b_007d-style-files-566"></a><a name="index-Bib_0040TeX_007b_007d-style-files-567"></a>
Here are descriptions of the four standard and four semi-standard basic
BibTeX styles. <samp><var>CTAN:</var><span class="file">/biblio/bibtex</span></samp> contains these and
many more (for CTAN info, see <a href="kpathsea.html#unixtex_002eftp">unixtex.ftp</a>).
<dl>
-<dt><code>plain</code><dd><a name="index-plain_002ebst-612"></a>Sorts entries alphabetically, with numeric labels. Generally formatted
+<dt><code>plain</code><dd><a name="index-plain_002ebst-568"></a>Sorts entries alphabetically, with numeric labels. Generally formatted
according to van Leunen's <cite>A Handbook for Scholars</cite>. The other
style files listed here are based on <code>plain</code>.
- <br><dt><code>abbrv</code><dd><a name="index-abbrv_002ebst-613"></a>First names, month names, and journal names are abbreviated.
+ <br><dt><code>abbrv</code><dd><a name="index-abbrv_002ebst-569"></a>First names, month names, and journal names are abbreviated.
- <br><dt><code>acm</code><dd><a name="index-acm_002ebst-614"></a>Names are printed in small caps.
+ <br><dt><code>acm</code><dd><a name="index-acm_002ebst-570"></a>Names are printed in small caps.
- <br><dt><code>alpha</code><dd><a name="index-alpha_002ebst-615"></a>Alphanumeric labels, e.g., &lsquo;<samp><span class="samp">Knu66</span></samp>&rsquo;.
+ <br><dt><code>alpha</code><dd><a name="index-alpha_002ebst-571"></a>Alphanumeric labels, e.g., &lsquo;<samp><span class="samp">Knu66</span></samp>&rsquo;.
- <br><dt><code>apalike</code><dd><a name="index-apalike_002ebst-616"></a>No labels at all; instead, the year appears in parentheses after the author.
+ <br><dt><code>apalike</code><dd><a name="index-apalike_002ebst-572"></a>No labels at all; instead, the year appears in parentheses after the author.
Use this in conjunction with <samp><span class="file">apalike.tex</span></samp> (plain TeX) or
<samp><span class="file">apalike.sty</span></samp> (LaTeX), which also changes the citations in the
text to be &lsquo;<samp><span class="samp">(</span><var>author</var><span class="samp">, </span><var>year</var><span class="samp">)</span></samp>&rsquo;.
- <br><dt><code>ieeetr</code><dd><a name="index-ieeetr_002ebst-617"></a>Numeric labels, entries in citation order, <span class="sc">ieee</span> abbreviations,
+ <br><dt><code>ieeetr</code><dd><a name="index-ieeetr_002ebst-573"></a>Numeric labels, entries in citation order, <span class="sc">ieee</span> abbreviations,
article titles in quotes.
- <br><dt><code>siam</code><dd><a name="index-siam_002ebst-618"></a>Numeric labels, alphabetic order, <cite>Math. Reviews</cite>
+ <br><dt><code>siam</code><dd><a name="index-siam_002ebst-574"></a>Numeric labels, alphabetic order, <cite>Math. Reviews</cite>
abbreviations, names in small caps.
- <br><dt><code>unsrt</code><dd><a name="index-unsrt_002ebst-619"></a>Lists entries in citation order, i.e., unsorted.
+ <br><dt><code>unsrt</code><dd><a name="index-unsrt_002ebst-575"></a>Lists entries in citation order, i.e., unsorted.
<br><dt><code>btxbst.doc</code><dd>The template file and documentation for the standard styles.
</dl>
<div class="node">
-<p><hr>
<a name="WEB"></a>
+<p><hr>
Next:&nbsp;<a rel="next" accesskey="n" href="#DVI-utilities">DVI utilities</a>,
Previous:&nbsp;<a rel="previous" accesskey="p" href="#BibTeX">BibTeX</a>,
Up:&nbsp;<a rel="up" accesskey="u" href="#Top">Top</a>
@@ -2835,16 +2642,15 @@ Up:&nbsp;<a rel="up" accesskey="u" href="#Top">Top</a>
<h2 class="chapter">8 WEB: Literate programming</h2>
-<p><a name="index-WEB-620"></a><a name="index-literate-programming-621"></a>
-<a name="index-litprog_0040_0040shsu_002eedu-622"></a><dfn>WEB</dfn> languages allow you to write a single source file that can
+<p><a name="index-WEB-576"></a><a name="index-literate-programming-577"></a>
+<dfn>WEB</dfn> languages allow you to write a single source file that can
produce both a compilable program and a well-formatted document
describing the program in as much detail as you wish to prepare.
Writing in this kind of dual-purpose language is called <dfn>literate
programming</dfn>. (The Usenet newsgroup <samp><span class="file">comp.programming.literate</span></samp>
-and the mailing list <a href="mailto:litprog@shsu.edu">litprog@shsu.edu</a> are devoted to this
-subject; they are gatewayed to each other.)
+is devoted to this subject.)
- <p><a name="index-webman_002etex-623"></a><a name="index-Spiderweb-624"></a><a name="index-Cweb-625"></a><a name="index-CWEB-626"></a><a name="index-Awk_002c-WEB-for-627"></a><a name="index-Ada_002c-WEB-for-628"></a><a name="index-Troff_002c-WEB-for-629"></a>WEB-like languages have been implemented with many pairs of base
+ <p><a name="index-webman_002etex-578"></a><a name="index-Spiderweb-579"></a><a name="index-Cweb-580"></a><a name="index-CWEB-581"></a><a name="index-Awk_002c-WEB-for-582"></a><a name="index-Ada_002c-WEB-for-583"></a><a name="index-Troff_002c-WEB-for-584"></a>WEB-like languages have been implemented with many pairs of base
languages: Cweb provides C and Troff (see <a href="#References">References</a>); CWEB provides
C and TeX (<samp><var>CTAN:</var><span class="file">/web/c_cpp/cweb</span></samp>); Spiderweb provides C,
C++, Awk, Ada, many others, and TeX
@@ -2864,8 +2670,8 @@ which is included in the <a href="ftp://ftp.tug.org/tex/lib.tar.gz">ftp://ftp.tu
</ul>
<div class="node">
-<p><hr>
<a name="tangle-invocation"></a>
+<p><hr>
Next:&nbsp;<a rel="next" accesskey="n" href="#weave-invocation">weave invocation</a>,
Up:&nbsp;<a rel="up" accesskey="u" href="#WEB">WEB</a>
@@ -2873,18 +2679,18 @@ Up:&nbsp;<a rel="up" accesskey="u" href="#WEB">WEB</a>
<h3 class="section">8.1 Tangle: Translate WEB to Pascal</h3>
-<p><a name="index-tangle-630"></a><a name="index-Pascal_002c-creating-from-WEB-631"></a><a name="index-WEB-programs_002c-compiling-632"></a>
+<p><a name="index-tangle-585"></a><a name="index-Pascal_002c-creating-from-WEB-586"></a><a name="index-WEB-programs_002c-compiling-587"></a>
Tangle creates a compilable Pascal program from a WEB source file
(see <a href="#WEB">WEB</a>). Synopsis:
<pre class="example"> tangle [<var>option</var>]... <var>webfile</var>[.web] [<var>changefile</var>[.ch]]
</pre>
- <p><a name="index-change-files_002c-and-Tangle-633"></a>The Pascal output is written to the basename of <var>webfile</var> extended
+ <p><a name="index-change-files_002c-and-Tangle-588"></a>The Pascal output is written to the basename of <var>webfile</var> extended
with &lsquo;<samp><span class="samp">.p</span></samp>&rsquo;; for example, &lsquo;<samp><span class="samp">tangle /wherever/foo.web</span></samp>&rsquo; creates
<samp><span class="file">./foo.p</span></samp>. Tangle applies <var>changefile</var> to <var>webfile</var> before
writing the output; by default, there is no change file.
- <p><a name="index-pool-file_002c-writing-634"></a><a name="index-string-pool_002c-writing-635"></a>If the program makes use of the WEB string facility, Tangle writes the
+ <p><a name="index-pool-file_002c-writing-589"></a><a name="index-string-pool_002c-writing-590"></a>If the program makes use of the WEB string facility, Tangle writes the
string pool to the basename of <var>webfile</var> extended with &lsquo;<samp><span class="samp">.pool</span></samp>&rsquo;.
<p>The Pascal output is packed into lines of 72 characters or less, with
@@ -2895,20 +2701,20 @@ semicolons when this can be done conveniently.
&lsquo;<samp><span class="samp">--help</span></samp>&rsquo; and &lsquo;<samp><span class="samp">--version</span></samp>&rsquo; (see <a href="#Common-options">Common options</a>):
<dl>
-<dt>&lsquo;<samp><span class="samp">-length=</span><var>number</var></samp>&rsquo;<dd><a name="index-g_t_002dlength_003d_0040var_007bnumber_007d-636"></a><a name="index-identifier-length-637"></a>The number of characters that are considered significant in an
+<dt>&lsquo;<samp><span class="samp">-length=</span><var>number</var></samp>&rsquo;<dd><a name="index-g_t_002dlength_003d_0040var_007bnumber_007d-591"></a><a name="index-identifier-length-592"></a>The number of characters that are considered significant in an
identifier. Whether underline characters are counted depends on the
&lsquo;<samp><span class="samp">-underline</span></samp>&rsquo; option. The default value is 32, the original tangle
used 7, but this proved too restrictive for use by Web2c.
- <br><dt>&lsquo;<samp><span class="samp">-lowercase</span></samp>&rsquo;<dt>&lsquo;<samp><span class="samp">-mixedcase</span></samp>&rsquo;<dt>&lsquo;<samp><span class="samp">-uppercase</span></samp>&rsquo;<dd><a name="index-g_t_002dlowercase-638"></a><a name="index-g_t_002dmixedcase-639"></a><a name="index-g_t_002duppercase-640"></a><a name="index-identifier-case-641"></a>These options specify the case of identifiers in the output of tangle.
+ <br><dt>&lsquo;<samp><span class="samp">-lowercase</span></samp>&rsquo;<dt>&lsquo;<samp><span class="samp">-mixedcase</span></samp>&rsquo;<dt>&lsquo;<samp><span class="samp">-uppercase</span></samp>&rsquo;<dd><a name="index-g_t_002dlowercase-593"></a><a name="index-g_t_002dmixedcase-594"></a><a name="index-g_t_002duppercase-595"></a><a name="index-identifier-case-596"></a>These options specify the case of identifiers in the output of tangle.
If &lsquo;<samp><span class="samp">-uppercase</span></samp>&rsquo; (&lsquo;<samp><span class="samp">-lowercase</span></samp>&rsquo;) is specified, tangle will
convert all identfiers to uppercase (lowercase). The default is
&lsquo;<samp><span class="samp">-mixedcase</span></samp>&rsquo;, which specifies that the case will not be changed.
- <br><dt>&lsquo;<samp><span class="samp">-underline</span></samp>&rsquo;<dd><a name="index-g_t_002dunderline-642"></a><a name="index-identifiers-with-underlines-643"></a>When this option is given, tangle does not strip underline characters
+ <br><dt>&lsquo;<samp><span class="samp">-underline</span></samp>&rsquo;<dd><a name="index-g_t_002dunderline-597"></a><a name="index-identifiers-with-underlines-598"></a>When this option is given, tangle does not strip underline characters
from identifiers.
- <br><dt>&lsquo;<samp><span class="samp">-loose</span></samp>&rsquo;<dt>&lsquo;<samp><span class="samp">-strict</span></samp>&rsquo;<dd><a name="index-g_t_002dloose-644"></a><a name="index-g_t_002dstrict-645"></a><a name="index-identifier-collisions-646"></a>These options specify how strict tangle must be when checking
+ <br><dt>&lsquo;<samp><span class="samp">-loose</span></samp>&rsquo;<dt>&lsquo;<samp><span class="samp">-strict</span></samp>&rsquo;<dd><a name="index-g_t_002dloose-599"></a><a name="index-g_t_002dstrict-600"></a><a name="index-identifier-collisions-601"></a>These options specify how strict tangle must be when checking
identifiers for equality. The default is &lsquo;<samp><span class="samp">-loose</span></samp>&rsquo;, which means
that tangle will follow the rules set by the case-smashing and underline
options above. If &lsquo;<samp><span class="samp">-strict</span></samp>&rsquo; is set, then identifiers will always
@@ -2918,8 +2724,8 @@ whether they collide.
</dl>
<div class="node">
-<p><hr>
<a name="weave-invocation"></a>
+<p><hr>
Next:&nbsp;<a rel="next" accesskey="n" href="#pooltype-invocation">pooltype invocation</a>,
Previous:&nbsp;<a rel="previous" accesskey="p" href="#tangle-invocation">tangle invocation</a>,
Up:&nbsp;<a rel="up" accesskey="u" href="#WEB">WEB</a>
@@ -2928,7 +2734,7 @@ Up:&nbsp;<a rel="up" accesskey="u" href="#WEB">WEB</a>
<h3 class="section">8.2 Weave: Translate WEB to TeX</h3>
-<p><a name="index-weave-647"></a><a name="index-g_t_0040TeX_007b_007d_002c-creating-from-WEB-648"></a><a name="index-WEB-programs_002c-typesetting-649"></a><a name="index-prettyprinting-WEB-programs-650"></a>
+<p><a name="index-weave-602"></a><a name="index-g_t_0040TeX_007b_007d_002c-creating-from-WEB-603"></a><a name="index-WEB-programs_002c-typesetting-604"></a><a name="index-prettyprinting-WEB-programs-605"></a>
Weave creates a TeX document from a WEB source file (see <a href="#WEB">WEB</a>),
assuming various macros defined in <samp><span class="file">webmac.tex</span></samp>. It takes care of
typographic details such as page layout, indentation, and italicizing
@@ -2937,7 +2743,7 @@ cross-reference information. Synopsis:
<pre class="example"> weave [<var>option</var>]... <var>webfile</var>[.web] [<var>changefile</var>[.ch]]
</pre>
- <p><a name="index-change-files_002c-and-Weave-651"></a>The output is to the basename of <var>webfile</var> extended with
+ <p><a name="index-change-files_002c-and-Weave-606"></a>The output is to the basename of <var>webfile</var> extended with
&lsquo;<samp><span class="samp">.tex</span></samp>&rsquo;; for example, &lsquo;<samp><span class="samp">weave /wherever/foo.web</span></samp>&rsquo; creates
<samp><span class="file">./foo.tex</span></samp>. Weave applies <var>changefile</var> to <var>webfile</var>
before writing the output; by default, there is no change file.
@@ -2945,7 +2751,7 @@ 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><span class="samp">-verbose</span></samp>&rsquo;, &lsquo;<samp><span class="samp">-help</span></samp>&rsquo; and &lsquo;<samp><span class="samp">-version</span></samp>&rsquo; (see <a href="#Common-options">Common options</a>):
<dl>
-<dt>&lsquo;<samp><span class="samp">-x</span></samp>&rsquo;<dd><a name="index-g_t_002dx-652"></a><a name="index-cross_002dreferences_002c-omitting-653"></a><a name="index-CONTENTS_002etex-654"></a><a name="index-webmac_002etex-655"></a>Omit the cross-reference information: the index, the list of WEB module
+<dt>&lsquo;<samp><span class="samp">-x</span></samp>&rsquo;<dd><a name="index-g_t_002dx-607"></a><a name="index-cross_002dreferences_002c-omitting-608"></a><a name="index-CONTENTS_002etex-609"></a><a name="index-webmac_002etex-610"></a>Omit the cross-reference information: the index, the list of WEB module
names, and the table of contents (an empty <samp><span class="file">CONTENTS.tex</span></samp> file will
still be written when the Weave output file is processed by TeX using
the default <samp><span class="file">webmac.tex</span></samp>, though).
@@ -2957,8 +2763,8 @@ changed modules, one can say <code>\let\maybe=\iffalse</code> (usually as the
first change in the change file).
<div class="node">
-<p><hr>
<a name="pooltype-invocation"></a>
+<p><hr>
Previous:&nbsp;<a rel="previous" accesskey="p" href="#weave-invocation">weave invocation</a>,
Up:&nbsp;<a rel="up" accesskey="u" href="#WEB">WEB</a>
@@ -2966,7 +2772,7 @@ Up:&nbsp;<a rel="up" accesskey="u" href="#WEB">WEB</a>
<h3 class="section">8.3 Pooltype: Display WEB pool files</h3>
-<p><a name="index-pooltype-656"></a><a name="index-type-programs_002c-pool-657"></a><a name="index-string-numbers_002c-displaying-658"></a><a name="index-WEB-pool-files_002c-displaying-659"></a>
+<p><a name="index-pooltype-611"></a><a name="index-type-programs_002c-pool-612"></a><a name="index-string-numbers_002c-displaying-613"></a><a name="index-WEB-pool-files_002c-displaying-614"></a>
Pooltype shows the so-called <dfn>string number</dfn> 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
possible input characters. Pooltype primarily serves as an example of
@@ -2989,14 +2795,14 @@ output.
1314: "Using character substitution: "
(23617 characters in all.)
</pre>
- <p><a name="index-representation-of-strings-660"></a><a name="index-string-representation-661"></a>In Metafont and MetaPost, the first 256 characters are actually
+ <p><a name="index-representation-of-strings-615"></a><a name="index-string-representation-616"></a>In Metafont and MetaPost, the first 256 characters are actually
represented as single bytes (i.e., themselves), not in the &lsquo;<samp><span class="samp">^^</span></samp>&rsquo;
notation. Consider Pooltype as showing the results after conversion for
output.
<div class="node">
-<p><hr>
<a name="DVI-utilities"></a>
+<p><hr>
Next:&nbsp;<a rel="next" accesskey="n" href="#Font-utilities">Font utilities</a>,
Previous:&nbsp;<a rel="previous" accesskey="p" href="#WEB">WEB</a>,
Up:&nbsp;<a rel="up" accesskey="u" href="#Top">Top</a>
@@ -3005,7 +2811,7 @@ Up:&nbsp;<a rel="up" accesskey="u" href="#Top">Top</a>
<h2 class="chapter">9 DVI utilities</h2>
-<p><a name="index-DVI-utilities-662"></a>
+<p><a name="index-DVI-utilities-617"></a>
TeX outputs a file in <dfn>DVI</dfn> (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
@@ -3014,7 +2820,7 @@ 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><span class="file">/dviware</span></samp> (for CTAN info, see <a href="kpathsea.html#unixtex_002eftp">unixtex.ftp</a>).
- <p><a name="index-dvitype_002eweb-663"></a><a name="index-DVI-format-definition-664"></a>For the precise definition of the DVI file format, see (for example) the
+ <p><a name="index-dvitype_002eweb-618"></a><a name="index-DVI-format-definition-619"></a>For the precise definition of the DVI file format, see (for example) the
source file <samp><span class="file">web2c/dvitype.web</span></samp>.
<p>The DVI-processing programs in the Web2c distribution are not device
@@ -3026,8 +2832,8 @@ drivers; they perform generic utility functions.
</ul>
<div class="node">
-<p><hr>
<a name="dvicopy-invocation"></a>
+<p><hr>
Next:&nbsp;<a rel="next" accesskey="n" href="#dvitype-invocation">dvitype invocation</a>,
Up:&nbsp;<a rel="up" accesskey="u" href="#DVI-utilities">DVI utilities</a>
@@ -3035,7 +2841,7 @@ Up:&nbsp;<a rel="up" accesskey="u" href="#DVI-utilities">DVI utilities</a>
<h3 class="section">9.1 DVIcopy: Canonicalize virtual font references</h3>
-<p><a name="index-dvicopy-665"></a><a name="index-virtual-fonts_002c-expanding-666"></a>
+<p><a name="index-dvicopy-620"></a><a name="index-virtual-fonts_002c-expanding-621"></a>
DVIcopy reads a DVI file, expands any references to virtual fonts
(see <a href="dvips.html#Virtual-fonts">Virtual fonts</a>) to base fonts, and writes the
resulting DVI file. Thus you can use virtual fonts even if your DVI
@@ -3050,21 +2856,21 @@ standard output if <var>outdvi</var> is not specified.
<p>The program accepts the following options, as well as the standard
&lsquo;<samp><span class="samp">-help</span></samp>&rsquo; and &lsquo;<samp><span class="samp">-version</span></samp>&rsquo; (see <a href="#Common-options">Common options</a>):
<dl>
-<dt>&lsquo;<samp><span class="samp">-magnification=</span><var>integer</var></samp>&rsquo;<dd><a name="index-g_t_002dmagnification_003d_0040var_007binteger_007d-667"></a><a name="index-magnification-668"></a><a name="index-g_t_005cmag-669"></a>Override existing magnification in <var>indvi</var> with <var>integer</var>; 1000
+<dt>&lsquo;<samp><span class="samp">-magnification=</span><var>integer</var></samp>&rsquo;<dd><a name="index-g_t_002dmagnification_003d_0040var_007binteger_007d-622"></a><a name="index-magnification-623"></a><a name="index-g_t_005cmag-624"></a>Override existing magnification in <var>indvi</var> with <var>integer</var>; 1000
specifies no magnification. This is equivalent to setting TeX's
<code>\mag</code> parameter.
- <br><dt>&lsquo;<samp><span class="samp">-max-pages=</span><var>n</var></samp>&rsquo;<dd><a name="index-g_t_002dmax_002dpages_003d_0040var_007bn_007d-670"></a>Process <var>n</var> pages; default is one million.
+ <br><dt>&lsquo;<samp><span class="samp">-max-pages=</span><var>n</var></samp>&rsquo;<dd><a name="index-g_t_002dmax_002dpages_003d_0040var_007bn_007d-625"></a>Process <var>n</var> pages; default is one million.
- <br><dt>&lsquo;<samp><span class="samp">-page-start=</span><var>page-spec</var></samp>&rsquo;<dd><a name="index-g_t_002dpage_002dstart_003d_0040var_007bpage_002dspec_007d-671"></a><a name="index-starting-page-672"></a><a name="index-page_002c-starting-673"></a><a name="index-g_t_005ccount_0040var_007bn_007d-674"></a>Start at the first page matching <var>page-spec</var>, which is one or more
+ <br><dt>&lsquo;<samp><span class="samp">-page-start=</span><var>page-spec</var></samp>&rsquo;<dd><a name="index-g_t_002dpage_002dstart_003d_0040var_007bpage_002dspec_007d-626"></a><a name="index-starting-page-627"></a><a name="index-page_002c-starting-628"></a><a name="index-g_t_005ccount_0040var_007bn_007d-629"></a>Start at the first page matching <var>page-spec</var>, which is one or more
(signed) integers separated by periods, corresponding to TeX's
<code>\count0...9</code> parameters at <code>\shipout</code> time; &lsquo;<samp><span class="samp">*</span></samp>&rsquo;
matches anything. Examples: &lsquo;<samp><span class="samp">3</span></samp>&rsquo;, &lsquo;<samp><span class="samp">1.*.-4</span></samp>&rsquo;.
</dl>
<div class="node">
-<p><hr>
<a name="dvitype-invocation"></a>
+<p><hr>
Previous:&nbsp;<a rel="previous" accesskey="p" href="#dvicopy-invocation">dvicopy invocation</a>,
Up:&nbsp;<a rel="up" accesskey="u" href="#DVI-utilities">DVI utilities</a>
@@ -3072,7 +2878,7 @@ Up:&nbsp;<a rel="up" accesskey="u" href="#DVI-utilities">DVI utilities</a>
<h3 class="section">9.2 DVItype: Plain text transliteration of DVI files</h3>
-<p><a name="index-dvitype-_0040r_007bDVI-validation_007d-675"></a><a name="index-conversion_002c-DVI-to-plain-text-676"></a><a name="index-plain-text_002c-converting-DVI-to-677"></a><a name="index-human_002dreadable-text_002c-converting-DVI-to-678"></a><a name="index-type-programs_002c-DVI-679"></a><a name="index-validation_002c-of-DVI-files-680"></a>
+<p><a name="index-dvitype-_0040r_007bDVI-validation_007d-630"></a><a name="index-conversion_002c-DVI-to-plain-text-631"></a><a name="index-plain-text_002c-converting-DVI-to-632"></a><a name="index-human_002dreadable-text_002c-converting-DVI-to-633"></a><a name="index-type-programs_002c-DVI-634"></a><a name="index-validation_002c-of-DVI-files-635"></a>
DVItype translates a DeVice Independent (DVI) file (as output by TeX,
for example) to a plain text file that humans can read. It also serves
as a DVI-validating program, i.e., if DVItype can read a file, it's
@@ -3091,16 +2897,16 @@ 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><span class="samp">-help</span></samp>&rsquo; and &lsquo;<samp><span class="samp">-version</span></samp>&rsquo; (see <a href="#Common-options">Common options</a>):
<dl>
-<dt>&lsquo;<samp><span class="samp">-dpi=</span><var>real</var></samp>&rsquo;<dd><a name="index-g_t_002ddpi_003d_0040var_007breal_007d-681"></a>Do pixel movement calculations at <var>real</var> pixels per inch; default
+<dt>&lsquo;<samp><span class="samp">-dpi=</span><var>real</var></samp>&rsquo;<dd><a name="index-g_t_002ddpi_003d_0040var_007breal_007d-636"></a>Do pixel movement calculations at <var>real</var> pixels per inch; default
300.0.
- <br><dt>&lsquo;<samp><span class="samp">-magnification=</span><var>integer</var></samp>&rsquo;<dd><a name="index-g_t_002dmagnification_003d_0040var_007binteger_007d-682"></a><a name="index-magnification-683"></a><a name="index-g_t_005cmag-684"></a>Override existing magnification in <var>indvi</var> with <var>integer</var>; 1000
+ <br><dt>&lsquo;<samp><span class="samp">-magnification=</span><var>integer</var></samp>&rsquo;<dd><a name="index-g_t_002dmagnification_003d_0040var_007binteger_007d-637"></a><a name="index-magnification-638"></a><a name="index-g_t_005cmag-639"></a>Override existing magnification in <var>indvi</var> with <var>integer</var>; 1000
specifies no magnification. This is equivalent to setting TeX's
<code>\mag</code> parameter.
- <br><dt>&lsquo;<samp><span class="samp">-max-pages=</span><var>n</var></samp>&rsquo;<dd><a name="index-g_t_002dmax_002dpages_003d_0040var_007bn_007d-685"></a>Process <var>n</var> pages; default is one million.
+ <br><dt>&lsquo;<samp><span class="samp">-max-pages=</span><var>n</var></samp>&rsquo;<dd><a name="index-g_t_002dmax_002dpages_003d_0040var_007bn_007d-640"></a>Process <var>n</var> pages; default is one million.
- <br><dt>&lsquo;<samp><span class="samp">-output-level=</span><var>n</var></samp>&rsquo;<dd><a name="index-g_t_002doutput_002dlevel_003d_0040var_007bn_007d-686"></a>Verbosity level of output, from 0 to 4 (default 4):
+ <br><dt>&lsquo;<samp><span class="samp">-output-level=</span><var>n</var></samp>&rsquo;<dd><a name="index-g_t_002doutput_002dlevel_003d_0040var_007bn_007d-641"></a>Verbosity level of output, from 0 to 4 (default 4):
<ul>
<li>0: Global document information only.
<li>1: Most DVI commands included, and typeset characters summarized.
@@ -3110,12 +2916,12 @@ specifies no magnification. This is equivalent to setting TeX's
in the file, reading the DVI postamble first.
</ul>
- <br><dt>&lsquo;<samp><span class="samp">-page-start=</span><var>page-spec</var></samp>&rsquo;<dd><a name="index-g_t_002dpage_002dstart_003d_0040var_007bpage_002dspec_007d-687"></a><a name="index-starting-page-688"></a><a name="index-page_002c-starting-689"></a><a name="index-g_t_005ccount_0040var_007bn_007d-690"></a>Start at the first page matching <var>page-spec</var>, which is one or more
+ <br><dt>&lsquo;<samp><span class="samp">-page-start=</span><var>page-spec</var></samp>&rsquo;<dd><a name="index-g_t_002dpage_002dstart_003d_0040var_007bpage_002dspec_007d-642"></a><a name="index-starting-page-643"></a><a name="index-page_002c-starting-644"></a><a name="index-g_t_005ccount_0040var_007bn_007d-645"></a>Start at the first page matching <var>page-spec</var>, which is one or more
(signed) integers separated by periods, corresponding to TeX's
<code>\count0...9</code> parameters at <code>\shipout</code> time; &lsquo;<samp><span class="samp">*</span></samp>&rsquo;
matches anything. Examples: &lsquo;<samp><span class="samp">1</span></samp>&rsquo;, &lsquo;<samp><span class="samp">5.*.-9</span></samp>&rsquo;.
- <br><dt>&lsquo;<samp><span class="samp">-show-opcodes</span></samp>&rsquo;<dd><a name="index-g_t_002dshow_002dopcodes-691"></a><a name="index-opcodes_002c-showing-DVI-692"></a><a name="index-DVI-opcodes_002c-showing-693"></a><a name="index-debugging-DVI-utilities-694"></a>Show numeric opcode values (in decimal) for DVI commands, in braces
+ <br><dt>&lsquo;<samp><span class="samp">-show-opcodes</span></samp>&rsquo;<dd><a name="index-g_t_002dshow_002dopcodes-646"></a><a name="index-opcodes_002c-showing-DVI-647"></a><a name="index-DVI-opcodes_002c-showing-648"></a><a name="index-debugging-DVI-utilities-649"></a>Show numeric opcode values (in decimal) for DVI commands, in braces
after the command name. This can help in debugging DVI utilities. We
use decimal because in the DVI format documentation (in
<samp><span class="file">dvitype.web</span></samp>, among others) the opcodes are shown in decimal.
@@ -3126,15 +2932,15 @@ use decimal because in the DVI format documentation (in
</ul>
<div class="node">
-<p><hr>
<a name="dvitype-output-example"></a>
+<p><hr>
Up:&nbsp;<a rel="up" accesskey="u" href="#dvitype-invocation">dvitype invocation</a>
</div>
<h4 class="subsection">9.2.1 DVItype output example</h4>
-<p><a name="index-dvitype-output-example-695"></a>As an example of the output from DVItype (see section above), here is
+<p><a name="index-dvitype-output-example-650"></a>As an example of the output from DVItype (see section above), here is
its (abridged) translation of the <samp><span class="file">story.dvi</span></samp> resulting from
running the example in <cite>The TeXbook</cite>, with
&lsquo;<samp><span class="samp">-output-level=4</span></samp>&rsquo; and &lsquo;<samp><span class="samp">-show-opcodes</span></samp>&rsquo; on.
@@ -3211,8 +3017,8 @@ STORY]</span></samp>&rsquo; and the &lsquo;<samp><span class="samp">[ 1]</span><
</ul>
<div class="node">
-<p><hr>
<a name="Font-utilities"></a>
+<p><hr>
Next:&nbsp;<a rel="next" accesskey="n" href="#Legalisms">Legalisms</a>,
Previous:&nbsp;<a rel="previous" accesskey="p" href="#DVI-utilities">DVI utilities</a>,
Up:&nbsp;<a rel="up" accesskey="u" href="#Top">Top</a>
@@ -3221,13 +3027,13 @@ Up:&nbsp;<a rel="up" accesskey="u" href="#Top">Top</a>
<h2 class="chapter">10 Font utilities</h2>
-<p><a name="index-font-utilities-696"></a>
+<p><a name="index-font-utilities-651"></a>
The Web2c programs described here convert between various TeX-related
font formats; the first section below briefly describes the
formats. GFtoPK is the only one that is routinely used, as Metafont
outputs GF format, but it's most efficient for device drivers to use PK.
- <p><a name="index-pktype_002eweb-697"></a><a name="index-gftype_002eweb-698"></a><a name="index-PK-format-definition-699"></a><a name="index-GF-format-definition-700"></a>The precise definitions of the PK, GF, TFM, PL, VF, and VPL formats
+ <p><a name="index-pktype_002eweb-652"></a><a name="index-gftype_002eweb-653"></a><a name="index-PK-format-definition-654"></a><a name="index-GF-format-definition-655"></a>The precise definitions of the PK, GF, TFM, PL, VF, and VPL formats
mentioned below are in the source files that read them;
<samp><span class="file">pktype.web</span></samp>, <samp><span class="file">gftype.web</span></samp>, <samp><span class="file">tftopl.web</span></samp>, etc.
@@ -3245,8 +3051,8 @@ mentioned below are in the source files that read them;
</ul>
<div class="node">
-<p><hr>
<a name="Font-file-formats"></a>
+<p><hr>
Next:&nbsp;<a rel="next" accesskey="n" href="#gftopk-invocation">gftopk invocation</a>,
Up:&nbsp;<a rel="up" accesskey="u" href="#Font-utilities">Font utilities</a>
@@ -3254,7 +3060,7 @@ Up:&nbsp;<a rel="up" accesskey="u" href="#Font-utilities">Font utilities</a>
<h3 class="section">10.1 Font file formats</h3>
-<p><a name="index-font-file-formats-701"></a><a name="index-file-formats-for-fonts-702"></a>
+<p><a name="index-font-file-formats-656"></a><a name="index-file-formats-for-fonts-657"></a>
(For another perspective on this, see <a href="dvips.html#Font-concepts">Font concepts</a>).
<p>Font files come in several varieties, with suffixes like:
@@ -3262,7 +3068,7 @@ Up:&nbsp;<a rel="up" accesskey="u" href="#Font-utilities">Font utilities</a>
</pre>
<p class="noindent">Each represents a file format.
- <p><a name="index-TFM-files_002c-explained-703"></a>A TFM (TeX font metric) file is a compact binary file that contains
+ <p><a name="index-TFM-files_002c-explained-658"></a>A TFM (TeX font metric) file is a compact binary file that contains
information about each character in a font, about combinations of
characters within that font, and about the font as a whole. The font
metric information contained in TFM files is device-independent units is
@@ -3271,7 +3077,7 @@ described below, TFM font files contain no information about the shapes
of characters. They describe rectangular areas and combinations
thereof, but not what will eventually be printed in those areas.
- <p><a name="index-scaling-of-fonts-704"></a><a name="index-optical-font-scaling-705"></a><a name="index-geometric-font-scaling-706"></a><a name="index-PostScript_002c-and-font-scaling-707"></a>Since TeX does scaling calculations, one TFM file serves for all
+ <p><a name="index-scaling-of-fonts-659"></a><a name="index-optical-font-scaling-660"></a><a name="index-geometric-font-scaling-661"></a><a name="index-PostScript_002c-and-font-scaling-662"></a>Since TeX does scaling calculations, one TFM file serves for all
magnifications of a given typeface. On the other hand, the best printed
results are obtained when magnified (or reduced fonts) are not produced
geometrically (as done by PostScript, for example) but rather optically,
@@ -3279,7 +3085,7 @@ with each size a separate design (as done with Computer Modern and the
EC fonts, for example); then a separate TFM file is needed for each
size.
- <p><a name="index-DVI-files_002c-explained-708"></a>At any rate, TeX produces a DVI (DeVice Independent) file from your
+ <p><a name="index-DVI-files_002c-explained-663"></a>At any rate, TeX produces a DVI (DeVice Independent) file from your
source document. In order to print DVI files on real devices, you need
font files defining digitized character shapes and other data. Then
previewers and printer-driver programs can translate your DVI files into
@@ -3290,14 +3096,14 @@ font was produced, and the &lsquo;<samp><span class="samp">pk</span></samp>&rsqu
indicates the font format. Outline fonts in PostScript Type 1 format
have suffixes such as &lsquo;<samp><span class="samp">.pfa</span></samp>&rsquo; or &lsquo;<samp><span class="samp">.pfb</span></samp>&rsquo;.
- <p><a name="index-PXL-files_002c-explained-709"></a><a name="index-PK-files_002c-explained-710"></a><a name="index-GF-files_002c-explained-711"></a>Fonts in pk (packed) format are in the tightly packed raster format that
+ <p><a name="index-PXL-files_002c-explained-664"></a><a name="index-PK-files_002c-explained-665"></a><a name="index-GF-files_002c-explained-666"></a>Fonts in pk (packed) format are in the tightly packed raster format that
is pretty much the standard today. They take up less space than fonts
in the gf (generic font) format that Metafont generates, and far less
space than fonts in pxl format. Fonts in pxl format take up gross
amounts of disk space and permit only 128 characters. They are
obsolete.
- <p><a name="index-PL-files_002c-explained-712"></a>Font files with the &lsquo;<samp><span class="samp">.pl</span></samp>&rsquo; (property list) suffix are the plain text
+ <p><a name="index-PL-files_002c-explained-667"></a>Font files with the &lsquo;<samp><span class="samp">.pl</span></samp>&rsquo; (property list) suffix are the plain text
(human-readable) analog of the binary &lsquo;<samp><span class="samp">.tfm</span></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>).
@@ -3307,18 +3113,18 @@ These are the files used by Metafont to generate rastered fonts for
specific typefaces at specific magnifications for the specific
resolution and type of mapping used by your device.
- <p><a name="index-virtual_002dfonts_002eknuth-713"></a><a name="index-virtualfonts_002etxt-714"></a>The suffix &lsquo;<samp><span class="samp">.vf</span></samp>&rsquo; identifies &ldquo;virtual font&rdquo; files, for which
+ <p><a name="index-virtual_002dfonts_002eknuth-668"></a><a name="index-virtualfonts_002etxt-669"></a>The suffix &lsquo;<samp><span class="samp">.vf</span></samp>&rsquo; identifies &ldquo;virtual font&rdquo; files, for which
&lsquo;<samp><span class="samp">.vpl</span></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,
see <samp><var>CTAN:</var><span class="file">/doc/virtual-fonts.knuth</span></samp>,
<samp><var>CTAN:</var><span class="file">/help/virtualfonts.txt</span></samp>, and <a href="dvips.html#Virtual-fonts">Virtual fonts</a>.
- <p><a name="index-MacKay_002c-Pierre-715"></a><a name="index-Tachikawa_002c-Elizabeth-716"></a>(This section is based on documentation in the original Unix TeX
+ <p><a name="index-MacKay_002c-Pierre-670"></a><a name="index-Tachikawa_002c-Elizabeth-671"></a>(This section is based on documentation in the original Unix TeX
distribution by Pierre MacKay and Elizabeth Tachikawa.)
<div class="node">
-<p><hr>
<a name="gftopk-invocation"></a>
+<p><hr>
Next:&nbsp;<a rel="next" accesskey="n" href="#pktogf-invocation">pktogf invocation</a>,
Previous:&nbsp;<a rel="previous" accesskey="p" href="#Font-file-formats">Font file formats</a>,
Up:&nbsp;<a rel="up" accesskey="u" href="#Font-utilities">Font utilities</a>
@@ -3327,7 +3133,7 @@ Up:&nbsp;<a rel="up" accesskey="u" href="#Font-utilities">Font utilities</a>
<h3 class="section">10.2 GFtoPK: Generic to packed font conversion</h3>
-<p><a name="index-gftopk-717"></a><a name="index-conversion_002c-GF-to-PK-718"></a><a name="index-PK_002c-converting-GF-to-719"></a><a name="index-GF_002c-converting-to-PK-720"></a>
+<p><a name="index-gftopk-672"></a><a name="index-conversion_002c-GF-to-PK-673"></a><a name="index-PK_002c-converting-GF-to-674"></a><a name="index-GF_002c-converting-to-PK-675"></a>
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
are considerably smaller than the corresponding gf files, so they are
@@ -3353,8 +3159,8 @@ of &lsquo;<samp><var>gfname</var><span class="samp">.</span><var>dpi</var><span
&lsquo;<samp><span class="samp">--version</span></samp>&rsquo; (see <a href="#Common-options">Common options</a>).
<div class="node">
-<p><hr>
<a name="pktogf-invocation"></a>
+<p><hr>
Next:&nbsp;<a rel="next" accesskey="n" href="#pktype-invocation">pktype invocation</a>,
Previous:&nbsp;<a rel="previous" accesskey="p" href="#gftopk-invocation">gftopk invocation</a>,
Up:&nbsp;<a rel="up" accesskey="u" href="#Font-utilities">Font utilities</a>
@@ -3363,7 +3169,7 @@ Up:&nbsp;<a rel="up" accesskey="u" href="#Font-utilities">Font utilities</a>
<h3 class="section">10.3 PKtoGF: Packed to generic font conversion</h3>
-<p><a name="index-pktogf-721"></a><a name="index-conversion_002c-PK-to-GF-722"></a><a name="index-GF_002c-converting-PK-to-723"></a><a name="index-PK_002c-converting-to-GF-724"></a>
+<p><a name="index-pktogf-676"></a><a name="index-conversion_002c-PK-to-GF-677"></a><a name="index-GF_002c-converting-PK-to-678"></a><a name="index-PK_002c-converting-to-GF-679"></a>
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
@@ -3388,8 +3194,8 @@ of &lsquo;<samp><var>pkname</var><span class="samp">.</span><var>dpi</var><span
&lsquo;<samp><span class="samp">--version</span></samp>&rsquo; (see <a href="#Common-options">Common options</a>).
<div class="node">
-<p><hr>
<a name="pktype-invocation"></a>
+<p><hr>
Next:&nbsp;<a rel="next" accesskey="n" href="#gftype-invocation">gftype invocation</a>,
Previous:&nbsp;<a rel="previous" accesskey="p" href="#pktogf-invocation">pktogf invocation</a>,
Up:&nbsp;<a rel="up" accesskey="u" href="#Font-utilities">Font utilities</a>
@@ -3398,7 +3204,7 @@ Up:&nbsp;<a rel="up" accesskey="u" href="#Font-utilities">Font utilities</a>
<h3 class="section">10.4 PKtype: Plain text transliteration of packed fonts</h3>
-<p><a name="index-pktype-_0040r_007bPK-validation_007d-725"></a><a name="index-conversion_002c-PK-to-plain-text-726"></a><a name="index-plain-text_002c-converting-PK-to-727"></a><a name="index-human_002dreadable-text_002c-converting-PK-to-728"></a><a name="index-type-programs_002c-PK-729"></a><a name="index-validation_002c-of-PK-files-730"></a>
+<p><a name="index-pktype-_0040r_007bPK-validation_007d-680"></a><a name="index-conversion_002c-PK-to-plain-text-681"></a><a name="index-plain-text_002c-converting-PK-to-682"></a><a name="index-human_002dreadable-text_002c-converting-PK-to-683"></a><a name="index-type-programs_002c-PK-684"></a><a name="index-validation_002c-of-PK-files-685"></a>
PKtype translates a packed font (PK) bitmap file (as output by GFtoPK,
for example) to a plain text file that humans can read. It also serves
as a PK-validating program, i.e., if PKtype can read a file, it's
@@ -3434,23 +3240,23 @@ letter `K' in &lsquo;<samp><span class="samp">cmr10</span></samp>&rsquo;, as ren
<p class="noindent">Explanation:
<dl>
-<dt>&lsquo;<samp><span class="samp">955</span></samp>&rsquo;<dd><a name="index-byte-position-731"></a>The byte position in the file where this character starts.
+<dt>&lsquo;<samp><span class="samp">955</span></samp>&rsquo;<dd><a name="index-byte-position-686"></a>The byte position in the file where this character starts.
- <br><dt>&lsquo;<samp><span class="samp">Flag byte</span></samp>&rsquo;<dt>&lsquo;<samp><span class="samp">Dynamic packing variable</span></samp>&rsquo;<dd><a name="index-flag-byte-732"></a><a name="index-dynamic-packing-variable-733"></a>Related to the packing for this character; see the source code.
+ <br><dt>&lsquo;<samp><span class="samp">Flag byte</span></samp>&rsquo;<dt>&lsquo;<samp><span class="samp">Dynamic packing variable</span></samp>&rsquo;<dd><a name="index-flag-byte-687"></a><a name="index-dynamic-packing-variable-688"></a>Related to the packing for this character; see the source code.
- <br><dt>&lsquo;<samp><span class="samp">Character</span></samp>&rsquo;<dd><a name="index-character-codes_002c-in-PKtype-output-734"></a>The character code, in decimal.
+ <br><dt>&lsquo;<samp><span class="samp">Character</span></samp>&rsquo;<dd><a name="index-character-codes_002c-in-PKtype-output-689"></a>The character code, in decimal.
- <br><dt>&lsquo;<samp><span class="samp">Packet length</span></samp>&rsquo;<dd><a name="index-packet-length-735"></a>The total length of this character definition, in bytes.
+ <br><dt>&lsquo;<samp><span class="samp">Packet length</span></samp>&rsquo;<dd><a name="index-packet-length-690"></a>The total length of this character definition, in bytes.
- <br><dt>&lsquo;<samp><span class="samp">TFM width</span></samp>&rsquo;<dd><a name="index-TFM-width-of-characters-736"></a><a name="index-device_002dindependent-width-737"></a><a name="index-width_002c-device_002dindependent-738"></a>The device-independent (TFM) width of this character. It is 2^24
+ <br><dt>&lsquo;<samp><span class="samp">TFM width</span></samp>&rsquo;<dd><a name="index-TFM-width-of-characters-691"></a><a name="index-device_002dindependent-width-692"></a><a name="index-width_002c-device_002dindependent-693"></a>The device-independent (TFM) width of this character. It is 2^24
times the ratio of the true width to the font's design size.
- <br><dt>&lsquo;<samp><span class="samp">dx</span></samp>&rsquo;<dd><a name="index-horizontal-escapement-739"></a><a name="index-escapement_002c-horizontal-740"></a><a name="index-scaled-pixels-741"></a><a name="index-dx-_0040r_007bhorizontal-escapement_007d-742"></a>The device-dependent width, in <dfn>scaled pixels</dfn>, i.e., units of
+ <br><dt>&lsquo;<samp><span class="samp">dx</span></samp>&rsquo;<dd><a name="index-horizontal-escapement-694"></a><a name="index-escapement_002c-horizontal-695"></a><a name="index-scaled-pixels-696"></a><a name="index-dx-_0040r_007bhorizontal-escapement_007d-697"></a>The device-dependent width, in <dfn>scaled pixels</dfn>, i.e., units of
horizontal pixels times 2^16.
- <br><dt>&lsquo;<samp><span class="samp">Height</span></samp>&rsquo;<dt>&lsquo;<samp><span class="samp">Width</span></samp>&rsquo;<dd><a name="index-height_002c-in-pixels-743"></a><a name="index-pixel-height-744"></a><a name="index-pixel-width-745"></a><a name="index-width_002c-in-pixels-746"></a>The bitmap height and width, in pixels.
+ <br><dt>&lsquo;<samp><span class="samp">Height</span></samp>&rsquo;<dt>&lsquo;<samp><span class="samp">Width</span></samp>&rsquo;<dd><a name="index-height_002c-in-pixels-698"></a><a name="index-pixel-height-699"></a><a name="index-pixel-width-700"></a><a name="index-width_002c-in-pixels-701"></a>The bitmap height and width, in pixels.
- <br><dt>&lsquo;<samp><span class="samp">X-offset</span></samp>&rsquo;<dt>&lsquo;<samp><span class="samp">Y-offset</span></samp>&rsquo;<dd><a name="index-x-offset-747"></a><a name="index-y-offset-748"></a><a name="index-origin-749"></a><a name="index-reference-pixel-750"></a><a name="index-side-bearings-751"></a><a name="index-left-side-bearing-752"></a><a name="index-right-side-bearing-753"></a>Horizontal and vertical offset from the upper left pixel to the
+ <br><dt>&lsquo;<samp><span class="samp">X-offset</span></samp>&rsquo;<dt>&lsquo;<samp><span class="samp">Y-offset</span></samp>&rsquo;<dd><a name="index-x-offset-702"></a><a name="index-y-offset-703"></a><a name="index-origin-704"></a><a name="index-reference-pixel-705"></a><a name="index-side-bearings-706"></a><a name="index-left-side-bearing-707"></a><a name="index-right-side-bearing-708"></a>Horizontal and vertical offset from the upper left pixel to the
reference (origin) pixel for this character, in pixels (right and down
are positive). The <dfn>reference pixel</dfn> is the pixel that occupies the
unit square in Metafont; the Metafont reference point is the lower left
@@ -3458,13 +3264,13 @@ hand corner of this pixel. Put another way, the x-offset is the negative
of the left side bearing; the right side bearing is the horizontal
escapement minus the bitmap width plus the x-offset.
- <br><dt>&lsquo;<samp><span class="samp">[2]23(16)...</span></samp>&rsquo;<dd><a name="index-run-length-encoded-bitmaps-754"></a><a name="index-repeated-rows-755"></a>Finally, run lengths of black pixels alternate with parenthesized run
+ <br><dt>&lsquo;<samp><span class="samp">[2]23(16)...</span></samp>&rsquo;<dd><a name="index-run-length-encoded-bitmaps-709"></a><a name="index-repeated-rows-710"></a>Finally, run lengths of black pixels alternate with parenthesized run
lengths of white pixels, and brackets indicate a repeated row.
</dl>
<div class="node">
-<p><hr>
<a name="gftype-invocation"></a>
+<p><hr>
Next:&nbsp;<a rel="next" accesskey="n" href="#tftopl-invocation">tftopl invocation</a>,
Previous:&nbsp;<a rel="previous" accesskey="p" href="#pktype-invocation">pktype invocation</a>,
Up:&nbsp;<a rel="up" accesskey="u" href="#Font-utilities">Font utilities</a>
@@ -3473,7 +3279,7 @@ Up:&nbsp;<a rel="up" accesskey="u" href="#Font-utilities">Font utilities</a>
<h3 class="section">10.5 GFtype: Plain text transliteration of generic fonts</h3>
-<p><a name="index-gftype-_0040r_007bGF-validation_007d-756"></a><a name="index-conversion_002c-GF-to-plain-text-757"></a><a name="index-plain-text_002c-converting-GF-to-758"></a><a name="index-human_002dreadable-text_002c-converting-GF-to-759"></a><a name="index-type-programs_002c-GF-760"></a><a name="index-validation_002c-of-GF-files-761"></a>
+<p><a name="index-gftype-_0040r_007bGF-validation_007d-711"></a><a name="index-conversion_002c-GF-to-plain-text-712"></a><a name="index-plain-text_002c-converting-GF-to-713"></a><a name="index-human_002dreadable-text_002c-converting-GF-to-714"></a><a name="index-type-programs_002c-GF-715"></a><a name="index-validation_002c-of-GF-files-716"></a>
GFtype translates a generic font (GF) bitmap file (as output by
Metafont, for example) to a plain text file that humans can read. It
also serves as a GF-validating program, i.e., if GFtype can read a file,
@@ -3493,9 +3299,9 @@ not an extension; no &lsquo;<samp><span class="samp">.</span></samp>&rsquo; prec
<p>The program accepts the following options, as well as the standard
&lsquo;<samp><span class="samp">-help</span></samp>&rsquo; and &lsquo;<samp><span class="samp">-version</span></samp>&rsquo; (see <a href="#Common-options">Common options</a>):
<dl>
-<dt>&lsquo;<samp><span class="samp">-images</span></samp>&rsquo;<dd><a name="index-g_t_002dimages-762"></a>Show the characters' bitmaps using asterisks and spaces.
+<dt>&lsquo;<samp><span class="samp">-images</span></samp>&rsquo;<dd><a name="index-g_t_002dimages-717"></a>Show the characters' bitmaps using asterisks and spaces.
- <br><dt>&lsquo;<samp><span class="samp">-mnemonics</span></samp>&rsquo;<dd><a name="index-g_t_002dmnemonics-763"></a>Translate all commands in the GF file.
+ <br><dt>&lsquo;<samp><span class="samp">-mnemonics</span></samp>&rsquo;<dd><a name="index-g_t_002dmnemonics-718"></a>Translate all commands in the GF file.
</dl>
<p>As an example of the output, here is the (abrdiged) translation of the
@@ -3542,22 +3348,22 @@ main definition:
<p class="noindent">Explanation:
<dl>
-<dt>&lsquo;<samp><span class="samp">2033</span></samp>&rsquo;<dt>&lsquo;<samp><span class="samp">2043</span></samp>&rsquo;<dt>&lsquo;<samp><span class="samp">...</span></samp>&rsquo;<dd><a name="index-byte-position-764"></a>The byte position in the file where each GF command starts.
+<dt>&lsquo;<samp><span class="samp">2033</span></samp>&rsquo;<dt>&lsquo;<samp><span class="samp">2043</span></samp>&rsquo;<dt>&lsquo;<samp><span class="samp">...</span></samp>&rsquo;<dd><a name="index-byte-position-719"></a>The byte position in the file where each GF command starts.
- <br><dt>&lsquo;<samp><span class="samp">beginning of char 75</span></samp>&rsquo;<dd><a name="index-character-codes_002c-in-GFtype-output-765"></a>The character code, in decimal.
+ <br><dt>&lsquo;<samp><span class="samp">beginning of char 75</span></samp>&rsquo;<dd><a name="index-character-codes_002c-in-GFtype-output-720"></a>The character code, in decimal.
- <br><dt>&lsquo;<samp><span class="samp">3&lt;=m&lt;=60 0&lt;=n&lt;=56</span></samp>&rsquo;<dd><a name="index-left-side-bearing-766"></a><a name="index-right-side-bearing-767"></a><a name="index-side-bearings-768"></a>The character's bitmap lies between 3 and 60 (inclusive) horizontally,
+ <br><dt>&lsquo;<samp><span class="samp">3&lt;=m&lt;=60 0&lt;=n&lt;=56</span></samp>&rsquo;<dd><a name="index-left-side-bearing-721"></a><a name="index-right-side-bearing-722"></a><a name="index-side-bearings-723"></a>The character's bitmap lies between 3 and 60 (inclusive) horizontally,
and between 0 and 56 (inclusive) vertically. (m is a column
position and n is a row position.) Thus, 3 is the left side
bearing. The right side bearing is the horizontal escapement (given
below) minus the maximum m.
- <br><dt>&lsquo;<samp><span class="samp">(initially n=56) paint (0)24(12)20</span></samp>&rsquo;<dd><a name="index-run-length-encoded-bitmaps-769"></a>The first row of pixels: 0 white pixels, 24 black pixels, 12 white
+ <br><dt>&lsquo;<samp><span class="samp">(initially n=56) paint (0)24(12)20</span></samp>&rsquo;<dd><a name="index-run-length-encoded-bitmaps-724"></a>The first row of pixels: 0 white pixels, 24 black pixels, 12 white
pixels, etc.
- <br><dt>&lsquo;<samp><span class="samp">newrow 0 (n=55) paint 24(12)20</span></samp>&rsquo;<dd><a name="index-newrow-_0040r_007bGF-command_007d-770"></a>The second row of pixels, with zero leading white pixels on the row.
+ <br><dt>&lsquo;<samp><span class="samp">newrow 0 (n=55) paint 24(12)20</span></samp>&rsquo;<dd><a name="index-newrow-_0040r_007bGF-command_007d-725"></a>The second row of pixels, with zero leading white pixels on the row.
- <br><dt>&lsquo;<samp><span class="samp">eoc</span></samp>&rsquo;<dd><a name="index-eoc-_0040r_007bGF-command_007d-771"></a>The end of the main character definition.
+ <br><dt>&lsquo;<samp><span class="samp">eoc</span></samp>&rsquo;<dd><a name="index-eoc-_0040r_007bGF-command_007d-726"></a>The end of the main character definition.
</dl>
@@ -3568,12 +3374,12 @@ pixels, etc.
<p>Explanation:
<dl>
-<dt>&lsquo;<samp><span class="samp">dx</span></samp>&rsquo;<dd><a name="index-horizontal-escapement-772"></a><a name="index-escapement_002c-horizontal-773"></a><a name="index-vertical-escapement-774"></a><a name="index-escapement_002c-vertical-775"></a><a name="index-scaled-pixels-776"></a><a name="index-dx-_0040r_007bhorizontal-escapement_007d-777"></a><a name="index-dy-_0040r_007bvertical-escapement_007d-778"></a>The device-dependent width, in <dfn>scaled pixels</dfn>, i.e., units of
+<dt>&lsquo;<samp><span class="samp">dx</span></samp>&rsquo;<dd><a name="index-horizontal-escapement-727"></a><a name="index-escapement_002c-horizontal-728"></a><a name="index-vertical-escapement-729"></a><a name="index-escapement_002c-vertical-730"></a><a name="index-scaled-pixels-731"></a><a name="index-dx-_0040r_007bhorizontal-escapement_007d-732"></a><a name="index-dy-_0040r_007bvertical-escapement_007d-733"></a>The device-dependent width, in <dfn>scaled pixels</dfn>, i.e., units of
horizontal pixels times 2^16. The &lsquo;<samp><span class="samp">(65)</span></samp>&rsquo; is simply the same number
rounded. If the vertical escapement is nonzero, it would appear here as
a &lsquo;<samp><span class="samp">dy</span></samp>&rsquo; value.
- <br><dt>&lsquo;<samp><span class="samp">width</span></samp>&rsquo;<dd><a name="index-TFM-width-of-characters-779"></a><a name="index-device_002dindependent-width-780"></a><a name="index-width_002c-device_002dindependent-781"></a>The device-independent (TFM) width of this character. It is 2^24
+ <br><dt>&lsquo;<samp><span class="samp">width</span></samp>&rsquo;<dd><a name="index-TFM-width-of-characters-734"></a><a name="index-device_002dindependent-width-735"></a><a name="index-width_002c-device_002dindependent-736"></a>The device-independent (TFM) width of this character. It is 2^24
times the ratio of the true width to the font's design size. The
&lsquo;<samp><span class="samp">64.57289</span></samp>&rsquo; is the same number converted to pixels.
@@ -3582,8 +3388,8 @@ times the ratio of the true width to the font's design size. The
</dl>
<div class="node">
-<p><hr>
<a name="tftopl-invocation"></a>
+<p><hr>
Next:&nbsp;<a rel="next" accesskey="n" href="#pltotf-invocation">pltotf invocation</a>,
Previous:&nbsp;<a rel="previous" accesskey="p" href="#gftype-invocation">gftype invocation</a>,
Up:&nbsp;<a rel="up" accesskey="u" href="#Font-utilities">Font utilities</a>
@@ -3592,7 +3398,7 @@ Up:&nbsp;<a rel="up" accesskey="u" href="#Font-utilities">Font utilities</a>
<h3 class="section">10.6 TFtoPL: TeX font metric to property list conversion</h3>
-<p><a name="index-tftopl-782"></a><a name="index-conversion_002c-TFM-to-property-list-783"></a><a name="index-validation_002c-of-TFM-files-784"></a><a name="index-property-list_002c-converting-TFM-to-785"></a><a name="index-human_002dreadable-text_002c-converting-TFM-to-786"></a><a name="index-plain-text_002c-converting-TFM-to-787"></a>
+<p><a name="index-tftopl-737"></a><a name="index-conversion_002c-TFM-to-property-list-738"></a><a name="index-validation_002c-of-TFM-files-739"></a><a name="index-property-list_002c-converting-TFM-to-740"></a><a name="index-human_002dreadable-text_002c-converting-TFM-to-741"></a><a name="index-plain-text_002c-converting-TFM-to-742"></a>
TFtoPL translates a TeX font metric (TFM, see <a href="dvips.html#Metric-files">Metric files</a>) file (as output by Metafont, for example) to
<dfn>property list format</dfn> (a list of parenthesized items describing the
font) that humans can edit or read. This program is mostly used by
@@ -3614,7 +3420,7 @@ program TFtoPL (see the next section).
<p>The program accepts the following option, as well as the standard
&lsquo;<samp><span class="samp">-verbose</span></samp>&rsquo;, &lsquo;<samp><span class="samp">-help</span></samp>&rsquo; and &lsquo;<samp><span class="samp">-version</span></samp>&rsquo; (see <a href="#Common-options">Common options</a>):
<dl>
-<dt>&lsquo;<samp><span class="samp">-charcode-format=</span><var>type</var></samp>&rsquo;<dd><a name="index-g_t_002dcharcode_002dformat_003d_0040var_007btype_007d-788"></a>Output character codes in the PL file according to <var>type</var>: either
+<dt>&lsquo;<samp><span class="samp">-charcode-format=</span><var>type</var></samp>&rsquo;<dd><a name="index-g_t_002dcharcode_002dformat_003d_0040var_007btype_007d-743"></a>Output character codes in the PL file according to <var>type</var>: either
&lsquo;<samp><span class="samp">octal</span></samp>&rsquo; or &lsquo;<samp><span class="samp">ascii</span></samp>&rsquo;. Default is &lsquo;<samp><span class="samp">ascii</span></samp>&rsquo; for letters and
digits, octal for all other characters. Exception: if the font's coding
scheme starts with &lsquo;<samp><span class="samp">TeX math sy</span></samp>&rsquo; or &lsquo;<samp><span class="samp">TeX math ex</span></samp>&rsquo;, all
@@ -3631,7 +3437,7 @@ where using ASCII characters for the character codes is merely
confusing.
</dl>
- <p><a name="index-property-list-format-789"></a>As an example of the output, here is the (abridged) property list
+ <p><a name="index-property-list-format-744"></a>As an example of the output, here is the (abridged) property list
translation of <samp><span class="file">cmr10.tfm</span></samp>:
<pre class="example"> (FAMILY CMR)
@@ -3684,14 +3490,14 @@ translation of <samp><span class="file">cmr10.tfm</span></samp>:
<dfn>properties</dfn>, nested where necessary.
<ul>
-<li><a name="index-FAMILY-_0040r_007bproperty_007d-790"></a><a name="index-FACE-_0040r_007bproperty_007d-791"></a><a name="index-headerbyte-_0040r_007binformation_007d-792"></a>The first few items (<code>FAMILY</code>, <code>FACE</code>, and so on) are
+<li><a name="index-FAMILY-_0040r_007bproperty_007d-745"></a><a name="index-FACE-_0040r_007bproperty_007d-746"></a><a name="index-headerbyte-_0040r_007binformation_007d-747"></a>The first few items (<code>FAMILY</code>, <code>FACE</code>, and so on) are
the so-called <dfn>headerbyte</dfn> information from Metafont, giving general
information about the font.
- <li><a name="index-FAMILY-_0040r_007bproperty_007d-793"></a><a name="index-g_t_005cfontdimen-794"></a>The <code>FONTDIMEN</code> property defines the TeX <code>\fontdimen</code>
+ <li><a name="index-FAMILY-_0040r_007bproperty_007d-748"></a><a name="index-g_t_005cfontdimen-749"></a>The <code>FONTDIMEN</code> property defines the TeX <code>\fontdimen</code>
values.
- <li><a name="index-LIGTABLE-_0040r_007bproperty_007d-795"></a><a name="index-LABEL-_0040r_007bproperty_007d-796"></a><a name="index-LIG-_0040r_007bproperty_007d-797"></a><a name="index-KRN-_0040r_007bproperty_007d-798"></a><a name="index-ligature-table_002c-in-TFM-files-799"></a><a name="index-kerning-table_002c-in-TFM-files-800"></a><a name="index-design_002dsize-units-801"></a>The <code>LIGTABLE</code> property defines the ligature and kerning table.
+ <li><a name="index-LIGTABLE-_0040r_007bproperty_007d-750"></a><a name="index-LABEL-_0040r_007bproperty_007d-751"></a><a name="index-LIG-_0040r_007bproperty_007d-752"></a><a name="index-KRN-_0040r_007bproperty_007d-753"></a><a name="index-ligature-table_002c-in-TFM-files-754"></a><a name="index-kerning-table_002c-in-TFM-files-755"></a><a name="index-design_002dsize-units-756"></a>The <code>LIGTABLE</code> property defines the ligature and kerning table.
<code>LIG</code> properties define ligatures: in the example above, an
&lsquo;<samp><span class="samp">f</span></samp>&rsquo; (in the &lsquo;<samp><span class="samp">LABEL</span></samp>&rsquo;) followed by an &lsquo;<samp><span class="samp">i</span></samp>&rsquo; is a ligature,
i.e., a typesetting program like TeX replaces those two consecutive
@@ -3703,7 +3509,7 @@ apostrophe), TeX inserts a small amount of space between them:
three-quarters of a printer's point by default in this case, or .001
inches).
- <li><a name="index-CHARACTER-_0040r_007bproperty_007d-802"></a><a name="index-CHARWD-_0040r_007bproperty_007d-803"></a><a name="index-CHARHT-_0040r_007bproperty_007d-804"></a><a name="index-CHARDP-_0040r_007bproperty_007d-805"></a><a name="index-CHARIC-_0040r_007bproperty_007d-806"></a>The <code>CHARACTER</code> property defines the dimensions of a character: its
+ <li><a name="index-CHARACTER-_0040r_007bproperty_007d-757"></a><a name="index-CHARWD-_0040r_007bproperty_007d-758"></a><a name="index-CHARHT-_0040r_007bproperty_007d-759"></a><a name="index-CHARDP-_0040r_007bproperty_007d-760"></a><a name="index-CHARIC-_0040r_007bproperty_007d-761"></a>The <code>CHARACTER</code> property defines the dimensions of a character: its
width, height, depth, and italic correction, also in design-size units,
as explained in the previous item. For our example `f', the depth is
zero, so that property is omitted. TFtoPL also inserts any kerns and
@@ -3712,8 +3518,8 @@ ligatures for this character as a comment.
</ul>
<div class="node">
-<p><hr>
<a name="pltotf-invocation"></a>
+<p><hr>
Next:&nbsp;<a rel="next" accesskey="n" href="#vftovp-invocation">vftovp invocation</a>,
Previous:&nbsp;<a rel="previous" accesskey="p" href="#tftopl-invocation">tftopl invocation</a>,
Up:&nbsp;<a rel="up" accesskey="u" href="#Font-utilities">Font utilities</a>
@@ -3722,7 +3528,7 @@ Up:&nbsp;<a rel="up" accesskey="u" href="#Font-utilities">Font utilities</a>
<h3 class="section">10.7 PLtoTF: Property list to TeX font metric conversion</h3>
-<p><a name="index-pltotf-807"></a><a name="index-conversion_002c-property-list-to-TFM-808"></a><a name="index-TFM-files_002c-converting-property-lists-to-809"></a><a name="index-machine_002dreadable_002c-converting-property-lists-to-810"></a>
+<p><a name="index-pltotf-762"></a><a name="index-conversion_002c-property-list-to-TFM-763"></a><a name="index-TFM-files_002c-converting-property-lists-to-764"></a><a name="index-machine_002dreadable_002c-converting-property-lists-to-765"></a>
PLtoTF translates a property list file (as output by TFtoPL, for
example) to TeX font metric (TFM, see <a href="dvips.html#Metric-files">Metric files</a>)
format. It's much easier for both programs and humans to create the
@@ -3743,8 +3549,8 @@ output by default is undesirable.)
<p>For an example of property list format, see the previous section.
<div class="node">
-<p><hr>
<a name="vftovp-invocation"></a>
+<p><hr>
Next:&nbsp;<a rel="next" accesskey="n" href="#vptovf-invocation">vptovf invocation</a>,
Previous:&nbsp;<a rel="previous" accesskey="p" href="#pltotf-invocation">pltotf invocation</a>,
Up:&nbsp;<a rel="up" accesskey="u" href="#Font-utilities">Font utilities</a>
@@ -3753,7 +3559,7 @@ Up:&nbsp;<a rel="up" accesskey="u" href="#Font-utilities">Font utilities</a>
<h3 class="section">10.8 VFtoVP: Virtual font to virtual property lists</h3>
-<p><a name="index-vftovp-811"></a><a name="index-conversion_002c-VF-to-VPL-812"></a><a name="index-validation_002c-of-VF-files-813"></a><a name="index-property-list_002c-converting-VF-to-virtual-814"></a><a name="index-human_002dreadable-text_002c-converting-VF-to-815"></a><a name="index-plain-text_002c-converting-VF-to-816"></a>
+<p><a name="index-vftovp-766"></a><a name="index-conversion_002c-VF-to-VPL-767"></a><a name="index-validation_002c-of-VF-files-768"></a><a name="index-property-list_002c-converting-VF-to-virtual-769"></a><a name="index-human_002dreadable-text_002c-converting-VF-to-770"></a><a name="index-plain-text_002c-converting-VF-to-771"></a>
VFtoVP translates a virtual font metric (VF, see <a href="dvips.html#Virtual-fonts">Virtual fonts</a>) file and its accompanying TeX font metric (TFM,
see <a href="dvips.html#Metric-files">Metric files</a>) file (as output by VPtoVF, for
example) to <dfn>virtual property list format</dfn> (a list of parenthesized
@@ -3778,7 +3584,7 @@ companion program VFtoVP (see the next section).
<p>The program accepts the following option, as well as the standard
&lsquo;<samp><span class="samp">-verbose</span></samp>&rsquo;, &lsquo;<samp><span class="samp">-help</span></samp>&rsquo; and &lsquo;<samp><span class="samp">-version</span></samp>&rsquo; (see <a href="#Common-options">Common options</a>):
<dl>
-<dt>&lsquo;<samp><span class="samp">-charcode-format=</span><var>type</var></samp>&rsquo;<dd><a name="index-g_t_002dcharcode_002dformat_003d_0040var_007btype_007d-817"></a>Output character codes in the PL file according to <var>type</var>: either
+<dt>&lsquo;<samp><span class="samp">-charcode-format=</span><var>type</var></samp>&rsquo;<dd><a name="index-g_t_002dcharcode_002dformat_003d_0040var_007btype_007d-772"></a>Output character codes in the PL file according to <var>type</var>: either
&lsquo;<samp><span class="samp">octal</span></samp>&rsquo; or &lsquo;<samp><span class="samp">ascii</span></samp>&rsquo;. Default is &lsquo;<samp><span class="samp">ascii</span></samp>&rsquo; for letters and
digits, octal for all other characters. Exception: if the font's coding
scheme starts with &lsquo;<samp><span class="samp">TeX math sy</span></samp>&rsquo; or &lsquo;<samp><span class="samp">TeX math ex</span></samp>&rsquo;, all
@@ -3796,8 +3602,8 @@ confusing.
</dl>
<div class="node">
-<p><hr>
<a name="vptovf-invocation"></a>
+<p><hr>
Next:&nbsp;<a rel="next" accesskey="n" href="#Font-utilities-available-elsewhere">Font utilities available elsewhere</a>,
Previous:&nbsp;<a rel="previous" accesskey="p" href="#vftovp-invocation">vftovp invocation</a>,
Up:&nbsp;<a rel="up" accesskey="u" href="#Font-utilities">Font utilities</a>
@@ -3806,7 +3612,7 @@ Up:&nbsp;<a rel="up" accesskey="u" href="#Font-utilities">Font utilities</a>
<h3 class="section">10.9 VPtoVF: Virtual property lists to virtual font</h3>
-<p><a name="index-vptovf-818"></a><a name="index-conversion_002c-property-list-to-VF-819"></a><a name="index-VF-files_002c-converting-property-lists-to-820"></a><a name="index-machine_002dreadable_002c-converting-property-lists-to-821"></a>
+<p><a name="index-vptovf-773"></a><a name="index-conversion_002c-property-list-to-VF-774"></a><a name="index-VF-files_002c-converting-property-lists-to-775"></a><a name="index-machine_002dreadable_002c-converting-property-lists-to-776"></a>
VPtoVF translates a virtual property list file (as output by VFtoVP, for
example) to virtual font (VF, see <a href="dvips.html#Virtual-fonts">Virtual fonts</a>) and
TeX font metric (TFM, see <a href="dvips.html#Metric-files">Metric files</a>) files.
@@ -3826,8 +3632,8 @@ specified, the VF output is written to the basename of
(see <a href="#Common-options">Common options</a>).
<div class="node">
-<p><hr>
<a name="Font-utilities-available-elsewhere"></a>
+<p><hr>
Previous:&nbsp;<a rel="previous" accesskey="p" href="#vptovf-invocation">vptovf invocation</a>,
Up:&nbsp;<a rel="up" accesskey="u" href="#Font-utilities">Font utilities</a>
@@ -3835,7 +3641,7 @@ Up:&nbsp;<a rel="up" accesskey="u" href="#Font-utilities">Font utilities</a>
<h3 class="section">10.10 Font utilities available elsewhere</h3>
-<p><a name="index-font-utilities_002c-non_002dWeb2c-822"></a>
+<p><a name="index-font-utilities_002c-non_002dWeb2c-777"></a>
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><span class="file">/fonts/utilities</span></samp> (for CTAN info,
@@ -3843,17 +3649,17 @@ see <a href="kpathsea.html#unixtex_002eftp">unixtex.ftp</a>). Here are some of
commonly-requested items:
<ul>
-<li><a name="index-AFM-to-TFM-conversion-823"></a><a name="index-afm2tfm-824"></a><a name="index-afmtopl-825"></a>AFM (Adobe font metric) to TFM conversion: see <a href="dvips.html#Invoking-afm2tfm">Invoking afm2tfm</a>, and <samp><var>CTAN:</var><span class="file">/fonts/utilities/afmtopl</span></samp>.
+<li><a name="index-AFM-to-TFM-conversion-778"></a><a name="index-afm2tfm-779"></a><a name="index-afmtopl-780"></a>AFM (Adobe font metric) to TFM conversion: see <a href="dvips.html#Invoking-afm2tfm">Invoking afm2tfm</a>, and <samp><var>CTAN:</var><span class="file">/fonts/utilities/afmtopl</span></samp>.
- <li><a name="index-X-bitmap-fonts-826"></a><a name="index-BDF-and-GF-conversion-827"></a>BDF (the X bitmap format) conversion:
+ <li><a name="index-X-bitmap-fonts-781"></a><a name="index-BDF-and-GF-conversion-782"></a>BDF (the X bitmap format) conversion:
<a href="ftp://ftp.tug.org/tex/bdf.tar.gz">ftp://ftp.tug.org/tex/bdf.tar.gz</a>.
- <li><a name="index-metatype1-828"></a><a name="index-Latin-Modern-829"></a>Creating fonts using MetaPost: MetaType1.
+ <li><a name="index-metatype1-783"></a><a name="index-Latin-Modern-784"></a>Creating fonts using MetaPost: MetaType1.
<a href="ftp://bop.eps.gda.pl/pub/metatype1">ftp://bop.eps.gda.pl/pub/metatype1</a>. This is used to create
the excellent Latin Modern font family (<samp><var>CTAN:</var><span class="file">/fonts/lm</span></samp>),
which extends Computer Modern to a vast repertoire of scripts.
- <li><a name="index-editing-of-bitmap-fonts-830"></a><a name="index-xbfe_0040r_007b_002c-bitmap-font-editor_007d-831"></a><a name="index-xfed_0040r_007b_002c-bitmap-font-editor_007d-832"></a><a name="index-xfedor_0040r_007b_002c-bitmap-font-editor_007d-833"></a><a name="index-gftopxl-834"></a><a name="index-chtopx-835"></a><a name="index-pxtoch-836"></a>Editing of bitmap fonts: Xbfe from the GNU font utilities mentioned
+ <li><a name="index-editing-of-bitmap-fonts-785"></a><a name="index-xbfe_0040r_007b_002c-bitmap-font-editor_007d-786"></a><a name="index-xfed_0040r_007b_002c-bitmap-font-editor_007d-787"></a><a name="index-xfedor_0040r_007b_002c-bitmap-font-editor_007d-788"></a><a name="index-gftopxl-789"></a><a name="index-chtopx-790"></a><a name="index-pxtoch-791"></a>Editing of bitmap fonts: Xbfe from the GNU font utilities mentioned
below; the X BDF-editing programs available from
<a href="ftp://ftp.x.org/R5contrib/xfed.tar.Z">ftp://ftp.x.org/R5contrib/xfed.tar.Z</a> and
<a href="ftp://ftp.x.org/R5contrib/xfedor.tar.Z">ftp://ftp.x.org/R5contrib/xfedor.tar.Z</a>; and finally, if your
@@ -3861,35 +3667,35 @@ fonts have only 128 characters, you can use the old <code>gftopxl</code>,
<code>pxtoch</code>, and <code>chtopx</code> programs from
<a href="ftp://ftp.tug.org/tex/web">ftp://ftp.tug.org/tex/web</a>.
- <li><a name="index-fontforge-837"></a><a name="index-pfaedit-838"></a>Editing of outline fonts: FontForge, <a href="fontforge.sourceforge.net">fontforge.sourceforge.net</a>.
+ <li><a name="index-fontforge-792"></a><a name="index-pfaedit-793"></a>Editing of outline fonts: FontForge, <a href="fontforge.sourceforge.net">fontforge.sourceforge.net</a>.
This is a very elaborate program with support for many outline formats
(Type&nbsp;1, OpenType, TrueType, <small class="dots">...</small>), and many advanced font
editing features.
- <li><a name="index-PK-bitmaps-from-PostScript-839"></a><a name="index-PostScript-to-PK-bitmaps-840"></a><a name="index-gsftopk-841"></a><a name="index-ps2pk-842"></a>PK bitmaps from PostScript outline fonts: gsftopk from the &lsquo;<samp><span class="samp">xdvi</span></samp>&rsquo;
+ <li><a name="index-PK-bitmaps-from-PostScript-794"></a><a name="index-PostScript-to-PK-bitmaps-795"></a><a name="index-gsftopk-796"></a><a name="index-ps2pk-797"></a>PK bitmaps from PostScript outline fonts: gsftopk from the &lsquo;<samp><span class="samp">xdvi</span></samp>&rsquo;
distribution. Alternatively, <code>ps2pk</code>, from
<samp><var>CTAN:</var><span class="file">/fonts/utilities/ps2pk</span></samp>.
- <li><a name="index-Type-1-conversion-843"></a><a name="index-PFA-and-PFB-conversion-844"></a><a name="index-PostScript-Type-1-font-conversion-845"></a>PostScript Type 1 font format conversion (i.e., between PFA and PFB
+ <li><a name="index-Type-1-conversion-798"></a><a name="index-PFA-and-PFB-conversion-799"></a><a name="index-PostScript-Type-1-font-conversion-800"></a>PostScript Type 1 font format conversion (i.e., between PFA and PFB
formats): <a href="http://www.lcdf.org/type">http://www.lcdf.org/type</a>.
- <li><a name="index-scanned-images-of-fonts-846"></a><a name="index-typeface-specimen-sheets-847"></a><a name="index-fontutils-848"></a>Scanned image conversion: the (aging) GNU font utilities convert type
+ <li><a name="index-scanned-images-of-fonts-801"></a><a name="index-typeface-specimen-sheets-802"></a><a name="index-fontutils-803"></a>Scanned image conversion: the (aging) GNU font utilities convert type
specimen images to Metafont, PostScript, etc.:
<a href="http://www.gnu.org/software/fontutils/">http://www.gnu.org/software/fontutils/</a>.
- <li><a name="index-autotrace-849"></a><a name="index-potrace-850"></a>Tracing bitmaps to fitted outlines: Autotrace
+ <li><a name="index-autotrace-804"></a><a name="index-potrace-805"></a>Tracing bitmaps to fitted outlines: Autotrace
(<a href="http://autotrace.sourceforge.net">http://autotrace.sourceforge.net</a>), Potrace
(<a href="http://potrace.sourceforge.net">http://potrace.sourceforge.net</a>). For Metafont fonts, either of
the two programs <code>mftrace</code>
(<a href="http://www.xs4all.nl/~hanwen/mftrace">http://www.xs4all.nl/~hanwen/mftrace</a>) or <code>textrace</code>
(<a href="http://textrace.sourceforge.net">http://textrace.sourceforge.net</a>) make the job easier.
- <li><a name="index-virtual-font-creation-851"></a><a name="index-fontinst_0040r_007b_002c-for-creating-virtual-fonts_007d-852"></a>Virtual font creation: <samp><var>CTAN:</var><span class="file">/fonts/utilities/fontinst</span></samp>.
+ <li><a name="index-virtual-font-creation-806"></a><a name="index-fontinst_0040r_007b_002c-for-creating-virtual-fonts_007d-807"></a>Virtual font creation: <samp><var>CTAN:</var><span class="file">/fonts/utilities/fontinst</span></samp>.
</ul>
<div class="node">
-<p><hr>
<a name="Legalisms"></a>
+<p><hr>
Next:&nbsp;<a rel="next" accesskey="n" href="#References">References</a>,
Previous:&nbsp;<a rel="previous" accesskey="p" href="#Font-utilities">Font utilities</a>,
Up:&nbsp;<a rel="up" accesskey="u" href="#Top">Top</a>
@@ -3898,7 +3704,7 @@ Up:&nbsp;<a rel="up" accesskey="u" href="#Top">Top</a>
<h2 class="appendix">Appendix A Legalisms</h2>
-<p><a name="index-legalisms-853"></a><a name="index-copyright-notices-854"></a><a name="index-permissions_002c-legal-855"></a>
+<p><a name="index-legalisms-808"></a><a name="index-copyright-notices-809"></a><a name="index-permissions_002c-legal-810"></a>
In general, each file has its own copyright notice stating the copying
permissions for that file. Following is a summary.
@@ -3942,8 +3748,8 @@ software.
</blockquote>
<div class="node">
-<p><hr>
<a name="References"></a>
+<p><hr>
Next:&nbsp;<a rel="next" accesskey="n" href="#Index">Index</a>,
Previous:&nbsp;<a rel="previous" accesskey="p" href="#Legalisms">Legalisms</a>,
Up:&nbsp;<a rel="up" accesskey="u" href="#Top">Top</a>
@@ -3952,7 +3758,7 @@ Up:&nbsp;<a rel="up" accesskey="u" href="#Top">Top</a>
<h2 class="appendix">Appendix B References</h2>
-<p><a name="index-references-856"></a><a name="index-bibliography-857"></a>
+<p><a name="index-references-811"></a><a name="index-bibliography-812"></a>
<ol type=1 start=1>
<li>Kpathsea: See <a href="kpathsea.html#Top">Introduction</a>.
@@ -4052,7 +3858,7 @@ Donald E. Knuth.
The errors of TeX.
<cite>Software&mdash;Practice and Experience</cite>, 19(7):607&ndash;681, July
1989.
-This is an updated version of iteKnuth:1988:ET.
+This is an updated version of Knuth:1988:ET.
<li>[Knu90]
Donald Knuth.
@@ -4102,8 +3908,8 @@ American Mathematical Society, Providence, RI, USA, 2nd revised edition, 1990.
</ol>
<div class="node">
-<p><hr>
<a name="Index"></a>
+<p><hr>
Previous:&nbsp;<a rel="previous" accesskey="p" href="#References">References</a>,
Up:&nbsp;<a rel="up" accesskey="u" href="#Top">Top</a>
@@ -4121,39 +3927,39 @@ Up:&nbsp;<a rel="up" accesskey="u" href="#Top">Top</a>
<li><a href="#index-g_t_002d_002ddisable_002ddump_002dshare-configure-_0040r_007boption_007d-197"><code>--disable-dump-share configure </code><span class="roman">option</span></a>: <a href="#Hardware-and-memory-dumps">Hardware and memory dumps</a></li>
<li><a href="#index-g_t_002d_002denable_002dipc-configure-_0040r_007boption_007d-252"><code>--enable-ipc configure </code><span class="roman">option</span></a>: <a href="#tex-invocation">tex invocation</a></li>
<li><a href="#index-g_t_002d_002dhelp-_0040r_007bcommon-option_007d-96"><code>--help </code><span class="roman">common option</span></a>: <a href="#Common-options">Common options</a></li>
-<li><a href="#index-g_t_002d_002dquiet-_0028newer_0029-580"><code>--quiet (newer)</code></a>: <a href="#newer-invocation">newer invocation</a></li>
-<li><a href="#index-g_t_002d_002dverbose-_0028newer_0029-581"><code>--verbose (newer)</code></a>: <a href="#newer-invocation">newer invocation</a></li>
<li><a href="#index-g_t_002d_002dverbose-_0040r_007bcommon-option_007d-98"><code>--verbose </code><span class="roman">common option</span></a>: <a href="#Common-options">Common options</a></li>
<li><a href="#index-g_t_002d_002dversion-_0040r_007bcommon-option_007d-100"><code>--version </code><span class="roman">common option</span></a>: <a href="#Common-options">Common options</a></li>
<li><a href="#index-g_t_002d_002dwith_002deditor_003d_0040var_007bcmd_007d-213"><code>--with-editor=</code><var>cmd</var></a>: <a href="#Editor-invocation">Editor invocation</a></li>
-<li><a href="#index-g_t_002d_002dwith_002depsfwin-406"><code>--with-epsfwin</code></a>: <a href="#Online-Metafont-graphics">Online Metafont graphics</a></li>
-<li><a href="#index-g_t_002d_002dwith_002dhp2627win-408"><code>--with-hp2627win</code></a>: <a href="#Online-Metafont-graphics">Online Metafont graphics</a></li>
-<li><a href="#index-g_t_002d_002dwith_002dmftalkwin-410"><code>--with-mftalkwin</code></a>: <a href="#Online-Metafont-graphics">Online Metafont graphics</a></li>
-<li><a href="#index-g_t_002d_002dwith_002dnext-413"><code>--with-next</code></a>: <a href="#Online-Metafont-graphics">Online Metafont graphics</a></li>
-<li><a href="#index-g_t_002d_002dwith_002dregiswin-415"><code>--with-regiswin</code></a>: <a href="#Online-Metafont-graphics">Online Metafont graphics</a></li>
-<li><a href="#index-g_t_002d_002dwith_002dsuntoolswin-420"><code>--with-suntoolswin</code></a>: <a href="#Online-Metafont-graphics">Online Metafont graphics</a></li>
-<li><a href="#index-g_t_002d_002dwith_002dtektronixwin-424"><code>--with-tektronixwin</code></a>: <a href="#Online-Metafont-graphics">Online Metafont graphics</a></li>
-<li><a href="#index-g_t_002d_002dwith_002dunitermwin-428"><code>--with-unitermwin</code></a>: <a href="#Online-Metafont-graphics">Online Metafont graphics</a></li>
-<li><a href="#index-g_t_002d_002dwith_002dx-434"><code>--with-x</code></a>: <a href="#Online-Metafont-graphics">Online Metafont graphics</a></li>
-<li><a href="#index-g_t_002d_002dwith_002dx_002dtoolkit_003d_0040var_007bkit_007d-436"><code>--with-x-toolkit=</code><var>kit</var></a>: <a href="#Online-Metafont-graphics">Online Metafont graphics</a></li>
-<li><a href="#index-g_t_002d_002dwith_002dx11-435"><code>--with-x11</code></a>: <a href="#Online-Metafont-graphics">Online Metafont graphics</a></li>
-<li><a href="#index-g_t_002d_002dwith_002dx11win-433"><code>--with-x11win</code></a>: <a href="#Online-Metafont-graphics">Online Metafont graphics</a></li>
+<li><a href="#index-g_t_002d_002dwith_002depsfwin-417"><code>--with-epsfwin</code></a>: <a href="#Online-Metafont-graphics">Online Metafont graphics</a></li>
+<li><a href="#index-g_t_002d_002dwith_002dhp2627win-419"><code>--with-hp2627win</code></a>: <a href="#Online-Metafont-graphics">Online Metafont graphics</a></li>
+<li><a href="#index-g_t_002d_002dwith_002dmftalkwin-421"><code>--with-mftalkwin</code></a>: <a href="#Online-Metafont-graphics">Online Metafont graphics</a></li>
+<li><a href="#index-g_t_002d_002dwith_002dnext-424"><code>--with-next</code></a>: <a href="#Online-Metafont-graphics">Online Metafont graphics</a></li>
+<li><a href="#index-g_t_002d_002dwith_002dregiswin-426"><code>--with-regiswin</code></a>: <a href="#Online-Metafont-graphics">Online Metafont graphics</a></li>
+<li><a href="#index-g_t_002d_002dwith_002dsuntoolswin-431"><code>--with-suntoolswin</code></a>: <a href="#Online-Metafont-graphics">Online Metafont graphics</a></li>
+<li><a href="#index-g_t_002d_002dwith_002dtektronixwin-435"><code>--with-tektronixwin</code></a>: <a href="#Online-Metafont-graphics">Online Metafont graphics</a></li>
+<li><a href="#index-g_t_002d_002dwith_002dunitermwin-439"><code>--with-unitermwin</code></a>: <a href="#Online-Metafont-graphics">Online Metafont graphics</a></li>
+<li><a href="#index-g_t_002d_002dwith_002dx-445"><code>--with-x</code></a>: <a href="#Online-Metafont-graphics">Online Metafont graphics</a></li>
+<li><a href="#index-g_t_002d_002dwith_002dx_002dtoolkit_003d_0040var_007bkit_007d-447"><code>--with-x-toolkit=</code><var>kit</var></a>: <a href="#Online-Metafont-graphics">Online Metafont graphics</a></li>
+<li><a href="#index-g_t_002d_002dwith_002dx11-446"><code>--with-x11</code></a>: <a href="#Online-Metafont-graphics">Online Metafont graphics</a></li>
+<li><a href="#index-g_t_002d_002dwith_002dx11win-444"><code>--with-x11win</code></a>: <a href="#Online-Metafont-graphics">Online Metafont graphics</a></li>
<li><a href="#index-g_t_002d8bit-138"><code>-8bit</code></a>: <a href="#Common-options">Common options</a></li>
<li><a href="#index-g_t_002dbase_003d_0040var_007bbase_007d-179"><code>-base=</code><var>base</var></a>: <a href="#Determining-the-memory-dump-to-use">Determining the memory dump to use</a></li>
<li><a href="#index-g_t_002dbase_003d_0040var_007bdumpname_007d-107"><code>-base=</code><var>dumpname</var></a>: <a href="#Common-options">Common options</a></li>
-<li><a href="#index-g_t_002dchange_003d_0040var_007bchfile_007d-471"><code>-change=</code><var>chfile</var></a>: <a href="#mft-invocation">mft invocation</a></li>
-<li><a href="#index-g_t_002dcharcode_002dformat_003d_0040var_007btype_007d-817"><code>-charcode-format=</code><var>type</var></a>: <a href="#vftovp-invocation">vftovp invocation</a></li>
-<li><a href="#index-g_t_002dcharcode_002dformat_003d_0040var_007btype_007d-788"><code>-charcode-format=</code><var>type</var></a>: <a href="#tftopl-invocation">tftopl invocation</a></li>
+<li><a href="#index-g_t_002dchange_003d_0040var_007bchfile_007d-482"><code>-change=</code><var>chfile</var></a>: <a href="#mft-invocation">mft invocation</a></li>
+<li><a href="#index-g_t_002dcharcode_002dformat_003d_0040var_007btype_007d-772"><code>-charcode-format=</code><var>type</var></a>: <a href="#vftovp-invocation">vftovp invocation</a></li>
+<li><a href="#index-g_t_002dcharcode_002dformat_003d_0040var_007btype_007d-743"><code>-charcode-format=</code><var>type</var></a>: <a href="#tftopl-invocation">tftopl invocation</a></li>
<li><a href="#index-g_t_002dD-_0040r_007bcompiler-options_007d-37"><code>-D </code><span class="roman">compiler options</span></a>: <a href="#Compile_002dtime-options">Compile-time options</a></li>
-<li><a href="#index-g_t_002ddpi_003d_0040var_007breal_007d-681"><code>-dpi=</code><var>real</var></a>: <a href="#dvitype-invocation">dvitype invocation</a></li>
+<li><a href="#index-g_t_002ddisable_002dwrite18-266"><code>-disable-write18</code></a>: <a href="#tex-invocation">tex invocation</a></li>
+<li><a href="#index-g_t_002ddpi_003d_0040var_007breal_007d-636"><code>-dpi=</code><var>real</var></a>: <a href="#dvitype-invocation">dvitype invocation</a></li>
+<li><a href="#index-g_t_002denable_002dwrite18-265"><code>-enable-write18</code></a>: <a href="#tex-invocation">tex invocation</a></li>
<li><a href="#index-g_t_002denc-247"><code>-enc</code></a>: <a href="#tex-invocation">tex invocation</a></li>
<li><a href="#index-g_t_002dfile_002dline_002derror-102"><code>-file-line-error</code></a>: <a href="#Common-options">Common options</a></li>
<li><a href="#index-g_t_002dfile_002dline_002derror_002dstyle-104"><code>-file-line-error-style</code></a>: <a href="#Common-options">Common options</a></li>
<li><a href="#index-g_t_002dfmt_003d_0040var_007bdumpname_007d-106"><code>-fmt=</code><var>dumpname</var></a>: <a href="#Common-options">Common options</a></li>
<li><a href="#index-g_t_002dfmt_003d_0040var_007bfmt_007d-178"><code>-fmt=</code><var>fmt</var></a>: <a href="#Determining-the-memory-dump-to-use">Determining the memory dump to use</a></li>
-<li><a href="#index-g_t_002dgeometry_0040r_007b_002c-supported-with-Xt_007d-448"><code>-geometry</code><span class="roman">, supported with Xt</span></a>: <a href="#Online-Metafont-graphics">Online Metafont graphics</a></li>
+<li><a href="#index-g_t_002dgeometry_0040r_007b_002c-supported-with-Xt_007d-459"><code>-geometry</code><span class="roman">, supported with Xt</span></a>: <a href="#Online-Metafont-graphics">Online Metafont graphics</a></li>
<li><a href="#index-g_t_002dhalt_002don_002derror-110"><code>-halt-on-error</code></a>: <a href="#Common-options">Common options</a></li>
-<li><a href="#index-g_t_002dimages-762"><code>-images</code></a>: <a href="#gftype-invocation">gftype invocation</a></li>
+<li><a href="#index-g_t_002dimages-717"><code>-images</code></a>: <a href="#gftype-invocation">gftype invocation</a></li>
<li><a href="#index-g_t_002dini-162"><code>-ini</code></a>: <a href="#Initial-and-virgin">Initial and virgin</a></li>
<li><a href="#index-g_t_002dini-112"><code>-ini</code></a>: <a href="#Common-options">Common options</a></li>
<li><a href="#index-g_t_002dinteraction_003d_0040var_007bstring_007d-115"><code>-interaction=</code><var>string</var></a>: <a href="#Common-options">Common options</a></li>
@@ -4161,23 +3967,23 @@ Up:&nbsp;<a rel="up" accesskey="u" href="#Top">Top</a>
<li><a href="#index-g_t_002dipc_002dstart-251"><code>-ipc-start</code></a>: <a href="#tex-invocation">tex invocation</a></li>
<li><a href="#index-g_t_002djobname_003d_0040var_007bstring_007d-117"><code>-jobname=</code><var>string</var></a>: <a href="#Common-options">Common options</a></li>
<li><a href="#index-g_t_002dkpathsea_002ddebug_003d_0040var_007bnumber_007d-119"><code>-kpathsea-debug=</code><var>number</var></a>: <a href="#Common-options">Common options</a></li>
-<li><a href="#index-g_t_002dlength_003d_0040var_007bnumber_007d-636"><code>-length=</code><var>number</var></a>: <a href="#tangle-invocation">tangle invocation</a></li>
-<li><a href="#index-g_t_002dloose-644"><code>-loose</code></a>: <a href="#tangle-invocation">tangle invocation</a></li>
-<li><a href="#index-g_t_002dlowercase-638"><code>-lowercase</code></a>: <a href="#tangle-invocation">tangle invocation</a></li>
-<li><a href="#index-g_t_002dmagnification_003d_0040var_007binteger_007d-682"><code>-magnification=</code><var>integer</var></a>: <a href="#dvitype-invocation">dvitype invocation</a></li>
-<li><a href="#index-g_t_002dmagnification_003d_0040var_007binteger_007d-667"><code>-magnification=</code><var>integer</var></a>: <a href="#dvicopy-invocation">dvicopy invocation</a></li>
-<li><a href="#index-g_t_002dmax_002dpages_003d_0040var_007bn_007d-685"><code>-max-pages=</code><var>n</var></a>: <a href="#dvitype-invocation">dvitype invocation</a></li>
-<li><a href="#index-g_t_002dmax_002dpages_003d_0040var_007bn_007d-670"><code>-max-pages=</code><var>n</var></a>: <a href="#dvicopy-invocation">dvicopy invocation</a></li>
+<li><a href="#index-g_t_002dlength_003d_0040var_007bnumber_007d-591"><code>-length=</code><var>number</var></a>: <a href="#tangle-invocation">tangle invocation</a></li>
+<li><a href="#index-g_t_002dloose-599"><code>-loose</code></a>: <a href="#tangle-invocation">tangle invocation</a></li>
+<li><a href="#index-g_t_002dlowercase-593"><code>-lowercase</code></a>: <a href="#tangle-invocation">tangle invocation</a></li>
+<li><a href="#index-g_t_002dmagnification_003d_0040var_007binteger_007d-637"><code>-magnification=</code><var>integer</var></a>: <a href="#dvitype-invocation">dvitype invocation</a></li>
+<li><a href="#index-g_t_002dmagnification_003d_0040var_007binteger_007d-622"><code>-magnification=</code><var>integer</var></a>: <a href="#dvicopy-invocation">dvicopy invocation</a></li>
+<li><a href="#index-g_t_002dmax_002dpages_003d_0040var_007bn_007d-640"><code>-max-pages=</code><var>n</var></a>: <a href="#dvitype-invocation">dvitype invocation</a></li>
+<li><a href="#index-g_t_002dmax_002dpages_003d_0040var_007bn_007d-625"><code>-max-pages=</code><var>n</var></a>: <a href="#dvicopy-invocation">dvicopy invocation</a></li>
<li><a href="#index-g_t_002dmem_003d_0040var_007bdumpname_007d-108"><code>-mem=</code><var>dumpname</var></a>: <a href="#Common-options">Common options</a></li>
<li><a href="#index-g_t_002dmem_003d_0040var_007bmem_007d-180"><code>-mem=</code><var>mem</var></a>: <a href="#Determining-the-memory-dump-to-use">Determining the memory dump to use</a></li>
-<li><a href="#index-g_t_002dmin_002dcrossrefs_003d_0040var_007bn_007d-598"><code>-min-crossrefs=</code><var>n</var></a>: <a href="#bibtex-invocation">bibtex invocation</a></li>
-<li><a href="#index-g_t_002dmixedcase-639"><code>-mixedcase</code></a>: <a href="#tangle-invocation">tangle invocation</a></li>
-<li><a href="#index-g_t_002dmktex_003d_0040var_007bfiletype_007d-376"><code>-mktex=</code><var>filetype</var></a>: <a href="#mf-invocation">mf invocation</a></li>
+<li><a href="#index-g_t_002dmin_002dcrossrefs_003d_0040var_007bn_007d-554"><code>-min-crossrefs=</code><var>n</var></a>: <a href="#bibtex-invocation">bibtex invocation</a></li>
+<li><a href="#index-g_t_002dmixedcase-594"><code>-mixedcase</code></a>: <a href="#tangle-invocation">tangle invocation</a></li>
+<li><a href="#index-g_t_002dmktex_003d_0040var_007bfiletype_007d-387"><code>-mktex=</code><var>filetype</var></a>: <a href="#mf-invocation">mf invocation</a></li>
<li><a href="#index-g_t_002dmktex_003d_0040var_007bfiletype_007d-253"><code>-mktex=</code><var>filetype</var></a>: <a href="#tex-invocation">tex invocation</a></li>
<li><a href="#index-g_t_002dmltex-255"><code>-mltex</code></a>: <a href="#tex-invocation">tex invocation</a></li>
-<li><a href="#index-g_t_002dmnemonics-763"><code>-mnemonics</code></a>: <a href="#gftype-invocation">gftype invocation</a></li>
+<li><a href="#index-g_t_002dmnemonics-718"><code>-mnemonics</code></a>: <a href="#gftype-invocation">gftype invocation</a></li>
<li><a href="#index-g_t_002dno_002dfile_002dline_002derror-103"><code>-no-file-line-error</code></a>: <a href="#Common-options">Common options</a></li>
-<li><a href="#index-g_t_002dno_002dmktex_003d_0040var_007bfiletype_007d-377"><code>-no-mktex=</code><var>filetype</var></a>: <a href="#mf-invocation">mf invocation</a></li>
+<li><a href="#index-g_t_002dno_002dmktex_003d_0040var_007bfiletype_007d-388"><code>-no-mktex=</code><var>filetype</var></a>: <a href="#mf-invocation">mf invocation</a></li>
<li><a href="#index-g_t_002dno_002dmktex_003d_0040var_007bfiletype_007d-254"><code>-no-mktex=</code><var>filetype</var></a>: <a href="#tex-invocation">tex invocation</a></li>
<li><a href="#index-g_t_002dno_002dparse_002dfirst_002dline-126"><code>-no-parse-first-line</code></a>: <a href="#Common-options">Common options</a></li>
<li><a href="#index-g_t_002dno_002dshell_002descape-263"><code>-no-shell-escape</code></a>: <a href="#tex-invocation">tex invocation</a></li>
@@ -4185,357 +3991,340 @@ Up:&nbsp;<a rel="up" accesskey="u" href="#Top">Top</a>
<li><a href="#index-g_t_002doutput_002dcomment_003d_0040var_007bstring_007d-258"><code>-output-comment=</code><var>string</var></a>: <a href="#tex-invocation">tex invocation</a></li>
<li><a href="#index-g_t_002doutput_002ddirectory-152"><code>-output-directory</code></a>: <a href="#Output-file-location">Output file location</a></li>
<li><a href="#index-g_t_002doutput_002ddirectory-123"><code>-output-directory</code></a>: <a href="#Common-options">Common options</a></li>
-<li><a href="#index-g_t_002doutput_002dlevel_003d_0040var_007bn_007d-686"><code>-output-level=</code><var>n</var></a>: <a href="#dvitype-invocation">dvitype invocation</a></li>
-<li><a href="#index-g_t_002doverflow_002dlabel_002doffset_003d_0040var_007bpoints_007d-461"><code>-overflow-label-offset=</code><var>points</var></a>: <a href="#gftodvi-invocation">gftodvi invocation</a></li>
-<li><a href="#index-g_t_002dpage_002dstart_003d_0040var_007bpage_002dspec_007d-687"><code>-page-start=</code><var>page-spec</var></a>: <a href="#dvitype-invocation">dvitype invocation</a></li>
-<li><a href="#index-g_t_002dpage_002dstart_003d_0040var_007bpage_002dspec_007d-671"><code>-page-start=</code><var>page-spec</var></a>: <a href="#dvicopy-invocation">dvicopy invocation</a></li>
+<li><a href="#index-g_t_002doutput_002dlevel_003d_0040var_007bn_007d-641"><code>-output-level=</code><var>n</var></a>: <a href="#dvitype-invocation">dvitype invocation</a></li>
+<li><a href="#index-g_t_002doverflow_002dlabel_002doffset_003d_0040var_007bpoints_007d-472"><code>-overflow-label-offset=</code><var>points</var></a>: <a href="#gftodvi-invocation">gftodvi invocation</a></li>
+<li><a href="#index-g_t_002dpage_002dstart_003d_0040var_007bpage_002dspec_007d-642"><code>-page-start=</code><var>page-spec</var></a>: <a href="#dvitype-invocation">dvitype invocation</a></li>
+<li><a href="#index-g_t_002dpage_002dstart_003d_0040var_007bpage_002dspec_007d-626"><code>-page-start=</code><var>page-spec</var></a>: <a href="#dvicopy-invocation">dvicopy invocation</a></li>
<li><a href="#index-g_t_002dparse_002dfirst_002dline-125"><code>-parse-first-line</code></a>: <a href="#Common-options">Common options</a></li>
<li><a href="#index-g_t_002dprogname_003d_0040var_007bstring_007d-181"><code>-progname=</code><var>string</var></a>: <a href="#Determining-the-memory-dump-to-use">Determining the memory dump to use</a></li>
<li><a href="#index-g_t_002dprogname_003d_0040var_007bstring_007d-128"><code>-progname=</code><var>string</var></a>: <a href="#Common-options">Common options</a></li>
<li><a href="#index-g_t_002drecorder-132"><code>-recorder</code></a>: <a href="#Common-options">Common options</a></li>
<li><a href="#index-g_t_002dshell_002descape-262"><code>-shell-escape</code></a>: <a href="#tex-invocation">tex invocation</a></li>
-<li><a href="#index-g_t_002dshow_002dopcodes-691"><code>-show-opcodes</code></a>: <a href="#dvitype-invocation">dvitype invocation</a></li>
-<li><a href="#index-g_t_002dstrict-645"><code>-strict</code></a>: <a href="#tangle-invocation">tangle invocation</a></li>
-<li><a href="#index-g_t_002dstyle_003d_0040var_007bmftfile_007d-473"><code>-style=</code><var>mftfile</var></a>: <a href="#mft-invocation">mft invocation</a></li>
-<li><a href="#index-g_t_002dT-505"><code>-T</code></a>: <a href="#mpost-invocation">mpost invocation</a></li>
-<li><a href="#index-g_t_002dterse-595"><code>-terse</code></a>: <a href="#bibtex-invocation">bibtex invocation</a></li>
-<li><a href="#index-g_t_002dtex-574"><code>-tex</code></a>: <a href="#mpto-invocation">mpto invocation</a></li>
-<li><a href="#index-g_t_002dtex_003d_0040var_007btexprogram_007d-508"><code>-tex=</code><var>texprogram</var></a>: <a href="#mpost-invocation">mpost invocation</a></li>
+<li><a href="#index-g_t_002dshell_002drestricted-264"><code>-shell-restricted</code></a>: <a href="#tex-invocation">tex invocation</a></li>
+<li><a href="#index-g_t_002dshow_002dopcodes-646"><code>-show-opcodes</code></a>: <a href="#dvitype-invocation">dvitype invocation</a></li>
+<li><a href="#index-g_t_002dstrict-600"><code>-strict</code></a>: <a href="#tangle-invocation">tangle invocation</a></li>
+<li><a href="#index-g_t_002dstyle_003d_0040var_007bmftfile_007d-484"><code>-style=</code><var>mftfile</var></a>: <a href="#mft-invocation">mft invocation</a></li>
+<li><a href="#index-g_t_002dT-516"><code>-T</code></a>: <a href="#mpost-invocation">mpost invocation</a></li>
+<li><a href="#index-g_t_002dterse-551"><code>-terse</code></a>: <a href="#bibtex-invocation">bibtex invocation</a></li>
+<li><a href="#index-g_t_002dtex_003d_0040var_007btexprogram_007d-519"><code>-tex=</code><var>texprogram</var></a>: <a href="#mpost-invocation">mpost invocation</a></li>
<li><a href="#index-g_t_002dtranslate_002dfile_003d_0040var_007btcxfile_007d-134"><code>-translate-file=</code><var>tcxfile</var></a>: <a href="#Common-options">Common options</a></li>
-<li><a href="#index-g_t_002dtroff-573"><code>-troff</code></a>: <a href="#mpto-invocation">mpto invocation</a></li>
-<li><a href="#index-g_t_002dtroff-535"><code>-troff</code></a>: <a href="#makempx-invocation">makempx invocation</a></li>
-<li><a href="#index-g_t_002dtroff-506"><code>-troff</code></a>: <a href="#mpost-invocation">mpost invocation</a></li>
-<li><a href="#index-g_t_002dunderline-642"><code>-underline</code></a>: <a href="#tangle-invocation">tangle invocation</a></li>
-<li><a href="#index-g_t_002duppercase-640"><code>-uppercase</code></a>: <a href="#tangle-invocation">tangle invocation</a></li>
-<li><a href="#index-g_t_002dx-652"><code>-x</code></a>: <a href="#weave-invocation">weave invocation</a></li>
+<li><a href="#index-g_t_002dtroff-517"><code>-troff</code></a>: <a href="#mpost-invocation">mpost invocation</a></li>
+<li><a href="#index-g_t_002dunderline-597"><code>-underline</code></a>: <a href="#tangle-invocation">tangle invocation</a></li>
+<li><a href="#index-g_t_002duppercase-595"><code>-uppercase</code></a>: <a href="#tangle-invocation">tangle invocation</a></li>
+<li><a href="#index-g_t_002dx-607"><code>-x</code></a>: <a href="#weave-invocation">weave invocation</a></li>
<li><a href="#index-g_t_002e_0040r_007b_002c-used-for-output_007d-151"><code>.</code><span class="roman">, used for output</span></a>: <a href="#Output-file-location">Output file location</a></li>
-<li><a href="#index-g_t_002e2602gf-375"><code>.2602gf</code></a>: <a href="#mf-invocation">mf invocation</a></li>
-<li><a href="#index-g_t_002eaux-_0040r_007bcross_002dreference-files_007d-586"><code>.aux </code><span class="roman">cross-reference files</span></a>: <a href="#bibtex-invocation">bibtex invocation</a></li>
-<li><a href="#index-g_t_002ebase-380"><code>.base</code></a>: <a href="#Initial-Metafont">Initial Metafont</a></li>
-<li><a href="#index-g_t_002ebbl-_0040r_007bbibliography-files_007d-585"><code>.bbl </code><span class="roman">bibliography files</span></a>: <a href="#bibtex-invocation">bibtex invocation</a></li>
-<li><a href="#index-g_t_002ebib-_0040r_007bbibliography-databases_007d-587"><code>.bib </code><span class="roman">bibliography databases</span></a>: <a href="#bibtex-invocation">bibtex invocation</a></li>
-<li><a href="#index-g_t_002eblg-_0040r_007bBib_0040TeX_007b_007d-log-file_007d-588"><code>.blg </code><span class="roman">BibTeX log file</span></a>: <a href="#bibtex-invocation">bibtex invocation</a></li>
-<li><a href="#index-g_t_002efmt-274"><code>.fmt</code></a>: <a href="#Initial-TeX">Initial TeX</a></li>
-<li><a href="#index-g_t_002emem-511"><code>.mem</code></a>: <a href="#Initial-MetaPost">Initial MetaPost</a></li>
-<li><a href="#index-g_t_002emf-361"><code>.mf</code></a>: <a href="#mf-invocation">mf invocation</a></li>
-<li><a href="#index-g_t_002emp-487"><code>.mp</code></a>: <a href="#mpost-invocation">mpost invocation</a></li>
-<li><a href="#index-g_t_002e_0040var_007bnnn_007d-_0040r_007bPostScript-figures_007d-490"><code>.</code><var>nnn</var> <span class="roman">PostScript figures</span></a>: <a href="#mpost-invocation">mpost invocation</a></li>
-<li><a href="#index-g_t_002e_0040var_007bnnn_007dgf-_0040r_007bgeneric-fonts_007d-365"><code>.</code><var>nnn</var><code>gf </code><span class="roman">generic fonts</span></a>: <a href="#mf-invocation">mf invocation</a></li>
-<li><a href="#index-g_t_002etcx-_0040r_007bcharacter-translation-files_007d-310"><code>.tcx </code><span class="roman">character translation files</span></a>: <a href="#TCX-files">TCX files</a></li>
+<li><a href="#index-g_t_002e2602gf-386"><code>.2602gf</code></a>: <a href="#mf-invocation">mf invocation</a></li>
+<li><a href="#index-g_t_002eaux-_0040r_007bcross_002dreference-files_007d-542"><code>.aux </code><span class="roman">cross-reference files</span></a>: <a href="#bibtex-invocation">bibtex invocation</a></li>
+<li><a href="#index-g_t_002ebase-391"><code>.base</code></a>: <a href="#Initial-Metafont">Initial Metafont</a></li>
+<li><a href="#index-g_t_002ebbl-_0040r_007bbibliography-files_007d-541"><code>.bbl </code><span class="roman">bibliography files</span></a>: <a href="#bibtex-invocation">bibtex invocation</a></li>
+<li><a href="#index-g_t_002ebib-_0040r_007bbibliography-databases_007d-543"><code>.bib </code><span class="roman">bibliography databases</span></a>: <a href="#bibtex-invocation">bibtex invocation</a></li>
+<li><a href="#index-g_t_002eblg-_0040r_007bBib_0040TeX_007b_007d-log-file_007d-544"><code>.blg </code><span class="roman">BibTeX log file</span></a>: <a href="#bibtex-invocation">bibtex invocation</a></li>
+<li><a href="#index-g_t_002efmt-270"><code>.fmt</code></a>: <a href="#Initial-TeX">Initial TeX</a></li>
+<li><a href="#index-g_t_002emem-522"><code>.mem</code></a>: <a href="#Initial-MetaPost">Initial MetaPost</a></li>
+<li><a href="#index-g_t_002emf-372"><code>.mf</code></a>: <a href="#mf-invocation">mf invocation</a></li>
+<li><a href="#index-g_t_002emp-498"><code>.mp</code></a>: <a href="#mpost-invocation">mpost invocation</a></li>
+<li><a href="#index-g_t_002e_0040var_007bnnn_007d-_0040r_007bPostScript-figures_007d-501"><code>.</code><var>nnn</var> <span class="roman">PostScript figures</span></a>: <a href="#mpost-invocation">mpost invocation</a></li>
+<li><a href="#index-g_t_002e_0040var_007bnnn_007dgf-_0040r_007bgeneric-fonts_007d-376"><code>.</code><var>nnn</var><code>gf </code><span class="roman">generic fonts</span></a>: <a href="#mf-invocation">mf invocation</a></li>
+<li><a href="#index-g_t_002etcx-_0040r_007bcharacter-translation-files_007d-306"><code>.tcx </code><span class="roman">character translation files</span></a>: <a href="#TCX-files">TCX files</a></li>
<li><a href="#index-g_t_002etcx-_0040r_007bcharacter-translation-files_007d-136"><code>.tcx </code><span class="roman">character translation files</span></a>: <a href="#Common-options">Common options</a></li>
<li><a href="#index-g_t_002etex-234"><code>.tex</code></a>: <a href="#tex-invocation">tex invocation</a></li>
-<li><a href="#index-g_t_002etfm-_0040r_007boutput_007d-491"><code>.tfm </code><span class="roman">output</span></a>: <a href="#mpost-invocation">mpost invocation</a></li>
-<li><a href="#index-g_t_002etfm-_0040r_007boutput_007d-370"><code>.tfm </code><span class="roman">output</span></a>: <a href="#mf-invocation">mf invocation</a></li>
-<li><a href="#index-g_t_002eXdefaults-446"><code>.Xdefaults</code></a>: <a href="#Online-Metafont-graphics">Online Metafont graphics</a></li>
-<li><a href="#index-g_t_002eXresources-447"><code>.Xresources</code></a>: <a href="#Online-Metafont-graphics">Online Metafont graphics</a></li>
-<li><a href="#index-g_t2602gf-374"><code>2602gf</code></a>: <a href="#mf-invocation">mf invocation</a></li>
+<li><a href="#index-g_t_002etfm-_0040r_007boutput_007d-502"><code>.tfm </code><span class="roman">output</span></a>: <a href="#mpost-invocation">mpost invocation</a></li>
+<li><a href="#index-g_t_002etfm-_0040r_007boutput_007d-381"><code>.tfm </code><span class="roman">output</span></a>: <a href="#mf-invocation">mf invocation</a></li>
+<li><a href="#index-g_t_002eXdefaults-457"><code>.Xdefaults</code></a>: <a href="#Online-Metafont-graphics">Online Metafont graphics</a></li>
+<li><a href="#index-g_t_002eXresources-458"><code>.Xresources</code></a>: <a href="#Online-Metafont-graphics">Online Metafont graphics</a></li>
+<li><a href="#index-g_t2602gf-385"><code>2602gf</code></a>: <a href="#mf-invocation">mf invocation</a></li>
<li><a href="#index-g_t8-bit-clean-139">8 bit clean</a>: <a href="#Common-options">Common options</a></li>
<li><a href="#index-g_t8-bit-clean-output_002c-specifying-140"><code>8 bit clean output, specifying</code></a>: <a href="#Common-options">Common options</a></li>
-<li><a href="#index-g_t8_002dbit-characters-313">8-bit characters</a>: <a href="#TCX-files">TCX files</a></li>
-<li><a href="#index-g_t_005cbibliography-590"><code>\bibliography</code></a>: <a href="#bibtex-invocation">bibtex invocation</a></li>
-<li><a href="#index-g_t_005cbibliographystyle-591"><code>\bibliographystyle</code></a>: <a href="#bibtex-invocation">bibtex invocation</a></li>
-<li><a href="#index-g_t_005ccharsubdef-_0040r_007band-ML_0040TeX_007b_007d_007d-303"><code>\charsubdef </code><span class="roman">and MLTeX</span></a>: <a href="#g_t_005ccharsubdef">\charsubdef</a></li>
-<li><a href="#index-g_t_005ccount_0040var_007bn_007d-690"><code>\count</code><var>n</var></a>: <a href="#dvitype-invocation">dvitype invocation</a></li>
-<li><a href="#index-g_t_005ccount_0040var_007bn_007d-674"><code>\count</code><var>n</var></a>: <a href="#dvicopy-invocation">dvicopy invocation</a></li>
+<li><a href="#index-g_t8_002dbit-characters-309">8-bit characters</a>: <a href="#TCX-files">TCX files</a></li>
+<li><a href="#index-g_t_005cbibliography-546"><code>\bibliography</code></a>: <a href="#bibtex-invocation">bibtex invocation</a></li>
+<li><a href="#index-g_t_005cbibliographystyle-547"><code>\bibliographystyle</code></a>: <a href="#bibtex-invocation">bibtex invocation</a></li>
+<li><a href="#index-g_t_005ccharsubdef-_0040r_007band-ML_0040TeX_007b_007d_007d-299"><code>\charsubdef </code><span class="roman">and MLTeX</span></a>: <a href="#g_t_005ccharsubdef">\charsubdef</a></li>
+<li><a href="#index-g_t_005ccount_0040var_007bn_007d-645"><code>\count</code><var>n</var></a>: <a href="#dvitype-invocation">dvitype invocation</a></li>
+<li><a href="#index-g_t_005ccount_0040var_007bn_007d-629"><code>\count</code><var>n</var></a>: <a href="#dvicopy-invocation">dvicopy invocation</a></li>
<li><a href="#index-g_t_005cfont-_0040r_007band-dynamic-generation_007d-239"><code>\font </code><span class="roman">and dynamic generation</span></a>: <a href="#tex-invocation">tex invocation</a></li>
-<li><a href="#index-g_t_005cfontdimen-794"><code>\fontdimen</code></a>: <a href="#tftopl-invocation">tftopl invocation</a></li>
-<li><a href="#index-g_t_005cimmediate_005cwrite18-267"><code>\immediate\write18</code></a>: <a href="#tex-invocation">tex invocation</a></li>
+<li><a href="#index-g_t_005cfontdimen-749"><code>\fontdimen</code></a>: <a href="#tftopl-invocation">tftopl invocation</a></li>
+<li><a href="#index-g_t_005cimmediate_005cwrite18-338"><code>\immediate\write18</code></a>: <a href="#Shell-escapes">Shell escapes</a></li>
<li><a href="#index-g_t_005cinput-_0040r_007bfilenames_007d-216"><code>\input </code><span class="roman">filenames</span></a>: <a href="#g_t_005cinput-filenames">\input filenames</a></li>
-<li><a href="#index-g_t_005cmag-684"><code>\mag</code></a>: <a href="#dvitype-invocation">dvitype invocation</a></li>
-<li><a href="#index-g_t_005cmag-669"><code>\mag</code></a>: <a href="#dvicopy-invocation">dvicopy invocation</a></li>
+<li><a href="#index-g_t_005cinput_0040r_007b_002c-and-pipes_007d-346"><code>\input</code><span class="roman">, and pipes</span></a>: <a href="#Shell-escapes">Shell escapes</a></li>
+<li><a href="#index-g_t_005cmag-639"><code>\mag</code></a>: <a href="#dvitype-invocation">dvitype invocation</a></li>
+<li><a href="#index-g_t_005cmag-624"><code>\mag</code></a>: <a href="#dvicopy-invocation">dvicopy invocation</a></li>
+<li><a href="#index-g_t_005copenin_0040r_007b_002c-and-pipes_007d-345"><code>\openin</code><span class="roman">, and pipes</span></a>: <a href="#Shell-escapes">Shell escapes</a></li>
<li><a href="#index-g_t_005copenout-_0040r_007band-security_007d-240"><code>\openout </code><span class="roman">and security</span></a>: <a href="#tex-invocation">tex invocation</a></li>
+<li><a href="#index-g_t_005copenout_0040r_007b_002c-and-pipes_007d-347"><code>\openout</code><span class="roman">, and pipes</span></a>: <a href="#Shell-escapes">Shell escapes</a></li>
+<li><a href="#index-g_t_005coutput-_0040r_007broutine_002c-and-_0040code_007b_005cwrite_007d_007d-341"><code>\output </code><span class="roman">routine, and </span><code>\write</code></a>: <a href="#Shell-escapes">Shell escapes</a></li>
+<li><a href="#index-g_t_005cpdfshellescape-348"><code>\pdfshellescape</code></a>: <a href="#Shell-escapes">Shell escapes</a></li>
<li><a href="#index-g_t_005cstring-226"><code>\string</code></a>: <a href="#g_t_005cinput-filenames">\input filenames</a></li>
-<li><a href="#index-g_t_005ctracingcharsubdef-_0040r_007band-ML_0040TeX_007b_007d_007d-306"><code>\tracingcharsubdef </code><span class="roman">and MLTeX</span></a>: <a href="#g_t_005ctracingcharsubdef">\tracingcharsubdef</a></li>
-<li><a href="#index-g_t_005ctracinglostchars-_0040r_007band-ML_0040TeX_007b_007d_007d-308"><code>\tracinglostchars </code><span class="roman">and MLTeX</span></a>: <a href="#g_t_005ctracingcharsubdef">\tracingcharsubdef</a></li>
-<li><a href="#index-g_t_005cwrite18-_0040r_007bshell-escape-extension_007d-268"><code>\write18 </code><span class="roman">shell escape extension</span></a>: <a href="#tex-invocation">tex invocation</a></li>
-<li><a href="#index-g_t_005e_005e-_0040r_007bnotation_002c-avoiding_007d-330"><code>^^ </code><span class="roman">notation, avoiding</span></a>: <a href="#TCX-files">TCX files</a></li>
-<li><a href="#index-g_t_0040cite_007bComputer-Modern-Typefaces_007d_002c-production-of-478"><cite>Computer Modern Typefaces</cite>, production of</a>: <a href="#mft-invocation">mft invocation</a></li>
-<li><a href="#index-abbrv_002ebst-613"><code>abbrv.bst</code></a>: <a href="#Basic-BibTeX-style-files">Basic BibTeX style files</a></li>
-<li><a href="#index-accented-character-314">accented character</a>: <a href="#TCX-files">TCX files</a></li>
-<li><a href="#index-accents_002c-hyphenating-words-with-300">accents, hyphenating words with</a>: <a href="#MLTeX">MLTeX</a></li>
+<li><a href="#index-g_t_005ctracingcharsubdef-_0040r_007band-ML_0040TeX_007b_007d_007d-302"><code>\tracingcharsubdef </code><span class="roman">and MLTeX</span></a>: <a href="#g_t_005ctracingcharsubdef">\tracingcharsubdef</a></li>
+<li><a href="#index-g_t_005ctracinglostchars-_0040r_007band-ML_0040TeX_007b_007d_007d-304"><code>\tracinglostchars </code><span class="roman">and MLTeX</span></a>: <a href="#g_t_005ctracingcharsubdef">\tracingcharsubdef</a></li>
+<li><a href="#index-g_t_005cwrite18-_0040r_007bshell-escape-extension_007d-339"><code>\write18 </code><span class="roman">shell escape extension</span></a>: <a href="#Shell-escapes">Shell escapes</a></li>
+<li><a href="#index-g_t_005e_005e-_0040r_007bnotation_002c-avoiding_007d-326"><code>^^ </code><span class="roman">notation, avoiding</span></a>: <a href="#TCX-files">TCX files</a></li>
+<li><a href="#index-g_t_0040cite_007bComputer-Modern-Typefaces_007d_002c-production-of-489"><cite>Computer Modern Typefaces</cite>, production of</a>: <a href="#mft-invocation">mft invocation</a></li>
+<li><a href="#index-abbrv_002ebst-569"><code>abbrv.bst</code></a>: <a href="#Basic-BibTeX-style-files">Basic BibTeX style files</a></li>
+<li><a href="#index-accented-character-310">accented character</a>: <a href="#TCX-files">TCX files</a></li>
+<li><a href="#index-accents_002c-hyphenating-words-with-296">accents, hyphenating words with</a>: <a href="#MLTeX">MLTeX</a></li>
<li><a href="#index-acknowledgements-19">acknowledgements</a>: <a href="#Introduction">Introduction</a></li>
-<li><a href="#index-acm_002ebst-614"><code>acm.bst</code></a>: <a href="#Basic-BibTeX-style-files">Basic BibTeX style files</a></li>
-<li><a href="#index-Ada_002c-WEB-for-628">Ada, WEB for</a>: <a href="#WEB">WEB</a></li>
+<li><a href="#index-acm_002ebst-570"><code>acm.bst</code></a>: <a href="#Basic-BibTeX-style-files">Basic BibTeX style files</a></li>
+<li><a href="#index-Ada_002c-WEB-for-583">Ada, WEB for</a>: <a href="#WEB">WEB</a></li>
<li><a href="#index-additional-Make-targets-44">additional Make targets</a>: <a href="#Additional-targets">Additional targets</a></li>
-<li><a href="#index-AFM-to-TFM-conversion-823">AFM to TFM conversion</a>: <a href="#Font-utilities-available-elsewhere">Font utilities available elsewhere</a></li>
-<li><a href="#index-afm2tfm-824"><code>afm2tfm</code></a>: <a href="#Font-utilities-available-elsewhere">Font utilities available elsewhere</a></li>
-<li><a href="#index-afmtopl-825"><code>afmtopl</code></a>: <a href="#Font-utilities-available-elsewhere">Font utilities available elsewhere</a></li>
+<li><a href="#index-AFM-to-TFM-conversion-778">AFM to TFM conversion</a>: <a href="#Font-utilities-available-elsewhere">Font utilities available elsewhere</a></li>
+<li><a href="#index-afm2tfm-779"><code>afm2tfm</code></a>: <a href="#Font-utilities-available-elsewhere">Font utilities available elsewhere</a></li>
+<li><a href="#index-afmtopl-780"><code>afmtopl</code></a>: <a href="#Font-utilities-available-elsewhere">Font utilities available elsewhere</a></li>
<li><a href="#index-aliases-for-fonts-147">aliases for fonts</a>: <a href="#Path-searching">Path searching</a></li>
-<li><a href="#index-alpha_002ebst-615"><code>alpha.bst</code></a>: <a href="#Basic-BibTeX-style-files">Basic BibTeX style files</a></li>
-<li><a href="#index-American-Mathematical-Society_002c-typesetting-system-284">American Mathematical Society, typesetting system</a>: <a href="#Formats">Formats</a></li>
-<li><a href="#index-AMS_0040TeX_007b_007d-283">AMSTeX</a>: <a href="#Formats">Formats</a></li>
-<li><a href="#index-apalike_002ebst-616"><code>apalike.bst</code></a>: <a href="#Basic-BibTeX-style-files">Basic BibTeX style files</a></li>
-<li><a href="#index-Arabic-typesetting-349">Arabic typesetting</a>: <a href="#TeX-extensions">TeX extensions</a></li>
+<li><a href="#index-alpha_002ebst-571"><code>alpha.bst</code></a>: <a href="#Basic-BibTeX-style-files">Basic BibTeX style files</a></li>
+<li><a href="#index-American-Mathematical-Society_002c-typesetting-system-280">American Mathematical Society, typesetting system</a>: <a href="#Formats">Formats</a></li>
+<li><a href="#index-AMS_0040TeX_007b_007d-279">AMSTeX</a>: <a href="#Formats">Formats</a></li>
+<li><a href="#index-apalike_002ebst-572"><code>apalike.bst</code></a>: <a href="#Basic-BibTeX-style-files">Basic BibTeX style files</a></li>
<li><a href="#index-architecture-dependencies-195">architecture dependencies</a>: <a href="#Hardware-and-memory-dumps">Hardware and memory dumps</a></li>
<li><a href="#index-array-limit_002c-fixed-83">array limit, fixed</a>: <a href="#Runtime-options">Runtime options</a></li>
<li><a href="#index-array-sizes-71">array sizes</a>: <a href="#Runtime-options">Runtime options</a></li>
<li><a href="#index-assembly-language-routines-41">assembly language routines</a>: <a href="#Compile_002dtime-options">Compile-time options</a></li>
-<li><a href="#index-autotrace-849"><code>autotrace</code></a>: <a href="#Font-utilities-available-elsewhere">Font utilities available elsewhere</a></li>
-<li><a href="#index-Awk_002c-WEB-for-627">Awk, WEB for</a>: <a href="#WEB">WEB</a></li>
+<li><a href="#index-autotrace-804"><code>autotrace</code></a>: <a href="#Font-utilities-available-elsewhere">Font utilities available elsewhere</a></li>
+<li><a href="#index-Awk_002c-WEB-for-582">Awk, WEB for</a>: <a href="#WEB">WEB</a></li>
<li><a href="#index-base-file_002c-determining-176">base file, determining</a>: <a href="#Determining-the-memory-dump-to-use">Determining the memory dump to use</a></li>
-<li><a href="#index-base-files-381">base files</a>: <a href="#Initial-Metafont">Initial Metafont</a></li>
-<li><a href="#index-base-files_002c-need-mode-definitions-391">base files, need mode definitions</a>: <a href="#Modes">Modes</a></li>
-<li><a href="#index-base-files_002c-plain-only-388">base files, plain only</a>: <a href="#Initial-Metafont">Initial Metafont</a></li>
+<li><a href="#index-base-files-392">base files</a>: <a href="#Initial-Metafont">Initial Metafont</a></li>
+<li><a href="#index-base-files_002c-need-mode-definitions-402">base files, need mode definitions</a>: <a href="#Modes">Modes</a></li>
+<li><a href="#index-base-files_002c-plain-only-399">base files, plain only</a>: <a href="#Initial-Metafont">Initial Metafont</a></li>
<li><a href="#index-base-files_002c-sharing-189">base files, sharing</a>: <a href="#Hardware-and-memory-dumps">Hardware and memory dumps</a></li>
<li><a href="#index-bases-_0040r_007bMake-target_007d-53"><code>bases </code><span class="roman">Make target</span></a>: <a href="#Additional-targets">Additional targets</a></li>
-<li><a href="#index-basic-Bib_0040TeX_007b_007d-style-files-610">basic BibTeX style files</a>: <a href="#Basic-BibTeX-style-files">Basic BibTeX style files</a></li>
+<li><a href="#index-basic-Bib_0040TeX_007b_007d-style-files-566">basic BibTeX style files</a>: <a href="#Basic-BibTeX-style-files">Basic BibTeX style files</a></li>
<li><a href="#index-basic-fonts-and-macros-29">basic fonts and macros</a>: <a href="#Installation">Installation</a></li>
<li><a href="#index-batch-languages-230">batch languages</a>: <a href="#TeX">TeX</a></li>
-<li><a href="#index-BDF-and-GF-conversion-827">BDF and GF conversion</a>: <a href="#Font-utilities-available-elsewhere">Font utilities available elsewhere</a></li>
-<li><a href="#index-beginfig-489"><code>beginfig</code></a>: <a href="#mpost-invocation">mpost invocation</a></li>
-<li><a href="#index-BeginPath-_0040r_007bditroff-command_007d-558"><code>BeginPath </code><span class="roman">ditroff command</span></a>: <a href="#dmp-invocation">dmp invocation</a></li>
+<li><a href="#index-BDF-and-GF-conversion-782">BDF and GF conversion</a>: <a href="#Font-utilities-available-elsewhere">Font utilities available elsewhere</a></li>
+<li><a href="#index-beginfig-500"><code>beginfig</code></a>: <a href="#mpost-invocation">mpost invocation</a></li>
<li><a href="#index-Berry_002c-Karl-17">Berry, Karl</a>: <a href="#Introduction">Introduction</a></li>
-<li><a href="#index-BIBINPUTS_0040r_007b_002c-search-path-for-bib-files_007d-593"><code>BIBINPUTS</code><span class="roman">, search path for bib files</span></a>: <a href="#bibtex-invocation">bibtex invocation</a></li>
-<li><a href="#index-bibliographies_002c-creating-582">bibliographies, creating</a>: <a href="#BibTeX">BibTeX</a></li>
-<li><a href="#index-bibliography-857">bibliography</a>: <a href="#References">References</a></li>
-<li><a href="#index-bibliography-items_002c-cross_002dreferenced-600">bibliography items, cross-referenced</a>: <a href="#bibtex-invocation">bibtex invocation</a></li>
-<li><a href="#index-bibtex-584"><code>bibtex</code></a>: <a href="#bibtex-invocation">bibtex invocation</a></li>
-<li><a href="#index-Bib_0040TeX_007b_007d-583">BibTeX</a>: <a href="#BibTeX">BibTeX</a></li>
-<li><a href="#index-Bib_0040TeX_007b_007d-collection-607">BibTeX collection</a>: <a href="#bibtex-invocation">bibtex invocation</a></li>
-<li><a href="#index-Bib_0040TeX_007b_007d-style-files-611">BibTeX style files</a>: <a href="#Basic-BibTeX-style-files">Basic BibTeX style files</a></li>
+<li><a href="#index-BIBINPUTS_0040r_007b_002c-search-path-for-bib-files_007d-549"><code>BIBINPUTS</code><span class="roman">, search path for bib files</span></a>: <a href="#bibtex-invocation">bibtex invocation</a></li>
+<li><a href="#index-bibliographies_002c-creating-538">bibliographies, creating</a>: <a href="#BibTeX">BibTeX</a></li>
+<li><a href="#index-bibliography-812">bibliography</a>: <a href="#References">References</a></li>
+<li><a href="#index-bibliography-items_002c-cross_002dreferenced-556">bibliography items, cross-referenced</a>: <a href="#bibtex-invocation">bibtex invocation</a></li>
+<li><a href="#index-bibtex-540"><code>bibtex</code></a>: <a href="#bibtex-invocation">bibtex invocation</a></li>
+<li><a href="#index-Bib_0040TeX_007b_007d-539">BibTeX</a>: <a href="#BibTeX">BibTeX</a></li>
+<li><a href="#index-Bib_0040TeX_007b_007d-collection-563">BibTeX collection</a>: <a href="#bibtex-invocation">bibtex invocation</a></li>
+<li><a href="#index-Bib_0040TeX_007b_007d-style-files-567">BibTeX style files</a>: <a href="#Basic-BibTeX-style-files">Basic BibTeX style files</a></li>
<li><a href="#index-BigEndian-machines-192">BigEndian machines</a>: <a href="#Hardware-and-memory-dumps">Hardware and memory dumps</a></li>
<li><a href="#index-binaries_002c-linking-129">binaries, linking</a>: <a href="#Common-options">Common options</a></li>
-<li><a href="#index-blank-lines_002c-in-TCX-files-322">blank lines, in TCX files</a>: <a href="#TCX-files">TCX files</a></li>
-<li><a href="#index-Bourne-shell-commands-in-_0040TeX_007b_007d-265">Bourne shell commands in TeX</a>: <a href="#tex-invocation">tex invocation</a></li>
+<li><a href="#index-blank-lines_002c-in-TCX-files-318">blank lines, in TCX files</a>: <a href="#TCX-files">TCX files</a></li>
<li><a href="#index-boxes_002c-memory-for-74">boxes, memory for</a>: <a href="#Runtime-options">Runtime options</a></li>
<li><a href="#index-breakpoints_002c-memory-for-76">breakpoints, memory for</a>: <a href="#Runtime-options">Runtime options</a></li>
<li><a href="#index-Breitenlohner_002c-Peter-5">Breitenlohner, Peter</a>: <a href="#Introduction">Introduction</a></li>
-<li><a href="#index-BSTINPUTS_0040r_007b_002c-search-path-for-bst-files_007d-594"><code>BSTINPUTS</code><span class="roman">, search path for bst files</span></a>: <a href="#bibtex-invocation">bibtex invocation</a></li>
-<li><a href="#index-btex-_0040r_007band-label-extraction_007d-570"><code>btex </code><span class="roman">and label extraction</span></a>: <a href="#mpto-invocation">mpto invocation</a></li>
-<li><a href="#index-btex-_0040r_007bfor-MetaPost-labels_007d-495"><code>btex </code><span class="roman">for MetaPost labels</span></a>: <a href="#mpost-invocation">mpost invocation</a></li>
-<li><a href="#index-btxdoc_002ebib-604"><code>btxdoc.bib</code></a>: <a href="#bibtex-invocation">bibtex invocation</a></li>
-<li><a href="#index-btxdoc_002etex-601"><code>btxdoc.tex</code></a>: <a href="#bibtex-invocation">bibtex invocation</a></li>
-<li><a href="#index-btxhak_002etex-602"><code>btxhak.tex</code></a>: <a href="#bibtex-invocation">bibtex invocation</a></li>
-<li><a href="#index-byte-position-764">byte position</a>: <a href="#gftype-invocation">gftype invocation</a></li>
-<li><a href="#index-byte-position-731">byte position</a>: <a href="#pktype-invocation">pktype invocation</a></li>
+<li><a href="#index-BSTINPUTS_0040r_007b_002c-search-path-for-bst-files_007d-550"><code>BSTINPUTS</code><span class="roman">, search path for bst files</span></a>: <a href="#bibtex-invocation">bibtex invocation</a></li>
+<li><a href="#index-btex-_0040r_007bfor-MetaPost-labels_007d-506"><code>btex </code><span class="roman">for MetaPost labels</span></a>: <a href="#mpost-invocation">mpost invocation</a></li>
+<li><a href="#index-btxdoc_002ebib-560"><code>btxdoc.bib</code></a>: <a href="#bibtex-invocation">bibtex invocation</a></li>
+<li><a href="#index-btxdoc_002etex-557"><code>btxdoc.tex</code></a>: <a href="#bibtex-invocation">bibtex invocation</a></li>
+<li><a href="#index-btxhak_002etex-558"><code>btxhak.tex</code></a>: <a href="#bibtex-invocation">bibtex invocation</a></li>
+<li><a href="#index-byte-position-719">byte position</a>: <a href="#gftype-invocation">gftype invocation</a></li>
+<li><a href="#index-byte-position-686">byte position</a>: <a href="#pktype-invocation">pktype invocation</a></li>
<li><a href="#index-byte-swapping-198">byte swapping</a>: <a href="#Hardware-and-memory-dumps">Hardware and memory dumps</a></li>
<li><a href="#index-c_002dsources-_0040r_007bMakefile-target_007d-47"><code>c-sources </code><span class="roman">Makefile target</span></a>: <a href="#Additional-targets">Additional targets</a></li>
-<li><a href="#index-captions_002c-extracting-from-MetaPost-input-567">captions, extracting from MetaPost input</a>: <a href="#mpto-invocation">mpto invocation</a></li>
-<li><a href="#index-captions_002c-for-MetaPost-525">captions, for MetaPost</a>: <a href="#makempx-invocation">makempx invocation</a></li>
-<li><a href="#index-change-files_002c-and-MFT-472">change files, and MFT</a>: <a href="#mft-invocation">mft invocation</a></li>
-<li><a href="#index-change-files_002c-and-Tangle-633">change files, and Tangle</a>: <a href="#tangle-invocation">tangle invocation</a></li>
-<li><a href="#index-change-files_002c-and-Weave-651">change files, and Weave</a>: <a href="#weave-invocation">weave invocation</a></li>
+<li><a href="#index-change-files_002c-and-MFT-483">change files, and MFT</a>: <a href="#mft-invocation">mft invocation</a></li>
+<li><a href="#index-change-files_002c-and-Tangle-588">change files, and Tangle</a>: <a href="#tangle-invocation">tangle invocation</a></li>
+<li><a href="#index-change-files_002c-and-Weave-606">change files, and Weave</a>: <a href="#weave-invocation">weave invocation</a></li>
<li><a href="#index-changing-error-messages-style-105">changing error messages style</a>: <a href="#Common-options">Common options</a></li>
-<li><a href="#index-character-codes_002c-in-GFtype-output-765">character codes, in GFtype output</a>: <a href="#gftype-invocation">gftype invocation</a></li>
-<li><a href="#index-character-codes_002c-in-PKtype-output-734">character codes, in PKtype output</a>: <a href="#pktype-invocation">pktype invocation</a></li>
-<li><a href="#index-character-codes_002c-in-TCX-files-325">character codes, in TCX files</a>: <a href="#TCX-files">TCX files</a></li>
-<li><a href="#index-character-proofs-of-fonts-454">character proofs of fonts</a>: <a href="#gftodvi-invocation">gftodvi invocation</a></li>
-<li><a href="#index-CHARACTER-_0040r_007bproperty_007d-802"><code>CHARACTER </code><span class="roman">property</span></a>: <a href="#tftopl-invocation">tftopl invocation</a></li>
-<li><a href="#index-character-translation-files-311">character translation files</a>: <a href="#TCX-files">TCX files</a></li>
-<li><a href="#index-CHARDP-_0040r_007bproperty_007d-805"><code>CHARDP </code><span class="roman">property</span></a>: <a href="#tftopl-invocation">tftopl invocation</a></li>
-<li><a href="#index-CHARHT-_0040r_007bproperty_007d-804"><code>CHARHT </code><span class="roman">property</span></a>: <a href="#tftopl-invocation">tftopl invocation</a></li>
-<li><a href="#index-CHARIC-_0040r_007bproperty_007d-806"><code>CHARIC </code><span class="roman">property</span></a>: <a href="#tftopl-invocation">tftopl invocation</a></li>
-<li><a href="#index-CHARWD-_0040r_007bproperty_007d-803"><code>CHARWD </code><span class="roman">property</span></a>: <a href="#tftopl-invocation">tftopl invocation</a></li>
-<li><a href="#index-chtopx-835"><code>chtopx</code></a>: <a href="#Font-utilities-available-elsewhere">Font utilities available elsewhere</a></li>
-<li><a href="#index-class-name-for-Metafont-443">class name for Metafont</a>: <a href="#Online-Metafont-graphics">Online Metafont graphics</a></li>
-<li><a href="#index-cm_002ebase-385"><code>cm.base</code></a>: <a href="#Initial-Metafont">Initial Metafont</a></li>
-<li><a href="#index-cmbase_002emf-386"><code>cmbase.mf</code></a>: <a href="#Initial-Metafont">Initial Metafont</a></li>
-<li><a href="#index-cmbase_002emft-476"><code>cmbase.mft</code></a>: <a href="#mft-invocation">mft invocation</a></li>
-<li><a href="#index-cmmf_002ebase-_0040r_007bnot-recommended_007d-384"><code>cmmf.base </code><span class="roman">not recommended</span></a>: <a href="#Initial-Metafont">Initial Metafont</a></li>
-<li><a href="#index-color_002c-in-DVItoMP-550">color, in DVItoMP</a>: <a href="#dvitomp-invocation">dvitomp invocation</a></li>
-<li><a href="#index-comments_002c-in-TCX-files-324">comments, in TCX files</a>: <a href="#TCX-files">TCX files</a></li>
-<li><a href="#index-comments_002c-MFT-control-469">comments, MFT control</a>: <a href="#mft-invocation">mft invocation</a></li>
+<li><a href="#index-character-codes_002c-in-GFtype-output-720">character codes, in GFtype output</a>: <a href="#gftype-invocation">gftype invocation</a></li>
+<li><a href="#index-character-codes_002c-in-PKtype-output-689">character codes, in PKtype output</a>: <a href="#pktype-invocation">pktype invocation</a></li>
+<li><a href="#index-character-codes_002c-in-TCX-files-321">character codes, in TCX files</a>: <a href="#TCX-files">TCX files</a></li>
+<li><a href="#index-character-proofs-of-fonts-465">character proofs of fonts</a>: <a href="#gftodvi-invocation">gftodvi invocation</a></li>
+<li><a href="#index-CHARACTER-_0040r_007bproperty_007d-757"><code>CHARACTER </code><span class="roman">property</span></a>: <a href="#tftopl-invocation">tftopl invocation</a></li>
+<li><a href="#index-character-translation-files-307">character translation files</a>: <a href="#TCX-files">TCX files</a></li>
+<li><a href="#index-CHARDP-_0040r_007bproperty_007d-760"><code>CHARDP </code><span class="roman">property</span></a>: <a href="#tftopl-invocation">tftopl invocation</a></li>
+<li><a href="#index-CHARHT-_0040r_007bproperty_007d-759"><code>CHARHT </code><span class="roman">property</span></a>: <a href="#tftopl-invocation">tftopl invocation</a></li>
+<li><a href="#index-CHARIC-_0040r_007bproperty_007d-761"><code>CHARIC </code><span class="roman">property</span></a>: <a href="#tftopl-invocation">tftopl invocation</a></li>
+<li><a href="#index-CHARWD-_0040r_007bproperty_007d-758"><code>CHARWD </code><span class="roman">property</span></a>: <a href="#tftopl-invocation">tftopl invocation</a></li>
+<li><a href="#index-chtopx-790"><code>chtopx</code></a>: <a href="#Font-utilities-available-elsewhere">Font utilities available elsewhere</a></li>
+<li><a href="#index-class-name-for-Metafont-454">class name for Metafont</a>: <a href="#Online-Metafont-graphics">Online Metafont graphics</a></li>
+<li><a href="#index-cm_002ebase-396"><code>cm.base</code></a>: <a href="#Initial-Metafont">Initial Metafont</a></li>
+<li><a href="#index-cmbase_002emf-397"><code>cmbase.mf</code></a>: <a href="#Initial-Metafont">Initial Metafont</a></li>
+<li><a href="#index-cmbase_002emft-487"><code>cmbase.mft</code></a>: <a href="#mft-invocation">mft invocation</a></li>
+<li><a href="#index-cmmf_002ebase-_0040r_007bnot-recommended_007d-395"><code>cmmf.base </code><span class="roman">not recommended</span></a>: <a href="#Initial-Metafont">Initial Metafont</a></li>
+<li><a href="#index-color_002c-in-DVItoMP-537">color, in DVItoMP</a>: <a href="#dvitomp-invocation">dvitomp invocation</a></li>
+<li><a href="#index-comments_002c-in-TCX-files-320">comments, in TCX files</a>: <a href="#TCX-files">TCX files</a></li>
+<li><a href="#index-comments_002c-MFT-control-480">comments, MFT control</a>: <a href="#mft-invocation">mft invocation</a></li>
<li><a href="#index-common-options-95">common options</a>: <a href="#Common-options">Common options</a></li>
<li><a href="#index-commonalities-87">commonalities</a>: <a href="#Commonalities">Commonalities</a></li>
-<li><a href="#index-comparing-file-modification-times-576">comparing file modification times</a>: <a href="#newer-invocation">newer invocation</a></li>
<li><a href="#index-compilation-25">compilation</a>: <a href="#Installation">Installation</a></li>
<li><a href="#index-compile_002dtime-options-35">compile-time options</a>: <a href="#Compile_002dtime-options">Compile-time options</a></li>
<li><a href="#index-compile_002dtime-options-33">compile-time options</a>: <a href="#configure-options">configure options</a></li>
-<li><a href="#index-Computer-Modern-fonts_002c-and-Troff-499">Computer Modern fonts, and Troff</a>: <a href="#mpost-invocation">mpost invocation</a></li>
-<li><a href="#index-Computer-Modern-macros-387">Computer Modern macros</a>: <a href="#Initial-Metafont">Initial Metafont</a></li>
+<li><a href="#index-Computer-Modern-fonts_002c-and-Troff-510">Computer Modern fonts, and Troff</a>: <a href="#mpost-invocation">mpost invocation</a></li>
+<li><a href="#index-Computer-Modern-macros-398">Computer Modern macros</a>: <a href="#Initial-Metafont">Initial Metafont</a></li>
<li><a href="#index-configuration-24">configuration</a>: <a href="#Installation">Installation</a></li>
<li><a href="#index-configuration-file-reading-145">configuration file reading</a>: <a href="#Path-searching">Path searching</a></li>
<li><a href="#index-configuration-file-values-70">configuration file values</a>: <a href="#Runtime-options">Runtime options</a></li>
<li><a href="#index-configuration_002c-compile_002dtime-32">configuration, compile-time</a>: <a href="#configure-options">configure options</a></li>
<li><a href="#index-configure-_002d_002dwith_002f_002d_002denable-_0040r_007boptions_007d-34"><code>configure --with/--enable </code><span class="roman">options</span></a>: <a href="#configure-options">configure options</a></li>
-<li><a href="#index-CONTENTS_002etex-654"><code>CONTENTS.tex</code></a>: <a href="#weave-invocation">weave invocation</a></li>
+<li><a href="#index-CONTENTS_002etex-609"><code>CONTENTS.tex</code></a>: <a href="#weave-invocation">weave invocation</a></li>
<li><a href="#index-control-sequence-names_002c-space-for-81">control sequence names, space for</a>: <a href="#Runtime-options">Runtime options</a></li>
<li><a href="#index-conventions-for-options_002c-89">conventions for options,</a>: <a href="#Option-conventions">Option conventions</a></li>
-<li><a href="#index-conversion_002c-DVI-to-plain-text-676">conversion, DVI to plain text</a>: <a href="#dvitype-invocation">dvitype invocation</a></li>
-<li><a href="#index-conversion_002c-GF-to-PK-718">conversion, GF to PK</a>: <a href="#gftopk-invocation">gftopk invocation</a></li>
-<li><a href="#index-conversion_002c-GF-to-plain-text-757">conversion, GF to plain text</a>: <a href="#gftype-invocation">gftype invocation</a></li>
-<li><a href="#index-conversion_002c-PK-to-GF-722">conversion, PK to GF</a>: <a href="#pktogf-invocation">pktogf invocation</a></li>
-<li><a href="#index-conversion_002c-PK-to-plain-text-726">conversion, PK to plain text</a>: <a href="#pktype-invocation">pktype invocation</a></li>
-<li><a href="#index-conversion_002c-property-list-to-TFM-808">conversion, property list to TFM</a>: <a href="#pltotf-invocation">pltotf invocation</a></li>
-<li><a href="#index-conversion_002c-property-list-to-VF-819">conversion, property list to VF</a>: <a href="#vptovf-invocation">vptovf invocation</a></li>
-<li><a href="#index-conversion_002c-TFM-to-property-list-783">conversion, TFM to property list</a>: <a href="#tftopl-invocation">tftopl invocation</a></li>
-<li><a href="#index-conversion_002c-VF-to-VPL-812">conversion, VF to VPL</a>: <a href="#vftovp-invocation">vftovp invocation</a></li>
-<li><a href="#index-copyright-notices-854">copyright notices</a>: <a href="#Legalisms">Legalisms</a></li>
-<li><a href="#index-Cork-encoding-and-ISO-input-319">Cork encoding and ISO input</a>: <a href="#TCX-files">TCX files</a></li>
+<li><a href="#index-conversion_002c-DVI-to-plain-text-631">conversion, DVI to plain text</a>: <a href="#dvitype-invocation">dvitype invocation</a></li>
+<li><a href="#index-conversion_002c-GF-to-PK-673">conversion, GF to PK</a>: <a href="#gftopk-invocation">gftopk invocation</a></li>
+<li><a href="#index-conversion_002c-GF-to-plain-text-712">conversion, GF to plain text</a>: <a href="#gftype-invocation">gftype invocation</a></li>
+<li><a href="#index-conversion_002c-PK-to-GF-677">conversion, PK to GF</a>: <a href="#pktogf-invocation">pktogf invocation</a></li>
+<li><a href="#index-conversion_002c-PK-to-plain-text-681">conversion, PK to plain text</a>: <a href="#pktype-invocation">pktype invocation</a></li>
+<li><a href="#index-conversion_002c-property-list-to-TFM-763">conversion, property list to TFM</a>: <a href="#pltotf-invocation">pltotf invocation</a></li>
+<li><a href="#index-conversion_002c-property-list-to-VF-774">conversion, property list to VF</a>: <a href="#vptovf-invocation">vptovf invocation</a></li>
+<li><a href="#index-conversion_002c-TFM-to-property-list-738">conversion, TFM to property list</a>: <a href="#tftopl-invocation">tftopl invocation</a></li>
+<li><a href="#index-conversion_002c-VF-to-VPL-767">conversion, VF to VPL</a>: <a href="#vftovp-invocation">vftovp invocation</a></li>
+<li><a href="#index-copyright-notices-809">copyright notices</a>: <a href="#Legalisms">Legalisms</a></li>
+<li><a href="#index-Cork-encoding-and-ISO-input-315">Cork encoding and ISO input</a>: <a href="#TCX-files">TCX files</a></li>
<li><a href="#index-creating-memory-dumps-172">creating memory dumps</a>: <a href="#Creating-memory-dumps">Creating memory dumps</a></li>
-<li><a href="#index-cross_002dreferenced-bibliography-items-599">cross-referenced bibliography items</a>: <a href="#bibtex-invocation">bibtex invocation</a></li>
-<li><a href="#index-cross_002dreferences_002c-omitting-653">cross-references, omitting</a>: <a href="#weave-invocation">weave invocation</a></li>
+<li><a href="#index-cross_002dreferenced-bibliography-items-555">cross-referenced bibliography items</a>: <a href="#bibtex-invocation">bibtex invocation</a></li>
+<li><a href="#index-cross_002dreferences_002c-omitting-608">cross-references, omitting</a>: <a href="#weave-invocation">weave invocation</a></li>
<li><a href="#index-current-directory_002c-used-for-output-150">current directory, used for output</a>: <a href="#Output-file-location">Output file location</a></li>
<li><a href="#index-Curtis_002c-Pavel-15">Curtis, Pavel</a>: <a href="#Introduction">Introduction</a></li>
-<li><a href="#index-CWEB-626">CWEB</a>: <a href="#WEB">WEB</a></li>
-<li><a href="#index-Cweb-625">Cweb</a>: <a href="#WEB">WEB</a></li>
-<li><a href="#index-D-_0040var_007bc_007d-_0040r_007bditroff-graphics_007d-555"><code>D </code><var>c</var> <span class="roman">ditroff graphics</span></a>: <a href="#dmp-invocation">dmp invocation</a></li>
+<li><a href="#index-CWEB-581">CWEB</a>: <a href="#WEB">WEB</a></li>
+<li><a href="#index-Cweb-580">Cweb</a>: <a href="#WEB">WEB</a></li>
<li><a href="#index-date-and-time_002c-in-memory-dumps-202">date and time, in memory dumps</a>: <a href="#Hardware-and-memory-dumps">Hardware and memory dumps</a></li>
-<li><a href="#index-debugging-DVI-utilities-694">debugging DVI utilities</a>: <a href="#dvitype-invocation">dvitype invocation</a></li>
+<li><a href="#index-debugging-DVI-utilities-649">debugging DVI utilities</a>: <a href="#dvitype-invocation">dvitype invocation</a></li>
<li><a href="#index-debugging-flags_002c-specifying-121">debugging flags, specifying</a>: <a href="#Common-options">Common options</a></li>
-<li><a href="#index-decimal-character-codes_002c-in-TCX-files-328">decimal character codes, in TCX files</a>: <a href="#TCX-files">TCX files</a></li>
+<li><a href="#index-decimal-character-codes_002c-in-TCX-files-324">decimal character codes, in TCX files</a>: <a href="#TCX-files">TCX files</a></li>
<li><a href="#index-dependencies_002c-hardware-196">dependencies, hardware</a>: <a href="#Hardware-and-memory-dumps">Hardware and memory dumps</a></li>
-<li><a href="#index-design_002dsize-units-801">design-size units</a>: <a href="#tftopl-invocation">tftopl invocation</a></li>
-<li><a href="#index-device-definitions_002c-for-Metafont-392">device definitions, for Metafont</a>: <a href="#Modes">Modes</a></li>
-<li><a href="#index-device_002dindependent-width-780">device-independent width</a>: <a href="#gftype-invocation">gftype invocation</a></li>
-<li><a href="#index-device_002dindependent-width-737">device-independent width</a>: <a href="#pktype-invocation">pktype invocation</a></li>
+<li><a href="#index-design_002dsize-units-756">design-size units</a>: <a href="#tftopl-invocation">tftopl invocation</a></li>
+<li><a href="#index-device-definitions_002c-for-Metafont-403">device definitions, for Metafont</a>: <a href="#Modes">Modes</a></li>
+<li><a href="#index-device_002dindependent-width-735">device-independent width</a>: <a href="#gftype-invocation">gftype invocation</a></li>
+<li><a href="#index-device_002dindependent-width-692">device-independent width</a>: <a href="#pktype-invocation">pktype invocation</a></li>
<li><a href="#index-directory-structure-28">directory structure</a>: <a href="#Installation">Installation</a></li>
-<li><a href="#index-DISPLAY-449"><code>DISPLAY</code></a>: <a href="#Online-Metafont-graphics">Online Metafont graphics</a></li>
-<li><a href="#index-ditroff-output_002c-converting-to-MPX-552">ditroff output, converting to MPX</a>: <a href="#dmp-invocation">dmp invocation</a></li>
-<li><a href="#index-DMP-551"><code>DMP</code></a>: <a href="#dmp-invocation">dmp invocation</a></li>
-<li><a href="#index-DMP-544"><code>DMP</code></a>: <a href="#makempx-invocation">makempx invocation</a></li>
-<li><a href="#index-DMP_002c-invoked-by-MakeMPX-529">DMP, invoked by MakeMPX</a>: <a href="#makempx-invocation">makempx invocation</a></li>
-<li><a href="#index-dmp_002ec-563"><code>dmp.c</code></a>: <a href="#dmp-invocation">dmp invocation</a></li>
+<li><a href="#index-DISPLAY-460"><code>DISPLAY</code></a>: <a href="#Online-Metafont-graphics">Online Metafont graphics</a></li>
<li><a href="#index-dot-files_002c-written-by-_0040TeX_007b_007d-programs-244">dot files, written by TeX programs</a>: <a href="#tex-invocation">tex invocation</a></li>
-<li><a href="#index-downloading-of-fonts-for-MetaPost-labels-501">downloading of fonts for MetaPost labels</a>: <a href="#mpost-invocation">mpost invocation</a></li>
-<li><a href="#index-dpost-554"><code>dpost</code></a>: <a href="#dmp-invocation">dmp invocation</a></li>
-<li><a href="#index-DrawingServant-412"><code>DrawingServant</code></a>: <a href="#Online-Metafont-graphics">Online Metafont graphics</a></li>
-<li><a href="#index-DrawPath-_0040r_007bditroff-command_007d-559"><code>DrawPath </code><span class="roman">ditroff command</span></a>: <a href="#dmp-invocation">dmp invocation</a></li>
+<li><a href="#index-downloading-of-fonts-for-MetaPost-labels-512">downloading of fonts for MetaPost labels</a>: <a href="#mpost-invocation">mpost invocation</a></li>
+<li><a href="#index-DrawingServant-423"><code>DrawingServant</code></a>: <a href="#Online-Metafont-graphics">Online Metafont graphics</a></li>
<li><a href="#index-dump-file-109">dump file</a>: <a href="#Common-options">Common options</a></li>
<li><a href="#index-dumping-memory-168">dumping memory</a>: <a href="#Memory-dumps">Memory dumps</a></li>
<li><a href="#index-DVI-comment_002c-specifying-260">DVI comment, specifying</a>: <a href="#tex-invocation">tex invocation</a></li>
-<li><a href="#index-DVI-files_002c-converting-to-MPX-548">DVI files, converting to MPX</a>: <a href="#dvitomp-invocation">dvitomp invocation</a></li>
-<li><a href="#index-DVI-files_002c-creating-multiple-352">DVI files, creating multiple</a>: <a href="#TeX-extensions">TeX extensions</a></li>
-<li><a href="#index-DVI-files_002c-explained-708">DVI files, explained</a>: <a href="#Font-file-formats">Font file formats</a></li>
-<li><a href="#index-DVI-format-definition-664">DVI format definition</a>: <a href="#DVI-utilities">DVI utilities</a></li>
-<li><a href="#index-DVI-opcodes_002c-showing-693">DVI opcodes, showing</a>: <a href="#dvitype-invocation">dvitype invocation</a></li>
-<li><a href="#index-DVI-utilities-662">DVI utilities</a>: <a href="#DVI-utilities">DVI utilities</a></li>
-<li><a href="#index-dvicopy-665"><code>dvicopy</code></a>: <a href="#dvicopy-invocation">dvicopy invocation</a></li>
-<li><a href="#index-dvitomp-547"><code>dvitomp</code></a>: <a href="#dvitomp-invocation">dvitomp invocation</a></li>
-<li><a href="#index-DVITOMP-543"><code>DVITOMP</code></a>: <a href="#makempx-invocation">makempx invocation</a></li>
-<li><a href="#index-DVItoMP_002c-invoked-by-MakeMPX-528">DVItoMP, invoked by MakeMPX</a>: <a href="#makempx-invocation">makempx invocation</a></li>
-<li><a href="#index-dvitype-_0040r_007bDVI-validation_007d-675"><code>dvitype </code><span class="roman">DVI validation</span></a>: <a href="#dvitype-invocation">dvitype invocation</a></li>
-<li><a href="#index-dvitype-output-example-695">dvitype output example</a>: <a href="#dvitype-output-example">dvitype output example</a></li>
-<li><a href="#index-dvitype_002eweb-663"><code>dvitype.web</code></a>: <a href="#DVI-utilities">DVI utilities</a></li>
-<li><a href="#index-dx-_0040r_007bhorizontal-escapement_007d-777">dx <span class="roman">horizontal escapement</span></a>: <a href="#gftype-invocation">gftype invocation</a></li>
-<li><a href="#index-dx-_0040r_007bhorizontal-escapement_007d-742">dx <span class="roman">horizontal escapement</span></a>: <a href="#pktype-invocation">pktype invocation</a></li>
-<li><a href="#index-dy-_0040r_007bvertical-escapement_007d-778">dy <span class="roman">vertical escapement</span></a>: <a href="#gftype-invocation">gftype invocation</a></li>
+<li><a href="#index-DVI-files_002c-converting-to-MPX-535">DVI files, converting to MPX</a>: <a href="#dvitomp-invocation">dvitomp invocation</a></li>
+<li><a href="#index-DVI-files_002c-explained-663">DVI files, explained</a>: <a href="#Font-file-formats">Font file formats</a></li>
+<li><a href="#index-DVI-format-definition-619">DVI format definition</a>: <a href="#DVI-utilities">DVI utilities</a></li>
+<li><a href="#index-DVI-opcodes_002c-showing-648">DVI opcodes, showing</a>: <a href="#dvitype-invocation">dvitype invocation</a></li>
+<li><a href="#index-DVI-utilities-617">DVI utilities</a>: <a href="#DVI-utilities">DVI utilities</a></li>
+<li><a href="#index-dvicopy-620"><code>dvicopy</code></a>: <a href="#dvicopy-invocation">dvicopy invocation</a></li>
+<li><a href="#index-dvitomp-534"><code>dvitomp</code></a>: <a href="#dvitomp-invocation">dvitomp invocation</a></li>
+<li><a href="#index-dvitype-_0040r_007bDVI-validation_007d-630"><code>dvitype </code><span class="roman">DVI validation</span></a>: <a href="#dvitype-invocation">dvitype invocation</a></li>
+<li><a href="#index-dvitype-output-example-650">dvitype output example</a>: <a href="#dvitype-output-example">dvitype output example</a></li>
+<li><a href="#index-dvitype_002eweb-618"><code>dvitype.web</code></a>: <a href="#DVI-utilities">DVI utilities</a></li>
+<li><a href="#index-dx-_0040r_007bhorizontal-escapement_007d-732">dx <span class="roman">horizontal escapement</span></a>: <a href="#gftype-invocation">gftype invocation</a></li>
+<li><a href="#index-dx-_0040r_007bhorizontal-escapement_007d-697">dx <span class="roman">horizontal escapement</span></a>: <a href="#pktype-invocation">pktype invocation</a></li>
+<li><a href="#index-dy-_0040r_007bvertical-escapement_007d-733">dy <span class="roman">vertical escapement</span></a>: <a href="#gftype-invocation">gftype invocation</a></li>
<li><a href="#index-dynamic-array-allocation-86">dynamic array allocation</a>: <a href="#Runtime-options">Runtime options</a></li>
-<li><a href="#index-dynamic-Metafont-mode-definitions-with-_0040code_007bsmode_007d-399">dynamic Metafont mode definitions with <code>smode</code></a>: <a href="#Modes">Modes</a></li>
-<li><a href="#index-dynamic-packing-variable-733">dynamic packing variable</a>: <a href="#pktype-invocation">pktype invocation</a></li>
+<li><a href="#index-dynamic-Metafont-mode-definitions-with-_0040code_007bsmode_007d-410">dynamic Metafont mode definitions with <code>smode</code></a>: <a href="#Modes">Modes</a></li>
+<li><a href="#index-dynamic-packing-variable-688">dynamic packing variable</a>: <a href="#pktype-invocation">pktype invocation</a></li>
<li><a href="#index-e-_0040r_007bresponse-at-error-prompt_007d-209"><code>e </code><span class="roman">response at error prompt</span></a>: <a href="#Editor-invocation">Editor invocation</a></li>
-<li><a href="#index-e_002dcircumflex-304">e-circumflex</a>: <a href="#g_t_005ccharsubdef">\charsubdef</a></li>
-<li><a href="#index-e_002d_0040TeX_007b_007d-342">e-TeX</a>: <a href="#TeX-extensions">TeX extensions</a></li>
-<li><a href="#index-e_002emft-477"><code>e.mft</code></a>: <a href="#mft-invocation">mft invocation</a></li>
-<li><a href="#index-EC-fonts-363">EC fonts</a>: <a href="#mf-invocation">mf invocation</a></li>
+<li><a href="#index-e_002dcircumflex-300">e-circumflex</a>: <a href="#g_t_005ccharsubdef">\charsubdef</a></li>
+<li><a href="#index-e_002d_0040TeX_007b_007d-355">e-TeX</a>: <a href="#TeX-extensions">TeX extensions</a></li>
+<li><a href="#index-e_002emft-488"><code>e.mft</code></a>: <a href="#mft-invocation">mft invocation</a></li>
+<li><a href="#index-EC-fonts-374">EC fonts</a>: <a href="#mf-invocation">mf invocation</a></li>
<li><a href="#index-EC-fonts-237">EC fonts</a>: <a href="#tex-invocation">tex invocation</a></li>
-<li><a href="#index-editing-of-bitmap-fonts-830">editing of bitmap fonts</a>: <a href="#Font-utilities-available-elsewhere">Font utilities available elsewhere</a></li>
+<li><a href="#index-editing-of-bitmap-fonts-785">editing of bitmap fonts</a>: <a href="#Font-utilities-available-elsewhere">Font utilities available elsewhere</a></li>
<li><a href="#index-editor-invoked-at-error-207">editor invoked at error</a>: <a href="#Editor-invocation">Editor invocation</a></li>
<li><a href="#index-eight_002dbit-characters-in-filenames-221">eight-bit characters in filenames</a>: <a href="#g_t_005cinput-filenames">\input filenames</a></li>
-<li><a href="#index-empty_002etcx-318"><code>empty.tcx</code></a>: <a href="#TCX-files">TCX files</a></li>
+<li><a href="#index-empty_002etcx-314"><code>empty.tcx</code></a>: <a href="#TCX-files">TCX files</a></li>
<li><a href="#index-endian-dependencies-193">endian dependencies</a>: <a href="#Hardware-and-memory-dumps">Hardware and memory dumps</a></li>
-<li><a href="#index-eoc-_0040r_007bGF-command_007d-771"><code>eoc </code><span class="roman">GF command</span></a>: <a href="#gftype-invocation">gftype invocation</a></li>
-<li><a href="#index-Eplain-289">Eplain</a>: <a href="#Formats">Formats</a></li>
-<li><a href="#index-epsf-404"><code>epsf</code></a>: <a href="#Online-Metafont-graphics">Online Metafont graphics</a></li>
+<li><a href="#index-eoc-_0040r_007bGF-command_007d-726"><code>eoc </code><span class="roman">GF command</span></a>: <a href="#gftype-invocation">gftype invocation</a></li>
+<li><a href="#index-Eplain-285">Eplain</a>: <a href="#Formats">Formats</a></li>
+<li><a href="#index-epsf-415"><code>epsf</code></a>: <a href="#Online-Metafont-graphics">Online Metafont graphics</a></li>
<li><a href="#index-errors_002c-editor-invoked-at-208">errors, editor invoked at</a>: <a href="#Editor-invocation">Editor invocation</a></li>
-<li><a href="#index-escapement_002c-horizontal-773">escapement, horizontal</a>: <a href="#gftype-invocation">gftype invocation</a></li>
-<li><a href="#index-escapement_002c-horizontal-740">escapement, horizontal</a>: <a href="#pktype-invocation">pktype invocation</a></li>
-<li><a href="#index-escapement_002c-vertical-775">escapement, vertical</a>: <a href="#gftype-invocation">gftype invocation</a></li>
-<li><a href="#index-etex-_0040r_007band-label-extraction_007d-571"><code>etex </code><span class="roman">and label extraction</span></a>: <a href="#mpto-invocation">mpto invocation</a></li>
-<li><a href="#index-etex-_0040r_007bfor-MetaPost-labels_007d-496"><code>etex </code><span class="roman">for MetaPost labels</span></a>: <a href="#mpost-invocation">mpost invocation</a></li>
+<li><a href="#index-escapement_002c-horizontal-728">escapement, horizontal</a>: <a href="#gftype-invocation">gftype invocation</a></li>
+<li><a href="#index-escapement_002c-horizontal-695">escapement, horizontal</a>: <a href="#pktype-invocation">pktype invocation</a></li>
+<li><a href="#index-escapement_002c-vertical-730">escapement, vertical</a>: <a href="#gftype-invocation">gftype invocation</a></li>
+<li><a href="#index-etex-_0040r_007bfor-MetaPost-labels_007d-507"><code>etex </code><span class="roman">for MetaPost labels</span></a>: <a href="#mpost-invocation">mpost invocation</a></li>
<li><a href="#index-executables_002c-shared-initial-and-virgin-161">executables, shared initial and virgin</a>: <a href="#Initial-and-virgin">Initial and virgin</a></li>
-<li><a href="#index-expanded-plain-format-290">expanded plain format</a>: <a href="#Formats">Formats</a></li>
-<li><a href="#index-extensions-to-_0040TeX_007b_007d-340">extensions to TeX</a>: <a href="#TeX-extensions">TeX extensions</a></li>
+<li><a href="#index-exit-status_002c-of-shell-escape-342">exit status, of shell escape</a>: <a href="#Shell-escapes">Shell escapes</a></li>
+<li><a href="#index-expanded-plain-format-286">expanded plain format</a>: <a href="#Formats">Formats</a></li>
+<li><a href="#index-extensions-to-_0040TeX_007b_007d-353">extensions to TeX</a>: <a href="#TeX-extensions">TeX extensions</a></li>
<li><a href="#index-extra_005fmem_005fbot-73"><code>extra_mem_bot</code></a>: <a href="#Runtime-options">Runtime options</a></li>
-<li><a href="#index-FACE-_0040r_007bproperty_007d-791"><code>FACE </code><span class="roman">property</span></a>: <a href="#tftopl-invocation">tftopl invocation</a></li>
-<li><a href="#index-FAMILY-_0040r_007bproperty_007d-790"><code>FAMILY </code><span class="roman">property</span></a>: <a href="#tftopl-invocation">tftopl invocation</a></li>
-<li><a href="#index-Ferguson_002c-Michael-298">Ferguson, Michael</a>: <a href="#MLTeX">MLTeX</a></li>
-<li><a href="#index-file-formats-for-fonts-702">file formats for fonts</a>: <a href="#Font-file-formats">Font file formats</a></li>
-<li><a href="#index-file-mtimes_002c-comparing-577">file mtimes, comparing</a>: <a href="#newer-invocation">newer invocation</a></li>
+<li><a href="#index-FACE-_0040r_007bproperty_007d-746"><code>FACE </code><span class="roman">property</span></a>: <a href="#tftopl-invocation">tftopl invocation</a></li>
+<li><a href="#index-FAMILY-_0040r_007bproperty_007d-745"><code>FAMILY </code><span class="roman">property</span></a>: <a href="#tftopl-invocation">tftopl invocation</a></li>
+<li><a href="#index-Ferguson_002c-Michael-294">Ferguson, Michael</a>: <a href="#MLTeX">MLTeX</a></li>
+<li><a href="#index-file-formats-for-fonts-657">file formats for fonts</a>: <a href="#Font-file-formats">Font file formats</a></li>
<li><a href="#index-file-recorder-133">file recorder</a>: <a href="#Common-options">Common options</a></li>
-<li><a href="#index-File_002dhandling-_0040TeX_007b_007d-351">File-handling TeX</a>: <a href="#TeX-extensions">TeX extensions</a></li>
<li><a href="#index-filename-conventions_002c-in-input-files-215">filename conventions, in input files</a>: <a href="#g_t_005cinput-filenames">\input filenames</a></li>
<li><a href="#index-filenames-starting-with-_0040samp_007b_002d_007d-94">filenames starting with &lsquo;<samp><span class="samp">-</span></samp>&rsquo;</a>: <a href="#Option-conventions">Option conventions</a></li>
<li><a href="#index-first-line-of-the-main-input-file-137">first line of the main input file</a>: <a href="#Common-options">Common options</a></li>
<li><a href="#index-fixed_002dpoint-arithmetic-39">fixed-point arithmetic</a>: <a href="#Compile_002dtime-options">Compile-time options</a></li>
<li><a href="#index-FIXPT-38"><code>FIXPT</code></a>: <a href="#Compile_002dtime-options">Compile-time options</a></li>
-<li><a href="#index-flag-byte-732">flag byte</a>: <a href="#pktype-invocation">pktype invocation</a></li>
+<li><a href="#index-flag-byte-687">flag byte</a>: <a href="#pktype-invocation">pktype invocation</a></li>
<li><a href="#index-floating_002dpoint-arithmetic-40">floating-point arithmetic</a>: <a href="#Compile_002dtime-options">Compile-time options</a></li>
<li><a href="#index-floating_002dpoint-values-200">floating-point values</a>: <a href="#Hardware-and-memory-dumps">Hardware and memory dumps</a></li>
<li><a href="#index-fmt-file_002c-determining-175">fmt file, determining</a>: <a href="#Determining-the-memory-dump-to-use">Determining the memory dump to use</a></li>
-<li><a href="#index-fmt-files-275">fmt files</a>: <a href="#Initial-TeX">Initial TeX</a></li>
+<li><a href="#index-fmt-files-271">fmt files</a>: <a href="#Initial-TeX">Initial TeX</a></li>
<li><a href="#index-fmt-files_002c-sharing-188">fmt files, sharing</a>: <a href="#Hardware-and-memory-dumps">Hardware and memory dumps</a></li>
<li><a href="#index-fmts-_0040r_007bMake-target_007d-51"><code>fmts </code><span class="roman">Make target</span></a>: <a href="#Additional-targets">Additional targets</a></li>
<li><a href="#index-font-aliases-146">font aliases</a>: <a href="#Path-searching">Path searching</a></li>
-<li><a href="#index-font-character-code_002c-translating-331">font character code, translating</a>: <a href="#TCX-files">TCX files</a></li>
-<li><a href="#index-font-design-358">font design</a>: <a href="#Metafont">Metafont</a></li>
-<li><a href="#index-font-downloading-for-MetaPost-labels-502">font downloading for MetaPost labels</a>: <a href="#mpost-invocation">mpost invocation</a></li>
-<li><a href="#index-font-file-formats-701">font file formats</a>: <a href="#Font-file-formats">Font file formats</a></li>
-<li><a href="#index-font-proofs-455">font proofs</a>: <a href="#gftodvi-invocation">gftodvi invocation</a></li>
-<li><a href="#index-font-utilities-696">font utilities</a>: <a href="#Font-utilities">Font utilities</a></li>
-<li><a href="#index-font-utilities_002c-non_002dWeb2c-822">font utilities, non-Web2c</a>: <a href="#Font-utilities-available-elsewhere">Font utilities available elsewhere</a></li>
+<li><a href="#index-font-character-code_002c-translating-327">font character code, translating</a>: <a href="#TCX-files">TCX files</a></li>
+<li><a href="#index-font-design-369">font design</a>: <a href="#Metafont">Metafont</a></li>
+<li><a href="#index-font-downloading-for-MetaPost-labels-513">font downloading for MetaPost labels</a>: <a href="#mpost-invocation">mpost invocation</a></li>
+<li><a href="#index-font-file-formats-656">font file formats</a>: <a href="#Font-file-formats">Font file formats</a></li>
+<li><a href="#index-font-proofs-466">font proofs</a>: <a href="#gftodvi-invocation">gftodvi invocation</a></li>
+<li><a href="#index-font-utilities-651">font utilities</a>: <a href="#Font-utilities">Font utilities</a></li>
+<li><a href="#index-font-utilities_002c-non_002dWeb2c-777">font utilities, non-Web2c</a>: <a href="#Font-utilities-available-elsewhere">Font utilities available elsewhere</a></li>
<li><a href="#index-font_005fmem_005fsize-78"><code>font_mem_size</code></a>: <a href="#Runtime-options">Runtime options</a></li>
-<li><a href="#index-fontforge-837"><code>fontforge</code></a>: <a href="#Font-utilities-available-elsewhere">Font utilities available elsewhere</a></li>
-<li><a href="#index-fontinst_0040r_007b_002c-for-creating-virtual-fonts_007d-852"><code>fontinst</code><span class="roman">, for creating virtual fonts</span></a>: <a href="#Font-utilities-available-elsewhere">Font utilities available elsewhere</a></li>
+<li><a href="#index-fontforge-792"><code>fontforge</code></a>: <a href="#Font-utilities-available-elsewhere">Font utilities available elsewhere</a></li>
+<li><a href="#index-fontinst_0040r_007b_002c-for-creating-virtual-fonts_007d-807"><code>fontinst</code><span class="roman">, for creating virtual fonts</span></a>: <a href="#Font-utilities-available-elsewhere">Font utilities available elsewhere</a></li>
<li><a href="#index-fonts_002c-basic-30">fonts, basic</a>: <a href="#Installation">Installation</a></li>
-<li><a href="#index-fontutils-848"><code>fontutils</code></a>: <a href="#Font-utilities-available-elsewhere">Font utilities available elsewhere</a></li>
-<li><a href="#index-format-files-278">format files</a>: <a href="#Initial-TeX">Initial TeX</a></li>
-<li><a href="#index-formats-for-_0040TeX_007b_007d-279">formats for TeX</a>: <a href="#Formats">Formats</a></li>
+<li><a href="#index-fontutils-803"><code>fontutils</code></a>: <a href="#Font-utilities-available-elsewhere">Font utilities available elsewhere</a></li>
+<li><a href="#index-format-files-274">format files</a>: <a href="#Initial-TeX">Initial TeX</a></li>
+<li><a href="#index-formats-for-_0040TeX_007b_007d-275">formats for TeX</a>: <a href="#Formats">Formats</a></li>
<li><a href="#index-formats-_0040r_007bMake-target_007d-49"><code>formats </code><span class="roman">Make target</span></a>: <a href="#Additional-targets">Additional targets</a></li>
<li><a href="#index-fraction-routines-42">fraction routines</a>: <a href="#Compile_002dtime-options">Compile-time options</a></li>
-<li><a href="#index-Free-Software-Foundation-documentation-system-288">Free Software Foundation documentation system</a>: <a href="#Formats">Formats</a></li>
+<li><a href="#index-Free-Software-Foundation-documentation-system-284">Free Software Foundation documentation system</a>: <a href="#Formats">Formats</a></li>
<li><a href="#index-freedom-of-Web2c-9">freedom of Web2c</a>: <a href="#Introduction">Introduction</a></li>
-<li><a href="#index-ftp_002emath_002eutah_002eedu-606"><code>ftp.math.utah.edu</code></a>: <a href="#bibtex-invocation">bibtex invocation</a></li>
-<li><a href="#index-generating-source-specials-271">generating source specials</a>: <a href="#tex-invocation">tex invocation</a></li>
-<li><a href="#index-geometric-designs-356">geometric designs</a>: <a href="#Metafont">Metafont</a></li>
-<li><a href="#index-geometric-font-scaling-706">geometric font scaling</a>: <a href="#Font-file-formats">Font file formats</a></li>
-<li><a href="#index-geometry-for-Metafont-444">geometry for Metafont</a>: <a href="#Online-Metafont-graphics">Online Metafont graphics</a></li>
+<li><a href="#index-ftp_002emath_002eutah_002eedu-562"><code>ftp.math.utah.edu</code></a>: <a href="#bibtex-invocation">bibtex invocation</a></li>
+<li><a href="#index-generating-source-specials-267">generating source specials</a>: <a href="#tex-invocation">tex invocation</a></li>
+<li><a href="#index-geometric-designs-367">geometric designs</a>: <a href="#Metafont">Metafont</a></li>
+<li><a href="#index-geometric-font-scaling-661">geometric font scaling</a>: <a href="#Font-file-formats">Font file formats</a></li>
+<li><a href="#index-geometry-for-Metafont-455">geometry for Metafont</a>: <a href="#Online-Metafont-graphics">Online Metafont graphics</a></li>
<li><a href="#index-getopt_005flong_005fonly-90"><code>getopt_long_only</code></a>: <a href="#Option-conventions">Option conventions</a></li>
-<li><a href="#index-GF-files_002c-explained-711">GF files, explained</a>: <a href="#Font-file-formats">Font file formats</a></li>
-<li><a href="#index-GF-files_002c-output-by-Metafont-368">GF files, output by Metafont</a>: <a href="#mf-invocation">mf invocation</a></li>
-<li><a href="#index-GF-format-definition-700">GF format definition</a>: <a href="#Font-utilities">Font utilities</a></li>
-<li><a href="#index-GF-output-367">GF output</a>: <a href="#mf-invocation">mf invocation</a></li>
-<li><a href="#index-GF_002c-converting-PK-to-723">GF, converting PK to</a>: <a href="#pktogf-invocation">pktogf invocation</a></li>
-<li><a href="#index-GF_002c-converting-to-PK-720">GF, converting to PK</a>: <a href="#gftopk-invocation">gftopk invocation</a></li>
-<li><a href="#index-gftodvi-453"><code>gftodvi</code></a>: <a href="#gftodvi-invocation">gftodvi invocation</a></li>
-<li><a href="#index-gftopk-717"><code>gftopk</code></a>: <a href="#gftopk-invocation">gftopk invocation</a></li>
-<li><a href="#index-gftopxl-834"><code>gftopxl</code></a>: <a href="#Font-utilities-available-elsewhere">Font utilities available elsewhere</a></li>
-<li><a href="#index-gftype-_0040r_007bGF-validation_007d-756"><code>gftype </code><span class="roman">GF validation</span></a>: <a href="#gftype-invocation">gftype invocation</a></li>
-<li><a href="#index-gftype_002eweb-698"><code>gftype.web</code></a>: <a href="#Font-utilities">Font utilities</a></li>
+<li><a href="#index-GF-files_002c-explained-666">GF files, explained</a>: <a href="#Font-file-formats">Font file formats</a></li>
+<li><a href="#index-GF-files_002c-output-by-Metafont-379">GF files, output by Metafont</a>: <a href="#mf-invocation">mf invocation</a></li>
+<li><a href="#index-GF-format-definition-655">GF format definition</a>: <a href="#Font-utilities">Font utilities</a></li>
+<li><a href="#index-GF-output-378">GF output</a>: <a href="#mf-invocation">mf invocation</a></li>
+<li><a href="#index-GF_002c-converting-PK-to-678">GF, converting PK to</a>: <a href="#pktogf-invocation">pktogf invocation</a></li>
+<li><a href="#index-GF_002c-converting-to-PK-675">GF, converting to PK</a>: <a href="#gftopk-invocation">gftopk invocation</a></li>
+<li><a href="#index-gftodvi-464"><code>gftodvi</code></a>: <a href="#gftodvi-invocation">gftodvi invocation</a></li>
+<li><a href="#index-gftopk-672"><code>gftopk</code></a>: <a href="#gftopk-invocation">gftopk invocation</a></li>
+<li><a href="#index-gftopxl-789"><code>gftopxl</code></a>: <a href="#Font-utilities-available-elsewhere">Font utilities available elsewhere</a></li>
+<li><a href="#index-gftype-_0040r_007bGF-validation_007d-711"><code>gftype </code><span class="roman">GF validation</span></a>: <a href="#gftype-invocation">gftype invocation</a></li>
+<li><a href="#index-gftype_002eweb-653"><code>gftype.web</code></a>: <a href="#Font-utilities">Font utilities</a></li>
<li><a href="#index-glue-ratio-representations-201">glue ratio representations</a>: <a href="#Hardware-and-memory-dumps">Hardware and memory dumps</a></li>
<li><a href="#index-glue_002c-memory-for-75">glue, memory for</a>: <a href="#Runtime-options">Runtime options</a></li>
-<li><a href="#index-glyph-substitutions-301">glyph substitutions</a>: <a href="#MLTeX">MLTeX</a></li>
-<li><a href="#index-gray-font-457">gray font</a>: <a href="#gftodvi-invocation">gftodvi invocation</a></li>
+<li><a href="#index-glyph-substitutions-297">glyph substitutions</a>: <a href="#MLTeX">MLTeX</a></li>
+<li><a href="#index-gray-font-468">gray font</a>: <a href="#gftodvi-invocation">gftodvi invocation</a></li>
<li><a href="#index-Gruff_002c-Billy-Goat-61">Gruff, Billy Goat</a>: <a href="#Triptrap">Triptrap</a></li>
-<li><a href="#index-gsftopk-841"><code>gsftopk</code></a>: <a href="#Font-utilities-available-elsewhere">Font utilities available elsewhere</a></li>
+<li><a href="#index-gsftopk-796"><code>gsftopk</code></a>: <a href="#Font-utilities-available-elsewhere">Font utilities available elsewhere</a></li>
<li><a href="#index-Harbison_002c-Samuel-P_002e-205">Harbison, Samuel P.</a>: <a href="#Hardware-and-memory-dumps">Hardware and memory dumps</a></li>
<li><a href="#index-hardware-and-memory-dumps-185">hardware and memory dumps</a>: <a href="#Hardware-and-memory-dumps">Hardware and memory dumps</a></li>
<li><a href="#index-hash-table_002c-increasing-size-of-82">hash table, increasing size of</a>: <a href="#Runtime-options">Runtime options</a></li>
<li><a href="#index-hash_005fextra-80"><code>hash_extra</code></a>: <a href="#Runtime-options">Runtime options</a></li>
-<li><a href="#index-headerbyte-_0040r_007binformation_007d-792"><code>headerbyte </code><span class="roman">information</span></a>: <a href="#tftopl-invocation">tftopl invocation</a></li>
-<li><a href="#index-height_002c-in-pixels-743">height, in pixels</a>: <a href="#pktype-invocation">pktype invocation</a></li>
+<li><a href="#index-headerbyte-_0040r_007binformation_007d-747"><code>headerbyte </code><span class="roman">information</span></a>: <a href="#tftopl-invocation">tftopl invocation</a></li>
+<li><a href="#index-height_002c-in-pixels-698">height, in pixels</a>: <a href="#pktype-invocation">pktype invocation</a></li>
<li><a href="#index-help_002c-online-97">help, online</a>: <a href="#Common-options">Common options</a></li>
<li><a href="#index-Henry_002c-Patrick-11">Henry, Patrick</a>: <a href="#Introduction">Introduction</a></li>
-<li><a href="#index-Herberts_002c-Mathias-405">Herberts, Mathias</a>: <a href="#Online-Metafont-graphics">Online Metafont graphics</a></li>
-<li><a href="#index-hex-character-codes_002c-in-TCX-files-327">hex character codes, in TCX files</a>: <a href="#TCX-files">TCX files</a></li>
+<li><a href="#index-Herberts_002c-Mathias-416">Herberts, Mathias</a>: <a href="#Online-Metafont-graphics">Online Metafont graphics</a></li>
+<li><a href="#index-hex-character-codes_002c-in-TCX-files-323">hex character codes, in TCX files</a>: <a href="#TCX-files">TCX files</a></li>
<li><a href="#index-history-12">history</a>: <a href="#Introduction">Introduction</a></li>
-<li><a href="#index-Hobby_002c-John-564">Hobby, John</a>: <a href="#dmp-invocation">dmp invocation</a></li>
<li><a href="#index-Hobby_002c-John-4">Hobby, John</a>: <a href="#Introduction">Introduction</a></li>
-<li><a href="#index-horizontal-escapement-772">horizontal escapement</a>: <a href="#gftype-invocation">gftype invocation</a></li>
-<li><a href="#index-horizontal-escapement-739">horizontal escapement</a>: <a href="#pktype-invocation">pktype invocation</a></li>
-<li><a href="#index-hp2627-407"><code>hp2627</code></a>: <a href="#Online-Metafont-graphics">Online Metafont graphics</a></li>
-<li><a href="#index-human-languages_002c-supported-in-_0040TeX_007b_007d-294">human languages, supported in TeX</a>: <a href="#Languages-and-hyphenation">Languages and hyphenation</a></li>
-<li><a href="#index-human_002dreadable-text_002c-converting-DVI-to-678">human-readable text, converting DVI to</a>: <a href="#dvitype-invocation">dvitype invocation</a></li>
-<li><a href="#index-human_002dreadable-text_002c-converting-GF-to-759">human-readable text, converting GF to</a>: <a href="#gftype-invocation">gftype invocation</a></li>
-<li><a href="#index-human_002dreadable-text_002c-converting-PK-to-728">human-readable text, converting PK to</a>: <a href="#pktype-invocation">pktype invocation</a></li>
-<li><a href="#index-human_002dreadable-text_002c-converting-TFM-to-786">human-readable text, converting TFM to</a>: <a href="#tftopl-invocation">tftopl invocation</a></li>
-<li><a href="#index-human_002dreadable-text_002c-converting-VF-to-815">human-readable text, converting VF to</a>: <a href="#vftovp-invocation">vftovp invocation</a></li>
-<li><a href="#index-hyphenation-and-languages-295">hyphenation and languages</a>: <a href="#Languages-and-hyphenation">Languages and hyphenation</a></li>
-<li><a href="#index-hyphenation-patterns_002c-creating-335">hyphenation patterns, creating</a>: <a href="#patgen-invocation">patgen invocation</a></li>
+<li><a href="#index-horizontal-escapement-727">horizontal escapement</a>: <a href="#gftype-invocation">gftype invocation</a></li>
+<li><a href="#index-horizontal-escapement-694">horizontal escapement</a>: <a href="#pktype-invocation">pktype invocation</a></li>
+<li><a href="#index-hp2627-418"><code>hp2627</code></a>: <a href="#Online-Metafont-graphics">Online Metafont graphics</a></li>
+<li><a href="#index-human-languages_002c-supported-in-_0040TeX_007b_007d-290">human languages, supported in TeX</a>: <a href="#Languages-and-hyphenation">Languages and hyphenation</a></li>
+<li><a href="#index-human_002dreadable-text_002c-converting-DVI-to-633">human-readable text, converting DVI to</a>: <a href="#dvitype-invocation">dvitype invocation</a></li>
+<li><a href="#index-human_002dreadable-text_002c-converting-GF-to-714">human-readable text, converting GF to</a>: <a href="#gftype-invocation">gftype invocation</a></li>
+<li><a href="#index-human_002dreadable-text_002c-converting-PK-to-683">human-readable text, converting PK to</a>: <a href="#pktype-invocation">pktype invocation</a></li>
+<li><a href="#index-human_002dreadable-text_002c-converting-TFM-to-741">human-readable text, converting TFM to</a>: <a href="#tftopl-invocation">tftopl invocation</a></li>
+<li><a href="#index-human_002dreadable-text_002c-converting-VF-to-770">human-readable text, converting VF to</a>: <a href="#vftovp-invocation">vftovp invocation</a></li>
+<li><a href="#index-hypertext-362">hypertext</a>: <a href="#TeX-extensions">TeX extensions</a></li>
+<li><a href="#index-hyphenation-and-languages-291">hyphenation and languages</a>: <a href="#Languages-and-hyphenation">Languages and hyphenation</a></li>
+<li><a href="#index-hyphenation-patterns_002c-creating-331">hyphenation patterns, creating</a>: <a href="#patgen-invocation">patgen invocation</a></li>
<li><a href="#index-ice-cream-10">ice cream</a>: <a href="#Introduction">Introduction</a></li>
-<li><a href="#index-identifier-case-641">identifier case</a>: <a href="#tangle-invocation">tangle invocation</a></li>
-<li><a href="#index-identifier-collisions-646">identifier collisions</a>: <a href="#tangle-invocation">tangle invocation</a></li>
-<li><a href="#index-identifier-length-637">identifier length</a>: <a href="#tangle-invocation">tangle invocation</a></li>
-<li><a href="#index-identifiers-with-underlines-643">identifiers with underlines</a>: <a href="#tangle-invocation">tangle invocation</a></li>
-<li><a href="#index-ieeetr_002ebst-617"><code>ieeetr.bst</code></a>: <a href="#Basic-BibTeX-style-files">Basic BibTeX style files</a></li>
-<li><a href="#index-il1_002dt1_002etcx-316"><code>il1-t1.tcx</code></a>: <a href="#TCX-files">TCX files</a></li>
-<li><a href="#index-il2_002dt1_002etcx-317"><code>il2-t1.tcx</code></a>: <a href="#TCX-files">TCX files</a></li>
-<li><a href="#index-Info-format-287">Info format</a>: <a href="#Formats">Formats</a></li>
+<li><a href="#index-identifier-case-596">identifier case</a>: <a href="#tangle-invocation">tangle invocation</a></li>
+<li><a href="#index-identifier-collisions-601">identifier collisions</a>: <a href="#tangle-invocation">tangle invocation</a></li>
+<li><a href="#index-identifier-length-592">identifier length</a>: <a href="#tangle-invocation">tangle invocation</a></li>
+<li><a href="#index-identifiers-with-underlines-598">identifiers with underlines</a>: <a href="#tangle-invocation">tangle invocation</a></li>
+<li><a href="#index-ieeetr_002ebst-573"><code>ieeetr.bst</code></a>: <a href="#Basic-BibTeX-style-files">Basic BibTeX style files</a></li>
+<li><a href="#index-il1_002dt1_002etcx-312"><code>il1-t1.tcx</code></a>: <a href="#TCX-files">TCX files</a></li>
+<li><a href="#index-il2_002dt1_002etcx-313"><code>il2-t1.tcx</code></a>: <a href="#TCX-files">TCX files</a></li>
+<li><a href="#index-Info-format-283">Info format</a>: <a href="#Formats">Formats</a></li>
<li><a href="#index-initial-form_002c-enabling-114">initial form, enabling</a>: <a href="#Common-options">Common options</a></li>
-<li><a href="#index-initial-Metafont-378">initial Metafont</a>: <a href="#Initial-Metafont">Initial Metafont</a></li>
-<li><a href="#index-initial-MetaPost-509">initial MetaPost</a>: <a href="#Initial-MetaPost">Initial MetaPost</a></li>
+<li><a href="#index-initial-Metafont-389">initial Metafont</a>: <a href="#Initial-Metafont">Initial Metafont</a></li>
+<li><a href="#index-initial-MetaPost-520">initial MetaPost</a>: <a href="#Initial-MetaPost">Initial MetaPost</a></li>
<li><a href="#index-initial-programs-165">initial programs</a>: <a href="#Initial-and-virgin">Initial and virgin</a></li>
-<li><a href="#index-initial-_0040TeX_007b_007d-272">initial TeX</a>: <a href="#Initial-TeX">Initial TeX</a></li>
+<li><a href="#index-initial-_0040TeX_007b_007d-268">initial TeX</a>: <a href="#Initial-TeX">Initial TeX</a></li>
<li><a href="#index-initializations_002c-lengthy-166">initializations, lengthy</a>: <a href="#Initial-and-virgin">Initial and virgin</a></li>
<li><a href="#index-input-filenames-214">input filenames</a>: <a href="#g_t_005cinput-filenames">\input filenames</a></li>
<li><a href="#index-install_002dbases-_0040r_007bMake-target_007d-54"><code>install-bases </code><span class="roman">Make target</span></a>: <a href="#Additional-targets">Additional targets</a></li>
@@ -4543,60 +4332,57 @@ Up:&nbsp;<a rel="up" accesskey="u" href="#Top">Top</a>
<li><a href="#index-install_002dformats-_0040r_007bMake-target_007d-50"><code>install-formats </code><span class="roman">Make target</span></a>: <a href="#Additional-targets">Additional targets</a></li>
<li><a href="#index-install_002dmems-_0040r_007bMake-target_007d-56"><code>install-mems </code><span class="roman">Make target</span></a>: <a href="#Additional-targets">Additional targets</a></li>
<li><a href="#index-installation-26">installation</a>: <a href="#Installation">Installation</a></li>
-<li><a href="#index-interaction-between-TCX-files-and-_0040samp_007b_002d8bit_007d_002e-333">interaction between TCX files and &lsquo;<samp><span class="samp">-8bit</span></samp>&rsquo;.</a>: <a href="#TCX-files">TCX files</a></li>
+<li><a href="#index-interaction-between-TCX-files-and-_0040samp_007b_002d8bit_007d_002e-329">interaction between TCX files and &lsquo;<samp><span class="samp">-8bit</span></samp>&rsquo;.</a>: <a href="#TCX-files">TCX files</a></li>
<li><a href="#index-interaction-mode-116">interaction mode</a>: <a href="#Common-options">Common options</a></li>
-<li><a href="#index-international-characters-312">international characters</a>: <a href="#TCX-files">TCX files</a></li>
+<li><a href="#index-international-characters-308">international characters</a>: <a href="#TCX-files">TCX files</a></li>
<li><a href="#index-introduction-1">introduction</a>: <a href="#Introduction">Introduction</a></li>
-<li><a href="#index-IPC-337">IPC</a>: <a href="#IPC-and-TeX">IPC and TeX</a></li>
-<li><a href="#index-IPC_005fDEBUG-339"><code>IPC_DEBUG</code></a>: <a href="#IPC-and-TeX">IPC and TeX</a></li>
+<li><a href="#index-IPC-350">IPC</a>: <a href="#IPC-and-TeX">IPC and TeX</a></li>
+<li><a href="#index-IPC_005fDEBUG-352"><code>IPC_DEBUG</code></a>: <a href="#IPC-and-TeX">IPC and TeX</a></li>
<li><a href="#index-IPC_005fDEBUG-43"><code>IPC_DEBUG</code></a>: <a href="#Compile_002dtime-options">Compile-time options</a></li>
<li><a href="#index-job-name-118">job name</a>: <a href="#Common-options">Common options</a></li>
-<li><a href="#index-kerning-table_002c-in-TFM-files-800">kerning table, in TFM files</a>: <a href="#tftopl-invocation">tftopl invocation</a></li>
-<li><a href="#index-keyboard-character-code_002c-translating-332">keyboard character code, translating</a>: <a href="#TCX-files">TCX files</a></li>
-<li><a href="#index-Knuth_002c-Donald-E_002e-470">Knuth, Donald E.</a>: <a href="#mft-invocation">mft invocation</a></li>
+<li><a href="#index-kerning-table_002c-in-TFM-files-755">kerning table, in TFM files</a>: <a href="#tftopl-invocation">tftopl invocation</a></li>
+<li><a href="#index-keyboard-character-code_002c-translating-328">keyboard character code, translating</a>: <a href="#TCX-files">TCX files</a></li>
+<li><a href="#index-Knuth_002c-Donald-E_002e-481">Knuth, Donald E.</a>: <a href="#mft-invocation">mft invocation</a></li>
<li><a href="#index-Knuth_002c-Donald-E_002e-2">Knuth, Donald E.</a>: <a href="#Introduction">Introduction</a></li>
<li><a href="#index-KPATHSEA_005fDEBUG-120"><code>KPATHSEA_DEBUG</code></a>: <a href="#Common-options">Common options</a></li>
-<li><a href="#index-KRN-_0040r_007bproperty_007d-798"><code>KRN </code><span class="roman">property</span></a>: <a href="#tftopl-invocation">tftopl invocation</a></li>
-<li><a href="#index-label-font-459">label font</a>: <a href="#gftodvi-invocation">gftodvi invocation</a></li>
-<li><a href="#index-LABEL-_0040r_007bproperty_007d-796"><code>LABEL </code><span class="roman">property</span></a>: <a href="#tftopl-invocation">tftopl invocation</a></li>
-<li><a href="#index-labels_002c-extracting-from-MetaPost-input-566">labels, extracting from MetaPost input</a>: <a href="#mpto-invocation">mpto invocation</a></li>
-<li><a href="#index-labels_002c-for-MetaPost-526">labels, for MetaPost</a>: <a href="#makempx-invocation">makempx invocation</a></li>
-<li><a href="#index-language-support-in-_0040TeX_007b_007d-293">language support in TeX</a>: <a href="#Languages-and-hyphenation">Languages and hyphenation</a></li>
-<li><a href="#index-languages_002c-hyphenation-rules-for-336">languages, hyphenation rules for</a>: <a href="#patgen-invocation">patgen invocation</a></li>
-<li><a href="#index-g_t_0040LaTeX_007b_007d-282">LaTeX</a>: <a href="#Formats">Formats</a></li>
-<li><a href="#index-Latin-Modern-829">Latin Modern</a>: <a href="#Font-utilities-available-elsewhere">Font utilities available elsewhere</a></li>
-<li><a href="#index-left-side-bearing-766">left side bearing</a>: <a href="#gftype-invocation">gftype invocation</a></li>
-<li><a href="#index-left-side-bearing-752">left side bearing</a>: <a href="#pktype-invocation">pktype invocation</a></li>
-<li><a href="#index-legalisms-853">legalisms</a>: <a href="#Legalisms">Legalisms</a></li>
+<li><a href="#index-KRN-_0040r_007bproperty_007d-753"><code>KRN </code><span class="roman">property</span></a>: <a href="#tftopl-invocation">tftopl invocation</a></li>
+<li><a href="#index-label-font-470">label font</a>: <a href="#gftodvi-invocation">gftodvi invocation</a></li>
+<li><a href="#index-LABEL-_0040r_007bproperty_007d-751"><code>LABEL </code><span class="roman">property</span></a>: <a href="#tftopl-invocation">tftopl invocation</a></li>
+<li><a href="#index-language-support-in-_0040TeX_007b_007d-289">language support in TeX</a>: <a href="#Languages-and-hyphenation">Languages and hyphenation</a></li>
+<li><a href="#index-languages_002c-hyphenation-rules-for-332">languages, hyphenation rules for</a>: <a href="#patgen-invocation">patgen invocation</a></li>
+<li><a href="#index-g_t_0040LaTeX_007b_007d-278">LaTeX</a>: <a href="#Formats">Formats</a></li>
+<li><a href="#index-Latin-Modern-784">Latin Modern</a>: <a href="#Font-utilities-available-elsewhere">Font utilities available elsewhere</a></li>
+<li><a href="#index-left-side-bearing-721">left side bearing</a>: <a href="#gftype-invocation">gftype invocation</a></li>
+<li><a href="#index-left-side-bearing-707">left side bearing</a>: <a href="#pktype-invocation">pktype invocation</a></li>
+<li><a href="#index-legalisms-808">legalisms</a>: <a href="#Legalisms">Legalisms</a></li>
<li><a href="#index-licensing-terms-8">licensing terms</a>: <a href="#Introduction">Introduction</a></li>
-<li><a href="#index-LIG-_0040r_007bproperty_007d-797"><code>LIG </code><span class="roman">property</span></a>: <a href="#tftopl-invocation">tftopl invocation</a></li>
-<li><a href="#index-ligature-table_002c-in-TFM-files-799">ligature table, in TFM files</a>: <a href="#tftopl-invocation">tftopl invocation</a></li>
-<li><a href="#index-LIGTABLE-_0040r_007bproperty_007d-795"><code>LIGTABLE </code><span class="roman">property</span></a>: <a href="#tftopl-invocation">tftopl invocation</a></li>
+<li><a href="#index-LIG-_0040r_007bproperty_007d-752"><code>LIG </code><span class="roman">property</span></a>: <a href="#tftopl-invocation">tftopl invocation</a></li>
+<li><a href="#index-ligature-table_002c-in-TFM-files-754">ligature table, in TFM files</a>: <a href="#tftopl-invocation">tftopl invocation</a></li>
+<li><a href="#index-LIGTABLE-_0040r_007bproperty_007d-750"><code>LIGTABLE </code><span class="roman">property</span></a>: <a href="#tftopl-invocation">tftopl invocation</a></li>
<li><a href="#index-linking-binaries-130">linking binaries</a>: <a href="#Common-options">Common options</a></li>
<li><a href="#index-links-to-binaries-184">links to binaries</a>: <a href="#Determining-the-memory-dump-to-use">Determining the memory dump to use</a></li>
-<li><a href="#index-literate-programming-621">literate programming</a>: <a href="#WEB">WEB</a></li>
-<li><a href="#index-litprog_0040_0040shsu_002eedu-622"><code>litprog@shsu.edu</code></a>: <a href="#WEB">WEB</a></li>
+<li><a href="#index-literate-programming-577">literate programming</a>: <a href="#WEB">WEB</a></li>
<li><a href="#index-LittleEndian-machines-191">LittleEndian machines</a>: <a href="#Hardware-and-memory-dumps">Hardware and memory dumps</a></li>
-<li><a href="#index-log-file_002c-Bib_0040TeX_007b_007d-589">log file, BibTeX</a>: <a href="#bibtex-invocation">bibtex invocation</a></li>
+<li><a href="#index-log-file_002c-Bib_0040TeX_007b_007d-545">log file, BibTeX</a>: <a href="#bibtex-invocation">bibtex invocation</a></li>
+<li><a href="#index-Lua-364">Lua</a>: <a href="#TeX-extensions">TeX extensions</a></li>
+<li><a href="#index-lua_0040TeX_007b_007d-363">luaTeX</a>: <a href="#TeX-extensions">TeX extensions</a></li>
<li><a href="#index-machine-dependencies-194">machine dependencies</a>: <a href="#Hardware-and-memory-dumps">Hardware and memory dumps</a></li>
-<li><a href="#index-machine_002dreadable_002c-converting-property-lists-to-821">machine-readable, converting property lists to</a>: <a href="#vptovf-invocation">vptovf invocation</a></li>
-<li><a href="#index-machine_002dreadable_002c-converting-property-lists-to-810">machine-readable, converting property lists to</a>: <a href="#pltotf-invocation">pltotf invocation</a></li>
-<li><a href="#index-MacKay_002c-Pierre-715">MacKay, Pierre</a>: <a href="#Font-file-formats">Font file formats</a></li>
-<li><a href="#index-macro-packages_002c-major-_0040TeX_007b_007d-281">macro packages, major TeX</a>: <a href="#Formats">Formats</a></li>
+<li><a href="#index-machine_002dreadable_002c-converting-property-lists-to-776">machine-readable, converting property lists to</a>: <a href="#vptovf-invocation">vptovf invocation</a></li>
+<li><a href="#index-machine_002dreadable_002c-converting-property-lists-to-765">machine-readable, converting property lists to</a>: <a href="#pltotf-invocation">pltotf invocation</a></li>
+<li><a href="#index-MacKay_002c-Pierre-670">MacKay, Pierre</a>: <a href="#Font-file-formats">Font file formats</a></li>
+<li><a href="#index-macro-packages_002c-major-_0040TeX_007b_007d-277">macro packages, major TeX</a>: <a href="#Formats">Formats</a></li>
<li><a href="#index-macros_002c-basic-31">macros, basic</a>: <a href="#Installation">Installation</a></li>
<li><a href="#index-macros_002c-predefining-in-memory-dumps-169">macros, predefining in memory dumps</a>: <a href="#Memory-dumps">Memory dumps</a></li>
-<li><a href="#index-magnification-683">magnification</a>: <a href="#dvitype-invocation">dvitype invocation</a></li>
-<li><a href="#index-magnification-668">magnification</a>: <a href="#dvicopy-invocation">dvicopy invocation</a></li>
+<li><a href="#index-magnification-638">magnification</a>: <a href="#dvitype-invocation">dvitype invocation</a></li>
+<li><a href="#index-magnification-623">magnification</a>: <a href="#dvicopy-invocation">dvicopy invocation</a></li>
<li><a href="#index-main_005fmemory-72"><code>main_memory</code></a>: <a href="#Runtime-options">Runtime options</a></li>
<li><a href="#index-Make-targets_002c-additional-46">Make targets, additional</a>: <a href="#Additional-targets">Additional targets</a></li>
-<li><a href="#index-makempx-523"><code>makempx</code></a>: <a href="#makempx-invocation">makempx invocation</a></li>
-<li><a href="#index-MAKEMPX_005fBINDIR-539"><code>MAKEMPX_BINDIR</code></a>: <a href="#makempx-invocation">makempx invocation</a></li>
<li><a href="#index-Martin_002c-Rick-20">Martin, Rick</a>: <a href="#Introduction">Introduction</a></li>
-<li><a href="#index-Mathematical-Reviews-285">Mathematical Reviews</a>: <a href="#Formats">Formats</a></li>
+<li><a href="#index-Mathematical-Reviews-281">Mathematical Reviews</a>: <a href="#Formats">Formats</a></li>
<li><a href="#index-mathematical-typesetting-229">mathematical typesetting</a>: <a href="#TeX">TeX</a></li>
<li><a href="#index-mem-file_002c-determining-177">mem file, determining</a>: <a href="#Determining-the-memory-dump-to-use">Determining the memory dump to use</a></li>
-<li><a href="#index-mem-files-512">mem files</a>: <a href="#Initial-MetaPost">Initial MetaPost</a></li>
-<li><a href="#index-mem-files_002c-plain-only-515">mem files, plain only</a>: <a href="#Initial-MetaPost">Initial MetaPost</a></li>
+<li><a href="#index-mem-files-523">mem files</a>: <a href="#Initial-MetaPost">Initial MetaPost</a></li>
+<li><a href="#index-mem-files_002c-plain-only-526">mem files, plain only</a>: <a href="#Initial-MetaPost">Initial MetaPost</a></li>
<li><a href="#index-mem-files_002c-sharing-190">mem files, sharing</a>: <a href="#Hardware-and-memory-dumps">Hardware and memory dumps</a></li>
<li><a href="#index-memory-dump-to-use_002c-determining-174">memory dump to use, determining</a>: <a href="#Determining-the-memory-dump-to-use">Determining the memory dump to use</a></li>
<li><a href="#index-memory-dumps-167">memory dumps</a>: <a href="#Memory-dumps">Memory dumps</a></li>
@@ -4605,365 +4391,341 @@ Up:&nbsp;<a rel="up" accesskey="u" href="#Top">Top</a>
<li><a href="#index-memory-dumps_002c-creating-171">memory dumps, creating</a>: <a href="#Creating-memory-dumps">Creating memory dumps</a></li>
<li><a href="#index-mems-_0040r_007bMake-target_007d-55"><code>mems </code><span class="roman">Make target</span></a>: <a href="#Additional-targets">Additional targets</a></li>
<li><a href="#index-meta-characters-in-filenames-222">meta characters in filenames</a>: <a href="#g_t_005cinput-filenames">\input filenames</a></li>
-<li><a href="#index-Metafont-354">Metafont</a>: <a href="#Metafont">Metafont</a></li>
-<li><a href="#index-Metafont-geometry-445">Metafont geometry</a>: <a href="#Online-Metafont-graphics">Online Metafont graphics</a></li>
-<li><a href="#index-Metafont-graphics-401">Metafont graphics</a>: <a href="#Online-Metafont-graphics">Online Metafont graphics</a></li>
-<li><a href="#index-Metafont-input-files-362">Metafont input files</a>: <a href="#mf-invocation">mf invocation</a></li>
-<li><a href="#index-Metafont-invocation-360">Metafont invocation</a>: <a href="#mf-invocation">mf invocation</a></li>
-<li><a href="#index-Metafont-meets-PostScript-482">Metafont meets PostScript</a>: <a href="#MetaPost">MetaPost</a></li>
-<li><a href="#index-Metafont-online-support_002c-new-devices-450">Metafont online support, new devices</a>: <a href="#Online-Metafont-graphics">Online Metafont graphics</a></li>
-<li><a href="#index-Metafont-source_002c-prettyprinting-465">Metafont source, prettyprinting</a>: <a href="#mft-invocation">mft invocation</a></li>
-<li><a href="#index-Metafont_002c-compatibility-in-MetaPost-516">Metafont, compatibility in MetaPost</a>: <a href="#Initial-MetaPost">Initial MetaPost</a></li>
-<li><a href="#index-Metafont_002c-initial-379">Metafont, initial</a>: <a href="#Initial-Metafont">Initial Metafont</a></li>
+<li><a href="#index-Metafont-365">Metafont</a>: <a href="#Metafont">Metafont</a></li>
+<li><a href="#index-Metafont-geometry-456">Metafont geometry</a>: <a href="#Online-Metafont-graphics">Online Metafont graphics</a></li>
+<li><a href="#index-Metafont-graphics-412">Metafont graphics</a>: <a href="#Online-Metafont-graphics">Online Metafont graphics</a></li>
+<li><a href="#index-Metafont-input-files-373">Metafont input files</a>: <a href="#mf-invocation">mf invocation</a></li>
+<li><a href="#index-Metafont-invocation-371">Metafont invocation</a>: <a href="#mf-invocation">mf invocation</a></li>
+<li><a href="#index-Metafont-meets-PostScript-493">Metafont meets PostScript</a>: <a href="#MetaPost">MetaPost</a></li>
+<li><a href="#index-Metafont-online-support_002c-new-devices-461">Metafont online support, new devices</a>: <a href="#Online-Metafont-graphics">Online Metafont graphics</a></li>
+<li><a href="#index-Metafont-source_002c-prettyprinting-476">Metafont source, prettyprinting</a>: <a href="#mft-invocation">mft invocation</a></li>
+<li><a href="#index-Metafont_002c-compatibility-in-MetaPost-527">Metafont, compatibility in MetaPost</a>: <a href="#Initial-MetaPost">Initial MetaPost</a></li>
+<li><a href="#index-Metafont_002c-initial-390">Metafont, initial</a>: <a href="#Initial-Metafont">Initial Metafont</a></li>
<li><a href="#index-Metafont_002c-MetaPost_002c-and-_0040TeX_007b_007d-159">Metafont, MetaPost, and TeX</a>: <a href="#Three-programs">Three programs</a></li>
-<li><a href="#index-MetaFun_002c-enhanced-MetaPost-521">MetaFun, enhanced MetaPost</a>: <a href="#Initial-MetaPost">Initial MetaPost</a></li>
-<li><a href="#index-metafun_002emp-520"><code>metafun.mp</code></a>: <a href="#Initial-MetaPost">Initial MetaPost</a></li>
-<li><a href="#index-MetaPost-480">MetaPost</a>: <a href="#MetaPost">MetaPost</a></li>
-<li><a href="#index-MetaPost-and-plain-Metafont-compatibility-518">MetaPost and plain Metafont compatibility</a>: <a href="#Initial-MetaPost">Initial MetaPost</a></li>
-<li><a href="#index-MetaPost-input-files-488">MetaPost input files</a>: <a href="#mpost-invocation">mpost invocation</a></li>
-<li><a href="#index-MetaPost-input_002c-extracting-labels-from-569">MetaPost input, extracting labels from</a>: <a href="#mpto-invocation">mpto invocation</a></li>
-<li><a href="#index-MetaPost-invocation-484">MetaPost invocation</a>: <a href="#mpost-invocation">mpost invocation</a></li>
-<li><a href="#index-MetaPost-labels-524">MetaPost labels</a>: <a href="#makempx-invocation">makempx invocation</a></li>
-<li><a href="#index-MetaPost-source_002c-prettyprinting-479">MetaPost source, prettyprinting</a>: <a href="#mft-invocation">mft invocation</a></li>
-<li><a href="#index-MetaPost_002c-initial-510">MetaPost, initial</a>: <a href="#Initial-MetaPost">Initial MetaPost</a></li>
+<li><a href="#index-MetaFun_002c-enhanced-MetaPost-532">MetaFun, enhanced MetaPost</a>: <a href="#Initial-MetaPost">Initial MetaPost</a></li>
+<li><a href="#index-metafun_002emp-531"><code>metafun.mp</code></a>: <a href="#Initial-MetaPost">Initial MetaPost</a></li>
+<li><a href="#index-MetaPost-491">MetaPost</a>: <a href="#MetaPost">MetaPost</a></li>
+<li><a href="#index-MetaPost-and-plain-Metafont-compatibility-529">MetaPost and plain Metafont compatibility</a>: <a href="#Initial-MetaPost">Initial MetaPost</a></li>
+<li><a href="#index-MetaPost-input-files-499">MetaPost input files</a>: <a href="#mpost-invocation">mpost invocation</a></li>
+<li><a href="#index-MetaPost-invocation-495">MetaPost invocation</a>: <a href="#mpost-invocation">mpost invocation</a></li>
+<li><a href="#index-MetaPost-source_002c-prettyprinting-490">MetaPost source, prettyprinting</a>: <a href="#mft-invocation">mft invocation</a></li>
+<li><a href="#index-MetaPost_002c-initial-521">MetaPost, initial</a>: <a href="#Initial-MetaPost">Initial MetaPost</a></li>
<li><a href="#index-MetaPost_002c-_0040TeX_007b_007d_002c-and-Metafont-160">MetaPost, TeX, and Metafont</a>: <a href="#Three-programs">Three programs</a></li>
-<li><a href="#index-metatype1-828"><code>metatype1</code></a>: <a href="#Font-utilities-available-elsewhere">Font utilities available elsewhere</a></li>
-<li><a href="#index-mf-359"><code>mf</code></a>: <a href="#mf-invocation">mf invocation</a></li>
-<li><a href="#index-mf_002ebase-383"><code>mf.base</code></a>: <a href="#Initial-Metafont">Initial Metafont</a></li>
+<li><a href="#index-metatype1-783"><code>metatype1</code></a>: <a href="#Font-utilities-available-elsewhere">Font utilities available elsewhere</a></li>
+<li><a href="#index-mf-370"><code>mf</code></a>: <a href="#mf-invocation">mf invocation</a></li>
+<li><a href="#index-mf_002ebase-394"><code>mf.base</code></a>: <a href="#Initial-Metafont">Initial Metafont</a></li>
<li><a href="#index-MFEDIT-211"><code>MFEDIT</code></a>: <a href="#Editor-invocation">Editor invocation</a></li>
-<li><a href="#index-mfplain_002emem-519"><code>mfplain.mem</code></a>: <a href="#Initial-MetaPost">Initial MetaPost</a></li>
-<li><a href="#index-mfput-366"><code>mfput</code></a>: <a href="#mf-invocation">mf invocation</a></li>
-<li><a href="#index-mft-464"><code>mft</code></a>: <a href="#mft-invocation">mft invocation</a></li>
-<li><a href="#index-mftalk-409"><code>mftalk</code></a>: <a href="#Online-Metafont-graphics">Online Metafont graphics</a></li>
-<li><a href="#index-MFTERM-402"><code>MFTERM</code></a>: <a href="#Online-Metafont-graphics">Online Metafont graphics</a></li>
-<li><a href="#index-mftmac_002etex-468"><code>mftmac.tex</code></a>: <a href="#mft-invocation">mft invocation</a></li>
-<li><a href="#index-mktexmf_0040r_007b_002c-disabling_007d-364"><code>mktexmf</code><span class="roman">, disabling</span></a>: <a href="#mf-invocation">mf invocation</a></li>
+<li><a href="#index-mfplain_002emem-530"><code>mfplain.mem</code></a>: <a href="#Initial-MetaPost">Initial MetaPost</a></li>
+<li><a href="#index-mfput-377"><code>mfput</code></a>: <a href="#mf-invocation">mf invocation</a></li>
+<li><a href="#index-mft-475"><code>mft</code></a>: <a href="#mft-invocation">mft invocation</a></li>
+<li><a href="#index-mftalk-420"><code>mftalk</code></a>: <a href="#Online-Metafont-graphics">Online Metafont graphics</a></li>
+<li><a href="#index-MFTERM-413"><code>MFTERM</code></a>: <a href="#Online-Metafont-graphics">Online Metafont graphics</a></li>
+<li><a href="#index-mftmac_002etex-479"><code>mftmac.tex</code></a>: <a href="#mft-invocation">mft invocation</a></li>
+<li><a href="#index-micro_002dtypography-361">micro-typography</a>: <a href="#TeX-extensions">TeX extensions</a></li>
+<li><a href="#index-mktexmf_0040r_007b_002c-disabling_007d-375"><code>mktexmf</code><span class="roman">, disabling</span></a>: <a href="#mf-invocation">mf invocation</a></li>
<li><a href="#index-mktextfM_0040r_007b_002c-disabling_007d-238"><code>mktextfM</code><span class="roman">, disabling</span></a>: <a href="#tex-invocation">tex invocation</a></li>
-<li><a href="#index-mltex-296"><code>mltex</code></a>: <a href="#MLTeX">MLTeX</a></li>
+<li><a href="#index-mltex-292"><code>mltex</code></a>: <a href="#MLTeX">MLTeX</a></li>
<li><a href="#index-ML_0040TeX_007b_007d_002c-enabling-256">MLTeX, enabling</a>: <a href="#tex-invocation">tex invocation</a></li>
-<li><a href="#index-mode-needed-to-run-Metafont-372">mode needed to run Metafont</a>: <a href="#mf-invocation">mf invocation</a></li>
-<li><a href="#index-mode_005fdef-396"><code>mode_def</code></a>: <a href="#Modes">Modes</a></li>
-<li><a href="#index-mode_005fsetup-397"><code>mode_setup</code></a>: <a href="#Modes">Modes</a></li>
-<li><a href="#index-modes-file-needed-for-Metafont-390">modes file needed for Metafont</a>: <a href="#Modes">Modes</a></li>
-<li><a href="#index-modes_002emf-_0040r_007brecommended-modes-file_007d-394"><code>modes.mf </code><span class="roman">recommended modes file</span></a>: <a href="#Modes">Modes</a></li>
+<li><a href="#index-mode-needed-to-run-Metafont-383">mode needed to run Metafont</a>: <a href="#mf-invocation">mf invocation</a></li>
+<li><a href="#index-mode_005fdef-407"><code>mode_def</code></a>: <a href="#Modes">Modes</a></li>
+<li><a href="#index-mode_005fsetup-408"><code>mode_setup</code></a>: <a href="#Modes">Modes</a></li>
+<li><a href="#index-modes-file-needed-for-Metafont-401">modes file needed for Metafont</a>: <a href="#Modes">Modes</a></li>
+<li><a href="#index-modes_002emf-_0040r_007brecommended-modes-file_007d-405"><code>modes.mf </code><span class="roman">recommended modes file</span></a>: <a href="#Modes">Modes</a></li>
<li><a href="#index-Morgan_002c-Tim-16">Morgan, Tim</a>: <a href="#Introduction">Introduction</a></li>
<li><a href="#index-Morris_002c-Bob-21">Morris, Bob</a>: <a href="#Introduction">Introduction</a></li>
<li><a href="#index-MPEDIT-212"><code>MPEDIT</code></a>: <a href="#Editor-invocation">Editor invocation</a></li>
-<li><a href="#index-mpgraph_002eps-486"><code>mpgraph.ps</code></a>: <a href="#mpost-invocation">mpost invocation</a></li>
-<li><a href="#index-mpman_002eps-485"><code>mpman.ps</code></a>: <a href="#mpost-invocation">mpost invocation</a></li>
-<li><a href="#index-mpost-483"><code>mpost</code></a>: <a href="#mpost-invocation">mpost invocation</a></li>
+<li><a href="#index-mpgraph_002eps-497"><code>mpgraph.ps</code></a>: <a href="#mpost-invocation">mpost invocation</a></li>
+<li><a href="#index-mpman_002eps-496"><code>mpman.ps</code></a>: <a href="#mpost-invocation">mpost invocation</a></li>
+<li><a href="#index-mpost-494"><code>mpost</code></a>: <a href="#mpost-invocation">mpost invocation</a></li>
<li><a href="#index-mpost_0040r_007b_002c-reason-for-name-change_007d-27"><code>mpost</code><span class="roman">, reason for name change</span></a>: <a href="#Installation">Installation</a></li>
-<li><a href="#index-mpost_002emem-514"><code>mpost.mem</code></a>: <a href="#Initial-MetaPost">Initial MetaPost</a></li>
-<li><a href="#index-mpout-492"><code>mpout</code></a>: <a href="#mpost-invocation">mpost invocation</a></li>
-<li><a href="#index-mproof_002etex-500"><code>mproof.tex</code></a>: <a href="#mpost-invocation">mpost invocation</a></li>
-<li><a href="#index-MPSUPPORT-560"><code>MPSUPPORT</code></a>: <a href="#dmp-invocation">dmp invocation</a></li>
-<li><a href="#index-MPto-565"><code>MPto</code></a>: <a href="#mpto-invocation">mpto invocation</a></li>
-<li><a href="#index-MPto_002c-invoked-by-MakeMPX-527">MPto, invoked by MakeMPX</a>: <a href="#makempx-invocation">makempx invocation</a></li>
-<li><a href="#index-MPTOTEX-541"><code>MPTOTEX</code></a>: <a href="#makempx-invocation">makempx invocation</a></li>
-<li><a href="#index-MPTOTR-542"><code>MPTOTR</code></a>: <a href="#makempx-invocation">makempx invocation</a></li>
+<li><a href="#index-mpost_002emem-525"><code>mpost.mem</code></a>: <a href="#Initial-MetaPost">Initial MetaPost</a></li>
+<li><a href="#index-mpout-503"><code>mpout</code></a>: <a href="#mpost-invocation">mpost invocation</a></li>
+<li><a href="#index-mproof_002etex-511"><code>mproof.tex</code></a>: <a href="#mpost-invocation">mpost invocation</a></li>
<li><a href="#index-mptrap-_0040r_007bMake-target_007d-60"><code>mptrap </code><span class="roman">Make target</span></a>: <a href="#Additional-targets">Additional targets</a></li>
<li><a href="#index-mptrap-test-64">mptrap test</a>: <a href="#Triptrap">Triptrap</a></li>
<li><a href="#index-mptrap_002ereadme-68"><code>mptrap.readme</code></a>: <a href="#Triptrap">Triptrap</a></li>
-<li><a href="#index-mpx-file_002c-defined-538">mpx file, defined</a>: <a href="#makempx-invocation">makempx invocation</a></li>
-<li><a href="#index-MPX-files_002c-converting-from-DVI-files-549">MPX files, converting from DVI files</a>: <a href="#dvitomp-invocation">dvitomp invocation</a></li>
-<li><a href="#index-MPX-files_002c-creating-from-ditroff-output-553">MPX files, creating from ditroff output</a>: <a href="#dmp-invocation">dmp invocation</a></li>
-<li><a href="#index-mpxerr-534"><code>mpxerr</code></a>: <a href="#makempx-invocation">makempx invocation</a></li>
-<li><a href="#index-mpxerr_002edvi-531"><code>mpxerr.dvi</code></a>: <a href="#makempx-invocation">makempx invocation</a></li>
-<li><a href="#index-mpxerr_002elog-530"><code>mpxerr.log</code></a>: <a href="#makempx-invocation">makempx invocation</a></li>
-<li><a href="#index-mpxerr_002et-533"><code>mpxerr.t</code></a>: <a href="#makempx-invocation">makempx invocation</a></li>
-<li><a href="#index-mpxerr_002etex-532"><code>mpxerr.tex</code></a>: <a href="#makempx-invocation">makempx invocation</a></li>
-<li><a href="#index-mtimes-of-files_002c-comparing-578">mtimes of files, comparing</a>: <a href="#newer-invocation">newer invocation</a></li>
-<li><a href="#index-Multi_002dlingual-_0040TeX_007b_007d-297">Multi-lingual TeX</a>: <a href="#MLTeX">MLTeX</a></li>
-<li><a href="#index-multiple-DVI-files_002c-creating-353">multiple DVI files, creating</a>: <a href="#TeX-extensions">TeX extensions</a></li>
-<li><a href="#index-N-tilde-305">N tilde</a>: <a href="#g_t_005ccharsubdef">\charsubdef</a></li>
-<li><a href="#index-new-graphics-support-for-Metafont-451">new graphics support for Metafont</a>: <a href="#Online-Metafont-graphics">Online Metafont graphics</a></li>
-<li><a href="#index-NEWER-540"><code>NEWER</code></a>: <a href="#makempx-invocation">makempx invocation</a></li>
-<li><a href="#index-newer-_0040r_007bfile-comparison_007d-575"><code>newer </code><span class="roman">file comparison</span></a>: <a href="#newer-invocation">newer invocation</a></li>
-<li><a href="#index-newrow-_0040r_007bGF-command_007d-770"><code>newrow </code><span class="roman">GF command</span></a>: <a href="#gftype-invocation">gftype invocation</a></li>
-<li><a href="#index-next-411"><code>next</code></a>: <a href="#Online-Metafont-graphics">Online Metafont graphics</a></li>
-<li><a href="#index-NO_005fX11WIN-429"><code>NO_X11WIN</code></a>: <a href="#Online-Metafont-graphics">Online Metafont graphics</a></li>
+<li><a href="#index-MPX-files_002c-converting-from-DVI-files-536">MPX files, converting from DVI files</a>: <a href="#dvitomp-invocation">dvitomp invocation</a></li>
+<li><a href="#index-Multi_002dlingual-_0040TeX_007b_007d-293">Multi-lingual TeX</a>: <a href="#MLTeX">MLTeX</a></li>
+<li><a href="#index-N-tilde-301">N tilde</a>: <a href="#g_t_005ccharsubdef">\charsubdef</a></li>
+<li><a href="#index-new-graphics-support-for-Metafont-462">new graphics support for Metafont</a>: <a href="#Online-Metafont-graphics">Online Metafont graphics</a></li>
+<li><a href="#index-newrow-_0040r_007bGF-command_007d-725"><code>newrow </code><span class="roman">GF command</span></a>: <a href="#gftype-invocation">gftype invocation</a></li>
+<li><a href="#index-next-422"><code>next</code></a>: <a href="#Online-Metafont-graphics">Online Metafont graphics</a></li>
+<li><a href="#index-NO_005fX11WIN-440"><code>NO_X11WIN</code></a>: <a href="#Online-Metafont-graphics">Online Metafont graphics</a></li>
<li><a href="#index-non_002dUnix-system_002c-compiling-on-48">non-Unix system, compiling on</a>: <a href="#Additional-targets">Additional targets</a></li>
<li><a href="#index-NUL_002c-not-allowed-in-filenames-220">NUL, not allowed in filenames</a>: <a href="#g_t_005cinput-filenames">\input filenames</a></li>
-<li><a href="#index-octal-character-codes_002c-in-TCX-files-326">octal character codes, in TCX files</a>: <a href="#TCX-files">TCX files</a></li>
-<li><a href="#index-offset-for-overflow-labels-463">offset for overflow labels</a>: <a href="#gftodvi-invocation">gftodvi invocation</a></li>
-<li><a href="#index-older_002dthan_002c-file-comparisons-579">older-than, file comparisons</a>: <a href="#newer-invocation">newer invocation</a></li>
-<li><a href="#index-Omega-344">Omega</a>: <a href="#TeX-extensions">TeX extensions</a></li>
-<li><a href="#index-online-Metafont-graphics-400">online Metafont graphics</a>: <a href="#Online-Metafont-graphics">Online Metafont graphics</a></li>
-<li><a href="#index-opcodes_002c-showing-DVI-692">opcodes, showing DVI</a>: <a href="#dvitype-invocation">dvitype invocation</a></li>
-<li><a href="#index-optical-font-scaling-705">optical font scaling</a>: <a href="#Font-file-formats">Font file formats</a></li>
+<li><a href="#index-octal-character-codes_002c-in-TCX-files-322">octal character codes, in TCX files</a>: <a href="#TCX-files">TCX files</a></li>
+<li><a href="#index-offset-for-overflow-labels-474">offset for overflow labels</a>: <a href="#gftodvi-invocation">gftodvi invocation</a></li>
+<li><a href="#index-Omega-357">Omega</a>: <a href="#TeX-extensions">TeX extensions</a></li>
+<li><a href="#index-online-Metafont-graphics-411">online Metafont graphics</a>: <a href="#Online-Metafont-graphics">Online Metafont graphics</a></li>
+<li><a href="#index-opcodes_002c-showing-DVI-647">opcodes, showing DVI</a>: <a href="#dvitype-invocation">dvitype invocation</a></li>
+<li><a href="#index-optical-font-scaling-660">optical font scaling</a>: <a href="#Font-file-formats">Font file formats</a></li>
<li><a href="#index-option-conventions-88">option conventions</a>: <a href="#Option-conventions">Option conventions</a></li>
-<li><a href="#index-origin-749">origin</a>: <a href="#pktype-invocation">pktype invocation</a></li>
+<li><a href="#index-origin-704">origin</a>: <a href="#pktype-invocation">pktype invocation</a></li>
<li><a href="#index-output-directory_002c-specifying-153">output directory, specifying</a>: <a href="#Output-file-location">Output file location</a></li>
<li><a href="#index-output-directory_002c-specifying-124">output directory, specifying</a>: <a href="#Common-options">Common options</a></li>
<li><a href="#index-output-file-location-149">output file location</a>: <a href="#Output-file-location">Output file location</a></li>
<li><a href="#index-output-files_002c-written-by-_0040TeX_007b_007d-programs-242">output files, written by TeX programs</a>: <a href="#tex-invocation">tex invocation</a></li>
<li><a href="#index-output_005fcomment-_0040r_007bfor-DVI-files_007d-259"><code>output_comment </code><span class="roman">for DVI files</span></a>: <a href="#tex-invocation">tex invocation</a></li>
-<li><a href="#index-overflow-label-offset-462">overflow label offset</a>: <a href="#gftodvi-invocation">gftodvi invocation</a></li>
-<li><a href="#index-packet-length-735">packet length</a>: <a href="#pktype-invocation">pktype invocation</a></li>
-<li><a href="#index-page_002c-starting-689">page, starting</a>: <a href="#dvitype-invocation">dvitype invocation</a></li>
-<li><a href="#index-page_002c-starting-673">page, starting</a>: <a href="#dvicopy-invocation">dvicopy invocation</a></li>
+<li><a href="#index-overflow-label-offset-473">overflow label offset</a>: <a href="#gftodvi-invocation">gftodvi invocation</a></li>
+<li><a href="#index-packet-length-690">packet length</a>: <a href="#pktype-invocation">pktype invocation</a></li>
+<li><a href="#index-page_002c-starting-644">page, starting</a>: <a href="#dvitype-invocation">dvitype invocation</a></li>
+<li><a href="#index-page_002c-starting-628">page, starting</a>: <a href="#dvicopy-invocation">dvicopy invocation</a></li>
<li><a href="#index-parsing-the-first-line-127">parsing the first line</a>: <a href="#Common-options">Common options</a></li>
-<li><a href="#index-Pascal_002c-creating-from-WEB-631">Pascal, creating from WEB</a>: <a href="#tangle-invocation">tangle invocation</a></li>
-<li><a href="#index-patgen-334"><code>patgen</code></a>: <a href="#patgen-invocation">patgen invocation</a></li>
+<li><a href="#index-Pascal_002c-creating-from-WEB-586">Pascal, creating from WEB</a>: <a href="#tangle-invocation">tangle invocation</a></li>
+<li><a href="#index-patgen-330"><code>patgen</code></a>: <a href="#patgen-invocation">patgen invocation</a></li>
<li><a href="#index-path-searching-143">path searching</a>: <a href="#Path-searching">Path searching</a></li>
<li><a href="#index-path-searching-debugging-122">path searching debugging</a>: <a href="#Common-options">Common options</a></li>
-<li><a href="#index-PDF-347">PDF</a>: <a href="#TeX-extensions">TeX extensions</a></li>
-<li><a href="#index-pdf_0040TeX_007b_007d-346">pdfTeX</a>: <a href="#TeX-extensions">TeX extensions</a></li>
-<li><a href="#index-permissions_002c-legal-855">permissions, legal</a>: <a href="#Legalisms">Legalisms</a></li>
-<li><a href="#index-PFA-and-PFB-conversion-844">PFA and PFB conversion</a>: <a href="#Font-utilities-available-elsewhere">Font utilities available elsewhere</a></li>
-<li><a href="#index-pfaedit-838"><code>pfaedit</code></a>: <a href="#Font-utilities-available-elsewhere">Font utilities available elsewhere</a></li>
+<li><a href="#index-PDF-360">PDF</a>: <a href="#TeX-extensions">TeX extensions</a></li>
+<li><a href="#index-pdf_0040TeX_007b_007d-359">pdfTeX</a>: <a href="#TeX-extensions">TeX extensions</a></li>
+<li><a href="#index-permissions_002c-legal-810">permissions, legal</a>: <a href="#Legalisms">Legalisms</a></li>
+<li><a href="#index-PFA-and-PFB-conversion-799">PFA and PFB conversion</a>: <a href="#Font-utilities-available-elsewhere">Font utilities available elsewhere</a></li>
+<li><a href="#index-pfaedit-793"><code>pfaedit</code></a>: <a href="#Font-utilities-available-elsewhere">Font utilities available elsewhere</a></li>
<li><a href="#index-PiC_0040TeX_007b_007d_002c-increasing-memory-for-77">PiCTeX, increasing memory for</a>: <a href="#Runtime-options">Runtime options</a></li>
-<li><a href="#index-picture-expressions-537">picture expressions</a>: <a href="#makempx-invocation">makempx invocation</a></li>
-<li><a href="#index-pixel-height-744">pixel height</a>: <a href="#pktype-invocation">pktype invocation</a></li>
-<li><a href="#index-pixel-width-745">pixel width</a>: <a href="#pktype-invocation">pktype invocation</a></li>
-<li><a href="#index-PK-bitmaps-from-PostScript-839">PK bitmaps from PostScript</a>: <a href="#Font-utilities-available-elsewhere">Font utilities available elsewhere</a></li>
-<li><a href="#index-PK-files_002c-explained-710">PK files, explained</a>: <a href="#Font-file-formats">Font file formats</a></li>
-<li><a href="#index-PK-files_002c-not-output-by-Metafont-369">PK files, not output by Metafont</a>: <a href="#mf-invocation">mf invocation</a></li>
-<li><a href="#index-PK-format-definition-699">PK format definition</a>: <a href="#Font-utilities">Font utilities</a></li>
-<li><a href="#index-PK_002c-converting-GF-to-719">PK, converting GF to</a>: <a href="#gftopk-invocation">gftopk invocation</a></li>
-<li><a href="#index-PK_002c-converting-to-GF-724">PK, converting to GF</a>: <a href="#pktogf-invocation">pktogf invocation</a></li>
-<li><a href="#index-pktogf-721"><code>pktogf</code></a>: <a href="#pktogf-invocation">pktogf invocation</a></li>
-<li><a href="#index-pktype-_0040r_007bPK-validation_007d-725"><code>pktype </code><span class="roman">PK validation</span></a>: <a href="#pktype-invocation">pktype invocation</a></li>
-<li><a href="#index-pktype_002eweb-697"><code>pktype.web</code></a>: <a href="#Font-utilities">Font utilities</a></li>
-<li><a href="#index-PL-files_002c-explained-712">PL files, explained</a>: <a href="#Font-file-formats">Font file formats</a></li>
-<li><a href="#index-plain-Metafont_002c-compatibility-in-MetaPost-517">plain Metafont, compatibility in MetaPost</a>: <a href="#Initial-MetaPost">Initial MetaPost</a></li>
-<li><a href="#index-plain-text_002c-converting-DVI-to-677">plain text, converting DVI to</a>: <a href="#dvitype-invocation">dvitype invocation</a></li>
-<li><a href="#index-plain-text_002c-converting-GF-to-758">plain text, converting GF to</a>: <a href="#gftype-invocation">gftype invocation</a></li>
-<li><a href="#index-plain-text_002c-converting-PK-to-727">plain text, converting PK to</a>: <a href="#pktype-invocation">pktype invocation</a></li>
-<li><a href="#index-plain-text_002c-converting-TFM-to-787">plain text, converting TFM to</a>: <a href="#tftopl-invocation">tftopl invocation</a></li>
-<li><a href="#index-plain-text_002c-converting-VF-to-816">plain text, converting VF to</a>: <a href="#vftovp-invocation">vftovp invocation</a></li>
-<li><a href="#index-plain_002ebase-382"><code>plain.base</code></a>: <a href="#Initial-Metafont">Initial Metafont</a></li>
-<li><a href="#index-plain_002ebst-612"><code>plain.bst</code></a>: <a href="#Basic-BibTeX-style-files">Basic BibTeX style files</a></li>
-<li><a href="#index-plain_002efmt-276"><code>plain.fmt</code></a>: <a href="#Initial-TeX">Initial TeX</a></li>
-<li><a href="#index-plain_002emem-513"><code>plain.mem</code></a>: <a href="#Initial-MetaPost">Initial MetaPost</a></li>
-<li><a href="#index-plain_002emft-475"><code>plain.mft</code></a>: <a href="#mft-invocation">mft invocation</a></li>
-<li><a href="#index-pltotf-807"><code>pltotf</code></a>: <a href="#pltotf-invocation">pltotf invocation</a></li>
-<li><a href="#index-pool-file_002c-writing-634">pool file, writing</a>: <a href="#tangle-invocation">tangle invocation</a></li>
-<li><a href="#index-Poole_002c-Simon-425">Poole, Simon</a>: <a href="#Online-Metafont-graphics">Online Metafont graphics</a></li>
-<li><a href="#index-pooltype-656"><code>pooltype</code></a>: <a href="#pooltype-invocation">pooltype invocation</a></li>
+<li><a href="#index-pipes_002c-reading-and-writing-344">pipes, reading and writing</a>: <a href="#Shell-escapes">Shell escapes</a></li>
+<li><a href="#index-pixel-height-699">pixel height</a>: <a href="#pktype-invocation">pktype invocation</a></li>
+<li><a href="#index-pixel-width-700">pixel width</a>: <a href="#pktype-invocation">pktype invocation</a></li>
+<li><a href="#index-PK-bitmaps-from-PostScript-794">PK bitmaps from PostScript</a>: <a href="#Font-utilities-available-elsewhere">Font utilities available elsewhere</a></li>
+<li><a href="#index-PK-files_002c-explained-665">PK files, explained</a>: <a href="#Font-file-formats">Font file formats</a></li>
+<li><a href="#index-PK-files_002c-not-output-by-Metafont-380">PK files, not output by Metafont</a>: <a href="#mf-invocation">mf invocation</a></li>
+<li><a href="#index-PK-format-definition-654">PK format definition</a>: <a href="#Font-utilities">Font utilities</a></li>
+<li><a href="#index-PK_002c-converting-GF-to-674">PK, converting GF to</a>: <a href="#gftopk-invocation">gftopk invocation</a></li>
+<li><a href="#index-PK_002c-converting-to-GF-679">PK, converting to GF</a>: <a href="#pktogf-invocation">pktogf invocation</a></li>
+<li><a href="#index-pktogf-676"><code>pktogf</code></a>: <a href="#pktogf-invocation">pktogf invocation</a></li>
+<li><a href="#index-pktype-_0040r_007bPK-validation_007d-680"><code>pktype </code><span class="roman">PK validation</span></a>: <a href="#pktype-invocation">pktype invocation</a></li>
+<li><a href="#index-pktype_002eweb-652"><code>pktype.web</code></a>: <a href="#Font-utilities">Font utilities</a></li>
+<li><a href="#index-PL-files_002c-explained-667">PL files, explained</a>: <a href="#Font-file-formats">Font file formats</a></li>
+<li><a href="#index-plain-Metafont_002c-compatibility-in-MetaPost-528">plain Metafont, compatibility in MetaPost</a>: <a href="#Initial-MetaPost">Initial MetaPost</a></li>
+<li><a href="#index-plain-text_002c-converting-DVI-to-632">plain text, converting DVI to</a>: <a href="#dvitype-invocation">dvitype invocation</a></li>
+<li><a href="#index-plain-text_002c-converting-GF-to-713">plain text, converting GF to</a>: <a href="#gftype-invocation">gftype invocation</a></li>
+<li><a href="#index-plain-text_002c-converting-PK-to-682">plain text, converting PK to</a>: <a href="#pktype-invocation">pktype invocation</a></li>
+<li><a href="#index-plain-text_002c-converting-TFM-to-742">plain text, converting TFM to</a>: <a href="#tftopl-invocation">tftopl invocation</a></li>
+<li><a href="#index-plain-text_002c-converting-VF-to-771">plain text, converting VF to</a>: <a href="#vftovp-invocation">vftovp invocation</a></li>
+<li><a href="#index-plain_002ebase-393"><code>plain.base</code></a>: <a href="#Initial-Metafont">Initial Metafont</a></li>
+<li><a href="#index-plain_002ebst-568"><code>plain.bst</code></a>: <a href="#Basic-BibTeX-style-files">Basic BibTeX style files</a></li>
+<li><a href="#index-plain_002efmt-272"><code>plain.fmt</code></a>: <a href="#Initial-TeX">Initial TeX</a></li>
+<li><a href="#index-plain_002emem-524"><code>plain.mem</code></a>: <a href="#Initial-MetaPost">Initial MetaPost</a></li>
+<li><a href="#index-plain_002emft-486"><code>plain.mft</code></a>: <a href="#mft-invocation">mft invocation</a></li>
+<li><a href="#index-pltotf-762"><code>pltotf</code></a>: <a href="#pltotf-invocation">pltotf invocation</a></li>
+<li><a href="#index-pool-file_002c-writing-589">pool file, writing</a>: <a href="#tangle-invocation">tangle invocation</a></li>
+<li><a href="#index-Poole_002c-Simon-436">Poole, Simon</a>: <a href="#Online-Metafont-graphics">Online Metafont graphics</a></li>
+<li><a href="#index-pooltype-611"><code>pooltype</code></a>: <a href="#pooltype-invocation">pooltype invocation</a></li>
<li><a href="#index-portable-filenames-223">portable filenames</a>: <a href="#g_t_005cinput-filenames">\input filenames</a></li>
-<li><a href="#index-PostScript-fonts_002c-and-Troff-497">PostScript fonts, and Troff</a>: <a href="#mpost-invocation">mpost invocation</a></li>
-<li><a href="#index-PostScript-meets-Metafont-481">PostScript meets Metafont</a>: <a href="#MetaPost">MetaPost</a></li>
-<li><a href="#index-PostScript-output-494">PostScript output</a>: <a href="#mpost-invocation">mpost invocation</a></li>
-<li><a href="#index-PostScript-to-PK-bitmaps-840">PostScript to PK bitmaps</a>: <a href="#Font-utilities-available-elsewhere">Font utilities available elsewhere</a></li>
-<li><a href="#index-PostScript-Type-1-font-conversion-845">PostScript Type 1 font conversion</a>: <a href="#Font-utilities-available-elsewhere">Font utilities available elsewhere</a></li>
-<li><a href="#index-PostScript_002c-and-font-scaling-707">PostScript, and font scaling</a>: <a href="#Font-file-formats">Font file formats</a></li>
-<li><a href="#index-potrace-850"><code>potrace</code></a>: <a href="#Font-utilities-available-elsewhere">Font utilities available elsewhere</a></li>
-<li><a href="#index-Pragma-ADE-522">Pragma ADE</a>: <a href="#Initial-MetaPost">Initial MetaPost</a></li>
+<li><a href="#index-PostScript-fonts_002c-and-Troff-508">PostScript fonts, and Troff</a>: <a href="#mpost-invocation">mpost invocation</a></li>
+<li><a href="#index-PostScript-meets-Metafont-492">PostScript meets Metafont</a>: <a href="#MetaPost">MetaPost</a></li>
+<li><a href="#index-PostScript-output-505">PostScript output</a>: <a href="#mpost-invocation">mpost invocation</a></li>
+<li><a href="#index-PostScript-to-PK-bitmaps-795">PostScript to PK bitmaps</a>: <a href="#Font-utilities-available-elsewhere">Font utilities available elsewhere</a></li>
+<li><a href="#index-PostScript-Type-1-font-conversion-800">PostScript Type 1 font conversion</a>: <a href="#Font-utilities-available-elsewhere">Font utilities available elsewhere</a></li>
+<li><a href="#index-PostScript_002c-and-font-scaling-662">PostScript, and font scaling</a>: <a href="#Font-file-formats">Font file formats</a></li>
+<li><a href="#index-potrace-805"><code>potrace</code></a>: <a href="#Font-utilities-available-elsewhere">Font utilities available elsewhere</a></li>
+<li><a href="#index-Pragma-ADE-533">Pragma ADE</a>: <a href="#Initial-MetaPost">Initial MetaPost</a></li>
<li><a href="#index-predefined-macros-and-memory-dumps-170">predefined macros and memory dumps</a>: <a href="#Memory-dumps">Memory dumps</a></li>
-<li><a href="#index-prettyprinting-Metafont-source-466">prettyprinting Metafont source</a>: <a href="#mft-invocation">mft invocation</a></li>
-<li><a href="#index-prettyprinting-WEB-programs-650">prettyprinting WEB programs</a>: <a href="#weave-invocation">weave invocation</a></li>
-<li><a href="#index-primitives_002c-new-343">primitives, new</a>: <a href="#TeX-extensions">TeX extensions</a></li>
-<li><a href="#index-printable-characters_002c-specifying-329">printable characters, specifying</a>: <a href="#TCX-files">TCX files</a></li>
-<li><a href="#index-printer-characteristics_002c-for-Metafont-393">printer characteristics, for Metafont</a>: <a href="#Modes">Modes</a></li>
+<li><a href="#index-prettyprinting-Metafont-source-477">prettyprinting Metafont source</a>: <a href="#mft-invocation">mft invocation</a></li>
+<li><a href="#index-prettyprinting-WEB-programs-605">prettyprinting WEB programs</a>: <a href="#weave-invocation">weave invocation</a></li>
+<li><a href="#index-primitives_002c-new-356">primitives, new</a>: <a href="#TeX-extensions">TeX extensions</a></li>
+<li><a href="#index-printable-characters_002c-specifying-325">printable characters, specifying</a>: <a href="#TCX-files">TCX files</a></li>
+<li><a href="#index-printer-characteristics_002c-for-Metafont-404">printer characteristics, for Metafont</a>: <a href="#Modes">Modes</a></li>
<li><a href="#index-production-use-164">production use</a>: <a href="#Initial-and-virgin">Initial and virgin</a></li>
<li><a href="#index-program-name_002c-determines-memory-dump-183">program name, determines memory dump</a>: <a href="#Determining-the-memory-dump-to-use">Determining the memory dump to use</a></li>
<li><a href="#index-program-names_002c-special-257">program names, special</a>: <a href="#tex-invocation">tex invocation</a></li>
<li><a href="#index-program-names_002c-special-113">program names, special</a>: <a href="#Common-options">Common options</a></li>
-<li><a href="#index-prologues-507"><code>prologues</code></a>: <a href="#mpost-invocation">mpost invocation</a></li>
-<li><a href="#index-prologues-_0040r_007band-Troff-in-MetaPost_007d-536"><code>prologues </code><span class="roman">and Troff in MetaPost</span></a>: <a href="#makempx-invocation">makempx invocation</a></li>
-<li><a href="#index-prologues_0040r_007b_002c-and-EPSF-output_007d-503"><code>prologues</code><span class="roman">, and EPSF output</span></a>: <a href="#mpost-invocation">mpost invocation</a></li>
-<li><a href="#index-proof-_0040r_007bmode_007d-373"><code>proof </code><span class="roman">mode</span></a>: <a href="#mf-invocation">mf invocation</a></li>
-<li><a href="#index-proof-sheets_002c-of-fonts-456">proof sheets, of fonts</a>: <a href="#gftodvi-invocation">gftodvi invocation</a></li>
-<li><a href="#index-property-list-format-789">property list format</a>: <a href="#tftopl-invocation">tftopl invocation</a></li>
-<li><a href="#index-property-list_002c-converting-TFM-to-785">property list, converting TFM to</a>: <a href="#tftopl-invocation">tftopl invocation</a></li>
-<li><a href="#index-property-list_002c-converting-VF-to-virtual-814">property list, converting VF to virtual</a>: <a href="#vftovp-invocation">vftovp invocation</a></li>
-<li><a href="#index-ps2pk-842"><code>ps2pk</code></a>: <a href="#Font-utilities-available-elsewhere">Font utilities available elsewhere</a></li>
-<li><a href="#index-psfonts_002emap_0040r_007b_002c-read-by-MetaPost_007d-504"><code>psfonts.map</code><span class="roman">, read by MetaPost</span></a>: <a href="#mpost-invocation">mpost invocation</a></li>
-<li><a href="#index-PXL-files_002c-explained-709">PXL files, explained</a>: <a href="#Font-file-formats">Font file formats</a></li>
-<li><a href="#index-pxtoch-836"><code>pxtoch</code></a>: <a href="#Font-utilities-available-elsewhere">Font utilities available elsewhere</a></li>
-<li><a href="#index-Raichle_002c-Bernd-299">Raichle, Bernd</a>: <a href="#MLTeX">MLTeX</a></li>
+<li><a href="#index-prologues-518"><code>prologues</code></a>: <a href="#mpost-invocation">mpost invocation</a></li>
+<li><a href="#index-prologues_0040r_007b_002c-and-EPSF-output_007d-514"><code>prologues</code><span class="roman">, and EPSF output</span></a>: <a href="#mpost-invocation">mpost invocation</a></li>
+<li><a href="#index-proof-_0040r_007bmode_007d-384"><code>proof </code><span class="roman">mode</span></a>: <a href="#mf-invocation">mf invocation</a></li>
+<li><a href="#index-proof-sheets_002c-of-fonts-467">proof sheets, of fonts</a>: <a href="#gftodvi-invocation">gftodvi invocation</a></li>
+<li><a href="#index-property-list-format-744">property list format</a>: <a href="#tftopl-invocation">tftopl invocation</a></li>
+<li><a href="#index-property-list_002c-converting-TFM-to-740">property list, converting TFM to</a>: <a href="#tftopl-invocation">tftopl invocation</a></li>
+<li><a href="#index-property-list_002c-converting-VF-to-virtual-769">property list, converting VF to virtual</a>: <a href="#vftovp-invocation">vftovp invocation</a></li>
+<li><a href="#index-ps2pk-797"><code>ps2pk</code></a>: <a href="#Font-utilities-available-elsewhere">Font utilities available elsewhere</a></li>
+<li><a href="#index-psfonts_002emap_0040r_007b_002c-read-by-MetaPost_007d-515"><code>psfonts.map</code><span class="roman">, read by MetaPost</span></a>: <a href="#mpost-invocation">mpost invocation</a></li>
+<li><a href="#index-PXL-files_002c-explained-664">PXL files, explained</a>: <a href="#Font-file-formats">Font file formats</a></li>
+<li><a href="#index-pxtoch-791"><code>pxtoch</code></a>: <a href="#Font-utilities-available-elsewhere">Font utilities available elsewhere</a></li>
+<li><a href="#index-Raichle_002c-Bernd-295">Raichle, Bernd</a>: <a href="#MLTeX">MLTeX</a></li>
<li><a href="#index-reading_002c-additional-23">reading, additional</a>: <a href="#Introduction">Introduction</a></li>
<li><a href="#index-readonly-directory_002c-running-_0040TeX_007b_007d-in-154">readonly directory, running TeX in</a>: <a href="#Output-file-location">Output file location</a></li>
<li><a href="#index-reallocation-of-arrays-85">reallocation of arrays</a>: <a href="#Runtime-options">Runtime options</a></li>
-<li><a href="#index-redefined-character-substitutions-307">redefined character substitutions</a>: <a href="#g_t_005ctracingcharsubdef">\tracingcharsubdef</a></li>
-<li><a href="#index-reference-pixel-750">reference pixel</a>: <a href="#pktype-invocation">pktype invocation</a></li>
-<li><a href="#index-references-856">references</a>: <a href="#References">References</a></li>
-<li><a href="#index-regis-414"><code>regis</code></a>: <a href="#Online-Metafont-graphics">Online Metafont graphics</a></li>
-<li><a href="#index-Regis-graphics-support-416">Regis graphics support</a>: <a href="#Online-Metafont-graphics">Online Metafont graphics</a></li>
+<li><a href="#index-redefined-character-substitutions-303">redefined character substitutions</a>: <a href="#g_t_005ctracingcharsubdef">\tracingcharsubdef</a></li>
+<li><a href="#index-reference-pixel-705">reference pixel</a>: <a href="#pktype-invocation">pktype invocation</a></li>
+<li><a href="#index-references-811">references</a>: <a href="#References">References</a></li>
+<li><a href="#index-regis-425"><code>regis</code></a>: <a href="#Online-Metafont-graphics">Online Metafont graphics</a></li>
+<li><a href="#index-Regis-graphics-support-427">Regis graphics support</a>: <a href="#Online-Metafont-graphics">Online Metafont graphics</a></li>
<li><a href="#index-regression-testing-261">regression testing</a>: <a href="#tex-invocation">tex invocation</a></li>
-<li><a href="#index-repeated-rows-755">repeated rows</a>: <a href="#pktype-invocation">pktype invocation</a></li>
-<li><a href="#index-representation-of-strings-660">representation of strings</a>: <a href="#pooltype-invocation">pooltype invocation</a></li>
-<li><a href="#index-right-side-bearing-767">right side bearing</a>: <a href="#gftype-invocation">gftype invocation</a></li>
-<li><a href="#index-right-side-bearing-753">right side bearing</a>: <a href="#pktype-invocation">pktype invocation</a></li>
-<li><a href="#index-right_002dto_002dleft-typesetting-350">right-to-left typesetting</a>: <a href="#TeX-extensions">TeX extensions</a></li>
+<li><a href="#index-repeated-rows-710">repeated rows</a>: <a href="#pktype-invocation">pktype invocation</a></li>
+<li><a href="#index-representation-of-strings-615">representation of strings</a>: <a href="#pooltype-invocation">pooltype invocation</a></li>
+<li><a href="#index-restricted-shell-escapes-335">restricted shell escapes</a>: <a href="#Shell-escapes">Shell escapes</a></li>
+<li><a href="#index-right-side-bearing-722">right side bearing</a>: <a href="#gftype-invocation">gftype invocation</a></li>
+<li><a href="#index-right-side-bearing-708">right side bearing</a>: <a href="#pktype-invocation">pktype invocation</a></li>
<li><a href="#index-Rokicki_002c-Tomas-13">Rokicki, Tomas</a>: <a href="#Introduction">Introduction</a></li>
-<li><a href="#index-run-length-encoded-bitmaps-769">run length encoded bitmaps</a>: <a href="#gftype-invocation">gftype invocation</a></li>
-<li><a href="#index-run-length-encoded-bitmaps-754">run length encoded bitmaps</a>: <a href="#pktype-invocation">pktype invocation</a></li>
+<li><a href="#index-run-length-encoded-bitmaps-724">run length encoded bitmaps</a>: <a href="#gftype-invocation">gftype invocation</a></li>
+<li><a href="#index-run-length-encoded-bitmaps-709">run length encoded bitmaps</a>: <a href="#pktype-invocation">pktype invocation</a></li>
<li><a href="#index-runtime-options-69">runtime options</a>: <a href="#Runtime-options">Runtime options</a></li>
-<li><a href="#index-scaled-pixels-776">scaled pixels</a>: <a href="#gftype-invocation">gftype invocation</a></li>
-<li><a href="#index-scaled-pixels-741">scaled pixels</a>: <a href="#pktype-invocation">pktype invocation</a></li>
-<li><a href="#index-scaling-of-fonts-704">scaling of fonts</a>: <a href="#Font-file-formats">Font file formats</a></li>
-<li><a href="#index-scanned-images-of-fonts-846">scanned images of fonts</a>: <a href="#Font-utilities-available-elsewhere">Font utilities available elsewhere</a></li>
+<li><a href="#index-scaled-pixels-731">scaled pixels</a>: <a href="#gftype-invocation">gftype invocation</a></li>
+<li><a href="#index-scaled-pixels-696">scaled pixels</a>: <a href="#pktype-invocation">pktype invocation</a></li>
+<li><a href="#index-scaling-of-fonts-659">scaling of fonts</a>: <a href="#Font-file-formats">Font file formats</a></li>
+<li><a href="#index-scanned-images-of-fonts-801">scanned images of fonts</a>: <a href="#Font-utilities-available-elsewhere">Font utilities available elsewhere</a></li>
<li><a href="#index-security_002c-and-_0040code_007b_005copenout_007d-241">security, and <code>\openout</code></a>: <a href="#tex-invocation">tex invocation</a></li>
<li><a href="#index-security_002c-and-output-files-245">security, and output files</a>: <a href="#tex-invocation">tex invocation</a></li>
-<li><a href="#index-security_002c-and-shell-escapes-270">security, and shell escapes</a>: <a href="#tex-invocation">tex invocation</a></li>
-<li><a href="#index-SetColor-_0040r_007bditroff-command_007d-557"><code>SetColor </code><span class="roman">ditroff command</span></a>: <a href="#dmp-invocation">dmp invocation</a></li>
-<li><a href="#index-shapes-357">shapes</a>: <a href="#Metafont">Metafont</a></li>
+<li><a href="#index-security_002c-and-shell-escapes-334">security, and shell escapes</a>: <a href="#Shell-escapes">Shell escapes</a></li>
+<li><a href="#index-shapes-368">shapes</a>: <a href="#Metafont">Metafont</a></li>
<li><a href="#index-sharing-memory-dumps-187">sharing memory dumps</a>: <a href="#Hardware-and-memory-dumps">Hardware and memory dumps</a></li>
-<li><a href="#index-shell-commands-in-_0040TeX_007b_007d-264">shell commands in TeX</a>: <a href="#tex-invocation">tex invocation</a></li>
-<li><a href="#index-shell_005fescape-_0040r_007benabling-in-_0040TeX_007b_007d_007d-266"><code>shell_escape </code><span class="roman">enabling in TeX</span></a>: <a href="#tex-invocation">tex invocation</a></li>
-<li><a href="#index-siam_002ebst-618"><code>siam.bst</code></a>: <a href="#Basic-BibTeX-style-files">Basic BibTeX style files</a></li>
-<li><a href="#index-side-bearings-768">side bearings</a>: <a href="#gftype-invocation">gftype invocation</a></li>
-<li><a href="#index-side-bearings-751">side bearings</a>: <a href="#pktype-invocation">pktype invocation</a></li>
-<li><a href="#index-slant-font-460">slant font</a>: <a href="#gftodvi-invocation">gftodvi invocation</a></li>
-<li><a href="#index-slides_002c-producing-292">slides, producing</a>: <a href="#Formats">Formats</a></li>
-<li><a href="#index-Sli_0040TeX_007b_007d-291">SliTeX</a>: <a href="#Formats">Formats</a></li>
-<li><a href="#index-small-Metafont-memory-and-modes-395">small Metafont memory and modes</a>: <a href="#Modes">Modes</a></li>
-<li><a href="#index-smode-_0040r_007band-dynamic-Metafont-mode-definition_007d-398"><code>smode </code><span class="roman">and dynamic Metafont mode definition</span></a>: <a href="#Modes">Modes</a></li>
-<li><a href="#index-sockets-338">sockets</a>: <a href="#IPC-and-TeX">IPC and TeX</a></li>
+<li><a href="#index-shell-commands-in-_0040TeX_007b_007d-333">shell commands in TeX</a>: <a href="#Shell-escapes">Shell escapes</a></li>
+<li><a href="#index-shell_005fescape-_0040r_007benabling-in-_0040TeX_007b_007d_007d-337"><code>shell_escape </code><span class="roman">enabling in TeX</span></a>: <a href="#Shell-escapes">Shell escapes</a></li>
+<li><a href="#index-shell_005fescape_005fcommands-343"><code>shell_escape_commands</code></a>: <a href="#Shell-escapes">Shell escapes</a></li>
+<li><a href="#index-siam_002ebst-574"><code>siam.bst</code></a>: <a href="#Basic-BibTeX-style-files">Basic BibTeX style files</a></li>
+<li><a href="#index-side-bearings-723">side bearings</a>: <a href="#gftype-invocation">gftype invocation</a></li>
+<li><a href="#index-side-bearings-706">side bearings</a>: <a href="#pktype-invocation">pktype invocation</a></li>
+<li><a href="#index-slant-font-471">slant font</a>: <a href="#gftodvi-invocation">gftodvi invocation</a></li>
+<li><a href="#index-slides_002c-producing-288">slides, producing</a>: <a href="#Formats">Formats</a></li>
+<li><a href="#index-Sli_0040TeX_007b_007d-287">SliTeX</a>: <a href="#Formats">Formats</a></li>
+<li><a href="#index-small-Metafont-memory-and-modes-406">small Metafont memory and modes</a>: <a href="#Modes">Modes</a></li>
+<li><a href="#index-smode-_0040r_007band-dynamic-Metafont-mode-definition_007d-409"><code>smode </code><span class="roman">and dynamic Metafont mode definition</span></a>: <a href="#Modes">Modes</a></li>
+<li><a href="#index-sockets-351">sockets</a>: <a href="#IPC-and-TeX">IPC and TeX</a></li>
<li><a href="#index-space_002dterminated-filenames-217">space-terminated filenames</a>: <a href="#g_t_005cinput-filenames">\input filenames</a></li>
-<li><a href="#index-Spiderweb-624">Spiderweb</a>: <a href="#WEB">WEB</a></li>
+<li><a href="#index-Spiderweb-579">Spiderweb</a>: <a href="#WEB">WEB</a></li>
<li><a href="#index-Stallman_002c-Richard-22">Stallman, Richard</a>: <a href="#Introduction">Introduction</a></li>
-<li><a href="#index-starting-page-688">starting page</a>: <a href="#dvitype-invocation">dvitype invocation</a></li>
-<li><a href="#index-starting-page-672">starting page</a>: <a href="#dvicopy-invocation">dvicopy invocation</a></li>
+<li><a href="#index-starting-page-643">starting page</a>: <a href="#dvitype-invocation">dvitype invocation</a></li>
+<li><a href="#index-starting-page-627">starting page</a>: <a href="#dvicopy-invocation">dvicopy invocation</a></li>
<li><a href="#index-Steele-Jr_002e_002c-Guy-L_002e-206">Steele Jr., Guy L.</a>: <a href="#Hardware-and-memory-dumps">Hardware and memory dumps</a></li>
<li><a href="#index-stopping-at-the-first-error-111">stopping at the first error</a>: <a href="#Common-options">Common options</a></li>
<li><a href="#index-strategy_002c-overall-7">strategy, overall</a>: <a href="#Introduction">Introduction</a></li>
-<li><a href="#index-string-numbers_002c-displaying-658">string numbers, displaying</a>: <a href="#pooltype-invocation">pooltype invocation</a></li>
-<li><a href="#index-string-pool_002c-writing-635">string pool, writing</a>: <a href="#tangle-invocation">tangle invocation</a></li>
-<li><a href="#index-string-representation-661">string representation</a>: <a href="#pooltype-invocation">pooltype invocation</a></li>
-<li><a href="#index-style-design_002c-for-Bib_0040TeX_007b_007d-603">style design, for BibTeX</a>: <a href="#bibtex-invocation">bibtex invocation</a></li>
-<li><a href="#index-style-files-474">style files</a>: <a href="#mft-invocation">mft invocation</a></li>
-<li><a href="#index-substitutions-of-font-glyphs-302">substitutions of font glyphs</a>: <a href="#MLTeX">MLTeX</a></li>
-<li><a href="#index-sun-417"><code>sun</code></a>: <a href="#Online-Metafont-graphics">Online Metafont graphics</a></li>
-<li><a href="#index-sun_002dgfx_002ec-421"><code>sun-gfx.c</code></a>: <a href="#Online-Metafont-graphics">Online Metafont graphics</a></li>
-<li><a href="#index-Suntools-419">Suntools</a>: <a href="#Online-Metafont-graphics">Online Metafont graphics</a></li>
-<li><a href="#index-SunView-418">SunView</a>: <a href="#Online-Metafont-graphics">Online Metafont graphics</a></li>
+<li><a href="#index-string-numbers_002c-displaying-613">string numbers, displaying</a>: <a href="#pooltype-invocation">pooltype invocation</a></li>
+<li><a href="#index-string-pool_002c-writing-590">string pool, writing</a>: <a href="#tangle-invocation">tangle invocation</a></li>
+<li><a href="#index-string-representation-616">string representation</a>: <a href="#pooltype-invocation">pooltype invocation</a></li>
+<li><a href="#index-style-design_002c-for-Bib_0040TeX_007b_007d-559">style design, for BibTeX</a>: <a href="#bibtex-invocation">bibtex invocation</a></li>
+<li><a href="#index-style-files-485">style files</a>: <a href="#mft-invocation">mft invocation</a></li>
+<li><a href="#index-substitutions-of-font-glyphs-298">substitutions of font glyphs</a>: <a href="#MLTeX">MLTeX</a></li>
+<li><a href="#index-sun-428"><code>sun</code></a>: <a href="#Online-Metafont-graphics">Online Metafont graphics</a></li>
+<li><a href="#index-sun_002dgfx_002ec-432"><code>sun-gfx.c</code></a>: <a href="#Online-Metafont-graphics">Online Metafont graphics</a></li>
+<li><a href="#index-Suntools-430">Suntools</a>: <a href="#Online-Metafont-graphics">Online Metafont graphics</a></li>
+<li><a href="#index-SunView-429">SunView</a>: <a href="#Online-Metafont-graphics">Online Metafont graphics</a></li>
<li><a href="#index-swap-space_002c-as-array-limit-84">swap space, as array limit</a>: <a href="#Runtime-options">Runtime options</a></li>
<li><a href="#index-swapping-bytes-199">swapping bytes</a>: <a href="#Hardware-and-memory-dumps">Hardware and memory dumps</a></li>
-<li><a href="#index-syntax-of-TCX-files-321">syntax of TCX files</a>: <a href="#TCX-files">TCX files</a></li>
-<li><a href="#index-system-_0040r_007bC-library-function_007d-269"><code>system </code><span class="roman">C library function</span></a>: <a href="#tex-invocation">tex invocation</a></li>
-<li><a href="#index-T1-encoding-and-ISO-input-320">T1 encoding and ISO input</a>: <a href="#TCX-files">TCX files</a></li>
-<li><a href="#index-Tachikawa_002c-Elizabeth-716">Tachikawa, Elizabeth</a>: <a href="#Font-file-formats">Font file formats</a></li>
-<li><a href="#index-tangle-630"><code>tangle</code></a>: <a href="#tangle-invocation">tangle invocation</a></li>
+<li><a href="#index-syntax-of-TCX-files-317">syntax of TCX files</a>: <a href="#TCX-files">TCX files</a></li>
+<li><a href="#index-system-_0040r_007bC-library-function_007d-340"><code>system </code><span class="roman">C library function</span></a>: <a href="#Shell-escapes">Shell escapes</a></li>
+<li><a href="#index-system-command-336">system command</a>: <a href="#Shell-escapes">Shell escapes</a></li>
+<li><a href="#index-T1-encoding-and-ISO-input-316">T1 encoding and ISO input</a>: <a href="#TCX-files">TCX files</a></li>
+<li><a href="#index-Tachikawa_002c-Elizabeth-671">Tachikawa, Elizabeth</a>: <a href="#Font-file-formats">Font file formats</a></li>
+<li><a href="#index-tangle-585"><code>tangle</code></a>: <a href="#tangle-invocation">tangle invocation</a></li>
<li><a href="#index-targets_002c-additional-Make-45">targets, additional Make</a>: <a href="#Additional-targets">Additional targets</a></li>
-<li><a href="#index-TCX-_0040r_007bcharacter-translation-files_007d-309"><code>TCX </code><span class="roman">character translation files</span></a>: <a href="#TCX-files">TCX files</a></li>
-<li><a href="#index-tek-422"><code>tek</code></a>: <a href="#Online-Metafont-graphics">Online Metafont graphics</a></li>
-<li><a href="#index-Tektronix-423">Tektronix</a>: <a href="#Online-Metafont-graphics">Online Metafont graphics</a></li>
-<li><a href="#index-Tektronix-4014-427">Tektronix 4014</a>: <a href="#Online-Metafont-graphics">Online Metafont graphics</a></li>
-<li><a href="#index-TERM-403"><code>TERM</code></a>: <a href="#Online-Metafont-graphics">Online Metafont graphics</a></li>
+<li><a href="#index-TCX-_0040r_007bcharacter-translation-files_007d-305"><code>TCX </code><span class="roman">character translation files</span></a>: <a href="#TCX-files">TCX files</a></li>
+<li><a href="#index-tek-433"><code>tek</code></a>: <a href="#Online-Metafont-graphics">Online Metafont graphics</a></li>
+<li><a href="#index-Tektronix-434">Tektronix</a>: <a href="#Online-Metafont-graphics">Online Metafont graphics</a></li>
+<li><a href="#index-Tektronix-4014-438">Tektronix 4014</a>: <a href="#Online-Metafont-graphics">Online Metafont graphics</a></li>
+<li><a href="#index-TERM-414"><code>TERM</code></a>: <a href="#Online-Metafont-graphics">Online Metafont graphics</a></li>
<li><a href="#index-terminator-for-filenames-219">terminator for filenames</a>: <a href="#g_t_005cinput-filenames">\input filenames</a></li>
-<li><a href="#index-terse-output-596">terse output</a>: <a href="#bibtex-invocation">bibtex invocation</a></li>
-<li><a href="#index-TEX-545"><code>TEX</code></a>: <a href="#makempx-invocation">makempx invocation</a></li>
+<li><a href="#index-terse-output-552">terse output</a>: <a href="#bibtex-invocation">bibtex invocation</a></li>
<li><a href="#index-tex-232"><code>tex</code></a>: <a href="#tex-invocation">tex invocation</a></li>
-<li><a href="#index-g_t_0040TeX_007b_007d_002c-bibliographies-for-609">TeX, bibliographies for</a>: <a href="#bibtex-invocation">bibtex invocation</a></li>
-<li><a href="#index-g_t_0040TeX_007b_007d_002c-creating-from-Metafont-467">TeX, creating from Metafont</a>: <a href="#mft-invocation">mft invocation</a></li>
-<li><a href="#index-g_t_0040TeX_007b_007d_002c-creating-from-WEB-648">TeX, creating from WEB</a>: <a href="#weave-invocation">weave invocation</a></li>
+<li><a href="#index-g_t_0040TeX_007b_007d_002c-bibliographies-for-565">TeX, bibliographies for</a>: <a href="#bibtex-invocation">bibtex invocation</a></li>
+<li><a href="#index-g_t_0040TeX_007b_007d_002c-creating-from-Metafont-478">TeX, creating from Metafont</a>: <a href="#mft-invocation">mft invocation</a></li>
+<li><a href="#index-g_t_0040TeX_007b_007d_002c-creating-from-WEB-603">TeX, creating from WEB</a>: <a href="#weave-invocation">weave invocation</a></li>
<li><a href="#index-g_t_0040TeX_007b_007d_002c-description-of-227">TeX, description of</a>: <a href="#TeX">TeX</a></li>
-<li><a href="#index-g_t_0040TeX_007b_007d_002c-extensions-to-341">TeX, extensions to</a>: <a href="#TeX-extensions">TeX extensions</a></li>
-<li><a href="#index-g_t_0040TeX_007b_007d_002c-format-packages-for-280">TeX, format packages for</a>: <a href="#Formats">Formats</a></li>
-<li><a href="#index-g_t_0040TeX_007b_007d_002c-initial-273">TeX, initial</a>: <a href="#Initial-TeX">Initial TeX</a></li>
+<li><a href="#index-g_t_0040TeX_007b_007d_002c-extensions-to-354">TeX, extensions to</a>: <a href="#TeX-extensions">TeX extensions</a></li>
+<li><a href="#index-g_t_0040TeX_007b_007d_002c-format-packages-for-276">TeX, format packages for</a>: <a href="#Formats">Formats</a></li>
+<li><a href="#index-g_t_0040TeX_007b_007d_002c-initial-269">TeX, initial</a>: <a href="#Initial-TeX">Initial TeX</a></li>
<li><a href="#index-g_t_0040TeX_007b_007d_002c-input-files-found-235">TeX, input files found</a>: <a href="#tex-invocation">tex invocation</a></li>
<li><a href="#index-g_t_0040TeX_007b_007d_002c-invocation-233">TeX, invocation</a>: <a href="#tex-invocation">tex invocation</a></li>
<li><a href="#index-g_t_0040TeX_007b_007d_002c-Metafont_002c-and-MetaPost-158">TeX, Metafont, and MetaPost</a>: <a href="#Three-programs">Three programs</a></li>
<li><a href="#index-g_t_0040TeX_007b_007d_002c-Web2c-implementation-of-3">TeX, Web2c implementation of</a>: <a href="#Introduction">Introduction</a></li>
-<li><a href="#index-TeX_002d_002dXeT-348"><code>TeX--XeT</code></a>: <a href="#TeX-extensions">TeX extensions</a></li>
-<li><a href="#index-tex_002efmt-277"><code>tex.fmt</code></a>: <a href="#Initial-TeX">Initial TeX</a></li>
-<li><a href="#index-TEXBIB_0040r_007b_002c-search-path-for-bib-files_007d-592"><code>TEXBIB</code><span class="roman">, search path for bib files</span></a>: <a href="#bibtex-invocation">bibtex invocation</a></li>
+<li><a href="#index-tex_002efmt-273"><code>tex.fmt</code></a>: <a href="#Initial-TeX">Initial TeX</a></li>
+<li><a href="#index-TEXBIB_0040r_007b_002c-search-path-for-bib-files_007d-548"><code>TEXBIB</code><span class="roman">, search path for bib files</span></a>: <a href="#bibtex-invocation">bibtex invocation</a></li>
<li><a href="#index-TEXEDIT-210"><code>TEXEDIT</code></a>: <a href="#Editor-invocation">Editor invocation</a></li>
<li><a href="#index-texfonts_002emap-148"><code>texfonts.map</code></a>: <a href="#Path-searching">Path searching</a></li>
-<li><a href="#index-Texinfo-286">Texinfo</a>: <a href="#Formats">Formats</a></li>
+<li><a href="#index-Texinfo-282">Texinfo</a>: <a href="#Formats">Formats</a></li>
<li><a href="#index-texmf_002ecnf-144"><code>texmf.cnf</code></a>: <a href="#Path-searching">Path searching</a></li>
-<li><a href="#index-texmfmp_002ec-452"><code>texmfmp.c</code></a>: <a href="#Online-Metafont-graphics">Online Metafont graphics</a></li>
+<li><a href="#index-texmfmp_002ec-463"><code>texmfmp.c</code></a>: <a href="#Online-Metafont-graphics">Online Metafont graphics</a></li>
<li><a href="#index-texmfmp_002ec-_0040r_007band-_0040code_007bopenoutnameok_007d_007d-246"><code>texmfmp.c </code><span class="roman">and </span><code>openoutnameok</code></a>: <a href="#tex-invocation">tex invocation</a></li>
<li><a href="#index-TEXMFOUTPUT_0040r_007b_002c-used-if-_0040samp_007b_002e_007d-unwritable_007d-155"><code>TEXMFOUTPUT</code><span class="roman">, used if &lsquo;</span><samp><span class="samp">.</span></samp><span class="roman">&rsquo; unwritable</span></a>: <a href="#Output-file-location">Output file location</a></li>
<li><a href="#index-texput-236"><code>texput</code></a>: <a href="#tex-invocation">tex invocation</a></li>
-<li><a href="#index-text_002c-extracting-from-MetaPost-input-568">text, extracting from MetaPost input</a>: <a href="#mpto-invocation">mpto invocation</a></li>
-<li><a href="#index-TFM-files_002c-converting-property-lists-to-809">TFM files, converting property lists to</a>: <a href="#pltotf-invocation">pltotf invocation</a></li>
-<li><a href="#index-TFM-files_002c-explained-703">TFM files, explained</a>: <a href="#Font-file-formats">Font file formats</a></li>
+<li><a href="#index-TFM-files_002c-converting-property-lists-to-764">TFM files, converting property lists to</a>: <a href="#pltotf-invocation">pltotf invocation</a></li>
+<li><a href="#index-TFM-files_002c-explained-658">TFM files, explained</a>: <a href="#Font-file-formats">Font file formats</a></li>
<li><a href="#index-TFM-files_002c-memory-for-79">TFM files, memory for</a>: <a href="#Runtime-options">Runtime options</a></li>
-<li><a href="#index-TFM-files_002c-output-by-Metafont-371">TFM files, output by Metafont</a>: <a href="#mf-invocation">mf invocation</a></li>
-<li><a href="#index-TFM-files_002c-output-by-MetaPost-493">TFM files, output by MetaPost</a>: <a href="#mpost-invocation">mpost invocation</a></li>
-<li><a href="#index-TFM-width-of-characters-779">TFM width of characters</a>: <a href="#gftype-invocation">gftype invocation</a></li>
-<li><a href="#index-TFM-width-of-characters-736">TFM width of characters</a>: <a href="#pktype-invocation">pktype invocation</a></li>
-<li><a href="#index-tftopl-782"><code>tftopl</code></a>: <a href="#tftopl-invocation">tftopl invocation</a></li>
+<li><a href="#index-TFM-files_002c-output-by-Metafont-382">TFM files, output by Metafont</a>: <a href="#mf-invocation">mf invocation</a></li>
+<li><a href="#index-TFM-files_002c-output-by-MetaPost-504">TFM files, output by MetaPost</a>: <a href="#mpost-invocation">mpost invocation</a></li>
+<li><a href="#index-TFM-width-of-characters-734">TFM width of characters</a>: <a href="#gftype-invocation">gftype invocation</a></li>
+<li><a href="#index-TFM-width-of-characters-691">TFM width of characters</a>: <a href="#pktype-invocation">pktype invocation</a></li>
+<li><a href="#index-tftopl-737"><code>tftopl</code></a>: <a href="#tftopl-invocation">tftopl invocation</a></li>
<li><a href="#index-three-programs-157">three programs</a>: <a href="#Three-programs">Three programs</a></li>
<li><a href="#index-time-and-date_002c-in-memory-dumps-203">time and date, in memory dumps</a>: <a href="#Hardware-and-memory-dumps">Hardware and memory dumps</a></li>
-<li><a href="#index-title-font-458">title font</a>: <a href="#gftodvi-invocation">gftodvi invocation</a></li>
-<li><a href="#index-toolkits_002c-X-437">toolkits, X</a>: <a href="#Online-Metafont-graphics">Online Metafont graphics</a></li>
+<li><a href="#index-title-font-469">title font</a>: <a href="#gftodvi-invocation">gftodvi invocation</a></li>
+<li><a href="#index-toolkits_002c-X-448">toolkits, X</a>: <a href="#Online-Metafont-graphics">Online Metafont graphics</a></li>
<li><a href="#index-torture-tests-65">torture tests</a>: <a href="#Triptrap">Triptrap</a></li>
<li><a href="#index-translation-file-for-_0040TeX_007b_007d_002c-specifying-135">translation file for TeX, specifying</a>: <a href="#Common-options">Common options</a></li>
<li><a href="#index-translation-from-WEB-to-C-6">translation from WEB to C</a>: <a href="#Introduction">Introduction</a></li>
<li><a href="#index-trap-_0040r_007bMake-target_007d-59"><code>trap </code><span class="roman">Make target</span></a>: <a href="#Additional-targets">Additional targets</a></li>
<li><a href="#index-trap-test-63">trap test</a>: <a href="#Triptrap">Triptrap</a></li>
<li><a href="#index-trapman_002etex-67"><code>trapman.tex</code></a>: <a href="#Triptrap">Triptrap</a></li>
-<li><a href="#index-trchars_002eadj-561"><code>trchars.adj</code></a>: <a href="#dmp-invocation">dmp invocation</a></li>
<li><a href="#index-Trickey_002c-Howard-14">Trickey, Howard</a>: <a href="#Introduction">Introduction</a></li>
<li><a href="#index-trip-_0040r_007bMake-target_007d-58"><code>trip </code><span class="roman">Make target</span></a>: <a href="#Additional-targets">Additional targets</a></li>
<li><a href="#index-trip-test-62">trip test</a>: <a href="#Triptrap">Triptrap</a></li>
<li><a href="#index-tripman_002etex-66"><code>tripman.tex</code></a>: <a href="#Triptrap">Triptrap</a></li>
<li><a href="#index-triptrap-_0040r_007bMake-target_007d-57"><code>triptrap </code><span class="roman">Make target</span></a>: <a href="#Additional-targets">Additional targets</a></li>
-<li><a href="#index-TROFF-546"><code>TROFF</code></a>: <a href="#makempx-invocation">makempx invocation</a></li>
-<li><a href="#index-Troff_002c-and-MetaPost-498">Troff, and MetaPost</a>: <a href="#mpost-invocation">mpost invocation</a></li>
-<li><a href="#index-Troff_002c-WEB-for-629">Troff, WEB for</a>: <a href="#WEB">WEB</a></li>
+<li><a href="#index-Troff_002c-and-MetaPost-509">Troff, and MetaPost</a>: <a href="#mpost-invocation">mpost invocation</a></li>
+<li><a href="#index-Troff_002c-WEB-for-584">Troff, WEB for</a>: <a href="#WEB">WEB</a></li>
<li><a href="#index-Trojan-horses-and-_0040TeX_007b_007d-programs-243">Trojan horses and TeX programs</a>: <a href="#tex-invocation">tex invocation</a></li>
-<li><a href="#index-TUGboat-bibliography-608">TUGboat bibliography</a>: <a href="#bibtex-invocation">bibtex invocation</a></li>
-<li><a href="#index-Type-1-conversion-843">Type 1 conversion</a>: <a href="#Font-utilities-available-elsewhere">Font utilities available elsewhere</a></li>
-<li><a href="#index-type-design_002c-personal-389">type design, personal</a>: <a href="#Initial-Metafont">Initial Metafont</a></li>
-<li><a href="#index-type-programs_002c-DVI-679">type programs, DVI</a>: <a href="#dvitype-invocation">dvitype invocation</a></li>
-<li><a href="#index-type-programs_002c-GF-760">type programs, GF</a>: <a href="#gftype-invocation">gftype invocation</a></li>
-<li><a href="#index-type-programs_002c-PK-729">type programs, PK</a>: <a href="#pktype-invocation">pktype invocation</a></li>
-<li><a href="#index-type-programs_002c-pool-657">type programs, pool</a>: <a href="#pooltype-invocation">pooltype invocation</a></li>
-<li><a href="#index-typeface-families-355">typeface families</a>: <a href="#Metafont">Metafont</a></li>
-<li><a href="#index-typeface-specimen-sheets-847">typeface specimen sheets</a>: <a href="#Font-utilities-available-elsewhere">Font utilities available elsewhere</a></li>
+<li><a href="#index-TUGboat-bibliography-564">TUGboat bibliography</a>: <a href="#bibtex-invocation">bibtex invocation</a></li>
+<li><a href="#index-Type-1-conversion-798">Type 1 conversion</a>: <a href="#Font-utilities-available-elsewhere">Font utilities available elsewhere</a></li>
+<li><a href="#index-type-design_002c-personal-400">type design, personal</a>: <a href="#Initial-Metafont">Initial Metafont</a></li>
+<li><a href="#index-type-programs_002c-DVI-634">type programs, DVI</a>: <a href="#dvitype-invocation">dvitype invocation</a></li>
+<li><a href="#index-type-programs_002c-GF-715">type programs, GF</a>: <a href="#gftype-invocation">gftype invocation</a></li>
+<li><a href="#index-type-programs_002c-PK-684">type programs, PK</a>: <a href="#pktype-invocation">pktype invocation</a></li>
+<li><a href="#index-type-programs_002c-pool-612">type programs, pool</a>: <a href="#pooltype-invocation">pooltype invocation</a></li>
+<li><a href="#index-typeface-families-366">typeface families</a>: <a href="#Metafont">Metafont</a></li>
+<li><a href="#index-typeface-specimen-sheets-802">typeface specimen sheets</a>: <a href="#Font-utilities-available-elsewhere">Font utilities available elsewhere</a></li>
<li><a href="#index-typesetting-228">typesetting</a>: <a href="#TeX">TeX</a></li>
-<li><a href="#index-Unicode-345">Unicode</a>: <a href="#TeX-extensions">TeX extensions</a></li>
+<li><a href="#index-Unicode-358">Unicode</a>: <a href="#TeX-extensions">TeX extensions</a></li>
<li><a href="#index-Unicode-input-248">Unicode input</a>: <a href="#tex-invocation">tex invocation</a></li>
-<li><a href="#index-uniterm-426"><code>uniterm</code></a>: <a href="#Online-Metafont-graphics">Online Metafont graphics</a></li>
-<li><a href="#index-unsrt_002ebst-619"><code>unsrt.bst</code></a>: <a href="#Basic-BibTeX-style-files">Basic BibTeX style files</a></li>
+<li><a href="#index-uniterm-437"><code>uniterm</code></a>: <a href="#Online-Metafont-graphics">Online Metafont graphics</a></li>
+<li><a href="#index-unsrt_002ebst-575"><code>unsrt.bst</code></a>: <a href="#Basic-BibTeX-style-files">Basic BibTeX style files</a></li>
<li><a href="#index-using-local-codepage-to-display-messages-142">using local codepage to display messages</a>: <a href="#Common-options">Common options</a></li>
<li><a href="#index-UTF_002d8-input-249">UTF-8 input</a>: <a href="#tex-invocation">tex invocation</a></li>
-<li><a href="#index-validation_002c-of-DVI-files-680">validation, of DVI files</a>: <a href="#dvitype-invocation">dvitype invocation</a></li>
-<li><a href="#index-validation_002c-of-GF-files-761">validation, of GF files</a>: <a href="#gftype-invocation">gftype invocation</a></li>
-<li><a href="#index-validation_002c-of-PK-files-730">validation, of PK files</a>: <a href="#pktype-invocation">pktype invocation</a></li>
-<li><a href="#index-validation_002c-of-TFM-files-784">validation, of TFM files</a>: <a href="#tftopl-invocation">tftopl invocation</a></li>
-<li><a href="#index-validation_002c-of-VF-files-813">validation, of VF files</a>: <a href="#vftovp-invocation">vftovp invocation</a></li>
-<li><a href="#index-verbatimtex-_0040r_007bMetaPost-command_007d-572"><code>verbatimtex </code><span class="roman">MetaPost command</span></a>: <a href="#mpto-invocation">mpto invocation</a></li>
-<li><a href="#index-verbose-Bib_0040TeX_007b_007d-output_002c-suppressing-597">verbose BibTeX output, suppressing</a>: <a href="#bibtex-invocation">bibtex invocation</a></li>
+<li><a href="#index-validation_002c-of-DVI-files-635">validation, of DVI files</a>: <a href="#dvitype-invocation">dvitype invocation</a></li>
+<li><a href="#index-validation_002c-of-GF-files-716">validation, of GF files</a>: <a href="#gftype-invocation">gftype invocation</a></li>
+<li><a href="#index-validation_002c-of-PK-files-685">validation, of PK files</a>: <a href="#pktype-invocation">pktype invocation</a></li>
+<li><a href="#index-validation_002c-of-TFM-files-739">validation, of TFM files</a>: <a href="#tftopl-invocation">tftopl invocation</a></li>
+<li><a href="#index-validation_002c-of-VF-files-768">validation, of VF files</a>: <a href="#vftovp-invocation">vftovp invocation</a></li>
+<li><a href="#index-verbose-Bib_0040TeX_007b_007d-output_002c-suppressing-553">verbose BibTeX output, suppressing</a>: <a href="#bibtex-invocation">bibtex invocation</a></li>
<li><a href="#index-verbosity_002c-enabling-99">verbosity, enabling</a>: <a href="#Common-options">Common options</a></li>
<li><a href="#index-version-number_002c-finding-101">version number, finding</a>: <a href="#Common-options">Common options</a></li>
-<li><a href="#index-vertical-escapement-774">vertical escapement</a>: <a href="#gftype-invocation">gftype invocation</a></li>
-<li><a href="#index-VF-files_002c-converting-property-lists-to-820">VF files, converting property lists to</a>: <a href="#vptovf-invocation">vptovf invocation</a></li>
-<li><a href="#index-vftovp-811"><code>vftovp</code></a>: <a href="#vftovp-invocation">vftovp invocation</a></li>
+<li><a href="#index-vertical-escapement-729">vertical escapement</a>: <a href="#gftype-invocation">gftype invocation</a></li>
+<li><a href="#index-VF-files_002c-converting-property-lists-to-775">VF files, converting property lists to</a>: <a href="#vptovf-invocation">vptovf invocation</a></li>
+<li><a href="#index-vftovp-766"><code>vftovp</code></a>: <a href="#vftovp-invocation">vftovp invocation</a></li>
<li><a href="#index-virgin-programs-163">virgin programs</a>: <a href="#Initial-and-virgin">Initial and virgin</a></li>
-<li><a href="#index-virtual-font-creation-851">virtual font creation</a>: <a href="#Font-utilities-available-elsewhere">Font utilities available elsewhere</a></li>
-<li><a href="#index-virtual-fonts_002c-expanding-666">virtual fonts, expanding</a>: <a href="#dvicopy-invocation">dvicopy invocation</a></li>
-<li><a href="#index-virtual_002dfonts_002eknuth-713"><code>virtual-fonts.knuth</code></a>: <a href="#Font-file-formats">Font file formats</a></li>
-<li><a href="#index-virtualfonts_002etxt-714"><code>virtualfonts.txt</code></a>: <a href="#Font-file-formats">Font file formats</a></li>
-<li><a href="#index-vptovf-818"><code>vptovf</code></a>: <a href="#vptovf-invocation">vptovf invocation</a></li>
-<li><a href="#index-weave-647"><code>weave</code></a>: <a href="#weave-invocation">weave invocation</a></li>
-<li><a href="#index-WEB-620">WEB</a>: <a href="#WEB">WEB</a></li>
-<li><a href="#index-WEB-pool-files_002c-displaying-659">WEB pool files, displaying</a>: <a href="#pooltype-invocation">pooltype invocation</a></li>
-<li><a href="#index-WEB-programs_002c-compiling-632">WEB programs, compiling</a>: <a href="#tangle-invocation">tangle invocation</a></li>
-<li><a href="#index-WEB-programs_002c-typesetting-649">WEB programs, typesetting</a>: <a href="#weave-invocation">weave invocation</a></li>
-<li><a href="#index-WEB2C_0040r_007b_002c-search-path-for-TCX-files_007d-315"><code>WEB2C</code><span class="roman">, search path for TCX files</span></a>: <a href="#TCX-files">TCX files</a></li>
+<li><a href="#index-virtual-font-creation-806">virtual font creation</a>: <a href="#Font-utilities-available-elsewhere">Font utilities available elsewhere</a></li>
+<li><a href="#index-virtual-fonts_002c-expanding-621">virtual fonts, expanding</a>: <a href="#dvicopy-invocation">dvicopy invocation</a></li>
+<li><a href="#index-virtual_002dfonts_002eknuth-668"><code>virtual-fonts.knuth</code></a>: <a href="#Font-file-formats">Font file formats</a></li>
+<li><a href="#index-virtualfonts_002etxt-669"><code>virtualfonts.txt</code></a>: <a href="#Font-file-formats">Font file formats</a></li>
+<li><a href="#index-vptovf-773"><code>vptovf</code></a>: <a href="#vptovf-invocation">vptovf invocation</a></li>
+<li><a href="#index-weave-602"><code>weave</code></a>: <a href="#weave-invocation">weave invocation</a></li>
+<li><a href="#index-WEB-576">WEB</a>: <a href="#WEB">WEB</a></li>
+<li><a href="#index-web-environments_002c-and-security-349">web environments, and security</a>: <a href="#Shell-escapes">Shell escapes</a></li>
+<li><a href="#index-WEB-pool-files_002c-displaying-614">WEB pool files, displaying</a>: <a href="#pooltype-invocation">pooltype invocation</a></li>
+<li><a href="#index-WEB-programs_002c-compiling-587">WEB programs, compiling</a>: <a href="#tangle-invocation">tangle invocation</a></li>
+<li><a href="#index-WEB-programs_002c-typesetting-604">WEB programs, typesetting</a>: <a href="#weave-invocation">weave invocation</a></li>
+<li><a href="#index-WEB2C_0040r_007b_002c-search-path-for-TCX-files_007d-311"><code>WEB2C</code><span class="roman">, search path for TCX files</span></a>: <a href="#TCX-files">TCX files</a></li>
<li><a href="#index-Weber_002c-Olaf-18">Weber, Olaf</a>: <a href="#Introduction">Introduction</a></li>
-<li><a href="#index-webmac_002etex-655"><code>webmac.tex</code></a>: <a href="#weave-invocation">weave invocation</a></li>
-<li><a href="#index-webman_002etex-623"><code>webman.tex</code></a>: <a href="#WEB">WEB</a></li>
-<li><a href="#index-whitespace_002c-in-TCX-files-323">whitespace, in TCX files</a>: <a href="#TCX-files">TCX files</a></li>
+<li><a href="#index-webmac_002etex-610"><code>webmac.tex</code></a>: <a href="#weave-invocation">weave invocation</a></li>
+<li><a href="#index-webman_002etex-578"><code>webman.tex</code></a>: <a href="#WEB">WEB</a></li>
+<li><a href="#index-whitespace_002c-in-TCX-files-319">whitespace, in TCX files</a>: <a href="#TCX-files">TCX files</a></li>
<li><a href="#index-whitespace_002dterminated-filenames-218">whitespace-terminated filenames</a>: <a href="#g_t_005cinput-filenames">\input filenames</a></li>
-<li><a href="#index-width_002c-device_002dindependent-781">width, device-independent</a>: <a href="#gftype-invocation">gftype invocation</a></li>
-<li><a href="#index-width_002c-device_002dindependent-738">width, device-independent</a>: <a href="#pktype-invocation">pktype invocation</a></li>
-<li><a href="#index-width_002c-in-pixels-746">width, in pixels</a>: <a href="#pktype-invocation">pktype invocation</a></li>
+<li><a href="#index-width_002c-device_002dindependent-736">width, device-independent</a>: <a href="#gftype-invocation">gftype invocation</a></li>
+<li><a href="#index-width_002c-device_002dindependent-693">width, device-independent</a>: <a href="#pktype-invocation">pktype invocation</a></li>
+<li><a href="#index-width_002c-in-pixels-701">width, in pixels</a>: <a href="#pktype-invocation">pktype invocation</a></li>
<li><a href="#index-word-processor_002c-not-231">word processor, not</a>: <a href="#TeX">TeX</a></li>
<li><a href="#index-writing-memory-dumps-173">writing memory dumps</a>: <a href="#Creating-memory-dumps">Creating memory dumps</a></li>
-<li><a href="#index-X-bitmap-fonts-826">X bitmap fonts</a>: <a href="#Font-utilities-available-elsewhere">Font utilities available elsewhere</a></li>
-<li><a href="#index-X-class-name-for-Metafont-442">X class name for Metafont</a>: <a href="#Online-Metafont-graphics">Online Metafont graphics</a></li>
-<li><a href="#index-x-offset-747">x offset</a>: <a href="#pktype-invocation">pktype invocation</a></li>
-<li><a href="#index-X-resources-441">X resources</a>: <a href="#Online-Metafont-graphics">Online Metafont graphics</a></li>
-<li><a href="#index-X-toolkits-and-Metafont-438">X toolkits and Metafont</a>: <a href="#Online-Metafont-graphics">Online Metafont graphics</a></li>
-<li><a href="#index-x-X-_0040r_007bditroff-device-control_007d-556"><code>x X </code><span class="roman">ditroff device control</span></a>: <a href="#dmp-invocation">dmp invocation</a></li>
-<li><a href="#index-xampl_002ebib-605"><code>xampl.bib</code></a>: <a href="#bibtex-invocation">bibtex invocation</a></li>
-<li><a href="#index-xbfe_0040r_007b_002c-bitmap-font-editor_007d-831"><code>xbfe</code><span class="roman">, bitmap font editor</span></a>: <a href="#Font-utilities-available-elsewhere">Font utilities available elsewhere</a></li>
-<li><a href="#index-xfed_0040r_007b_002c-bitmap-font-editor_007d-832"><code>xfed</code><span class="roman">, bitmap font editor</span></a>: <a href="#Font-utilities-available-elsewhere">Font utilities available elsewhere</a></li>
-<li><a href="#index-xfedor_0040r_007b_002c-bitmap-font-editor_007d-833"><code>xfedor</code><span class="roman">, bitmap font editor</span></a>: <a href="#Font-utilities-available-elsewhere">Font utilities available elsewhere</a></li>
-<li><a href="#index-Xlib-431"><code>Xlib</code></a>: <a href="#Online-Metafont-graphics">Online Metafont graphics</a></li>
-<li><a href="#index-Xlib-support-440">Xlib support</a>: <a href="#Online-Metafont-graphics">Online Metafont graphics</a></li>
-<li><a href="#index-Xt-430"><code>Xt</code></a>: <a href="#Online-Metafont-graphics">Online Metafont graphics</a></li>
-<li><a href="#index-Xt-support-439">Xt support</a>: <a href="#Online-Metafont-graphics">Online Metafont graphics</a></li>
-<li><a href="#index-xterm-432"><code>xterm</code></a>: <a href="#Online-Metafont-graphics">Online Metafont graphics</a></li>
-<li><a href="#index-y-offset-748">y offset</a>: <a href="#pktype-invocation">pktype invocation</a></li>
+<li><a href="#index-X-bitmap-fonts-781">X bitmap fonts</a>: <a href="#Font-utilities-available-elsewhere">Font utilities available elsewhere</a></li>
+<li><a href="#index-X-class-name-for-Metafont-453">X class name for Metafont</a>: <a href="#Online-Metafont-graphics">Online Metafont graphics</a></li>
+<li><a href="#index-x-offset-702">x offset</a>: <a href="#pktype-invocation">pktype invocation</a></li>
+<li><a href="#index-X-resources-452">X resources</a>: <a href="#Online-Metafont-graphics">Online Metafont graphics</a></li>
+<li><a href="#index-X-toolkits-and-Metafont-449">X toolkits and Metafont</a>: <a href="#Online-Metafont-graphics">Online Metafont graphics</a></li>
+<li><a href="#index-xampl_002ebib-561"><code>xampl.bib</code></a>: <a href="#bibtex-invocation">bibtex invocation</a></li>
+<li><a href="#index-xbfe_0040r_007b_002c-bitmap-font-editor_007d-786"><code>xbfe</code><span class="roman">, bitmap font editor</span></a>: <a href="#Font-utilities-available-elsewhere">Font utilities available elsewhere</a></li>
+<li><a href="#index-xfed_0040r_007b_002c-bitmap-font-editor_007d-787"><code>xfed</code><span class="roman">, bitmap font editor</span></a>: <a href="#Font-utilities-available-elsewhere">Font utilities available elsewhere</a></li>
+<li><a href="#index-xfedor_0040r_007b_002c-bitmap-font-editor_007d-788"><code>xfedor</code><span class="roman">, bitmap font editor</span></a>: <a href="#Font-utilities-available-elsewhere">Font utilities available elsewhere</a></li>
+<li><a href="#index-Xlib-442"><code>Xlib</code></a>: <a href="#Online-Metafont-graphics">Online Metafont graphics</a></li>
+<li><a href="#index-Xlib-support-451">Xlib support</a>: <a href="#Online-Metafont-graphics">Online Metafont graphics</a></li>
+<li><a href="#index-Xt-441"><code>Xt</code></a>: <a href="#Online-Metafont-graphics">Online Metafont graphics</a></li>
+<li><a href="#index-Xt-support-450">Xt support</a>: <a href="#Online-Metafont-graphics">Online Metafont graphics</a></li>
+<li><a href="#index-xterm-443"><code>xterm</code></a>: <a href="#Online-Metafont-graphics">Online Metafont graphics</a></li>
+<li><a href="#index-y-offset-703">y offset</a>: <a href="#pktype-invocation">pktype invocation</a></li>
<li><a href="#index-g_t_007e-_0040r_007bexpansion-in-filenames_007d-224"><code>~ </code><span class="roman">expansion in filenames</span></a>: <a href="#g_t_005cinput-filenames">\input filenames</a></li>
</ul></body></html>
diff --git a/Master/texmf/doc/web2c/web2c.pdf b/Master/texmf/doc/web2c/web2c.pdf
index c41ceab2af1..8c309fef591 100644
--- a/Master/texmf/doc/web2c/web2c.pdf
+++ b/Master/texmf/doc/web2c/web2c.pdf
Binary files differ
diff --git a/Master/tlpkg/bin/tl-update-txi b/Master/tlpkg/bin/tl-update-txi
index ff05d7d5aeb..33d18fe8748 100755
--- a/Master/tlpkg/bin/tl-update-txi
+++ b/Master/tlpkg/bin/tl-update-txi
@@ -6,6 +6,8 @@
# install info/html/pdf. Don't delete info files since they are in the
# dist's. Unfortunately no easy way to do the same for pdf.
+: ${CTAN=/home/ftp/tex-archive}
+
texihtml="makeinfo --html --no-split"
texipdf="texi2pdf --quiet --clean"
@@ -22,7 +24,7 @@ xu=$Build/source/utils
#
do_dvipng() {
mypkg=dvipng
- cd $xk/$mypkg || exit 1
+ cd $xk/$mypkg/doc || exit 1
MV=cp mvcp-if-change $mypkg.info $infodir/
$texihtml $mypkg.texi && mvcp-if-change $mypkg.html $docdir/$mypkg/
$texipdf $mypkg.texi && mv -v $mypkg.pdf $docdir/$mypkg/
@@ -47,15 +49,23 @@ do_dvips() {
#
do_epspdf() {
mypkg=epspdf
- cd $Master/texmf-dist/doc/support/$mypkg || exit 1
- makeinfo --no-split $mypkg.info
- mvcp-if-change $mypkg.info $infodir/
+ cd $Master/texmf-dist/doc/support/$mypkg
+ #makeinfo --no-split $mypkg.info
+ #mvcp-if-change $mypkg.info $infodir/
+ #done as part of package update?
+}
+
+#
+do_fontname() {
+ mypkg=fontname
+ cd $CTAN/info/fontname
+ MV=cp mvcp-if-change $mypkg.info $infodir/
}
#
do_kpathsea() {
mypkg=kpathsea
- cd $xk/$mypkg || exit 1
+ cd $xk/$mypkg/doc || exit 1
MV=cp mvcp-if-change $mypkg.info $infodir/
$texihtml $mypkg.texi && mvcp-if-change $mypkg.html $docdir/$mypkg/
$texipdf $mypkg.texi && mv -v $mypkg.pdf $docdir/$mypkg/
@@ -73,6 +83,7 @@ do_web2c() {
do_dvipng
do_dvips
do_epspdf
+do_fontname
do_kpathsea
do_web2c