summaryrefslogtreecommitdiff
path: root/Master
diff options
context:
space:
mode:
authorKarl Berry <karl@freefriends.org>2010-06-17 00:16:42 +0000
committerKarl Berry <karl@freefriends.org>2010-06-17 00:16:42 +0000
commit55133e0c2bb3ef821339a09c48fbcf3f0d2dde27 (patch)
tree2c1fd130535207fb2157e62516527b5d9171cf5b /Master
parent83f44dc7cbbf424407a091b932e3d8344911dbb5 (diff)
texinfo manual updates
git-svn-id: svn://tug.org/texlive/trunk@19010 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master')
-rw-r--r--Master/texmf/doc/dvipng/dvipng.html86
-rw-r--r--Master/texmf/doc/dvipng/dvipng.pdfbin256860 -> 224620 bytes
-rw-r--r--Master/texmf/doc/dvips/dvips.html1662
-rw-r--r--Master/texmf/doc/dvips/dvips.pdfbin408821 -> 409350 bytes
-rw-r--r--Master/texmf/doc/info/dvipng.info144
-rw-r--r--Master/texmf/doc/info/dvips.info385
-rw-r--r--Master/texmf/doc/info/fontname.info49
-rw-r--r--Master/texmf/doc/info/kpathsea.info588
-rw-r--r--Master/texmf/doc/info/web2c.info339
-rw-r--r--Master/texmf/doc/kpathsea/kpathsea.html1951
-rw-r--r--Master/texmf/doc/kpathsea/kpathsea.pdfbin657266 -> 445618 bytes
-rw-r--r--Master/texmf/doc/web2c/web2c.html1553
-rw-r--r--Master/texmf/doc/web2c/web2c.pdfbin667676 -> 462629 bytes
13 files changed, 3312 insertions, 3445 deletions
diff --git a/Master/texmf/doc/dvipng/dvipng.html b/Master/texmf/doc/dvipng/dvipng.html
index b2de8e77039..692fffa865a 100644
--- a/Master/texmf/doc/dvipng/dvipng.html
+++ b/Master/texmf/doc/dvipng/dvipng.html
@@ -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.12
+ <p>This file documents dvipng version 1.13
<p>Corrections or perhaps rewrites of sections are <em>very welcome</em>.
@@ -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.12 Copyright 2002-2008 Jan-Ake Larsson
+<pre class="example"> This is ./dvipng 1.13 Copyright 2002-2010 Jan-Ake Larsson
Usage: ./dvipng [OPTION]... FILENAME[.dvi]
Options are chosen to be similar to dvips' options where possible:
@@ -757,14 +757,17 @@ DVI, e.g., via a PostScript special (i.e., the &lsquo;<samp><span class="samp">g
<br><dt>&lsquo;<samp><span class="samp">-v*</span></samp>&rsquo;<dd>Enable verbose operation. This will currently indicate what fonts is
used, in addition to the usual output.
- <br><dt>&lsquo;<samp><span class="samp">-x </span><var>num</var></samp>&rsquo;<dd><a name="index-magnification_002c-overriding-DVI-60"></a>Set the x magnification ratio to <var>num</var>/1000. Overrides
+ <br><dt>&lsquo;<samp><span class="samp">--width*</span></samp>&rsquo;<dd><a name="index-width-reporting-60"></a>Report the width of the image. See also &lsquo;<samp><span class="samp">--height</span></samp>&rsquo; and
+&lsquo;<samp><span class="samp">--depth</span></samp>&rsquo;.
+
+ <br><dt>&lsquo;<samp><span class="samp">-x </span><var>num</var></samp>&rsquo;<dd><a name="index-magnification_002c-overriding-DVI-61"></a>Set the x magnification ratio to <var>num</var>/1000. Overrides
the magnification specified in the DVI file. Must be between 10 and
100000. It is recommended that you use standard magstep values (1095,
1200, 1440, 1728, 2074, 2488, 2986, and so on) to help reduce the total
number of PK files generated. <var>num</var> may be a real number, not an
integer, for increased precision.
- <br><dt>&lsquo;<samp><span class="samp">-z </span><var>num</var></samp>&rsquo;<dd><a name="index-compression-61"></a>Set the PNG compression level to <var>num</var>. This option is enabled if
+ <br><dt>&lsquo;<samp><span class="samp">-z </span><var>num</var></samp>&rsquo;<dd><a name="index-compression-62"></a>Set the PNG compression level to <var>num</var>. This option is enabled if
your &lsquo;<samp><span class="samp">libgd</span></samp>&rsquo; is new enough. The default compression level is 1,
which selects maximum speed at the price of slightly larger PNGs. For an
older &lsquo;<samp><span class="samp">libgd</span></samp>&rsquo;, the hard-soldered value 5 is used. The include file
@@ -828,7 +831,7 @@ use the &lsquo;<samp><span class="samp">png16m</span></samp>&rsquo; device to pr
inclusion. Other relevant switches are &lsquo;<samp><span class="samp">--noghostscript</span></samp>&rsquo; and
&lsquo;<samp><span class="samp">--nogssafer</span></samp>&rsquo;. See <a href="#Option-details">Option details</a>.
- <p><a name="index-PostScript-inclusion-problems-62"></a>The most common problem with including graphics is an incorrect
+ <p><a name="index-PostScript-inclusion-problems-63"></a>The most common problem with including graphics is an incorrect
bounding box. Complain to whoever wrote the software that generated
the file if the bounding box is indeed incorrect. An adjusted
boundingbox can be specified in the &lsquo;<samp><span class="samp">\includegraphics</span></samp>&rsquo; call, as
@@ -900,7 +903,7 @@ Up:&nbsp;<a rel="up" accesskey="u" href="#Color">Color</a>
<h3 class="section">6.1 Color specifications</h3>
-<p><a name="index-color-specifications-63"></a>
+<p><a name="index-color-specifications-64"></a>
The color specification supported by dvipng is by-value or by-name. The
by-value spec starts with the name of a color model (one of &lsquo;<samp><span class="samp">rgb</span></samp>&rsquo;,
&lsquo;<samp><span class="samp">hsb</span></samp>&rsquo;, &lsquo;<samp><span class="samp">cmy</span></samp>&rsquo;, &lsquo;<samp><span class="samp">cmyk</span></samp>&rsquo;, or &lsquo;<samp><span class="samp">gray</span></samp>&rsquo;) followed by the
@@ -968,7 +971,7 @@ Up:&nbsp;<a rel="up" accesskey="u" href="#Top">Top</a>
<h2 class="chapter">7 Diagnosing problems</h2>
-<p><a name="index-problems-64"></a><a name="index-trouble-65"></a><a name="index-debugging-66"></a>
+<p><a name="index-problems-65"></a><a name="index-trouble-66"></a><a name="index-debugging-67"></a>
You've gone through all the trouble of installing dvipng, carefully read
all the instructions in this manual, and still can't get something to
work. The following sections provide some helpful hints if you find
@@ -1062,14 +1065,50 @@ bugs and suggesting improvements as the thing has evolved. These
include but is perhaps not limited to (in semi-random order): Thomas
Esser (teTeX), Christian Schenk (MIKTeX), Brian R Furry (debian
package), Angus Leeming (LyX), Thomas Boutell (libgd), John Jones
-(first user report), Uwe Kern (xcolor), Karl Berry (TeX Live),
-David Harvey (hinting in Freetype), Neal Harmon, Alan Shutko, Reiner
-Stieb, Nick Alcock, Adam Buchbinder, Svend Tollak Munkejord, James
-Longstreet, Bernhard Simon, Bob McElrath, Georg Schwarz, Jason Farmer,
-Brian V. Smith, Samuel Hathaway, Thomas R. Shemanske, Stephen Gibson,
-Christian Ridderstr&ouml;m, Ezra Peisach, William H Wheeler, Thomas
-Klausner, Harald Koenig, Adrian Bunk, Kevin Smith, Jason Riedy,
-Wolfram Krause, Reinhard Kotucha, and Takeshi Abe.
+(first user report), Uwe Kern (xcolor), Karl Berry and Peter
+Breitenlohner (TeX Live), David Harvey (hinting in Freetype), Neal
+Harmon, Alan Shutko, Reiner Stieb, Nick Alcock, Adam Buchbinder, Svend
+Tollak Munkejord, James Longstreet, Bernhard Simon, Bob McElrath,
+Georg Schwarz, Jason Farmer, Brian V. Smith, Samuel Hathaway, Thomas
+R. Shemanske, Stephen Gibson, Christian Ridderstr&ouml;m, Ezra Peisach,
+William H Wheeler, Thomas Klausner, Harald Koenig, Adrian Bunk, Kevin
+Smith, Jason Riedy, Wolfram Krause, Reinhard Kotucha, Takeshi Abe, and
+Waldeck Schutzer.
+
+ <p>Use of the <code>gd</code> library requires inclusion of the following
+copyright notice, which applies to the <code>gd</code> library:
+
+ <blockquote>
+Portions copyright 1994, 1995, 1996, 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004 by Cold Spring Harbor Laboratory. Funded under Grant P41-RR02188 by the National Institutes of Health.
+
+ <p>Portions copyright 1996, 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004 by Boutell.Com, Inc.
+
+ <p>Portions relating to GD2 format copyright 1999, 2000, 2001, 2002, 2003, 2004 Philip Warner.
+
+ <p>Portions relating to PNG copyright 1999, 2000, 2001, 2002, 2003, 2004 Greg Roelofs.
+
+ <p>Portions relating to gdttf.c copyright 1999, 2000, 2001, 2002, 2003, 2004 John Ellson (ellson@graphviz.org).
+
+ <p>Portions relating to gdft.c copyright 2001, 2002, 2003, 2004 John Ellson (ellson@graphviz.org).
+
+ <p>Portions relating to JPEG and to color quantization copyright 2000, 2001, 2002, 2003, 2004, Doug Becker and copyright (C) 1994, 1995, 1996, 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004 Thomas G. Lane. This software is based in part on the work of the Independent JPEG Group. See the file README-JPEG.TXT for more information.
+
+ <p>Portions relating to GIF compression copyright 1989 by Jef Poskanzer and David Rowley, with modifications for thread safety by Thomas Boutell.
+
+ <p>Portions relating to GIF decompression copyright 1990, 1991, 1993 by David Koblas, with modifications for thread safety by Thomas Boutell.
+
+ <p>Portions relating to WBMP copyright 2000, 2001, 2002, 2003, 2004 Maurice Szmurlo and Johan Van den Brande.
+
+ <p>Portions relating to GIF animations copyright 2004 Jaakko Hyv&auml;dtti (jaakko.hyvatti@iki.fi)
+
+ <p>Permission has been granted to copy, distribute and modify gd in any context without fee, including a commercial application, provided that this notice is present in user-accessible supporting documentation.
+
+ <p>This does not affect your ownership of the derived work itself, and the intent is to assure proper credit for the authors of gd, not to interfere with your productive use of gd. If you have questions, ask. "Derived works" includes all programs that utilize the library. Credit must be given in user-accessible documentation.
+
+ <p>This software is provided "AS IS." The copyright holders disclaim all warranties, either express or implied, including but not limited to implied warranties of merchantability and fitness for a particular purpose, with respect to this code and accompanying documentation.
+
+ <p>Although their code does not appear in the current release, the authors also wish to thank Hutchison Avenue Software Corporation for their prior contributions.
+</blockquote>
<div class="node">
<a name="Copying"></a>
@@ -1100,7 +1139,7 @@ License along with this program. If not, see
</pre>
-Copyright &copy; 2002-2008 Jan-&Aring;ke Larsson
+Copyright &copy; 2002-2010 Jan-&Aring;ke Larsson
<div class="node">
<a name="Index"></a>
@@ -1120,13 +1159,13 @@ Up:&nbsp;<a rel="up" accesskey="u" href="#Top">Top</a>
<li><a href="#index-background-color-_0028option_0029-14">background color (option)</a>: <a href="#Option-details">Option details</a></li>
<li><a href="#index-base-resolution_002c-setting-13">base resolution, setting</a>: <a href="#Option-details">Option details</a></li>
<li><a href="#index-baseline-reporting-17">baseline reporting</a>: <a href="#Option-details">Option details</a></li>
-<li><a href="#index-color-specifications-63">color specifications</a>: <a href="#Color-specifications">Color specifications</a></li>
+<li><a href="#index-color-specifications-64">color specifications</a>: <a href="#Color-specifications">Color specifications</a></li>
<li><a href="#index-command_002dline-options-5">command-line options</a>: <a href="#Command_002dline-options">Command-line options</a></li>
<li><a href="#index-compilation-2">compilation</a>: <a href="#Installation">Installation</a></li>
-<li><a href="#index-compression-61">compression</a>: <a href="#Option-details">Option details</a></li>
+<li><a href="#index-compression-62">compression</a>: <a href="#Option-details">Option details</a></li>
<li><a href="#index-configuration_002c-of-dvipng-1">configuration, of dvipng</a>: <a href="#Installation">Installation</a></li>
<li><a href="#index-dark-fonts-23">dark fonts</a>: <a href="#Option-details">Option details</a></li>
-<li><a href="#index-debugging-66">debugging</a>: <a href="#Diagnosing-problems">Diagnosing problems</a></li>
+<li><a href="#index-debugging-67">debugging</a>: <a href="#Diagnosing-problems">Diagnosing problems</a></li>
<li><a href="#index-debugging-15">debugging</a>: <a href="#Option-details">Option details</a></li>
<li><a href="#index-depth-reporting-18">depth reporting</a>: <a href="#Option-details">Option details</a></li>
<li><a href="#index-exit-on-erroneous-images-57">exit on erroneous images</a>: <a href="#Option-details">Option details</a></li>
@@ -1146,7 +1185,7 @@ Up:&nbsp;<a rel="up" accesskey="u" href="#Top">Top</a>
<li><a href="#index-invoking-dvipng-4">invoking dvipng</a>: <a href="#Basic-usage">Basic usage</a></li>
<li><a href="#index-last-page-printed-29">last page printed</a>: <a href="#Option-details">Option details</a></li>
<li><a href="#index-light-fonts-24">light fonts</a>: <a href="#Option-details">Option details</a></li>
-<li><a href="#index-magnification_002c-overriding-DVI-60">magnification, overriding DVI</a>: <a href="#Option-details">Option details</a></li>
+<li><a href="#index-magnification_002c-overriding-DVI-61">magnification, overriding DVI</a>: <a href="#Option-details">Option details</a></li>
<li><a href="#index-Metafont-mode_002c-specifying-34">Metafont mode, specifying</a>: <a href="#Option-details">Option details</a></li>
<li><a href="#index-mktexpk_0040r_007b_002c-avoiding_007d-36"><code>mktexpk</code><span class="roman">, avoiding</span></a>: <a href="#Option-details">Option details</a></li>
<li><a href="#index-mode-name_002c-specifying-33">mode name, specifying</a>: <a href="#Option-details">Option details</a></li>
@@ -1164,8 +1203,8 @@ Up:&nbsp;<a rel="up" accesskey="u" href="#Top">Top</a>
<li><a href="#index-physical-page-number_002c-and-_0040samp_007b_002dl_007d-31">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-45">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-PNG-image-format-49">PNG image format</a>: <a href="#Option-details">Option details</a></li>
-<li><a href="#index-PostScript-inclusion-problems-62">PostScript inclusion problems</a>: <a href="#Encapsulated-PostScript">Encapsulated PostScript</a></li>
-<li><a href="#index-problems-64">problems</a>: <a href="#Diagnosing-problems">Diagnosing problems</a></li>
+<li><a href="#index-PostScript-inclusion-problems-63">PostScript inclusion problems</a>: <a href="#Encapsulated-PostScript">Encapsulated PostScript</a></li>
+<li><a href="#index-problems-65">problems</a>: <a href="#Diagnosing-problems">Diagnosing problems</a></li>
<li><a href="#index-quality-55">quality</a>: <a href="#Option-details">Option details</a></li>
<li><a href="#index-quiet-operation-51">quiet operation</a>: <a href="#Option-details">Option details</a></li>
<li><a href="#index-reverse-pagination-56">reverse pagination</a>: <a href="#Option-details">Option details</a></li>
@@ -1175,8 +1214,9 @@ Up:&nbsp;<a rel="up" accesskey="u" href="#Top">Top</a>
<li><a href="#index-T1lib-font-rendering-58">T1lib font rendering</a>: <a href="#Option-details">Option details</a></li>
<li><a href="#index-transparent-border-fallback-color-12">transparent border fallback color</a>: <a href="#Option-details">Option details</a></li>
<li><a href="#index-transparent-border-width-11">transparent border width</a>: <a href="#Option-details">Option details</a></li>
-<li><a href="#index-trouble-65">trouble</a>: <a href="#Diagnosing-problems">Diagnosing problems</a></li>
+<li><a href="#index-trouble-66">trouble</a>: <a href="#Diagnosing-problems">Diagnosing problems</a></li>
<li><a href="#index-truecolor-output-59">truecolor output</a>: <a href="#Option-details">Option details</a></li>
<li><a href="#index-warnings_002c-suppressing-53">warnings, suppressing</a>: <a href="#Option-details">Option details</a></li>
+<li><a href="#index-width-reporting-60">width reporting</a>: <a href="#Option-details">Option details</a></li>
</ul></body></html>
diff --git a/Master/texmf/doc/dvipng/dvipng.pdf b/Master/texmf/doc/dvipng/dvipng.pdf
index e92a19ce5be..0db65ef0fa6 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 22c3022a8ea..d970a1c15d5 100644
--- a/Master/texmf/doc/dvips/dvips.html
+++ b/Master/texmf/doc/dvips/dvips.html
@@ -7,8 +7,8 @@
<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.98
-(September 2009), a program to translate a DVI file into
+This manual documents Dvips version 5.99
+(July 2010), 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"><!--
@@ -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.98
-(September 2009), a program to translate a DVI file into
+<p>This manual documents Dvips version 5.99
+(July 2010), a program to translate a DVI file into
PostScript. You may freely use, modify and/or distribute this file.
<ul class="menu">
@@ -274,12 +274,13 @@ Up:&nbsp;<a rel="up" accesskey="u" href="#Top">Top</a>
<h2 class="chapter">2 Installation</h2>
<p><a name="index-configuration_002c-of-Dvips-2"></a><a name="index-compilation-3"></a><a name="index-installation_002c-of-Dvips-4"></a>
-(A copy of this chapter is in the distribution file <samp><span class="file">dvipsk/INSTALL</span></samp>.)
+<!-- ifset version -->
+<!-- (A copy of this chapter is in the distribution file @file{dvipsk/INSTALL}.) -->
+<!-- end ifset -->
<p>Installing Dvips is mostly the same as installing any Kpathsea-using
program. Therefore, for the basic steps involved,
-see <a href="kpathsea.html#Installation">Installation</a>. (A copy is in the file
-<samp><span class="file">kpathsea/INSTALL</span></samp>.)
+see <a href="kpathsea.html#Installation">Installation</a>.
<p>For solutions to common installation problems and information on how to
report a bug, see the file <samp><span class="file">kpathsea/BUGS</span></samp> (see <a href="kpathsea.html#Bugs">Bugs</a>). For solutions to Dvips-specific problems,
@@ -349,7 +350,7 @@ for your reading pleasure:
% Partially download Type 1 fonts by default. Only reason not to do
% this is if you encounter bugs. (Please report them to
- % <a href="mailto:tex-k@mail.tug.org">tex-k@mail.tug.org</a> if you do.)
+ % <a href="mailto:tex-k@tug.org">tex-k@tug.org</a> if you do.)
j
% Also look for fonts at these resolutions.
@@ -520,22 +521,19 @@ Up:&nbsp;<a rel="up" accesskey="u" href="#Diagnosing-problems">Diagnosing proble
<h4 class="subsection">2.4.1 Debug options</h4>
<p><a name="index-debugging-options-49"></a><a name="index-options_002c-debugging-50"></a>
-The &lsquo;<samp><span class="samp">-d</span></samp>&rsquo; flag to Dvips helps in tracking down certain errors. The
-parameter to this flag is an integer that tells what errors are
+The &lsquo;<samp><span class="samp">-d</span></samp>&rsquo; flag to Dvips helps in tracking down certain errors.
+The parameter to this flag is an integer that tells what errors are
currently being tracked. To track a certain class of debug messages,
-simply provide the appropriate number given below; if you wish to track
-multiple classes, sum the numbers of the classes you wish to track. To
-track all classes, you can use <code>-1</code>. Another useful value is
-<code>3650</code>, which tracks everything having to do with file searching
-and opening.
+specify the appropriate number given below; if you wish to track
+multiple classes, sum the numbers of the classes you wish to track.
+To track all classes, you can use <code>-1</code>.
- <p>You can also set the environment variable <samp><span class="env">KPATHSEA_DEBUG</span></samp> to any
-of these values.
-
- <p>Some of these debugging options are actually provided by Kpathsea
-(see <a href="kpathsea.html#Debugging">Debugging</a>).
+ <p>You can also set the environment variable <samp><span class="env">KPATHSEA_DEBUG</span></samp> instead
+of using &lsquo;<samp><span class="samp">-d</span></samp>&rsquo;. Some of these debugging options are actually
+provided by Kpathsea (see <a href="kpathsea.html#Debugging">Debugging</a>).
<p>The classes are:
+
<dl>
<dt>1<dd>specials
<br><dt>2<dd>paths
@@ -544,13 +542,12 @@ of these values.
<br><dt>16<dd>headers
<br><dt>32<dd>font compression
<br><dt>64<dd>files
-<br><dt>128<dd>config files
-<br><dt>256<dd>Partial Type 1 font encoding vectors
-<br><dt>512<dd>Partial Type 1 subr calls
-<br><dt>1024<dd>Kpathsea <code>stat</code> calls
-<br><dt>2048<dd>Kpathsea hash table lookups
-<br><dt>4096<dd>Kpathsea path element expansion
-<br><dt>8192<dd>Kpathsea path searches
+<br><dt>128<dd>(omitted)
+<br><dt>256<dd>config files
+<br><dt>512<dd>Kpathsea <code>stat</code> calls
+<br><dt>1024<dd>Kpathsea hash table lookups
+<br><dt>2048<dd>Kpathsea path element expansion
+<br><dt>4096<dd>Kpathsea path searches
</dl>
<div class="node">
@@ -799,7 +796,8 @@ Options:
-m* Manual feed -M* Don't make fonts
-mode s Metafont device name
-n # Maximum number of pages -N* No structured comments
--noomega Disable Omega extensions
+-noomega Disable Omega and pTeX extensions
+-noptex Disable pTeX extensions
-o f Output file -O c Set/change paper offset
-p # First page -P s Load config.$s
-pp l Print only pages listed
@@ -1001,23 +999,33 @@ TranScript in particular cannot handle modern Encapsulated PostScript.
Beware: This also disables page movement, etc., in PostScript viewers
such as Ghostview.
- <br><dt>&lsquo;<samp><span class="samp">-noomega</span></samp>&rsquo;<dd><a name="index-g_t_002dnoomega-169"></a><a name="index-Omega-extensions-170"></a>This will disable the use of Omega extensions when interpreting DVI files.
-By default, the additional opcodes &lsquo;<samp><span class="samp">129</span></samp>&rsquo; and &lsquo;<samp><span class="samp">134</span></samp>&rsquo; are recognized
-by Dvips as Omega extensions and interpreted as requests to set 2-byte
-characters. The only drawback is that the virtual font array will (at least
-temporarily) require 65536 positions instead of the default 256 positions,
-i.e., the memory requirements of Dvips will be slightly larger. If you find
-this unacceptable or encounter another problem with the Omega extensions,
-you can switch this extension off by using &lsquo;<samp><span class="samp">-noomega</span></samp>&rsquo; (but please do
-send a bug report if you find such problems, see <a href="kpathsea.html#Bugs">Bugs</a>).
-
- <br><dt>&lsquo;<samp><span class="samp">-o </span><var>name</var></samp>&rsquo;<dd><a name="index-g_t_002do-_0040var_007bname_007d-171"></a><a name="index-output_002c-redirecting-172"></a><a name="index-standard-output_002c-output-to-173"></a>Send output to the file <var>name</var>. If &lsquo;<samp><span class="samp">-o</span></samp>&rsquo; is specified without
+ <br><dt>&lsquo;<samp><span class="samp">-noomega</span></samp>&rsquo;<dd><a name="index-g_t_002dnoomega-169"></a><a name="index-Omega-extensions-170"></a><a name="index-p_0040TeX_007b_007d-extensions-171"></a>Disable the use of Omega and pTeX extensions when interpreting DVI
+files. By default, the additional opcodes &lsquo;<samp><span class="samp">129</span></samp>&rsquo; and &lsquo;<samp><span class="samp">134</span></samp>&rsquo;
+are recognized by Dvips as Omega extensions and interpreted as
+requests to set 2-byte characters.
+
+ <br><dt>&lsquo;<samp><span class="samp">-noptex</span></samp>&rsquo;<dd><a name="index-g_t_002dnoptex-172"></a><a name="index-p_0040TeX_007b_007d-extensions-173"></a>Disable the use of pTeX extensions when interpreting DVI files. By
+default, the additional opcodes &lsquo;<samp><span class="samp">130</span></samp>&rsquo; and &lsquo;<samp><span class="samp">135</span></samp>&rsquo; are
+recognized by Dvips as Omega extensions and interpreted as requests to
+set 3-byte characters, and &lsquo;<samp><span class="samp">255</span></samp>&rsquo; as request to change the
+typesetting direction.
+
+ <p>The only drawback is that the virtual font array will (at least
+temporarily) require 65536 or more positions instead of the default
+256 positions, i.e., the memory requirements of Dvips will be somewhat
+larger. If you find this unacceptable or encounter another problem
+with the Omega or pTeX extensions, you can switch off the pTeX
+extension by using &lsquo;<samp><span class="samp">-noptex</span></samp>&rsquo;, or both by using &lsquo;<samp><span class="samp">-noomega</span></samp>&rsquo;
+(but please do send a bug report if you find such problems,
+see <a href="kpathsea.html#Bugs">Bugs</a>).
+
+ <br><dt>&lsquo;<samp><span class="samp">-o </span><var>name</var></samp>&rsquo;<dd><a name="index-g_t_002do-_0040var_007bname_007d-174"></a><a name="index-output_002c-redirecting-175"></a><a name="index-standard-output_002c-output-to-176"></a>Send output to the file <var>name</var>. If &lsquo;<samp><span class="samp">-o</span></samp>&rsquo; is specified without
<var>name</var> (i.e., it is the last thing on the command line), the
default is &lsquo;<samp><var>file</var><span class="samp">.ps</span></samp>&rsquo; where the input DVI file was
&lsquo;<samp><var>file</var><span class="samp">.dvi</span></samp>&rsquo;. If &lsquo;<samp><span class="samp">-o</span></samp>&rsquo; isn't given at all, the
configuration file default is used.
- <p><a name="index-popen-_0040r_007bfor-output_007d-174"></a><a name="index-g_t_002d-_0040r_007bas-output-filename_007d-175"></a><a name="index-g_t_0021-_0040r_007bstarting-output-filename_007d-176"></a><a name="index-g_t_007c-_0040r_007bstarting-output-filename_007d-177"></a><a name="index-lpr-spooler_002c-MS_002dDOS-emulation-178"></a><a name="index-spooling-to-lpr-on-MS_002dDOS-179"></a>If <var>name</var> is &lsquo;<samp><span class="samp">-</span></samp>&rsquo;, output goes to standard output. If the first
+ <p><a name="index-popen-_0040r_007bfor-output_007d-177"></a><a name="index-g_t_002d-_0040r_007bas-output-filename_007d-178"></a><a name="index-g_t_0021-_0040r_007bstarting-output-filename_007d-179"></a><a name="index-g_t_007c-_0040r_007bstarting-output-filename_007d-180"></a><a name="index-lpr-spooler_002c-MS_002dDOS-emulation-181"></a><a name="index-spooling-to-lpr-on-MS_002dDOS-182"></a>If <var>name</var> is &lsquo;<samp><span class="samp">-</span></samp>&rsquo;, output goes to standard output. If the first
character of <var>name</var> is &lsquo;<samp><span class="samp">!</span></samp>&rsquo; or &lsquo;<samp><span class="samp">|</span></samp>&rsquo;, then the remainder will
be used as an argument to <code>popen</code>; thus, specifying &lsquo;<samp><span class="samp">|lpr</span></samp>&rsquo; as
the output file will automatically queue the file for printing as
@@ -1029,21 +1037,21 @@ cannot be found.)
environment variable, and turns off the automatic sending of control-D.
See the &lsquo;<samp><span class="samp">-f</span></samp>&rsquo; option for how to override this.
- <br><dt>&lsquo;<samp><span class="samp">-O </span><var>x-offset</var><span class="samp">,</span><var>y-offset</var></samp>&rsquo;<dd><a name="index-g_t_002dO-_0040var_007bx_002doffset_007d_002c_0040var_007by_002doffset_007d-180"></a><a name="index-offset-pages-181"></a><a name="index-printer-offset-182"></a>Move the origin by <var>x-offset</var>,<var>y-offset</var>, a comma-separated
+ <br><dt>&lsquo;<samp><span class="samp">-O </span><var>x-offset</var><span class="samp">,</span><var>y-offset</var></samp>&rsquo;<dd><a name="index-g_t_002dO-_0040var_007bx_002doffset_007d_002c_0040var_007by_002doffset_007d-183"></a><a name="index-offset-pages-184"></a><a name="index-printer-offset-185"></a>Move the origin by <var>x-offset</var>,<var>y-offset</var>, a comma-separated
pair of dimensions such as &lsquo;<samp><span class="samp">.1in,-.3cm</span></samp>&rsquo; (see <a href="#papersize-special">papersize special</a>). The origin of the page is shifted from the default position
(of one inch down, one inch to the right from the upper left corner of
the paper) by this amount. This is usually best specified in the
printer-specific configuration file.
- <p><a name="index-testpage_002etex-183"></a>This is useful for a printer that consistently offsets output pages by a
+ <p><a name="index-testpage_002etex-186"></a>This is useful for a printer that consistently offsets output pages by a
certain amount. You can use the file <samp><span class="file">testpage.tex</span></samp> to determine
the correct value for your printer. Be sure to do several runs with the
same <code>O</code> value&mdash;some printers vary widely from run to run.
- <p><a name="index-bop_002dhook_0040r_007b_002c-and-offset-pages_007d-184"></a>If your printer offsets every other page consistently, instead of every
+ <p><a name="index-bop_002dhook_0040r_007b_002c-and-offset-pages_007d-187"></a>If your printer offsets every other page consistently, instead of every
page, your best recourse is to use &lsquo;<samp><span class="samp">bop-hook</span></samp>&rsquo; (see <a href="#PostScript-hooks">PostScript hooks</a>).
- <br><dt>&lsquo;<samp><span class="samp">-p [=]</span><var>num</var></samp>&rsquo;<dd><a name="index-g_t_002dp-_005b_003d_005d_0040var_007bnum_007d-185"></a><a name="index-first-page-printed-186"></a><a name="index-page_002c-first-printed-187"></a><a name="index-physical-page-number_002c-and-_0040samp_007b_002dp_007d-188"></a><a name="index-absolute-page-number_002c-and-_0040samp_007b_002dp_007d-189"></a>The first page printed will be the first one numbered <var>num</var>. Default
+ <br><dt>&lsquo;<samp><span class="samp">-p [=]</span><var>num</var></samp>&rsquo;<dd><a name="index-g_t_002dp-_005b_003d_005d_0040var_007bnum_007d-188"></a><a name="index-first-page-printed-189"></a><a name="index-page_002c-first-printed-190"></a><a name="index-physical-page-number_002c-and-_0040samp_007b_002dp_007d-191"></a><a name="index-absolute-page-number_002c-and-_0040samp_007b_002dp_007d-192"></a>The first page printed will be the first one numbered <var>num</var>. Default
is the first page in the document. If <var>num</var> is prefixed by an
equals sign, then it (and the argument to the &lsquo;<samp><span class="samp">-l</span></samp>&rsquo; option, if
specified) is treated as a physical (absolute) page number, rather than
@@ -1051,12 +1059,12 @@ a value to compare with the TeX &lsquo;<samp><span class="samp">\count0</span></
DVI file. Thus, using &lsquo;<samp><span class="samp">-p =3</span></samp>&rsquo; will start with the third page of
the document, no matter what the pages are actually numbered.
- <br><dt>&lsquo;<samp><span class="samp">-pp </span><var>first</var><span class="samp">-</span><var>last</var></samp>&rsquo;<dd><a name="index-g_t_002dpp-_0040var_007bfirst_007d_002d_0040var_007blast_007d-190"></a><a name="index-page-range-191"></a><a name="index-g_t_002dpp-_0040var_007brange_007d-192"></a>Print pages <var>first</var> through <var>last</var>; equivalent to &lsquo;<samp><span class="samp">-p
+ <br><dt>&lsquo;<samp><span class="samp">-pp </span><var>first</var><span class="samp">-</span><var>last</var></samp>&rsquo;<dd><a name="index-g_t_002dpp-_0040var_007bfirst_007d_002d_0040var_007blast_007d-193"></a><a name="index-page-range-194"></a><a name="index-g_t_002dpp-_0040var_007brange_007d-195"></a>Print pages <var>first</var> through <var>last</var>; equivalent to &lsquo;<samp><span class="samp">-p
</span><var>first</var><span class="samp"> -l </span><var>last</var></samp>&rsquo;, except that multiple &lsquo;<samp><span class="samp">-pp</span></samp>&rsquo; options
accumulate, unlike &lsquo;<samp><span class="samp">-p</span></samp>&rsquo; and &lsquo;<samp><span class="samp">-l</span></samp>&rsquo;. The &lsquo;<samp><span class="samp">-</span></samp>&rsquo; separator can
also be &lsquo;<samp><span class="samp">:</span></samp>&rsquo;.
- <br><dt>&lsquo;<samp><span class="samp">-P </span><var>printer</var></samp>&rsquo;<dd><a name="index-g_t_002dP-_0040var_007bprinter_007d-193"></a><a name="index-config_002eps-194"></a>Read the configuration file <samp><span class="file">config.</span><var>printer</var></samp>
+ <br><dt>&lsquo;<samp><span class="samp">-P </span><var>printer</var></samp>&rsquo;<dd><a name="index-g_t_002dP-_0040var_007bprinter_007d-196"></a><a name="index-config_002eps-197"></a>Read the configuration file <samp><span class="file">config.</span><var>printer</var></samp>
(<samp><var>printer</var><span class="file">.cfg</span></samp> on MS-DOS), which can set the output name
(most likely &lsquo;<samp><span class="samp">o |lpr -P</span><var>printer</var></samp>&rsquo;), resolution, Metafont mode,
and perhaps font paths and other printer-specific defaults. It works
@@ -1076,27 +1084,27 @@ include Type1 outline fonts into the PostScript file
exists, it is read.
See <a href="#Configuration-file-searching">Configuration file searching</a>.
- <br><dt>&lsquo;<samp><span class="samp">-q*</span></samp>&rsquo;<dd><a name="index-g_t_002dq-195"></a><a name="index-quiet-operation-196"></a><a name="index-silent-operation-197"></a><a name="index-warnings_002c-suppressing-198"></a>Run quietly. Don't chatter about pages converted, etc. to standard
+ <br><dt>&lsquo;<samp><span class="samp">-q*</span></samp>&rsquo;<dd><a name="index-g_t_002dq-198"></a><a name="index-quiet-operation-199"></a><a name="index-silent-operation-200"></a><a name="index-warnings_002c-suppressing-201"></a>Run quietly. Don't chatter about pages converted, etc. to standard
output; report no warnings (only errors) to standard error.
- <br><dt>&lsquo;<samp><span class="samp">-r*</span></samp>&rsquo;<dd><a name="index-g_t_002dr-199"></a><a name="index-reverse-pagination-200"></a>Output pages in reverse order. By default, page 1 is output first.
+ <br><dt>&lsquo;<samp><span class="samp">-r*</span></samp>&rsquo;<dd><a name="index-g_t_002dr-202"></a><a name="index-reverse-pagination-203"></a>Output pages in reverse order. By default, page 1 is output first.
- <br><dt>&lsquo;<samp><span class="samp">-R</span></samp>&rsquo;<dd><a name="index-g_t_002dR-201"></a><a name="index-security-202"></a><a name="index-shell-command-execution_002c-disabling-203"></a><a name="index-absolute-filenames_002c-disabling-204"></a><a name="index-g_t_0040file_007b_002e_002e_007d_002drelative-filenames-205"></a>Run securely. &lsquo;<samp><span class="samp">-R2</span></samp>&rsquo; disables both shell command execution in
+ <br><dt>&lsquo;<samp><span class="samp">-R</span></samp>&rsquo;<dd><a name="index-g_t_002dR-204"></a><a name="index-security-205"></a><a name="index-shell-command-execution_002c-disabling-206"></a><a name="index-absolute-filenames_002c-disabling-207"></a><a name="index-g_t_0040file_007b_002e_002e_007d_002drelative-filenames-208"></a>Run securely. &lsquo;<samp><span class="samp">-R2</span></samp>&rsquo; disables both shell command execution in
<code>\special</code> (via &lsquo;<samp><span class="samp">`</span></samp>&rsquo;, see <a href="#Dynamic-creation-of-graphics">Dynamic creation of graphics</a>)
and config files (via the &lsquo;<samp><span class="samp">E</span></samp>&rsquo; option, see <a href="#Configuration-file-commands">Configuration file commands</a>) and opening of any absolute or <samp><span class="file">..</span></samp>-relative
filenames. &lsquo;<samp><span class="samp">-R1</span></samp>&rsquo;, the default, forbids shell escapes but allows
absolute filenames. &lsquo;<samp><span class="samp">-R0</span></samp>&rsquo; allows both.
- <br><dt>&lsquo;<samp><span class="samp">-s*</span></samp>&rsquo;<dd><a name="index-g_t_002ds-206"></a><a name="index-save_002frestore_002c-generating-global-207"></a>Enclose the output in a global save/restore pair. This causes the file
+ <br><dt>&lsquo;<samp><span class="samp">-s*</span></samp>&rsquo;<dd><a name="index-g_t_002ds-209"></a><a name="index-save_002frestore_002c-generating-global-210"></a>Enclose the output in a global save/restore pair. This causes the file
to not be truly conformant, and is thus not recommended, but is useful
if you are driving a deficient printer directly and thus don't care too
much about the portability of the output to other environments.
- <br><dt>&lsquo;<samp><span class="samp">-S </span><var>num</var></samp>&rsquo;<dd><a name="index-g_t_002dS-_0040var_007bnum_007d-208"></a>Set the maximum number of pages in each `section'. This option is most
+ <br><dt>&lsquo;<samp><span class="samp">-S </span><var>num</var></samp>&rsquo;<dd><a name="index-g_t_002dS-_0040var_007bnum_007d-211"></a>Set the maximum number of pages in each `section'. This option is most
commonly used with the &lsquo;<samp><span class="samp">-i</span></samp>&rsquo; option; see its description above for
more information.
- <br><dt>&lsquo;<samp><span class="samp">-t </span><var>papertype</var></samp>&rsquo;<dd><a name="index-g_t_002dt-_0040var_007bpapertype_007d-209"></a><a name="index-paper-type-210"></a><a name="index-media-211"></a><a name="index-letter-papertype-212"></a><a name="index-legal-papertype-213"></a><a name="index-ledger-papertype-214"></a><a name="index-a4-papertype-215"></a><a name="index-a3-papertype-216"></a><a name="index-landscape-papertype-217"></a><a name="index-papersize-special_002c-and-no-_0040samp_007b_002dt_007d-218"></a>Set the paper type to <var>papertype</var>, usually defined in one of the
+ <br><dt>&lsquo;<samp><span class="samp">-t </span><var>papertype</var></samp>&rsquo;<dd><a name="index-g_t_002dt-_0040var_007bpapertype_007d-212"></a><a name="index-paper-type-213"></a><a name="index-media-214"></a><a name="index-letter-papertype-215"></a><a name="index-legal-papertype-216"></a><a name="index-ledger-papertype-217"></a><a name="index-a4-papertype-218"></a><a name="index-a3-papertype-219"></a><a name="index-landscape-papertype-220"></a><a name="index-papersize-special_002c-and-no-_0040samp_007b_002dt_007d-221"></a>Set the paper type to <var>papertype</var>, usually defined in one of the
configuration files, along with the appropriate PostScript code to
select it (see <a href="#Config-file-paper-sizes">Config file paper sizes</a>).
<ul>
@@ -1117,56 +1125,56 @@ 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
+ <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-222"></a>Set the paper size to (<var>hsize</var>,<var>vsize</var>), a comma-separated
pair of dimensions such as &lsquo;<samp><span class="samp">.1in,-.3cm</span></samp>&rsquo; (see <a href="#papersize-special">papersize special</a>). It overrides any paper size special in the DVI file. Be
careful, as the paper size will stick to a predefined size if there is
one close enough. To disable this behavior, use &lsquo;<samp><span class="samp">-tunknown</span></samp>&rsquo;.
- <br><dt>&lsquo;<samp><span class="samp">-u </span><var>psmapfile</var></samp>&rsquo;<dd><a name="index-g_t_002du-_0040var_007bpsmapfile_007d-220"></a><a name="index-PostScript-font-alias-file-221"></a><a name="index-resident-fonts_002c-different-in-different-printers-222"></a>Set <var>psmapfile</var> to be the file that dvips uses for looking up
+ <br><dt>&lsquo;<samp><span class="samp">-u </span><var>psmapfile</var></samp>&rsquo;<dd><a name="index-g_t_002du-_0040var_007bpsmapfile_007d-223"></a><a name="index-PostScript-font-alias-file-224"></a><a name="index-resident-fonts_002c-different-in-different-printers-225"></a>Set <var>psmapfile</var> to be the file that dvips uses for looking up
PostScript font aliases. If <var>psmapfile</var> begins with a &lsquo;<samp><span class="samp">+</span></samp>&rsquo;
character, then the rest of the name is used as the name of the map file,
and the map file is appended to the list of map files (instead of replacing
the list). In either case, if the name has no extension, then &lsquo;<samp><span class="samp">.map</span></samp>&rsquo;
is added at the end.
- <br><dt>&lsquo;<samp><span class="samp">-U*</span></samp>&rsquo;<dd><a name="index-g_t_002dU-223"></a><a name="index-Xerox-4045-224"></a>Disable a PostScript virtual memory-saving optimization that stores the
+ <br><dt>&lsquo;<samp><span class="samp">-U*</span></samp>&rsquo;<dd><a name="index-g_t_002dU-226"></a><a name="index-Xerox-4045-227"></a>Disable a PostScript virtual memory-saving optimization that stores the
character metric information in the same string that is used to store
the bitmap information. This is only necessary when driving the Xerox
4045 PostScript interpreter, which has a bug that puts garbage on the
bottom of each character. Not recommended unless you must drive this
printer.
- <br><dt>&lsquo;<samp><span class="samp">-v</span></samp>&rsquo;<dd><a name="index-g_t_002dv-225"></a>Print the dvips version number and exit.
+ <br><dt>&lsquo;<samp><span class="samp">-v</span></samp>&rsquo;<dd><a name="index-g_t_002dv-228"></a>Print the dvips version number and exit.
- <br><dt>&lsquo;<samp><span class="samp">-V*</span></samp>&rsquo;<dd><a name="index-g_t_002dV-226"></a>Download non-resident PostScript fonts as bitmaps. This requires use
-<a name="index-mtpk-227"></a><a name="index-gsftopk-228"></a><a name="index-pstopk-229"></a>of <code>mtpk</code> or <code>gsftopk</code> or <code>pstopk</code> or some combination
+ <br><dt>&lsquo;<samp><span class="samp">-V*</span></samp>&rsquo;<dd><a name="index-g_t_002dV-229"></a>Download non-resident PostScript fonts as bitmaps. This requires use
+<a name="index-mtpk-230"></a><a name="index-gsftopk-231"></a><a name="index-pstopk-232"></a>of <code>mtpk</code> or <code>gsftopk</code> or <code>pstopk</code> or some combination
thereof to generate the required bitmap fonts; these programs are
supplied with Dvips. The bitmap must be put into <samp><span class="file">psfonts.map</span></samp> as
the downloadable file for that font. This is useful only for those
fonts for which you do not have real outlines, being downloaded to
printers that have no resident fonts, i.e., very rarely.
- <br><dt>&lsquo;<samp><span class="samp">-x </span><var>num</var></samp>&rsquo;<dd><a name="index-g_t_002dx-_0040var_007bnum_007d-230"></a><a name="index-magnification_002c-overriding-DVI-231"></a>Set the magnification ratio to <var>num</var>/1000. Overrides
+ <br><dt>&lsquo;<samp><span class="samp">-x </span><var>num</var></samp>&rsquo;<dd><a name="index-g_t_002dx-_0040var_007bnum_007d-233"></a><a name="index-magnification_002c-overriding-DVI-234"></a>Set the magnification ratio to <var>num</var>/1000. Overrides
the magnification specified in the DVI file. Must be between 10 and
100000. It is recommended that you use standard magstep values (1095,
1200, 1440, 1728, 2074, 2488, 2986, and so on) to help reduce the total
number of PK files generated. <var>num</var> may be a real number, not an
integer, for increased precision.
- <br><dt>&lsquo;<samp><span class="samp">-X </span><var>num</var></samp>&rsquo;<dd><a name="index-g_t_002dX-_0040var_007bnum_007d-232"></a><a name="index-resolution-233"></a>Set the horizontal resolution in dots per inch to <var>num</var>.
+ <br><dt>&lsquo;<samp><span class="samp">-X </span><var>num</var></samp>&rsquo;<dd><a name="index-g_t_002dX-_0040var_007bnum_007d-235"></a><a name="index-resolution-236"></a>Set the horizontal resolution in dots per inch to <var>num</var>.
- <br><dt>&lsquo;<samp><span class="samp">-y </span><var>num</var></samp>&rsquo;<dd><a name="index-magnification_002c-vertical-234"></a>Set the magnification ratio to <var>num</var>/1000 times the
+ <br><dt>&lsquo;<samp><span class="samp">-y </span><var>num</var></samp>&rsquo;<dd><a name="index-magnification_002c-vertical-237"></a>Set the magnification ratio to <var>num</var>/1000 times the
magnification specified in the DVI file. See
&lsquo;<samp><span class="samp">-x</span></samp>&rsquo; above.
- <br><dt>&lsquo;<samp><span class="samp">-Y </span><var>num</var></samp>&rsquo;<dd><a name="index-g_t_002dY-_0040var_007bnum_007d-235"></a>Set the vertical resolution in dots per inch to <var>num.</var>
-<a name="index-resolution-236"></a>
-<br><dt>&lsquo;<samp><span class="samp">-z*</span></samp>&rsquo;<dd><a name="index-g_t_002dz-_0040r_007bfor-recognizing-hyperdvi_007d-237"></a><a name="index-hyperdvi-extensions_002c-enabling-238"></a><a name="index-distillation_002c-and-_0040samp_007b_002dz_007d-239"></a><a name="index-PDF-files_002c-option-for-240"></a><a name="index-html-_0040r_007bspecials_002c-and-_0040samp_007b_002dz_007d_007d-241"></a>Pass &lsquo;<samp><span class="samp">html</span></samp>&rsquo; hyperdvi specials through to the output for eventual
+ <br><dt>&lsquo;<samp><span class="samp">-Y </span><var>num</var></samp>&rsquo;<dd><a name="index-g_t_002dY-_0040var_007bnum_007d-238"></a>Set the vertical resolution in dots per inch to <var>num.</var>
+<a name="index-resolution-239"></a>
+<br><dt>&lsquo;<samp><span class="samp">-z*</span></samp>&rsquo;<dd><a name="index-g_t_002dz-_0040r_007bfor-recognizing-hyperdvi_007d-240"></a><a name="index-hyperdvi-extensions_002c-enabling-241"></a><a name="index-distillation_002c-and-_0040samp_007b_002dz_007d-242"></a><a name="index-PDF-files_002c-option-for-243"></a><a name="index-html-_0040r_007bspecials_002c-and-_0040samp_007b_002dz_007d_007d-244"></a>Pass &lsquo;<samp><span class="samp">html</span></samp>&rsquo; hyperdvi specials through to the output for eventual
distillation into PDF. This is not enabled by default to avoid
including the header files unnecessarily, and use of temporary files in
creating the output. See <a href="#Hypertext">Hypertext</a>.
- <br><dt>&lsquo;<samp><span class="samp">-Z*</span></samp>&rsquo;<dd><a name="index-g_t_002dZ-_0040r_007bfor-compressing-bitmap-fonts_007d-242"></a><a name="index-compressing-bitmap-fonts-243"></a>Compress bitmap fonts in the output file, thereby reducing the size of
+ <br><dt>&lsquo;<samp><span class="samp">-Z*</span></samp>&rsquo;<dd><a name="index-g_t_002dZ-_0040r_007bfor-compressing-bitmap-fonts_007d-245"></a><a name="index-compressing-bitmap-fonts-246"></a>Compress bitmap fonts in the output file, thereby reducing the size of
what gets downloaded. Especially useful at high resolutions or when
very large fonts are used. May slow down printing, especially on early
68000-based PostScript printers. Generally recommend today, and can be
@@ -1185,7 +1193,7 @@ Up:&nbsp;<a rel="up" accesskey="u" href="#Invoking-Dvips">Invoking Dvips</a>
<h3 class="section">3.3 Environment variables</h3>
-<p><a name="index-environment-variables-244"></a>
+<p><a name="index-environment-variables-247"></a>
Dvips looks for many environment variables, to define search paths and
other things. The path variables are read as needed, after all
configuration files are read, so they override values in the
@@ -1198,7 +1206,7 @@ Kpathsea-using programs. Only the environment variables specific to
Dvips are mentioned here.
<dl>
-<dt><code>DVIPSDEBUG</code><a name="index-DVIPSDEBUG-245"></a><dd><a name="index-KPATHSEA_005fDEBUG-246"></a>Write the absolute path names of any configuration or map files to
+<dt><code>DVIPSDEBUG</code><a name="index-DVIPSDEBUG-248"></a><dd><a name="index-KPATHSEA_005fDEBUG-249"></a>Write the absolute path names of any configuration or map files to
standard output, for debugging. This isn't done by default because
these files are read even before the banner is printed. For
voluminous additional debugging, set the environment variable
@@ -1206,34 +1214,34 @@ voluminous additional debugging, set the environment variable
(see <a href="kpathsea.html#Debugging">Debugging</a>). (If <samp><span class="env">KPATHSEA_DEBUG</span></samp> is
set to any value, it automatically turns on <samp><span class="env">DVIPSDEBUG</span></samp>.)
- <br><dt><code>DVIPSFONTS</code><a name="index-DVIPSFONTS-247"></a><dd>Default path to search for all fonts. Overrides all the font path
+ <br><dt><code>DVIPSFONTS</code><a name="index-DVIPSFONTS-250"></a><dd>Default path to search for all fonts. Overrides all the font path
config file options and other environment variables (see <a href="kpathsea.html#Supported-file-formats">Supported file formats</a>).
- <br><dt><code>DVIPSHEADERS</code><a name="index-DVIPSHEADERS-248"></a><dd>Default path to search for PostScript header files. Overrides the &lsquo;<samp><span class="samp">H</span></samp>&rsquo;
+ <br><dt><code>DVIPSHEADERS</code><a name="index-DVIPSHEADERS-251"></a><dd>Default path to search for PostScript header files. Overrides the &lsquo;<samp><span class="samp">H</span></samp>&rsquo;
config file option (see <a href="#Configuration-file-commands">Configuration file commands</a>).
- <br><dt><code>DVIPSMAKEPK</code><a name="index-DVIPSMAKEPK-249"></a><dd><a name="index-mktexpk_0040r_007b_002c-changing-name_007d-250"></a>Overrides &lsquo;<samp><span class="samp">mktexpk</span></samp>&rsquo; as the name of the program to invoke to
+ <br><dt><code>DVIPSMAKEPK</code><a name="index-DVIPSMAKEPK-252"></a><dd><a name="index-mktexpk_0040r_007b_002c-changing-name_007d-253"></a>Overrides &lsquo;<samp><span class="samp">mktexpk</span></samp>&rsquo; as the name of the program to invoke to
create missing PK fonts. You can change the arguments passed to the
<code>mktexpk</code> program with the <code>MAKETEXPK</code> environment
variable; see <a href="kpathsea.html#MakeTeX-script-arguments">MakeTeX script arguments</a>.
- <br><dt><code>DVIPSRC</code><a name="index-DVIPSRC-251"></a><dd>Specifies the name of the startup file (see <a href="#Configuration-file-searching">Configuration file searching</a>) which is read after <samp><span class="file">config.ps</span></samp> but before any
+ <br><dt><code>DVIPSRC</code><a name="index-DVIPSRC-254"></a><dd>Specifies the name of the startup file (see <a href="#Configuration-file-searching">Configuration file searching</a>) which is read after <samp><span class="file">config.ps</span></samp> but before any
printer-specific configuration files.
- <br><dt><code>DVIPSSIZES</code><a name="index-DVIPSSIZES-252"></a><dd><a name="index-last_002dresort-font-scaling_002c-with-_0040code_007bDVIPSSIZES_007d-253"></a>Last-resort sizes for scaling of unfound fonts. Overrides the &lsquo;<samp><span class="samp">R</span></samp>&rsquo;
+ <br><dt><code>DVIPSSIZES</code><a name="index-DVIPSSIZES-255"></a><dd><a name="index-last_002dresort-font-scaling_002c-with-_0040code_007bDVIPSSIZES_007d-256"></a>Last-resort sizes for scaling of unfound fonts. Overrides the &lsquo;<samp><span class="samp">R</span></samp>&rsquo;
definition in config files (see <a href="#Configuration-file-commands">Configuration file commands</a>).
- <br><dt><code>PRINTER</code><a name="index-PRINTER-254"></a><dd>Determine the default printer configuration file. (Dvips itself does
+ <br><dt><code>PRINTER</code><a name="index-PRINTER-257"></a><dd>Determine the default printer configuration file. (Dvips itself does
not use <code>PRINTER</code> to determine the output destination in any way.)
- <br><dt><code>TEXCONFIG</code><a name="index-TEXCONFIG-255"></a><dd><a name="index-configuration-file-path-256"></a>Path to search for Dvips' <samp><span class="file">config.</span><var>printer</var></samp> configuration
+ <br><dt><code>TEXCONFIG</code><a name="index-TEXCONFIG-258"></a><dd><a name="index-configuration-file-path-259"></a>Path to search for Dvips' <samp><span class="file">config.</span><var>printer</var></samp> configuration
files, including the base <samp><span class="file">config.ps</span></samp>. Using this single
environment variable, you can override everything else. (The
printer-specific configuration files are called <samp><var>printer</var><span class="file">.cfg</span></samp>
on MS-DOS, but <samp><span class="file">config.ps</span></samp> is called by that name on all
platforms.)
- <br><dt><code>TEXPICTS</code><a name="index-TEXPICTS-257"></a><dd>Path to search for included graphics files. Overrides the &lsquo;<samp><span class="samp">S</span></samp>&rsquo;
+ <br><dt><code>TEXPICTS</code><a name="index-TEXPICTS-260"></a><dd>Path to search for included graphics files. Overrides the &lsquo;<samp><span class="samp">S</span></samp>&rsquo;
config file option (see <a href="#Configuration-file-commands">Configuration file commands</a>). If not set,
<code>TEXINPUTS</code> is looked for. See <a href="kpathsea.html#Supported-file-formats">Supported file formats</a>.
@@ -1249,7 +1257,7 @@ Up:&nbsp;<a rel="up" accesskey="u" href="#Invoking-Dvips">Invoking Dvips</a>
<h3 class="section">3.4 Dvips configuration files</h3>
-<p><a name="index-configuration-files-258"></a>
+<p><a name="index-configuration-files-261"></a>
This section describes in detail the Dvips-specific <samp><span class="file">config.*</span></samp>
device configuration files (called <samp><span class="file">*.cfg</span></samp> on MS-DOS), which
override the <samp><span class="file">texmf.cnf</span></samp>
@@ -1274,17 +1282,17 @@ Up:&nbsp;<a rel="up" accesskey="u" href="#Config-files">Config files</a>
<h4 class="subsection">3.4.1 Configuration file searching</h4>
-<p><a name="index-configuration-file-searching-259"></a><a name="index-searching-config-files_002c-order-of-260"></a>
+<p><a name="index-configuration-file-searching-262"></a><a name="index-searching-config-files_002c-order-of-263"></a>
The Dvips program loads many different configuration files, so that
parameters can be set globally across the system, on a per-device basis,
or individually by each user.
<ol type=1 start=1>
-<li><a name="index-config_002eps_0040r_007b_002c-searched-for_007d-261"></a>Dvips first reads (if it exists) <samp><span class="file">config.ps</span></samp>; it is searched for
+<li><a name="index-config_002eps_0040r_007b_002c-searched-for_007d-264"></a>Dvips first reads (if it exists) <samp><span class="file">config.ps</span></samp>; it is searched for
along the path for Dvips configuration files, as described in
<a href="kpathsea.html#Supported-file-formats">Supported file formats</a>.
- <li><a name="index-g_t_002edvipsrc_0040r_007b_002c-searched-for_007d-262"></a>A user-specific startup file is loaded, so individual users can override
+ <li><a name="index-g_t_002edvipsrc_0040r_007b_002c-searched-for_007d-265"></a>A user-specific startup file is loaded, so individual users can override
any options set in the global file. The environment variable
<code>DVIPSRC</code>, if defined, is used as the specification of the startup
file. If this variable is undefined, Dvips uses a platform-specific
@@ -1296,7 +1304,7 @@ searched for along the path for Dvips configuration files (as described
in <a href="kpathsea.html#Supported-file-formats">Supported file formats</a>.); users are
expected to set this path as they see fit for their taste.
- <li><a name="index-g_t_002dP_0040var_007bprinter_007d_0040r_007b_002c-and-config-file-searching_007d-263"></a>The command line is read and parsed: if the &lsquo;<samp><span class="samp">-P</span><var>device</var></samp>&rsquo; option
+ <li><a name="index-g_t_002dP_0040var_007bprinter_007d_0040r_007b_002c-and-config-file-searching_007d-266"></a>The command line is read and parsed: if the &lsquo;<samp><span class="samp">-P</span><var>device</var></samp>&rsquo; option
is encountered, at that point <samp><span class="file">config.</span><var>device</var></samp> is loaded.
Thus, the printer configuration file can override anything in the
site-wide or user configuration file, and it can also override options
@@ -1305,7 +1313,7 @@ encountered. (On MS-DOS, the printer configuration files are called
<samp><var>device</var><span class="file">.cfg</span></samp>, since DOS doesn't allow more than 3 characters
after the dot in filenames.)
- <li><a name="index-PRINTER_0040r_007b_002c-and-config-file-searching_007d-264"></a>If no &lsquo;<samp><span class="samp">-P</span></samp>&rsquo; option was specified, and also the &lsquo;<samp><span class="samp">-o</span></samp>&rsquo; and
+ <li><a name="index-PRINTER_0040r_007b_002c-and-config-file-searching_007d-267"></a>If no &lsquo;<samp><span class="samp">-P</span></samp>&rsquo; option was specified, and also the &lsquo;<samp><span class="samp">-o</span></samp>&rsquo; and
&lsquo;<samp><span class="samp">-f</span></samp>&rsquo; command line options were not used, Dvips checks the
environment variable <code>PRINTER</code>. If it exists, then
<samp><span class="file">config.</span><var>$PRINTER</var></samp> (<samp><var>$PRINTER</var><span class="file">.cfg</span></samp> on MS-DOS) is
@@ -1351,7 +1359,7 @@ Up:&nbsp;<a rel="up" accesskey="u" href="#Config-files">Config files</a>
<h4 class="subsection">3.4.2 Configuration file commands</h4>
-<p><a name="index-configuration-file-options-265"></a><a name="index-Dvips-configuration-file-options-266"></a>
+<p><a name="index-configuration-file-options-268"></a><a name="index-Dvips-configuration-file-options-269"></a>
Most of the configuration file commands are similar to corresponding
command line options, but there are a few exceptions. When they are the
same, we omit the description here.
@@ -1359,44 +1367,44 @@ same, we omit the description here.
<p>As with command line options, many may be turned off by suffixing the
letter with a zero (&lsquo;<samp><span class="samp">0</span></samp>&rsquo;).
- <p><a name="index-comments_002c-in-configuration-files-267"></a><a name="index-continuation-lines_002c-not-supported-268"></a>Within a configuration file, empty lines, and lines starting with a
+ <p><a name="index-comments_002c-in-configuration-files-270"></a><a name="index-continuation-lines_002c-not-supported-271"></a>Within a configuration file, empty lines, and lines starting with a
space, asterisk, equal sign, percent sign, or pound sign are ignored.
There is no provision for continuation lines.
<dl>
-<dt>&lsquo;<samp><span class="samp">@ </span><var>name hsize vsize</var></samp>&rsquo;<dd><a name="index-g_t_0040_0040-_0040r_007bpaper-size-config-command_007d-269"></a>Define paper sizes. See <a href="#Config-file-paper-sizes">Config file paper sizes</a>.
+<dt>&lsquo;<samp><span class="samp">@ </span><var>name hsize vsize</var></samp>&rsquo;<dd><a name="index-g_t_0040_0040-_0040r_007bpaper-size-config-command_007d-272"></a>Define paper sizes. See <a href="#Config-file-paper-sizes">Config file paper sizes</a>.
- <br><dt>&lsquo;<samp><span class="samp">a*</span></samp>&rsquo;<dd><a name="index-a-_0040r_007bconfig-command-_0028memory-conservation_0029_007d-270"></a>Memory conservation. Same as &lsquo;<samp><span class="samp">-a</span></samp>&rsquo;, see <a href="#Option-details">Option details</a>.
+ <br><dt>&lsquo;<samp><span class="samp">a*</span></samp>&rsquo;<dd><a name="index-a-_0040r_007bconfig-command-_0028memory-conservation_0029_007d-273"></a>Memory conservation. Same as &lsquo;<samp><span class="samp">-a</span></samp>&rsquo;, see <a href="#Option-details">Option details</a>.
- <br><dt>&lsquo;<samp><span class="samp">b </span><var>#copies</var></samp>&rsquo;<dd><a name="index-b-_0040r_007bconfig-command-_0028_0023copies_0029_007d-271"></a>Multiple copies. Same as &lsquo;<samp><span class="samp">-b</span></samp>&rsquo;, see <a href="#Option-details">Option details</a>.
+ <br><dt>&lsquo;<samp><span class="samp">b </span><var>#copies</var></samp>&rsquo;<dd><a name="index-b-_0040r_007bconfig-command-_0028_0023copies_0029_007d-274"></a>Multiple copies. Same as &lsquo;<samp><span class="samp">-b</span></samp>&rsquo;, see <a href="#Option-details">Option details</a>.
- <br><dt>&lsquo;<samp><span class="samp">D </span><var>dpi</var></samp>&rsquo;<dd><a name="index-D-_0040r_007bconfig-command-_0028dpi_0029_007d-272"></a>Output resolution. Same as &lsquo;<samp><span class="samp">-D</span></samp>&rsquo;, see <a href="#Option-details">Option details</a>.
+ <br><dt>&lsquo;<samp><span class="samp">D </span><var>dpi</var></samp>&rsquo;<dd><a name="index-D-_0040r_007bconfig-command-_0028dpi_0029_007d-275"></a>Output resolution. Same as &lsquo;<samp><span class="samp">-D</span></samp>&rsquo;, see <a href="#Option-details">Option details</a>.
- <br><dt>&lsquo;<samp><span class="samp">e </span><var>num</var></samp>&rsquo;<dd><a name="index-e-_0040r_007bconfig-command-_0028maxdrift_0029_007d-273"></a>Max drift. Same as &lsquo;<samp><span class="samp">-e</span></samp>&rsquo;, see <a href="#Option-details">Option details</a>.
+ <br><dt>&lsquo;<samp><span class="samp">e </span><var>num</var></samp>&rsquo;<dd><a name="index-e-_0040r_007bconfig-command-_0028maxdrift_0029_007d-276"></a>Max drift. Same as &lsquo;<samp><span class="samp">-e</span></samp>&rsquo;, see <a href="#Option-details">Option details</a>.
- <br><dt>&lsquo;<samp><span class="samp">E </span><var>command</var></samp>&rsquo;<dd><a name="index-E-_0040r_007bconfig-command-_0028shell-escape_0029_007d-274"></a><a name="index-system-_0040r_007bin-config-file_007d-275"></a><a name="index-datestamp_002c-in-output-276"></a><a name="index-shell-escape_002c-in-config-file-277"></a>Executes the command listed with <code>system</code>(3); can be used to get
+ <br><dt>&lsquo;<samp><span class="samp">E </span><var>command</var></samp>&rsquo;<dd><a name="index-E-_0040r_007bconfig-command-_0028shell-escape_0029_007d-277"></a><a name="index-system-_0040r_007bin-config-file_007d-278"></a><a name="index-datestamp_002c-in-output-279"></a><a name="index-shell-escape_002c-in-config-file-280"></a>Executes the command listed with <code>system</code>(3); can be used to get
the current date into a header file for inclusion, for instance.
Possibly dangerous; this may be disabled, in which case a warning will
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">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-281"></a><a name="index-F-_0040r_007bconfig-command-_0028filter_0029_007d-282"></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">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;,
+ <br><dt>&lsquo;<samp><span class="samp">G*</span></samp>&rsquo;<dd><a name="index-G-_0040r_007bcharacter-shifting-config-command_007d-283"></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>header</var></samp>&rsquo;<dd><a name="index-h-_0040r_007bheader-downloading-config-command_007d-284"></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-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
+ <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-285"></a><a name="index-header-path_002c-defining-286"></a><a name="index-DVIPSHEADERS_0040r_007b_002c-overrides_007d-H-287"></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-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">i </span><var>n</var></samp>&rsquo;<dd><a name="index-i-_0040r_007bconfig-command-_0028pages_002fsection_0029_007d-288"></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-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">j*</span></samp>&rsquo;<dd><a name="index-j-_0040r_007bconfig-command-_0028partial-font-downloading_0029_007d-289"></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_002dremoval_0029_007d-287"></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-290"></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-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
+ <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-291"></a><a name="index-memory-available-292"></a><a name="index-printer-memory-293"></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:
@@ -1413,13 +1421,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-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">M </span><var>mode</var></samp>&rsquo;<dd><a name="index-M-_0040r_007bconfig-command-_0028mf-mode_0029_007d-294"></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-292"></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-295"></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-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>.
+ <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-296"></a><a name="index-output-file_002c-setting-297"></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
@@ -1428,9 +1436,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-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">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-298"></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-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
+ <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-299"></a><a name="index-PostScript-font-alias-file-300"></a><a name="index-resident-fonts_002c-different-in-different-printers-301"></a><a name="index-g_t_002b_0040var_007bpsmapfile_007d-302"></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)
@@ -1438,15 +1446,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-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
+ <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-303"></a><a name="index-PKFONTS_0040r_007b_002c-overrides_007d-P-304"></a><a name="index-TEXPKS_0040r_007b_002c-overrides_007d-P-305"></a><a name="index-GLYPHFONTS_0040r_007b_002c-overrides_007d-P-306"></a><a name="index-TEXFONTS_0040r_007b_002c-overrides_007d-P-307"></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-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">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-308"></a><a name="index-Q-_0040r_007bconfig-command-_0028quiet_0029_007d-309"></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-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></samp>&rsquo;<dd><a name="index-r-_0040r_007bconfig-command-_0028page-reversal_0029_007d-310"></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-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
+ <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-311"></a><a name="index-fallback-resolutions-312"></a><a name="index-default-resolutions-313"></a><a name="index-last_002dresort-scaling_002c-with-_0040code_007bR_007d-314"></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
@@ -1458,43 +1466,43 @@ 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-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
+ <p><a name="index-DVIPSSIZES_0040r_007b_002c-overrides_007d-R-315"></a><a name="index-TEXSIZES_0040r_007b_002c-overrides_007d-R-316"></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-314"></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-317"></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-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></samp>&rsquo;<dd><a name="index-s-_0040r_007bconfig-command-_0028save_002frestore_0029_007d-318"></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-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
+ <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-319"></a><a name="index-TEXPICTS_0040r_007b_002c-overrides_007d-S-320"></a><a name="index-TEXINPUTS_0040r_007b_002c-overrides_007d-S-321"></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-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
+ <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-322"></a><a name="index-TFMFONTS_0040r_007b_002c-overrides_007d-T-323"></a><a name="index-TEXFONTS_0040r_007b_002c-overrides_007d-T-324"></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-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">U*</span></samp>&rsquo;<dd><a name="index-U-_0040r_007bconfig-command-_0028Xerox-4045_0029_007d-325"></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-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
+ <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-326"></a><a name="index-virtual-font-path-327"></a><a name="index-device-dependency_002c-and-virtual-fonts-328"></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-326"></a><a name="index-warning-messages_002c-defining-327"></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-329"></a><a name="index-warning-messages_002c-defining-330"></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-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">X </span><var>num</var></samp>&rsquo;<dd><a name="index-X-_0040r_007bconfig-command-_0028horizontal-resolution_0029_007d-331"></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-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">Y </span><var>num</var></samp>&rsquo;<dd><a name="index-Y-_0040r_007bconfig-command-_0028vertical-resolution_0029_007d-332"></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-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-_0028compression_0029_007d-333"></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-331"></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-334"></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.
@@ -1511,13 +1519,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-332"></a>
+<p><a name="index-paper-size_002c-general-335"></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-333"></a><a name="index-portrait-orientation_002c-defined-334"></a>But many documents are designed for other paper sizes. For instance,
+ <p><a name="index-landscape-orientation_002c-defined-336"></a><a name="index-portrait-orientation_002c-defined-337"></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
@@ -1552,7 +1560,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-335"></a>
+<p><a name="index-papersize-_0040r_007bspecial_007d-338"></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>}
@@ -1563,7 +1571,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-336"></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-339"></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>:
@@ -1576,7 +1584,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-337"></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-340"></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>.
@@ -1595,7 +1603,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-338"></a><a name="index-configuration-file-paper-size-command-339"></a>
+<p><a name="index-paper-size-configuration-file-command-341"></a><a name="index-configuration-file-paper-size-command-342"></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:
@@ -1661,22 +1669,22 @@ commands; others (such as the NeXT) want &lsquo;<samp><span class="samp">PaperSi
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
+ <p><a name="index-unknown_0040r_007b_002c-paper-format-for-_0040samp_007b_002dt_007d_007d-343"></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-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
+ <p><a name="index-nopaper_0040r_007b_002c-paper-format-for-_0040samp_007b_002dt_007d_007d-344"></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
+ <p><a name="index-mkdvipspapers-345"></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-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>
+ <p><a name="index-config_002eps-_0040r_007bpaper-sizes_007d-346"></a><a name="index-letter-_0040r_007bpaper-size_007d-347"></a><a name="index-a4-_0040r_007bpaper-size_007d-348"></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&nbsp;2), or the &lsquo;<samp><span class="samp">letter</span></samp>&rsquo; or &lsquo;<samp><span class="samp">a4</span></samp>&rsquo; operator
@@ -1685,7 +1693,7 @@ 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-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
+ <p><a name="index-letterSize-_0040r_007bpaper-size_007d-349"></a><a name="index-A4size-_0040r_007bpaper-size_007d-350"></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">
@@ -1698,12 +1706,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-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
+<p><a name="index-paper-trays-351"></a><a name="index-dual-paper-trays-352"></a><a name="index-multiple-paper-trays-353"></a><a name="index-HP4Si-printer-and-paper-trays-354"></a>
+<a name="index-bop_002dhook-355"></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-353"></a>For example, suppose you have an alternate tray stocked with letterhead
+ <p><a name="index-letterhead-tray-356"></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
@@ -1740,7 +1748,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-354"></a><a name="index-PostScript-interaction-355"></a>
+<p><a name="index-interaction-with-PostScript-357"></a><a name="index-PostScript-interaction-358"></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.
@@ -1785,20 +1793,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-356"></a>
+<p><a name="index-bounding-box_002c-comment-for-359"></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-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
+ <p><a name="index-big-points-360"></a><a name="index-PostScript-units-361"></a><a name="index-bounding-box_002c-defined-362"></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-360"></a>To see if a PostScript file has a bounding box comment, just look at the
+ <p><a name="index-g_t_0025_0025BoundingBox-363"></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
@@ -1809,7 +1817,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-361"></a><a name="index-g_t_0028atend_0029_0040r_007b_002c-bounding-box-specification_007d-362"></a>
+ <p><a name="index-atend_0040r_007b_002c-bounding-box-specification_007d-364"></a><a name="index-g_t_0028atend_0029_0040r_007b_002c-bounding-box-specification_007d-365"></a>
<pre class="example"> %%BoundingBox: (atend)
</pre>
<p class="noindent">the file is still probably Encapsulated PostScript, but the bounding box
@@ -1819,13 +1827,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-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
+ <p><a name="index-bbfig-366"></a><a name="index-bounding-box_002c-determining-367"></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-365"></a>If the comment looks like this:
+ <p><a name="index-g_t612-792-_0040r_007bbounding-box-size_007d-368"></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
@@ -1869,7 +1877,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-366"></a><a name="index-macros-for-epsf-inclusion-367"></a>
+<p><a name="index-g_t_005cincludegraphics-_0040LaTeX_007b_007d-macro-369"></a><a name="index-macros-for-epsf-inclusion-370"></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
@@ -1901,7 +1909,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-368"></a>The \includegraphics command has many options, specified in
+ <p><a name="index-bounding-box_002c-supplying-to-_0040TeX_007b_007d-371"></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
@@ -1932,7 +1940,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-369"></a><a name="index-macros-for-epsf-inclusion-370"></a>
+<p><a name="index-EPSF-macros-372"></a><a name="index-macros-for-epsf-inclusion-373"></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>.
@@ -1940,10 +1948,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-371"></a>
+ <p><a name="index-epsf_002etex-374"></a>
<pre class="example"> \input epsf
</pre>
- <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:
+ <p class="noindent"><a name="index-epsf_002esty-375"></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>
@@ -1954,7 +1962,7 @@ figures you plan to include.
<pre class="example"> \epsffile{foo.eps}
</pre>
- <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>
+ <p><a name="index-g_t_005cleavevmode-376"></a><a name="index-bounding-box_002c-supplying-to-_0040TeX_007b_007d-377"></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
@@ -1967,7 +1975,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-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>
+ <p><a name="index-g_t_005cepsffile-_0040r_007bmacro_007d-378"></a><a name="index-figures_002c-natural-size-379"></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
@@ -1975,7 +1983,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-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
+ <p><a name="index-g_t_005cepsfverbosetrue-380"></a><a name="index-verbose-EPSF-processing-381"></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
@@ -1995,7 +2003,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-379"></a><a name="index-figures_002c-scaling-380"></a>
+<p><a name="index-scaling-of-figures-382"></a><a name="index-figures_002c-scaling-383"></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.
@@ -2004,14 +2012,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-381"></a>
+ <p><a name="index-g_t_005cepsfxsize-384"></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-382"></a>
+ <p><a name="index-g_t_005cepsfysize-385"></a>
<pre class="example"> \epsfysize=<var>dimen</var>
</pre>
<p class="noindent">in which case the height will be set and the width scaled
@@ -2021,7 +2029,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-383"></a>You can resize graphics in a more general way by redefining the
+ <p><a name="index-g_t_005cepsfsize-386"></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,
@@ -2051,11 +2059,11 @@ instead of <code>\hsize</code>.)
</dl>
- <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
+ <p><a name="index-DVI-magnification-387"></a><a name="index-magnification_002c-DVI-388"></a><a name="index-g_t_005cmagnification-389"></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-387"></a>
+ <p><a name="index-g_t_002fmagscale-390"></a>
<pre class="example"> \special{! /magscale false def}
</pre>
<p class="noindent">Use of this command is not recommended because it will make the
@@ -2064,7 +2072,7 @@ 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-388"></a>DVI magnification is not applied to any output from code you write in
+ <p><a name="index-bop_002dhook-391"></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">
@@ -2077,7 +2085,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-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>
+<p><a name="index-clipping-of-EPSF-392"></a><a name="index-bounding-box_002c-inaccurate-393"></a><a name="index-text-in-figures_002c-chopped-off-394"></a><a name="index-lines-in-figures_002c-wrong-width-395"></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
@@ -2103,7 +2111,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-393"></a>
+<p><a name="index-psfile-_0040r_007bspecial_007d-396"></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> ... }
@@ -2116,26 +2124,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-394"></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-397"></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-395"></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-398"></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-396"></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-399"></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-397"></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-400"></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-398"></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-401"></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-399"></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-402"></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-400"></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-403"></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-401"></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-404"></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-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>
+ <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-405"></a><a name="index-lly-_0040r_007b_0028_0040samp_007bpsfile_007d-special-option_0029_007d-406"></a><a name="index-urx-_0040r_007b_0028_0040samp_007bpsfile_007d-special-option_0029_007d-407"></a><a name="index-ury-_0040r_007b_0028_0040samp_007bpsfile_007d-special-option_0029_007d-408"></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-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
+ <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-409"></a><a name="index-rwi-_0040r_007b_0028_0040samp_007bpsfile_007d-special-option_0029_007d-410"></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,
@@ -2158,8 +2166,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-408"></a>in &lsquo;<samp><span class="samp">SDict</span></samp>&rsquo;
-<a name="index-SDict-409"></a>by a TeX command such as
+<a name="index-scaleunit-411"></a>in &lsquo;<samp><span class="samp">SDict</span></samp>&rsquo;
+<a name="index-SDict-412"></a>by a TeX command such as
<pre class="example"> \special{! /@scaleunit 1 def}
</pre>
@@ -2178,7 +2186,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-410"></a><a name="index-compressed-PostScript-411"></a><a name="index-uncompressing-PostScript-412"></a>
+<p><a name="index-dynamic-creation-of-graphics-413"></a><a name="index-compressed-PostScript-414"></a><a name="index-uncompressing-PostScript-415"></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
@@ -2198,7 +2206,7 @@ file to standard output. For example:
<pre class="example"> \special{psfile="`gnuplot foo"}
</pre>
- <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
+ <p class="noindent"><a name="index-gnuplot-416"></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.
@@ -2213,7 +2221,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-414"></a><a name="index-fonts_002c-in-PostScript-figures-415"></a><a name="index-g_t_0025_002aFont-416"></a>
+<p><a name="index-figures-and-fonts-417"></a><a name="index-fonts_002c-in-PostScript-figures-418"></a><a name="index-g_t_0025_002aFont-419"></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:
@@ -2262,14 +2270,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-417"></a><a name="index-PostScript-header-files-418"></a>
+<p><a name="index-header-files_002c-defined-420"></a><a name="index-PostScript-header-files-421"></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-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
+ <p><a name="index-psheaderdir-422"></a><a name="index-g_t_002epro-_0040r_007bprologue-files_007d-423"></a><a name="index-g_t_002elpro-_0040r_007blong-prologue-files_007d-424"></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
@@ -2279,7 +2287,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-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
+ <p><a name="index-userdict_0040r_007b_002c-and-dictionary-files_007d-425"></a><a name="index-dictionary_002c-_0040code_007buserdict_007d-426"></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">
@@ -2298,15 +2306,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-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
+<p><a name="index-including-headers-in-_0040TeX_007b_007d-427"></a><a name="index-header_003d_0040var_007bfile_007d-_005cspecial-428"></a><a name="index-g_t_0040TeX_007b_007d_002c-including-headers-in-429"></a>
+<a name="index-headers_002c-including-in-_0040TeX_007b_007d-430"></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-428"></a>As another example, if you have some PostScript code that uses a
+ <p><a name="index-fonts_002c-as-header-files-431"></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:
@@ -2321,7 +2329,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-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
+ <p><a name="index-before-header_002c-inserting-code-432"></a><a name="index-after-header_002c-inserting-code-433"></a><a name="index-pre-_0040r_007bcode-before-headers_007d-434"></a><a name="index-post-_0040r_007bcode-after-headers_007d-435"></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.
@@ -2351,14 +2359,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-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>
+<p><a name="index-including-headers-from-the-command-line-436"></a><a name="index-command-line_002c-including-headers-from-437"></a><a name="index-headers_002c-including-from-the-command-line-438"></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-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
+ <p><a name="index-duplex-printers-439"></a><a name="index-simplex-mode-on-duplex-printers-440"></a><a name="index-screen-frequencies_002c-setting-441"></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
@@ -2377,13 +2385,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-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
+<p><a name="index-headers-and-memory-usage-442"></a><a name="index-memory-usage_002c-and-headers-443"></a>
+<a name="index-sections-of-output-file_002c-and-memory-444"></a><a name="index-output-file_002c-sectioning-of-445"></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-443"></a><a name="index-g_t_0025_0025VMusage-444"></a>
+ <p><a name="index-VMusage-446"></a><a name="index-g_t_0025_0025VMusage-447"></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
@@ -2402,7 +2410,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-445"></a><a name="index-PostScript-code_002c-literal-446"></a>
+<p><a name="index-literal-PostScript_002c-using-448"></a><a name="index-PostScript-code_002c-literal-449"></a>
You can include literal PostScript code in your document in several ways.
<ul class="menu">
@@ -2424,7 +2432,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-447"></a>
+<p><a name="index-g_t_0022-_0040r_007bspecial-_0028literal-PostScript_0029_007d-450"></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;.
@@ -2451,8 +2459,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-448"></a>
-<a name="index-save_002frestore_002c-and-specials-449"></a>Generally, Dvips encloses specials in a PostScript save/restore pair,
+<p><a name="index-ps-_0040r_007bspecial_007d-451"></a>
+<a name="index-save_002frestore_002c-and-specials-452"></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
@@ -2476,11 +2484,11 @@ 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-450"></a>In addition, the variant
+ <p><a name="index-plotfile_0040r_007b_002c-_0040samp_007bps_007d-subspecial_007d-453"></a>In addition, the variant
<pre class="example"> \special{ps: plotfile <var>filename</var>}
</pre>
- <p class="noindent"><a name="index-rotate_002etex-451"></a>inserts the contents of <var>filename</var> verbatim into the output (except
+ <p class="noindent"><a name="index-rotate_002etex-454"></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.
@@ -2496,8 +2504,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-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,
+<p><a name="index-literal-headers-455"></a><a name="index-SDict-_0040r_007bdictionary_007d-456"></a>
+<a name="index-g_t_0021-_0040r_007bspecial-_0028literal-PS-header_0029_007d-457"></a><a name="index-dictionary_002c-_0040code_007bSDict_007d-458"></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
@@ -2521,18 +2529,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-456"></a>
+<p><a name="index-PostScript-hooks-459"></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-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>,
+ <p><a name="index-bop_002dhook-460"></a><a name="index-eop_002dhook-461"></a><a name="index-start_002dhook-462"></a><a name="index-end_002dhook-463"></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-461"></a><a name="index-dated-output-462"></a>When these macros are executed, the default PostScript coordinate system
+ <p><a name="index-draft-copies-464"></a><a name="index-dated-output-465"></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
@@ -2542,7 +2550,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-463"></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-466"></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.
@@ -2553,7 +2561,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-464"></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-467"></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;).
@@ -2570,7 +2578,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-465"></a><a name="index-examples-of-literal-PostScript-466"></a>
+<p><a name="index-literal-PostScript_002c-examples-468"></a><a name="index-examples-of-literal-PostScript-469"></a>
To finish off this section, the following examples of literal PostScript
are presented without explanation:
@@ -2586,7 +2594,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-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
+ <p><a name="index-g_t_005crotninety-470"></a><a name="index-gsave_0040r_007b_002f_007dgrestore_0040r_007b_002c-and-literal-PS_007d-471"></a><a name="index-save_0040r_007b_002f_007drestore_0040r_007b_002c-and-literal-PS_007d-472"></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
@@ -2603,13 +2611,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-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
+<p><a name="index-hypertext-support-473"></a>
+<a name="index-g_t_002dz-474"></a><a name="index-html-_0040r_007bspecials_007d-475"></a><a name="index-pdfmark-476"></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-474"></a><a name="index-PDF-files_002c-making-475"></a>The resulting PostScript can then be processed by a distiller program to
+ <p><a name="index-distiller_002c-for-PDF-files-477"></a><a name="index-PDF-files_002c-making-478"></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
@@ -2619,7 +2627,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-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
+ <p><a name="index-g_t_0040code_007bhttp_003a_002f_002fwww_002ewin_002etue_002enl_002f_007edickie_002fidvi_007d-479"></a><a name="index-g_t_0040code_007bhttp_003a_002f_002fxxx_002elanl_002egov_002fhypertex_007d-480"></a><a name="index-Doyle_002c-Mark-481"></a><a name="index-Bhattacharya_002c-Tanmoy-482"></a><a name="index-Java-DVI-reader-483"></a><a name="index-idvi-_0040r_007bJava-DVI-reader_007d-484"></a><a name="index-dvihps_0040r_007b_002c-hyperdvi-to-PostScript_007d-485"></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
@@ -2645,8 +2653,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-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
+<p><a name="index-hypertext-caveats-486"></a>
+<a name="index-Computer-Modern-in-PostScript-487"></a><a name="index-hypertext-and-bitmap-fonts-488"></a><a name="index-hypertext-caveats-489"></a><a name="index-embedding-Type-1-fonts-490"></a><a name="index-PDF-files_002c-font-quality-491"></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.
@@ -2694,7 +2702,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-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
+ <p><a name="index-psi-character-missing-492"></a><a name="index-trailing-spaces_002c-dropped-493"></a><a name="index-spaces_002c-dropped-trailing-494"></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
@@ -2733,8 +2741,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-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
+<p><a name="index-hypertext-specials-495"></a><a name="index-specials_002c-hypertext-496"></a>
+<a name="index-Smith_002c-Arthur-497"></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:
@@ -2748,7 +2756,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-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),
+ <p><a name="index-uniform-resource-locator-498"></a><a name="index-extended-URL-499"></a><a name="index-URL_002c-extended-for-_0040TeX_007b_007d-500"></a><a name="index-Murphy_002c-Tim-501"></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;,
@@ -2757,12 +2765,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-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>
+ <p><a name="index-URL_002c-definition-502"></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-500"></a><dd><a name="index-links_002c-hypertext-501"></a>Creates links in your TeX document. For example:
+<dt>&lsquo;<samp><span class="samp">href</span></samp>&rsquo;<a name="index-href-503"></a><dd><a name="index-links_002c-hypertext-504"></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>
@@ -2771,7 +2779,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-502"></a><dd><a name="index-Anderson_002c-Laurie-503"></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-505"></a><dd><a name="index-Anderson_002c-Laurie-506"></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.
@@ -2781,11 +2789,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-504"></a><dd><a name="index-mailcap-_0040r_007band-hypertext_007d-505"></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-507"></a><dd><a name="index-mailcap-_0040r_007band-hypertext_007d-508"></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-506"></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-509"></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>
@@ -2804,7 +2812,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-507"></a>
+<p><a name="index-PostScript-fonts-510"></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
@@ -2835,7 +2843,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-508"></a>
+<p><a name="index-font-concepts-511"></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
@@ -2867,7 +2875,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-509"></a>
+<p><a name="index-metric-files-512"></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
@@ -2877,7 +2885,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-510"></a><a name="index-ligature_002c-defined-511"></a>In addition to information on individual characters, the metric file
+ <p><a name="index-kerning_002c-defined-513"></a><a name="index-ligature_002c-defined-514"></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
@@ -2889,12 +2897,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-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;)
+<li><a name="index-afm-files-515"></a><a name="index-g_t_002eafm-_0040r_007bAdobe-metric-files_007d-516"></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-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
+ <li><a name="index-tfm-files-517"></a><a name="index-g_t_002etfm-_0040r_007b_0040TeX_007b_007d-font-metric-files_007d-518"></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
@@ -2902,14 +2910,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-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
+ <p><a name="index-property-list-files-519"></a><a name="index-tftopl-520"></a><a name="index-pltotf-521"></a><a name="index-g_t_002epl-_0040r_007bproperty-list-files_007d-522"></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-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>
+ <li><a name="index-pfm-files-523"></a><a name="index-g_t_002epfm-_0040r_007bprinter-font-metric-files_007d-524"></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.
@@ -2931,7 +2939,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-522"></a>
+<p><a name="index-glyph-files-525"></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
@@ -2943,7 +2951,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-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
+ <p><a name="index-outline-fonts-526"></a><a name="index-arcs-527"></a><a name="index-splines-528"></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
@@ -2951,25 +2959,25 @@ 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-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
+ <p><a name="index-Type-1-fonts-529"></a><a name="index-pfa-files-530"></a><a name="index-pfb-files-531"></a><a name="index-g_t_002epfa-_0040r_007bprinter-font-ascii-files_007d-532"></a><a name="index-g_t_002epfb-_0040r_007bprinter-font-binary-files_007d-533"></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-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
+ <p><a name="index-bitmap-fonts-534"></a><a name="index-g_t_002emf-_0040r_007bMetafont-source-files_007d-535"></a><a name="index-Metafont-source-files-536"></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-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
+ <p><a name="index-pk-files-537"></a><a name="index-g_t_002e_0040var_007bnnn_007dpk-_0040r_007bpacked-font-bitmaps_007d-538"></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-536"></a><a name="index-gftopk-537"></a>Metafont actually outputs <dfn>generic font</dfn> (GF) files, e.g.,
+ <p><a name="index-gf-files-539"></a><a name="index-gftopk-540"></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
@@ -2986,7 +2994,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-538"></a>
+<p><a name="index-virtual-fonts-541"></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
@@ -2998,13 +3006,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-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
+ <p><a name="index-vf-files-542"></a><a name="index-vpl-files-543"></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-541"></a>In the case of a PostScript font <var>f</var> being used in a straightforward
+ <p><a name="index-base-fonts-544"></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
@@ -3015,7 +3023,7 @@ 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-542"></a><a name="index-virtual-font-expansion-543"></a>You can <dfn>expand</dfn> virtual fonts into their base fonts with DVIcopy
+ <p><a name="index-expansion_002c-of-virtual-fonts-545"></a><a name="index-virtual-font-expansion-546"></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.
@@ -3030,7 +3038,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-544"></a>
+<p><a name="index-encodings-547"></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
@@ -3040,7 +3048,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-545"></a>TeX implicitly assumes a particular encoding for the fonts you use
+ <p><a name="index-Computer-Modern_002c-encoding-of-548"></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
@@ -3052,7 +3060,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-546"></a><a name="index-encoding-files-547"></a><a name="index-encoding-vectors_002c-defined-548"></a>
+ <p><a name="index-PostScript-encoding-549"></a><a name="index-encoding-files-550"></a><a name="index-encoding-vectors_002c-defined-551"></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
@@ -3061,16 +3069,16 @@ 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-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,
-such as <samp><span class="file">ptmr.tfm</span></samp>. The distribution includes many other encoding
-files; for example, <samp><span class="file">8r.enc</span></samp>, which is the base font for the
-current PostScript font distribution, and three corresponding to the
-TeX mathematics fonts: <samp><span class="file">texmext.enc</span></samp> for math extensions,
-<samp><span class="file">texmital.enc</span></samp> for math italics, and <samp><span class="file">texmsym.enc</span></samp> for math
-symbols.
+ <p><a name="index-dvips_002eenc-552"></a><a name="index-g_t8r_002eenc-553"></a><a name="index-texmext_002eenc-554"></a><a name="index-texmital_002eenc-555"></a><a name="index-texmsym_002eenc-556"></a><a name="index-reencode_002f_002a_002eenc-557"></a>Examples of encodings: the <samp><span class="file">dvips.enc</span></samp> encoding file that comes
+with the Fontname distribution (<a href="http://tug.org/fontname">http://tug.org/fontname</a>) 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, such as <samp><span class="file">ptmr.tfm</span></samp>. The
+distribution includes many other encoding files; for example,
+<samp><span class="file">8r.enc</span></samp>, which is the base font for the current PostScript font
+distribution, and three corresponding to the TeX mathematics fonts:
+<samp><span class="file">texmext.enc</span></samp> for math extensions, <samp><span class="file">texmital.enc</span></samp> for math
+italics, and <samp><span class="file">texmsym.enc</span></samp> for math symbols.
<div class="node">
<a name="PostScript-typesetting"></a>
@@ -3082,7 +3090,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-555"></a><a name="index-character-lookup-procedure-in-PostScript-556"></a>
+<p><a name="index-typesetting-in-PostScript-558"></a><a name="index-character-lookup-procedure-in-PostScript-559"></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
@@ -3101,7 +3109,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-557"></a>The basic PostScript operator for imaging characters is
+ <p><a name="index-show-_0040r_007bPostScript-operator_007d-560"></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:
@@ -3111,11 +3119,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-558"></a>PostScript interpreters use ASCII; therefore `S' is represented as the
+<li><a name="index-ASCII-character-codes_002c-used-by-PostScript-561"></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-559"></a><a name="index-dictionary_002c-PostScript-language-560"></a>A PostScript <dfn>dictionary</dfn> is a mapping of names to arbitrary values.
+ <li><a name="index-current-font_002c-in-PostScript-562"></a><a name="index-dictionary_002c-PostScript-language-563"></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.)
@@ -3123,18 +3131,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-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;,
+ <li><a name="index-encoding-vectors_002c-in-Type-1-fonts-564"></a><a name="index-Encoding-_0040r_007bType-1-dictionary_007d-565"></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-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
+ <li><a name="index-CharStrings-_0040r_007bType-1-dictionary_007d-566"></a><a name="index-dictionary_002c-_0040code_007bCharStrings_007d-567"></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-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
+ <li><a name="index-hints-568"></a><a name="index-character-definitions-in-PostScript-569"></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
@@ -3159,7 +3167,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-567"></a><a name="index-fonts_002c-installing-568"></a>
+<p><a name="index-installing-fonts-570"></a><a name="index-fonts_002c-installing-571"></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
@@ -3201,7 +3209,7 @@ from the VPL file:
<p>The simplest invocation of Afm2tfm to make virtual fonts goes something
like this:
- <p><a name="index-afm2tfm-569"></a>
+ <p><a name="index-afm2tfm-572"></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
@@ -3209,7 +3217,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-570"></a>
+ <p><a name="index-vptovf-573"></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
@@ -3263,7 +3271,7 @@ 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-571"></a><a name="index-efficiency_002c-and-fonts-572"></a>These PostScript fonts can be scaled to any size. Go wild! Using
+ <p><a name="index-memory_002c-used-by-PostScript-fonts-574"></a><a name="index-efficiency_002c-and-fonts-575"></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
@@ -3280,7 +3288,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-573"></a>
+<p><a name="index-afm2tfm-576"></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
@@ -3288,7 +3296,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-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
+ <p><a name="index-fontinst-577"></a><a name="index-virtual-fonts_002c-creating-578"></a><a name="index-Jeffrey_002c-Alan-579"></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>).
@@ -3309,7 +3317,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-577"></a><a name="index-fonts_002c-changing-encoding-of-578"></a>
+<p><a name="index-encoding-changes-580"></a><a name="index-fonts_002c-changing-encoding-of-581"></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
@@ -3334,8 +3342,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-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
+<p><a name="index-changing-_0040TeX_007b_007d-encodings-582"></a><a name="index-g_t_0040TeX_007b_007d-encoding_002c-changing-583"></a>
+<a name="index-g_t_002dt-_0040var_007btex_002denc_007d-584"></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
@@ -3345,7 +3353,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-582"></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-585"></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
@@ -3364,7 +3372,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-583"></a><a name="index-PostScript-encoding_002c-changing-584"></a><a name="index-g_t_002dp-_0040var_007bps_002denc_007d-585"></a>
+<p><a name="index-changing-PostScript-encodings-586"></a><a name="index-PostScript-encoding_002c-changing-587"></a><a name="index-g_t_002dp-_0040var_007bps_002denc_007d-588"></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
@@ -3377,13 +3385,13 @@ 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-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
+ <p><a name="index-trademark-_0040r_007bcharacter_002c-accessing_007d-589"></a><a name="index-registered-_0040r_007bcharacter_002c-accessing_007d-590"></a><a name="index-extra-characters_002c-accessing-591"></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-589"></a>The `8r' base encoding used for the current PostScript font
+ <p><a name="index-g_t8r-_0040r_007bencoding_002c-and-extra-characters_007d-592"></a>The `8r' base encoding used for the current PostScript font
distribution does do this reencoding, for precisely this reason.
<div class="node">
@@ -3397,7 +3405,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-590"></a>
+<p><a name="index-g_t_002dT-_0040var_007benc_002dfile_007d-593"></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
@@ -3417,7 +3425,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-591"></a><a name="index-remapping-592"></a>
+<p><a name="index-reencoding-594"></a><a name="index-remapping-595"></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
@@ -3444,7 +3452,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-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>)
+ <p><a name="index-accents_002c-in-wrong-position-596"></a><a name="index-Hungarian-umlaut-597"></a><a name="index-dot-accent-598"></a><a name="index-Scandinavian-A-ring-599"></a><a name="index-A-ring_002c-Scandinavian-letter-600"></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
@@ -3456,7 +3464,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-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>
+ <p><a name="index-g_t_005cH-601"></a><a name="index-g_t_005c_002e-602"></a><a name="index-g_t_005cdot-603"></a><a name="index-g_t_005cAA-604"></a>
<pre class="example"> \def\H#1{{\accent"CD #1}}
\def\.#1{{\accent"C7 #1}}
\def\dot{\mathaccent"70C7 }
@@ -3465,7 +3473,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-602"></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-605"></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>
@@ -3496,7 +3504,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-603"></a>
+<p><a name="index-encoding-file-format-606"></a>
Afm2tfm's encoding files have the same format as an encoding vector in a
PostScript font. Here is a skeletal example:
@@ -3511,7 +3519,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-604"></a>Comments, which start with a percent sign and continue until the end
+ <p><a name="index-comments_002c-in-encoding-files-607"></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
@@ -3529,11 +3537,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-605"></a>In these <code>LIGKERN</code> statements, three types of information may be
+ <p><a name="index-LIGKERN-_0040r_007bencoding-file-command_007d-608"></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-606"></a>Throughout a <code>LIGKERN</code> statement, the boundary character is
+ <p><a name="index-boundary-character-609"></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:
@@ -3547,12 +3555,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-607"></a><a name="index-Metafont-ligature-operations-608"></a>To specify a ligature, specify the names of the pair of characters,
+ <p><a name="index-ligature-operations-610"></a><a name="index-Metafont-ligature-operations-611"></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-609"></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-612"></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
@@ -3591,7 +3599,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-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
+<p><a name="index-oblique-fonts-613"></a><a name="index-slanted-fonts-614"></a><a name="index-fonts_002c-slanted-615"></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.)
@@ -3602,26 +3610,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-613"></a>
+ <p><a name="index-SlantFont-616"></a>
<pre class="example"> rptmro Times-Roman ".167 SlantFont"
</pre>
- <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
+ <p class="noindent"><a name="index-psfonts_002emap-617"></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-615"></a><a name="index-fonts_002c-expanded-616"></a>Similarly, you can get an expanded font with
+ <p><a name="index-expanded-fonts-618"></a><a name="index-fonts_002c-expanded-619"></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-617"></a>
+<a name="index-ExtendFont-620"></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-618"></a><a name="index-fonts_002c-small-caps-619"></a>
+<a name="index-small-caps-fonts-621"></a><a name="index-fonts_002c-small-caps-622"></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
@@ -3636,7 +3644,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-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
+ <p><a name="index-PaintType-623"></a><a name="index-outline-fonts-624"></a><a name="index-fonts_002c-outlined-625"></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:
@@ -3660,7 +3668,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-623"></a><a name="index-afm2tfm-options-624"></a>
+<p><a name="index-options_002c-to-Afm2tfm-626"></a><a name="index-afm2tfm-options-627"></a>
Synopsis:
<pre class="example"> afm2tfm [<var>option</var>]... <var>afmfile</var>[.afm] [<var>tfmfile</var>[.tfm]]
</pre>
@@ -3672,7 +3680,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-625"></a>The TFM file thus created is <dfn>raw</dfn> because it omits ligature and
+ <p><a name="index-accents_002c-wrong-628"></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
@@ -3688,40 +3696,40 @@ 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-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
+<dt>&lsquo;<samp><span class="samp">-c </span><var>ratio</var></samp>&rsquo;<dd><a name="index-g_t_002dc-_0040var_007bratio_007d-629"></a><a name="index-scaling-small-caps-630"></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-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
+ <br><dt>&lsquo;<samp><span class="samp">-e </span><var>ratio</var></samp>&rsquo;<dd><a name="index-g_t_002de-_0040var_007bratio_007d-631"></a><a name="index-expanded-fonts-632"></a><a name="index-condensed-fonts-633"></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-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
+ <br><dt>&lsquo;<samp><span class="samp">-O</span></samp>&rsquo;<dd><a name="index-g_t_002dO-634"></a><a name="index-octal-character-codes-635"></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-633"></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-636"></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-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
+ <br><dt>&lsquo;<samp><span class="samp">-s </span><var>slant</var></samp>&rsquo;<dd><a name="index-g_t_002ds-_0040var_007bslant_007d-637"></a><a name="index-slanted-fonts_002c-making-638"></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-636"></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-639"></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-637"></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-640"></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-638"></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-641"></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-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-642"></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-640"></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-643"></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.
@@ -3738,13 +3746,13 @@ 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-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>
+<p><a name="index-psfonts_002emap-644"></a><a name="index-non_002dresident-fonts-645"></a><a name="index-downloading-PostScript-fonts-646"></a><a name="index-fonts_002c-downloading-647"></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-645"></a>For example, the line
+ <p><a name="index-g_t_003c-_0040r_007bfont-downloading_007d-648"></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> (just as if it were
@@ -3753,49 +3761,49 @@ font, see <a href="#Virtual-fonts">Virtual fonts</a>) references the TFM file &l
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-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:
+ <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:
<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-650"></a>You can change the encoding of the Type 1 font at the PostScript
+ <p><a name="index-reencoding-PostScript-fonts-653"></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-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
+ <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
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-653"></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-656"></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-654"></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-657"></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-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
+ <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
<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-657"></a>When using PFB files, Dvips is smart enough to unpack the binary PFB
+ <p><a name="index-pfb-files_002c-automatically-unpacked-660"></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
+ <p><a name="index-partial-font-downloading-661"></a><a name="index-downloading-fonts-partially-662"></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
+ <p><a name="index-whole-font-downloading-663"></a><a name="index-multiple-master-fonts-664"></a><a name="index-Minion-typeface-family-665"></a><a name="index-g_t_003c_003c-_0040r_007bwhole-font-downloading_007d-666"></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
@@ -3849,8 +3857,8 @@ Up:&nbsp;<a rel="up" accesskey="u" href="#Top">Top</a>
<h2 class="chapter">7 Color</h2>
-<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
+<p><a name="index-color-667"></a>
+<a name="index-Hafner_002c-Jim-668"></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
@@ -3881,7 +3889,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-666"></a><a name="index-color-macros-667"></a>
+<p><a name="index-macros-for-color-669"></a><a name="index-color-macros-670"></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:
@@ -3895,7 +3903,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-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
+ <p><a name="index-Crayola-crayon-box-671"></a><a name="index-Pantone-colors-672"></a><a name="index-color-names_002c-mixed-case-673"></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
@@ -3910,7 +3918,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-671"></a>where <var>ColorName</var> is the name of a predefined color, e.g.,
+ <p><a name="index-g_t_005c_0040var_007bColorName_007d-674"></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
@@ -3919,14 +3927,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-672"></a>The color nesting level has no hard limit, but it is not advisable to
+ <p class="noindent"><a name="index-color-nesting-level-675"></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-673"></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-676"></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
@@ -3965,7 +3973,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-674"></a><a name="index-colors_002c-user_002ddefinable-675"></a>
+<p><a name="index-user_002ddefinable-colors-677"></a><a name="index-colors_002c-user_002ddefinable-678"></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
@@ -4002,7 +4010,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-676"></a>
+<p><a name="index-color-subtleties-679"></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
@@ -4071,7 +4079,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-677"></a><a name="index-configuration_002c-of-color-devices-678"></a>
+<p><a name="index-color-configuration-680"></a><a name="index-configuration_002c-of-color-devices-681"></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
@@ -4084,7 +4092,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-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
+ <p><a name="index-Phaser-printer_002c-used-for-color-calibration-682"></a><a name="index-Tektronix-Phaser-printer_002c-used-for-color-calibration-683"></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
@@ -4147,7 +4155,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-681"></a>
+<p><a name="index-color-specifications-684"></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;.
@@ -4231,20 +4239,20 @@ 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-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-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_0021-_0040r_007bspecial-_0028literal-PS-header_0029_007d-457"><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-179"><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-450"><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-363"><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-467"><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-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_0025_0025VMusage-447"><code>%%VMusage</code></a>: <a href="#Headers-and-memory-usage">Headers and memory usage</a></li>
+<li><a href="#index-g_t_0025_002aFont-419"><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-365"><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-302"><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-_0040r_007bas-output-filename_007d-178"><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>
<li><a href="#index-g_t_002d_002dhelp-81"><code>--help</code></a>: <a href="#Option-summary">Option summary</a></li>
<li><a href="#index-g_t_002d_002dversion-87"><code>--version</code></a>: <a href="#Option-details">Option details</a></li>
@@ -4254,12 +4262,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-626"><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-629"><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-628"><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-631"><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>
@@ -4276,639 +4284,641 @@ 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-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-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>
-<li><a href="#index-g_t_002dq-195"><code>-q</code></a>: <a href="#Option-details">Option details</a></li>
-<li><a href="#index-g_t_002dR-201"><code>-R</code></a>: <a href="#Option-details">Option details</a></li>
-<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-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-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-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-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-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-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_002dnoptex-172"><code>-noptex</code></a>: <a href="#Option-details">Option details</a></li>
+<li><a href="#index-g_t_002dO-634"><code>-O</code></a>: <a href="#Afm2tfm-options">Afm2tfm options</a></li>
+<li><a href="#index-g_t_002do-_0040var_007bname_007d-174"><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-183"><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-188"><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-196"><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-636"><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-588"><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-193"><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-195"><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-266"><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>
+<li><a href="#index-g_t_002dq-198"><code>-q</code></a>: <a href="#Option-details">Option details</a></li>
+<li><a href="#index-g_t_002dR-204"><code>-R</code></a>: <a href="#Option-details">Option details</a></li>
+<li><a href="#index-g_t_002dr-202"><code>-r</code></a>: <a href="#Option-details">Option details</a></li>
+<li><a href="#index-g_t_002ds-209"><code>-s</code></a>: <a href="#Option-details">Option details</a></li>
+<li><a href="#index-g_t_002dS-_0040var_007bnum_007d-211"><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-637"><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-593"><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-222"><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-212"><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-640"><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-639"><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-584"><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-641"><code>-u</code></a>: <a href="#Afm2tfm-options">Afm2tfm options</a></li>
+<li><a href="#index-g_t_002dU-226"><code>-U</code></a>: <a href="#Option-details">Option details</a></li>
+<li><a href="#index-g_t_002du-_0040var_007bpsmapfile_007d-223"><code>-u </code><var>psmapfile</var></a>: <a href="#Option-details">Option details</a></li>
+<li><a href="#index-g_t_002dV-229"><code>-V</code></a>: <a href="#Option-details">Option details</a></li>
+<li><a href="#index-g_t_002dv-228"><code>-v</code></a>: <a href="#Option-details">Option details</a></li>
+<li><a href="#index-g_t_002dV-_0040var_007bvpl_002dfile_007d-643"><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-642"><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-235"><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-233"><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-238"><code>-Y </code><var>num</var></a>: <a href="#Option-details">Option details</a></li>
+<li><a href="#index-g_t_002dz-474"><code>-z</code></a>: <a href="#Hypertext">Hypertext</a></li>
+<li><a href="#index-g_t_002dZ-_0040r_007bfor-compressing-bitmap-fonts_007d-245"><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-240"><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-208"><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-516"><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-265"><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-424"><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-535"><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-538"><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-532"><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-533"><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-524"><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-522"><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-423"><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-518"><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-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-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-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-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-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-g_t_002fmagscale-390"><code>/magscale</code></a>: <a href="#EPSF-scaling">EPSF scaling</a></li>
+<li><a href="#index-g_t612-792-_0040r_007bbounding-box-size_007d-368"><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-592"><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-553"><code>8r.enc</code></a>: <a href="#Encodings">Encodings</a></li>
+<li><a href="#index-g_t_003c-_0040r_007bfont-downloading_007d-648"><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-666"><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-612"><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-272"><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-602"><code>\.</code></a>: <a href="#Reencoding-with-Afm2tfm">Reencoding with Afm2tfm</a></li>
+<li><a href="#index-g_t_005cAA-604"><code>\AA</code></a>: <a href="#Reencoding-with-Afm2tfm">Reencoding with Afm2tfm</a></li>
+<li><a href="#index-g_t_005c_0040var_007bColorName_007d-674"><code>\</code><var>ColorName</var></a>: <a href="#Color-macro-files">Color macro files</a></li>
+<li><a href="#index-g_t_005cdot-603"><code>\dot</code></a>: <a href="#Reencoding-with-Afm2tfm">Reencoding with Afm2tfm</a></li>
+<li><a href="#index-g_t_005cepsffile-_0040r_007bmacro_007d-378"><code>\epsffile </code><span class="roman">macro</span></a>: <a href="#EPSF-macros">EPSF macros</a></li>
+<li><a href="#index-g_t_005cepsfsize-386"><code>\epsfsize</code></a>: <a href="#EPSF-scaling">EPSF scaling</a></li>
+<li><a href="#index-g_t_005cepsfverbosetrue-380"><code>\epsfverbosetrue</code></a>: <a href="#EPSF-macros">EPSF macros</a></li>
+<li><a href="#index-g_t_005cepsfxsize-384"><code>\epsfxsize</code></a>: <a href="#EPSF-scaling">EPSF scaling</a></li>
+<li><a href="#index-g_t_005cepsfysize-385"><code>\epsfysize</code></a>: <a href="#EPSF-scaling">EPSF scaling</a></li>
+<li><a href="#index-g_t_005cH-601"><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-369">\includegraphics LaTeX macro</a>: <a href="#g_t_005cincludegraphics">\includegraphics</a></li>
+<li><a href="#index-g_t_005cleavevmode-376"><code>\leavevmode</code></a>: <a href="#EPSF-macros">EPSF macros</a></li>
+<li><a href="#index-g_t_005cmagnification-389"><code>\magnification</code></a>: <a href="#EPSF-scaling">EPSF scaling</a></li>
+<li><a href="#index-g_t_005crotninety-470"><code>\rotninety</code></a>: <a href="#Literal-examples">Literal examples</a></li>
+<li><a href="#index-g_t_005ctext_0040var_007bColorName_007d-676"><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-273"><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-600">A ring, Scandinavian letter</a>: <a href="#Reencoding-with-Afm2tfm">Reencoding with Afm2tfm</a></li>
+<li><a href="#index-a3-papertype-219">a3 papertype</a>: <a href="#Option-details">Option details</a></li>
+<li><a href="#index-a4-_0040r_007bpaper-size_007d-348"><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-218">a4 papertype</a>: <a href="#Option-details">Option details</a></li>
+<li><a href="#index-A4size-_0040r_007bpaper-size_007d-350"><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-207">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-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-absolute-page-number_002c-and-_0040samp_007b_002dp_007d-192">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-596">accents, in wrong position</a>: <a href="#Reencoding-with-Afm2tfm">Reencoding with Afm2tfm</a></li>
+<li><a href="#index-accents_002c-wrong-628">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-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-afm-files-515">afm files</a>: <a href="#Metric-files">Metric files</a></li>
+<li><a href="#index-afm2tfm-576"><code>afm2tfm</code></a>: <a href="#Invoking-afm2tfm">Invoking afm2tfm</a></li>
+<li><a href="#index-afm2tfm-572"><code>afm2tfm</code></a>: <a href="#Making-a-font-available">Making a font available</a></li>
+<li><a href="#index-afm2tfm-options-627">afm2tfm options</a>: <a href="#Afm2tfm-options">Afm2tfm options</a></li>
+<li><a href="#index-after-header_002c-inserting-code-433">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-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-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-Anderson_002c-Laurie-506">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-403"><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-527">arcs</a>: <a href="#Glyph-files">Glyph files</a></li>
+<li><a href="#index-ASCII-character-codes_002c-used-by-PostScript-561">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-364"><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-274"><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-509"><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-544">base fonts</a>: <a href="#Virtual-fonts">Virtual fonts</a></li>
+<li><a href="#index-bbfig-366"><code>bbfig</code></a>: <a href="#Bounding-box">Bounding box</a></li>
+<li><a href="#index-before-header_002c-inserting-code-432">before header, inserting code</a>: <a href="#Including-headers-from-TeX">Including headers from TeX</a></li>
+<li><a href="#index-Bhattacharya_002c-Tanmoy-482">Bhattacharya, Tanmoy</a>: <a href="#Hypertext">Hypertext</a></li>
+<li><a href="#index-big-points-360">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-531">bitmap fonts</a>: <a href="#Glyph-files">Glyph files</a></li>
+<li><a href="#index-bitmap-fonts-534">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-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-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-bop_002dhook-460"><code>bop-hook</code></a>: <a href="#PostScript-hooks">PostScript hooks</a></li>
+<li><a href="#index-bop_002dhook-391"><code>bop-hook</code></a>: <a href="#EPSF-scaling">EPSF scaling</a></li>
+<li><a href="#index-bop_002dhook-355"><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-187"><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-609">boundary character</a>: <a href="#Encoding-file-format">Encoding file format</a></li>
+<li><a href="#index-bounding-box_002c-comment-for-359">bounding box, comment for</a>: <a href="#Bounding-box">Bounding box</a></li>
+<li><a href="#index-bounding-box_002c-defined-362">bounding box, defined</a>: <a href="#Bounding-box">Bounding box</a></li>
+<li><a href="#index-bounding-box_002c-determining-367">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-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-bounding-box_002c-inaccurate-393">bounding box, inaccurate</a>: <a href="#EPSF-clipping">EPSF clipping</a></li>
+<li><a href="#index-bounding-box_002c-supplying-to-_0040TeX_007b_007d-377">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-371">bounding box, supplying to TeX</a>: <a href="#g_t_005cincludegraphics">\includegraphics</a></li>
+<li><a href="#index-changing-PostScript-encodings-586">changing PostScript encodings</a>: <a href="#Changing-PostScript-encodings">Changing PostScript encodings</a></li>
+<li><a href="#index-changing-_0040TeX_007b_007d-encodings-582">changing TeX encodings</a>: <a href="#Changing-TeX-encodings">Changing TeX encodings</a></li>
+<li><a href="#index-character-definitions-in-PostScript-569">character definitions in PostScript</a>: <a href="#PostScript-typesetting">PostScript typesetting</a></li>
+<li><a href="#index-character-lookup-procedure-in-PostScript-559">character lookup procedure in PostScript</a>: <a href="#PostScript-typesetting">PostScript typesetting</a></li>
+<li><a href="#index-CharStrings-_0040r_007bType-1-dictionary_007d-566"><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-404"><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-392">clipping of EPSF</a>: <a href="#EPSF-clipping">EPSF clipping</a></li>
+<li><a href="#index-CODINGSCHEME-605"><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-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-667">color</a>: <a href="#Color">Color</a></li>
+<li><a href="#index-color-configuration-680">color configuration</a>: <a href="#Color-device-configuration">Color device configuration</a></li>
+<li><a href="#index-color-macros-670">color macros</a>: <a href="#Color-macro-files">Color macro files</a></li>
+<li><a href="#index-color-names_002c-mixed-case-673">color names, mixed case</a>: <a href="#Color-macro-files">Color macro files</a></li>
+<li><a href="#index-color-nesting-level-675">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-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-color-specifications-684">color specifications</a>: <a href="#Color-specifications">Color specifications</a></li>
+<li><a href="#index-color-subtleties-679">color subtleties</a>: <a href="#Color-subtleties">Color subtleties</a></li>
+<li><a href="#index-colors_002c-user_002ddefinable-678">colors, user-definable</a>: <a href="#User_002ddefinable-colors">User-definable colors</a></li>
+<li><a href="#index-command-line_002c-including-headers-from-437">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-604">comments, in encoding files</a>: <a href="#Encoding-file-format">Encoding file format</a></li>
+<li><a href="#index-comments_002c-in-configuration-files-270">comments, in configuration files</a>: <a href="#Configuration-file-commands">Configuration file commands</a></li>
+<li><a href="#index-comments_002c-in-encoding-files-607">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-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-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-compressed-PostScript-414">compressed PostScript</a>: <a href="#Dynamic-creation-of-graphics">Dynamic creation of graphics</a></li>
+<li><a href="#index-compressing-bitmap-fonts-246">compressing bitmap fonts</a>: <a href="#Option-details">Option details</a></li>
+<li><a href="#index-Computer-Modern-in-PostScript-487">Computer Modern in PostScript</a>: <a href="#Hypertext-caveats">Hypertext caveats</a></li>
+<li><a href="#index-Computer-Modern_002c-encoding-of-548">Computer Modern, encoding of</a>: <a href="#Encodings">Encodings</a></li>
+<li><a href="#index-condensed-fonts-633">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-197"><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-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-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-config_002eps-_0040r_007bpaper-sizes_007d-346"><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-264"><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-268">configuration file options</a>: <a href="#Configuration-file-commands">Configuration file commands</a></li>
+<li><a href="#index-configuration-file-paper-size-command-342">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-259">configuration file path</a>: <a href="#Environment-variables">Environment variables</a></li>
+<li><a href="#index-configuration-file-searching-262">configuration file searching</a>: <a href="#Configuration-file-searching">Configuration file searching</a></li>
+<li><a href="#index-configuration-files-261">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-678">configuration, of color devices</a>: <a href="#Color-device-configuration">Color device configuration</a></li>
+<li><a href="#index-configuration_002c-of-color-devices-681">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-continuation-lines_002c-not-supported-271">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-668">Crayola crayon box</a>: <a href="#Color-macro-files">Color macro files</a></li>
+<li><a href="#index-Crayola-crayon-box-671">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-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-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-current-font_002c-in-PostScript-562">current font, in PostScript</a>: <a href="#PostScript-typesetting">PostScript typesetting</a></li>
+<li><a href="#index-D-_0040r_007bconfig-command-_0028dpi_0029_007d-275"><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-465">dated output</a>: <a href="#PostScript-hooks">PostScript hooks</a></li>
+<li><a href="#index-datestamp_002c-in-output-279">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-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-default-resolutions-313">default resolutions</a>: <a href="#Configuration-file-commands">Configuration file commands</a></li>
+<li><a href="#index-default_005ftexsizes-_0040r_007bMake-variable_007d-317"><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-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-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-device-dependency_002c-and-virtual-fonts-328">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-567">dictionary, <code>CharStrings</code></a>: <a href="#PostScript-typesetting">PostScript typesetting</a></li>
+<li><a href="#index-dictionary_002c-PostScript-language-563">dictionary, PostScript language</a>: <a href="#PostScript-typesetting">PostScript typesetting</a></li>
+<li><a href="#index-dictionary_002c-_0040code_007bSDict_007d-458">dictionary, <code>SDict</code></a>: <a href="#Literal-headers">Literal headers</a></li>
+<li><a href="#index-dictionary_002c-_0040code_007buserdict_007d-426">dictionary, <code>userdict</code></a>: <a href="#Header-files">Header files</a></li>
+<li><a href="#index-distillation_002c-and-_0040samp_007b_002dz_007d-242">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-477">distiller, for PDF files</a>: <a href="#Hypertext">Hypertext</a></li>
+<li><a href="#index-dot-accent-598">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-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-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-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-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-572">efficiency, and fonts</a>: <a href="#Making-a-font-available">Making a font available</a></li>
+<li><a href="#index-downloading-fonts-partially-662">downloading fonts partially</a>: <a href="#psfonts_002emap">psfonts.map</a></li>
+<li><a href="#index-downloading-PostScript-fonts-646">downloading PostScript fonts</a>: <a href="#psfonts_002emap">psfonts.map</a></li>
+<li><a href="#index-Doyle_002c-Mark-481">Doyle, Mark</a>: <a href="#Hypertext">Hypertext</a></li>
+<li><a href="#index-draft-copies-464">draft copies</a>: <a href="#PostScript-hooks">PostScript hooks</a></li>
+<li><a href="#index-dual-paper-trays-352">dual paper trays</a>: <a href="#Paper-trays">Paper trays</a></li>
+<li><a href="#index-duplex-printers-439">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-387">DVI magnification</a>: <a href="#EPSF-scaling">EPSF scaling</a></li>
+<li><a href="#index-dvihps_0040r_007b_002c-hyperdvi-to-PostScript_007d-485"><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-269">Dvips configuration file options</a>: <a href="#Configuration-file-commands">Configuration file commands</a></li>
+<li><a href="#index-dvips_002eenc-552"><code>dvips.enc</code></a>: <a href="#Encodings">Encodings</a></li>
+<li><a href="#index-DVIPSDEBUG-248"><code>DVIPSDEBUG</code></a>: <a href="#Environment-variables">Environment variables</a></li>
+<li><a href="#index-DVIPSFONTS-250"><code>DVIPSFONTS</code></a>: <a href="#Environment-variables">Environment variables</a></li>
+<li><a href="#index-DVIPSHEADERS-251"><code>DVIPSHEADERS</code></a>: <a href="#Environment-variables">Environment variables</a></li>
+<li><a href="#index-DVIPSHEADERS_0040r_007b_002c-overrides_007d-H-287"><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-252"><code>DVIPSMAKEPK</code></a>: <a href="#Environment-variables">Environment variables</a></li>
+<li><a href="#index-DVIPSRC-254"><code>DVIPSRC</code></a>: <a href="#Environment-variables">Environment variables</a></li>
+<li><a href="#index-DVIPSSIZES-255"><code>DVIPSSIZES</code></a>: <a href="#Environment-variables">Environment variables</a></li>
+<li><a href="#index-DVIPSSIZES_0040r_007b_002c-overrides_007d-R-315"><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-413">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-276"><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-277"><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-575">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-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-embedding-Type-1-fonts-490">embedding Type 1 fonts</a>: <a href="#Hypertext-caveats">Hypertext caveats</a></li>
+<li><a href="#index-encoding-changes-580">encoding changes</a>: <a href="#Changing-font-encodings">Changing font encodings</a></li>
+<li><a href="#index-encoding-file-format-606">encoding file format</a>: <a href="#Encoding-file-format">Encoding file format</a></li>
+<li><a href="#index-encoding-files-550">encoding files</a>: <a href="#Encodings">Encodings</a></li>
+<li><a href="#index-Encoding-_0040r_007bType-1-dictionary_007d-565"><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-551">encoding vectors, defined</a>: <a href="#Encodings">Encodings</a></li>
+<li><a href="#index-encoding-vectors_002c-in-Type-1-fonts-564">encoding vectors, in Type 1 fonts</a>: <a href="#PostScript-typesetting">PostScript typesetting</a></li>
+<li><a href="#index-encodings-547">encodings</a>: <a href="#Encodings">Encodings</a></li>
+<li><a href="#index-end_002dhook-463"><code>end-hook</code></a>: <a href="#PostScript-hooks">PostScript hooks</a></li>
+<li><a href="#index-environment-variables-247">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-458"><code>eop-hook</code></a>: <a href="#PostScript-hooks">PostScript hooks</a></li>
+<li><a href="#index-eop_002dhook-461"><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-369">EPSF macros</a>: <a href="#EPSF-macros">EPSF macros</a></li>
+<li><a href="#index-EPSF-macros-372">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-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-epsf_002esty-375"><code>epsf.sty</code></a>: <a href="#EPSF-macros">EPSF macros</a></li>
+<li><a href="#index-epsf_002etex-374"><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-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-examples-of-literal-PostScript-469">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-632">expanded fonts</a>: <a href="#Afm2tfm-options">Afm2tfm options</a></li>
+<li><a href="#index-expanded-fonts-618">expanded fonts</a>: <a href="#Special-font-effects">Special font effects</a></li>
+<li><a href="#index-expansion_002c-of-virtual-fonts-545">expansion, of virtual fonts</a>: <a href="#Virtual-fonts">Virtual fonts</a></li>
+<li><a href="#index-extended-URL-499">extended URL</a>: <a href="#Hypertext-specials">Hypertext specials</a></li>
+<li><a href="#index-ExtendFont-620"><code>ExtendFont</code></a>: <a href="#Special-font-effects">Special font effects</a></li>
+<li><a href="#index-extra-characters_002c-accessing-591">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-282"><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-281"><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-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-fallback-resolutions-312">fallback resolutions</a>: <a href="#Configuration-file-commands">Configuration file commands</a></li>
+<li><a href="#index-figures-and-fonts-417">figures and fonts</a>: <a href="#Fonts-in-figures">Fonts in figures</a></li>
+<li><a href="#index-figures_002c-natural-size-379">figures, natural size</a>: <a href="#EPSF-macros">EPSF macros</a></li>
+<li><a href="#index-figures_002c-scaling-383">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-508">font concepts</a>: <a href="#Font-concepts">Font concepts</a></li>
+<li><a href="#index-first-page-printed-189">first page printed</a>: <a href="#Option-details">Option details</a></li>
+<li><a href="#index-font-concepts-511">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-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-fontinst-577"><code>fontinst</code></a>: <a href="#Invoking-afm2tfm">Invoking afm2tfm</a></li>
+<li><a href="#index-fonts_002c-as-header-files-431">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-581">fonts, changing encoding of</a>: <a href="#Changing-font-encodings">Changing font encodings</a></li>
+<li><a href="#index-fonts_002c-downloading-647">fonts, downloading</a>: <a href="#psfonts_002emap">psfonts.map</a></li>
+<li><a href="#index-fonts_002c-expanded-619">fonts, expanded</a>: <a href="#Special-font-effects">Special font effects</a></li>
+<li><a href="#index-fonts_002c-in-PostScript-figures-418">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-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-installing-571">fonts, installing</a>: <a href="#Making-a-font-available">Making a font available</a></li>
+<li><a href="#index-fonts_002c-outlined-625">fonts, outlined</a>: <a href="#Special-font-effects">Special font effects</a></li>
+<li><a href="#index-fonts_002c-slanted-615">fonts, slanted</a>: <a href="#Special-font-effects">Special font effects</a></li>
+<li><a href="#index-fonts_002c-small-caps-622">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-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-G-_0040r_007bcharacter-shifting-config-command_007d-283"><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-539">gf files</a>: <a href="#Glyph-files">Glyph files</a></li>
+<li><a href="#index-gftopk-540"><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-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-glyph-files-525">glyph files</a>: <a href="#Glyph-files">Glyph files</a></li>
+<li><a href="#index-GLYPHFONTS_0040r_007b_002c-overrides_007d-P-306"><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-413"><code>gnuplot</code></a>: <a href="#Dynamic-creation-of-graphics">Dynamic creation of graphics</a></li>
+<li><a href="#index-gnuplot-416"><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-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-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-gsave_0040r_007b_002f_007dgrestore_0040r_007b_002c-and-literal-PS_007d-471"><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-231"><code>gsftopk</code></a>: <a href="#Option-details">Option details</a></li>
+<li><a href="#index-h-_0040r_007bheader-downloading-config-command_007d-284"><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-285"><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-668">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-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-header-files_002c-defined-420">header files, defined</a>: <a href="#Header-files">Header files</a></li>
+<li><a href="#index-header-path_002c-defining-286">header path, defining</a>: <a href="#Configuration-file-commands">Configuration file commands</a></li>
+<li><a href="#index-header_003d_0040var_007bfile_007d-_005cspecial-428"><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-442">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-438">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-430">headers, including in TeX</a>: <a href="#Including-headers-from-TeX">Including headers from TeX</a></li>
+<li><a href="#index-hints-568">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-397"><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-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-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-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-HP4Si-printer-and-paper-trays-354">HP4Si printer and paper trays</a>: <a href="#Paper-trays">Paper trays</a></li>
+<li><a href="#index-href-503"><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-401"><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-399"><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-475"><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-244"><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-479"><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-480"><code>http://xxx.lanl.gov/hypertex</code></a>: <a href="#Hypertext">Hypertext</a></li>
+<li><a href="#index-Hungarian-umlaut-597">Hungarian umlaut</a>: <a href="#Reencoding-with-Afm2tfm">Reencoding with Afm2tfm</a></li>
+<li><a href="#index-hyperdvi-extensions_002c-enabling-241">hyperdvi extensions, enabling</a>: <a href="#Option-details">Option details</a></li>
+<li><a href="#index-hypertext-and-bitmap-fonts-488">hypertext and bitmap fonts</a>: <a href="#Hypertext-caveats">Hypertext caveats</a></li>
+<li><a href="#index-hypertext-caveats-486">hypertext caveats</a>: <a href="#Hypertext-caveats">Hypertext caveats</a></li>
+<li><a href="#index-hypertext-specials-495">hypertext specials</a>: <a href="#Hypertext-specials">Hypertext specials</a></li>
+<li><a href="#index-hypertext-support-473">hypertext support</a>: <a href="#Hypertext">Hypertext</a></li>
+<li><a href="#index-i-_0040r_007bconfig-command-_0028pages_002fsection_0029_007d-288"><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-484"><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-504"><code>img</code></a>: <a href="#Hypertext-specials">Hypertext specials</a></li>
+<li><a href="#index-img-507"><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-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-including-headers-from-the-command-line-436">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-427">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-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-installing-fonts-570">installing fonts</a>: <a href="#Making-a-font-available">Making a font available</a></li>
+<li><a href="#index-interaction-with-PostScript-357">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-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-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-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-j-_0040r_007bconfig-command-_0028partial-font-downloading_0029_007d-289"><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-483">Java DVI reader</a>: <a href="#Hypertext">Hypertext</a></li>
+<li><a href="#index-Jeffrey_002c-Alan-579">Jeffrey, Alan</a>: <a href="#Invoking-afm2tfm">Invoking afm2tfm</a></li>
+<li><a href="#index-K-_0040r_007bconfig-command-_0028comment_002dremoval_0029_007d-290"><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-513">kerning, defined</a>: <a href="#Metric-files">Metric files</a></li>
+<li><a href="#index-KPATHSEA_005fDEBUG-249"><code>KPATHSEA_DEBUG</code></a>: <a href="#Environment-variables">Environment variables</a></li>
+<li><a href="#index-landscape-orientation_002c-defined-336">landscape orientation, defined</a>: <a href="#Paper-size-and-landscape">Paper size and landscape</a></li>
+<li><a href="#index-landscape-papertype-220">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-339"><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-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-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-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-last_002dresort-font-scaling_002c-with-_0040code_007bDVIPSSIZES_007d-256">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-314">last-resort scaling, with <code>R</code></a>: <a href="#Configuration-file-commands">Configuration file commands</a></li>
+<li><a href="#index-ledger-papertype-217">ledger papertype</a>: <a href="#Option-details">Option details</a></li>
+<li><a href="#index-legal-papertype-216">legal papertype</a>: <a href="#Option-details">Option details</a></li>
+<li><a href="#index-letter-_0040r_007bpaper-size_007d-347"><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-215">letter papertype</a>: <a href="#Option-details">Option details</a></li>
+<li><a href="#index-letterhead-tray-356">letterhead tray</a>: <a href="#Paper-trays">Paper trays</a></li>
+<li><a href="#index-letterSize-_0040r_007bpaper-size_007d-349"><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-610">ligature operations</a>: <a href="#Encoding-file-format">Encoding file format</a></li>
+<li><a href="#index-ligature_002c-defined-514">ligature, defined</a>: <a href="#Metric-files">Metric files</a></li>
+<li><a href="#index-LIGKERN-_0040r_007bencoding-file-command_007d-608"><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-395">lines in figures, wrong width</a>: <a href="#EPSF-clipping">EPSF clipping</a></li>
+<li><a href="#index-links_002c-hypertext-504">links, hypertext</a>: <a href="#Hypertext-specials">Hypertext specials</a></li>
+<li><a href="#index-literal-headers-455">literal headers</a>: <a href="#Literal-headers">Literal headers</a></li>
+<li><a href="#index-literal-PostScript_002c-examples-468">literal PostScript, examples</a>: <a href="#Literal-examples">Literal examples</a></li>
+<li><a href="#index-literal-PostScript_002c-using-448">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-405"><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-406"><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-lpr-spooler_002c-MS_002dDOS-emulation-181">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-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-505"><code>mailcap </code><span class="roman">and hypertext</span></a>: <a href="#Hypertext-specials">Hypertext specials</a></li>
+<li><a href="#index-m-_0040r_007bconfig-command-_0028available-memory_0029_007d-291"><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-294"><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-669">macros for color</a>: <a href="#Color-macro-files">Color macro files</a></li>
+<li><a href="#index-macros-for-epsf-inclusion-373">macros for epsf inclusion</a>: <a href="#EPSF-macros">EPSF macros</a></li>
+<li><a href="#index-macros-for-epsf-inclusion-370">macros for epsf inclusion</a>: <a href="#g_t_005cincludegraphics">\includegraphics</a></li>
+<li><a href="#index-magnification_002c-DVI-388">magnification, DVI</a>: <a href="#EPSF-scaling">EPSF scaling</a></li>
+<li><a href="#index-magnification_002c-overriding-DVI-234">magnification, overriding DVI</a>: <a href="#Option-details">Option details</a></li>
+<li><a href="#index-magnification_002c-vertical-237">magnification, vertical</a>: <a href="#Option-details">Option details</a></li>
+<li><a href="#index-mailcap-_0040r_007band-hypertext_007d-508"><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-289">memory available</a>: <a href="#Configuration-file-commands">Configuration file commands</a></li>
+<li><a href="#index-media-214">media</a>: <a href="#Option-details">Option details</a></li>
+<li><a href="#index-memory-available-292">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-440">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-443">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-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-memory_002c-used-by-PostScript-fonts-574">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-611">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-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-Metafont-source-files-536">Metafont source files</a>: <a href="#Glyph-files">Glyph files</a></li>
+<li><a href="#index-metric-files-512">metric files</a>: <a href="#Metric-files">Metric files</a></li>
+<li><a href="#index-Minion-typeface-family-665">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-342"><code>mkdvipspapers</code></a>: <a href="#Config-file-paper-sizes">Config file paper sizes</a></li>
+<li><a href="#index-mkdvipspapers-345"><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-mktexpk_0040r_007b_002c-changing-name_007d-253"><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-661">multiple master fonts</a>: <a href="#psfonts_002emap">psfonts.map</a></li>
+<li><a href="#index-mtpk-230"><code>mtpk</code></a>: <a href="#Option-details">Option details</a></li>
+<li><a href="#index-multiple-master-fonts-664">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-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-multiple-paper-trays-353">multiple paper trays</a>: <a href="#Paper-trays">Paper trays</a></li>
+<li><a href="#index-Murphy_002c-Tim-501">Murphy, Tim</a>: <a href="#Hypertext-specials">Hypertext specials</a></li>
+<li><a href="#index-N-_0040r_007bEPS_002ddisabling-config-command_007d-295"><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-505"><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-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-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-non_002dresident-fonts-645">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-344"><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-298"><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-296"><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-613">oblique fonts</a>: <a href="#Special-font-effects">Special font effects</a></li>
+<li><a href="#index-octal-character-codes-635">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-offset-pages-184">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>
<li><a href="#index-option_002c-details-of-82">option, details of</a>: <a href="#Option-details">Option details</a></li>
<li><a href="#index-options_002c-debugging-50">options, debugging</a>: <a href="#Debug-options">Debug options</a></li>
<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-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-options_002c-to-Afm2tfm-626">options, to Afm2tfm</a>: <a href="#Afm2tfm-options">Afm2tfm options</a></li>
+<li><a href="#index-outline-fonts-624">outline fonts</a>: <a href="#Special-font-effects">Special font effects</a></li>
+<li><a href="#index-outline-fonts-526">outline fonts</a>: <a href="#Glyph-files">Glyph files</a></li>
+<li><a href="#index-output-file_002c-sectioning-of-445">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-297">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-redirecting-175">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-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-p-_0040r_007bconfig-command-_0028font-aliases_0029_007d-299"><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-303"><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-194">page range</a>: <a href="#Option-details">Option details</a></li>
+<li><a href="#index-page_002c-first-printed-190">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-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-PaintType-623"><code>PaintType</code></a>: <a href="#Special-font-effects">Special font effects</a></li>
+<li><a href="#index-Pantone-colors-672">Pantone colors</a>: <a href="#Color-macro-files">Color macro files</a></li>
+<li><a href="#index-paper-size-configuration-file-command-341">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-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-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-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-paper-size_002c-general-335">paper size, general</a>: <a href="#Paper-size-and-landscape">Paper size and landscape</a></li>
+<li><a href="#index-paper-trays-351">paper trays</a>: <a href="#Paper-trays">Paper trays</a></li>
+<li><a href="#index-paper-type-213">paper type</a>: <a href="#Option-details">Option details</a></li>
+<li><a href="#index-papersize-_0040r_007bspecial_007d-338"><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-221">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-661">partial font downloading</a>: <a href="#psfonts_002emap">psfonts.map</a></li>
+<li><a href="#index-PDF-files_002c-font-quality-491">PDF files, font quality</a>: <a href="#Hypertext-caveats">Hypertext caveats</a></li>
+<li><a href="#index-PDF-files_002c-making-478">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-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-PDF-files_002c-option-for-243">PDF files, option for</a>: <a href="#Option-details">Option details</a></li>
+<li><a href="#index-pdfmark-476"><code>pdfmark</code></a>: <a href="#Hypertext">Hypertext</a></li>
+<li><a href="#index-pfa-files-530">pfa files</a>: <a href="#Glyph-files">Glyph files</a></li>
+<li><a href="#index-pfb-files-531">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-523">pfm files</a>: <a href="#Metric-files">Metric files</a></li>
+<li><a href="#index-Phaser-printer_002c-used-for-color-calibration-682">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-463">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-_0040samp_007b_002dp_007d-191">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-466">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-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-334">portrait orientation, defined</a>: <a href="#Paper-size-and-landscape">Paper size and landscape</a></li>
+<li><a href="#index-pk-files-537">pk files</a>: <a href="#Glyph-files">Glyph files</a></li>
+<li><a href="#index-PKFONTS_0040r_007b_002c-overrides_007d-P-304"><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-453"><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-521"><code>pltotf</code></a>: <a href="#Metric-files">Metric files</a></li>
+<li><a href="#index-popen-_0040r_007bfor-output_007d-177"><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-337">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-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-507">PostScript fonts</a>: <a href="#PostScript-fonts">PostScript fonts</a></li>
+<li><a href="#index-post-_0040r_007bcode-after-headers_007d-435"><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-449">PostScript code, literal</a>: <a href="#Literal-PS">Literal PS</a></li>
+<li><a href="#index-PostScript-encoding-549">PostScript encoding</a>: <a href="#Encodings">Encodings</a></li>
+<li><a href="#index-PostScript-encoding_002c-changing-587">PostScript encoding, changing</a>: <a href="#Changing-PostScript-encodings">Changing PostScript encodings</a></li>
+<li><a href="#index-PostScript-font-alias-file-300">PostScript font alias file</a>: <a href="#Configuration-file-commands">Configuration file commands</a></li>
+<li><a href="#index-PostScript-font-alias-file-224">PostScript font alias file</a>: <a href="#Option-details">Option details</a></li>
+<li><a href="#index-PostScript-fonts-510">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-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-header-files-421">PostScript header files</a>: <a href="#Header-files">Header files</a></li>
+<li><a href="#index-PostScript-hooks-459">PostScript hooks</a>: <a href="#PostScript-hooks">PostScript hooks</a></li>
+<li><a href="#index-PostScript-interaction-358">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-358">PostScript units</a>: <a href="#Bounding-box">Bounding box</a></li>
+<li><a href="#index-PostScript-units-361">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-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-pre-_0040r_007bcode-before-headers_007d-434"><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-257"><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-290">printer memory</a>: <a href="#Configuration-file-commands">Configuration file commands</a></li>
+<li><a href="#index-printer-memory-293">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-offset-185">printer offset</a>: <a href="#Option-details">Option details</a></li>
+<li><a href="#index-PRINTER_0040r_007b_002c-and-config-file-searching_007d-267"><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-516">property list files</a>: <a href="#Metric-files">Metric files</a></li>
+<li><a href="#index-property-list-files-519">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-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-ps-_0040r_007bspecial_007d-451"><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-396"><code>psfile </code><span class="roman">special</span></a>: <a href="#psfile-special">psfile special</a></li>
+<li><a href="#index-psfonts_002emap-644"><code>psfonts.map</code></a>: <a href="#psfonts_002emap">psfonts.map</a></li>
+<li><a href="#index-psfonts_002emap-617"><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-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-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-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-psheaderdir-422"><code>psheaderdir</code></a>: <a href="#Header-files">Header files</a></li>
+<li><a href="#index-psi-character-missing-492">psi character missing</a>: <a href="#Hypertext-caveats">Hypertext caveats</a></li>
+<li><a href="#index-pstopk-232"><code>pstopk</code></a>: <a href="#Option-details">Option details</a></li>
+<li><a href="#index-p_0040TeX_007b_007d-extensions-171">pTeX extensions</a>: <a href="#Option-details">Option details</a></li>
+<li><a href="#index-Q-_0040r_007bconfig-command-_0028quiet_0029_007d-309"><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-308"><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-199">quiet operation</a>: <a href="#Option-details">Option details</a></li>
+<li><a href="#index-r-_0040r_007bconfig-command-_0028page-reversal_0029_007d-310"><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-311"><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-557"><code>reencode/*.enc</code></a>: <a href="#Encodings">Encodings</a></li>
+<li><a href="#index-reencoding-594">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-590"><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-595">remapping</a>: <a href="#Reencoding-with-Afm2tfm">Reencoding with Afm2tfm</a></li>
+<li><a href="#index-resident-fonts_002c-different-in-different-printers-301">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-225">resident fonts, different in different printers</a>: <a href="#Option-details">Option details</a></li>
+<li><a href="#index-resolution-236">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-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-reverse-pagination-203">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-409"><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-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-rotate_002etex-454"><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-410"><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-319"><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-318"><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-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-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-441">sections of output file, and memory</a>: <a href="#Headers-and-memory-usage">Headers and memory usage</a></li>
+<li><a href="#index-save_0040r_007b_002f_007drestore_0040r_007b_002c-and-literal-PS_007d-472"><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-452">save/restore, and specials</a>: <a href="#ps-special">ps special</a></li>
+<li><a href="#index-save_002frestore_002c-generating-global-210">save/restore, generating global</a>: <a href="#Option-details">Option details</a></li>
+<li><a href="#index-scaleunit-411"><code>scaleunit</code></a>: <a href="#psfile-special">psfile special</a></li>
+<li><a href="#index-scaling-of-figures-382">scaling of figures</a>: <a href="#EPSF-scaling">EPSF scaling</a></li>
+<li><a href="#index-scaling-small-caps-630">scaling small caps</a>: <a href="#Afm2tfm-options">Afm2tfm options</a></li>
+<li><a href="#index-Scandinavian-A-ring-599">Scandinavian A ring</a>: <a href="#Reencoding-with-Afm2tfm">Reencoding with Afm2tfm</a></li>
+<li><a href="#index-screen-frequencies_002c-setting-441">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-412"><code>SDict</code></a>: <a href="#psfile-special">psfile special</a></li>
+<li><a href="#index-SDict-_0040r_007bdictionary_007d-456"><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-263">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-444">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-security-205">security</a>: <a href="#Option-details">Option details</a></li>
+<li><a href="#index-shell-command-execution_002c-disabling-206">shell command execution, disabling</a>: <a href="#Option-details">Option details</a></li>
+<li><a href="#index-shell-escape_002c-in-config-file-280">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-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-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-show-_0040r_007bPostScript-operator_007d-560"><code>show </code><span class="roman">PostScript operator</span></a>: <a href="#PostScript-typesetting">PostScript typesetting</a></li>
+<li><a href="#index-silent-operation-200">silent operation</a>: <a href="#Option-details">Option details</a></li>
+<li><a href="#index-simplex-mode-on-duplex-printers-440">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-614">slanted fonts</a>: <a href="#Special-font-effects">Special font effects</a></li>
+<li><a href="#index-slanted-fonts_002c-making-638">slanted fonts, making</a>: <a href="#Afm2tfm-options">Afm2tfm options</a></li>
+<li><a href="#index-SlantFont-616"><code>SlantFont</code></a>: <a href="#Special-font-effects">Special font effects</a></li>
+<li><a href="#index-small-caps-fonts-621">small caps fonts</a>: <a href="#Special-font-effects">Special font effects</a></li>
+<li><a href="#index-Smith_002c-Arthur-497">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-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-spaces_002c-dropped-trailing-494">spaces, dropped trailing</a>: <a href="#Hypertext-caveats">Hypertext caveats</a></li>
+<li><a href="#index-specials_002c-hypertext-496">specials, hypertext</a>: <a href="#Hypertext-specials">Hypertext specials</a></li>
+<li><a href="#index-splines-528">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-spooling-to-lpr-on-MS_002dDOS-182">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-output_002c-output-to-176">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-459"><code>start-hook</code></a>: <a href="#PostScript-hooks">PostScript hooks</a></li>
+<li><a href="#index-start_002dhook-462"><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-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-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-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-system-_0040r_007bin-config-file_007d-278"><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-322"><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-683">Tektronix Phaser printer, used for color calibration</a>: <a href="#Color-device-configuration">Color device configuration</a></li>
+<li><a href="#index-testpage_002etex-186"><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-583">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-429">TeX, including headers in</a>: <a href="#Including-headers-from-TeX">Including headers from TeX</a></li>
+<li><a href="#index-TEXCONFIG-258"><code>TEXCONFIG</code></a>: <a href="#Environment-variables">Environment variables</a></li>
+<li><a href="#index-TEXFONTS_0040r_007b_002c-overrides_007d-P-307"><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-324"><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-321"><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-554"><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-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-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-texmital_002eenc-555"><code>texmital.enc</code></a>: <a href="#Encodings">Encodings</a></li>
+<li><a href="#index-texmsym_002eenc-585"><code>texmsym.enc</code></a>: <a href="#Changing-TeX-encodings">Changing TeX encodings</a></li>
+<li><a href="#index-texmsym_002eenc-556"><code>texmsym.enc</code></a>: <a href="#Encodings">Encodings</a></li>
+<li><a href="#index-TEXPICTS-260"><code>TEXPICTS</code></a>: <a href="#Environment-variables">Environment variables</a></li>
+<li><a href="#index-TEXPICTS_0040r_007b_002c-overrides_007d-S-320"><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-305"><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-316"><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-394">text in figures, chopped off</a>: <a href="#EPSF-clipping">EPSF clipping</a></li>
+<li><a href="#index-tfm-files-517">tfm files</a>: <a href="#Metric-files">Metric files</a></li>
+<li><a href="#index-TFMFONTS_0040r_007b_002c-overrides_007d-T-323"><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-520"><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-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-trademark-_0040r_007bcharacter_002c-accessing_007d-589"><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-493">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-646">transforming downloaded fonts</a>: <a href="#psfonts_002emap">psfonts.map</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-trouble-47">trouble</a>: <a href="#Diagnosing-problems">Diagnosing problems</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-Type-1-fonts-529">Type 1 fonts</a>: <a href="#Glyph-files">Glyph files</a></li>
+<li><a href="#index-typesetting-in-PostScript-558">typesetting in PostScript</a>: <a href="#PostScript-typesetting">PostScript typesetting</a></li>
+<li><a href="#index-U-_0040r_007bconfig-command-_0028Xerox-4045_0029_007d-325"><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-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-uncompressing-PostScript-415">uncompressing PostScript</a>: <a href="#Dynamic-creation-of-graphics">Dynamic creation of graphics</a></li>
+<li><a href="#index-uniform-resource-locator-498">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-343"><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-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="#papersize-special">papersize special</a></li>
+<li><a href="#index-URL_002c-definition-502">URL, definition</a>: <a href="#Hypertext-specials">Hypertext specials</a></li>
+<li><a href="#index-URL_002c-extended-for-_0040TeX_007b_007d-500">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-407"><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-408"><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-677">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-425"><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-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-V-_0040r_007bconfig-command-_0028vf-path_0029_007d-326"><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-381">verbose EPSF processing</a>: <a href="#EPSF-macros">EPSF macros</a></li>
+<li><a href="#index-vf-files-542">vf files</a>: <a href="#Virtual-fonts">Virtual fonts</a></li>
+<li><a href="#index-virtual-font-expansion-546">virtual font expansion</a>: <a href="#Virtual-fonts">Virtual fonts</a></li>
+<li><a href="#index-virtual-font-path-327">virtual font path</a>: <a href="#Configuration-file-commands">Configuration file commands</a></li>
+<li><a href="#index-virtual-fonts-541">virtual fonts</a>: <a href="#Virtual-fonts">Virtual fonts</a></li>
+<li><a href="#index-virtual-fonts_002c-creating-578">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-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-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-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-VMusage-446"><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-398"><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-543">vpl files</a>: <a href="#Virtual-fonts">Virtual fonts</a></li>
+<li><a href="#index-vptovf-573"><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-402"><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-400"><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-329"><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-330">warning messages, defining</a>: <a href="#Configuration-file-commands">Configuration file commands</a></li>
+<li><a href="#index-warnings_002c-suppressing-201">warnings, suppressing</a>: <a href="#Option-details">Option details</a></li>
+<li><a href="#index-whole-font-downloading-663">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-331"><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-227">Xerox 4045</a>: <a href="#Option-details">Option details</a></li>
+<li><a href="#index-Y-_0040r_007bconfig-command-_0028vertical-resolution_0029_007d-332"><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-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>
+<li><a href="#index-Z-_0040r_007bconfig-command-_0028compression_0029_007d-333"><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-334"><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-180"><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 ac9ce039a45..fe4bdee2e2f 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/dvipng.info b/Master/texmf/doc/info/dvipng.info
index 7e25b004068..5f5a66fef70 100644
--- a/Master/texmf/doc/info/dvipng.info
+++ b/Master/texmf/doc/info/dvipng.info
@@ -1,4 +1,5 @@
-This is dvipng.info, produced by makeinfo version 4.13 from dvipng.texi.
+This is ../../../../texk/dvipng/doc/dvipng.info, produced by makeinfo
+version 4.13 from ../../../../texk/dvipng/doc/dvipng.texi.
INFO-DIR-SECTION TeX
START-INFO-DIR-ENTRY
@@ -15,7 +16,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.12
+ This file documents dvipng version 1.13
Corrections or perhaps rewrites of sections are _very welcome_.
@@ -326,7 +327,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.12 Copyright 2002-2008 Jan-Ake Larsson
+ This is ./dvipng 1.13 Copyright 2002-2010 Jan-Ake Larsson
Usage: ./dvipng [OPTION]... FILENAME[.dvi]
Options are chosen to be similar to dvips' options where possible:
@@ -662,6 +663,9 @@ reversal, use `-r0'. Such options are marked with a trailing `*'.
Enable verbose operation. This will currently indicate what fonts
is used, in addition to the usual output.
+`--width*'
+ Report the width of the image. See also `--height' and `--depth'.
+
`-x NUM'
Set the x magnification ratio to NUM/1000. Overrides the
magnification specified in the DVI file. Must be between 10 and
@@ -941,13 +945,78 @@ improvements as the thing has evolved. These include but is perhaps not
limited to (in semi-random order): Thomas Esser (teTeX), Christian
Schenk (MIKTeX), Brian R Furry (debian package), Angus Leeming (LyX),
Thomas Boutell (libgd), John Jones (first user report), Uwe Kern
-(xcolor), Karl Berry (TeX Live), David Harvey (hinting in Freetype),
-Neal Harmon, Alan Shutko, Reiner Stieb, Nick Alcock, Adam Buchbinder,
-Svend Tollak Munkejord, James Longstreet, Bernhard Simon, Bob McElrath,
-Georg Schwarz, Jason Farmer, Brian V. Smith, Samuel Hathaway, Thomas R.
-Shemanske, Stephen Gibson, Christian Ridderstro"m, Ezra Peisach,
-William H Wheeler, Thomas Klausner, Harald Koenig, Adrian Bunk, Kevin
-Smith, Jason Riedy, Wolfram Krause, Reinhard Kotucha, and Takeshi Abe.
+(xcolor), Karl Berry and Peter Breitenlohner (TeX Live), David Harvey
+(hinting in Freetype), Neal Harmon, Alan Shutko, Reiner Stieb, Nick
+Alcock, Adam Buchbinder, Svend Tollak Munkejord, James Longstreet,
+Bernhard Simon, Bob McElrath, Georg Schwarz, Jason Farmer, Brian V.
+Smith, Samuel Hathaway, Thomas R. Shemanske, Stephen Gibson, Christian
+Ridderstro"m, Ezra Peisach, William H Wheeler, Thomas Klausner, Harald
+Koenig, Adrian Bunk, Kevin Smith, Jason Riedy, Wolfram Krause, Reinhard
+Kotucha, Takeshi Abe, and Waldeck Schutzer.
+
+ Use of the `gd' library requires inclusion of the following
+copyright notice, which applies to the `gd' library:
+
+ Portions copyright 1994, 1995, 1996, 1997, 1998, 1999, 2000, 2001,
+ 2002, 2003, 2004 by Cold Spring Harbor Laboratory. Funded under
+ Grant P41-RR02188 by the National Institutes of Health.
+
+ Portions copyright 1996, 1997, 1998, 1999, 2000, 2001, 2002, 2003,
+ 2004 by Boutell.Com, Inc.
+
+ Portions relating to GD2 format copyright 1999, 2000, 2001, 2002,
+ 2003, 2004 Philip Warner.
+
+ Portions relating to PNG copyright 1999, 2000, 2001, 2002, 2003,
+ 2004 Greg Roelofs.
+
+ Portions relating to gdttf.c copyright 1999, 2000, 2001, 2002,
+ 2003, 2004 John Ellson (ellson@graphviz.org).
+
+ Portions relating to gdft.c copyright 2001, 2002, 2003, 2004 John
+ Ellson (ellson@graphviz.org).
+
+ Portions relating to JPEG and to color quantization copyright
+ 2000, 2001, 2002, 2003, 2004, Doug Becker and copyright (C) 1994,
+ 1995, 1996, 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004 Thomas
+ G. Lane. This software is based in part on the work of the
+ Independent JPEG Group. See the file README-JPEG.TXT for more
+ information.
+
+ Portions relating to GIF compression copyright 1989 by Jef
+ Poskanzer and David Rowley, with modifications for thread safety
+ by Thomas Boutell.
+
+ Portions relating to GIF decompression copyright 1990, 1991, 1993
+ by David Koblas, with modifications for thread safety by Thomas
+ Boutell.
+
+ Portions relating to WBMP copyright 2000, 2001, 2002, 2003, 2004
+ Maurice Szmurlo and Johan Van den Brande.
+
+ Portions relating to GIF animations copyright 2004 Jaakko
+ Hyva"dtti (jaakko.hyvatti@iki.fi)
+
+ Permission has been granted to copy, distribute and modify gd in
+ any context without fee, including a commercial application,
+ provided that this notice is present in user-accessible supporting
+ documentation.
+
+ This does not affect your ownership of the derived work itself,
+ and the intent is to assure proper credit for the authors of gd,
+ not to interfere with your productive use of gd. If you have
+ questions, ask. "Derived works" includes all programs that utilize
+ the library. Credit must be given in user-accessible documentation.
+
+ This software is provided "AS IS." The copyright holders disclaim
+ all warranties, either express or implied, including but not
+ limited to implied warranties of merchantability and fitness for a
+ particular purpose, with respect to this code and accompanying
+ documentation.
+
+ Although their code does not appear in the current release, the
+ authors also wish to thank Hutchison Avenue Software Corporation
+ for their prior contributions.

File: dvipng.info, Node: Copying, Next: Index, Prev: Credits, Up: Top
@@ -971,7 +1040,7 @@ License along with this program. If not, see
-Copyright (C) 2002-2008 Jan-AAke Larsson
+Copyright (C) 2002-2010 Jan-AAke Larsson

File: dvipng.info, Node: Index, Prev: Copying, Up: Top
@@ -994,7 +1063,7 @@ Index
* command-line options: Command-line options.
(line 6)
* compilation: Installation. (line 6)
-* compression: Option details. (line 303)
+* compression: Option details. (line 306)
* configuration, of dvipng: Installation. (line 6)
* dark fonts: Option details. (line 119)
* debugging <1>: Diagnosing problems. (line 6)
@@ -1017,7 +1086,7 @@ Index
* invoking dvipng: Basic usage. (line 6)
* last page printed: Option details. (line 140)
* light fonts: Option details. (line 119)
-* magnification, overriding DVI: Option details. (line 295)
+* magnification, overriding DVI: Option details. (line 298)
* Metafont mode, specifying: Option details. (line 149)
* mktexpk, avoiding: Option details. (line 157)
* mode name, specifying: Option details. (line 149)
@@ -1051,33 +1120,34 @@ Index
* trouble: Diagnosing problems. (line 6)
* truecolor output: Option details. (line 284)
* warnings, suppressing: Option details. (line 238)
+* width reporting: Option details. (line 295)

Tag Table:
-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
+Node: Top353
+Node: Introduction1248
+Node: Installation3487
+Node: Prerequisites3834
+Node: Configure6324
+Node: Build/install8363
+Node: Installation outside the texmf tree8831
+Node: Advice for non-privileged users9538
+Node: Basic usage10546
+Node: Command-line options11673
+Node: Option summary12097
+Node: Option details14406
+Node: Graphics29868
+Node: Encapsulated PostScript30433
+Node: Bitmapped graphics31776
+Node: Color32976
+Node: Color specifications33364
+Node: Color specials34463
+Node: Diagnosing problems35875
+Node: Contact information36358
+Node: Debug options37099
+Node: Credits38134
+Node: Copying42135
+Node: Index42915

End Tag Table
diff --git a/Master/texmf/doc/info/dvips.info b/Master/texmf/doc/info/dvips.info
index 007024dca84..16c074cfc55 100644
--- a/Master/texmf/doc/info/dvips.info
+++ b/Master/texmf/doc/info/dvips.info
@@ -1,7 +1,7 @@
This is ../../../texk/dvipsk/dvips.info, produced by makeinfo version
4.13 from ../../../texk/dvipsk/dvips.texi.
-This manual documents Dvips version 5.98 (September 2009), a program to
+This manual documents Dvips version 5.99 (July 2010), a program to
translate a DVI file into PostScript. You may freely use, modify
and/or distribute this file.
@@ -18,7 +18,7 @@ File: dvips.info, Node: Top, Next: Why Dvips, Up: (dir)
Dvips
*****
-This manual documents Dvips version 5.98 (September 2009), a program to
+This manual documents Dvips version 5.99 (July 2010), a program to
translate a DVI file into PostScript. You may freely use, modify
and/or distribute this file.
@@ -109,11 +109,9 @@ File: dvips.info, Node: Installation, Next: Invoking Dvips, Prev: Why Dvips,
2 Installation
**************
-(A copy of this chapter is in the distribution file `dvipsk/INSTALL'.)
-
Installing Dvips is mostly the same as installing any Kpathsea-using
program. Therefore, for the basic steps involved, *note Installation:
-(kpathsea)Installation. (A copy is in the file `kpathsea/INSTALL'.)
+(kpathsea)Installation.
For solutions to common installation problems and information on how
to report a bug, see the file `kpathsea/BUGS' (*note Bugs:
@@ -180,7 +178,7 @@ pleasure:
% Partially download Type 1 fonts by default. Only reason not to do
% this is if you encounter bugs. (Please report them to
- % <tex-k@mail.tug.org> if you do.)
+ % <tex-k@tug.org> if you do.)
j
% Also look for fonts at these resolutions.
@@ -338,18 +336,16 @@ File: dvips.info, Node: Debug options, Next: No output, Up: Diagnosing proble
The `-d' flag to Dvips helps in tracking down certain errors. The
parameter to this flag is an integer that tells what errors are
currently being tracked. To track a certain class of debug messages,
-simply provide the appropriate number given below; if you wish to track
+specify the appropriate number given below; if you wish to track
multiple classes, sum the numbers of the classes you wish to track. To
-track all classes, you can use `-1'. Another useful value is `3650',
-which tracks everything having to do with file searching and opening.
-
- You can also set the environment variable `KPATHSEA_DEBUG' to any of
-these values.
+track all classes, you can use `-1'.
- Some of these debugging options are actually provided by Kpathsea
-(*note Debugging: (kpathsea)Debugging.).
+ You can also set the environment variable `KPATHSEA_DEBUG' instead
+of using `-d'. Some of these debugging options are actually provided
+by Kpathsea (*note Debugging: (kpathsea)Debugging.).
The classes are:
+
1
specials
@@ -372,24 +368,21 @@ these values.
files
128
- config files
+ (omitted)
256
- Partial Type 1 font encoding vectors
+ config files
512
- Partial Type 1 subr calls
-
-1024
Kpathsea `stat' calls
-2048
+1024
Kpathsea hash table lookups
-4096
+2048
Kpathsea path element expansion
-8192
+4096
Kpathsea path searches

@@ -588,7 +581,8 @@ Options:
-m* Manual feed -M* Don't make fonts
-mode s Metafont device name
-n # Maximum number of pages -N* No structured comments
--noomega Disable Omega extensions
+-noomega Disable Omega and pTeX extensions
+-noptex Disable pTeX extensions
-o f Output file -O c Set/change paper offset
-p # First page -P s Load config.$s
-pp l Print only pages listed
@@ -813,17 +807,26 @@ reversal, use `-r0'. Such options are marked with a trailing `*'.
movement, etc., in PostScript viewers such as Ghostview.
`-noomega'
- This will disable the use of Omega extensions when interpreting
- DVI files. By default, the additional opcodes `129' and `134' are
+ Disable the use of Omega and pTeX extensions when interpreting DVI
+ files. By default, the additional opcodes `129' and `134' are
recognized by Dvips as Omega extensions and interpreted as
- requests to set 2-byte characters. The only drawback is that the
- virtual font array will (at least temporarily) require 65536
- positions instead of the default 256 positions, i.e., the memory
- requirements of Dvips will be slightly larger. If you find this
- unacceptable or encounter another problem with the Omega
- extensions, you can switch this extension off by using `-noomega'
- (but please do send a bug report if you find such problems, *note
- Bugs: (kpathsea)Bugs.).
+ requests to set 2-byte characters.
+
+`-noptex'
+ Disable the use of pTeX extensions when interpreting DVI files. By
+ default, the additional opcodes `130' and `135' are recognized by
+ Dvips as Omega extensions and interpreted as requests to set
+ 3-byte characters, and `255' as request to change the typesetting
+ direction.
+
+ The only drawback is that the virtual font array will (at least
+ temporarily) require 65536 or more positions instead of the default
+ 256 positions, i.e., the memory requirements of Dvips will be
+ somewhat larger. If you find this unacceptable or encounter
+ another problem with the Omega or pTeX extensions, you can switch
+ off the pTeX extension by using `-noptex', or both by using
+ `-noomega' (but please do send a bug report if you find such
+ problems, *note Bugs: (kpathsea)Bugs.).
`-o NAME'
Send output to the file NAME. If `-o' is specified without NAME
@@ -2742,14 +2745,14 @@ interpreter in your printer if you use one of them in place of the
default encoding vector for a particular PostScript font.
Examples of encodings: the `dvips.enc' encoding file that comes with
-Dvips in the `reencode' 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, such as
-`ptmr.tfm'. The distribution includes many other encoding files; for
-example, `8r.enc', which is the base font for the current PostScript
-font distribution, and three corresponding to the TeX mathematics
-fonts: `texmext.enc' for math extensions, `texmital.enc' for math
-italics, and `texmsym.enc' for math symbols.
+the Fontname distribution (`http://tug.org/fontname') 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, such as `ptmr.tfm'. The distribution includes many other
+encoding files; for example, `8r.enc', which is the base font for the
+current PostScript font distribution, and three corresponding to the
+TeX mathematics fonts: `texmext.enc' for math extensions,
+`texmital.enc' for math italics, and `texmsym.enc' for math symbols.

File: dvips.info, Node: PostScript typesetting, Prev: Encodings, Up: Font concepts
@@ -3775,7 +3778,7 @@ Index
* Menu:
* ! special (literal PS header): Literal headers. (line 6)
-* ! starting output filename: Option details. (line 224)
+* ! starting output filename: Option details. (line 233)
* " special (literal PostScript): " special. (line 6)
* %%BoundingBox: Bounding box. (line 17)
* %%Page, and multi-page information: PostScript hooks. (line 37)
@@ -3790,7 +3793,7 @@ Index
* +PSMAPFILE: Configuration file commands.
(line 105)
* -: Option details. (line 11)
-* - as output filename: Option details. (line 224)
+* - as output filename: Option details. (line 233)
* --help <1>: Option details. (line 15)
* --help: Option summary. (line 7)
* --version: Option details. (line 18)
@@ -3822,46 +3825,47 @@ Index
* -N: Option details. (line 198)
* -n NUM: Option details. (line 195)
* -noomega: Option details. (line 206)
+* -noptex: Option details. (line 212)
* -O: Afm2tfm options. (line 41)
-* -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)
+* -o NAME: Option details. (line 228)
+* -O X-OFFSET,Y-OFFSET: Option details. (line 245)
+* -p [=]NUM: Option details. (line 263)
+* -P PRINTER: Option details. (line 277)
* -p PS-ENC <1>: Afm2tfm options. (line 46)
* -p PS-ENC: Changing PostScript encodings.
(line 6)
-* -pp FIRST-LAST: Option details. (line 263)
-* -pp RANGE: Option details. (line 263)
+* -pp FIRST-LAST: Option details. (line 272)
+* -pp RANGE: Option details. (line 272)
* -PPRINTER, and config file searching: Configuration file searching.
(line 27)
-* -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)
+* -q: Option details. (line 296)
+* -R: Option details. (line 303)
+* -r: Option details. (line 300)
+* -s: Option details. (line 311)
+* -S NUM: Option details. (line 318)
* -s SLANT: Afm2tfm options. (line 51)
* -T ENC-FILE: Changing both encodings.
(line 6)
-* -T HSIZE,VSIZE: Option details. (line 338)
-* -t PAPERTYPE: Option details. (line 314)
+* -T HSIZE,VSIZE: Option details. (line 347)
+* -t PAPERTYPE: Option details. (line 323)
* -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 353)
-* -u PSMAPFILE: Option details. (line 345)
-* -V: Option details. (line 364)
-* -v: Option details. (line 361)
+* -U: Option details. (line 362)
+* -u PSMAPFILE: Option details. (line 354)
+* -V: Option details. (line 373)
+* -v: Option details. (line 370)
* -V VPL-FILE: Afm2tfm options. (line 74)
* -v VPL-FILE: Afm2tfm options. (line 71)
-* -X NUM: Option details. (line 381)
-* -x NUM: Option details. (line 373)
-* -Y NUM: Option details. (line 388)
+* -X NUM: Option details. (line 390)
+* -x NUM: Option details. (line 382)
+* -Y NUM: Option details. (line 397)
* -z: Hypertext. (line 6)
-* -Z for compressing bitmap fonts: Option details. (line 397)
-* -z for recognizing hyperdvi: Option details. (line 391)
-* ..-relative filenames: Option details. (line 294)
+* -Z for compressing bitmap fonts: Option details. (line 406)
+* -z for recognizing hyperdvi: Option details. (line 400)
+* ..-relative filenames: Option details. (line 303)
* .afm Adobe metric files: Metric files. (line 26)
* .dvipsrc, searched for: Configuration file searching.
(line 14)
@@ -3916,15 +3920,15 @@ Index
(line 21)
* A ring, Scandinavian letter: Reencoding with Afm2tfm.
(line 32)
-* a3 papertype: Option details. (line 314)
+* a3 papertype: Option details. (line 323)
* a4 paper size: Config file paper sizes.
(line 84)
-* a4 papertype: Option details. (line 314)
+* a4 papertype: Option details. (line 323)
* A4size paper size: Config file paper sizes.
(line 92)
-* absolute filenames, disabling: Option details. (line 294)
+* absolute filenames, disabling: Option details. (line 303)
* absolute page number, and -l: Option details. (line 163)
-* absolute page number, and -p: Option details. (line 254)
+* absolute page number, and -p: Option details. (line 263)
* accents, in wrong position: Reencoding with Afm2tfm.
(line 32)
* accents, wrong: Afm2tfm options. (line 17)
@@ -3969,7 +3973,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 249)
+* bop-hook, and offset pages: Option details. (line 258)
* boundary character: Encoding file format.
(line 41)
* bounding box, comment for: Bounding box. (line 6)
@@ -4017,13 +4021,13 @@ Index
* compilation: Installation. (line 6)
* compressed PostScript: Dynamic creation of graphics.
(line 6)
-* compressing bitmap fonts: Option details. (line 397)
+* compressing bitmap fonts: Option details. (line 406)
* 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 268)
+* config.ps: Option details. (line 277)
* config.ps installation: config.ps installation.
(line 6)
* config.ps paper sizes: Config file paper sizes.
@@ -4079,7 +4083,7 @@ Index
(line 35)
* dictionary, SDict: Literal headers. (line 6)
* dictionary, userdict: Header files. (line 21)
-* distillation, and -z: Option details. (line 391)
+* distillation, and -z: Option details. (line 400)
* distiller, for PDF files: Hypertext. (line 11)
* dot accent: Reencoding with Afm2tfm.
(line 32)
@@ -4174,7 +4178,7 @@ Index
* 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 254)
+* first page printed: Option details. (line 263)
* font concepts: Font concepts. (line 6)
* font generation, avoiding: Option details. (line 184)
* fontinst: Invoking afm2tfm. (line 13)
@@ -4220,7 +4224,7 @@ Index
* gs installation: Ghostscript installation.
(line 6)
* gsave/grestore, and literal PS: Literal examples. (line 27)
-* gsftopk: Option details. (line 365)
+* gsftopk: Option details. (line 374)
* h header downloading config command: Configuration file commands.
(line 48)
* H header path config command: Configuration file commands.
@@ -4248,12 +4252,12 @@ 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 391)
+* html specials, and -z: Option details. (line 400)
* 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 391)
+* hyperdvi extensions, enabling: Option details. (line 400)
* hypertext and bitmap fonts: Hypertext caveats. (line 6)
* hypertext caveats: Hypertext caveats. (line 6)
* hypertext specials: Hypertext specials. (line 6)
@@ -4292,18 +4296,18 @@ Index
(line 18)
* landscape orientation, defined: Paper size and landscape.
(line 11)
-* landscape papertype: Option details. (line 314)
+* landscape papertype: Option details. (line 323)
* landscape, as \special: papersize special. (line 16)
* 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 127)
-* ledger papertype: Option details. (line 314)
-* legal papertype: Option details. (line 314)
+* ledger papertype: Option details. (line 323)
+* legal papertype: Option details. (line 323)
* letter paper size: Config file paper sizes.
(line 84)
-* letter papertype: Option details. (line 314)
+* letter papertype: Option details. (line 323)
* letterhead tray: Paper trays. (line 10)
* letterSize paper size: Config file paper sizes.
(line 92)
@@ -4321,7 +4325,7 @@ 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 224)
+* lpr spooler, MS-DOS emulation: Option details. (line 233)
* Lucida, installing: PostScript font installation.
(line 10)
* m config command (available memory): Configuration file commands.
@@ -4332,13 +4336,13 @@ Index
* 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 373)
-* magnification, vertical: Option details. (line 384)
+* magnification, overriding DVI: Option details. (line 382)
+* magnification, vertical: Option details. (line 393)
* mailcap and hypertext: Hypertext specials. (line 53)
* manual feed: Option details. (line 172)
* maxdrift: Option details. (line 71)
* maximum pages printed: Option details. (line 195)
-* media: Option details. (line 314)
+* media: Option details. (line 323)
* memory available: Configuration file commands.
(line 67)
* memory of printer exhausted: Printer errors. (line 14)
@@ -4366,7 +4370,7 @@ Index
(line 10)
* Monotype fonts, installing: PostScript font installation.
(line 19)
-* mtpk: Option details. (line 365)
+* mtpk: Option details. (line 374)
* multiple master fonts: psfonts.map. (line 60)
* multiple output files: Option details. (line 127)
* multiple paper trays: Paper trays. (line 6)
@@ -4388,7 +4392,7 @@ Index
(line 6)
* octal character codes: Afm2tfm options. (line 41)
* odd pages only: Option details. (line 27)
-* offset pages: Option details. (line 236)
+* offset pages: Option details. (line 245)
* Omega extensions: Option details. (line 206)
* option, details of: Option details. (line 6)
* options, debugging: Debug options. (line 6)
@@ -4406,14 +4410,14 @@ Index
* 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 219)
+* output, redirecting: Option details. (line 228)
* output, too small: Small or inverted. (line 6)
* p config command (font aliases): Configuration file commands.
(line 105)
* P config command (PK path): Configuration file commands.
(line 114)
-* page range: Option details. (line 263)
-* page, first printed: Option details. (line 254)
+* page range: Option details. (line 272)
+* page, first printed: Option details. (line 263)
* page, last printed: Option details. (line 163)
* pages, maximum printed: Option details. (line 195)
* PaintType: Special font effects.
@@ -4426,15 +4430,15 @@ Index
* paper size, general: Paper size and landscape.
(line 6)
* paper trays: Paper trays. (line 6)
-* paper type: Option details. (line 314)
+* paper type: Option details. (line 323)
* papersize special: papersize special. (line 6)
-* papersize special, and no -t: Option details. (line 314)
+* papersize special, and no -t: Option details. (line 323)
* 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 391)
+* PDF files, option for: Option details. (line 400)
* pdfmark: Hypertext. (line 6)
* pfa files: Glyph files. (line 25)
* pfb files: Glyph files. (line 25)
@@ -4443,7 +4447,7 @@ Index
* Phaser printer, used for color calibration: Color device configuration.
(line 18)
* physical page number, and -l: Option details. (line 163)
-* physical page number, and -p: Option details. (line 254)
+* physical page number, and -p: Option details. (line 263)
* physical page number, and bop-hook: PostScript hooks. (line 26)
* pipes, not readable: Option details. (line 98)
* pk files: Glyph files. (line 35)
@@ -4451,7 +4455,7 @@ Index
(line 114)
* plotfile, ps subspecial: ps special. (line 30)
* pltotf: Metric files. (line 39)
-* popen for output: Option details. (line 224)
+* popen for output: Option details. (line 233)
* portrait orientation, defined: Paper size and landscape.
(line 11)
* positioning accuracy: Option details. (line 71)
@@ -4463,7 +4467,7 @@ Index
(line 6)
* PostScript font alias file <1>: Configuration file commands.
(line 105)
-* PostScript font alias file: Option details. (line 345)
+* PostScript font alias file: Option details. (line 354)
* PostScript fonts: PostScript fonts. (line 6)
* PostScript fonts, installing: PostScript font installation.
(line 6)
@@ -4491,7 +4495,7 @@ Index
* printer memory: Configuration file commands.
(line 67)
* printer memory exhausted: Printer errors. (line 14)
-* printer offset: Option details. (line 236)
+* printer offset: Option details. (line 245)
* PRINTER, and config file searching: Configuration file searching.
(line 36)
* PRINTER, avoided with -f: Option details. (line 98)
@@ -4509,12 +4513,13 @@ Index
(line 24)
* psheaderdir: Header files. (line 12)
* psi character missing: Hypertext caveats. (line 55)
-* pstopk: Option details. (line 365)
+* pstopk: Option details. (line 374)
+* pTeX extensions: Option details. (line 206)
* Q config command (quiet): Configuration file commands.
(line 121)
* q config command (quiet): Configuration file commands.
(line 121)
-* quiet operation: Option details. (line 287)
+* quiet operation: Option details. (line 296)
* r config command (page reversal): Configuration file commands.
(line 124)
* R fallback resolution config command: Configuration file commands.
@@ -4530,10 +4535,10 @@ Index
* resident fonts, different in different printers <1>: Configuration file commands.
(line 105)
* resident fonts, different in different printers: Option details.
- (line 345)
-* resolution: Option details. (line 381)
+ (line 354)
+* resolution: Option details. (line 390)
* resolution, setting: Option details. (line 58)
-* reverse pagination: Option details. (line 291)
+* reverse pagination: Option details. (line 300)
* rhi (psfile special option): psfile special. (line 46)
* Rokicki, Tomas: Why Dvips. (line 68)
* rotate.tex: ps special. (line 34)
@@ -4545,7 +4550,7 @@ Index
* 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 302)
+* save/restore, generating global: Option details. (line 311)
* scaleunit: psfile special. (line 67)
* scaling of figures: EPSF scaling. (line 6)
* scaling small caps: Afm2tfm options. (line 33)
@@ -4560,14 +4565,14 @@ Index
* sections of output file, and memory: Headers and memory usage.
(line 6)
* sections output, in separate files: Option details. (line 127)
-* security: Option details. (line 294)
-* shell command execution, disabling: Option details. (line 294)
+* security: Option details. (line 303)
+* shell command execution, disabling: Option details. (line 303)
* 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 287)
+* silent operation: Option details. (line 296)
* simplex mode on duplex printers: Including headers from the command line.
(line 13)
* slanted fonts: Special font effects.
@@ -4586,10 +4591,10 @@ 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 224)
+* spooling to lpr on MS-DOS: Option details. (line 233)
* standard I/O: Option details. (line 98)
* standard input, reading options from: Option details. (line 11)
-* standard output, output to: Option details. (line 219)
+* standard output, output to: Option details. (line 228)
* standard PostScript, required by Ghostview: Ghostscript installation.
(line 17)
* start-hook: PostScript hooks. (line 11)
@@ -4600,7 +4605,7 @@ Index
(line 157)
* Tektronix Phaser printer, used for color calibration: Color device configuration.
(line 18)
-* testpage.tex: Option details. (line 243)
+* testpage.tex: Option details. (line 252)
* TeX encoding, changing: Changing TeX encodings.
(line 6)
* TeX, including headers in: Including headers from TeX.
@@ -4684,12 +4689,12 @@ Index
(line 171)
* warning messages, defining: Configuration file commands.
(line 171)
-* warnings, suppressing: Option details. (line 287)
+* warnings, suppressing: Option details. (line 296)
* whole font downloading: psfonts.map. (line 60)
* wide fonts: psfonts.map. (line 19)
* X config command (horizontal resolution): Configuration file commands.
(line 178)
-* Xerox 4045: Option details. (line 353)
+* Xerox 4045: Option details. (line 362)
* Y config command (vertical resolution): Configuration file commands.
(line 181)
* Y&Y fonts, installing: PostScript font installation.
@@ -4698,87 +4703,87 @@ Index
(line 184)
* z config command (secure mode): Configuration file commands.
(line 187)
-* | starting output filename: Option details. (line 224)
+* | starting output filename: Option details. (line 233)

Tag Table:
-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
+Node: Top559
+Node: Why Dvips1303
+Node: Installation4751
+Node: config.ps installation5772
+Node: PostScript font installation8309
+Node: Ghostscript installation11183
+Node: Diagnosing problems12280
+Node: Debug options13375
+Node: No output14401
+Node: Small or inverted15869
+Node: Printer errors16588
+Node: Long documents fail17920
+Node: Including graphics fails18261
+Node: Invoking Dvips19499
+Node: Basic usage20090
+Node: Command-line options21074
+Node: Option summary21523
+Node: Option details23728
+Node: Environment variables43094
+Node: Config files46053
+Node: Configuration file searching46736
+Node: Configuration file commands50036
+Node: Paper size and landscape57149
+Node: papersize special58747
+Node: Config file paper sizes60156
+Node: Paper trays64311
+Node: Interaction with PostScript65645
+Node: PostScript figures66298
+Node: Bounding box67024
+Node: \includegraphics70395
+Node: EPSF macros72686
+Node: EPSF scaling74656
+Node: EPSF clipping77226
+Node: psfile special77868
+Node: Dynamic creation of graphics80261
+Node: Fonts in figures81579
+Node: Header files83239
+Node: Including headers from TeX84445
+Node: Including headers from the command line86479
+Node: Headers and memory usage87579
+Node: Literal PS88289
+Node: " special88871
+Node: ps special89612
+Node: Literal headers91110
+Node: PostScript hooks91825
+Node: Literal examples93915
+Node: Hypertext95367
+Node: Hypertext caveats96925
+Node: Hypertext specials101322
+Node: PostScript fonts103956
+Node: Font concepts105072
+Node: Metric files106239
+Node: Glyph files109065
+Node: Virtual fonts111421
+Node: Encodings113311
+Node: PostScript typesetting115714
+Node: Making a font available118796
+Node: Invoking afm2tfm123826
+Node: Changing font encodings124796
+Node: Changing TeX encodings125586
+Node: Changing PostScript encodings126686
+Node: Changing both encodings128030
+Node: Reencoding with Afm2tfm128703
+Node: Encoding file format131807
+Node: Special font effects136010
+Node: Afm2tfm options138273
+Node: psfonts.map141258
+Node: Color145990
+Node: Color macro files147034
+Node: User-definable colors150232
+Node: Color subtleties151507
+Node: Ted Turner153158
+Node: Color device configuration154383
+Node: Color support details156825
+Node: Color specifications157203
+Node: Color specials158606
+Node: Index160735

End Tag Table
diff --git a/Master/texmf/doc/info/fontname.info b/Master/texmf/doc/info/fontname.info
index 14b93d87ea9..31c036daf62 100644
--- a/Master/texmf/doc/info/fontname.info
+++ b/Master/texmf/doc/info/fontname.info
@@ -12394,13 +12394,16 @@ B.5 `ec.enc': Cork encoding
===========================
% @@psencodingfile@{
-% date = "6jul08",
+% date = "24feb10",
% 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."
% @}
%
+% The original paper can be found on
+% https://www.tug.org/TUGboat/Articles/tb11-4/tb30ferguson.pdf
+%
% 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
@@ -12423,13 +12426,26 @@ B.5 `ec.enc': Cork encoding
% - /dotlessj = U+0237 - LATIN SMALL LETTER DOTLESS J
% - /cwm = U+200B - ZERO WIDTH SPACE
% - /visiblespace = U+2423 - OPEN BOX
+% and should probably better be labeled with uniXXXX notation
+% (though hardly any font has those glyphs anyway).
%
% 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
+% Hyphen character:
+% There are two character named "hyphen". The original article explains
+% the background of this decision (if one wanted to use a different
+% hyphenation character and still be able to use the dash). So the first
+% character should serve as "hyphen char" and the other one as "dash" in
+% compound words. The character 0x2D is supposed to be the hyphen char,
+% but since there used to be two characters of the same name in this
+% file for some time, the tools like afmtotfm have been confused and
+% remapped the hyphen char to 0x7F automatically. After the second
+% character's name was changed, hyphenation characters in existing
+% tfm fonts (generated with the old ec.enc) have disappeared, so the
+% second character has been renamed back to "hyphen". Anyone generating
+% tfm fonts is strongly encouraged to make a copy of this file, rename
+% it and change glyph names as required for their font.
%
% Other remarks:
% - /Eth = U+00D0 - LATIN CAPITAL LETTER ETH
@@ -12470,7 +12486,6 @@ B.5 `ec.enc': Cork encoding
% 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
@@ -12628,7 +12643,7 @@ B.5 `ec.enc': Cork encoding
/bar % 0x7C
/braceright % 0x7D
/asciitilde % 0x7E
-/hyphen.alt % 0x7F U+002D % U+????
+/hyphen % 0x7F U+002D (explicit "hyphen char")
/Abreve % 0x80 U+0102
/Aogonek % 0x81 U+0104
/Cacute % 0x82 U+0106
@@ -16089,16 +16104,16 @@ 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
+Node: groff721873
+Node: t5726807
+Node: qx734758
+Node: texmext776230
+Node: texmsym780086
+Node: texmital783269
+Node: texnansi786003
+Node: texnansx798422
+Node: xl2803771
+Node: xt2808758
+Node: General index813385

End Tag Table
diff --git a/Master/texmf/doc/info/kpathsea.info b/Master/texmf/doc/info/kpathsea.info
index 6850dccfb61..def0252034c 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.13 from
-kpathsea.texi.
+This is ../../../../texk/kpathsea/doc/kpathsea.info, produced by
+makeinfo version 4.13 from ../../../../texk/kpathsea/doc/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, 2009 Karl Berry & Olaf Weber.
+2005, 2007, 2008, 2009, 2010 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
@@ -39,8 +39,8 @@ Kpathsea library
****************
This manual documents how to install and use the Kpathsea library for
-filename lookup. It corresponds to version 5.0.0, released in
-June 2009.
+filename lookup. It corresponds to version 6.0.0, released in
+July 2010.
* Menu:
@@ -60,8 +60,8 @@ File: kpathsea.info, Node: Introduction, Next: Installation, Prev: Top, Up:
1 Introduction
**************
-This manual corresponds to version 5.0.0 of the Kpathsea library,
-released in June 2009.
+This manual corresponds to version 6.0.0 of the Kpathsea library,
+released in July 2010.
The library's fundamental purpose is to return a filename from a
list of directories specified by the user, similar to what shells do
@@ -454,7 +454,7 @@ before installation, or the installed `texmf.cnf', and remove the
*Note TeX directory structure: TeX directory structure, for a
description of the default arrangement of the input files that comprise
-the TeX system. The file `kpathsea/HIER' is a copy of that section.
+the TeX system.

File: kpathsea.info, Node: Default path generation, Prev: Default path features, Up: Changing search paths
@@ -1237,166 +1237,27 @@ File: kpathsea.info, Node: unixtex.ftp, Next: Reporting bugs, Prev: TeX direc
2.5 `unixtex.ftp': Obtaining TeX
================================
-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@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,
-Metafont, MetaPost, DVI processors for the X window system, PostScript,
-the PCL language in the HP LaserJet, and related programs. They are
-oriented towards building from the original sources, though some
-information on alternative packages is included in the last section.
-See also `http://www.tug.org/web2c/', the Web2c and Kpathsea home page.
-
- Please note that the Web2c distribution is a bare-bones distribution
-in source form, and building a complete installation from it is a
-non-trivial matter. For most uses, it is a better idea to install a
-distribution with pre-packaged binaries for your platform. The
-principal example of such a distribution is TeX Live
-(`http://www.tug.org/texlive/'), which is based on the Web2c sources.
-
- Please consider joining the TeX Users Group (TUG) or another user
-group of your choice to help support the maintenance and development of
-the programs you retrieve. See `http://www.tug.org/join.html' for
-information and the membership registration form, and
-`http://www.tug.org/usergroups.html' for a listing of all user groups.
-
- For actual installation instructions after obtaining the necessary
-sources, see *note Installation::. A copy is in the distribution file
-`kpathsea/INSTALL'.
+This is `ftp://ftp.tug.org/tex/unixtex.ftp', last updated 13 June 2010.
+Also available as `http://www.tug.org/unixtex.ftp'. Email
+<tex-k@tug.org> with comments or questions.
-* Menu:
-
-* Electronic distribution:: CTAN and so forth.
-* CD-ROM distribution::
-* Other TeX packages::
-
-
-File: kpathsea.info, Node: Electronic distribution, Next: CD-ROM distribution, Up: unixtex.ftp
-
-2.5.1 Electronic distribution
------------------------------
-
-In many places we refer to CTAN:. This is _both_ a host name and a
-directory name. Here are the primary locations:
-
- `ftp://ctan.tug.org/tex-archive/' (Vermont, USA)
- `ftp://ftp.dante.de/tex-archive/' (Germany)
- `ftp://ftp.tex.ac.uk/tex-archive/' (England)
-
-CTAN has many mirrors worldwide; see the top-level file
-`README.mirrors' from one of the sites above or see
-`http://www.tug.org/CTAN.sites'.
-
- You can also access CTAN via the World Wide Web, electronic mail, or
-NFS. The same `README.mirrors' file explains how.
-
- 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):
-
-`CTAN:/systems/web2c/web.tar.gz'
- The original WEB source files, written primarily by Don Knuth.
- Required unless you already have this `web' version. (The WEB
- sources change irregularly with respect to Web2c itself.) Unpacks
- into `web2c-VERSION'.
-
-`CTAN:/systems/web2c/web2c.tar.gz'
- The Web2c system. Required. Also unpacks into `web2c-VERSION'.
-
-`CTAN:/systems/web2c/web2c-etex.tar.gz'
- Additions to the Web2c system for building e-TeX. Optional.
- Unpacks into `web2c-VERSION'.
-
-`CTAN:/systems/web2c/etexlib.tar.gz'
- Additions to the texmf tree needed to build e-TeX. Optional.
- Unpacks into `texmf/'.
-
-`CTAN:/systems/web2c/etexdoc.tar.gz'
- Documentation for e-TeX as an addition to the texmf tree.
- Optional. Unpacks into `texmf/'.
-
-`CTAN:/systems/web2c/web2c-omega.tar.gz'
- Additions to the Web2c system for building Omega. Optional.
- Unpacks into `web2c-VERSION'.
-
-`CTAN:/systems/web2c/omegalib.tar.gz'
- Additions to the texmf tree needed to build Omega. Optional.
- Unpacks into `texmf/'.
-
-`CTAN:/systems/web2c/omegadoc.tar.gz'
- Documentation for Omega as an addition to the texmf tree.
- Optional. Unpacks into `texmf/'.
-
-`CTAN:/systems/web2c/web2c-pdftex.tar.gz'
- Additions to the Web2c system for building pdfTeX. Optional.
- Unpacks into `web2c-VERSION'.
-
-`CTAN:/systems/web2c/pdftexlib.tar.gz'
- Additions to the texmf tree needed to build pdfTeX. Optional.
- Unpacks into `texmf/'.
-
-`CTAN:/dviware/xdvik/xdvik.tar.gz'
- X window system DVI previewer. Unpacks into `xdvik-VERSION'.
- Optional.
-
- Additional drivers, macro files, and other support are needed to
-build a working system. These are available in teTeX.
-
- All that said, the originating host for the software above is
-`ftp.tug.org'. You can retrieve these distributions (but not much
-else) from the `tex/' directory on that host.
-
-
-File: kpathsea.info, Node: CD-ROM distribution, Next: Other TeX packages, Prev: Electronic distribution, Up: unixtex.ftp
-
-2.5.2 CD-ROM distribution
--------------------------
-
-Numerous organizations distribute various TeX CD-ROM's (and DVD's):
-
- * Virtually all the TeX user groups collaborate to produce the `TeX
- Live' distribution once a year; see `http://www.tug.org/texlive/'
- for more information.
-
- * The Free Software Foundation's `Source Code CD-ROM' contains the
- minimal TeX source distribution described in the previous section
- (i.e., enough to print GNU documentation); email <gnu@gnu.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@tug.org>.
-
-
-File: kpathsea.info, Node: Other TeX packages, Prev: CD-ROM distribution, Up: unixtex.ftp
-
-2.5.3 Other TeX packages
-------------------------
+ The principal free TeX distribution for Unix-like systems is TeX
+Live, `http://tug.org/texlive'. Its web pages describe many ways to
+acquire TeX, over the Internet or on physical media, both the sources
+and precompiled binaries for many systems, either standalone or as part
+of various operating system distributions.
-Many other TeX implementations are available in `CTAN:/systems',
-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 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!)
+ Web2C, Kpathsea, Dvips, and Dviljk are no longer released as a
+separate packages. Their sources are now maintained as part of TeX
+Live.
- 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.
-
- The host labrea.stanford.edu is the original source for the files
+ The host ftp.cs.stanford.edu is the original source for the files
for which Donald Knuth is directly responsible: `tex.web', `plain.tex',
etc. However, unless you want to build your TeX library tree ab initio,
-it is more reliable and less work to retrieve these files as part of
-the above packages. In any case, labrea is not the canonical source for
-anything except what was created by Stanford TeX project, so do not
-rely on all the files available at that ftp site being up-to-date.
+it is more reliable and less work to retrieve these files as part of a
+larger package. In any case, that ftp site is not the canonical source
+for anything except what was created as part of Stanford TeX project,
+so do not rely on the other files available there being up-to-date.

File: kpathsea.info, Node: Reporting bugs, Prev: unixtex.ftp, Up: Installation
@@ -1874,7 +1735,7 @@ 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 C doesn't guarantee that it will. It it known to fail on HP-UX 10
-mchines when the native compiler is used, unless the `+u' compiler
+machines when the native compiler is used, unless the `+u' compiler
switch was specified. Using GCC will work on this platform as well.

@@ -1890,7 +1751,8 @@ looks something like this:
prompt$ ./configure
...
creating Makefile
- sed: 1: "\\@^ac_include make/pat ...": \ can not be used as a string delimiter
+ sed: 1: "\\@^ac_include make/pat ...": \ can not
+ be used as a string delimiter
So far as I know, the bug here is in `/bin/sh' on these systems. I
don't have access to a machine running any of them, so if someone can
@@ -2613,6 +2475,7 @@ in administrative scripts. It is used heavily in the distributed
`mktex...' scripts.
Synopsis:
+
kpsewhich OPTION... FILENAME...
The options and filename(s) to look up can be intermixed. Options
@@ -2678,9 +2541,14 @@ filename, and returns the first file found.
suffixes. *Note Supported file formats::, for more information on
each of these.
+ The strings in parentheses are abbreviations recognized only by
+ `kpsewhich' (not the underlying library calls). They are provided
+ when it would otherwise require an argument containing a space to
+ specify the format, to simplify quoting of calls from shells.
+
gf: gf
pk: pk
- bitmap font:
+ bitmap font (bitmapfont):
tfm: .tfm
afm: .afm
base: .base
@@ -2696,42 +2564,45 @@ filename, and returns the first file found.
mft: .mft
mp: .mp
mppool: .pool
- MetaPost support:
+ MetaPost support (mpsupport):
ocp: .ocp
ofm: .ofm .tfm
- opl: .opl
+ opl: .opl .pl
otp: .otp
- ovf: .ovf
- ovp: .ovp
+ ovf: .ovf .vf
+ ovp: .ovp .vpl
graphic/figure: .eps .epsi
tex: .tex .sty .cls .fd .aux .bbl .def .clo .ldf
- TeX system documentation:
+ TeX system documentation (doc):
texpool: .pool
- TeX system sources: .dtx .ins
+ TeX system sources (source): .dtx .ins
PostScript header: .pro
- Troff fonts:
+ Troff fonts (trofffont):
type1 fonts: .pfa .pfb
vf: .vf
- dvips config:
+ dvips config (dvipsconfig):
ist: .ist
truetype fonts: .ttf .ttc .TTF .TTC
type42 fonts: .t42 .T42
- web2c files:
- other text files:
- other binary files:
- misc fonts:
+ web2c files (web2c):
+ other text files (othertext):
+ other binary files (otherbin):
+ misc fonts (miscfont):
web: .web .ch
cweb: .w .web .ch
enc files: .enc
- cmap files:
+ cmap files (cmap):
subfont definition files: .sfd
opentype fonts: .otf
- pdftex config:
+ pdftex config (pdftexconfig):
lig files: .lig
texmfscripts:
lua: .luc .luctex .texluc .lua .luatex .texlua
font feature files: .fea
cid maps: .cid .cidmap
+ mlbib: .mlbib .bib
+ mlbst: .mlbst .bst
+ clua: .dll .so
This option and `--path' are mutually exclusive.
@@ -2739,12 +2610,12 @@ filename, and returns the first file found.
After processing the command line, read additional filenames to
look up from standard input.
-`-mktex=FILETYPE'
-`-no-mktex=FILETYPE'
- Turn on or off the `mktex' script associated with FILETYPE. The
- only values that make sense for FILETYPE are `pk', `mf', `tex',
- and `tfm'. By default, all are off in Kpsewhich. *Note mktex
- scripts::.
+`--mktex=FILETYPE'
+`--no-mktex=FILETYPE'
+ Turn on or off the `mktex' script associated with FILETYPE. Usual
+ values for FILETYPE are `pk', `mf', `tex', and `tfm'. By default,
+ all are off in Kpsewhich, even if they are enabled for TeX. This
+ option implies setting `--must-exist'. *Note mktex scripts::.
`--mode=STRING'
Set the mode name to STRING; this also only affects `gf' and `pk'
@@ -2753,8 +2624,8 @@ filename, and returns the first file found.
`--must-exist'
Do everything possible to find the files, notably including
- searching the disk. By default, only the `ls-R' database is
- checked, in the interest of efficiency.
+ searching the disk and running the `mktex' scripts. By default,
+ only the `ls-R' database is checked, in the interest of efficiency.
`--path=STRING'
Search along the path STRING (colon-separated as usual), instead
@@ -2770,6 +2641,13 @@ filename, and returns the first file found.
affect the search paths via the `.PROGNAM' feature in
configuration files (*note Config files::).
+`--safe-in-name=NAME'
+`--safe-out-name=NAME'
+ Exit successfully if NAME is safe to open for reading or writing,
+ respectively, else unsuccessfully. No output is written. These
+ tests take account of the related Kpathsea configuration settings
+ (*note Calling sequence::).
+
`--subdir=STRING'
Report only those matches whose directory part _ends_ with STRING
(compared literally, except case is ignored on a case-insensitive
@@ -2828,9 +2706,8 @@ filename, and returns the first file found.
one you are interested in.
We only match at the end because a site might happen to install TeX
- in `/some/coincidental/pkg1/path/', and we wouldn't want
- `texmf-dist/scripts/pkg2/' to match that when searching for
- `/pkg1'.
+ in `/some/coincidental/pkg1/path/', and we wouldn't want to match
+ `texmf-dist/scripts/pkg2/' that when searching for `/pkg1'.

@@ -2939,9 +2816,11 @@ File: kpathsea.info, Node: Standard options, Prev: Auxiliary tasks, Up: Invok
Kpsewhich accepts the standard GNU options:
- * `--help' prints a help message on standard output and exits.
+ * `--help' prints a help message on standard output and exits
+ successfully.
- * `--version' prints the Kpathsea version number and exits.
+ * `--version' prints the Kpathsea version number and exits
+ successfully.

File: kpathsea.info, Node: TeX support, Next: Programming, Prev: Path searching, Up: Top
@@ -3153,7 +3032,7 @@ environment variables with an underscore, e.g., `TEXINPUTS_latex'
`texmfscripts'
(Architecture-independent executables distributed in the texmf
- tree) `TEXMFSCRIPTS'.
+ trees) `TEXMFSCRIPTS'.
`texpool'
(TeX program strings, *note pooltype invocation: (web2c)pooltype
@@ -3256,9 +3135,9 @@ 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 `kpathsea_find_file' in
-`kpathsea/tex-file.c'. You can watch it in action with the debugging
-options (*note Debugging::).
+ This algorithm is implemented in the function `kpathsea_find_file'
+in the source file `kpathsea/tex-file.c'. You can watch it in action
+with the debugging options (*note Debugging::).

File: kpathsea.info, Node: Glyph lookup, Next: Suppressing warnings, Prev: File lookup, Up: TeX support
@@ -3595,7 +3474,32 @@ this:
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
+ 9. TeX can write output files, via the `\openout' primitive; this
+ opens a security hole vulnerable to Trojan horse attack: an
+ unwitting user could run a TeX program that overwrites, say,
+ `~/.rhosts'. Analogous security holes exist for many other
+ programs. To alleviate this, there is a configuration variable
+ `openout_any', which selects one of three levels of security.
+ When it is set to `a' (for "any"), no restrictions are imposed.
+ When it is set to `r' (for "restricted"), filenames beginning with
+ `.' are disallowed (except `.tex' because LaTeX needs it). When
+ it is set to `p' (for "paranoid") additional restrictions are
+ imposed: an absolute filename must refer to a file in (a
+ subdirectory) of `TEXMFOUTPUT', and any attempt to go up a
+ directory level is forbidden (that is, paths may not contain a
+ `..' component). The paranoid setting is the default. (For
+ backwards compatibility, `y' and `1' are synonyms of `a', while
+ `n' and `0' are synonyms for `r'.) The function
+ `kpathsea_out_name_ok', with a filename as second argument,
+ returns `true' if that filename is acceptable to be opend for
+ output or `false' otherwise.
+
+ 10. Similarly, the function `kpathsea_in_name_ok', with a filename as
+ second argument, returns `true' if that filename is acceptable to
+ be opend for input or `false' otherwise, depending on the value of
+ the configuration variable `openin_any' (with `a' as default).
+
+ 11. 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.
@@ -3608,10 +3512,10 @@ calls, etc. (Perhaps someday I'll move the former to a separate
library.)
The `c-*.h' 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
-`ftp://prep.ai.mit.edu/pub/gnu/'.
+different systems. You will almost certainly want to use Autoconf and
+probably Automake for configuring and building your software if you use
+Kpathsea; I strongly recommend using Autoconf and Automake regardless.
+They are available from `ftp://ftp.gnu.og/pub/gnu/'.

File: kpathsea.info, Node: Program-specific files, Next: Programming with config files, Prev: Calling sequence, Up: Programming
@@ -3625,12 +3529,12 @@ directories. The Standard TeX directory structure (*note Introduction:
(tds)Top.), specifies that such files should go into a subdirectory
named after the program, like `texmf/ttf2pk'.
- Two special formats, `kpse_program_text_format' and
-`kpse_program_binary_format' exist, which use `.:$TEXMF/PROGRAM//' as
-their compiled-in search path. To override this default, you can use
-the variable `PROGRAMINPUTS' in the environment and/or `texmf.cnf'.
-That is to say, the name of the variable is constructed by converting
-the name of the program to upper case, and appending `INPUTS'.
+ Two formats, `kpse_program_text_format' and
+`kpse_program_binary_format', use `.:$TEXMF/PROGRAM//' as their
+compiled-in search path. To override this default, you can use the
+variable `PROGRAMINPUTS' in the environment and/or `texmf.cnf'. 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
`kpathsea_open_file' will open the files it finds in text or binary
@@ -3697,22 +3601,30 @@ Index
(line 38)
* --help: Standard options. (line 8)
* --interactive: Path searching options.
- (line 110)
+ (line 118)
+* --mktex=FILETYPE: Path searching options.
+ (line 123)
* --mode=STRING: Path searching options.
- (line 121)
+ (line 129)
* --must-exist: Path searching options.
- (line 126)
+ (line 134)
+* --no-mktex=FILETYPE: Path searching options.
+ (line 123)
* --path=STRING: Path searching options.
- (line 131)
+ (line 139)
* --progname=NAME: Path searching options.
- (line 140)
+ (line 148)
+* --safe-in-name=NAME: Path searching options.
+ (line 154)
+* --safe-out-name=NAME: Path searching options.
+ (line 154)
* --show-path=NAME: Auxiliary tasks. (line 41)
* --srcdir, for building multiple architectures: configure scenarios.
(line 18)
* --subdir=STRING: Path searching options.
- (line 145)
+ (line 160)
* --var-value=VARIABLE: Auxiliary tasks. (line 12)
-* --version: Standard options. (line 10)
+* --version: Standard options. (line 11)
* --with options: configure options. (line 16)
* --with-mktextex-default: mktex configuration. (line 12)
* --without-mktexfmt-default: mktex configuration. (line 12)
@@ -3730,10 +3642,6 @@ Index
* -dynamic: ShellWidgetClass. (line 43)
* -g, compiling without: configure scenarios. (line 32)
* -L option to ls: ls-R. (line 38)
-* -mktex=FILETYPE: Path searching options.
- (line 115)
-* -no-mktex=FILETYPE: Path searching options.
- (line 115)
* -O, compiling with: configure scenarios. (line 32)
* -static: ShellWidgetClass. (line 43)
* . directories, ignored: ls-R. (line 33)
@@ -3844,7 +3752,6 @@ Index
* absolute filenames: Searching overview. (line 52)
* ac_include, Autoconf extension: Running configure. (line 6)
* access warnings: Searching overview. (line 56)
-* Acorn TeX implementations: Other TeX packages. (line 6)
* AFMFONTS: Supported file formats.
(line 20)
* AFS: Installing files. (line 32)
@@ -3859,7 +3766,6 @@ Index
* alphabetical order, not: Subdirectory expansion.
(line 6)
* Amiga support: Custom installation. (line 19)
-* Amiga TeX implementations: Other TeX packages. (line 6)
* Andrew File System, installing with: Installing files. (line 32)
* announcement mailing list: Mailing lists. (line 6)
* ANSI C: TeX or Metafont failing.
@@ -3875,7 +3781,7 @@ Index
(line 6)
* argv[0]: Calling sequence. (line 14)
* ash, losing with configure: configure shells. (line 19)
-* autoconf, recommended: Calling sequence. (line 94)
+* autoconf, recommended: Calling sequence. (line 119)
* automounter, and configuration: configure scenarios. (line 29)
* automounter, and ls-R: ls-R. (line 40)
* auxiliary tasks: Auxiliary tasks. (line 6)
@@ -3883,16 +3789,12 @@ Index
* Babel: Kpathsea application distributions.
(line 28)
* Bach, Johann Sebastian: Default expansion. (line 41)
-* backbone of CTAN: Electronic distribution.
- (line 6)
* backslash-newline: Config files. (line 31)
* bash, recommended for running configure: configure shells. (line 6)
* basic glyph lookup: Basic glyph lookup. (line 6)
* Berry, Karl: History. (line 12)
* BIBINPUTS: Supported file formats.
(line 28)
-* binary mode, for file transfers: Electronic distribution.
- (line 20)
* blank lines, in texmf.cnf: Config files. (line 29)
* brace expansion: Brace expansion. (line 6)
* BSD universe: Running make. (line 44)
@@ -3903,7 +3805,7 @@ 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 94)
+* c-*.h: Calling sequence. (line 119)
* c-auto.h: Programming overview.
(line 33)
* c-auto.in: Running configure. (line 6)
@@ -3915,7 +3817,6 @@ Index
(line 6)
* cc, compiling with: configure environment.
(line 11)
-* CD-ROM distributions: CD-ROM distribution. (line 6)
* CFLAGS: configure environment.
(line 14)
* ChangeLog entry: Bug checklist. (line 55)
@@ -3985,10 +3886,6 @@ Index
* CPPFLAGS: configure environment.
(line 22)
* crashes, reporting: Bug checklist. (line 61)
-* CTAN, defined: Electronic distribution.
- (line 6)
-* CTAN.sites: Electronic distribution.
- (line 13)
* custom installation: Custom installation. (line 6)
* CWEBINPUTS: Supported file formats.
(line 43)
@@ -4032,9 +3929,6 @@ Index
(line 6)
* distributions, not compiling: Kpathsea application distributions.
(line 6)
-* distributions, on CD-ROM: CD-ROM distribution. (line 6)
-* distributions, via ftp: Electronic distribution.
- (line 6)
* dlclose: dlopen. (line 6)
* dlopen: dlopen. (line 6)
* dlsym: dlopen. (line 6)
@@ -4043,7 +3937,6 @@ Index
(line 173)
* DOS compatible names: mktex configuration. (line 69)
* DOS support: Custom installation. (line 19)
-* DOS TeX implementations: Other TeX packages. (line 6)
* dosnames: mktex configuration. (line 68)
* dot files: ls-R. (line 33)
* doubled colons: Default expansion. (line 6)
@@ -4066,8 +3959,6 @@ Index
* EC fonts, and dynamic source creation: mktex scripts. (line 6)
* elt-dirs.c: Subdirectory expansion.
(line 41)
-* email CTAN access: Electronic distribution.
- (line 17)
* enabling mktex scripts: mktex configuration. (line 6)
* ENCFONTS: Supported file formats.
(line 51)
@@ -4144,12 +4035,9 @@ Index
(line 224)
* fopen, redefined: Debugging. (line 54)
* format of external database: Database format. (line 6)
-* Free Software Foundation: CD-ROM distribution. (line 12)
* FreeBSD configure error: Empty Makefiles. (line 6)
* FreeBSD shells and configure: configure shells. (line 19)
-* FSF Source Code CD-ROM: CD-ROM distribution. (line 12)
-* ftp retrieval: Electronic distribution.
- (line 6)
+* ftp.cs.stanford.edu: unixtex.ftp. (line 20)
* ftp.tug.org: unixtex.ftp. (line 6)
* fundamental purpose of Kpathsea: Introduction. (line 6)
* gcc, compiling with: configure environment.
@@ -4176,11 +4064,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 87)
+* hash table routines: Calling sequence. (line 112)
* hash_summary_only variable for debugging: Debugging. (line 105)
* help, mailing list for general TeX: Mailing lists. (line 25)
-* HIER: Default path features.
- (line 41)
* history of Kpathsea: History. (line 6)
* home directories in paths: Tilde expansion. (line 6)
* HOME, as ~ expansion: Tilde expansion. (line 6)
@@ -4193,7 +4079,7 @@ Index
* INDEXSTYLE: Supported file formats.
(line 74)
* info-tex@shsu.edu: Mailing lists. (line 25)
-* input lines, reading: Calling sequence. (line 87)
+* input lines, reading: Calling sequence. (line 112)
* install-data Make target: Installing files. (line 28)
* install-exec Make target: Installing files. (line 23)
* installation: Installation. (line 6)
@@ -4209,16 +4095,13 @@ Index
* installation, simple: Simple installation. (line 6)
* installing files: Installing files. (line 6)
* interactive query: Path searching options.
- (line 110)
+ (line 118)
* interface, not frozen: Introduction. (line 27)
* introduction: Introduction. (line 6)
* kdebug:: Debugging. (line 105)
* kdefault.c: Default expansion. (line 48)
* Knuth, Donald E.: History. (line 6)
-* Knuth, Donald E., archive of programs by: Other TeX packages.
- (line 18)
-* Knuth, Donald E., original author: Electronic distribution.
- (line 25)
+* Knuth, Donald E., archive of programs by: unixtex.ftp. (line 20)
* Korn shell, losing with configure: configure shells. (line 14)
* kpathsae_var_value: Programming with config files.
(line 10)
@@ -4227,8 +4110,6 @@ Index
(line 6)
* kpathsea.h: Programming overview.
(line 24)
-* kpathsea/HIER: Default path features.
- (line 41)
* kpathsea/README.CONFIGURE: Running configure. (line 15)
* kpathsea_cnf_get: Programming with config files.
(line 23)
@@ -4237,11 +4118,13 @@ Index
* 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_finish: Calling sequence. (line 107)
+* kpathsea_in_name_ok: Calling sequence. (line 102)
* 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_out_name_ok: Calling sequence. (line 82)
* kpathsea_set_program_name: Calling sequence. (line 14)
* KPATHSEA_WARNING: Config files. (line 18)
* kpse->debug: Debugging. (line 6)
@@ -4265,7 +4148,6 @@ Index
* kpsewhich: Invoking kpsewhich. (line 6)
* Kpsewhich, and debugging: Debugging. (line 31)
* ksh, losing with configure: configure shells. (line 14)
-* labrea.stanford.edu: Other TeX packages. (line 18)
* LaserJet drive: Kpathsea application distributions.
(line 13)
* last-resort font: Fallback font. (line 6)
@@ -4288,10 +4170,9 @@ Index
* license for using the library: Introduction. (line 31)
* LIGFONTS: Supported file formats.
(line 78)
-* lines, reading arbitrary-length: Calling sequence. (line 87)
+* lines, reading arbitrary-length: Calling sequence. (line 112)
* Linux File System Standard: mktex configuration. (line 114)
* Linux shells and configure: configure shells. (line 19)
-* Linux, using Web2c: CD-ROM distribution. (line 16)
* lndir for building symlink trees: configure scenarios. (line 18)
* loader options: configure environment.
(line 39)
@@ -4309,7 +4190,6 @@ Index
* ls-R database file: ls-R. (line 6)
* ls-R, simplest build: ls-R. (line 18)
* Mach10 configure error: Empty Makefiles. (line 6)
-* Macintosh TeX implementations: Other TeX packages. (line 6)
* MacKenzie, David <1>: Subdirectory expansion.
(line 22)
* MacKenzie, David: History. (line 45)
@@ -4324,7 +4204,7 @@ Index
* MAKETEX_FINE_DEBUG (1024): Debugging. (line 100)
* MAKETEX_MODE: Default path features.
(line 19)
-* memory allocation routines: Calling sequence. (line 87)
+* memory allocation routines: Calling sequence. (line 112)
* metafont driver files: mktex configuration. (line 94)
* Metafont failures: TeX or Metafont failing.
(line 6)
@@ -4342,8 +4222,6 @@ Index
(line 99)
* MFTINPUTS: Supported file formats.
(line 103)
-* mirrors, FTP: Electronic distribution.
- (line 13)
* MISCFONTS: Supported file formats.
(line 107)
* mismatched checksum warnings: Suppressing warnings.
@@ -4401,8 +4279,6 @@ Index
* NeXT, lacking X11: Kpathsea application distributions.
(line 6)
* NFS and ls-R: ls-R. (line 40)
-* NFS CTAN access: Electronic distribution.
- (line 17)
* nomfdrivers: mktex configuration. (line 93)
* nomode: mktex configuration. (line 98)
* non-English typesetting: Kpathsea application distributions.
@@ -4413,9 +4289,6 @@ Index
* 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 127)
* OFMFONTS: Supported file formats.
@@ -4432,7 +4305,6 @@ Index
* options for debugging: Debugging. (line 6)
* options to configure: configure options. (line 16)
* OS/2 support: Custom installation. (line 19)
-* other TeX distributions: Other TeX packages. (line 6)
* OTPINPUTS: Supported file formats.
(line 141)
* overview of path searching: Searching overview. (line 6)
@@ -4488,7 +4360,6 @@ Index
* PostScript fonts, additional: Simple installation. (line 60)
* precompiled executables, instead of installation: Simple installation.
(line 6)
-* precompiled Unix binaries: Other TeX packages. (line 13)
* preprocessor options: configure environment.
(line 32)
* preprocessor options, additional: Running make. (line 24)
@@ -4516,10 +4387,8 @@ Index
(line 16)
* readable: Suppressing warnings.
(line 26)
-* reading arbitrary-length lines: Calling sequence. (line 87)
+* reading arbitrary-length lines: Calling sequence. (line 112)
* README.CONFIGURE: Running configure. (line 15)
-* README.mirrors: Electronic distribution.
- (line 13)
* recording successful searches: Logging. (line 6)
* relative filenames: Searching overview. (line 52)
* relative filenames in ls-R: Installing files. (line 40)
@@ -4583,7 +4452,7 @@ Index
* 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 87)
+* string routines: Calling sequence. (line 112)
* strip: mktex configuration. (line 108)
* stripsupplier: mktex configuration. (line 102)
* striptypeface: mktex configuration. (line 105)
@@ -4616,15 +4485,17 @@ Index
(line 204)
* tcfmgr.map: Specially-recognized files.
(line 47)
-* TDS: TeX directory structure.
+* TDS <1>: TeX directory structure.
(line 6)
+* TDS: Default path features.
+ (line 41)
* testing, post-installation: Installation testing.
(line 6)
* tests, simple: Simple installation. (line 79)
-* teTeX: Other TeX packages. (line 13)
-* TeX directory structure: TeX directory structure.
+* TeX directory structure <1>: TeX directory structure.
(line 6)
-* TeX distributions besides Web2c: Other TeX packages. (line 6)
+* TeX directory structure: Default path features.
+ (line 41)
* TeX environment variables: Supported file formats.
(line 6)
* TeX failures: TeX or Metafont failing.
@@ -4633,7 +4504,6 @@ Index
* TeX glyph lookup: Glyph lookup. (line 6)
* 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-file.c: File lookup. (line 37)
@@ -4644,6 +4514,7 @@ Index
(line 24)
* tex-k-request@tug.org: Mailing lists. (line 7)
* tex-k@tug.org (bug address): Reporting bugs. (line 8)
+* tex.web: unixtex.ftp. (line 20)
* TEX_HUSH <1>: Suppressing warnings.
(line 6)
* TEX_HUSH: Searching overview. (line 56)
@@ -4759,7 +4630,6 @@ Index
* VFFONTS: Supported file formats.
(line 207)
* VMS support: Custom installation. (line 19)
-* VMS TeX implementations: Other TeX packages. (line 6)
* Vojta, Paul: History. (line 30)
* Walsh, Norman: History. (line 57)
* warning about unusable ls-R: ls-R. (line 45)
@@ -4778,9 +4648,6 @@ Index
* whitespace, in fontmap files: Fontmap. (line 28)
* whitespace, not ignored on continuation lines: Config files.
(line 31)
-* Windows TeX implementations: Other TeX packages. (line 6)
-* World Wide Web CTAN access: Electronic distribution.
- (line 17)
* www.tug.org: unixtex.ftp. (line 6)
* X11 previewer: Kpathsea application distributions.
(line 25)
@@ -4807,86 +4674,83 @@ Index

Tag Table:
-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
+Node: Top1615
+Node: Introduction2258
+Node: History4080
+Node: Installation8172
+Node: Simple installation8962
+Node: Custom installation12545
+Node: Disk space13719
+Node: Kpathsea application distributions14603
+Node: Changing search paths15718
+Node: Default path features16900
+Node: Default path generation18983
+Node: Running configure20426
+Node: configure shells21477
+Node: configure options22529
+Node: configure environment24036
+Node: configure scenarios25838
+Node: Shared library27424
+Node: Running make28438
+Node: Installing files30485
+Node: Cleaning up32432
+Node: Filename database generation33480
+Node: mktex scripts34047
+Node: mktex configuration35324
+Node: mktex script names41143
+Node: mktex script arguments42534
+Node: Installation testing43424
+Node: Security43788
+Node: TeX directory structure46355
+Node: unixtex.ftp50777
+Node: Reporting bugs52095
+Node: Bug checklist52830
+Node: Mailing lists56527
+Node: Debugging57736
+Node: Logging62814
+Node: Common problems64684
+Node: Unable to find files65515
+Node: Slow path searching67926
+Node: Unable to generate fonts69303
+Node: TeX or Metafont failing71812
+Node: Empty Makefiles73691
+Node: XtStrings74928
+Node: dlopen75764
+Node: ShellWidgetClass76582
+Node: Pointer combination warnings78214
+Node: Path searching78603
+Node: Searching overview79250
+Node: Path sources82646
+Node: Config files83717
+Node: Path expansion87362
+Node: Default expansion88311
+Node: Variable expansion90381
+Node: Tilde expansion91784
+Node: Brace expansion92764
+Node: KPSE_DOT expansion93869
+Node: Subdirectory expansion94382
+Node: Filename database96733
+Node: ls-R97787
+Node: Filename aliases100681
+Node: Database format101859
+Node: Invoking kpsewhich102872
+Node: Path searching options103818
+Node: Specially-recognized files111982
+Node: Auxiliary tasks113338
+Node: Standard options115163
+Node: TeX support115519
+Node: Supported file formats116810
+Node: File lookup124327
+Node: Glyph lookup126076
+Node: Basic glyph lookup127200
+Node: Fontmap128079
+Node: Fallback font130696
+Node: Suppressing warnings131609
+Node: Programming132714
+Node: Programming overview133227
+Node: Calling sequence135921
+Node: Program-specific files142444
+Node: Programming with config files143467
+Node: Index144779

End Tag Table
diff --git a/Master/texmf/doc/info/web2c.info b/Master/texmf/doc/info/web2c.info
index 708cb6e1ad1..6b628f45a08 100644
--- a/Master/texmf/doc/info/web2c.info
+++ b/Master/texmf/doc/info/web2c.info
@@ -59,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 2009, released in July 2009.
+corresponds to Web2c version 2010, released in July 2010.
* Menu:
@@ -83,7 +83,7 @@ File: web2c.info, Node: Introduction, Next: Installation, Prev: Top, Up: Top
1 Introduction
**************
-This manual corresponds to version 2009 of Web2c, released in July 2009.
+This manual corresponds to version 2010 of Web2c, released in July 2010.
"Web2c" is the name of a TeX implementation, originally for Unix,
but now also running under DOS, Amiga, and other operating systems. By
@@ -560,7 +560,7 @@ common:
`-recorder'
Enable the filename recorder. This makes the program save a list
of the opened files into a file with (by default) extension
- `.fls'. For Omega, this option is always on, and the file has
+ `.fls'. For Aleph, this option is always on, and the file has
extension `.ofl'.
`-translate-file=TCXFILE'
@@ -626,6 +626,11 @@ not specified, the main programs (TeX, Metafont, MetaPost, and BibTeX)
make an exception: if the config file value `TEXMFOUTPUT' is set (it is
not by default), output files are written to the directory specified.
+ `TEXMFOUTPUT' is also checked for input files, as TeX often
+generates files that need to be subsequently read; for input, no
+suffixes (such as `.tex') are added by default, the input name is
+simply checked as given.
+

File: web2c.info, Node: Three programs, Prev: Output file location, Up: Commonalities
@@ -988,24 +993,18 @@ of the EC fonts, which can be generated at any size.
TeX can write output files, via the `\openout' primitive; this opens
a security hole vulnerable to Trojan horse attack: an unwitting user
could run a TeX program that overwrites, say, `~/.rhosts'. (MetaPost
-has a `write' primitive with similar implications). To alleviate this,
-there is a configuration variable `openout_any', which selects one of
-three levels of security. When it is set to `a' (for "any"), no
-restrictions are imposed. When it is set to `r' (for "restricted"),
-filenames beginning with `.' are disallowed (except `.tex' because
-LaTeX needs it). When it is set to `p' (for "paranoid") additional
-restrictions are imposed: an absolute filename must refer to a file in
-(a subdirectory) of `TEXMFOUTPUT', and any attempt to go up a directory
-level is forbidden (that is, paths may not contain a `..' component).
-The paranoid setting is the default. (For backwards compatibility, `y'
-and `1' are synonyms of `a', while `n' and `0' are synonyms for `r'.)
+has a `write' primitive with similar implications). To alleviate this
+and similar problems the functions `kpathsea_out_name_ok' and
+`kpathsea_in_name_ok' from the Kpathse library (*note Calling sequence:
+(kpathsea)Calling sequence.) are used to determine if a given filename
+is acceptable to be opened for output or input, depending on the
+setting of the configuration variables `openout_any' and `openin_any':
+`a' (for "any", the default for `openin_any'), `r' (for "restricted"),
+or `p' (for "paranoid", the default for `openout_any').
In any case, all `\openout' filenames are recorded in the log file,
except those opened on the first line of input, which is processed when
-the log file has not yet been opened. (If you as a TeX administrator
-wish to implement more stringent rules on `\openout', modifying the
-function `openoutnameok' in `web2c/lib/texmfmp.c' is intended to
-suffice.)
+the log file has not yet been opened.
The program accepts the following options, as well as the standard
`-help' and `-version' (*note Common options::):
@@ -1570,11 +1569,10 @@ e-TeX
Adds many new primitives, including right-to-left typesetting and
more registers. Now frozen.
-Omega
Aleph
- These add Unicode support, right-to-left typesetting, and more.
+ This adds Unicode support, right-to-left typesetting, and more.
Omega was the original program. Aleph is an updated version with
- a variety of bug fixes, and includes e-TeX. Neither is actively
+ a variety of bug fixes, and includes e-TeX. Aleph is not actively
maintained.
pdfTeX
@@ -1588,6 +1586,11 @@ luaTeX
(`http://lua.org') and opens up the TeX typesetting engine to
control from Lua. Home page: `http://luatex.org'.
+XeTeX
+ Combines support for Unicode input and OpenType- and system fonts
+ with the capabilities of pdfTeX. Home page:
+ `http://tug.org/xetex'.
+

File: web2c.info, Node: Metafont, Next: MetaPost, Prev: TeX, Up: Top
@@ -1815,7 +1818,7 @@ devices for which support has been compiled in can be selected.
the corresponding `configure' option(s) in parentheses.
`epsf'
- (`--with-epsfwin') Pseudo-window server for Encapsulated
+ (`--enable-epsfwin') Pseudo-window server for Encapsulated
PostScript (see `web2c/window/epsf.c'). 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
@@ -1823,43 +1826,46 @@ the corresponding `configure' option(s) in parentheses.
the new filename. Contributed by Mathias Herberts.
`hp2627'
- (`--with-hp2627win') HP2627a color graphics terminals.
+ (`--enable-hp2627win') HP2627a color graphics terminals.
`mftalk'
- (`--with-mftalkwin') Generic window server (see
+ (`--enable-mftalkwin') Generic window server (see
`web2c/window/mftalk.c').
`next'
- (`--with-next') NeXT window system. This requires a separate
+ (`--enable-next') NeXT window system. This requires a separate
program, called `DrawingServant', available separately. See the
`web2c/window/next.c'.
`regis'
- (`--with-regiswin') Regis terminals.
+ (`--enable-regiswin') Regis terminals.
`sun'
- (`--with-suntoolswin') The old Suntools (not any flavor of X)
+ (`--enable-suntoolswin') The old Suntools (not any flavor of X)
window system. (You can get the even older SunWindows `gfx' system
by using `sun-gfx.c'.)
`tek'
- (`--with-tektronixwin') Tektronix terminals.
+ (`--enable-tektronixwin') Tektronix terminals.
`uniterm'
- (`--with-unitermwin') Uniterm, Simon Poole's emulator of a smart
+ (`--enable-unitermwin') 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 `--with-tek'
- selects.
+ terminals as well; it's faster than the driver
+ `--enable-tektronixwin' selects.
`xterm'
- (`--with-x11win', `--with-x', `--with-x11') The X window system
- (version 11).
+ `--with-x' The X window system (version 11).
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 `configure --with-x
- --with-x-toolkit=no'.
+ --with-kf-x-toolkit=no'.
+
+ Specify `--disable-mf-nowin' in order not to build a separate
+ non-windows-capable Metafont executable `mf-nowin' (or
+ `mf-nowin.exe').
You cannot specify any of the usual X options (e.g., `-geometry')
on the Metafont command line, but you can specify X resources in
@@ -2068,8 +2074,8 @@ structure. See also:
* `http://cm.bell-labs.com/who/hobby/MetaPost.html' (the
MetaPost author's home page);
- * `http://tug.org/metapost.html' (papers, packages, and
- related information).
+ * `http://tug.org/metapost' (papers, packages, and related
+ information).
Also, a standard MetaPost package for drawing graphs is documented in
AT&T technical report CSTR-164, available as the file `mpgraph.ps',
@@ -2141,6 +2147,12 @@ only standard PostScript fonts. MetaPost reads the same `psfonts.map'
file as Dvips, to determine PostScript fonts that need to be downloaded
(*note psfonts.map: (dvips)psfonts.map.).
+ It is posible for pdfTeX to read MetaPost output directly; this is
+in contrast to general EPSF files, which have to be converted for use
+with PDF output. The easiest way is to name the MetaPost output files
+with the `.mps' extension. Then the LaTeX `\includegraphics' command,
+for example, will be able to read them, even when outputting PDF.
+
MetaPost can write output files, via the `write' primitive; this
opens a security hole. *Note tex invocation::.
@@ -3499,35 +3511,33 @@ Index
* -- starts option names: Option conventions. (line 11)
* --disable-dump-share configure option: Hardware and memory dumps.
(line 6)
-* --enable-ipc configure option: tex invocation. (line 101)
-* --help common option: Common options. (line 11)
-* --verbose common option: Common options. (line 15)
-* --version common option: Common options. (line 18)
-* --with-editor=CMD: Editor invocation. (line 10)
-* --with-epsfwin: Online Metafont graphics.
+* --disable-mf-nowin: Online Metafont graphics.
+ (line 65)
+* --enable-epsfwin: Online Metafont graphics.
(line 20)
-* --with-hp2627win: Online Metafont graphics.
+* --enable-hp2627win: Online Metafont graphics.
(line 28)
-* --with-mftalkwin: Online Metafont graphics.
+* --enable-ipc configure option: tex invocation. (line 95)
+* --enable-mftalkwin: Online Metafont graphics.
(line 31)
-* --with-next: Online Metafont graphics.
+* --enable-next: Online Metafont graphics.
(line 35)
-* --with-regiswin: Online Metafont graphics.
+* --enable-regiswin: Online Metafont graphics.
(line 40)
-* --with-suntoolswin: Online Metafont graphics.
+* --enable-suntoolswin: Online Metafont graphics.
(line 43)
-* --with-tektronixwin: Online Metafont graphics.
+* --enable-tektronixwin: Online Metafont graphics.
(line 48)
-* --with-unitermwin: Online Metafont graphics.
+* --enable-unitermwin: Online Metafont graphics.
(line 51)
+* --help common option: Common options. (line 11)
+* --verbose common option: Common options. (line 15)
+* --version common option: Common options. (line 18)
+* --with-editor=CMD: Editor invocation. (line 10)
+* --with-mf-x-toolkit=KIT: Online Metafont graphics.
+ (line 59)
* --with-x: Online Metafont graphics.
(line 57)
-* --with-x-toolkit=KIT: Online Metafont graphics.
- (line 60)
-* --with-x11: Online Metafont graphics.
- (line 57)
-* --with-x11win: Online Metafont graphics.
- (line 57)
* -8bit: Common options. (line 103)
* -base=BASE: Determining the memory dump to use.
(line 15)
@@ -3537,24 +3547,24 @@ Index
* -charcode-format=TYPE: tftopl invocation. (line 28)
* -D compiler options: Compile-time options.
(line 6)
-* -disable-write18: tex invocation. (line 136)
+* -disable-write18: tex invocation. (line 130)
* -dpi=REAL: dvitype invocation. (line 24)
-* -enable-write18: tex invocation. (line 135)
-* -enc: tex invocation. (line 95)
+* -enable-write18: tex invocation. (line 129)
+* -enc: tex invocation. (line 89)
* -file-line-error: Common options. (line 25)
* -file-line-error-style: Common options. (line 26)
* -fmt=DUMPNAME: Common options. (line 34)
* -fmt=FMT: Determining the memory dump to use.
(line 15)
* -geometry, supported with Xt: Online Metafont graphics.
- (line 66)
+ (line 69)
* -halt-on-error: Common options. (line 41)
* -images: gftype invocation. (line 26)
* -ini <1>: Initial and virgin. (line 12)
* -ini: Common options. (line 45)
* -interaction=STRING: Common options. (line 51)
-* -ipc: tex invocation. (line 101)
-* -ipc-start: tex invocation. (line 101)
+* -ipc: tex invocation. (line 95)
+* -ipc-start: tex invocation. (line 95)
* -jobname=STRING: Common options. (line 56)
* -kpathsea-debug=NUMBER: Common options. (line 60)
* -length=NUMBER: tangle invocation. (line 27)
@@ -3570,16 +3580,16 @@ Index
* -min-crossrefs=N: bibtex invocation. (line 31)
* -mixedcase: tangle invocation. (line 35)
* -mktex=FILETYPE <1>: mf invocation. (line 87)
-* -mktex=FILETYPE: tex invocation. (line 111)
-* -mltex: tex invocation. (line 116)
+* -mktex=FILETYPE: tex invocation. (line 105)
+* -mltex: tex invocation. (line 110)
* -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-mktex=FILETYPE: tex invocation. (line 105)
* -no-parse-first-line: Common options. (line 78)
-* -no-shell-escape: tex invocation. (line 129)
+* -no-shell-escape: tex invocation. (line 123)
* -oem: Common options. (line 108)
-* -output-comment=STRING: tex invocation. (line 121)
+* -output-comment=STRING: tex invocation. (line 115)
* -output-directory <1>: Output file location.
(line 15)
* -output-directory: Common options. (line 67)
@@ -3592,16 +3602,16 @@ Index
(line 18)
* -progname=STRING: Common options. (line 83)
* -recorder: Common options. (line 90)
-* -shell-escape: tex invocation. (line 128)
-* -shell-restricted: tex invocation. (line 130)
+* -shell-escape: tex invocation. (line 122)
+* -shell-restricted: tex invocation. (line 124)
* -show-opcodes: dvitype invocation. (line 56)
* -strict: tangle invocation. (line 46)
* -style=MFTFILE: mft invocation. (line 68)
-* -T: mpost invocation. (line 112)
+* -T: mpost invocation. (line 118)
* -terse: bibtex invocation. (line 28)
-* -tex=TEXPROGRAM: mpost invocation. (line 115)
+* -tex=TEXPROGRAM: mpost invocation. (line 121)
* -translate-file=TCXFILE: Common options. (line 96)
-* -troff: mpost invocation. (line 112)
+* -troff: mpost invocation. (line 118)
* -underline: tangle invocation. (line 41)
* -uppercase: tangle invocation. (line 35)
* -x: weave invocation. (line 22)
@@ -3617,6 +3627,7 @@ Index
* .mem: Initial MetaPost. (line 6)
* .mf: mf invocation. (line 24)
* .mp: mpost invocation. (line 31)
+* .mps files and PDF: mpost invocation. (line 89)
* .NNN PostScript figures: mpost invocation. (line 37)
* .NNNgf generic fonts: mf invocation. (line 34)
* .tcx character translation files <1>: TCX files. (line 6)
@@ -3625,9 +3636,9 @@ Index
* .tfm output <1>: mpost invocation. (line 37)
* .tfm output: mf invocation. (line 43)
* .Xdefaults: Online Metafont graphics.
- (line 66)
+ (line 69)
* .Xresources: Online Metafont graphics.
- (line 66)
+ (line 69)
* 2602gf: mf invocation. (line 48)
* 8 bit clean: Common options. (line 103)
* 8 bit clean output, specifying: Common options. (line 103)
@@ -3670,6 +3681,7 @@ Index
(line 12)
* afmtopl: Font utilities available elsewhere.
(line 12)
+* Aleph: TeX extensions. (line 14)
* aliases for fonts: Path searching. (line 15)
* alpha.bst: Basic BibTeX style files.
(line 22)
@@ -3745,7 +3757,7 @@ Index
* chtopx: Font utilities available elsewhere.
(line 23)
* class name for Metafont: Online Metafont graphics.
- (line 66)
+ (line 69)
* cm.base: Initial Metafont. (line 28)
* cmbase.mf: Initial Metafont. (line 28)
* cmbase.mft: mft invocation. (line 75)
@@ -3802,14 +3814,14 @@ Index
* device-independent width: pktype invocation. (line 53)
* directory structure: Installation. (line 34)
* DISPLAY: Online Metafont graphics.
- (line 73)
+ (line 76)
* dot files, written by TeX programs: tex invocation. (line 51)
* downloading of fonts for MetaPost labels: mpost invocation. (line 73)
* DrawingServant: Online Metafont graphics.
(line 35)
* dump file: Common options. (line 34)
* dumping memory: Memory dumps. (line 6)
-* DVI comment, specifying: tex invocation. (line 121)
+* DVI comment, specifying: tex invocation. (line 115)
* DVI files, converting to MPX: dvitomp invocation. (line 6)
* DVI files, explained: Font file formats. (line 30)
* DVI format definition: DVI utilities. (line 14)
@@ -3902,11 +3914,11 @@ Index
* Free Software Foundation documentation system: Formats. (line 47)
* freedom of Web2c: Introduction. (line 22)
* ftp.math.utah.edu: bibtex invocation. (line 54)
-* generating source specials: tex invocation. (line 142)
+* generating source specials: tex invocation. (line 136)
* geometric designs: Metafont. (line 6)
* geometric font scaling: Font file formats. (line 22)
* geometry for Metafont: Online Metafont graphics.
- (line 66)
+ (line 69)
* getopt_long_only: Option conventions. (line 6)
* GF files, explained: Font file formats. (line 40)
* GF files, output by Metafont: mf invocation. (line 34)
@@ -3954,7 +3966,7 @@ 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)
+* hypertext: TeX extensions. (line 20)
* hyphenation and languages: Languages and hyphenation.
(line 6)
* hyphenation patterns, creating: patgen invocation. (line 6)
@@ -4017,8 +4029,8 @@ Index
* 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)
+* Lua: TeX extensions. (line 26)
+* luaTeX: TeX extensions. (line 26)
* machine dependencies: Hardware and memory dumps.
(line 6)
* machine-readable, converting property lists to <1>: vptovf invocation.
@@ -4055,14 +4067,14 @@ Index
* meta characters in filenames: \input filenames. (line 35)
* Metafont: Metafont. (line 6)
* Metafont geometry: Online Metafont graphics.
- (line 66)
+ (line 69)
* Metafont graphics: Online Metafont graphics.
(line 6)
* Metafont input files: mf invocation. (line 24)
* Metafont invocation: mf invocation. (line 6)
* Metafont meets PostScript: MetaPost. (line 6)
* Metafont online support, new devices: Online Metafont graphics.
- (line 77)
+ (line 80)
* Metafont source, prettyprinting: mft invocation. (line 6)
* Metafont, compatibility in MetaPost: Initial MetaPost. (line 25)
* Metafont, initial: Initial Metafont. (line 6)
@@ -4090,11 +4102,11 @@ Index
* MFTERM: Online Metafont graphics.
(line 11)
* mftmac.tex: mft invocation. (line 6)
-* micro-typography: TeX extensions. (line 21)
+* micro-typography: TeX extensions. (line 20)
* mktexmf, disabling: mf invocation. (line 24)
* mktextfM, disabling: tex invocation. (line 44)
* mltex: MLTeX. (line 6)
-* MLTeX, enabling: tex invocation. (line 116)
+* MLTeX, enabling: tex invocation. (line 110)
* mode needed to run Metafont: mf invocation. (line 48)
* mode_def: Modes. (line 15)
* mode_setup: Modes. (line 15)
@@ -4117,17 +4129,18 @@ Index
* Multi-lingual TeX: MLTeX. (line 6)
* N tilde: \charsubdef. (line 37)
* new graphics support for Metafont: Online Metafont graphics.
- (line 77)
+ (line 80)
* newrow GF command: gftype invocation. (line 93)
* next: Online Metafont graphics.
(line 34)
* NO_X11WIN: Online Metafont graphics.
(line 56)
* non-Unix system, compiling on: Additional targets. (line 12)
+* non-windows-capable Metafont: Online Metafont graphics.
+ (line 65)
* 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)
-* Omega: TeX extensions. (line 15)
* online Metafont graphics: Online Metafont graphics.
(line 6)
* opcodes, showing DVI: dvitype invocation. (line 56)
@@ -4140,7 +4153,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 121)
+* output_comment for DVI files: tex invocation. (line 115)
* overflow label offset: gftodvi invocation. (line 59)
* packet length: pktype invocation. (line 50)
* page, starting <1>: dvitype invocation. (line 50)
@@ -4150,8 +4163,9 @@ Index
* patgen: patgen invocation. (line 6)
* path searching: Path searching. (line 6)
* path searching debugging: Common options. (line 60)
-* PDF: TeX extensions. (line 21)
-* pdfTeX: TeX extensions. (line 21)
+* PDF: TeX extensions. (line 20)
+* PDF, and .mps files: mpost invocation. (line 89)
+* pdfTeX: TeX extensions. (line 20)
* permissions, legal: Legalisms. (line 6)
* PFA and PFB conversion: Font utilities available elsewhere.
(line 39)
@@ -4211,9 +4225,9 @@ Index
* 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 116)
+* program names, special <1>: tex invocation. (line 110)
* program names, special: Common options. (line 45)
-* prologues: mpost invocation. (line 112)
+* prologues: mpost invocation. (line 118)
* prologues, and EPSF output: mpost invocation. (line 83)
* proof mode: mf invocation. (line 48)
* proof sheets, of fonts: gftodvi invocation. (line 6)
@@ -4238,7 +4252,7 @@ Index
(line 39)
* Regis graphics support: Online Metafont graphics.
(line 40)
-* regression testing: tex invocation. (line 121)
+* regression testing: tex invocation. (line 115)
* repeated rows: pktype invocation. (line 76)
* representation of strings: pooltype invocation. (line 30)
* restricted shell escapes: Shell escapes. (line 6)
@@ -4256,6 +4270,7 @@ Index
* security, and \openout: tex invocation. (line 51)
* security, and output files: tex invocation. (line 51)
* security, and shell escapes: Shell escapes. (line 6)
+* security, and write: mpost invocation. (line 95)
* shapes: Metafont. (line 6)
* sharing memory dumps: Hardware and memory dumps.
(line 6)
@@ -4335,8 +4350,9 @@ Index
* Texinfo: Formats. (line 47)
* texmf.cnf: Path searching. (line 6)
* texmfmp.c: Online Metafont graphics.
- (line 77)
-* texmfmp.c and openoutnameok: tex invocation. (line 51)
+ (line 80)
+* TEXMFOUTPUT, used for reading: Output file location.
+ (line 24)
* TEXMFOUTPUT, used if . unwritable: Output file location.
(line 19)
* texput: tex invocation. (line 35)
@@ -4353,7 +4369,7 @@ Index
(line 30)
* title font: gftodvi invocation. (line 33)
* toolkits, X: Online Metafont graphics.
- (line 60)
+ (line 59)
* torture tests: Triptrap. (line 6)
* translation file for TeX, specifying: Common options. (line 96)
* translation from WEB to C: Introduction. (line 16)
@@ -4380,14 +4396,14 @@ Index
* typeface specimen sheets: Font utilities available elsewhere.
(line 42)
* typesetting: TeX. (line 6)
-* Unicode: TeX extensions. (line 15)
-* Unicode input: tex invocation. (line 95)
+* Unicode: TeX extensions. (line 14)
+* Unicode input: tex invocation. (line 89)
* uniterm: Online Metafont graphics.
(line 50)
* unsrt.bst: Basic BibTeX style files.
(line 39)
* using local codepage to display messages: Common options. (line 108)
-* UTF-8 input: tex invocation. (line 95)
+* UTF-8 input: tex invocation. (line 89)
* validation, of DVI files: dvitype invocation. (line 6)
* validation, of GF files: gftype invocation. (line 6)
* validation, of PK files: pktype invocation. (line 6)
@@ -4427,15 +4443,16 @@ Index
* X bitmap fonts: Font utilities available elsewhere.
(line 15)
* X class name for Metafont: Online Metafont graphics.
- (line 66)
+ (line 69)
* x offset: pktype invocation. (line 66)
* X resources: Online Metafont graphics.
- (line 66)
+ (line 69)
* X toolkits and Metafont: Online Metafont graphics.
- (line 60)
+ (line 59)
* xampl.bib: bibtex invocation. (line 51)
* xbfe, bitmap font editor: Font utilities available elsewhere.
(line 23)
+* XeTeX: TeX extensions. (line 31)
* xfed, bitmap font editor: Font utilities available elsewhere.
(line 23)
* xfedor, bitmap font editor: Font utilities available elsewhere.
@@ -4443,11 +4460,11 @@ Index
* Xlib: Online Metafont graphics.
(line 56)
* Xlib support: Online Metafont graphics.
- (line 60)
+ (line 59)
* Xt: Online Metafont graphics.
(line 56)
* Xt support: Online Metafont graphics.
- (line 60)
+ (line 59)
* xterm: Online Metafont graphics.
(line 56)
* y offset: pktype invocation. (line 66)
@@ -4469,62 +4486,62 @@ 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
+Node: Three programs25555
+Node: Initial and virgin26314
+Node: Memory dumps27414
+Node: Creating memory dumps27881
+Node: Determining the memory dump to use29142
+Node: Hardware and memory dumps30766
+Node: Editor invocation33235
+Node: \input filenames33965
+Node: TeX36958
+Node: tex invocation38104
+Node: Initial TeX45074
+Node: Formats46563
+Node: Languages and hyphenation49502
+Node: MLTeX49932
+Node: \charsubdef51427
+Node: \tracingcharsubdef53753
+Node: TCX files54328
+Node: patgen invocation59752
+Node: Shell escapes60469
+Node: IPC and TeX64033
+Node: TeX extensions64603
+Node: Metafont65735
+Node: mf invocation67023
+Node: Initial Metafont70906
+Node: Modes72659
+Node: Online Metafont graphics74915
+Node: gftodvi invocation78330
+Node: mft invocation81152
+Node: MetaPost85207
+Node: mpost invocation85969
+Node: Initial MetaPost91227
+Node: dvitomp invocation93038
+Node: BibTeX93703
+Node: bibtex invocation94064
+Node: Basic BibTeX style files96389
+Node: WEB97731
+Node: tangle invocation98939
+Node: weave invocation101062
+Node: pooltype invocation102470
+Node: DVI utilities103600
+Node: dvicopy invocation104544
+Node: dvitype invocation105842
+Node: dvitype output example108197
+Node: Font utilities111248
+Node: Font file formats112428
+Node: gftopk invocation115727
+Node: pktogf invocation116931
+Node: pktype invocation118110
+Node: gftype invocation120945
+Node: tftopl invocation125461
+Node: pltotf invocation130095
+Node: vftovp invocation131160
+Node: vptovf invocation133444
+Node: Font utilities available elsewhere134498
+Node: Legalisms136906
+Node: References139077
+Node: Index143459

End Tag Table
diff --git a/Master/texmf/doc/kpathsea/kpathsea.html b/Master/texmf/doc/kpathsea/kpathsea.html
index eefbdad9b89..075aa10f522 100644
--- a/Master/texmf/doc/kpathsea/kpathsea.html
+++ b/Master/texmf/doc/kpathsea/kpathsea.html
@@ -10,7 +10,7 @@
This file documents the Kpathsea library for path searching.
Copyright (C) 1996, 1997, 1998, 1999, 2000, 2001, 2002, 2003,
-2004, 2005, 2007, 2008, 2009 Karl Berry & Olaf Weber.
+2004, 2005, 2007, 2008, 2009, 2010 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
@@ -84,11 +84,6 @@ approved by the TeX Users Group.-->
<li><a href="#Security">2.3 Security</a>
<li><a href="#TeX-directory-structure">2.4 TeX directory structure</a>
<li><a href="#unixtex_002eftp">2.5 <samp><span class="file">unixtex.ftp</span></samp>: Obtaining TeX</a>
-<ul>
-<li><a href="#Electronic-distribution">2.5.1 Electronic distribution</a>
-<li><a href="#CD_002dROM-distribution">2.5.2 CD-ROM distribution</a>
-<li><a href="#Other-TeX-packages">2.5.3 Other TeX packages</a>
-</li></ul>
<li><a href="#Reporting-bugs">2.6 Reporting bugs</a>
<ul>
<li><a href="#Bug-checklist">2.6.1 Bug checklist</a>
@@ -175,8 +170,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 5.0.0,
-released in June 2009.
+filename lookup. It corresponds to version 6.0.0,
+released in July 2010.
<ul class="menu">
<li><a accesskey="1" href="#Introduction">Introduction</a>: Overview.
@@ -202,8 +197,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 5.0.0 of the Kpathsea
-library, released in June 2009.
+This manual corresponds to version 6.0.0 of the Kpathsea
+library, released in July 2010.
<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
@@ -629,10 +624,9 @@ 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-72"></a><a name="index-kpathsea_002fHIER-73"></a>See <a href="#TeX-directory-structure">TeX directory structure</a>, for a
+ <p><a name="index-TDS-72"></a><a name="index-g_t_0040TeX_007b_007d-directory-structure-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.
+the TeX system.
<div class="node">
<a name="Default-path-generation"></a>
@@ -1503,207 +1497,29 @@ Up:&nbsp;<a rel="up" accesskey="u" href="#Installation">Installation</a>
<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@tug.org">tex-k@tug.org</a>
-with comments or questions.
-
- <p>Following are general instructions for Unix or other sites who wish to
-acquire the Web2c distribution, (plain) TeX, LaTeX (2e),
-BibTeX, Metafont, MetaPost, DVI processors for the X window system,
-PostScript, the PCL language in the HP LaserJet, and related programs.
-They are oriented towards building from the original sources, though
-some information on alternative packages is included in the last
-section. See also <a href="http://www.tug.org/web2c/">http://www.tug.org/web2c/</a>, the Web2c and
-Kpathsea home page.
-
- <p>Please note that the Web2c distribution is a bare-bones distribution
-in source form, and building a complete installation from it is a
-non-trivial matter. For most uses, it is a better idea to install a
-distribution with pre-packaged binaries for your platform. The
-principal example of such a distribution is TeX Live
-(<a href="http://www.tug.org/texlive/">http://www.tug.org/texlive/</a>), which is based on the
-Web2c sources.
-
- <p>Please consider joining the TeX Users Group (TUG) or another user
-group of your choice to help support the maintenance and development
-of the programs you retrieve. See <a href="http://www.tug.org/join.html">http://www.tug.org/join.html</a>
-for information and the membership registration form, and
-<a href="http://www.tug.org/usergroups.html">http://www.tug.org/usergroups.html</a> for a listing of all user groups.
-
- <p>For actual installation instructions after obtaining the necessary
-sources, see <a href="#Installation">Installation</a>. A copy is in the distribution file
-<samp><span class="file">kpathsea/INSTALL</span></samp>.
-
-<ul class="menu">
-<li><a accesskey="1" href="#Electronic-distribution">Electronic distribution</a>: CTAN and so forth.
-<li><a accesskey="2" href="#CD_002dROM-distribution">CD-ROM distribution</a>
-<li><a accesskey="3" href="#Other-TeX-packages">Other TeX packages</a>
-</ul>
-
-<!-- * Tape distribution:: -->
-<!-- used to be in this menu. -->
-<div class="node">
-<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>
-
-</div>
-
-<h4 class="subsection">2.5.1 Electronic distribution</h4>
-
-<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-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-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-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-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>.
-
- <br><dt><samp><var>CTAN:</var><span class="file">/systems/web2c/web2c.tar.gz</span></samp><dd>The Web2c system. Required. Also unpacks into
-<samp><span class="file">web2c-</span><var>version</var></samp>.
-
- <br><dt><samp><var>CTAN:</var><span class="file">/systems/web2c/web2c-etex.tar.gz</span></samp><dd>Additions to the Web2c system for building e-TeX. Optional. Unpacks
-into <samp><span class="file">web2c-</span><var>version</var></samp>.
-
- <br><dt><samp><var>CTAN:</var><span class="file">/systems/web2c/etexlib.tar.gz</span></samp><dd>Additions to the texmf tree needed to build e-TeX. Optional.
-Unpacks into <samp><span class="file">texmf/</span></samp>.
-
- <br><dt><samp><var>CTAN:</var><span class="file">/systems/web2c/etexdoc.tar.gz</span></samp><dd>Documentation for e-TeX as an addition to the texmf tree. Optional.
-Unpacks into <samp><span class="file">texmf/</span></samp>.
-
- <br><dt><samp><var>CTAN:</var><span class="file">/systems/web2c/web2c-omega.tar.gz</span></samp><dd>Additions to the Web2c system for building Omega. Optional. Unpacks
-into <samp><span class="file">web2c-</span><var>version</var></samp>.
-
- <br><dt><samp><var>CTAN:</var><span class="file">/systems/web2c/omegalib.tar.gz</span></samp><dd>Additions to the texmf tree needed to build Omega. Optional. Unpacks
-into <samp><span class="file">texmf/</span></samp>.
-
- <br><dt><samp><var>CTAN:</var><span class="file">/systems/web2c/omegadoc.tar.gz</span></samp><dd>Documentation for Omega as an addition to the texmf tree. Optional.
-Unpacks into <samp><span class="file">texmf/</span></samp>.
-
- <br><dt><samp><var>CTAN:</var><span class="file">/systems/web2c/web2c-pdftex.tar.gz</span></samp><dd>Additions to the Web2c system for building pdfTeX. Optional.
-Unpacks into <samp><span class="file">web2c-</span><var>version</var></samp>.
-
- <br><dt><samp><var>CTAN:</var><span class="file">/systems/web2c/pdftexlib.tar.gz</span></samp><dd>Additions to the texmf tree needed to build pdfTeX. Optional.
-Unpacks into <samp><span class="file">texmf/</span></samp>.
-
- <br><dt><samp><var>CTAN:</var><span class="file">/dviware/xdvik/xdvik.tar.gz</span></samp><dd>X window system DVI previewer. Unpacks into <samp><span class="file">xdvik-</span><var>version</var></samp>.
-Optional.
-</dl>
-
- <p>Additional drivers, macro files, and other support are needed to build
-a working system. These are available in teTeX.
-
- <p>All that said, the originating host for the software above is
-<samp><span class="file">ftp.tug.org</span></samp>. You can retrieve these distributions (but not much
-else) from the <samp><span class="file">tex/</span></samp> directory on that host.
-
-<div class="node">
-<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>
-
-</div>
-
-<h4 class="subsection">2.5.2 CD-ROM distribution</h4>
-
-<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-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-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>.
-
- <!-- Commented out: the information is outdated in way or another. -->
- <!-- @item -->
- <!-- The Gateway@! CD-ROM set contains a runnable NetBSD/Amiga distribution -->
- <!-- and sources; see @url{http://www.netbsd.org/Sites/cdroms.html}. -->
- <!-- @item -->
- <!-- The InfoMagic CD-ROM is a copy of CTAN (see previous section); see -->
- <!-- @url{http://www.infomagic.com}. -->
- <!-- @item -->
- <!-- @cindex 4all@TeX{} Live CD-ROM -->
- <!-- @cindex NTG -->
- <!-- NTG (Dutch-speaking @TeX{} user group) produced the 4all@TeX{} CD-ROM; -->
- <!-- email @email{ntg@@nic.surfnet.nl}, or see -->
- <!-- @url{http://www.ntg.nl/4allcd/}. This is a runnable system. -->
- <!-- @item -->
- <!-- @cindex Prime Time @TeX{}cetera CD-ROM -->
- <!-- The Prime Time @TeX{}cetera CD-ROM is also a copy of CTAN; email -->
- <!-- @email{ptf@@ctcl.com} or see @url{http://www.ptf.com/ptf/}. -->
- <!-- @item -->
- <!-- @cindex Walnut Creek @TeX{} CD-ROM -->
- <!-- 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-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@tug.org">tex-k@tug.org</a>.
-
-<div class="node">
-<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>
-
-</div>
-
-<h4 class="subsection">2.5.3 Other TeX packages</h4>
-
-<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
-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-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-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
+is <a href="ftp://ftp.tug.org/tex/unixtex.ftp">ftp://ftp.tug.org/tex/unixtex.ftp</a>, last updated 13 June
+2010. Also available as <a href="http://www.tug.org/unixtex.ftp">http://www.tug.org/unixtex.ftp</a>. Email
+<a href="mailto:tex-k@tug.org">tex-k@tug.org</a> with comments or questions.
+
+ <p>The principal free TeX distribution for Unix-like systems is TeX
+Live, on the web at <a href="http://tug.org/texlive">http://tug.org/texlive</a>. The pages there
+describe many ways to acquire TeX, over the Internet or on physical
+media, both the sources and precompiled binaries for many systems,
+either standalone or as part of various operating system
+distributions.
+
+ <p>Web2C, Kpathsea, Dvips, and Dviljk are no longer released as a
+separate packages. Their sources are now maintained as part of TeX
+Live.
+
+ <p><a name="index-ftp_002ecs_002estanford_002eedu-280"></a><a name="index-tex_002eweb-281"></a><a name="index-Knuth_002c-Donald-E_002e_002c-archive-of-programs-by-282"></a>The host <tt>ftp.cs.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
-these files as part of the above packages. In any case, <tt>labrea</tt> is
-not the canonical source for anything except what was created by
-Stanford TeX project, so do not rely on all the files available at
-that ftp site being up-to-date.
+these files as part of a larger package. In any case, that ftp site is
+not the canonical source for anything except what was created as part
+of Stanford TeX project, so do not rely on the other files available
+there being up-to-date.
<div class="node">
<a name="Reporting-bugs"></a>
@@ -1715,10 +1531,10 @@ 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-312"></a><a name="index-bugs_002c-reporting-313"></a>
+<p><a name="index-reporting-bugs-283"></a><a name="index-bugs_002c-reporting-284"></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_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
+ <p><a name="index-tex_002dk_0040_0040tug_002eorg-_0040r_007b_0028bug-address_0029_007d-285"></a><a name="index-bug-address-286"></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
@@ -1743,7 +1559,7 @@ 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-316"></a><a name="index-bug-checklist-317"></a>
+<p><a name="index-checklist-for-bug-reports-287"></a><a name="index-bug-checklist-288"></a>
Before reporting a bug, please check below to be sure it isn't already
known (see <a href="#Common-problems">Common problems</a>).
@@ -1755,23 +1571,23 @@ information necessary for reproduction. Therefore, to enable
investigation, your report should include the following:
<ul>
-<li><a name="index-version-numbers_002c-determining-318"></a>The version number(s) of the program(s) involved, and of Kpathsea
+<li><a name="index-version-numbers_002c-determining-289"></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-319"></a>The hardware, operating system (including version number), compiler, and
+ <li><a name="index-uname-290"></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-320"></a>Any options you gave to <code>configure</code>. This is recorded in the
+ <li><a name="index-config_002elog-291"></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-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
+ <p><a name="index-configuration-bugs-292"></a><a name="index-config_002estatus-293"></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
@@ -1796,12 +1612,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-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
+ <li><a name="index-context-diff-294"></a><a name="index-sending-patches-295"></a><a name="index-ChangeLog-_0040r_007bentry_007d-296"></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-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
+ <li><a name="index-stack-trace-297"></a><a name="index-debugger-298"></a><a name="index-crashes_002c-reporting-299"></a><a name="index-core-dumps_002c-reporting-300"></a><a name="index-null-pointers_002c-dereferencing-301"></a><a name="index-gdb_0040r_007b_002c-recommended_007d-302"></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
@@ -1825,10 +1641,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-332"></a><a name="index-bug-mailing-list-333"></a><a name="index-announcement-mailing-list-334"></a>
+<p><a name="index-mailing-lists-303"></a><a name="index-bug-mailing-list-304"></a><a name="index-announcement-mailing-list-305"></a>
Web2c and Kpathsea in general are discussed on the mailing list
<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
+<a name="index-tex_002dk_002drequest_0040_0040tug_002eorg-306"></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>
@@ -1845,7 +1661,7 @@ 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-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
+ <p><a name="index-g_t_0040TeX_007b_007d-help-mailing-list-307"></a><a name="index-La_0040TeX_007b_007d-help-mailing-list-308"></a><a name="index-Usenet-_0040TeX_007b_007d-newsgroup-309"></a><a name="index-newsgroup-for-_0040TeX_007b_007d-310"></a><a name="index-help_002c-mailing-list-for-general-_0040TeX_007b_007d-311"></a><a name="index-info_002dtex_0040_0040shsu_002eedu-312"></a><a name="index-comp_002etext_002etex-313"></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
@@ -1862,8 +1678,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-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
+<p><a name="index-debugging-314"></a><a name="index-runtime-debugging-315"></a><a name="index-options-for-debugging-316"></a>
+<a name="index-kpse_002d_003edebug-317"></a><a name="index-debug_002eh-318"></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.
@@ -1875,57 +1691,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-348"></a><a name="index-kpse_002d_003edebug-349"></a>You can also set the environment variable <code>KPATHSEA_DEBUG</code>; in this
+ <p><a name="index-KPATHSEA_005fDEBUG-319"></a><a name="index-kpse_002d_003edebug-320"></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 instance variable <code>kpse-&gt;debug</code>, also use the numbers
below.
- <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
+ <p><a name="index-g_t_002d1-_0040r_007bdebugging-value_007d-321"></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-351"></a><a name="index-standard-error-and-debugging-output-352"></a>Debugging output always goes to standard error, so you can redirect it
+ <p><a name="index-debugging-output-322"></a><a name="index-standard-error-and-debugging-output-323"></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-353"></a>It is sometimes helpful to run the standalone Kpsewhich utility
+ <p><a name="index-Kpsewhich_002c-and-debugging-324"></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-354"></a>In any case, you can <em>not</em> use the <em>names</em> below; you must
+ <p><a name="index-numeric-debugging-values-325"></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-355"></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-326"></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-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>
+ <br><dt><code>KPSE_DEBUG_HASH </code><span class="roman">(2)</span><a name="index-KPSE_005fDEBUG_005fHASH-_0040r_007b_00282_0029_007d-327"></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-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
+ <br><dt><code>KPSE_DEBUG_FOPEN </code><span class="roman">(4)</span><a name="index-KPSE_005fDEBUG_005fFOPEN-_0040r_007b_00284_0029_007d-328"></a><dd><a name="index-fopen_0040r_007b_002c-redefined_007d-329"></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-359"></a><dd><a name="index-kpse_005fformat_005finfo_005ftype-360"></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-330"></a><dd><a name="index-kpse_005fformat_005finfo_005ftype-331"></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-361"></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-332"></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-362"></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-333"></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.,
@@ -1933,12 +1749,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-363"></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-334"></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-364"></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-335"></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-365"></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-336"></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
@@ -1946,11 +1762,11 @@ 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-366"></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-337"></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-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
+ <p><a name="index-g_t_0040samp_007bkdebug_003a_007d-338"></a><a name="index-hash_005fsummary_005fonly-_0040r_007bvariable-for-debugging_007d-339"></a><a name="index-hash-table-buckets_002c-printing-340"></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>
@@ -1967,18 +1783,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-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
+<p><a name="index-log-file-341"></a>
+<a name="index-logging-successful-searches-342"></a><a name="index-recording-successful-searches-343"></a><a name="index-usage-patterns_002c-finding-344"></a><a name="index-disk-usage_002c-reducing-345"></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-375"></a>To do this, define the environment or config file variable
+ <p><a name="index-TEXMFLOG-346"></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-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
+ <p><a name="index-epoch_002c-seconds-since-347"></a><a name="index-time-_0040r_007bsystem-call_007d-348"></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
@@ -1995,7 +1811,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-378"></a>Only filenames that are absolute are recorded, to preserve
+ <p><a name="index-privacy_002c-semblance-of-349"></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>
@@ -2017,7 +1833,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-379"></a><a name="index-problems_002c-common-380"></a><a name="index-FAQ_002c-Kpathsea-381"></a>
+<p><a name="index-common-problems-350"></a><a name="index-problems_002c-common-351"></a><a name="index-FAQ_002c-Kpathsea-352"></a>
Here are some common problems with configuration, compilation, linking,
execution, <small class="dots">...</small>
@@ -2044,7 +1860,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-382"></a><a name="index-files_002c-unable-to-find-383"></a>
+<p><a name="index-unable-to-find-files-353"></a><a name="index-files_002c-unable-to-find-354"></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>.
@@ -2054,13 +1870,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-384"></a><a name="index-environment-variables_002c-old-385"></a>You have (perhaps unknowingly) told Kpathsea to use search paths that
+ <li><a name="index-g_t_002fetc_002fprofile-355"></a><a name="index-environment-variables_002c-old-356"></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-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
+ <li><a name="index-symbolic-links-not-found-357"></a><a name="index-leaf-directories-wrongly-guessed-358"></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
@@ -2101,7 +1917,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-388"></a><a name="index-slow-startup-time-389"></a><a name="index-startup-time_002c-excessive-390"></a>
+<p><a name="index-excessive-startup-time-359"></a><a name="index-slow-startup-time-360"></a><a name="index-startup-time_002c-excessive-361"></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:
@@ -2138,14 +1954,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-391"></a><a name="index-font-generation-failures-392"></a>
+<p><a name="index-unable-to-generate-fonts-362"></a><a name="index-font-generation-failures-363"></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-393"></a>If <code>mktexpk</code> runs, but fails with this error:
+ <p><a name="index-g_t_0040code_007bmktexpk_007d-can_0027t-guess-mode-364"></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>
@@ -2163,14 +1979,14 @@ a configuration file:
<pre class="example"> D 360
M lqmed
</pre>
- <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
+ <p><a name="index-Metafont-using-the-wrong-device-365"></a><a name="index-device_002c-wrong-366"></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-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>
+ <p><a name="index-g_t_002e2602gf-367"></a><a name="index-g_t2602gf-368"></a><a name="index-Metafont-making-too_002dlarge-fonts-369"></a><a name="index-proof-mode-370"></a><a name="index-online-Metafont-display_002c-spurious-371"></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
@@ -2180,14 +1996,14 @@ 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-401"></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-372"></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-402"></a>If <code>mf</code> is a command not found at all by <code>mktexpk</code>, then you
+ <p><a name="index-Metafont-installation-373"></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">
@@ -2201,7 +2017,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-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
+<p><a name="index-g_t_0040TeX_007b_007d-failures-374"></a><a name="index-Metafont-failures-375"></a><a name="index-compiler-bugs-376"></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
@@ -2210,26 +2026,26 @@ 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-406"></a>For a workaround, if you enabled any optimization flags, it's best to
+ <p><a name="index-optimization-caveat-377"></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-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
+ <p><a name="index-GNU-C-compiler-bugs-378"></a><a name="index-system-C-compiler-bugs-379"></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-409"></a>To report compiler bugs effectively requires perseverance and
+ <p><a name="index-compiler-bugs_002c-finding-380"></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-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
+ <p><a name="index-ANSI-C-381"></a><a name="index-HP_002dUX_002c-compiling-on-382"></a><a name="index-compiling-on-HP_002dUX-383"></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
C doesn't guarantee that it will. It it known to fail on HP-UX 10
-mchines when the native compiler is used, unless the &lsquo;<samp><span class="samp">+u</span></samp>&rsquo; compiler
+machines when the native compiler is used, unless the &lsquo;<samp><span class="samp">+u</span></samp>&rsquo; compiler
switch was specified. Using GCC will work on this platform as well.
<div class="node">
@@ -2243,7 +2059,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-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>
+<p><a name="index-Makefiles_002c-empty-384"></a><a name="index-sed-_0040r_007berror-from-_0040code_007bconfigure_007d_007d-385"></a><a name="index-configure-_0040r_007berror-from-_0040code_007bsed_007d_007d-386"></a><a name="index-NetBSD-_0040code_007bconfigure_007d-error-387"></a><a name="index-FreeBSD-_0040code_007bconfigure_007d-error-388"></a><a name="index-Mach10-_0040code_007bconfigure_007d-error-389"></a><a name="index-AIX-4_002e1-_0040code_007bconfigure_007d-error-390"></a><a name="index-NeXT-_0040code_007bsed_007d-error-391"></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:
@@ -2251,7 +2067,8 @@ which looks something like this:
<pre class="example"> prompt$ ./configure
...
creating Makefile
- sed: 1: "\\@^ac_include make/pat ...": \ can not be used as a string delimiter
+ sed: 1: "\\@^ac_include make/pat ...": \ can not
+ be used as a string delimiter
</pre>
<p>So far as I know, the bug here is in <code>/bin/sh</code> on these systems. I
don't have access to a machine running any of them, so if someone can
@@ -2282,7 +2099,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-421"></a>You may find that linking X programs results in an error from the linker
+<p><a name="index-XtStrings-392"></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 ...
@@ -2309,7 +2126,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-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><a name="index-static-linking-and-_0040code_007bdlsym_007d-393"></a><a name="index-dlopen-394"></a><a name="index-dlsym-395"></a><a name="index-dlclose-396"></a><a name="index-wcstombs-397"></a><a name="index-libdl_002ea-398"></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
@@ -2325,7 +2142,7 @@ when you link:
void *dlsym() { return 0; }
int dlclose() { return -1; }
</pre>
- <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
+ <p><a name="index-dlsym_002ec-399"></a>These are contained in the <samp><span class="file">dlsym.c</span></samp> file in the MIT X
distribution.
<div class="node">
@@ -2339,15 +2156,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-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><a name="index-dynamic-linking-problems-with-OpenWin-libraries-400"></a><a name="index-OpenWin-libraries_002c-dynamic-linking-problems-401"></a><a name="index-get_005fwmShellWidgetClass-402"></a><a name="index-get_005fapplicationShellWidgetClass-403"></a>
+<a name="index-comp_002esys_002esun_002eadmin-_0040r_007bFAQ_007d-404"></a><a name="index-FAQ_002c-_0040t_007bcomp_002esys_002esun_002eadmin_007d-405"></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-435"></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-406"></a>The cause is bugs in the <code>Xmu</code> shared library as shipped from Sun.
There are several fixes:
<ul>
@@ -2365,7 +2182,7 @@ compiling Xdvi, see the <code>-DNOTOOL</code> option in <samp><span class="file"
</ul>
- <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:
+ <p><a name="index-Sun-OpenWin-patches-407"></a><a name="index-patches_002c-Sun-OpenWin-408"></a>Here is the information for getting the two patches:
<pre class="display"> Patch ID: 100512-02
Bug ID's: 1086793, 1086912, 1074766
@@ -2375,14 +2192,14 @@ 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-438"></a>The way to statically link with <code>libXmu</code> depends on whether you are
+ <p><a name="index-static-linking-409"></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-439"></a><a name="index-g_t_002ddynamic-440"></a>
+ <p><a name="index-g_t_002dstatic-410"></a><a name="index-g_t_002ddynamic-411"></a>
<pre class="example"> -static -lXmu -dynamic
</pre>
- <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;.
+ <p><a name="index-g_t_002dBstatic-412"></a><a name="index-g_t_002dBdynamic-413"></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">
<a name="Pointer-combination-warnings"></a>
@@ -2394,7 +2211,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-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
+<p><a name="index-warnings_002c-pointer-combinations-414"></a><a name="index-pointer-combination-warnings-415"></a><a name="index-illegal-pointer-combination-warnings-416"></a><a name="index-cc-_0040r_007bwarnings_007d-417"></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.
@@ -2462,7 +2279,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-447"></a>
+<p><a name="index-path-searching-418"></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.
@@ -2485,24 +2302,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-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>,
+<p><a name="index-searching-overview-419"></a><a name="index-path-searching_002c-overview-420"></a><a name="index-overview-of-path-searching-421"></a>
+<a name="index-search-path_002c-defined-422"></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-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;
+ <p><a name="index-magic-characters-423"></a><a name="index-g_t_003a-_0040r_007bmay-not-be-_003a_007d-424"></a><a name="index-g_t_002f-_0040r_007bmay-not-be-_002f_007d-425"></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-455"></a><a name="index-searching-the-database-456"></a>To check a particular path element <var>e</var>, Kpathsea first sees if a
+ <p><a name="index-database-search-426"></a><a name="index-searching-the-database-427"></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-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,
+ <p><a name="index-floating-directories-428"></a><a name="index-filesystem-search-429"></a><a name="index-disk-search-430"></a><a name="index-searching-the-disk-431"></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
@@ -2511,7 +2328,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-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
+ <p><a name="index-must-exist-432"></a><a name="index-VF-files_002c-not-found-433"></a><a name="index-cmr10_002evf-434"></a><a name="index-g_t_005copenin-435"></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
@@ -2524,7 +2341,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-465"></a>Although the simplest and most common path element is a directory name,
+ <p><a name="index-expansion_002c-path-element-436"></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
@@ -2533,11 +2350,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-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
+ <p><a name="index-absolute-filenames-437"></a><a name="index-relative-filenames-438"></a><a name="index-explicitly-relative-filenames-439"></a><a name="index-filenames_002c-absolute-or-explicitly-relative-440"></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-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
+ <p><a name="index-permission-denied-441"></a><a name="index-unreadable-files-442"></a><a name="index-access-warnings-443"></a><a name="index-warnings_002c-file-access-444"></a><a name="index-lost_002bfound-_0040r_007bdirectory_007d-445"></a><a name="index-TEX_005fHUSH-446"></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
@@ -2559,12 +2376,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-476"></a><a name="index-sources-for-search-paths-477"></a>
+<p><a name="index-path-sources-447"></a><a name="index-sources-for-search-paths-448"></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-478"></a>A user-set environment variable, e.g., <code>TEXINPUTS</code>.
+<li><a name="index-environment-variable_002c-source-for-path-449"></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;.
@@ -2572,10 +2389,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-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.,
+ <li><a name="index-configuration-file_002c-source-for-path-450"></a><a name="index-Kpathsea-config-file_002c-source-for-path-451"></a><a name="index-texmf_002ecnf_0040r_007b_002c-source-for-path_007d-452"></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-482"></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-453"></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
@@ -2596,8 +2413,8 @@ Up:&nbsp;<a rel="up" accesskey="u" href="#Path-sources">Path sources</a>
<h4 class="subsection">3.2.1 Config files</h4>
-<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>
+<p><a name="index-config-files-454"></a><a name="index-texmf_002ecnf_0040r_007b_002c-definition-for_007d-455"></a>
+<a name="index-runtime-configuration-files-456"></a><a name="index-TEXMFCNF-457"></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
@@ -2610,7 +2427,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-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
+ <p><a name="index-KPATHSEA_005fWARNING-458"></a><a name="index-warning_002c-about-missing-_0040file_007btexmf_002ecnf_007d-459"></a><a name="index-g_t_0040file_007btexmf_002ecnf_007d-missing_002c-warning-about-460"></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
@@ -2621,11 +2438,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-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-comments_002c-in-_0040file_007btexmf_002ecnf_007d-461"></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-491"></a>Blank lines are ignored.
+ <li><a name="index-blank-lines_002c-in-_0040file_007btexmf_002ecnf_007d-462"></a>Blank lines are ignored.
- <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.,
+ <li><a name="index-backslash_002dnewline-463"></a><a name="index-continuation-character-464"></a><a name="index-whitespace_002c-not-ignored-on-continuation-lines-465"></a><a name="index-g_t_005c_0040r_007b_002c-line-continuation-in-_0040file_007btexmf_002ecnf_007d_007d-466"></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.
@@ -2635,7 +2452,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-496"></a>The <var>variable</var> name may contain any character other than whitespace,
+ <li><a name="index-identifiers_002c-characters-valid-in-467"></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
@@ -2644,7 +2461,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-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;.
+ <li><a name="index-right_002dhand-side-of-variable-assignments-468"></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;
@@ -2670,7 +2487,7 @@ these points:
TEXINPUTS.latex2e = $latex2e_inputs
TEXINPUTS.latex = $latex2e_inputs
</pre>
- <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
+ <p><a name="index-shell-scripts-as-configuration-files-469"></a><a name="index-configuration-files-as-shell-scripts_002e-470"></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
@@ -2678,7 +2495,7 @@ 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-500"></a>The implementation of all this is in <samp><span class="file">kpathsea/cnf.c</span></samp>.
+ <p><a name="index-cnf_002ec-471"></a>The implementation of all this is in <samp><span class="file">kpathsea/cnf.c</span></samp>.
<div class="node">
<a name="Path-expansion"></a>
@@ -2691,7 +2508,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-501"></a><a name="index-expansion_002c-search-path-502"></a>
+<p><a name="index-path-expansion-472"></a><a name="index-expansion_002c-search-path-473"></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
@@ -2718,7 +2535,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-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>
+<p><a name="index-g_t_003a_003a-_0040r_007bexpansion_007d-474"></a><a name="index-doubled-colons-475"></a><a name="index-leading-colons-476"></a><a name="index-trailing-colons-477"></a><a name="index-extra-colons-478"></a><a name="index-default-expansion-479"></a><a name="index-expansion_002c-default-480"></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
@@ -2755,14 +2572,14 @@ 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-510"></a>
+<a name="index-Bach_002c-Johann-Sebastian-481"></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-511"></a>You can trace this by debugging &ldquo;paths&rdquo; (see <a href="#Debugging">Debugging</a>).
+ <p><a name="index-kdefault_002ec-482"></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>.
@@ -2777,7 +2594,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-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>
+<p><a name="index-g_t_0024-_0040r_007bexpansion_007d-483"></a><a name="index-environment-variables-in-paths-484"></a><a name="index-variable-expansion-485"></a><a name="index-expansion_002c-variable-486"></a><a name="index-texmf_002ecnf_0040r_007b_002c-and-variable-expansion_007d-487"></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.
@@ -2789,7 +2606,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-517"></a><a name="index-shell-variables-518"></a>You must quote the <tt>$</tt>'s and braces as necessary for your shell.
+ <p><a name="index-quoting-variable-values-488"></a><a name="index-shell-variables-489"></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.
@@ -2806,7 +2623,7 @@ 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-519"></a>Variable expansion is implemented in the source file
+ <p><a name="index-variable_002ec-490"></a>Variable expansion is implemented in the source file
<samp><span class="file">kpathsea/variable.c</span></samp>.
<div class="node">
@@ -2820,8 +2637,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-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
+<p><a name="index-g_t_007e-_0040r_007bexpansion_007d-491"></a><a name="index-home-directories-in-paths-492"></a><a name="index-tilde-expansion-493"></a><a name="index-expansion_002c-tilde-494"></a>
+<a name="index-HOME_0040r_007b_002c-as-_007e-expansion_007d-495"></a><a name="index-USERPROFILE_0040r_007b_002c-as-_007e-expansion_007d-496"></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>.
@@ -2835,13 +2652,13 @@ 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-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
+ <p><a name="index-g_t_0040t_007broot_007d-user-497"></a><a name="index-trailing-_0040samp_007b_002f_007d-in-home-directory-498"></a><a name="index-g_t_002f_0040r_007b_002c-trailing-in-home-directory_007d-499"></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-529"></a>Tilde expansion is implemented in the source file <samp><span class="file">kpathsea/tilde.c</span></samp>.
+ <p><a name="index-tilde_002ec-500"></a>Tilde expansion is implemented in the source file <samp><span class="file">kpathsea/tilde.c</span></samp>.
<div class="node">
<a name="Brace-expansion"></a>
@@ -2854,7 +2671,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-530"></a><a name="index-brace-expansion-531"></a>
+<p><a name="index-g_t_0040_007b-_0040r_007bexpansion_007d-501"></a><a name="index-brace-expansion-502"></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:
@@ -2870,14 +2687,14 @@ 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-532"></a>This feature can be used to implement multiple TeX hierarchies, by
+ <p><a name="index-multiple-_0040TeX_007b_007d-hierarchies-503"></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-533"></a>Brace expansion is implemented in the source file
+ <p><a name="index-expand_002ec-504"></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.
@@ -2894,7 +2711,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-534"></a>
+<p><a name="index-KPSE_005fDOT-_0040r_007bexpansion_007d-505"></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
@@ -2911,8 +2728,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-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
+<p><a name="index-g_t_002f_002f-506"></a><a name="index-subdirectory-searching-507"></a><a name="index-expansion_002c-subdirectory-508"></a>
+<a name="index-alphabetical-order_002c-not-509"></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
@@ -2929,10 +2746,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-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
+ <p><a name="index-trick-for-detecting-leaf-directories-510"></a><a name="index-leaf-directory-trick-511"></a><a name="index-Farwell_002c-Matthew-512"></a><a name="index-MacKenzie_002c-David-513"></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-543"></a>The trick is that in every real Unix implementation (as opposed to the
+ <p><a name="index-st_005fnlink-514"></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
@@ -2944,10 +2761,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-ST_005fNLINK_005fTRICK-544"></a>You can disable the trick by undefining <code>ST_NLINK_TRICK</code> in
+ <p><a name="index-ST_005fNLINK_005fTRICK-515"></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-545"></a>Unfortunately, in some cases files in leaf directories are
+ <p><a name="index-elt_002ddirs_002ec-516"></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
@@ -2956,7 +2773,7 @@ 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-546"></a>Subdirectory expansion is implemented in the source file
+ <p><a name="index-elt_002ddirs_002ec-517"></a>Subdirectory expansion is implemented in the source file
<samp><span class="file">kpathsea/elt-dirs.c</span></samp>.
<div class="node">
@@ -2970,7 +2787,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-547"></a><a name="index-database_002c-for-filenames-548"></a><a name="index-externally_002dbuilt-filename-database-549"></a>
+<p><a name="index-filename-database-518"></a><a name="index-database_002c-for-filenames-519"></a><a name="index-externally_002dbuilt-filename-database-520"></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
@@ -3004,7 +2821,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-550"></a><a name="index-TEXMFDBS-551"></a>
+<p><a name="index-ls_002dR-_0040r_007bdatabase-file_007d-521"></a><a name="index-TEXMFDBS-522"></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
@@ -3018,10 +2835,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-552"></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-523"></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-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
+ <p class="noindent"><a name="index-g_t_002d_002dcolor_003dtty-524"></a><a name="index-g_t_002fetc_002fprofile-_0040r_007band-aliases_007d-525"></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
@@ -3034,26 +2851,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-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;
+ <p><a name="index-g_t_002dA-_0040r_007boption-to-_0040code_007bls_007d_007d-526"></a><a name="index-dot-files-527"></a><a name="index-g_t_002e-_0040r_007bfiles_007d-528"></a><a name="index-g_t_002e-_0040r_007bdirectories_002c-ignored_007d-529"></a><a name="index-g_t_002etex-_0040r_007bfile_002c-included-in-_0040file_007bls_002dR_007d_007d-530"></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-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-symbolic-links_002c-and-_0040file_007bls_002dR_007d-531"></a><a name="index-g_t_002dL-_0040r_007boption-to-_0040code_007bls_007d_007d-532"></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-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
+ <p><a name="index-automounter_002c-and-_0040file_007bls_002dR_007d-533"></a><a name="index-NFS-and-_0040file_007bls_002dR_007d-534"></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-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
+ <p><a name="index-warning-about-unusable-_0040file_007bls_002dR_007d-535"></a><a name="index-unusable-_0040file_007bls_002dR_007d-warning-536"></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-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
+ <p><a name="index-g_t_0021_0021-_0040r_007bin-path-specifications_007d-537"></a><a name="index-disk-searching_002c-avoiding-538"></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,
@@ -3073,7 +2890,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-568"></a><a name="index-aliases_002c-for-filenames-569"></a>
+<p><a name="index-filename-aliases-539"></a><a name="index-aliases_002c-for-filenames-540"></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
@@ -3111,7 +2928,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-570"></a><a name="index-database_002c-format-of-571"></a>
+<p><a name="index-format-of-external-database-541"></a><a name="index-database_002c-format-of-542"></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.
@@ -3161,7 +2978,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-572"></a><a name="index-path-searching_002c-standalone-573"></a><a name="index-standalone-path-searching-574"></a>
+<p><a name="index-kpsewhich-543"></a><a name="index-path-searching_002c-standalone-544"></a><a name="index-standalone-path-searching-545"></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,
@@ -3169,6 +2986,7 @@ perhaps in administrative scripts. It is used heavily in the
distributed &lsquo;<samp><span class="samp">mktex...</span></samp>&rsquo; scripts.
<p>Synopsis:
+
<pre class="example"> kpsewhich <var>option</var>... <var>filename</var>...
</pre>
<p>The options and filename(s) to look up can be intermixed.
@@ -3192,21 +3010,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-575"></a>
+<p><a name="index-path-searching-options-546"></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-576"></a><a name="index-all-matches_002c-finding-577"></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-547"></a><a name="index-all-matches_002c-finding-548"></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-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
+ <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-549"></a><a name="index-g_t_002dD-_0040var_007bnum_007d-550"></a><a name="index-resolution_002c-setting-551"></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-581"></a><a name="index-engine-name-582"></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-552"></a><a name="index-engine-name-553"></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.
@@ -3222,7 +3040,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-583"></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-554"></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.
@@ -3235,9 +3053,14 @@ 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.
+ <p>The strings in parentheses are abbreviations recognized only by
+<code>kpsewhich</code> (not the underlying library calls). They are
+provided when it would otherwise require an argument containing a
+space to specify the format, to simplify quoting of calls from shells.
+
<pre class="example"> gf: gf
pk: pk
- bitmap font:
+ bitmap font (bitmapfont):
tfm: .tfm
afm: .afm
base: .base
@@ -3253,72 +3076,81 @@ See <a href="#Supported-file-formats">Supported file formats</a>, for more infor
mft: .mft
mp: .mp
mppool: .pool
- MetaPost support:
+ MetaPost support (mpsupport):
ocp: .ocp
ofm: .ofm .tfm
- opl: .opl
+ opl: .opl .pl
otp: .otp
- ovf: .ovf
- ovp: .ovp
+ ovf: .ovf .vf
+ ovp: .ovp .vpl
graphic/figure: .eps .epsi
tex: .tex .sty .cls .fd .aux .bbl .def .clo .ldf
- TeX system documentation:
+ TeX system documentation (doc):
texpool: .pool
- TeX system sources: .dtx .ins
+ TeX system sources (source): .dtx .ins
PostScript header: .pro
- Troff fonts:
+ Troff fonts (trofffont):
type1 fonts: .pfa .pfb
vf: .vf
- dvips config:
+ dvips config (dvipsconfig):
ist: .ist
truetype fonts: .ttf .ttc .TTF .TTC
type42 fonts: .t42 .T42
- web2c files:
- other text files:
- other binary files:
- misc fonts:
+ web2c files (web2c):
+ other text files (othertext):
+ other binary files (otherbin):
+ misc fonts (miscfont):
web: .web .ch
cweb: .w .web .ch
enc files: .enc
- cmap files:
+ cmap files (cmap):
subfont definition files: .sfd
opentype fonts: .otf
- pdftex config:
+ pdftex config (pdftexconfig):
lig files: .lig
texmfscripts:
lua: .luc .luctex .texluc .lua .luatex .texlua
font feature files: .fea
cid maps: .cid .cidmap
+ mlbib: .mlbib .bib
+ mlbst: .mlbst .bst
+ clua: .dll .so
</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-584"></a><a name="index-interactive-query-585"></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-555"></a><a name="index-interactive-query-556"></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-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">--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_002d_002dmktex_003d_0040var_007bfiletype_007d-557"></a><a name="index-g_t_002d_002dno_002dmktex_003d_0040var_007bfiletype_007d-558"></a>Turn on or off the &lsquo;<samp><span class="samp">mktex</span></samp>&rsquo; script associated with <var>filetype</var>.
+Usual values 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, even if they
+are enabled for TeX. This option implies setting
+<code>--must-exist</code>. 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-588"></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-559"></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-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">--must-exist</span></samp>&rsquo;<dd><a name="index-g_t_002d_002dmust_002dexist-560"></a>Do everything possible to find the files, notably including searching
+the disk and running the &lsquo;<samp><span class="samp">mktex</span></samp>&rsquo; scripts. 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-590"></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-561"></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-591"></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-562"></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-592"></a>Report only those matches whose directory part <em>ends</em> with
+ <br><dt>&lsquo;<samp><span class="samp">--safe-in-name=</span><var>name</var></samp>&rsquo;<dt>&lsquo;<samp><span class="samp">--safe-out-name=</span><var>name</var></samp>&rsquo;<dd><a name="index-g_t_002d_002dsafe_002din_002dname_003d_0040var_007bname_007d-563"></a><a name="index-g_t_002d_002dsafe_002dout_002dname_003d_0040var_007bname_007d-564"></a>Exit successfully if <var>name</var> is safe to open for reading or
+writing, respectively, else unsuccessfully. No output is written.
+These tests take account of the related Kpathsea configuration
+settings (see <a href="#Calling-sequence">Calling sequence</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-565"></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:
@@ -3375,9 +3207,8 @@ By specifying, say, &lsquo;<samp><span class="samp">--subdir=/pkg1</span></samp>
the one you are interested in.
<p>We only match at the end because a site might happen to install TeX
-in <samp><span class="file">/some/coincidental/pkg1/path/</span></samp>, and we wouldn't want
-<samp><span class="file">texmf-dist/scripts/pkg2/</span></samp> to match that when searching for
-&lsquo;<samp><span class="samp">/pkg1</span></samp>&rsquo;.
+in <samp><span class="file">/some/coincidental/pkg1/path/</span></samp>, and we wouldn't want to match
+<samp><span class="file">texmf-dist/scripts/pkg2/</span></samp> that when searching for &lsquo;<samp><span class="samp">/pkg1</span></samp>&rsquo;.
</dl>
@@ -3404,31 +3235,31 @@ up to the caller to specify the desired format.
with their corresponding format:
-<a name="index-config_002eps-593"></a>
+<a name="index-config_002eps-566"></a>
<dl><dt><samp><span class="file">config.ps</span></samp><dd><code>dvips config</code>
- <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-dvipdfmx_002ecfg-567"></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-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-fmtutil_002ecnf-568"></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-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-glyphlist_002etxt-569"></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-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-mktex_002ecnf-570"></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-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-pdfglyphlist_002etxt-571"></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-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;
+ <p><a name="index-pdftex_002ecfg-572"></a><a name="index-pdftexconfig_002etex-573"></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-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-texmf_002ecnf-574"></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;
+ <p><a name="index-XDvi-575"></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-603"></a>Another useful configuration file in this regard is <samp><span class="file">tcfmgr.map</span></samp>,
+ <p><a name="index-tcfmgr_002emap-576"></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).
@@ -3443,26 +3274,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-604"></a>
+<p><a name="index-auxiliary-tasks-577"></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-605"></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-578"></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-606"></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-579"></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-607"></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-580"></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-608"></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-581"></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-609"></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-582"></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
@@ -3479,7 +3310,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-610"></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-583"></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.
@@ -3496,13 +3327,14 @@ 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-611"></a>
+<p><a name="index-standard-options-584"></a>
Kpsewhich accepts the standard GNU options:
<ul>
-<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_002dhelp-585"></a>&lsquo;<samp><span class="samp">--help</span></samp>&rsquo; prints a help message on standard output and exits
+successfully.
- <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.
+ <li><a name="index-g_t_002d_002dversion-586"></a>&lsquo;<samp><span class="samp">--version</span></samp>&rsquo; prints the Kpathsea version number and exits successfully.
</ul>
<div class="node">
@@ -3516,7 +3348,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-614"></a>
+<p><a name="index-g_t_0040TeX_007b_007d-support-587"></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
@@ -3551,15 +3383,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-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>
+<p><a name="index-supported-file-formats-588"></a><a name="index-file-formats_002c-supported-589"></a>
+<a name="index-environment-variables-for-_0040TeX_007b_007d-590"></a><a name="index-g_t_0040TeX_007b_007d-environment-variables-591"></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-619"></a>Since environment variables containing periods, such as
+ <p><a name="index-program_002dvarying-paths-592"></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>).
@@ -3567,208 +3399,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-620"></a><a name="index-AFMFONTS-621"></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-593"></a><a name="index-AFMFONTS-594"></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-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>)
+ <br><dt>&lsquo;<samp><span class="samp">base</span></samp>&rsquo;<dd><a name="index-g_t_002ebase-595"></a><a name="index-MFBASES-596"></a><a name="index-TEXMFINI-597"></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-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>)
+ <br><dt>&lsquo;<samp><span class="samp">bib</span></samp>&rsquo;<dd><a name="index-g_t_002ebib-598"></a><a name="index-BIBINPUTS-599"></a><a name="index-TEXBIB-600"></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-628"></a><a name="index-BSTINPUTS-629"></a>(BibTeX style, 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-601"></a><a name="index-BSTINPUTS-602"></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-630"></a><a name="index-CMAPFONTS-631"></a>(character map files)
+ <br><dt>&lsquo;<samp><span class="samp">cmap</span></samp>&rsquo;<dd><a name="index-g_t_002ecmap-603"></a><a name="index-CMAPFONTS-604"></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-632"></a><a name="index-TEXMFCNF-633"></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-605"></a><a name="index-TEXMFCNF-606"></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-634"></a><a name="index-g_t_002eweb-635"></a><a name="index-CWEBINPUTS-636"></a>(CWEB input files)
+ <br><dt>&lsquo;<samp><span class="samp">cweb</span></samp>&rsquo;<dd><a name="index-g_t_002ew-607"></a><a name="index-g_t_002eweb-608"></a><a name="index-CWEBINPUTS-609"></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-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>)
+ <br><dt>&lsquo;<samp><span class="samp">dvips config</span></samp>&rsquo;<dd><a name="index-TEXCONFIG-610"></a><a name="index-config_002eps_0040r_007b_002c-search-path-for_007d-611"></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-639"></a><a name="index-ENCFONTS-640"></a>(encoding vectors)
+ <br><dt>&lsquo;<samp><span class="samp">enc files</span></samp>&rsquo;<dd><a name="index-g_t_002eenc-612"></a><a name="index-ENCFONTS-613"></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-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>)
+ <br><dt>&lsquo;<samp><span class="samp">fmt</span></samp>&rsquo;<dd><a name="index-g_t_002efmt-614"></a><a name="index-TEXFORMATS-615"></a><a name="index-TEXMFINI-616"></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">font cid map</span></samp>&rsquo;<dd><a name="index-g_t_002ecid-644"></a><a name="index-FONTCIDMAPS-645"></a>(CJK mapping)
+ <br><dt>&lsquo;<samp><span class="samp">font cid map</span></samp>&rsquo;<dd><a name="index-g_t_002ecid-617"></a><a name="index-FONTCIDMAPS-618"></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)
+ <br><dt>&lsquo;<samp><span class="samp">font feature files</span></samp>&rsquo;<dd><a name="index-g_t_002efea-619"></a><a name="index-FONTFEATURES-620"></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>)
+ <br><dt>&lsquo;<samp><span class="samp">gf</span></samp>&rsquo;<dd><a name="index-gf-621"></a><a name="index-GFFONTS-622"></a><a name="index-GLYPHFONTS-623"></a><a name="index-TEXFONTS-624"></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-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>)
+ <br><dt>&lsquo;<samp><span class="samp">graphic/figure</span></samp>&rsquo;<dd><a name="index-g_t_002eeps-625"></a><a name="index-g_t_002eepsi-626"></a><a name="index-TEXPICTS-627"></a><a name="index-TEXINPUTS-628"></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-656"></a><a name="index-TEXINDEXSTYLE-657"></a><a name="index-INDEXSTYLE-658"></a>(makeindex style files)
+ <br><dt>&lsquo;<samp><span class="samp">ist</span></samp>&rsquo;<dd><a name="index-g_t_002eist-629"></a><a name="index-TEXINDEXSTYLE-630"></a><a name="index-INDEXSTYLE-631"></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-659"></a><a name="index-LIGFONTS-660"></a>(ligature definition files)
+ <br><dt>&lsquo;<samp><span class="samp">lig files</span></samp>&rsquo;<dd><a name="index-g_t_002elig-632"></a><a name="index-LIGFONTS-633"></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-661"></a><a name="index-TEXMFDBS-662"></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-634"></a><a name="index-TEXMFDBS-635"></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-663"></a><a name="index-TEXFONTMAPS-664"></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-636"></a><a name="index-TEXFONTMAPS-637"></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-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>)
+ <br><dt>&lsquo;<samp><span class="samp">mem</span></samp>&rsquo;<dd><a name="index-g_t_002emem-638"></a><a name="index-MPMEMS-639"></a><a name="index-TEXMFINI-640"></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-668"></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-641"></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-669"></a><a name="index-MFINPUTS-670"></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-642"></a><a name="index-MFINPUTS-643"></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-671"></a><a name="index-MFPOOL-672"></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-644"></a><a name="index-MFPOOL-645"></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-673"></a><a name="index-MFTINPUTS-674"></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-646"></a><a name="index-MFTINPUTS-647"></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-675"></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-648"></a>(font-related files that don't fit the other categories)
<code>MISCFONTS</code>
- <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)
+ <br><dt>&lsquo;<samp><span class="samp">mlbib</span></samp>&rsquo;<dd><a name="index-g_t_002emlbib-649"></a><a name="index-MLBIBINPUTS-650"></a><a name="index-BIBINPUTS-651"></a><a name="index-TEXBIB-652"></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)
+ <br><dt>&lsquo;<samp><span class="samp">mlbst</span></samp>&rsquo;<dd><a name="index-g_t_002emlbst-653"></a><a name="index-MLBSTINPUTS-654"></a><a name="index-BSTINPUTS-655"></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>)
+ <br><dt>&lsquo;<samp><span class="samp">mp</span></samp>&rsquo;<dd><a name="index-g_t_002emp-656"></a><a name="index-MPINPUTS-657"></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-685"></a><a name="index-MPPOOL-686"></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-658"></a><a name="index-MPPOOL-659"></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-687"></a><a name="index-OCPINPUTS-688"></a>(Omega compiled process files)
+ <br><dt>&lsquo;<samp><span class="samp">ocp</span></samp>&rsquo;<dd><a name="index-g_t_002eocp-660"></a><a name="index-OCPINPUTS-661"></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-689"></a><a name="index-OFMFONTS-690"></a>(Omega font metrics)
+ <br><dt>&lsquo;<samp><span class="samp">ofm</span></samp>&rsquo;<dd><a name="index-g_t_002eofm-662"></a><a name="index-OFMFONTS-663"></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-691"></a>(OpenType fonts)
+ <br><dt>&lsquo;<samp><span class="samp">opentype fonts</span></samp>&rsquo;<dd><a name="index-OPENTYPEFONTS-664"></a>(OpenType fonts)
<code>OPENTYPEFONTS</code>.
- <br><dt>&lsquo;<samp><span class="samp">opl</span></samp>&rsquo;<dd><a name="index-g_t_002eopl-692"></a>(Omega property lists)
+ <br><dt>&lsquo;<samp><span class="samp">opl</span></samp>&rsquo;<dd><a name="index-g_t_002eopl-665"></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-693"></a><a name="index-OTPINPUTS-694"></a>(Omega translation process files)
+ <br><dt>&lsquo;<samp><span class="samp">otp</span></samp>&rsquo;<dd><a name="index-g_t_002eotp-666"></a><a name="index-OTPINPUTS-667"></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-695"></a><a name="index-OVFFONTS-696"></a>(Omega virtual fonts)
+ <br><dt>&lsquo;<samp><span class="samp">ovf</span></samp>&rsquo;<dd><a name="index-g_t_002eovf-668"></a><a name="index-OVFFONTS-669"></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-697"></a><a name="index-OVPFONTS-698"></a>(Omega virtual property lists)
+ <br><dt>&lsquo;<samp><span class="samp">ovp</span></samp>&rsquo;<dd><a name="index-g_t_002eovp-670"></a><a name="index-OVPFONTS-671"></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-699"></a>(PDFTeX-specific configuration files)
+ <br><dt>&lsquo;<samp><span class="samp">pdftex config</span></samp>&rsquo;<dd><a name="index-PDFTEXCONFIG-672"></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-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>)
+ <br><dt>&lsquo;<samp><span class="samp">pk</span></samp>&rsquo;<dd><a name="index-g_t_002epk-673"></a><a name="index-PKFONTS-674"></a><a name="index-TEXPKS-675"></a><a name="index-GLYPHFONTS-676"></a><a name="index-TEXFONTS-677"></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-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>)
+ <br><dt>&lsquo;<samp><span class="samp">PostScript header</span></samp>&rsquo;<dd><a name="index-g_t_002epro-678"></a><a name="index-TEXPSHEADERS-679"></a><a name="index-PSHEADERS-680"></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-708"></a><a name="index-SFDFONTS-709"></a>(subfont definition files)
+ <br><dt>&lsquo;<samp><span class="samp">subfont definition files</span></samp>&rsquo;<dd><a name="index-g_t_002esfd-681"></a><a name="index-SFDFONTS-682"></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-710"></a><a name="index-TEXINPUTS-711"></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-683"></a><a name="index-TEXINPUTS-684"></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-712"></a><a name="index-TEXDOCS-713"></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-685"></a><a name="index-TEXDOCS-686"></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-714"></a><a name="index-TEXSOURCES-715"></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-687"></a><a name="index-TEXSOURCES-688"></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-716"></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-689"></a>(Architecture-independent executables distributed in the texmf trees)
<code>TEXMFSCRIPTS</code>.
- <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>)
+ <br><dt>&lsquo;<samp><span class="samp">texpool</span></samp>&rsquo;<dd><a name="index-g_t_002epool-690"></a><a name="index-TEXPOOL-691"></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-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>)
+ <br><dt>&lsquo;<samp><span class="samp">tfm</span></samp>&rsquo;<dd><a name="index-g_t_002etfm-692"></a><a name="index-TFMFONTS-693"></a><a name="index-TEXFONTS-694"></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-722"></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-695"></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-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;,
+ <br><dt>&lsquo;<samp><span class="samp">truetype fonts</span></samp>&rsquo;<dd><a name="index-g_t_002ettf-696"></a><a name="index-g_t_002ettc-697"></a><a name="index-TTFONTS-698"></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-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>)
+ <br><dt>&lsquo;<samp><span class="samp">type1 fonts</span></samp>&rsquo;<dd><a name="index-g_t_002epfa-699"></a><a name="index-g_t_002epfb-700"></a><a name="index-T1FONTS-701"></a><a name="index-T1INPUTS-702"></a><a name="index-TEXPSHEADERS-703"></a><a name="index-DVIPSHEADERS-704"></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-732"></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-705"></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-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>)
+ <br><dt>&lsquo;<samp><span class="samp">vf</span></samp>&rsquo;<dd><a name="index-g_t_002evf-706"></a><a name="index-VFFONTS-707"></a><a name="index-TEXFONTS-708"></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-736"></a><a name="index-WEBINPUTS-737"></a>(WEB input files)
+ <br><dt>&lsquo;<samp><span class="samp">web</span></samp>&rsquo;<dd><a name="index-g_t_002eweb-709"></a><a name="index-WEBINPUTS-710"></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-738"></a>(files specific to the web2c implementation)
+ <br><dt>&lsquo;<samp><span class="samp">web2c files</span></samp>&rsquo;<dd><a name="index-WEB2C-711"></a>(files specific to the web2c implementation)
<code>WEB2C</code>.
</dl>
@@ -3779,10 +3611,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-739"></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-712"></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-740"></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-713"></a>(binary files used by &lsquo;<samp><span class="samp">foo</span></samp>&rsquo;)
<code>FOOINPUTS</code>.
</dl>
@@ -3799,7 +3631,7 @@ non-metric) files.
<li>Each font format has a variable of its own.
- <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.,
+ <li><a name="index-XDVIFONTS-714"></a><a name="index-DVIPSFONTS-715"></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>
@@ -3815,7 +3647,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-743"></a><a name="index-searching-for-files-744"></a><a name="index-g_t_0040TeX_007b_007d-file-lookup-745"></a>
+<p><a name="index-file-lookup-716"></a><a name="index-searching-for-files-717"></a><a name="index-g_t_0040TeX_007b_007d-file-lookup-718"></a>
This section describes how Kpathsea searches for most files (bitmap font
searches are the exception, as described in the next section).
@@ -3836,7 +3668,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-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
+ <p><a name="index-extensions_002c-filename-719"></a><a name="index-suffixes_002c-filename-720"></a><a name="index-try_005fstd_005fextension_005ffirst-721"></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
@@ -3850,7 +3682,8 @@ 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-749"></a><a name="index-kpathsea_005ffind_005ffile-750"></a>This algorithm is implemented in the routine <code>kpathsea_find_file</code> in
+ <p><a name="index-tex_002dfile_002ec-722"></a><a name="index-kpathsea_005ffind_005ffile-723"></a>This algorithm is implemented in the function
+<code>kpathsea_find_file</code> in the source file
<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>).
@@ -3865,7 +3698,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-751"></a><a name="index-searching-for-glyphs-752"></a><a name="index-g_t_0040TeX_007b_007d-glyph-lookup-753"></a>
+<p><a name="index-glyph-lookup-724"></a><a name="index-searching-for-glyphs-725"></a><a name="index-g_t_0040TeX_007b_007d-glyph-lookup-726"></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).
@@ -3888,7 +3721,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-754"></a><a name="index-kpathsea_005ffind_005fglyph-755"></a>This is implemented in <code>kpathsea_find_glyph</code> in
+ <p><a name="index-tex_002dglyph_002ec-727"></a><a name="index-kpathsea_005ffind_005fglyph-728"></a>This is implemented in <code>kpathsea_find_glyph</code> in
<samp><span class="file">kpathsea/tex-glyph.c</span></samp>.
<ul class="menu">
@@ -3907,7 +3740,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-756"></a><a name="index-common-features-in-glyph-lookup-757"></a>
+<p><a name="index-basic-glyph-lookup-729"></a><a name="index-common-features-in-glyph-lookup-730"></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,
@@ -3918,7 +3751,7 @@ 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-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>.
+ <p><a name="index-tolerance-for-glyph-lookup-731"></a><a name="index-glyph-lookup-bitmap-tolerance-732"></a><a name="index-KPSE_005fBITMAP_005fTOLERANCE-733"></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
@@ -3935,8 +3768,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-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
+<p><a name="index-fontmap-files-734"></a><a name="index-font-alias-files-735"></a><a name="index-aliases-for-fonts-736"></a>
+<a name="index-texfonts_002emap-737"></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>
@@ -3947,11 +3780,11 @@ are found are read; earlier definitions override later ones.
<ol type=1 start=1>
- <li><a name="index-fontnames_002c-arbitrary-length-765"></a>An alias name is limited in length only by available memory, not by your
+ <li><a name="index-fontnames_002c-arbitrary-length-738"></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-766"></a><a name="index-lcircle10-767"></a>A few fonts have historically had multiple names: specifically,
+ <li><a name="index-circle-fonts-739"></a><a name="index-lcircle10-740"></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
@@ -3962,12 +3795,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-768"></a>
+<a name="index-comments_002c-in-fontmap-files-741"></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-769"></a><li>Blank lines are ignored.
+<a name="index-whitespace_002c-in-fontmap-files-742"></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-770"></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-743"></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;
@@ -4011,8 +3844,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-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,
+<p><a name="index-fallback-font-744"></a><a name="index-fallback-resolutions-745"></a><a name="index-font-of-last-resort-746"></a><a name="index-resolutions_002c-last_002dresort-747"></a><a name="index-last_002dresort-font-748"></a>
+<a name="index-DVIPSSIZES-749"></a><a name="index-XDVISIZES-750"></a><a name="index-DVILJSIZES-751"></a><a name="index-TEXSIZES-752"></a><a name="index-default_005ftexsizes-753"></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.,
@@ -4021,7 +3854,7 @@ 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-781"></a><a name="index-kpathsea_005finit_005fprog-782"></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-754"></a><a name="index-kpathsea_005finit_005fprog-755"></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 calling <code>kpathsea_init_prog</code>
(see <a href="#Calling-sequence">Calling sequence</a>); the default is no fallback font.
@@ -4036,8 +3869,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-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;
+<p><a name="index-warnings_002c-suppressing-756"></a><a name="index-suppressing-warnings-757"></a>
+<a name="index-TEX_005fHUSH-758"></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
@@ -4045,19 +3878,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-786"></a><dd>Suppress everything possible.
+<dt>&lsquo;<samp><span class="samp">all</span></samp>&rsquo;<a name="index-all-759"></a><dd>Suppress everything possible.
- <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">checksum</span></samp>&rsquo;<a name="index-checksum-760"></a><dd><a name="index-mismatched-checksum-warnings-761"></a>Suppress mismatched font checksum warnings.
- <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
+ <br><dt>&lsquo;<samp><span class="samp">lostchar</span></samp>&rsquo;<a name="index-lostchar-762"></a><dd><a name="index-missing-character-warnings-763"></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-791"></a><dd>Don't suppress any warnings.
+ <br><dt>&lsquo;<samp><span class="samp">none</span></samp>&rsquo;<a name="index-none-764"></a><dd>Don't suppress any warnings.
- <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
+ <br><dt>&lsquo;<samp><span class="samp">readable</span></samp>&rsquo;<a name="index-readable-765"></a><dd><a name="index-unreadable-file-warnings-766"></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-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
+ <br><dt>&lsquo;<samp><span class="samp">special</span></samp>&rsquo;<a name="index-special-767"></a><dd><a name="index-unknown-special-warnings-768"></a><a name="index-g_t_005cspecial_0040r_007b_002c-suppressing-warnings-about_007d-769"></a>Suppresses warnings about an unimplemented or unparsable
&lsquo;<samp><span class="samp">\special</span></samp>&rsquo; command.
</dl>
@@ -4096,7 +3929,7 @@ 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-797"></a><a name="index-overview-of-programming-with-Kpathsea-798"></a>
+<p><a name="index-programming-overview-770"></a><a name="index-overview-of-programming-with-Kpathsea-771"></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.
@@ -4107,7 +3940,7 @@ 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-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
+ <p><a name="index-re_002dentrant-API-772"></a><a name="index-API_002c-re_002dentrant-773"></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
@@ -4115,7 +3948,7 @@ 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
+ <p><a name="index-pathsearch_002eh-774"></a><a name="index-tex_002dfile_002eh-775"></a><a name="index-tex_002dglyph_002eh-776"></a><a name="index-kpathsea_002eh-777"></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.
@@ -4124,13 +3957,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-805"></a><a name="index-c_002dauto_002eh-806"></a>If you want to include only specific headers, you should still consider
+ <p><a name="index-config_002eh-778"></a><a name="index-c_002dauto_002eh-779"></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-807"></a>The library provides no way for an external program to register new file
+ <p><a name="index-file-types_002c-registering-new-780"></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
@@ -4155,17 +3988,17 @@ 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-808"></a><a name="index-calling-sequence-809"></a>
+<p><a name="index-programming-with-Kpathsea-781"></a><a name="index-calling-sequence-782"></a>
The typical way to use Kpathsea in your program goes something like this:
<ol type=1 start=1>
- <li><a name="index-kpathsea_005fnew-810"></a>Call <code>kpathsea_new</code> to create a new library instance. This variable
+ <li><a name="index-kpathsea_005fnew-783"></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
+ <li><a name="index-kpathsea_005fset_005fprogram_005fname-784"></a><a name="index-argv_005b0_005d-785"></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>).
@@ -4173,16 +4006,16 @@ 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-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
+ <p><a name="index-kpse_002d_003einvocation_005fname-786"></a><a name="index-kpse_002d_003einvocation_005fshort_005fname-787"></a><a name="index-kpse_002d_003eprogram_005fname-788"></a><a name="index-error-message-macros-789"></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 variable
<code>kpse-&gt;program_name</code> to the program name it uses.
- <p><a name="index-KPATHSEA_005fDEBUG-817"></a>It also initializes debugging options based on the environment
+ <p><a name="index-KPATHSEA_005fDEBUG-790"></a>It also initializes debugging options based on the environment
variable <code>KPATHSEA_DEBUG</code> (if that is set).
- <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>
+ <p><a name="index-SELFAUTOLOC-791"></a><a name="index-SELFAUTODIR-792"></a><a name="index-SELFAUTOPARENT-793"></a><a name="index-symlinks_002c-resolving-794"></a><a name="index-expanding-symlinks-795"></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
@@ -4190,20 +4023,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_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
+ <li><a name="index-kpse_002d_003edebug-_0040r_007bvariable_007d-796"></a><a name="index-debugging-options_002c-in-Kpathsea_002dusing-program-797"></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>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_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
+ <li><a name="index-client_005fpath-_0040r_007bin-_0040code_007bkpse_002d_003eformat_005finfo_007d_007d-798"></a><a name="index-kpse_002d_003eformat_005finfo-799"></a><a name="index-resident_002ec-800"></a><a name="index-config-files_002c-for-Kpathsea_002dusing-programs-801"></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-&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-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
+ <li><a name="index-kpathsea_005finit_005fprog-802"></a><a name="index-proginit_002eh-803"></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
@@ -4211,7 +4044,7 @@ 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-kpathsea_005ffind_005ffile-831"></a>The routine to actually find a file of type <var>format</var> is
+ <li><a name="index-kpathsea_005ffind_005ffile-804"></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
@@ -4224,7 +4057,7 @@ is <code>kpathsea_find_glyph</code>, defined in
resultant filename, because fonts can be found in so many ways. See the
documentation in the source.
- <li><a name="index-kpathsea_005fopen_005ffile-832"></a>To actually open a file, not just return a filename, call
+ <li><a name="index-kpathsea_005fopen_005ffile-805"></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
@@ -4232,24 +4065,47 @@ necessary (unless the search path specified &lsquo;<samp><span class="samp">!!</
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
+ <li><a name="index-kpathsea_005fout_005fname_005fok-806"></a>TeX can write output files, via the <code>\openout</code> primitive; this opens
+a security hole vulnerable to Trojan horse attack: an unwitting user could
+run a TeX program that overwrites, say, <samp><span class="file">~/.rhosts</span></samp>. Analogous
+security holes exist for many other programs. To alleviate this, there is a
+configuration variable <code>openout_any</code>, which selects one of three levels
+of security. When it is set to &lsquo;<samp><span class="samp">a</span></samp>&rsquo; (for &ldquo;any&rdquo;), no restrictions are
+imposed. When it is set to &lsquo;<samp><span class="samp">r</span></samp>&rsquo; (for &ldquo;restricted&rdquo;), filenames
+beginning with &lsquo;<samp><span class="samp">.</span></samp>&rsquo; are disallowed (except <samp><span class="file">.tex</span></samp> because LaTeX
+needs it). When it is set to &lsquo;<samp><span class="samp">p</span></samp>&rsquo; (for &ldquo;paranoid&rdquo;) additional
+restrictions are imposed: an absolute filename must refer to a file in (a
+subdirectory) of <code>TEXMFOUTPUT</code>, and any attempt to go up a directory
+level is forbidden (that is, paths may not contain a &lsquo;<samp><span class="samp">..</span></samp>&rsquo; component).
+The paranoid setting is the default. (For backwards compatibility, &lsquo;<samp><span class="samp">y</span></samp>&rsquo;
+and &lsquo;<samp><span class="samp">1</span></samp>&rsquo; are synonyms of &lsquo;<samp><span class="samp">a</span></samp>&rsquo;, while &lsquo;<samp><span class="samp">n</span></samp>&rsquo; and &lsquo;<samp><span class="samp">0</span></samp>&rsquo; are
+synonyms for &lsquo;<samp><span class="samp">r</span></samp>&rsquo;.) The function <code>kpathsea_out_name_ok</code>, with a
+filename as second argument, returns <code>true</code> if that filename is
+acceptable to be opend for output or <code>false</code> otherwise.
+
+ <li><a name="index-kpathsea_005fin_005fname_005fok-807"></a>Similarly, the function <code>kpathsea_in_name_ok</code>, with a filename as
+second argument, returns <code>true</code> if that filename is acceptable to be
+opend for input or <code>false</code> otherwise, depending on the value of the
+configuration variable <code>openin_any</code> (with &lsquo;<samp><span class="samp">a</span></samp>&rsquo; as default).
+
+ <li><a name="index-kpathsea_005ffinish-808"></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-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
+ <p><a name="index-hash-table-routines-809"></a><a name="index-memory-allocation-routines-810"></a><a name="index-string-routines-811"></a><a name="index-reading-arbitrary_002dlength-lines-812"></a><a name="index-input-lines_002c-reading-813"></a><a name="index-lines_002c-reading-arbitrary_002dlength-814"></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-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>.
+ <p><a name="index-c_002d_002a_002eh-815"></a><a name="index-autoconf_0040r_007b_002c-recommended_007d-816"></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 and
+probably Automake for configuring and building your software if you use
+Kpathsea; I strongly recommend using Autoconf and Automake regardless.
+They are available from <a href="ftp://ftp.gnu.og/pub/gnu/">ftp://ftp.gnu.og/pub/gnu/</a>.
<div class="node">
<a name="Program-specific-files"></a>
@@ -4269,13 +4125,13 @@ directories. The Standard TeX directory structure (see <a href="tds.html#Top">I
that such files should go into a subdirectory named after the program,
like &lsquo;<samp><span class="samp">texmf/ttf2pk</span></samp>&rsquo;.
- <p>Two special formats, &lsquo;<samp><span class="samp">kpse_program_text_format</span></samp>&rsquo; and
-&lsquo;<samp><span class="samp">kpse_program_binary_format</span></samp>&rsquo; exist, which use
-<code>.:$TEXMF/</code><var>program</var><code>//</code> as their compiled-in search path. To
-override this default, you can use the variable
-<var>PROGRAM</var><code>INPUTS</code> in the environment and/or &lsquo;<samp><span class="samp">texmf.cnf</span></samp>&rsquo;.
-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>Two formats, &lsquo;<samp><span class="samp">kpse_program_text_format</span></samp>&rsquo; and
+&lsquo;<samp><span class="samp">kpse_program_binary_format</span></samp>&rsquo;, use <code>.:$TEXMF/</code><var>program</var><code>//</code>
+as their compiled-in search path. To override this default, you can
+use the variable <var>PROGRAM</var><code>INPUTS</code> in the environment and/or
+&lsquo;<samp><span class="samp">texmf.cnf</span></samp>&rsquo;. 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>kpathsea_open_file</code> will open the files it finds in text or binary
@@ -4291,12 +4147,12 @@ 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-842"></a><a name="index-config-files_002c-programming-with-843"></a>
+<p><a name="index-programming-with-config-files-817"></a><a name="index-config-files_002c-programming-with-818"></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-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
+ <p><a name="index-kpathsae_005fvar_005fvalue-819"></a><a name="index-variable_002eh-820"></a><a name="index-shell_005fescape_0040r_007b_002c-example-for-code_007d-821"></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
@@ -4309,7 +4165,7 @@ declared in <samp><span class="file">kpathsea/variable.h</span></samp>. It's ge
to set the search path structure components as explained in the previous
section, rather than using this yourself.
- <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
+ <p><a name="index-kpathsea_005fcnf_005fget-822"></a><a name="index-cnf_002eh-823"></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>kpathsea_cnf_get</code> (declared in <samp><span class="file">kpathsea/cnf.h</span></samp>)
with the string <var>var</var>.
@@ -4327,33 +4183,37 @@ 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-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_0021_0021-_0040r_007bin-path-specifications_007d-537"><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-483"><code>$ </code><span class="roman">expansion</span></a>: <a href="#Variable-expansion">Variable expansion</a></li>
+<li><a href="#index-g_t_002d_002dall-547"><code>--all</code></a>: <a href="#Path-searching-options">Path searching options</a></li>
+<li><a href="#index-g_t_002d_002dcolor_003dtty-524"><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-578"><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_002ddpi_003d_0040var_007bnum_007d-549"><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_002dengine_003d_0040var_007bname_007d-552"><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-580"><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-582"><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-581"><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-554"><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-585"><code>--help</code></a>: <a href="#Standard-options">Standard options</a></li>
+<li><a href="#index-g_t_002d_002dinteractive-555"><code>--interactive</code></a>: <a href="#Path-searching-options">Path searching options</a></li>
+<li><a href="#index-g_t_002d_002dmktex_003d_0040var_007bfiletype_007d-557"><code>--mktex=</code><var>filetype</var></a>: <a href="#Path-searching-options">Path searching options</a></li>
+<li><a href="#index-g_t_002d_002dmode_003d_0040var_007bstring_007d-559"><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-560"><code>--must-exist</code></a>: <a href="#Path-searching-options">Path searching options</a></li>
+<li><a href="#index-g_t_002d_002dno_002dmktex_003d_0040var_007bfiletype_007d-558"><code>--no-mktex=</code><var>filetype</var></a>: <a href="#Path-searching-options">Path searching options</a></li>
+<li><a href="#index-g_t_002d_002dpath_003d_0040var_007bstring_007d-561"><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-562"><code>--progname=</code><var>name</var></a>: <a href="#Path-searching-options">Path searching options</a></li>
+<li><a href="#index-g_t_002d_002dsafe_002din_002dname_003d_0040var_007bname_007d-563"><code>--safe-in-name=</code><var>name</var></a>: <a href="#Path-searching-options">Path searching options</a></li>
+<li><a href="#index-g_t_002d_002dsafe_002dout_002dname_003d_0040var_007bname_007d-564"><code>--safe-out-name=</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-583"><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_002dsubdir_003d_0040var_007bstring_007d-565"><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-579"><code>--var-value=</code><var>variable</var></a>: <a href="#Auxiliary-tasks">Auxiliary tasks</a></li>
+<li><a href="#index-g_t_002d_002dversion-586"><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>
@@ -4362,348 +4222,332 @@ Up:&nbsp;<a rel="up" accesskey="u" href="#Top">Top</a>
<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_002d1-_0040r_007bdebugging-value_007d-321"><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-526"><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-413"><code>-Bdynamic</code></a>: <a href="#ShellWidgetClass">ShellWidgetClass</a></li>
+<li><a href="#index-g_t_002dBstatic-412"><code>-Bstatic</code></a>: <a href="#ShellWidgetClass">ShellWidgetClass</a></li>
+<li><a href="#index-g_t_002dD-_0040var_007bnum_007d-550"><code>-D </code><var>num</var></a>: <a href="#Path-searching-options">Path searching options</a></li>
+<li><a href="#index-g_t_002ddynamic-411"><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_002dL-_0040r_007boption-to-_0040code_007bls_007d_007d-532"><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_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_002dstatic-410"><code>-static</code></a>: <a href="#ShellWidgetClass">ShellWidgetClass</a></li>
+<li><a href="#index-g_t_002e-_0040r_007bdirectories_002c-ignored_007d-529"><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-528"><code>. </code><span class="roman">files</span></a>: <a href="#ls_002dR">ls-R</a></li>
+<li><a href="#index-g_t_002e2602gf-367"><code>.2602gf</code></a>: <a href="#Unable-to-generate-fonts">Unable to generate fonts</a></li>
+<li><a href="#index-g_t_002eafm-593"><code>.afm</code></a>: <a href="#Supported-file-formats">Supported file formats</a></li>
+<li><a href="#index-g_t_002ebase-595"><code>.base</code></a>: <a href="#Supported-file-formats">Supported file formats</a></li>
+<li><a href="#index-g_t_002ebib-598"><code>.bib</code></a>: <a href="#Supported-file-formats">Supported file formats</a></li>
+<li><a href="#index-g_t_002ebst-601"><code>.bst</code></a>: <a href="#Supported-file-formats">Supported file formats</a></li>
+<li><a href="#index-g_t_002ecid-617"><code>.cid</code></a>: <a href="#Supported-file-formats">Supported file formats</a></li>
+<li><a href="#index-g_t_002ecmap-603"><code>.cmap</code></a>: <a href="#Supported-file-formats">Supported file formats</a></li>
+<li><a href="#index-g_t_002ecnf-605"><code>.cnf</code></a>: <a href="#Supported-file-formats">Supported file formats</a></li>
+<li><a href="#index-g_t_002eenc-612"><code>.enc</code></a>: <a href="#Supported-file-formats">Supported file formats</a></li>
+<li><a href="#index-g_t_002eeps-625"><code>.eps</code></a>: <a href="#Supported-file-formats">Supported file formats</a></li>
+<li><a href="#index-g_t_002eepsi-626"><code>.epsi</code></a>: <a href="#Supported-file-formats">Supported file formats</a></li>
+<li><a href="#index-g_t_002efea-619"><code>.fea</code></a>: <a href="#Supported-file-formats">Supported file formats</a></li>
+<li><a href="#index-g_t_002efmt-614"><code>.fmt</code></a>: <a href="#Supported-file-formats">Supported file formats</a></li>
+<li><a href="#index-g_t_002eist-629"><code>.ist</code></a>: <a href="#Supported-file-formats">Supported file formats</a></li>
+<li><a href="#index-g_t_002elig-632"><code>.lig</code></a>: <a href="#Supported-file-formats">Supported file formats</a></li>
+<li><a href="#index-g_t_002emap-636"><code>.map</code></a>: <a href="#Supported-file-formats">Supported file formats</a></li>
+<li><a href="#index-g_t_002emem-638"><code>.mem</code></a>: <a href="#Supported-file-formats">Supported file formats</a></li>
+<li><a href="#index-g_t_002emf-642"><code>.mf</code></a>: <a href="#Supported-file-formats">Supported file formats</a></li>
+<li><a href="#index-g_t_002emft-646"><code>.mft</code></a>: <a href="#Supported-file-formats">Supported file formats</a></li>
+<li><a href="#index-g_t_002emlbib-649"><code>.mlbib</code></a>: <a href="#Supported-file-formats">Supported file formats</a></li>
+<li><a href="#index-g_t_002emlbst-653"><code>.mlbst</code></a>: <a href="#Supported-file-formats">Supported file formats</a></li>
+<li><a href="#index-g_t_002emp-656"><code>.mp</code></a>: <a href="#Supported-file-formats">Supported file formats</a></li>
+<li><a href="#index-g_t_002eocp-660"><code>.ocp</code></a>: <a href="#Supported-file-formats">Supported file formats</a></li>
+<li><a href="#index-g_t_002eofm-662"><code>.ofm</code></a>: <a href="#Supported-file-formats">Supported file formats</a></li>
+<li><a href="#index-g_t_002eopl-665"><code>.opl</code></a>: <a href="#Supported-file-formats">Supported file formats</a></li>
+<li><a href="#index-g_t_002eotp-666"><code>.otp</code></a>: <a href="#Supported-file-formats">Supported file formats</a></li>
+<li><a href="#index-g_t_002eovf-668"><code>.ovf</code></a>: <a href="#Supported-file-formats">Supported file formats</a></li>
+<li><a href="#index-g_t_002eovp-670"><code>.ovp</code></a>: <a href="#Supported-file-formats">Supported file formats</a></li>
+<li><a href="#index-g_t_002epfa-699"><code>.pfa</code></a>: <a href="#Supported-file-formats">Supported file formats</a></li>
+<li><a href="#index-g_t_002epfb-700"><code>.pfb</code></a>: <a href="#Supported-file-formats">Supported file formats</a></li>
+<li><a href="#index-g_t_002epk-673"><code>.pk</code></a>: <a href="#Supported-file-formats">Supported file formats</a></li>
+<li><a href="#index-g_t_002epool-644"><code>.pool</code></a>: <a href="#Supported-file-formats">Supported file formats</a></li>
+<li><a href="#index-g_t_002epro-678"><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_002esfd-681"><code>.sfd</code></a>: <a href="#Supported-file-formats">Supported file formats</a></li>
+<li><a href="#index-g_t_002etex-683"><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-530"><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-692"><code>.tfm</code></a>: <a href="#Supported-file-formats">Supported file formats</a></li>
+<li><a href="#index-g_t_002ettc-697"><code>.ttc</code></a>: <a href="#Supported-file-formats">Supported file formats</a></li>
+<li><a href="#index-g_t_002ettf-696"><code>.ttf</code></a>: <a href="#Supported-file-formats">Supported file formats</a></li>
+<li><a href="#index-g_t_002evf-706"><code>.vf</code></a>: <a href="#Supported-file-formats">Supported file formats</a></li>
+<li><a href="#index-g_t_002ew-607"><code>.w</code></a>: <a href="#Supported-file-formats">Supported file formats</a></li>
+<li><a href="#index-g_t_002eweb-608"><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-425"><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-499"><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-506"><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_002fetc_002fprofile-355"><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-525"><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_t2602gf-368"><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_003a-_0040r_007bmay-not-be-_003a_007d-424"><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-474"><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-g_t_005c_0040r_007b_002c-line-continuation-in-_0040file_007btexmf_002ecnf_007d_007d-466"><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-435"><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-769"><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-437">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-access-warnings-443">access warnings</a>: <a href="#Searching-overview">Searching overview</a></li>
+<li><a href="#index-AFMFONTS-594"><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-4_002e1-_0040code_007bconfigure_007d-error-390">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-aliases-for-fonts-736">aliases for fonts</a>: <a href="#Fontmap">Fontmap</a></li>
+<li><a href="#index-aliases_002c-for-filenames-540">aliases, for filenames</a>: <a href="#Filename-aliases">Filename aliases</a></li>
+<li><a href="#index-all-759"><code>all</code></a>: <a href="#Suppressing-warnings">Suppressing warnings</a></li>
+<li><a href="#index-all-matches_002c-finding-548">all matches, finding</a>: <a href="#Path-searching-options">Path searching options</a></li>
+<li><a href="#index-alphabetical-order_002c-not-509">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-announcement-mailing-list-305">announcement mailing list</a>: <a href="#Mailing-lists">Mailing lists</a></li>
+<li><a href="#index-ANSI-C-381">ANSI C</a>: <a href="#TeX-or-Metafont-failing">TeX or Metafont failing</a></li>
+<li><a href="#index-API_002c-re_002dentrant-773">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-argv_005b0_005d-785"><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-autoconf_0040r_007b_002c-recommended_007d-816"><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-automounter_002c-and-_0040file_007bls_002dR_007d-533">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-577">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-Bach_002c-Johann-Sebastian-481">Bach, Johann Sebastian</a>: <a href="#Default-expansion">Default expansion</a></li>
+<li><a href="#index-backslash_002dnewline-463">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-basic-glyph-lookup-729">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-BIBINPUTS-599"><code>BIBINPUTS</code></a>: <a href="#Supported-file-formats">Supported file formats</a></li>
+<li><a href="#index-blank-lines_002c-in-_0040file_007btexmf_002ecnf_007d-462">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-502">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-BSTINPUTS-602"><code>BSTINPUTS</code></a>: <a href="#Supported-file-formats">Supported file formats</a></li>
+<li><a href="#index-bug-address-286">bug address</a>: <a href="#Reporting-bugs">Reporting bugs</a></li>
+<li><a href="#index-bug-checklist-288">bug checklist</a>: <a href="#Bug-checklist">Bug checklist</a></li>
+<li><a href="#index-bug-mailing-list-304">bug mailing list</a>: <a href="#Mailing-lists">Mailing lists</a></li>
+<li><a href="#index-bugs_002c-reporting-284">bugs, reporting</a>: <a href="#Reporting-bugs">Reporting bugs</a></li>
+<li><a href="#index-c_002d_002a_002eh-815"><code>c-*.h</code></a>: <a href="#Calling-sequence">Calling sequence</a></li>
+<li><a href="#index-c_002dauto_002eh-779"><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-calling-sequence-782">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_007bwarnings_007d-417"><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-ChangeLog-_0040r_007bentry_007d-296"><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-287">checklist for bug reports</a>: <a href="#Bug-checklist">Bug checklist</a></li>
+<li><a href="#index-checksum-760"><code>checksum</code></a>: <a href="#Suppressing-warnings">Suppressing warnings</a></li>
+<li><a href="#index-circle-fonts-739">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-client_005fpath-_0040r_007bin-_0040code_007bkpse_002d_003eformat_005finfo_007d_007d-798"><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-604"><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-754"><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-434"><code>cmr10.vf</code></a>: <a href="#Searching-overview">Searching overview</a></li>
+<li><a href="#index-cnf_002ec-471"><code>cnf.c</code></a>: <a href="#Config-files">Config files</a></li>
+<li><a href="#index-cnf_002eh-823"><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-in-fontmap-files-741">comments, in fontmap files</a>: <a href="#Fontmap">Fontmap</a></li>
+<li><a href="#index-comments_002c-in-_0040file_007btexmf_002ecnf_007d-461">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-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-common-features-in-glyph-lookup-730">common features in glyph lookup</a>: <a href="#Basic-glyph-lookup">Basic glyph lookup</a></li>
+<li><a href="#index-common-problems-350">common problems</a>: <a href="#Common-problems">Common problems</a></li>
+<li><a href="#index-comp_002esys_002esun_002eadmin-_0040r_007bFAQ_007d-404"><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-313"><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-compilation-value_002c-source-for-path-453">compilation value, source for path</a>: <a href="#Path-sources">Path sources</a></li>
+<li><a href="#index-compiler-bugs-376">compiler bugs</a>: <a href="#TeX-or-Metafont-failing">TeX or Metafont failing</a></li>
+<li><a href="#index-compiler-bugs_002c-finding-380">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-compiling-on-HP_002dUX-383">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-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-config-files-454">config files</a>: <a href="#Config-files">Config files</a></li>
+<li><a href="#index-config-files_002c-for-Kpathsea_002dusing-programs-801">config files, for Kpathsea-using programs</a>: <a href="#Calling-sequence">Calling sequence</a></li>
+<li><a href="#index-config-files_002c-programming-with-818">config files, programming with</a>: <a href="#Programming-with-config-files">Programming with config files</a></li>
+<li><a href="#index-config_002eh-778"><code>config.h</code></a>: <a href="#Programming-overview">Programming overview</a></li>
+<li><a href="#index-config_002elog-291"><code>config.log</code></a>: <a href="#Bug-checklist">Bug checklist</a></li>
+<li><a href="#index-config_002eps-566"><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-611"><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-293"><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-bugs-292">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-file_002c-source-for-path-450">configuration file, source for path</a>: <a href="#Path-sources">Path sources</a></li>
+<li><a href="#index-configuration-files-as-shell-scripts_002e-470">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-configure-_0040r_007berror-from-_0040code_007bsed_007d_007d-386"><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-context-diff-294">context diff</a>: <a href="#Bug-checklist">Bug checklist</a></li>
+<li><a href="#index-continuation-character-464">continuation character</a>: <a href="#Config-files">Config files</a></li>
+<li><a href="#index-core-dumps_002c-reporting-300">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-crashes_002c-reporting-299">crashes, reporting</a>: <a href="#Bug-checklist">Bug checklist</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-CWEBINPUTS-609"><code>CWEBINPUTS</code></a>: <a href="#Supported-file-formats">Supported file formats</a></li>
+<li><a href="#index-database-search-426">database search</a>: <a href="#Searching-overview">Searching overview</a></li>
+<li><a href="#index-database_002c-for-filenames-519">database, for filenames</a>: <a href="#Filename-database">Filename database</a></li>
+<li><a href="#index-database_002c-format-of-542">database, format of</a>: <a href="#Database-format">Database format</a></li>
+<li><a href="#index-debug_002eh-318"><code>debug.h</code></a>: <a href="#Debugging">Debugging</a></li>
+<li><a href="#index-debugger-298">debugger</a>: <a href="#Bug-checklist">Bug checklist</a></li>
+<li><a href="#index-debugging-314">debugging</a>: <a href="#Debugging">Debugging</a></li>
+<li><a href="#index-debugging-options_002c-in-Kpathsea_002dusing-program-797">debugging options, in Kpathsea-using program</a>: <a href="#Calling-sequence">Calling sequence</a></li>
+<li><a href="#index-debugging-output-322">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-expansion-479">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-default_005ftexsizes-753"><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-device_002c-wrong-366">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-search-430">disk search</a>: <a href="#Searching-overview">Searching overview</a></li>
+<li><a href="#index-disk-searching_002c-avoiding-538">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-disk-usage_002c-reducing-345">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-dlclose-396"><code>dlclose</code></a>: <a href="#dlopen">dlopen</a></li>
+<li><a href="#index-dlopen-394"><code>dlopen</code></a>: <a href="#dlopen">dlopen</a></li>
+<li><a href="#index-dlsym-395"><code>dlsym</code></a>: <a href="#dlopen">dlopen</a></li>
+<li><a href="#index-dlsym_002ec-399"><code>dlsym.c</code></a>: <a href="#dlopen">dlopen</a></li>
+<li><a href="#index-doc-files-685"><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-dot-files-527">dot files</a>: <a href="#ls_002dR">ls-R</a></li>
+<li><a href="#index-doubled-colons-475">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-DVILJSIZES-751"><code>DVILJSIZES</code></a>: <a href="#Fallback-font">Fallback font</a></li>
+<li><a href="#index-dvipdfmx_002ecfg-567"><code>dvipdfmx.cfg</code></a>: <a href="#Specially_002drecognized-files">Specially-recognized files</a></li>
+<li><a href="#index-DVIPSFONTS-715"><code>DVIPSFONTS</code></a>: <a href="#Supported-file-formats">Supported file formats</a></li>
+<li><a href="#index-DVIPSHEADERS-704"><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-DVIPSSIZES-749"><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-dynamic-linking-problems-with-OpenWin-libraries-400">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-elt_002ddirs_002ec-516"><code>elt-dirs.c</code></a>: <a href="#Subdirectory-expansion">Subdirectory expansion</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-ENCFONTS-613"><code>ENCFONTS</code></a>: <a href="#Supported-file-formats">Supported file formats</a></li>
+<li><a href="#index-engine-name-553">engine name</a>: <a href="#Path-searching-options">Path searching options</a></li>
+<li><a href="#index-environment-variable_002c-source-for-path-449">environment variable, source for path</a>: <a href="#Path-sources">Path sources</a></li>
+<li><a href="#index-environment-variables-for-_0040TeX_007b_007d-590">environment variables for TeX</a>: <a href="#Supported-file-formats">Supported file formats</a></li>
+<li><a href="#index-environment-variables-in-paths-484">environment variables in paths</a>: <a href="#Variable-expansion">Variable expansion</a></li>
+<li><a href="#index-environment-variables_002c-old-356">environment variables, old</a>: <a href="#Unable-to-find-files">Unable to find files</a></li>
+<li><a href="#index-epoch_002c-seconds-since-347">epoch, seconds since</a>: <a href="#Logging">Logging</a></li>
+<li><a href="#index-error-message-macros-789">error message macros</a>: <a href="#Calling-sequence">Calling sequence</a></li>
+<li><a href="#index-excessive-startup-time-359">excessive startup time</a>: <a href="#Slow-path-searching">Slow path searching</a></li>
+<li><a href="#index-expand_002ec-504"><code>expand.c</code></a>: <a href="#Brace-expansion">Brace expansion</a></li>
+<li><a href="#index-expanding-symlinks-795">expanding symlinks</a>: <a href="#Calling-sequence">Calling sequence</a></li>
+<li><a href="#index-expansion_002c-default-480">expansion, default</a>: <a href="#Default-expansion">Default expansion</a></li>
+<li><a href="#index-expansion_002c-path-element-436">expansion, path element</a>: <a href="#Searching-overview">Searching overview</a></li>
+<li><a href="#index-expansion_002c-search-path-473">expansion, search path</a>: <a href="#Path-expansion">Path expansion</a></li>
+<li><a href="#index-expansion_002c-subdirectory-508">expansion, subdirectory</a>: <a href="#Subdirectory-expansion">Subdirectory expansion</a></li>
+<li><a href="#index-expansion_002c-tilde-494">expansion, tilde</a>: <a href="#Tilde-expansion">Tilde expansion</a></li>
+<li><a href="#index-expansion_002c-variable-486">expansion, variable</a>: <a href="#Variable-expansion">Variable expansion</a></li>
+<li><a href="#index-explicitly-relative-filenames-439">explicitly relative filenames</a>: <a href="#Searching-overview">Searching overview</a></li>
+<li><a href="#index-extensions_002c-filename-719">extensions, filename</a>: <a href="#File-lookup">File lookup</a></li>
+<li><a href="#index-externally_002dbuilt-filename-database-520">externally-built filename database</a>: <a href="#Filename-database">Filename database</a></li>
+<li><a href="#index-extra-colons-478">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-font-744">fallback font</a>: <a href="#Fallback-font">Fallback font</a></li>
+<li><a href="#index-fallback-resolutions-745">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-FAQ_002c-_0040t_007bcomp_002esys_002esun_002eadmin_007d-405">FAQ, <tt>comp.sys.sun.admin</tt></a>: <a href="#ShellWidgetClass">ShellWidgetClass</a></li>
+<li><a href="#index-FAQ_002c-Kpathsea-352">FAQ, Kpathsea</a>: <a href="#Common-problems">Common problems</a></li>
+<li><a href="#index-Farwell_002c-Matthew-512">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-formats_002c-supported-589">file formats, supported</a>: <a href="#Supported-file-formats">Supported file formats</a></li>
+<li><a href="#index-file-lookup-716">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-file-types_002c-registering-new-780">file types, registering new</a>: <a href="#Programming-overview">Programming overview</a></li>
+<li><a href="#index-filename-aliases-539">filename aliases</a>: <a href="#Filename-aliases">Filename aliases</a></li>
+<li><a href="#index-filename-database-518">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-filenames_002c-absolute-or-explicitly-relative-440">filenames, absolute or explicitly relative</a>: <a href="#Searching-overview">Searching overview</a></li>
+<li><a href="#index-files_002c-unable-to-find-354">files, unable to find</a>: <a href="#Unable-to-find-files">Unable to find files</a></li>
+<li><a href="#index-filesystem-search-429">filesystem search</a>: <a href="#Searching-overview">Searching overview</a></li>
+<li><a href="#index-floating-directories-428">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-fmtutil_002ecnf-568"><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-alias-files-735">font alias files</a>: <a href="#Fontmap">Fontmap</a></li>
+<li><a href="#index-font-generation-failures-363">font generation failures</a>: <a href="#Unable-to-generate-fonts">Unable to generate fonts</a></li>
+<li><a href="#index-font-of-last-resort-746">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-FONTCIDMAPS-618"><code>FONTCIDMAPS</code></a>: <a href="#Supported-file-formats">Supported file formats</a></li>
+<li><a href="#index-FONTFEATURES-620"><code>FONTFEATURES</code></a>: <a href="#Supported-file-formats">Supported file formats</a></li>
+<li><a href="#index-fontmap-files-734">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-fontnames_002c-arbitrary-length-738">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-FOOINPUTS-712"><code>FOOINPUTS</code></a>: <a href="#Supported-file-formats">Supported file formats</a></li>
+<li><a href="#index-fopen_0040r_007b_002c-redefined_007d-329"><code>fopen</code><span class="roman">, redefined</span></a>: <a href="#Debugging">Debugging</a></li>
+<li><a href="#index-format-of-external-database-541">format of external database</a>: <a href="#Database-format">Database format</a></li>
+<li><a href="#index-FreeBSD-_0040code_007bconfigure_007d-error-388">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_002ecs_002estanford_002eedu-280"><code>ftp.cs.stanford.edu</code></a>: <a href="#unixtex_002eftp">unixtex.ftp</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-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-gdb_0040r_007b_002c-recommended_007d-302"><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-get_005fapplicationShellWidgetClass-403"><code>get_applicationShellWidgetClass</code></a>: <a href="#ShellWidgetClass">ShellWidgetClass</a></li>
+<li><a href="#index-get_005fwmShellWidgetClass-402"><code>get_wmShellWidgetClass</code></a>: <a href="#ShellWidgetClass">ShellWidgetClass</a></li>
+<li><a href="#index-gf-621"><code>gf</code></a>: <a href="#Supported-file-formats">Supported file formats</a></li>
+<li><a href="#index-GFFONTS-622"><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-glyph-lookup-724">glyph lookup</a>: <a href="#Glyph-lookup">Glyph lookup</a></li>
+<li><a href="#index-glyph-lookup-bitmap-tolerance-732">glyph lookup bitmap tolerance</a>: <a href="#Basic-glyph-lookup">Basic glyph lookup</a></li>
+<li><a href="#index-GLYPHFONTS-623"><code>GLYPHFONTS</code></a>: <a href="#Supported-file-formats">Supported file formats</a></li>
+<li><a href="#index-glyphlist_002etxt-569"><code>glyphlist.txt</code></a>: <a href="#Specially_002drecognized-files">Specially-recognized files</a></li>
+<li><a href="#index-GNU-C-compiler-bugs-378">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-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-GSFTOPK_005fDEBUG-_0040r_007b_0028128_0029_007d-335"><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-340">hash table buckets, printing</a>: <a href="#Debugging">Debugging</a></li>
+<li><a href="#index-hash-table-routines-809">hash table routines</a>: <a href="#Calling-sequence">Calling sequence</a></li>
+<li><a href="#index-hash_005fsummary_005fonly-_0040r_007bvariable-for-debugging_007d-339"><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-311">help, mailing list for general TeX</a>: <a href="#Mailing-lists">Mailing lists</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-home-directories-in-paths-492">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-495"><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-382">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-467">identifiers, characters valid in</a>: <a href="#Config-files">Config files</a></li>
+<li><a href="#index-illegal-pointer-combination-warnings-416">illegal pointer combination warnings</a>: <a href="#Pointer-combination-warnings">Pointer combination warnings</a></li>
+<li><a href="#index-include-_0040r_007bfontmap-directive_007d-743"><code>include </code><span class="roman">fontmap directive</span></a>: <a href="#Fontmap">Fontmap</a></li>
+<li><a href="#index-INDEXSTYLE-631"><code>INDEXSTYLE</code></a>: <a href="#Supported-file-formats">Supported file formats</a></li>
+<li><a href="#index-info_002dtex_0040_0040shsu_002eedu-312"><code>info-tex@shsu.edu</code></a>: <a href="#Mailing-lists">Mailing lists</a></li>
+<li><a href="#index-input-lines_002c-reading-813">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>
@@ -4714,123 +4558,119 @@ Up:&nbsp;<a rel="up" accesskey="u" href="#Top">Top</a>
<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-interactive-query-556">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-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-g_t_0040samp_007bkdebug_003a_007d-338">&lsquo;<samp><span class="samp">kdebug:</span></samp>&rsquo;</a>: <a href="#Debugging">Debugging</a></li>
+<li><a href="#index-kdefault_002ec-482"><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-Knuth_002c-Donald-E_002e_002c-archive-of-programs-by-282">Knuth, Donald E., archive of programs by</a>: <a href="#unixtex_002eftp">unixtex.ftp</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-kpathsae_005fvar_005fvalue-819"><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-451">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_002eh-777"><code>kpathsea.h</code></a>: <a href="#Programming-overview">Programming overview</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-kpathsea_005fcnf_005fget-822"><code>kpathsea_cnf_get</code></a>: <a href="#Programming-with-config-files">Programming with config files</a></li>
+<li><a href="#index-KPATHSEA_005fDEBUG-790"><code>KPATHSEA_DEBUG</code></a>: <a href="#Calling-sequence">Calling sequence</a></li>
+<li><a href="#index-KPATHSEA_005fDEBUG-319"><code>KPATHSEA_DEBUG</code></a>: <a href="#Debugging">Debugging</a></li>
+<li><a href="#index-kpathsea_005ffind_005ffile-804"><code>kpathsea_find_file</code></a>: <a href="#Calling-sequence">Calling sequence</a></li>
+<li><a href="#index-kpathsea_005ffind_005ffile-723"><code>kpathsea_find_file</code></a>: <a href="#File-lookup">File lookup</a></li>
+<li><a href="#index-kpathsea_005ffind_005fglyph-728"><code>kpathsea_find_glyph</code></a>: <a href="#Glyph-lookup">Glyph lookup</a></li>
+<li><a href="#index-kpathsea_005ffinish-808"><code>kpathsea_finish</code></a>: <a href="#Calling-sequence">Calling sequence</a></li>
+<li><a href="#index-kpathsea_005fin_005fname_005fok-807"><code>kpathsea_in_name_ok</code></a>: <a href="#Calling-sequence">Calling sequence</a></li>
+<li><a href="#index-kpathsea_005finit_005fprog-802"><code>kpathsea_init_prog</code></a>: <a href="#Calling-sequence">Calling sequence</a></li>
+<li><a href="#index-kpathsea_005finit_005fprog-755"><code>kpathsea_init_prog</code></a>: <a href="#Fallback-font">Fallback font</a></li>
+<li><a href="#index-kpathsea_005fnew-783"><code>kpathsea_new</code></a>: <a href="#Calling-sequence">Calling sequence</a></li>
+<li><a href="#index-kpathsea_005fopen_005ffile-805"><code>kpathsea_open_file</code></a>: <a href="#Calling-sequence">Calling sequence</a></li>
+<li><a href="#index-kpathsea_005fout_005fname_005fok-806"><code>kpathsea_out_name_ok</code></a>: <a href="#Calling-sequence">Calling sequence</a></li>
+<li><a href="#index-kpathsea_005fset_005fprogram_005fname-784"><code>kpathsea_set_program_name</code></a>: <a href="#Calling-sequence">Calling sequence</a></li>
+<li><a href="#index-KPATHSEA_005fWARNING-458"><code>KPATHSEA_WARNING</code></a>: <a href="#Config-files">Config files</a></li>
+<li><a href="#index-kpse_002d_003edebug-317"><code>kpse-&gt;debug</code></a>: <a href="#Debugging">Debugging</a></li>
+<li><a href="#index-kpse_002d_003edebug-_0040r_007bvariable_007d-796"><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-799"><code>kpse-&gt;format_info</code></a>: <a href="#Calling-sequence">Calling sequence</a></li>
+<li><a href="#index-kpse_002d_003einvocation_005fname-786"><code>kpse-&gt;invocation_name</code></a>: <a href="#Calling-sequence">Calling sequence</a></li>
+<li><a href="#index-kpse_002d_003einvocation_005fshort_005fname-787"><code>kpse-&gt;invocation_short_name</code></a>: <a href="#Calling-sequence">Calling sequence</a></li>
+<li><a href="#index-kpse_002d_003eprogram_005fname-788"><code>kpse-&gt;program_name</code></a>: <a href="#Calling-sequence">Calling sequence</a></li>
+<li><a href="#index-KPSE_005fBITMAP_005fTOLERANCE-733"><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-332"><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-328"><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-327"><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-330"><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-333"><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-326"><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-334"><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-505"><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-331"><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-kpsewhich-543"><code>kpsewhich</code></a>: <a href="#Invoking-kpsewhich">Invoking kpsewhich</a></li>
+<li><a href="#index-Kpsewhich_002c-and-debugging-324">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-last_002dresort-font-748">last-resort font</a>: <a href="#Fallback-font">Fallback font</a></li>
+<li><a href="#index-La_0040TeX_007b_007d-help-mailing-list-308">LaTeX help mailing list</a>: <a href="#Mailing-lists">Mailing lists</a></li>
+<li><a href="#index-lcircle10-740"><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-leading-colons-476">leading colons</a>: <a href="#Default-expansion">Default expansion</a></li>
+<li><a href="#index-leaf-directories-wrongly-guessed-358">leaf directories wrongly guessed</a>: <a href="#Unable-to-find-files">Unable to find files</a></li>
+<li><a href="#index-leaf-directory-trick-511">leaf directory trick</a>: <a href="#Subdirectory-expansion">Subdirectory expansion</a></li>
+<li><a href="#index-libdl_002ea-398"><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-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-LIGFONTS-633"><code>LIGFONTS</code></a>: <a href="#Supported-file-formats">Supported file formats</a></li>
+<li><a href="#index-lines_002c-reading-arbitrary_002dlength-814">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-log-file-341">log file</a>: <a href="#Logging">Logging</a></li>
+<li><a href="#index-logging-successful-searches-342">logging successful searches</a>: <a href="#Logging">Logging</a></li>
+<li><a href="#index-lost_002bfound-_0040r_007bdirectory_007d-445"><code>lost+found </code><span class="roman">directory</span></a>: <a href="#Searching-overview">Searching overview</a></li>
+<li><a href="#index-lostchar-762"><code>lostchar</code></a>: <a href="#Suppressing-warnings">Suppressing warnings</a></li>
+<li><a href="#index-ls_002dR-634"><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-ls_002dR-_0040r_007bdatabase-file_007d-521"><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-523"><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-389">Mach10 <code>configure</code> error</a>: <a href="#Empty-Makefiles">Empty Makefiles</a></li>
+<li><a href="#index-MacKenzie_002c-David-513">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-magic-characters-423">magic characters</a>: <a href="#Searching-overview">Searching overview</a></li>
+<li><a href="#index-mailing-lists-303">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-Makefiles_002c-empty-384">Makefiles, empty</a>: <a href="#Empty-Makefiles">Empty Makefiles</a></li>
+<li><a href="#index-MAKETEX_005fDEBUG-_0040r_007b_0028512_0029_007d-336"><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-337"><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-memory-allocation-routines-810">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-Metafont-failures-375">Metafont failures</a>: <a href="#TeX-or-Metafont-failing">TeX or Metafont failing</a></li>
+<li><a href="#index-Metafont-installation-373">Metafont installation</a>: <a href="#Unable-to-generate-fonts">Unable to generate fonts</a></li>
+<li><a href="#index-Metafont-making-too_002dlarge-fonts-369">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-365">Metafont using the wrong device</a>: <a href="#Unable-to-generate-fonts">Unable to generate fonts</a></li>
+<li><a href="#index-MFBASES-596"><code>MFBASES</code></a>: <a href="#Supported-file-formats">Supported file formats</a></li>
+<li><a href="#index-MFINPUTS-643"><code>MFINPUTS</code></a>: <a href="#Supported-file-formats">Supported file formats</a></li>
+<li><a href="#index-MFPOOL-645"><code>MFPOOL</code></a>: <a href="#Supported-file-formats">Supported file formats</a></li>
+<li><a href="#index-MFTINPUTS-647"><code>MFTINPUTS</code></a>: <a href="#Supported-file-formats">Supported file formats</a></li>
+<li><a href="#index-MISCFONTS-648"><code>MISCFONTS</code></a>: <a href="#Supported-file-formats">Supported file formats</a></li>
+<li><a href="#index-mismatched-checksum-warnings-761">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-missing-character-warnings-763">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-570"><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>
@@ -4838,321 +4678,312 @@ Up:&nbsp;<a rel="up" accesskey="u" href="#Top">Top</a>
<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-g_t_0040code_007bmktexpk_007d-can_0027t-guess-mode-364"><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-MLBIBINPUTS-650"><code>MLBIBINPUTS</code></a>: <a href="#Supported-file-formats">Supported file formats</a></li>
+<li><a href="#index-MLBSTINPUTS-654"><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-MPINPUTS-657"><code>MPINPUTS</code></a>: <a href="#Supported-file-formats">Supported file formats</a></li>
+<li><a href="#index-MPMEMS-639"><code>MPMEMS</code></a>: <a href="#Supported-file-formats">Supported file formats</a></li>
+<li><a href="#index-MPPOOL-659"><code>MPPOOL</code></a>: <a href="#Supported-file-formats">Supported file formats</a></li>
+<li><a href="#index-MPSUPPORT-641"><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-multiple-_0040TeX_007b_007d-hierarchies-503">multiple TeX hierarchies</a>: <a href="#Brace-expansion">Brace expansion</a></li>
+<li><a href="#index-must-exist-432">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-_0040code_007bconfigure_007d-error-387">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-newsgroup-for-_0040TeX_007b_007d-310">newsgroup for TeX</a>: <a href="#Mailing-lists">Mailing lists</a></li>
+<li><a href="#index-NeXT-_0040code_007bsed_007d-error-391">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-NFS-and-_0040file_007bls_002dR_007d-534">NFS and <samp><span class="file">ls-R</span></samp></a>: <a href="#ls_002dR">ls-R</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-none-764"><code>none</code></a>: <a href="#Suppressing-warnings">Suppressing warnings</a></li>
+<li><a href="#index-null-pointers_002c-dereferencing-301">null pointers, dereferencing</a>: <a href="#Bug-checklist">Bug checklist</a></li>
+<li><a href="#index-numeric-debugging-values-325">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-OCPINPUTS-661"><code>OCPINPUTS</code></a>: <a href="#Supported-file-formats">Supported file formats</a></li>
+<li><a href="#index-OFMFONTS-663"><code>OFMFONTS</code></a>: <a href="#Supported-file-formats">Supported file formats</a></li>
+<li><a href="#index-online-Metafont-display_002c-spurious-371">online Metafont display, spurious</a>: <a href="#Unable-to-generate-fonts">Unable to generate fonts</a></li>
+<li><a href="#index-OPENTYPEFONTS-664"><code>OPENTYPEFONTS</code></a>: <a href="#Supported-file-formats">Supported file formats</a></li>
+<li><a href="#index-OpenWin-libraries_002c-dynamic-linking-problems-401">OpenWin libraries, dynamic linking problems</a>: <a href="#ShellWidgetClass">ShellWidgetClass</a></li>
+<li><a href="#index-optimization-caveat-377">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-for-debugging-316">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-OTPINPUTS-667"><code>OTPINPUTS</code></a>: <a href="#Supported-file-formats">Supported file formats</a></li>
+<li><a href="#index-overview-of-path-searching-421">overview of path searching</a>: <a href="#Searching-overview">Searching overview</a></li>
+<li><a href="#index-overview-of-programming-with-Kpathsea-771">overview of programming with Kpathsea</a>: <a href="#Programming-overview">Programming overview</a></li>
+<li><a href="#index-OVFFONTS-669"><code>OVFFONTS</code></a>: <a href="#Supported-file-formats">Supported file formats</a></li>
+<li><a href="#index-OVPFONTS-671"><code>OVPFONTS</code></a>: <a href="#Supported-file-formats">Supported file formats</a></li>
+<li><a href="#index-patches_002c-Sun-OpenWin-408">patches, Sun OpenWin</a>: <a href="#ShellWidgetClass">ShellWidgetClass</a></li>
+<li><a href="#index-path-expansion-472">path expansion</a>: <a href="#Path-expansion">Path expansion</a></li>
+<li><a href="#index-path-searching-418">path searching</a>: <a href="#Path-searching">Path searching</a></li>
+<li><a href="#index-path-searching-options-546">path searching options</a>: <a href="#Path-searching-options">Path searching options</a></li>
+<li><a href="#index-path-searching_002c-overview-420">path searching, overview</a>: <a href="#Searching-overview">Searching overview</a></li>
+<li><a href="#index-path-searching_002c-standalone-544">path searching, standalone</a>: <a href="#Invoking-kpsewhich">Invoking kpsewhich</a></li>
+<li><a href="#index-path-sources-447">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-pathsearch_002eh-774"><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-pdfglyphlist_002etxt-571"><code>pdfglyphlist.txt</code></a>: <a href="#Specially_002drecognized-files">Specially-recognized files</a></li>
+<li><a href="#index-pdftex_002ecfg-572"><code>pdftex.cfg</code></a>: <a href="#Specially_002drecognized-files">Specially-recognized files</a></li>
+<li><a href="#index-PDFTEXCONFIG-672"><code>PDFTEXCONFIG</code></a>: <a href="#Supported-file-formats">Supported file formats</a></li>
+<li><a href="#index-pdftexconfig_002etex-573"><code>pdftexconfig.tex</code></a>: <a href="#Specially_002drecognized-files">Specially-recognized files</a></li>
+<li><a href="#index-permission-denied-441">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-PKFONTS-674"><code>PKFONTS</code></a>: <a href="#Supported-file-formats">Supported file formats</a></li>
+<li><a href="#index-plain_002ebase-372"><code>plain.base</code></a>: <a href="#Unable-to-generate-fonts">Unable to generate fonts</a></li>
+<li><a href="#index-pointer-combination-warnings-415">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-privacy_002c-semblance-of-349">privacy, semblance of</a>: <a href="#Logging">Logging</a></li>
+<li><a href="#index-problems_002c-common-351">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-proginit_002eh-803"><code>proginit.h</code></a>: <a href="#Calling-sequence">Calling sequence</a></li>
+<li><a href="#index-program_002dvarying-paths-592">program-varying paths</a>: <a href="#Supported-file-formats">Supported file formats</a></li>
+<li><a href="#index-programming-overview-770">programming overview</a>: <a href="#Programming-overview">Programming overview</a></li>
+<li><a href="#index-programming-with-config-files-817">programming with config files</a>: <a href="#Programming-with-config-files">Programming with config files</a></li>
+<li><a href="#index-programming-with-Kpathsea-781">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-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-proof-mode-370">proof mode</a>: <a href="#Unable-to-generate-fonts">Unable to generate fonts</a></li>
+<li><a href="#index-PSHEADERS-680"><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-quoting-variable-values-488">quoting variable values</a>: <a href="#Variable-expansion">Variable expansion</a></li>
+<li><a href="#index-re_002dentrant-API-772">re-entrant API</a>: <a href="#Programming-overview">Programming overview</a></li>
+<li><a href="#index-readable-765"><code>readable</code></a>: <a href="#Suppressing-warnings">Suppressing warnings</a></li>
+<li><a href="#index-reading-arbitrary_002dlength-lines-812">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-recording-successful-searches-343">recording successful searches</a>: <a href="#Logging">Logging</a></li>
+<li><a href="#index-relative-filenames-438">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-reporting-bugs-283">reporting bugs</a>: <a href="#Reporting-bugs">Reporting bugs</a></li>
+<li><a href="#index-resident_002ec-800"><code>resident.c</code></a>: <a href="#Calling-sequence">Calling sequence</a></li>
+<li><a href="#index-resolution_002c-setting-551">resolution, setting</a>: <a href="#Path-searching-options">Path searching options</a></li>
+<li><a href="#index-resolutions_002c-last_002dresort-747">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-right_002dhand-side-of-variable-assignments-468">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-g_t_0040t_007broot_007d-user-497"><tt>root</tt> user</a>: <a href="#Tilde-expansion">Tilde expansion</a></li>
+<li><a href="#index-runtime-configuration-files-456">runtime configuration files</a>: <a href="#Config-files">Config files</a></li>
+<li><a href="#index-runtime-debugging-315">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-path_002c-defined-422">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-searching-for-files-717">searching for files</a>: <a href="#File-lookup">File lookup</a></li>
+<li><a href="#index-searching-for-glyphs-725">searching for glyphs</a>: <a href="#Glyph-lookup">Glyph lookup</a></li>
+<li><a href="#index-searching-overview-419">searching overview</a>: <a href="#Searching-overview">Searching overview</a></li>
+<li><a href="#index-searching-the-database-427">searching the database</a>: <a href="#Searching-overview">Searching overview</a></li>
+<li><a href="#index-searching-the-disk-431">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-sed-_0040r_007berror-from-_0040code_007bconfigure_007d_007d-385"><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-792">SELFAUTODIR</a>: <a href="#Calling-sequence">Calling sequence</a></li>
+<li><a href="#index-SELFAUTOLOC-791">SELFAUTOLOC</a>: <a href="#Calling-sequence">Calling sequence</a></li>
+<li><a href="#index-SELFAUTOPARENT-793">SELFAUTOPARENT</a>: <a href="#Calling-sequence">Calling sequence</a></li>
+<li><a href="#index-sending-patches-295">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-SFDFONTS-682"><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-shell-scripts-as-configuration-files-469">shell scripts as configuration files</a>: <a href="#Config-files">Config files</a></li>
+<li><a href="#index-shell-variables-489">shell variables</a>: <a href="#Variable-expansion">Variable expansion</a></li>
+<li><a href="#index-shell_005fescape_0040r_007b_002c-example-for-code_007d-821"><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-slow-startup-time-360">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-source-files-687"><code>source files</code></a>: <a href="#Supported-file-formats">Supported file formats</a></li>
+<li><a href="#index-sources-for-search-paths-448">sources for search paths</a>: <a href="#Path-sources">Path sources</a></li>
+<li><a href="#index-special-767"><code>special</code></a>: <a href="#Suppressing-warnings">Suppressing warnings</a></li>
+<li><a href="#index-st_005fnlink-514"><code>st_nlink</code></a>: <a href="#Subdirectory-expansion">Subdirectory expansion</a></li>
+<li><a href="#index-ST_005fNLINK_005fTRICK-515"><code>ST_NLINK_TRICK</code></a>: <a href="#Subdirectory-expansion">Subdirectory expansion</a></li>
+<li><a href="#index-stack-trace-297">stack trace</a>: <a href="#Bug-checklist">Bug checklist</a></li>
+<li><a href="#index-standalone-path-searching-545">standalone path searching</a>: <a href="#Invoking-kpsewhich">Invoking kpsewhich</a></li>
+<li><a href="#index-standard-error-and-debugging-output-323">standard error and debugging output</a>: <a href="#Debugging">Debugging</a></li>
+<li><a href="#index-standard-options-584">standard options</a>: <a href="#Standard-options">Standard options</a></li>
+<li><a href="#index-startup-time_002c-excessive-361">startup time, excessive</a>: <a href="#Slow-path-searching">Slow path searching</a></li>
+<li><a href="#index-static-linking-409">static linking</a>: <a href="#ShellWidgetClass">ShellWidgetClass</a></li>
+<li><a href="#index-static-linking-and-_0040code_007bdlsym_007d-393">static linking and <code>dlsym</code></a>: <a href="#dlopen">dlopen</a></li>
+<li><a href="#index-string-routines-811">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-subdirectory-searching-507">subdirectory searching</a>: <a href="#Subdirectory-expansion">Subdirectory expansion</a></li>
+<li><a href="#index-suffixes_002c-filename-720">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-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-Sun-OpenWin-patches-407">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-supported-file-formats-588">supported file formats</a>: <a href="#Supported-file-formats">Supported file formats</a></li>
+<li><a href="#index-suppressing-warnings-757">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-symbolic-links-not-found-357">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-531">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-794">symlinks, resolving</a>: <a href="#Calling-sequence">Calling sequence</a></li>
+<li><a href="#index-system-C-compiler-bugs-379">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-T1FONTS-701"><code>T1FONTS</code></a>: <a href="#Supported-file-formats">Supported file formats</a></li>
+<li><a href="#index-T1INPUTS-702"><code>T1INPUTS</code></a>: <a href="#Supported-file-formats">Supported file formats</a></li>
+<li><a href="#index-T42FONTS-705"><code>T42FONTS</code></a>: <a href="#Supported-file-formats">Supported file formats</a></li>
+<li><a href="#index-tcfmgr_002emap-576"><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-TDS-72">TDS</a>: <a href="#Default-path-features">Default path features</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-directory-structure-73">TeX directory structure</a>: <a href="#Default-path-features">Default path features</a></li>
+<li><a href="#index-g_t_0040TeX_007b_007d-environment-variables-591">TeX environment variables</a>: <a href="#Supported-file-formats">Supported file formats</a></li>
+<li><a href="#index-g_t_0040TeX_007b_007d-failures-374">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-718">TeX file lookup</a>: <a href="#File-lookup">File lookup</a></li>
+<li><a href="#index-g_t_0040TeX_007b_007d-glyph-lookup-726">TeX glyph lookup</a>: <a href="#Glyph-lookup">Glyph lookup</a></li>
+<li><a href="#index-g_t_0040TeX_007b_007d-help-mailing-list-307">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-support-587">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_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-tex_002dfile_002ec-722"><code>tex-file.c</code></a>: <a href="#File-lookup">File lookup</a></li>
+<li><a href="#index-tex_002dfile_002eh-775"><code>tex-file.h</code></a>: <a href="#Programming-overview">Programming overview</a></li>
+<li><a href="#index-tex_002dglyph_002ec-727"><code>tex-glyph.c</code></a>: <a href="#Glyph-lookup">Glyph lookup</a></li>
+<li><a href="#index-tex_002dglyph_002eh-776"><code>tex-glyph.h</code></a>: <a href="#Programming-overview">Programming overview</a></li>
+<li><a href="#index-tex_002dk_002drequest_0040_0040tug_002eorg-306"><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-285"><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_002eweb-281"><code>tex.web</code></a>: <a href="#unixtex_002eftp">unixtex.ftp</a></li>
+<li><a href="#index-TEX_005fHUSH-758"><code>TEX_HUSH</code></a>: <a href="#Suppressing-warnings">Suppressing warnings</a></li>
+<li><a href="#index-TEX_005fHUSH-446"><code>TEX_HUSH</code></a>: <a href="#Searching-overview">Searching overview</a></li>
+<li><a href="#index-TEXBIB-600"><code>TEXBIB</code></a>: <a href="#Supported-file-formats">Supported file formats</a></li>
+<li><a href="#index-TEXCONFIG-610"><code>TEXCONFIG</code></a>: <a href="#Supported-file-formats">Supported file formats</a></li>
+<li><a href="#index-TEXDOCS-686"><code>TEXDOCS</code></a>: <a href="#Supported-file-formats">Supported file formats</a></li>
+<li><a href="#index-TEXFONTMAPS-637"><code>TEXFONTMAPS</code></a>: <a href="#Supported-file-formats">Supported file formats</a></li>
+<li><a href="#index-TEXFONTS-624"><code>TEXFONTS</code></a>: <a href="#Supported-file-formats">Supported file formats</a></li>
+<li><a href="#index-texfonts_002emap-737"><code>texfonts.map</code></a>: <a href="#Fontmap">Fontmap</a></li>
+<li><a href="#index-TEXFORMATS-615"><code>TEXFORMATS</code></a>: <a href="#Supported-file-formats">Supported file formats</a></li>
+<li><a href="#index-TEXINDEXSTYLE-630"><code>TEXINDEXSTYLE</code></a>: <a href="#Supported-file-formats">Supported file formats</a></li>
+<li><a href="#index-TEXINPUTS-628"><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-574"><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-460"><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-487"><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-definition-for_007d-455"><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_002ecnf_0040r_007b_002c-source-for-path_007d-452"><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-TEXMFCNF-606"><code>TEXMFCNF</code></a>: <a href="#Supported-file-formats">Supported file formats</a></li>
+<li><a href="#index-TEXMFCNF-457"><code>TEXMFCNF</code></a>: <a href="#Config-files">Config files</a></li>
+<li><a href="#index-TEXMFDBS-635"><code>TEXMFDBS</code></a>: <a href="#Supported-file-formats">Supported file formats</a></li>
+<li><a href="#index-TEXMFDBS-522"><code>TEXMFDBS</code></a>: <a href="#ls_002dR">ls-R</a></li>
+<li><a href="#index-TEXMFINI-597"><code>TEXMFINI</code></a>: <a href="#Supported-file-formats">Supported file formats</a></li>
+<li><a href="#index-TEXMFLOG-346"><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-TEXMFSCRIPTS-689"><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-TEXPICTS-627"><code>TEXPICTS</code></a>: <a href="#Supported-file-formats">Supported file formats</a></li>
+<li><a href="#index-TEXPKS-675"><code>TEXPKS</code></a>: <a href="#Supported-file-formats">Supported file formats</a></li>
+<li><a href="#index-TEXPOOL-691"><code>TEXPOOL</code></a>: <a href="#Supported-file-formats">Supported file formats</a></li>
+<li><a href="#index-TEXPSHEADERS-679"><code>TEXPSHEADERS</code></a>: <a href="#Supported-file-formats">Supported file formats</a></li>
+<li><a href="#index-TEXSIZES-752"><code>TEXSIZES</code></a>: <a href="#Fallback-font">Fallback font</a></li>
+<li><a href="#index-TEXSOURCES-688"><code>TEXSOURCES</code></a>: <a href="#Supported-file-formats">Supported file formats</a></li>
+<li><a href="#index-TFMFONTS-693"><code>TFMFONTS</code></a>: <a href="#Supported-file-formats">Supported file formats</a></li>
+<li><a href="#index-tilde-expansion-493">tilde expansion</a>: <a href="#Tilde-expansion">Tilde expansion</a></li>
+<li><a href="#index-tilde_002ec-500"><code>tilde.c</code></a>: <a href="#Tilde-expansion">Tilde expansion</a></li>
+<li><a href="#index-time-_0040r_007bsystem-call_007d-348"><code>time </code><span class="roman">system call</span></a>: <a href="#Logging">Logging</a></li>
+<li><a href="#index-tolerance-for-glyph-lookup-731">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-trailing-_0040samp_007b_002f_007d-in-home-directory-498">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-477">trailing colons</a>: <a href="#Default-expansion">Default expansion</a></li>
+<li><a href="#index-TRFONTS-695"><code>TRFONTS</code></a>: <a href="#Supported-file-formats">Supported file formats</a></li>
+<li><a href="#index-trick-for-detecting-leaf-directories-510">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-try_005fstd_005fextension_005ffirst-721"><code>try_std_extension_first</code></a>: <a href="#File-lookup">File lookup</a></li>
+<li><a href="#index-TTFONTS-698"><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-unable-to-find-files-353">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-362">unable to generate fonts</a>: <a href="#Unable-to-generate-fonts">Unable to generate fonts</a></li>
+<li><a href="#index-uname-290"><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-unknown-special-warnings-768">unknown special warnings</a>: <a href="#Suppressing-warnings">Suppressing warnings</a></li>
+<li><a href="#index-unreadable-file-warnings-766">unreadable file warnings</a>: <a href="#Suppressing-warnings">Suppressing warnings</a></li>
+<li><a href="#index-unreadable-files-442">unreadable files</a>: <a href="#Searching-overview">Searching overview</a></li>
+<li><a href="#index-unusable-_0040file_007bls_002dR_007d-warning-536">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-344">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-Usenet-_0040TeX_007b_007d-newsgroup-309">Usenet TeX newsgroup</a>: <a href="#Mailing-lists">Mailing lists</a></li>
+<li><a href="#index-USERPROFILE_0040r_007b_002c-as-_007e-expansion_007d-496"><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-variable-expansion-485">variable expansion</a>: <a href="#Variable-expansion">Variable expansion</a></li>
+<li><a href="#index-variable_002ec-490"><code>variable.c</code></a>: <a href="#Variable-expansion">Variable expansion</a></li>
+<li><a href="#index-variable_002eh-820"><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-version-numbers_002c-determining-289">version numbers, determining</a>: <a href="#Bug-checklist">Bug checklist</a></li>
+<li><a href="#index-VF-files_002c-not-found-433">VF files, not found</a>: <a href="#Searching-overview">Searching overview</a></li>
+<li><a href="#index-VFFONTS-707"><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-warning-about-unusable-_0040file_007bls_002dR_007d-535">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-459">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-444">warnings, file access</a>: <a href="#Searching-overview">Searching overview</a></li>
+<li><a href="#index-warnings_002c-pointer-combinations-414">warnings, pointer combinations</a>: <a href="#Pointer-combination-warnings">Pointer combination warnings</a></li>
+<li><a href="#index-warnings_002c-suppressing-756">warnings, suppressing</a>: <a href="#Suppressing-warnings">Suppressing warnings</a></li>
+<li><a href="#index-wcstombs-397"><code>wcstombs</code></a>: <a href="#dlopen">dlopen</a></li>
+<li><a href="#index-WEB2C-711"><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-WEBINPUTS-710"><code>WEBINPUTS</code></a>: <a href="#Supported-file-formats">Supported file formats</a></li>
+<li><a href="#index-whitespace_002c-in-fontmap-files-742">whitespace, in fontmap files</a>: <a href="#Fontmap">Fontmap</a></li>
+<li><a href="#index-whitespace_002c-not-ignored-on-continuation-lines-465">whitespace, not ignored on continuation lines</a>: <a href="#Config-files">Config files</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-XDvi-575"><code>XDvi</code></a>: <a href="#Specially_002drecognized-files">Specially-recognized files</a></li>
+<li><a href="#index-XDVIFONTS-714"><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-XDVISIZES-750"><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-Xmu-_0040r_007blibrary-problems_007d-406"><code>Xmu </code><span class="roman">library problems</span></a>: <a href="#ShellWidgetClass">ShellWidgetClass</a></li>
+<li><a href="#index-XtStrings-392"><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>
+<li><a href="#index-g_t_0040_007b-_0040r_007bexpansion_007d-501"><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-491"><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 1461ebc91ce..fd41680f38a 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 db13d9fec9b..e02c15e6a98 100644
--- a/Master/texmf/doc/web2c/web2c.html
+++ b/Master/texmf/doc/web2c/web2c.html
@@ -159,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 2009, released in
-July 2009.
+corresponds to Web2c version 2010, released in
+July 2010.
<ul class="menu">
<li><a accesskey="1" href="#Introduction">Introduction</a>: A brief introduction.
@@ -190,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 2009 of Web2c, released in
-July 2009.
+This manual corresponds to version 2010 of Web2c, released in
+July 2010.
<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
@@ -658,7 +658,7 @@ name. See <a href="#Memory-dumps">Memory dumps</a>.
<br><dt>&lsquo;<samp><span class="samp">-recorder</span></samp>&rsquo;<dd><a name="index-g_t_002drecorder-132"></a><a name="index-file-recorder-133"></a>Enable the filename recorder. This makes the program save a list of the
opened files into a file with (by default) extension &lsquo;<samp><span class="samp">.fls</span></samp>&rsquo;. For
-Omega, this option is always on, and the file has extension &lsquo;<samp><span class="samp">.ofl</span></samp>&rsquo;.
+Aleph, this option is always on, and the file has extension &lsquo;<samp><span class="samp">.ofl</span></samp>&rsquo;.
<br><dt>&lsquo;<samp><span class="samp">-translate-file=</span><var>tcxfile</var></samp>&rsquo;<dd><a name="index-g_t_002dtranslate_002dfile_003d_0040var_007btcxfile_007d-134"></a><a name="index-translation-file-for-_0040TeX_007b_007d_002c-specifying-135"></a><a name="index-g_t_002etcx-_0040r_007bcharacter-translation-files_007d-136"></a><a name="index-first-line-of-the-main-input-file-137"></a>Use <var>tcxfile</var> to define which characters are printable and translations
between the internal and external character sets. Moreover,
@@ -733,6 +733,11 @@ BibTeX) make an exception: if the config file value
<code>TEXMFOUTPUT</code> is set (it is not by default), output files are
written to the directory specified.
+ <p><a name="index-TEXMFOUTPUT_0040r_007b_002c-used-for-reading_007d-157"></a><code>TEXMFOUTPUT</code> is also checked for input files, as TeX often
+generates files that need to be subsequently read; for input, no
+suffixes (such as &lsquo;<samp><span class="samp">.tex</span></samp>&rsquo;) are added by default, the input name is
+simply checked as given.
+
<div class="node">
<a name="Three-programs"></a>
<p><hr>
@@ -743,7 +748,7 @@ Up:&nbsp;<a rel="up" accesskey="u" href="#Commonalities">Commonalities</a>
<h3 class="section">3.5 Three programs: Metafont, MetaPost, and TeX</h3>
-<p><a name="index-three-programs-157"></a><a name="index-g_t_0040TeX_007b_007d_002c-Metafont_002c-and-MetaPost-158"></a><a name="index-Metafont_002c-MetaPost_002c-and-_0040TeX_007b_007d-159"></a><a name="index-MetaPost_002c-_0040TeX_007b_007d_002c-and-Metafont-160"></a>
+<p><a name="index-three-programs-158"></a><a name="index-g_t_0040TeX_007b_007d_002c-Metafont_002c-and-MetaPost-159"></a><a name="index-Metafont_002c-MetaPost_002c-and-_0040TeX_007b_007d-160"></a><a name="index-MetaPost_002c-_0040TeX_007b_007d_002c-and-Metafont-161"></a>
TeX, Metafont, and MetaPost have a number of features in common.
Besides the ones here, the common command-line options are described in
the previous section. The configuration file options that let you
@@ -767,24 +772,24 @@ Up:&nbsp;<a rel="up" accesskey="u" href="#Three-programs">Three programs</a>
<h4 class="subsection">3.5.1 Initial and virgin</h4>
-<p><a name="index-executables_002c-shared-initial-and-virgin-161"></a>The TeX, Metafont, and MetaPost programs each have two main
+<p><a name="index-executables_002c-shared-initial-and-virgin-162"></a>The TeX, Metafont, and MetaPost programs each have two main
variants, called <dfn>initial</dfn> and <dfn>virgin</dfn>. As of Web2c 7, one
executable suffices for both variants, and in fact, the <code>ini...</code>
executables are no longer created.
<p>The initial form is enabled if:
<ol type=1 start=1>
-<li><a name="index-g_t_002dini-162"></a>the &lsquo;<samp><span class="samp">-ini</span></samp>&rsquo; option was specified; or
+<li><a name="index-g_t_002dini-163"></a>the &lsquo;<samp><span class="samp">-ini</span></samp>&rsquo; option was specified; or
<li>the program name is <samp><span class="file">initex</span></samp> resp. <samp><span class="file">inimf</span></samp> resp.
<samp><span class="file">inimpost</span></samp> (these variants are no longer typically installed); or
<li>the first line of the main input file is &lsquo;<samp><span class="samp">%&amp;ini</span></samp>&rsquo;;
</ol>
otherwise, the virgin form is used.
- <p><a name="index-virgin-programs-163"></a><a name="index-production-use-164"></a>The <dfn>virgin</dfn> form is the one generally invoked for production use.
+ <p><a name="index-virgin-programs-164"></a><a name="index-production-use-165"></a>The <dfn>virgin</dfn> form is the one generally invoked for production use.
The first thing it does is read a memory dump (see <a href="#Determining-the-memory-dump-to-use">Determining the memory dump to use</a>), and then proceeds on with the main job.
- <p><a name="index-initial-programs-165"></a><a name="index-initializations_002c-lengthy-166"></a>The <dfn>initial</dfn> form is generally used only to create memory dumps
+ <p><a name="index-initial-programs-166"></a><a name="index-initializations_002c-lengthy-167"></a>The <dfn>initial</dfn> form is generally used only to create memory dumps
(see the next section). It starts up more slowly than the virgin form,
because it must do lengthy initializations that are encapsulated in the
memory dump file.
@@ -800,8 +805,8 @@ Up:&nbsp;<a rel="up" accesskey="u" href="#Three-programs">Three programs</a>
<h4 class="subsection">3.5.2 Memory dumps</h4>
-<p><a name="index-memory-dumps-167"></a>
-<a name="index-dumping-memory-168"></a><a name="index-macros_002c-predefining-in-memory-dumps-169"></a><a name="index-predefined-macros-and-memory-dumps-170"></a>In typical use, TeX, Metafont, and MetaPost require a large number of
+<p><a name="index-memory-dumps-168"></a>
+<a name="index-dumping-memory-169"></a><a name="index-macros_002c-predefining-in-memory-dumps-170"></a><a name="index-predefined-macros-and-memory-dumps-171"></a>In typical use, TeX, Metafont, and MetaPost require a large number of
macros to be predefined; therefore, they support <dfn>memory dump</dfn>
files, which can be read much more efficiently than ordinary source
code.
@@ -822,7 +827,7 @@ Up:&nbsp;<a rel="up" accesskey="u" href="#Memory-dumps">Memory dumps</a>
<h5 class="subsubsection">3.5.2.1 Creating memory dumps</h5>
-<p><a name="index-memory-dumps_002c-creating-171"></a><a name="index-creating-memory-dumps-172"></a><a name="index-writing-memory-dumps-173"></a>
+<p><a name="index-memory-dumps_002c-creating-172"></a><a name="index-creating-memory-dumps-173"></a><a name="index-writing-memory-dumps-174"></a>
The programs all create memory dumps in slightly idiosyncratic (thought
substantially similar) way, so we describe the details in separate
sections (references below). The basic idea is to run the initial
@@ -862,7 +867,7 @@ Up:&nbsp;<a rel="up" accesskey="u" href="#Memory-dumps">Memory dumps</a>
<h5 class="subsubsection">3.5.2.2 Determining the memory dump to use</h5>
-<p><a name="index-memory-dump-to-use_002c-determining-174"></a><a name="index-fmt-file_002c-determining-175"></a><a name="index-base-file_002c-determining-176"></a><a name="index-mem-file_002c-determining-177"></a>
+<p><a name="index-memory-dump-to-use_002c-determining-175"></a><a name="index-fmt-file_002c-determining-176"></a><a name="index-base-file_002c-determining-177"></a><a name="index-mem-file_002c-determining-178"></a>
The virgin form (see <a href="#Initial-and-virgin">Initial and virgin</a>) of each program always
reads a memory dump before processing normal source input. All three
programs determine the memory dump to use in the same way:
@@ -873,12 +878,12 @@ program uses the remainder of that argument as the memory dump name.
For example, running &lsquo;<samp><span class="samp">tex \&amp;super</span></samp>&rsquo; reads <samp><span class="file">super.fmt</span></samp>. (The
backslash protects the &lsquo;<samp><span class="samp">&amp;</span></samp>&rsquo; against interpretation by the shell.)
- <li><a name="index-g_t_002dfmt_003d_0040var_007bfmt_007d-178"></a><a name="index-g_t_002dbase_003d_0040var_007bbase_007d-179"></a><a name="index-g_t_002dmem_003d_0040var_007bmem_007d-180"></a>If the &lsquo;<samp><span class="samp">-fmt</span></samp>&rsquo; resp. &lsquo;<samp><span class="samp">-base</span></samp>&rsquo; resp. &lsquo;<samp><span class="samp">-mem</span></samp>&rsquo; option is
+ <li><a name="index-g_t_002dfmt_003d_0040var_007bfmt_007d-179"></a><a name="index-g_t_002dbase_003d_0040var_007bbase_007d-180"></a><a name="index-g_t_002dmem_003d_0040var_007bmem_007d-181"></a>If the &lsquo;<samp><span class="samp">-fmt</span></samp>&rsquo; resp. &lsquo;<samp><span class="samp">-base</span></samp>&rsquo; resp. &lsquo;<samp><span class="samp">-mem</span></samp>&rsquo; option is
specified, its value is used.
- <li><a name="index-g_t_002dprogname_003d_0040var_007bstring_007d-181"></a>If the &lsquo;<samp><span class="samp">-progname</span></samp>&rsquo; option is specified, its value is used.
+ <li><a name="index-g_t_002dprogname_003d_0040var_007bstring_007d-182"></a>If the &lsquo;<samp><span class="samp">-progname</span></samp>&rsquo; option is specified, its value is used.
- <li><a name="index-g_t_0025_0026-_0040r_007bmagic-number_007d-182"></a>If the first line of the main input file (which must be specified on the
+ <li><a name="index-g_t_0025_0026-_0040r_007bmagic-number_007d-183"></a>If the first line of the main input file (which must be specified on the
command line, not in response to &lsquo;<samp><span class="samp">**</span></samp>&rsquo;) is <code>%&amp;</code><var>dump</var>, and
<var>dump</var> is an existing memory dump of the appropriate type,
<var>dump</var> is used.
@@ -891,7 +896,7 @@ translation file is to be used: <code>%&amp;-translate-file=</code><var>tcxfile<
-translate-file=</code><var>tcxfile</var>. If this is done, the name of the dump
must be given first.
- <li><a name="index-program-name_002c-determines-memory-dump-183"></a><a name="index-links-to-binaries-184"></a>Otherwise, the program uses the program invocation name, most commonly
+ <li><a name="index-program-name_002c-determines-memory-dump-184"></a><a name="index-links-to-binaries-185"></a>Otherwise, the program uses the program invocation name, most commonly
<samp><span class="file">tex</span></samp> resp. <samp><span class="file">mf</span></samp> resp. <samp><span class="file">mpost</span></samp>. For example, if
<samp><span class="file">latex</span></samp> is a link to <samp><span class="file">tex</span></samp>, and the user runs &lsquo;<samp><span class="samp">latex
foo</span></samp>&rsquo;, <samp><span class="file">latex.fmt</span></samp> will be used.
@@ -908,15 +913,15 @@ Up:&nbsp;<a rel="up" accesskey="u" href="#Memory-dumps">Memory dumps</a>
<h5 class="subsubsection">3.5.2.3 Hardware and memory dumps</h5>
-<p><a name="index-hardware-and-memory-dumps-185"></a><a name="index-memory-dumps-and-hardware-186"></a><a name="index-sharing-memory-dumps-187"></a><a name="index-fmt-files_002c-sharing-188"></a><a name="index-base-files_002c-sharing-189"></a><a name="index-mem-files_002c-sharing-190"></a>
-<a name="index-LittleEndian-machines-191"></a><a name="index-BigEndian-machines-192"></a><a name="index-endian-dependencies-193"></a><a name="index-machine-dependencies-194"></a><a name="index-architecture-dependencies-195"></a><a name="index-dependencies_002c-hardware-196"></a><a name="index-g_t_002d_002ddisable_002ddump_002dshare-configure-_0040r_007boption_007d-197"></a>By default, memory dump files are generally sharable between
+<p><a name="index-hardware-and-memory-dumps-186"></a><a name="index-memory-dumps-and-hardware-187"></a><a name="index-sharing-memory-dumps-188"></a><a name="index-fmt-files_002c-sharing-189"></a><a name="index-base-files_002c-sharing-190"></a><a name="index-mem-files_002c-sharing-191"></a>
+<a name="index-LittleEndian-machines-192"></a><a name="index-BigEndian-machines-193"></a><a name="index-endian-dependencies-194"></a><a name="index-machine-dependencies-195"></a><a name="index-architecture-dependencies-196"></a><a name="index-dependencies_002c-hardware-197"></a><a name="index-g_t_002d_002ddisable_002ddump_002dshare-configure-_0040r_007boption_007d-198"></a>By default, memory dump files are generally sharable between
architectures of different types; specifically, on machines of different
endianness (see <a href="libc.html#Byte-order">Byte order</a>). (This is a
feature of the Web2c implementation, and is not true of all TeX
implementations.) If you specify &lsquo;<samp><span class="samp">--disable-dump-share</span></samp>&rsquo; to
<code>configure</code>, however, memory dumps will be endian-dependent.
- <p><a name="index-byte-swapping-198"></a><a name="index-swapping-bytes-199"></a>The reason to do this is speed. To achieve endian-independence, the
+ <p><a name="index-byte-swapping-199"></a><a name="index-swapping-bytes-200"></a>The reason to do this is speed. To achieve endian-independence, the
reading of memory dumps on LittleEndian architectures, such as PC's and
DEC architectures, is somewhat slowed (all the multibyte values have to
be swapped). Usually, this is not noticeable, and the advantage of
@@ -925,7 +930,7 @@ outweighs the speed loss. But if you're installing Web2c for use on
LittleEndian machines only, perhaps on a PC being used only by you, you
may wish to get maximum speed.
- <p><a name="index-floating_002dpoint-values-200"></a><a name="index-glue-ratio-representations-201"></a>TeXnically, even without &lsquo;<samp><span class="samp">--disable-dump-share</span></samp>&rsquo;, sharing of
+ <p><a name="index-floating_002dpoint-values-201"></a><a name="index-glue-ratio-representations-202"></a>TeXnically, even without &lsquo;<samp><span class="samp">--disable-dump-share</span></samp>&rsquo;, sharing of
<samp><span class="file">.fmt</span></samp> files cannot be guaranteed to work. Floating-point values
are always written in native format, and hence will generally not be
readable across platforms. Fortunately, TeX uses floating point only
@@ -934,11 +939,11 @@ AMSTeX, <small class="dots">...</small>) do not do any glue setting at <samp><sp
time. Metafont and MetaPost do not use floating point in any dumped
value at all.
- <p><a name="index-date-and-time_002c-in-memory-dumps-202"></a><a name="index-time-and-date_002c-in-memory-dumps-203"></a><a name="index-memory-dumps_002c-contain-date-and-time-204"></a>Incidentally, different memory dump files will never compare equal
+ <p><a name="index-date-and-time_002c-in-memory-dumps-203"></a><a name="index-time-and-date_002c-in-memory-dumps-204"></a><a name="index-memory-dumps_002c-contain-date-and-time-205"></a>Incidentally, different memory dump files will never compare equal
byte-for-byte, because the program always dumps the current date and
time. So don't be alarmed by just a few bytes difference.
- <p><a name="index-Harbison_002c-Samuel-P_002e-205"></a><a name="index-Steele-Jr_002e_002c-Guy-L_002e-206"></a>If you don't know what endianness your machine is, and you're curious,
+ <p><a name="index-Harbison_002c-Samuel-P_002e-206"></a><a name="index-Steele-Jr_002e_002c-Guy-L_002e-207"></a>If you don't know what endianness your machine is, and you're curious,
here is a little C program to tell you. (The <code>configure</code> script
contains a similar program.) This is from the book <cite>C: A Reference
Manual</cite>, by Samuel P. Harbison and Guy L. Steele
@@ -974,12 +979,12 @@ Up:&nbsp;<a rel="up" accesskey="u" href="#Three-programs">Three programs</a>
<h4 class="subsection">3.5.3 Editor invocation</h4>
-<p><a name="index-editor-invoked-at-error-207"></a><a name="index-errors_002c-editor-invoked-at-208"></a><a name="index-e-_0040r_007bresponse-at-error-prompt_007d-209"></a>
+<p><a name="index-editor-invoked-at-error-208"></a><a name="index-errors_002c-editor-invoked-at-209"></a><a name="index-e-_0040r_007bresponse-at-error-prompt_007d-210"></a>
TeX, Metafont, and MetaPost all (by default) stop and ask for user
intervention at an error. If the user responds with <kbd>e</kbd> or <kbd>E</kbd>,
the program invokes an editor.
- <p><a name="index-TEXEDIT-210"></a><a name="index-MFEDIT-211"></a><a name="index-MPEDIT-212"></a><a name="index-g_t_002d_002dwith_002deditor_003d_0040var_007bcmd_007d-213"></a>Specifying &lsquo;<samp><span class="samp">--with-editor=</span><var>cmd</var></samp>&rsquo; to <code>configure</code> sets the
+ <p><a name="index-TEXEDIT-211"></a><a name="index-MFEDIT-212"></a><a name="index-MPEDIT-213"></a><a name="index-g_t_002d_002dwith_002deditor_003d_0040var_007bcmd_007d-214"></a>Specifying &lsquo;<samp><span class="samp">--with-editor=</span><var>cmd</var></samp>&rsquo; to <code>configure</code> sets the
default editor command string to <var>cmd</var>. The environment
variables/configuration values <code>TEXEDIT</code>, <code>MFEDIT</code>, and
<code>MPEDIT</code> (respectively) override this. If &lsquo;<samp><span class="samp">--with-editor</span></samp>&rsquo; is
@@ -999,13 +1004,13 @@ Up:&nbsp;<a rel="up" accesskey="u" href="#Three-programs">Three programs</a>
<h4 class="subsection">3.5.4 <code>\input</code> filenames</h4>
-<p><a name="index-input-filenames-214"></a><a name="index-filename-conventions_002c-in-input-files-215"></a><a name="index-g_t_005cinput-_0040r_007bfilenames_007d-216"></a>
+<p><a name="index-input-filenames-215"></a><a name="index-filename-conventions_002c-in-input-files-216"></a><a name="index-g_t_005cinput-_0040r_007bfilenames_007d-217"></a>
TeX, Metafont, and MetaPost source programs can all read other source
files with the <code>\input</code> (TeX) and <code>input</code> (MF and MP)
primitives:
<pre class="example"> \input <var>name</var> % in TeX
</pre>
- <p><a name="index-space_002dterminated-filenames-217"></a><a name="index-whitespace_002dterminated-filenames-218"></a><a name="index-terminator-for-filenames-219"></a>The file <var>name</var> can always be terminated with whitespace; for
+ <p><a name="index-space_002dterminated-filenames-218"></a><a name="index-whitespace_002dterminated-filenames-219"></a><a name="index-terminator-for-filenames-220"></a>The file <var>name</var> can always be terminated with whitespace; for
Metafont and MetaPost, the statement terminator &lsquo;<samp><span class="samp">;</span></samp>&rsquo; also works.
(LaTeX and other macro packages provide other interfaces to
<code>\input</code> that allow different notation; here we are concerned only
@@ -1029,14 +1034,14 @@ tokenized and expanded the input. So, multiple spaces and tabs may be
seen as a single space, active characters such as &lsquo;<samp><span class="samp">~</span></samp>&rsquo; are
expanded first, and so on. (See below.)
- <p><a name="index-NUL_002c-not-allowed-in-filenames-220"></a><a name="index-eight_002dbit-characters-in-filenames-221"></a><a name="index-meta-characters-in-filenames-222"></a>On the other hand, various C library routines and Unix itself use the null
+ <p><a name="index-NUL_002c-not-allowed-in-filenames-221"></a><a name="index-eight_002dbit-characters-in-filenames-222"></a><a name="index-meta-characters-in-filenames-223"></a>On the other hand, various C library routines and Unix itself use the null
byte (character code zero, ASCII NUL) to terminate strings. So
filenames in Web2c cannot contain nulls, even though TeX itself does
not treat NUL specially.
In addition, some older Unix variants do not allow eight-bit characters
(codes 128&ndash;255) in filenames.
- <p><a name="index-portable-filenames-223"></a>For maximal portability of your document across systems, use only the
+ <p><a name="index-portable-filenames-224"></a>For maximal portability of your document across systems, use only the
characters &lsquo;<samp><span class="samp">a</span></samp>&rsquo;&ndash;&lsquo;<samp><span class="samp">z</span></samp>&rsquo;, &lsquo;<samp><span class="samp">0</span></samp>&rsquo;&ndash;&lsquo;<samp><span class="samp">9</span></samp>&rsquo;, and &lsquo;<samp><span class="samp">.</span></samp>&rsquo;, and
restrict your filenames to at most eight characters (not including the
extension), and at most a three-character extension. Do not use
@@ -1044,7 +1049,7 @@ anything but simple filenames, since directory separators vary among
systems; instead, add the necessary directories to the appropriate
search path.
- <p><a name="index-g_t_007e-_0040r_007bexpansion-in-filenames_007d-224"></a><a name="index-g_t_0024-_0040r_007bexpansion-in-filenames_007d-225"></a>Finally, the present Web2c implementation does &lsquo;<samp><span class="samp">~</span></samp>&rsquo; and &lsquo;<samp><span class="samp">$</span></samp>&rsquo;
+ <p><a name="index-g_t_007e-_0040r_007bexpansion-in-filenames_007d-225"></a><a name="index-g_t_0024-_0040r_007bexpansion-in-filenames_007d-226"></a>Finally, the present Web2c implementation does &lsquo;<samp><span class="samp">~</span></samp>&rsquo; and &lsquo;<samp><span class="samp">$</span></samp>&rsquo;
expansion on <var>name</var>, unlike Knuth's original implementation and
older versions of Web2c. Thus:
<pre class="example"> \input ~jsmith/$foo.bar
@@ -1058,7 +1063,7 @@ numeral, or &lsquo;<samp><span class="samp">_</span></samp>&rsquo;.
<p>(So another way to get a program to read a filename containing
whitespace is to define an environment variable and dereference it.)
- <p><a name="index-g_t_005cstring-226"></a>In all the common TeX formats (plain TeX, LaTeX, AMSTeX),
+ <p><a name="index-g_t_005cstring-227"></a>In all the common TeX formats (plain TeX, LaTeX, AMSTeX),
the characters &lsquo;<samp><span class="samp">~</span></samp>&rsquo; and &lsquo;<samp><span class="samp">$</span></samp>&rsquo; have special category codes, so to
actually use these in a document you have to change their catcodes or
use <code>\string</code>. (The result is unportable anyway, see the
@@ -1076,11 +1081,11 @@ Up:&nbsp;<a rel="up" accesskey="u" href="#Top">Top</a>
<h2 class="chapter">4 TeX: Typesetting</h2>
-<p><a name="index-g_t_0040TeX_007b_007d_002c-description-of-227"></a><a name="index-typesetting-228"></a><a name="index-mathematical-typesetting-229"></a>
+<p><a name="index-g_t_0040TeX_007b_007d_002c-description-of-228"></a><a name="index-typesetting-229"></a><a name="index-mathematical-typesetting-230"></a>
TeX is a typesetting system: it was especially designed to handle
complex mathematics, as well as most ordinary text typesetting.
- <p><a name="index-batch-languages-230"></a><a name="index-word-processor_002c-not-231"></a>TeX is a batch language, like C or Pascal, and not an interactive
+ <p><a name="index-batch-languages-231"></a><a name="index-word-processor_002c-not-232"></a>TeX is a batch language, like C or Pascal, and not an interactive
&ldquo;word processor&rdquo;: you compile a TeX input file into a corresponding
device-independent (DVI) file (and then translate the DVI file to the
commands for a particular output device). This approach has both
@@ -1109,7 +1114,7 @@ Up:&nbsp;<a rel="up" accesskey="u" href="#TeX">TeX</a>
<h3 class="section">4.1 <code>tex</code> invocation</h3>
-<p><a name="index-tex-232"></a><a name="index-g_t_0040TeX_007b_007d_002c-invocation-233"></a>
+<p><a name="index-tex-233"></a><a name="index-g_t_0040TeX_007b_007d_002c-invocation-234"></a>
TeX (usually invoked as <code>tex</code>) formats the given text and
commands, and outputs a corresponding device-independent representation
of the typeset document. This section merely describes the options
@@ -1125,7 +1130,7 @@ here) and determine their memory dump (fmt) file in the same way
tex [<var>option</var>]... \<var>first-line</var>
tex [<var>option</var>]... &amp;<var>fmt</var> <var>args</var>
</pre>
- <p><a name="index-g_t_002etex-234"></a><a name="index-g_t_0040TeX_007b_007d_002c-input-files-found-235"></a>TeX searches the usual places for the main input file <var>texname</var>
+ <p><a name="index-g_t_002etex-235"></a><a name="index-g_t_0040TeX_007b_007d_002c-input-files-found-236"></a>TeX searches the usual places for the main input file <var>texname</var>
(see <a href="kpathsea.html#Supported-file-formats">Supported file formats</a>), extending
<var>texname</var> with <samp><span class="file">.tex</span></samp> if necessary. To see all the
relevant paths, set the environment variable <code>KPATHSEA_DEBUG</code> to
@@ -1140,7 +1145,7 @@ arguments as a line of regular TeX input.
<p>If no arguments or options are specified, TeX prompts for an
input file name with &lsquo;<samp><span class="samp">**</span></samp>&rsquo;.
- <p><a name="index-texput-236"></a>TeX writes the main DVI output to the file
+ <p><a name="index-texput-237"></a>TeX writes the main DVI output to the file
<samp><var>basetexname</var><span class="file">.dvi</span></samp>, where <var>basetexname</var> is the basename of
<var>texname</var>, or &lsquo;<samp><span class="samp">texput</span></samp>&rsquo; if no input file was specified. A DVI
file is a device-independent binary representation of your TeX
@@ -1150,35 +1155,27 @@ device, such as a PostScript printer
(see <a href="dvips.html#Top">Introduction</a>) or an X Window System display
(see xdvi(1)).
- <p><a name="index-EC-fonts-237"></a><a name="index-mktextfM_0040r_007b_002c-disabling_007d-238"></a><a name="index-g_t_005cfont-_0040r_007band-dynamic-generation_007d-239"></a>TeX also reads TFM files for any fonts you load in your document with
+ <p><a name="index-EC-fonts-238"></a><a name="index-mktextfM_0040r_007b_002c-disabling_007d-239"></a><a name="index-g_t_005cfont-_0040r_007band-dynamic-generation_007d-240"></a>TeX also reads TFM files for any fonts you load in your document with
the <code>\font</code> primitive. By default, it runs an external program
named <samp><span class="file">mktextfm</span></samp> to create any nonexistent TFM files. You can
disable this at configure-time or runtime (see <a href="kpathsea.html#mktex-configuration">mktex configuration</a>). This is enabled mostly for the
sake of the EC fonts, which can be generated at any size.
- <p><a name="index-g_t_005copenout-_0040r_007band-security_007d-240"></a><a name="index-security_002c-and-_0040code_007b_005copenout_007d-241"></a><a name="index-output-files_002c-written-by-_0040TeX_007b_007d-programs-242"></a><a name="index-Trojan-horses-and-_0040TeX_007b_007d-programs-243"></a><a name="index-dot-files_002c-written-by-_0040TeX_007b_007d-programs-244"></a><a name="index-security_002c-and-output-files-245"></a><a name="index-texmfmp_002ec-_0040r_007band-_0040code_007bopenoutnameok_007d_007d-246"></a>TeX can write output files, via the <code>\openout</code> primitive; this
-opens a security hole vulnerable to Trojan horse attack: an unwitting
-user could run a TeX program that overwrites, say, <samp><span class="file">~/.rhosts</span></samp>.
-(MetaPost has a <code>write</code> primitive with similar implications). To
-alleviate this, there is a configuration variable <code>openout_any</code>,
-which selects one of three levels of security. When it is set to
-&lsquo;<samp><span class="samp">a</span></samp>&rsquo; (for &ldquo;any&rdquo;), no restrictions are imposed. When it is set to
-&lsquo;<samp><span class="samp">r</span></samp>&rsquo; (for &ldquo;restricted&rdquo;), filenames beginning with &lsquo;<samp><span class="samp">.</span></samp>&rsquo; are
-disallowed (except <samp><span class="file">.tex</span></samp> because LaTeX needs it). When it is set
-to &lsquo;<samp><span class="samp">p</span></samp>&rsquo; (for &ldquo;paranoid&rdquo;) additional restrictions are imposed: an
-absolute filename must refer to a file in (a subdirectory) of
-<code>TEXMFOUTPUT</code>, and any attempt to go up a directory level is
-forbidden (that is, paths may not contain a &lsquo;<samp><span class="samp">..</span></samp>&rsquo; component). The
-paranoid setting is the default. (For backwards compatibility, &lsquo;<samp><span class="samp">y</span></samp>&rsquo;
-and &lsquo;<samp><span class="samp">1</span></samp>&rsquo; are synonyms of &lsquo;<samp><span class="samp">a</span></samp>&rsquo;, while &lsquo;<samp><span class="samp">n</span></samp>&rsquo; and &lsquo;<samp><span class="samp">0</span></samp>&rsquo; are
-synonyms for &lsquo;<samp><span class="samp">r</span></samp>&rsquo;.)
+ <p><a name="index-g_t_005copenout-_0040r_007band-security_007d-241"></a><a name="index-security_002c-and-_0040code_007b_005copenout_007d-242"></a><a name="index-output-files_002c-written-by-_0040TeX_007b_007d-programs-243"></a><a name="index-Trojan-horses-and-_0040TeX_007b_007d-programs-244"></a><a name="index-dot-files_002c-written-by-_0040TeX_007b_007d-programs-245"></a><a name="index-security_002c-and-output-files-246"></a>TeX can write output files, via the <code>\openout</code> primitive; this opens
+a security hole vulnerable to Trojan horse attack: an unwitting user could
+run a TeX program that overwrites, say, <samp><span class="file">~/.rhosts</span></samp>. (MetaPost has
+a <code>write</code> primitive with similar implications). To alleviate this and
+similar problems the functions <code>kpathsea_out_name_ok</code> and
+<code>kpathsea_in_name_ok</code> from the Kpathse library (see <a href="kpathsea.html#Calling-sequence">Calling sequence</a>) are used to determine if a given filename
+is acceptable to be opened for output or input, depending on the setting of
+the configuration variables <code>openout_any</code> and <code>openin_any</code>:
+&lsquo;<samp><span class="samp">a</span></samp>&rsquo; (for &ldquo;any&rdquo;, the default for <code>openin_any</code>), &lsquo;<samp><span class="samp">r</span></samp>&rsquo; (for
+&ldquo;restricted&rdquo;), or &lsquo;<samp><span class="samp">p</span></samp>&rsquo; (for &ldquo;paranoid&rdquo;, the default for
+<code>openout_any</code>).
<p>In any case, all <code>\openout</code> filenames are recorded in the log file,
except those opened on the first line of input, which is processed when
-the log file has not yet been opened. (If you as a TeX administrator
-wish to implement more stringent rules on <code>\openout</code>, modifying the
-function <code>openoutnameok</code> in <samp><span class="file">web2c/lib/texmfmp.c</span></samp> is intended
-to suffice.)
+the log file has not yet been opened.
<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>):
@@ -1803,9 +1800,9 @@ partial list.
<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
+ <br><dt>Aleph<dd><a name="index-Aleph-357"></a><a name="index-Unicode-358"></a>This adds Unicode support, right-to-left typesetting, and more. Omega
was the original program. Aleph is an updated version with a variety
-of bug fixes, and includes e-TeX. Neither is actively maintained.
+of bug fixes, and includes e-TeX. Aleph is not 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
@@ -1816,6 +1813,10 @@ page: <a href="http://pdftex.org">http://pdftex.org</a>.
(<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>.
+ <br><dt>XeTeX<dd><a name="index-Xe_0040TeX_007b_007d-365"></a><a name="index-Unicode-366"></a>Combines support for Unicode input and OpenType- and system fonts
+with the capabilities of pdfTeX.
+Home page: <a href="http://tug.org/xetex">http://tug.org/xetex</a>.
+
</dl>
<div class="node">
@@ -1829,7 +1830,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-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>
+<p><a name="index-Metafont-367"></a><a name="index-typeface-families-368"></a><a name="index-geometric-designs-369"></a><a name="index-shapes-370"></a><a name="index-font-design-371"></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
@@ -1863,7 +1864,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-370"></a><a name="index-Metafont-invocation-371"></a>
+<p><a name="index-mf-372"></a><a name="index-Metafont-invocation-373"></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
@@ -1883,7 +1884,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-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>
+ <p><a name="index-g_t_002emf-374"></a><a name="index-Metafont-input-files-375"></a><a name="index-EC-fonts-376"></a><a name="index-mktexmf_0040r_007b_002c-disabling_007d-377"></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;
@@ -1893,7 +1894,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-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
+ <p><a name="index-g_t_002e_0040var_007bnnn_007dgf-_0040r_007bgeneric-fonts_007d-378"></a><a name="index-mfput-379"></a><a name="index-GF-output-380"></a><a name="index-GF-files_002c-output-by-Metafont-381"></a><a name="index-PK-files_002c-not-output-by-Metafont-382"></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
@@ -1902,12 +1903,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-381"></a><a name="index-TFM-files_002c-output-by-Metafont-382"></a>Metafont also usually writes a metric file in TFM format to
+ <p><a name="index-g_t_002etfm-_0040r_007boutput_007d-383"></a><a name="index-TFM-files_002c-output-by-Metafont-384"></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-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
+ <p><a name="index-mode-needed-to-run-Metafont-385"></a><a name="index-proof-_0040r_007bmode_007d-386"></a><a name="index-g_t2602gf-387"></a><a name="index-g_t_002e2602gf-388"></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>
@@ -1934,7 +1935,7 @@ 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-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>.
+ <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-389"></a><a name="index-g_t_002dno_002dmktex_003d_0040var_007bfiletype_007d-390"></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>
@@ -1949,8 +1950,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-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
+<p><a name="index-initial-Metafont-391"></a><a name="index-Metafont_002c-initial-392"></a>
+<a name="index-g_t_002ebase-393"></a><a name="index-base-files-394"></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
@@ -1958,7 +1959,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-393"></a><a name="index-mf_002ebase-394"></a>The only memory dump file commonly used with Metafont is the default
+ <p><a name="index-plain_002ebase-395"></a><a name="index-mf_002ebase-396"></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'
@@ -1971,13 +1972,13 @@ 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-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
+ <p><a name="index-cmmf_002ebase-_0040r_007bnot-recommended_007d-397"></a><a name="index-cm_002ebase-398"></a><a name="index-cmbase_002emf-399"></a><a name="index-Computer-Modern-macros-400"></a><a name="index-base-files_002c-plain-only-401"></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-400"></a>People actually working on a typeface may still find it worthwhile to
+<a name="index-type-design_002c-personal-402"></a>People actually working on a typeface may still find it worthwhile to
create their own base file, of course.
<div class="node">
@@ -1991,16 +1992,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-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
+<p><a name="index-modes-file-needed-for-Metafont-403"></a><a name="index-base-files_002c-need-mode-definitions-404"></a><a name="index-device-definitions_002c-for-Metafont-405"></a><a name="index-printer-characteristics_002c-for-Metafont-406"></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-405"></a>When making a base file, a file containing modes for locally-available
+ <p><a name="index-modes_002emf-_0040r_007brecommended-modes-file_007d-407"></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-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
+ <p><a name="index-small-Metafont-memory-and-modes-408"></a><a name="index-mode_005fdef-409"></a><a name="index-mode_005fsetup-410"></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
@@ -2013,7 +2014,7 @@ comments in that file for how to create the new definition, and please
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-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
+ <p><a name="index-smode-_0040r_007band-dynamic-Metafont-mode-definition_007d-411"></a><a name="index-dynamic-Metafont-mode-definitions-with-_0040code_007bsmode_007d-412"></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:
@@ -2049,13 +2050,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-411"></a><a name="index-Metafont-graphics-412"></a>
+<p><a name="index-online-Metafont-graphics-413"></a><a name="index-Metafont-graphics-414"></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-413"></a><a name="index-TERM-414"></a>Metafont examines the <code>MFTERM</code> environment variable or config file
+ <p><a name="index-MFTERM-415"></a><a name="index-TERM-416"></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
@@ -2065,56 +2066,59 @@ be selected.
and the corresponding <code>configure</code> option(s) in parentheses.
<dl>
-<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
+<dt><code>epsf</code><a name="index-epsf-417"></a><dd><a name="index-Herberts_002c-Mathias-418"></a><a name="index-g_t_002d_002denable_002depsfwin-419"></a>(&lsquo;<samp><span class="samp">--enable-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-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>hp2627</code><a name="index-hp2627-420"></a><dd><a name="index-g_t_002d_002denable_002dhp2627win-421"></a>(&lsquo;<samp><span class="samp">--enable-hp2627win</span></samp>&rsquo;) HP2627a color graphics terminals.
- <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
+ <br><dt><code>mftalk</code><a name="index-mftalk-422"></a><dd><a name="index-g_t_002d_002denable_002dmftalkwin-423"></a>(&lsquo;<samp><span class="samp">--enable-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-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
+ <br><dt><code>next</code><a name="index-next-424"></a><dd><a name="index-DrawingServant-425"></a><a name="index-g_t_002d_002denable_002dnext-426"></a>(&lsquo;<samp><span class="samp">--enable-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-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>regis</code><a name="index-regis-427"></a><dd><a name="index-g_t_002d_002denable_002dregiswin-428"></a><a name="index-Regis-graphics-support-429"></a>(&lsquo;<samp><span class="samp">--enable-regiswin</span></samp>&rsquo;) Regis terminals.
- <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)
+ <br><dt><code>sun</code><a name="index-sun-430"></a><dd><a name="index-SunView-431"></a><a name="index-Suntools-432"></a><a name="index-g_t_002d_002denable_002dsuntoolswin-433"></a><a name="index-sun_002dgfx_002ec-434"></a>(&lsquo;<samp><span class="samp">--enable-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-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.
+ <br><dt><code>tek</code><a name="index-tek-435"></a><dd><a name="index-Tektronix-436"></a><a name="index-g_t_002d_002denable_002dtektronixwin-437"></a>(&lsquo;<samp><span class="samp">--enable-tektronixwin</span></samp>&rsquo;) Tektronix terminals.
- <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
+ <p><a name="index-Poole_002c-Simon-438"></a><br><dt><code>uniterm</code><a name="index-uniterm-439"></a><dd><a name="index-Tektronix-4014-440"></a><a name="index-g_t_002d_002denable_002dunitermwin-441"></a>(&lsquo;<samp><span class="samp">--enable-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.
+as well; it's faster than the driver &lsquo;<samp><span class="samp">--enable-tektronixwin</span></samp>&rsquo; selects.
- <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-NO_005fX11WIN-442"></a><a name="index-Xt-443"></a><a name="index-Xlib-444"></a><br><dt><code>xterm</code><a name="index-xterm-445"></a><dd><a name="index-g_t_002d_002dwith_002dx-446"></a>&lsquo;<samp><span class="samp">--with-x</span></samp>&rsquo; The X window system (version 11).
- <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
+ <p><a name="index-g_t_002d_002dwith_002dmf_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;.
+--with-kf-x-toolkit=no</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;)
+ <p><a name="index-g_t_002d_002ddisable_002dmf_002dnowin-452"></a><a name="index-non_002dwindows_002dcapable-Metafont-453"></a>Specify &lsquo;<samp><span class="samp">--disable-mf-nowin</span></samp>&rsquo; in order not to build a separate
+non-windows-capable Metafont executable <code>mf-nowin</code> (or
+<code>mf-nowin.exe</code>).
+
+ <p><a name="index-X-resources-454"></a><a name="index-X-class-name-for-Metafont-455"></a><a name="index-class-name-for-Metafont-456"></a><a name="index-geometry-for-Metafont-457"></a><a name="index-Metafont-geometry-458"></a><a name="index-g_t_002eXdefaults-459"></a><a name="index-g_t_002eXresources-460"></a><a name="index-g_t_002dgeometry_0040r_007b_002c-supported-with-Xt_007d-461"></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-460"></a>You specify the X display to which Metafont connects in the
+ <p><a name="index-DISPLAY-462"></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-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
+ <p><a name="index-Metafont-online-support_002c-new-devices-463"></a><a name="index-new-graphics-support-for-Metafont-464"></a><a name="index-texmfmp_002ec-465"></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
@@ -2131,7 +2135,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-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>
+<p><a name="index-gftodvi-466"></a><a name="index-character-proofs-of-fonts-467"></a><a name="index-font-proofs-468"></a><a name="index-proof-sheets_002c-of-fonts-469"></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:
@@ -2156,17 +2160,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-468"></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-470"></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-469"></a><dfn>title font</dfn> (default <samp><span class="file">cmr8</span></samp>): for the header information at
+ <li><a name="index-title-font-471"></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-470"></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-472"></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-471"></a><dfn>slant font</dfn> (no default): for diagonal lines, which are otherwise
+ <li><a name="index-slant-font-473"></a><dfn>slant font</dfn> (no default): for diagonal lines, which are otherwise
simulated using horizontal and vertical rules.
</ul>
@@ -2188,7 +2192,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-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
+<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-474"></a><a name="index-overflow-label-offset-475"></a><a name="index-offset-for-overflow-labels-476"></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
@@ -2205,8 +2209,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-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
+<p><a name="index-mft-477"></a><a name="index-Metafont-source_002c-prettyprinting-478"></a><a name="index-prettyprinting-Metafont-source-479"></a><a name="index-g_t_0040TeX_007b_007d_002c-creating-from-Metafont-480"></a>
+<a name="index-mftmac_002etex-481"></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:
@@ -2225,7 +2229,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-480"></a>
+<a name="index-comments_002c-MFT-control-482"></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
@@ -2262,27 +2266,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-481"></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-483"></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-482"></a><a name="index-change-files_002c-and-MFT-483"></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-484"></a><a name="index-change-files_002c-and-MFT-485"></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-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
+ <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-486"></a><a name="index-style-files-487"></a><a name="index-plain_002emft-488"></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-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
+ <p><a name="index-cmbase_002emft-489"></a><a name="index-e_002emft-490"></a><a name="index-g_t_0040cite_007bComputer-Modern-Typefaces_007d_002c-production-of-491"></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-490"></a>Using an appropriate MFT style file, it is also possible to configure
+ <p><a name="index-MetaPost-source_002c-prettyprinting-492"></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>
@@ -2302,7 +2306,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-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
+<p><a name="index-MetaPost-493"></a><a name="index-PostScript-meets-Metafont-494"></a><a name="index-Metafont-meets-PostScript-495"></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.
@@ -2327,8 +2331,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-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
+<p><a name="index-mpost-496"></a><a name="index-MetaPost-invocation-497"></a>
+<a name="index-mpman_002eps-498"></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
@@ -2339,11 +2343,11 @@ also:
<ul>
<li><a href="http://cm.bell-labs.com/who/hobby/MetaPost.html">http://cm.bell-labs.com/who/hobby/MetaPost.html</a> (the
MetaPost author's home page);
-<li><a href="http://tug.org/metapost.html">http://tug.org/metapost.html</a> (papers, packages, and
+<li><a href="http://tug.org/metapost">http://tug.org/metapost</a> (papers, packages, and
related information).
</ul>
- <p><a name="index-mpgraph_002eps-497"></a>Also, a standard MetaPost package for drawing graphs is documented in
+ <p><a name="index-mpgraph_002eps-499"></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>.
@@ -2355,13 +2359,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-498"></a><a name="index-MetaPost-input-files-499"></a>MetaPost searches the usual places for the main input file <var>mpname</var>
+ <p><a name="index-g_t_002emp-500"></a><a name="index-MetaPost-input-files-501"></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-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
+ <p><a name="index-beginfig-502"></a><a name="index-g_t_002e_0040var_007bnnn_007d-_0040r_007bPostScript-figures_007d-503"></a><a name="index-g_t_002etfm-_0040r_007boutput_007d-504"></a><a name="index-mpout-505"></a><a name="index-TFM-files_002c-output-by-MetaPost-506"></a><a name="index-PostScript-output-507"></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
@@ -2376,7 +2380,7 @@ 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-506"></a><a name="index-etex-_0040r_007bfor-MetaPost-labels_007d-507"></a>The MetaPost construct
+ <p><a name="index-btex-_0040r_007bfor-MetaPost-labels_007d-508"></a><a name="index-etex-_0040r_007bfor-MetaPost-labels_007d-509"></a>The MetaPost construct
<pre class="example"> btex ... <var>tex-input</var> ... etex
</pre>
<p class="noindent">generates a MetaPost picture expression corresponding to
@@ -2398,12 +2402,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><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;
+ <p><a name="index-PostScript-fonts_002c-and-Troff-510"></a><a name="index-Troff_002c-and-MetaPost-511"></a><a name="index-Computer-Modern-fonts_002c-and-Troff-512"></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-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
+ <p><a name="index-mproof_002etex-513"></a><a name="index-downloading-of-fonts-for-MetaPost-labels-514"></a><a name="index-font-downloading-for-MetaPost-labels-515"></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
@@ -2413,13 +2417,20 @@ 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-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
+ <p><a name="index-prologues_0040r_007b_002c-and-EPSF-output_007d-516"></a><a name="index-psfonts_002emap_0040r_007b_002c-read-by-MetaPost_007d-517"></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
need to be downloaded (see <a href="dvips.html#psfonts_002emap">psfonts.map</a>).
- <p>MetaPost can write output files, via the <code>write</code> primitive; this
+ <p><a name="index-PDF_002c-and-_0040code_007b_002emps_007d-files-518"></a><a name="index-g_t_0040code_007b_002emps_007d-files-and-PDF-519"></a>It is posible for pdfTeX to read MetaPost output directly; this is
+in contrast to general EPSF files, which have to be converted for use
+with PDF output. The easiest way is to name the MetaPost output files
+with the <code>.mps</code> extension. Then the LaTeX
+<code>\includegraphics</code> command, for example, will be able to read
+them, even when outputting PDF.
+
+ <p><a name="index-security_002c-and-_0040code_007bwrite_007d-520"></a>MetaPost can write output files, via the <code>write</code> primitive; this
opens a security hole. See <a href="#tex-invocation">tex invocation</a>.
<p>The program accepts the following options, as well as the standard
@@ -2428,9 +2439,9 @@ 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-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">-T</span></samp>&rsquo;<dt>&lsquo;<samp><span class="samp">-troff</span></samp>&rsquo;<dd><a name="index-g_t_002dT-521"></a><a name="index-g_t_002dtroff-522"></a><a name="index-prologues-523"></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-519"></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-524"></a>When this option is given, the program <var>texprogram</var> is used to
typeset the labels.
</dl>
@@ -2446,8 +2457,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-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
+<p><a name="index-initial-MetaPost-525"></a><a name="index-MetaPost_002c-initial-526"></a>
+<a name="index-g_t_002emem-527"></a><a name="index-mem-files-528"></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
@@ -2456,7 +2467,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-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,
+ <p><a name="index-plain_002emem-529"></a><a name="index-mpost_002emem-530"></a><a name="index-mem-files_002c-plain-only-531"></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):
@@ -2467,7 +2478,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-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
+ <p><a name="index-Metafont_002c-compatibility-in-MetaPost-532"></a><a name="index-plain-Metafont_002c-compatibility-in-MetaPost-533"></a><a name="index-MetaPost-and-plain-Metafont-compatibility-534"></a><a name="index-mfplain_002emem-535"></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
@@ -2475,7 +2486,7 @@ 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-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
+ <p><a name="index-metafun_002emp-536"></a><a name="index-MetaFun_002c-enhanced-MetaPost-537"></a><a name="index-Pragma-ADE-538"></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>.
@@ -2490,7 +2501,7 @@ Up:&nbsp;<a rel="up" accesskey="u" href="#MetaPost">MetaPost</a>
<h3 class="section">6.3 DVItoMP: DVI to MPX conversion</h3>
-<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>
+<p><a name="index-dvitomp-539"></a><a name="index-DVI-files_002c-converting-to-MPX-540"></a><a name="index-MPX-files_002c-converting-from-DVI-files-541"></a>
DVItoMP converts DVI files into low-level MetaPost commands in a
so-called MPX file. Synopsis:
@@ -2500,7 +2511,7 @@ so-called MPX file. Synopsis:
<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-537"></a>DVItoMP supports Dvips-style color specials, such as &lsquo;<samp><span class="samp">color push
+ <p><a name="index-color_002c-in-DVItoMP-542"></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.
@@ -2517,7 +2528,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-538"></a><a name="index-Bib_0040TeX_007b_007d-539"></a>
+<p><a name="index-bibliographies_002c-creating-543"></a><a name="index-Bib_0040TeX_007b_007d-544"></a>
BibTeX automates much of the job of typesetting bibliographies, and
makes bibliography entries reusable in many different contexts.
@@ -2536,8 +2547,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-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
+<p><a name="index-bibtex-545"></a>
+<a name="index-g_t_002ebbl-_0040r_007bbibliography-files_007d-546"></a><a name="index-g_t_002eaux-_0040r_007bcross_002dreference-files_007d-547"></a><a name="index-g_t_002ebib-_0040r_007bbibliography-databases_007d-548"></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,
@@ -2546,12 +2557,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-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
+ <p><a name="index-g_t_002eblg-_0040r_007bBib_0040TeX_007b_007d-log-file_007d-549"></a><a name="index-log-file_002c-Bib_0040TeX_007b_007d-550"></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-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
+ <p><a name="index-g_t_005cbibliography-551"></a><a name="index-g_t_005cbibliographystyle-552"></a><a name="index-TEXBIB_0040r_007b_002c-search-path-for-bib-files_007d-553"></a><a name="index-BIBINPUTS_0040r_007b_002c-search-path-for-bib-files_007d-554"></a><a name="index-BSTINPUTS_0040r_007b_002c-search-path-for-bst-files_007d-555"></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,
@@ -2561,9 +2572,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-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.
+<dt>&lsquo;<samp><span class="samp">-terse</span></samp>&rsquo;<dd><a name="index-g_t_002dterse-556"></a><a name="index-terse-output-557"></a><a name="index-verbose-Bib_0040TeX_007b_007d-output_002c-suppressing-558"></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-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
+ <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-559"></a><a name="index-cross_002dreferenced-bibliography-items-560"></a><a name="index-bibliography-items_002c-cross_002dreferenced-561"></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,
@@ -2575,15 +2586,15 @@ large number.
<p>See also:
<dl>
-<dt><samp><span class="file">btxdoc.tex</span></samp><dd><a name="index-btxdoc_002etex-557"></a>Basic LaTeXable documentation for general BibTeX users.
+<dt><samp><span class="file">btxdoc.tex</span></samp><dd><a name="index-btxdoc_002etex-562"></a>Basic LaTeXable documentation for general BibTeX users.
- <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">btxhak.tex</span></samp><dd><a name="index-btxhak_002etex-563"></a><a name="index-style-design_002c-for-Bib_0040TeX_007b_007d-564"></a>LaTeXable documentation for style designers.
- <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">btxdoc.bib</span></samp><dd><a name="index-btxdoc_002ebib-565"></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-561"></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-566"></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-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
+ <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-567"></a><a name="index-Bib_0040TeX_007b_007d-collection-568"></a><a name="index-TUGboat-bibliography-569"></a><a name="index-g_t_0040TeX_007b_007d_002c-bibliographies-for-570"></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>
@@ -2598,34 +2609,34 @@ 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-566"></a><a name="index-Bib_0040TeX_007b_007d-style-files-567"></a>
+<p><a name="index-basic-Bib_0040TeX_007b_007d-style-files-571"></a><a name="index-Bib_0040TeX_007b_007d-style-files-572"></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-568"></a>Sorts entries alphabetically, with numeric labels. Generally formatted
+<dt><code>plain</code><dd><a name="index-plain_002ebst-573"></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-569"></a>First names, month names, and journal names are abbreviated.
+ <br><dt><code>abbrv</code><dd><a name="index-abbrv_002ebst-574"></a>First names, month names, and journal names are abbreviated.
- <br><dt><code>acm</code><dd><a name="index-acm_002ebst-570"></a>Names are printed in small caps.
+ <br><dt><code>acm</code><dd><a name="index-acm_002ebst-575"></a>Names are printed in small caps.
- <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>alpha</code><dd><a name="index-alpha_002ebst-576"></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-572"></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-577"></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-573"></a>Numeric labels, entries in citation order, <span class="sc">ieee</span> abbreviations,
+ <br><dt><code>ieeetr</code><dd><a name="index-ieeetr_002ebst-578"></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-574"></a>Numeric labels, alphabetic order, <cite>Math. Reviews</cite>
+ <br><dt><code>siam</code><dd><a name="index-siam_002ebst-579"></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-575"></a>Lists entries in citation order, i.e., unsorted.
+ <br><dt><code>unsrt</code><dd><a name="index-unsrt_002ebst-580"></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.
@@ -2642,7 +2653,7 @@ Up:&nbsp;<a rel="up" accesskey="u" href="#Top">Top</a>
<h2 class="chapter">8 WEB: Literate programming</h2>
-<p><a name="index-WEB-576"></a><a name="index-literate-programming-577"></a>
+<p><a name="index-WEB-581"></a><a name="index-literate-programming-582"></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.
@@ -2650,7 +2661,7 @@ 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>
is devoted to this subject.)
- <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
+ <p><a name="index-webman_002etex-583"></a><a name="index-Spiderweb-584"></a><a name="index-Cweb-585"></a><a name="index-CWEB-586"></a><a name="index-Awk_002c-WEB-for-587"></a><a name="index-Ada_002c-WEB-for-588"></a><a name="index-Troff_002c-WEB-for-589"></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
@@ -2679,18 +2690,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-585"></a><a name="index-Pascal_002c-creating-from-WEB-586"></a><a name="index-WEB-programs_002c-compiling-587"></a>
+<p><a name="index-tangle-590"></a><a name="index-Pascal_002c-creating-from-WEB-591"></a><a name="index-WEB-programs_002c-compiling-592"></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-588"></a>The Pascal output is written to the basename of <var>webfile</var> extended
+ <p><a name="index-change-files_002c-and-Tangle-593"></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-589"></a><a name="index-string-pool_002c-writing-590"></a>If the program makes use of the WEB string facility, Tangle writes the
+ <p><a name="index-pool-file_002c-writing-594"></a><a name="index-string-pool_002c-writing-595"></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
@@ -2701,20 +2712,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-591"></a><a name="index-identifier-length-592"></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-596"></a><a name="index-identifier-length-597"></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-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.
+ <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-598"></a><a name="index-g_t_002dmixedcase-599"></a><a name="index-g_t_002duppercase-600"></a><a name="index-identifier-case-601"></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-597"></a><a name="index-identifiers-with-underlines-598"></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-602"></a><a name="index-identifiers-with-underlines-603"></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-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
+ <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-604"></a><a name="index-g_t_002dstrict-605"></a><a name="index-identifier-collisions-606"></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
@@ -2734,7 +2745,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-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>
+<p><a name="index-weave-607"></a><a name="index-g_t_0040TeX_007b_007d_002c-creating-from-WEB-608"></a><a name="index-WEB-programs_002c-typesetting-609"></a><a name="index-prettyprinting-WEB-programs-610"></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
@@ -2743,7 +2754,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-606"></a>The output is to the basename of <var>webfile</var> extended with
+ <p><a name="index-change-files_002c-and-Weave-611"></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.
@@ -2751,7 +2762,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-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
+<dt>&lsquo;<samp><span class="samp">-x</span></samp>&rsquo;<dd><a name="index-g_t_002dx-612"></a><a name="index-cross_002dreferences_002c-omitting-613"></a><a name="index-CONTENTS_002etex-614"></a><a name="index-webmac_002etex-615"></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).
@@ -2772,7 +2783,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-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>
+<p><a name="index-pooltype-616"></a><a name="index-type-programs_002c-pool-617"></a><a name="index-string-numbers_002c-displaying-618"></a><a name="index-WEB-pool-files_002c-displaying-619"></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
@@ -2795,7 +2806,7 @@ output.
1314: "Using character substitution: "
(23617 characters in all.)
</pre>
- <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
+ <p><a name="index-representation-of-strings-620"></a><a name="index-string-representation-621"></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.
@@ -2811,7 +2822,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-617"></a>
+<p><a name="index-DVI-utilities-622"></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
@@ -2820,7 +2831,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-618"></a><a name="index-DVI-format-definition-619"></a>For the precise definition of the DVI file format, see (for example) the
+ <p><a name="index-dvitype_002eweb-623"></a><a name="index-DVI-format-definition-624"></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
@@ -2841,7 +2852,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-620"></a><a name="index-virtual-fonts_002c-expanding-621"></a>
+<p><a name="index-dvicopy-625"></a><a name="index-virtual-fonts_002c-expanding-626"></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
@@ -2856,13 +2867,13 @@ 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-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
+<dt>&lsquo;<samp><span class="samp">-magnification=</span><var>integer</var></samp>&rsquo;<dd><a name="index-g_t_002dmagnification_003d_0040var_007binteger_007d-627"></a><a name="index-magnification-628"></a><a name="index-g_t_005cmag-629"></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-625"></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-630"></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-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
+ <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-631"></a><a name="index-starting-page-632"></a><a name="index-page_002c-starting-633"></a><a name="index-g_t_005ccount_0040var_007bn_007d-634"></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;.
@@ -2878,7 +2889,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-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>
+<p><a name="index-dvitype-_0040r_007bDVI-validation_007d-635"></a><a name="index-conversion_002c-DVI-to-plain-text-636"></a><a name="index-plain-text_002c-converting-DVI-to-637"></a><a name="index-human_002dreadable-text_002c-converting-DVI-to-638"></a><a name="index-type-programs_002c-DVI-639"></a><a name="index-validation_002c-of-DVI-files-640"></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
@@ -2897,16 +2908,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-636"></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-641"></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-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
+ <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-642"></a><a name="index-magnification-643"></a><a name="index-g_t_005cmag-644"></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-640"></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-645"></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-641"></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-646"></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.
@@ -2916,12 +2927,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-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
+ <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-647"></a><a name="index-starting-page-648"></a><a name="index-page_002c-starting-649"></a><a name="index-g_t_005ccount_0040var_007bn_007d-650"></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-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
+ <br><dt>&lsquo;<samp><span class="samp">-show-opcodes</span></samp>&rsquo;<dd><a name="index-g_t_002dshow_002dopcodes-651"></a><a name="index-opcodes_002c-showing-DVI-652"></a><a name="index-DVI-opcodes_002c-showing-653"></a><a name="index-debugging-DVI-utilities-654"></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.
@@ -2940,7 +2951,7 @@ Up:&nbsp;<a rel="up" accesskey="u" href="#dvitype-invocation">dvitype invocation
<h4 class="subsection">9.2.1 DVItype output example</h4>
-<p><a name="index-dvitype-output-example-650"></a>As an example of the output from DVItype (see section above), here is
+<p><a name="index-dvitype-output-example-655"></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.
@@ -3027,13 +3038,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-651"></a>
+<p><a name="index-font-utilities-656"></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-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
+ <p><a name="index-pktype_002eweb-657"></a><a name="index-gftype_002eweb-658"></a><a name="index-PK-format-definition-659"></a><a name="index-GF-format-definition-660"></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.
@@ -3060,7 +3071,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-656"></a><a name="index-file-formats-for-fonts-657"></a>
+<p><a name="index-font-file-formats-661"></a><a name="index-file-formats-for-fonts-662"></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:
@@ -3068,7 +3079,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-658"></a>A TFM (TeX font metric) file is a compact binary file that contains
+ <p><a name="index-TFM-files_002c-explained-663"></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
@@ -3077,7 +3088,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-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
+ <p><a name="index-scaling-of-fonts-664"></a><a name="index-optical-font-scaling-665"></a><a name="index-geometric-font-scaling-666"></a><a name="index-PostScript_002c-and-font-scaling-667"></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,
@@ -3085,7 +3096,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-663"></a>At any rate, TeX produces a DVI (DeVice Independent) file from your
+ <p><a name="index-DVI-files_002c-explained-668"></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
@@ -3096,14 +3107,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-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
+ <p><a name="index-PXL-files_002c-explained-669"></a><a name="index-PK-files_002c-explained-670"></a><a name="index-GF-files_002c-explained-671"></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-667"></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-672"></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>).
@@ -3113,13 +3124,13 @@ 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-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
+ <p><a name="index-virtual_002dfonts_002eknuth-673"></a><a name="index-virtualfonts_002etxt-674"></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-670"></a><a name="index-Tachikawa_002c-Elizabeth-671"></a>(This section is based on documentation in the original Unix TeX
+ <p><a name="index-MacKay_002c-Pierre-675"></a><a name="index-Tachikawa_002c-Elizabeth-676"></a>(This section is based on documentation in the original Unix TeX
distribution by Pierre MacKay and Elizabeth Tachikawa.)
<div class="node">
@@ -3133,7 +3144,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-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>
+<p><a name="index-gftopk-677"></a><a name="index-conversion_002c-GF-to-PK-678"></a><a name="index-PK_002c-converting-GF-to-679"></a><a name="index-GF_002c-converting-to-PK-680"></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
@@ -3169,7 +3180,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-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>
+<p><a name="index-pktogf-681"></a><a name="index-conversion_002c-PK-to-GF-682"></a><a name="index-GF_002c-converting-PK-to-683"></a><a name="index-PK_002c-converting-to-GF-684"></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
@@ -3204,7 +3215,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-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>
+<p><a name="index-pktype-_0040r_007bPK-validation_007d-685"></a><a name="index-conversion_002c-PK-to-plain-text-686"></a><a name="index-plain-text_002c-converting-PK-to-687"></a><a name="index-human_002dreadable-text_002c-converting-PK-to-688"></a><a name="index-type-programs_002c-PK-689"></a><a name="index-validation_002c-of-PK-files-690"></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
@@ -3240,23 +3251,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-686"></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-691"></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-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">Flag byte</span></samp>&rsquo;<dt>&lsquo;<samp><span class="samp">Dynamic packing variable</span></samp>&rsquo;<dd><a name="index-flag-byte-692"></a><a name="index-dynamic-packing-variable-693"></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-689"></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-694"></a>The character code, in decimal.
- <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">Packet length</span></samp>&rsquo;<dd><a name="index-packet-length-695"></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-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
+ <br><dt>&lsquo;<samp><span class="samp">TFM width</span></samp>&rsquo;<dd><a name="index-TFM-width-of-characters-696"></a><a name="index-device_002dindependent-width-697"></a><a name="index-width_002c-device_002dindependent-698"></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-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
+ <br><dt>&lsquo;<samp><span class="samp">dx</span></samp>&rsquo;<dd><a name="index-horizontal-escapement-699"></a><a name="index-escapement_002c-horizontal-700"></a><a name="index-scaled-pixels-701"></a><a name="index-dx-_0040r_007bhorizontal-escapement_007d-702"></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-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">Height</span></samp>&rsquo;<dt>&lsquo;<samp><span class="samp">Width</span></samp>&rsquo;<dd><a name="index-height_002c-in-pixels-703"></a><a name="index-pixel-height-704"></a><a name="index-pixel-width-705"></a><a name="index-width_002c-in-pixels-706"></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-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
+ <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-707"></a><a name="index-y-offset-708"></a><a name="index-origin-709"></a><a name="index-reference-pixel-710"></a><a name="index-side-bearings-711"></a><a name="index-left-side-bearing-712"></a><a name="index-right-side-bearing-713"></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
@@ -3264,7 +3275,7 @@ 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-709"></a><a name="index-repeated-rows-710"></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-714"></a><a name="index-repeated-rows-715"></a>Finally, run lengths of black pixels alternate with parenthesized run
lengths of white pixels, and brackets indicate a repeated row.
</dl>
@@ -3279,7 +3290,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-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>
+<p><a name="index-gftype-_0040r_007bGF-validation_007d-716"></a><a name="index-conversion_002c-GF-to-plain-text-717"></a><a name="index-plain-text_002c-converting-GF-to-718"></a><a name="index-human_002dreadable-text_002c-converting-GF-to-719"></a><a name="index-type-programs_002c-GF-720"></a><a name="index-validation_002c-of-GF-files-721"></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,
@@ -3299,9 +3310,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-717"></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-722"></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-718"></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-723"></a>Translate all commands in the GF file.
</dl>
<p>As an example of the output, here is the (abrdiged) translation of the
@@ -3348,22 +3359,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-719"></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-724"></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-720"></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-725"></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-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,
+ <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-726"></a><a name="index-right-side-bearing-727"></a><a name="index-side-bearings-728"></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-724"></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-729"></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-725"></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-730"></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-726"></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-731"></a>The end of the main character definition.
</dl>
@@ -3374,12 +3385,12 @@ pixels, etc.
<p>Explanation:
<dl>
-<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
+<dt>&lsquo;<samp><span class="samp">dx</span></samp>&rsquo;<dd><a name="index-horizontal-escapement-732"></a><a name="index-escapement_002c-horizontal-733"></a><a name="index-vertical-escapement-734"></a><a name="index-escapement_002c-vertical-735"></a><a name="index-scaled-pixels-736"></a><a name="index-dx-_0040r_007bhorizontal-escapement_007d-737"></a><a name="index-dy-_0040r_007bvertical-escapement_007d-738"></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-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
+ <br><dt>&lsquo;<samp><span class="samp">width</span></samp>&rsquo;<dd><a name="index-TFM-width-of-characters-739"></a><a name="index-device_002dindependent-width-740"></a><a name="index-width_002c-device_002dindependent-741"></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.
@@ -3398,7 +3409,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-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>
+<p><a name="index-tftopl-742"></a><a name="index-conversion_002c-TFM-to-property-list-743"></a><a name="index-validation_002c-of-TFM-files-744"></a><a name="index-property-list_002c-converting-TFM-to-745"></a><a name="index-human_002dreadable-text_002c-converting-TFM-to-746"></a><a name="index-plain-text_002c-converting-TFM-to-747"></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
@@ -3420,7 +3431,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-743"></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-748"></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
@@ -3437,7 +3448,7 @@ where using ASCII characters for the character codes is merely
confusing.
</dl>
- <p><a name="index-property-list-format-744"></a>As an example of the output, here is the (abridged) property list
+ <p><a name="index-property-list-format-749"></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)
@@ -3490,14 +3501,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-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
+<li><a name="index-FAMILY-_0040r_007bproperty_007d-750"></a><a name="index-FACE-_0040r_007bproperty_007d-751"></a><a name="index-headerbyte-_0040r_007binformation_007d-752"></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-748"></a><a name="index-g_t_005cfontdimen-749"></a>The <code>FONTDIMEN</code> property defines the TeX <code>\fontdimen</code>
+ <li><a name="index-FAMILY-_0040r_007bproperty_007d-753"></a><a name="index-g_t_005cfontdimen-754"></a>The <code>FONTDIMEN</code> property defines the TeX <code>\fontdimen</code>
values.
- <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.
+ <li><a name="index-LIGTABLE-_0040r_007bproperty_007d-755"></a><a name="index-LABEL-_0040r_007bproperty_007d-756"></a><a name="index-LIG-_0040r_007bproperty_007d-757"></a><a name="index-KRN-_0040r_007bproperty_007d-758"></a><a name="index-ligature-table_002c-in-TFM-files-759"></a><a name="index-kerning-table_002c-in-TFM-files-760"></a><a name="index-design_002dsize-units-761"></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
@@ -3509,7 +3520,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-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
+ <li><a name="index-CHARACTER-_0040r_007bproperty_007d-762"></a><a name="index-CHARWD-_0040r_007bproperty_007d-763"></a><a name="index-CHARHT-_0040r_007bproperty_007d-764"></a><a name="index-CHARDP-_0040r_007bproperty_007d-765"></a><a name="index-CHARIC-_0040r_007bproperty_007d-766"></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
@@ -3528,7 +3539,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-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>
+<p><a name="index-pltotf-767"></a><a name="index-conversion_002c-property-list-to-TFM-768"></a><a name="index-TFM-files_002c-converting-property-lists-to-769"></a><a name="index-machine_002dreadable_002c-converting-property-lists-to-770"></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
@@ -3559,7 +3570,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-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>
+<p><a name="index-vftovp-771"></a><a name="index-conversion_002c-VF-to-VPL-772"></a><a name="index-validation_002c-of-VF-files-773"></a><a name="index-property-list_002c-converting-VF-to-virtual-774"></a><a name="index-human_002dreadable-text_002c-converting-VF-to-775"></a><a name="index-plain-text_002c-converting-VF-to-776"></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
@@ -3584,7 +3595,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-772"></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-777"></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
@@ -3612,7 +3623,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-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>
+<p><a name="index-vptovf-778"></a><a name="index-conversion_002c-property-list-to-VF-779"></a><a name="index-VF-files_002c-converting-property-lists-to-780"></a><a name="index-machine_002dreadable_002c-converting-property-lists-to-781"></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.
@@ -3641,7 +3652,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-777"></a>
+<p><a name="index-font-utilities_002c-non_002dWeb2c-782"></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,
@@ -3649,17 +3660,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-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-AFM-to-TFM-conversion-783"></a><a name="index-afm2tfm-784"></a><a name="index-afmtopl-785"></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-781"></a><a name="index-BDF-and-GF-conversion-782"></a>BDF (the X bitmap format) conversion:
+ <li><a name="index-X-bitmap-fonts-786"></a><a name="index-BDF-and-GF-conversion-787"></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-783"></a><a name="index-Latin-Modern-784"></a>Creating fonts using MetaPost: MetaType1.
+ <li><a name="index-metatype1-788"></a><a name="index-Latin-Modern-789"></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-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
+ <li><a name="index-editing-of-bitmap-fonts-790"></a><a name="index-xbfe_0040r_007b_002c-bitmap-font-editor_007d-791"></a><a name="index-xfed_0040r_007b_002c-bitmap-font-editor_007d-792"></a><a name="index-xfedor_0040r_007b_002c-bitmap-font-editor_007d-793"></a><a name="index-gftopxl-794"></a><a name="index-chtopx-795"></a><a name="index-pxtoch-796"></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
@@ -3667,30 +3678,30 @@ 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-792"></a><a name="index-pfaedit-793"></a>Editing of outline fonts: FontForge, <a href="fontforge.sourceforge.net">fontforge.sourceforge.net</a>.
+ <li><a name="index-fontforge-797"></a><a name="index-pfaedit-798"></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-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;
+ <li><a name="index-PK-bitmaps-from-PostScript-799"></a><a name="index-PostScript-to-PK-bitmaps-800"></a><a name="index-gsftopk-801"></a><a name="index-ps2pk-802"></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-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
+ <li><a name="index-Type-1-conversion-803"></a><a name="index-PFA-and-PFB-conversion-804"></a><a name="index-PostScript-Type-1-font-conversion-805"></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-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
+ <li><a name="index-scanned-images-of-fonts-806"></a><a name="index-typeface-specimen-sheets-807"></a><a name="index-fontutils-808"></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-804"></a><a name="index-potrace-805"></a>Tracing bitmaps to fitted outlines: Autotrace
+ <li><a name="index-autotrace-809"></a><a name="index-potrace-810"></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-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>.
+ <li><a name="index-virtual-font-creation-811"></a><a name="index-fontinst_0040r_007b_002c-for-creating-virtual-fonts_007d-812"></a>Virtual font creation: <samp><var>CTAN:</var><span class="file">/fonts/utilities/fontinst</span></samp>.
</ul>
<div class="node">
@@ -3704,7 +3715,7 @@ Up:&nbsp;<a rel="up" accesskey="u" href="#Top">Top</a>
<h2 class="appendix">Appendix A Legalisms</h2>
-<p><a name="index-legalisms-808"></a><a name="index-copyright-notices-809"></a><a name="index-permissions_002c-legal-810"></a>
+<p><a name="index-legalisms-813"></a><a name="index-copyright-notices-814"></a><a name="index-permissions_002c-legal-815"></a>
In general, each file has its own copyright notice stating the copying
permissions for that file. Following is a summary.
@@ -3758,7 +3769,7 @@ Up:&nbsp;<a rel="up" accesskey="u" href="#Top">Top</a>
<h2 class="appendix">Appendix B References</h2>
-<p><a name="index-references-811"></a><a name="index-bibliography-812"></a>
+<p><a name="index-references-816"></a><a name="index-bibliography-817"></a>
<ol type=1 start=1>
<li>Kpathsea: See <a href="kpathsea.html#Top">Introduction</a>.
@@ -3919,71 +3930,70 @@ Up:&nbsp;<a rel="up" accesskey="u" href="#Top">Top</a>
<ul class="index-cp" compact>
<li><a href="#index-g_t_0040samp_007b_0023define_007d-options-36">&lsquo;<samp><span class="samp">#define</span></samp>&rsquo; options</a>: <a href="#Compile_002dtime-options">Compile-time options</a></li>
-<li><a href="#index-g_t_0024-_0040r_007bexpansion-in-filenames_007d-225"><code>$ </code><span class="roman">expansion in filenames</span></a>: <a href="#g_t_005cinput-filenames">\input filenames</a></li>
-<li><a href="#index-g_t_0025_0026-_0040r_007bmagic-number_007d-182"><code>%&amp; </code><span class="roman">magic number</span></a>: <a href="#Determining-the-memory-dump-to-use">Determining the memory dump to use</a></li>
+<li><a href="#index-g_t_0024-_0040r_007bexpansion-in-filenames_007d-226"><code>$ </code><span class="roman">expansion in filenames</span></a>: <a href="#g_t_005cinput-filenames">\input filenames</a></li>
+<li><a href="#index-g_t_0025_0026-_0040r_007bmagic-number_007d-183"><code>%&amp; </code><span class="roman">magic number</span></a>: <a href="#Determining-the-memory-dump-to-use">Determining the memory dump to use</a></li>
<li><a href="#index-g_t_002d-_0040r_007bstarting-a-filename_007d-93"><code>- </code><span class="roman">starting a filename</span></a>: <a href="#Option-conventions">Option conventions</a></li>
<li><a href="#index-g_t_002d-_0040r_007bstarts-option-names_007d-91"><code>- </code><span class="roman">starts option names</span></a>: <a href="#Option-conventions">Option conventions</a></li>
<li><a href="#index-g_t_002d_002d-_0040r_007bstarts-option-names_007d-92"><code>-- </code><span class="roman">starts option names</span></a>: <a href="#Option-conventions">Option conventions</a></li>
-<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_002ddisable_002ddump_002dshare-configure-_0040r_007boption_007d-198"><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_002ddisable_002dmf_002dnowin-452"><code>--disable-mf-nowin</code></a>: <a href="#Online-Metafont-graphics">Online Metafont graphics</a></li>
+<li><a href="#index-g_t_002d_002denable_002depsfwin-419"><code>--enable-epsfwin</code></a>: <a href="#Online-Metafont-graphics">Online Metafont graphics</a></li>
+<li><a href="#index-g_t_002d_002denable_002dhp2627win-421"><code>--enable-hp2627win</code></a>: <a href="#Online-Metafont-graphics">Online Metafont graphics</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_002denable_002dmftalkwin-423"><code>--enable-mftalkwin</code></a>: <a href="#Online-Metafont-graphics">Online Metafont graphics</a></li>
+<li><a href="#index-g_t_002d_002denable_002dnext-426"><code>--enable-next</code></a>: <a href="#Online-Metafont-graphics">Online Metafont graphics</a></li>
+<li><a href="#index-g_t_002d_002denable_002dregiswin-428"><code>--enable-regiswin</code></a>: <a href="#Online-Metafont-graphics">Online Metafont graphics</a></li>
+<li><a href="#index-g_t_002d_002denable_002dsuntoolswin-433"><code>--enable-suntoolswin</code></a>: <a href="#Online-Metafont-graphics">Online Metafont graphics</a></li>
+<li><a href="#index-g_t_002d_002denable_002dtektronixwin-437"><code>--enable-tektronixwin</code></a>: <a href="#Online-Metafont-graphics">Online Metafont graphics</a></li>
+<li><a href="#index-g_t_002d_002denable_002dunitermwin-441"><code>--enable-unitermwin</code></a>: <a href="#Online-Metafont-graphics">Online Metafont graphics</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_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-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_002d_002dwith_002deditor_003d_0040var_007bcmd_007d-214"><code>--with-editor=</code><var>cmd</var></a>: <a href="#Editor-invocation">Editor invocation</a></li>
+<li><a href="#index-g_t_002d_002dwith_002dmf_002dx_002dtoolkit_003d_0040var_007bkit_007d-447"><code>--with-mf-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_002dx-446"><code>--with-x</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_007bbase_007d-180"><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-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_002dchange_003d_0040var_007bchfile_007d-484"><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-777"><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-748"><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_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_002ddpi_003d_0040var_007breal_007d-641"><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-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_002dfmt_003d_0040var_007bfmt_007d-179"><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-461"><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-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_002dimages-722"><code>-images</code></a>: <a href="#gftype-invocation">gftype invocation</a></li>
+<li><a href="#index-g_t_002dini-163"><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>
<li><a href="#index-g_t_002dipc-250"><code>-ipc</code></a>: <a href="#tex-invocation">tex invocation</a></li>
<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-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_002dlength_003d_0040var_007bnumber_007d-596"><code>-length=</code><var>number</var></a>: <a href="#tangle-invocation">tangle invocation</a></li>
+<li><a href="#index-g_t_002dloose-604"><code>-loose</code></a>: <a href="#tangle-invocation">tangle invocation</a></li>
+<li><a href="#index-g_t_002dlowercase-598"><code>-lowercase</code></a>: <a href="#tangle-invocation">tangle invocation</a></li>
+<li><a href="#index-g_t_002dmagnification_003d_0040var_007binteger_007d-642"><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-627"><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-645"><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-630"><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-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_002dmem_003d_0040var_007bmem_007d-181"><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-559"><code>-min-crossrefs=</code><var>n</var></a>: <a href="#bibtex-invocation">bibtex invocation</a></li>
+<li><a href="#index-g_t_002dmixedcase-599"><code>-mixedcase</code></a>: <a href="#tangle-invocation">tangle invocation</a></li>
+<li><a href="#index-g_t_002dmktex_003d_0040var_007bfiletype_007d-389"><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-718"><code>-mnemonics</code></a>: <a href="#gftype-invocation">gftype invocation</a></li>
+<li><a href="#index-g_t_002dmnemonics-723"><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-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-390"><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>
@@ -3991,342 +4001,344 @@ 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-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_002doutput_002dlevel_003d_0040var_007bn_007d-646"><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-474"><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-647"><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-631"><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-182"><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_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_002dshow_002dopcodes-651"><code>-show-opcodes</code></a>: <a href="#dvitype-invocation">dvitype invocation</a></li>
+<li><a href="#index-g_t_002dstrict-605"><code>-strict</code></a>: <a href="#tangle-invocation">tangle invocation</a></li>
+<li><a href="#index-g_t_002dstyle_003d_0040var_007bmftfile_007d-486"><code>-style=</code><var>mftfile</var></a>: <a href="#mft-invocation">mft invocation</a></li>
+<li><a href="#index-g_t_002dT-521"><code>-T</code></a>: <a href="#mpost-invocation">mpost invocation</a></li>
+<li><a href="#index-g_t_002dterse-556"><code>-terse</code></a>: <a href="#bibtex-invocation">bibtex invocation</a></li>
+<li><a href="#index-g_t_002dtex_003d_0040var_007btexprogram_007d-524"><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-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_002dtroff-522"><code>-troff</code></a>: <a href="#mpost-invocation">mpost invocation</a></li>
+<li><a href="#index-g_t_002dunderline-602"><code>-underline</code></a>: <a href="#tangle-invocation">tangle invocation</a></li>
+<li><a href="#index-g_t_002duppercase-600"><code>-uppercase</code></a>: <a href="#tangle-invocation">tangle invocation</a></li>
+<li><a href="#index-g_t_002dx-612"><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-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_002e2602gf-388"><code>.2602gf</code></a>: <a href="#mf-invocation">mf invocation</a></li>
+<li><a href="#index-g_t_002eaux-_0040r_007bcross_002dreference-files_007d-547"><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-393"><code>.base</code></a>: <a href="#Initial-Metafont">Initial Metafont</a></li>
+<li><a href="#index-g_t_002ebbl-_0040r_007bbibliography-files_007d-546"><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-548"><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-549"><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_002emem-527"><code>.mem</code></a>: <a href="#Initial-MetaPost">Initial MetaPost</a></li>
+<li><a href="#index-g_t_002emf-374"><code>.mf</code></a>: <a href="#mf-invocation">mf invocation</a></li>
+<li><a href="#index-g_t_002emp-500"><code>.mp</code></a>: <a href="#mpost-invocation">mpost invocation</a></li>
+<li><a href="#index-g_t_0040code_007b_002emps_007d-files-and-PDF-519"><code>.mps</code> files and PDF</a>: <a href="#mpost-invocation">mpost invocation</a></li>
+<li><a href="#index-g_t_002e_0040var_007bnnn_007d-_0040r_007bPostScript-figures_007d-503"><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-378"><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-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_t_002etex-235"><code>.tex</code></a>: <a href="#tex-invocation">tex invocation</a></li>
+<li><a href="#index-g_t_002etfm-_0040r_007boutput_007d-504"><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-383"><code>.tfm </code><span class="roman">output</span></a>: <a href="#mf-invocation">mf invocation</a></li>
+<li><a href="#index-g_t_002eXdefaults-459"><code>.Xdefaults</code></a>: <a href="#Online-Metafont-graphics">Online Metafont graphics</a></li>
+<li><a href="#index-g_t_002eXresources-460"><code>.Xresources</code></a>: <a href="#Online-Metafont-graphics">Online Metafont graphics</a></li>
+<li><a href="#index-g_t2602gf-387"><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-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_005cbibliography-551"><code>\bibliography</code></a>: <a href="#bibtex-invocation">bibtex invocation</a></li>
+<li><a href="#index-g_t_005cbibliographystyle-552"><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-749"><code>\fontdimen</code></a>: <a href="#tftopl-invocation">tftopl invocation</a></li>
+<li><a href="#index-g_t_005ccount_0040var_007bn_007d-650"><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-634"><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-240"><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-754"><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_005cinput-_0040r_007bfilenames_007d-217"><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_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_005cmag-644"><code>\mag</code></a>: <a href="#dvitype-invocation">dvitype invocation</a></li>
+<li><a href="#index-g_t_005cmag-629"><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_007band-security_007d-241"><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_005cstring-227"><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-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-g_t_0040cite_007bComputer-Modern-Typefaces_007d_002c-production-of-491"><cite>Computer Modern Typefaces</cite>, production of</a>: <a href="#mft-invocation">mft invocation</a></li>
+<li><a href="#index-abbrv_002ebst-574"><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-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-acm_002ebst-575"><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-588">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-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-AFM-to-TFM-conversion-783">AFM to TFM conversion</a>: <a href="#Font-utilities-available-elsewhere">Font utilities available elsewhere</a></li>
+<li><a href="#index-afm2tfm-784"><code>afm2tfm</code></a>: <a href="#Font-utilities-available-elsewhere">Font utilities available elsewhere</a></li>
+<li><a href="#index-afmtopl-785"><code>afmtopl</code></a>: <a href="#Font-utilities-available-elsewhere">Font utilities available elsewhere</a></li>
+<li><a href="#index-Aleph-357">Aleph</a>: <a href="#TeX-extensions">TeX extensions</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-571"><code>alpha.bst</code></a>: <a href="#Basic-BibTeX-style-files">Basic BibTeX style files</a></li>
+<li><a href="#index-alpha_002ebst-576"><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-apalike_002ebst-577"><code>apalike.bst</code></a>: <a href="#Basic-BibTeX-style-files">Basic BibTeX style files</a></li>
+<li><a href="#index-architecture-dependencies-196">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-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-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-autotrace-809"><code>autotrace</code></a>: <a href="#Font-utilities-available-elsewhere">Font utilities available elsewhere</a></li>
+<li><a href="#index-Awk_002c-WEB-for-587">Awk, WEB for</a>: <a href="#WEB">WEB</a></li>
+<li><a href="#index-base-file_002c-determining-177">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-394">base files</a>: <a href="#Initial-Metafont">Initial Metafont</a></li>
+<li><a href="#index-base-files_002c-need-mode-definitions-404">base files, need mode definitions</a>: <a href="#Modes">Modes</a></li>
+<li><a href="#index-base-files_002c-plain-only-401">base files, plain only</a>: <a href="#Initial-Metafont">Initial Metafont</a></li>
+<li><a href="#index-base-files_002c-sharing-190">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-566">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-571">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-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-batch-languages-231">batch languages</a>: <a href="#TeX">TeX</a></li>
+<li><a href="#index-BDF-and-GF-conversion-787">BDF and GF conversion</a>: <a href="#Font-utilities-available-elsewhere">Font utilities available elsewhere</a></li>
+<li><a href="#index-beginfig-502"><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-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-BIBINPUTS_0040r_007b_002c-search-path-for-bib-files_007d-554"><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-543">bibliographies, creating</a>: <a href="#BibTeX">BibTeX</a></li>
+<li><a href="#index-bibliography-817">bibliography</a>: <a href="#References">References</a></li>
+<li><a href="#index-bibliography-items_002c-cross_002dreferenced-561">bibliography items, cross-referenced</a>: <a href="#bibtex-invocation">bibtex invocation</a></li>
+<li><a href="#index-bibtex-545"><code>bibtex</code></a>: <a href="#bibtex-invocation">bibtex invocation</a></li>
+<li><a href="#index-Bib_0040TeX_007b_007d-544">BibTeX</a>: <a href="#BibTeX">BibTeX</a></li>
+<li><a href="#index-Bib_0040TeX_007b_007d-collection-568">BibTeX collection</a>: <a href="#bibtex-invocation">bibtex invocation</a></li>
+<li><a href="#index-Bib_0040TeX_007b_007d-style-files-572">BibTeX style files</a>: <a href="#Basic-BibTeX-style-files">Basic BibTeX style files</a></li>
+<li><a href="#index-BigEndian-machines-193">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-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-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-BSTINPUTS_0040r_007b_002c-search-path-for-bst-files_007d-555"><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-508"><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-565"><code>btxdoc.bib</code></a>: <a href="#bibtex-invocation">bibtex invocation</a></li>
+<li><a href="#index-btxdoc_002etex-562"><code>btxdoc.tex</code></a>: <a href="#bibtex-invocation">bibtex invocation</a></li>
+<li><a href="#index-btxhak_002etex-563"><code>btxhak.tex</code></a>: <a href="#bibtex-invocation">bibtex invocation</a></li>
+<li><a href="#index-byte-position-724">byte position</a>: <a href="#gftype-invocation">gftype invocation</a></li>
+<li><a href="#index-byte-position-691">byte position</a>: <a href="#pktype-invocation">pktype invocation</a></li>
+<li><a href="#index-byte-swapping-199">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-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-change-files_002c-and-MFT-485">change files, and MFT</a>: <a href="#mft-invocation">mft invocation</a></li>
+<li><a href="#index-change-files_002c-and-Tangle-593">change files, and Tangle</a>: <a href="#tangle-invocation">tangle invocation</a></li>
+<li><a href="#index-change-files_002c-and-Weave-611">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-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-GFtype-output-725">character codes, in GFtype output</a>: <a href="#gftype-invocation">gftype invocation</a></li>
+<li><a href="#index-character-codes_002c-in-PKtype-output-694">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-proofs-of-fonts-467">character proofs of fonts</a>: <a href="#gftodvi-invocation">gftodvi invocation</a></li>
+<li><a href="#index-CHARACTER-_0040r_007bproperty_007d-762"><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-CHARDP-_0040r_007bproperty_007d-765"><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-764"><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-766"><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-763"><code>CHARWD </code><span class="roman">property</span></a>: <a href="#tftopl-invocation">tftopl invocation</a></li>
+<li><a href="#index-chtopx-795"><code>chtopx</code></a>: <a href="#Font-utilities-available-elsewhere">Font utilities available elsewhere</a></li>
+<li><a href="#index-class-name-for-Metafont-456">class name for Metafont</a>: <a href="#Online-Metafont-graphics">Online Metafont graphics</a></li>
+<li><a href="#index-cm_002ebase-398"><code>cm.base</code></a>: <a href="#Initial-Metafont">Initial Metafont</a></li>
+<li><a href="#index-cmbase_002emf-399"><code>cmbase.mf</code></a>: <a href="#Initial-Metafont">Initial Metafont</a></li>
+<li><a href="#index-cmbase_002emft-489"><code>cmbase.mft</code></a>: <a href="#mft-invocation">mft invocation</a></li>
+<li><a href="#index-cmmf_002ebase-_0040r_007bnot-recommended_007d-397"><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-542">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-comments_002c-MFT-control-482">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-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-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-Computer-Modern-fonts_002c-and-Troff-512">Computer Modern fonts, and Troff</a>: <a href="#mpost-invocation">mpost invocation</a></li>
+<li><a href="#index-Computer-Modern-macros-400">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-609"><code>CONTENTS.tex</code></a>: <a href="#weave-invocation">weave invocation</a></li>
+<li><a href="#index-CONTENTS_002etex-614"><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-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-conversion_002c-DVI-to-plain-text-636">conversion, DVI to plain text</a>: <a href="#dvitype-invocation">dvitype invocation</a></li>
+<li><a href="#index-conversion_002c-GF-to-PK-678">conversion, GF to PK</a>: <a href="#gftopk-invocation">gftopk invocation</a></li>
+<li><a href="#index-conversion_002c-GF-to-plain-text-717">conversion, GF to plain text</a>: <a href="#gftype-invocation">gftype invocation</a></li>
+<li><a href="#index-conversion_002c-PK-to-GF-682">conversion, PK to GF</a>: <a href="#pktogf-invocation">pktogf invocation</a></li>
+<li><a href="#index-conversion_002c-PK-to-plain-text-686">conversion, PK to plain text</a>: <a href="#pktype-invocation">pktype invocation</a></li>
+<li><a href="#index-conversion_002c-property-list-to-TFM-768">conversion, property list to TFM</a>: <a href="#pltotf-invocation">pltotf invocation</a></li>
+<li><a href="#index-conversion_002c-property-list-to-VF-779">conversion, property list to VF</a>: <a href="#vptovf-invocation">vptovf invocation</a></li>
+<li><a href="#index-conversion_002c-TFM-to-property-list-743">conversion, TFM to property list</a>: <a href="#tftopl-invocation">tftopl invocation</a></li>
+<li><a href="#index-conversion_002c-VF-to-VPL-772">conversion, VF to VPL</a>: <a href="#vftovp-invocation">vftovp invocation</a></li>
+<li><a href="#index-copyright-notices-814">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-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-creating-memory-dumps-173">creating memory dumps</a>: <a href="#Creating-memory-dumps">Creating memory dumps</a></li>
+<li><a href="#index-cross_002dreferenced-bibliography-items-560">cross-referenced bibliography items</a>: <a href="#bibtex-invocation">bibtex invocation</a></li>
+<li><a href="#index-cross_002dreferences_002c-omitting-613">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-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-649">debugging DVI utilities</a>: <a href="#dvitype-invocation">dvitype invocation</a></li>
+<li><a href="#index-CWEB-586">CWEB</a>: <a href="#WEB">WEB</a></li>
+<li><a href="#index-Cweb-585">Cweb</a>: <a href="#WEB">WEB</a></li>
+<li><a href="#index-date-and-time_002c-in-memory-dumps-203">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-654">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-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-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-dependencies_002c-hardware-197">dependencies, hardware</a>: <a href="#Hardware-and-memory-dumps">Hardware and memory dumps</a></li>
+<li><a href="#index-design_002dsize-units-761">design-size units</a>: <a href="#tftopl-invocation">tftopl invocation</a></li>
+<li><a href="#index-device-definitions_002c-for-Metafont-405">device definitions, for Metafont</a>: <a href="#Modes">Modes</a></li>
+<li><a href="#index-device_002dindependent-width-740">device-independent width</a>: <a href="#gftype-invocation">gftype invocation</a></li>
+<li><a href="#index-device_002dindependent-width-697">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-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-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-DISPLAY-462"><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-245">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-514">downloading of fonts for MetaPost labels</a>: <a href="#mpost-invocation">mpost invocation</a></li>
+<li><a href="#index-DrawingServant-425"><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-dumping-memory-169">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-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-DVI-files_002c-converting-to-MPX-540">DVI files, converting to MPX</a>: <a href="#dvitomp-invocation">dvitomp invocation</a></li>
+<li><a href="#index-DVI-files_002c-explained-668">DVI files, explained</a>: <a href="#Font-file-formats">Font file formats</a></li>
+<li><a href="#index-DVI-format-definition-624">DVI format definition</a>: <a href="#DVI-utilities">DVI utilities</a></li>
+<li><a href="#index-DVI-opcodes_002c-showing-653">DVI opcodes, showing</a>: <a href="#dvitype-invocation">dvitype invocation</a></li>
+<li><a href="#index-DVI-utilities-622">DVI utilities</a>: <a href="#DVI-utilities">DVI utilities</a></li>
+<li><a href="#index-dvicopy-625"><code>dvicopy</code></a>: <a href="#dvicopy-invocation">dvicopy invocation</a></li>
+<li><a href="#index-dvitomp-539"><code>dvitomp</code></a>: <a href="#dvitomp-invocation">dvitomp invocation</a></li>
+<li><a href="#index-dvitype-_0040r_007bDVI-validation_007d-635"><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-655">dvitype output example</a>: <a href="#dvitype-output-example">dvitype output example</a></li>
+<li><a href="#index-dvitype_002eweb-623"><code>dvitype.web</code></a>: <a href="#DVI-utilities">DVI utilities</a></li>
+<li><a href="#index-dx-_0040r_007bhorizontal-escapement_007d-737">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-702">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-738">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-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-dynamic-Metafont-mode-definitions-with-_0040code_007bsmode_007d-412">dynamic Metafont mode definitions with <code>smode</code></a>: <a href="#Modes">Modes</a></li>
+<li><a href="#index-dynamic-packing-variable-693">dynamic packing variable</a>: <a href="#pktype-invocation">pktype invocation</a></li>
+<li><a href="#index-e-_0040r_007bresponse-at-error-prompt_007d-210"><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-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-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-e_002emft-490"><code>e.mft</code></a>: <a href="#mft-invocation">mft invocation</a></li>
+<li><a href="#index-EC-fonts-376">EC fonts</a>: <a href="#mf-invocation">mf invocation</a></li>
+<li><a href="#index-EC-fonts-238">EC fonts</a>: <a href="#tex-invocation">tex invocation</a></li>
+<li><a href="#index-editing-of-bitmap-fonts-790">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-208">editor invoked at error</a>: <a href="#Editor-invocation">Editor invocation</a></li>
+<li><a href="#index-eight_002dbit-characters-in-filenames-222">eight-bit characters in filenames</a>: <a href="#g_t_005cinput-filenames">\input filenames</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-726"><code>eoc </code><span class="roman">GF command</span></a>: <a href="#gftype-invocation">gftype invocation</a></li>
+<li><a href="#index-endian-dependencies-194">endian dependencies</a>: <a href="#Hardware-and-memory-dumps">Hardware and memory dumps</a></li>
+<li><a href="#index-eoc-_0040r_007bGF-command_007d-731"><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-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-epsf-417"><code>epsf</code></a>: <a href="#Online-Metafont-graphics">Online Metafont graphics</a></li>
+<li><a href="#index-errors_002c-editor-invoked-at-209">errors, editor invoked at</a>: <a href="#Editor-invocation">Editor invocation</a></li>
+<li><a href="#index-escapement_002c-horizontal-733">escapement, horizontal</a>: <a href="#gftype-invocation">gftype invocation</a></li>
+<li><a href="#index-escapement_002c-horizontal-700">escapement, horizontal</a>: <a href="#pktype-invocation">pktype invocation</a></li>
+<li><a href="#index-escapement_002c-vertical-735">escapement, vertical</a>: <a href="#gftype-invocation">gftype invocation</a></li>
+<li><a href="#index-etex-_0040r_007bfor-MetaPost-labels_007d-509"><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-162">executables, shared initial and virgin</a>: <a href="#Initial-and-virgin">Initial and virgin</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-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-FACE-_0040r_007bproperty_007d-751"><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-750"><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-formats-for-fonts-662">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-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-filename-conventions_002c-in-input-files-216">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-687">flag byte</a>: <a href="#pktype-invocation">pktype invocation</a></li>
+<li><a href="#index-flag-byte-692">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-floating_002dpoint-values-201">floating-point values</a>: <a href="#Hardware-and-memory-dumps">Hardware and memory dumps</a></li>
+<li><a href="#index-fmt-file_002c-determining-176">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-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-fmt-files_002c-sharing-189">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-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-design-371">font design</a>: <a href="#Metafont">Metafont</a></li>
+<li><a href="#index-font-downloading-for-MetaPost-labels-515">font downloading for MetaPost labels</a>: <a href="#mpost-invocation">mpost invocation</a></li>
+<li><a href="#index-font-file-formats-661">font file formats</a>: <a href="#Font-file-formats">Font file formats</a></li>
+<li><a href="#index-font-proofs-468">font proofs</a>: <a href="#gftodvi-invocation">gftodvi invocation</a></li>
+<li><a href="#index-font-utilities-656">font utilities</a>: <a href="#Font-utilities">Font utilities</a></li>
+<li><a href="#index-font-utilities_002c-non_002dWeb2c-782">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-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-fontforge-797"><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-812"><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-803"><code>fontutils</code></a>: <a href="#Font-utilities-available-elsewhere">Font utilities available elsewhere</a></li>
+<li><a href="#index-fontutils-808"><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-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-562"><code>ftp.math.utah.edu</code></a>: <a href="#bibtex-invocation">bibtex invocation</a></li>
+<li><a href="#index-ftp_002emath_002eutah_002eedu-567"><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-geometric-designs-369">geometric designs</a>: <a href="#Metafont">Metafont</a></li>
+<li><a href="#index-geometric-font-scaling-666">geometric font scaling</a>: <a href="#Font-file-formats">Font file formats</a></li>
+<li><a href="#index-geometry-for-Metafont-457">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-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-GF-files_002c-explained-671">GF files, explained</a>: <a href="#Font-file-formats">Font file formats</a></li>
+<li><a href="#index-GF-files_002c-output-by-Metafont-381">GF files, output by Metafont</a>: <a href="#mf-invocation">mf invocation</a></li>
+<li><a href="#index-GF-format-definition-660">GF format definition</a>: <a href="#Font-utilities">Font utilities</a></li>
+<li><a href="#index-GF-output-380">GF output</a>: <a href="#mf-invocation">mf invocation</a></li>
+<li><a href="#index-GF_002c-converting-PK-to-683">GF, converting PK to</a>: <a href="#pktogf-invocation">pktogf invocation</a></li>
+<li><a href="#index-GF_002c-converting-to-PK-680">GF, converting to PK</a>: <a href="#gftopk-invocation">gftopk invocation</a></li>
+<li><a href="#index-gftodvi-466"><code>gftodvi</code></a>: <a href="#gftodvi-invocation">gftodvi invocation</a></li>
+<li><a href="#index-gftopk-677"><code>gftopk</code></a>: <a href="#gftopk-invocation">gftopk invocation</a></li>
+<li><a href="#index-gftopxl-794"><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-716"><code>gftype </code><span class="roman">GF validation</span></a>: <a href="#gftype-invocation">gftype invocation</a></li>
+<li><a href="#index-gftype_002eweb-658"><code>gftype.web</code></a>: <a href="#Font-utilities">Font utilities</a></li>
+<li><a href="#index-glue-ratio-representations-202">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-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-gray-font-470">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-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-gsftopk-801"><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-206">Harbison, Samuel P.</a>: <a href="#Hardware-and-memory-dumps">Hardware and memory dumps</a></li>
+<li><a href="#index-hardware-and-memory-dumps-186">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-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-headerbyte-_0040r_007binformation_007d-752"><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-703">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-416">Herberts, Mathias</a>: <a href="#Online-Metafont-graphics">Online Metafont graphics</a></li>
+<li><a href="#index-Herberts_002c-Mathias-418">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-4">Hobby, John</a>: <a href="#Introduction">Introduction</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-horizontal-escapement-732">horizontal escapement</a>: <a href="#gftype-invocation">gftype invocation</a></li>
+<li><a href="#index-horizontal-escapement-699">horizontal escapement</a>: <a href="#pktype-invocation">pktype invocation</a></li>
+<li><a href="#index-hp2627-420"><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-human_002dreadable-text_002c-converting-DVI-to-638">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-719">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-688">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-746">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-775">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-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-identifier-case-601">identifier case</a>: <a href="#tangle-invocation">tangle invocation</a></li>
+<li><a href="#index-identifier-collisions-606">identifier collisions</a>: <a href="#tangle-invocation">tangle invocation</a></li>
+<li><a href="#index-identifier-length-597">identifier length</a>: <a href="#tangle-invocation">tangle invocation</a></li>
+<li><a href="#index-identifiers-with-underlines-603">identifiers with underlines</a>: <a href="#tangle-invocation">tangle invocation</a></li>
+<li><a href="#index-ieeetr_002ebst-578"><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-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-Metafont-391">initial Metafont</a>: <a href="#Initial-Metafont">Initial Metafont</a></li>
+<li><a href="#index-initial-MetaPost-525">initial MetaPost</a>: <a href="#Initial-MetaPost">Initial MetaPost</a></li>
+<li><a href="#index-initial-programs-166">initial programs</a>: <a href="#Initial-and-virgin">Initial and virgin</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-initializations_002c-lengthy-167">initializations, lengthy</a>: <a href="#Initial-and-virgin">Initial and virgin</a></li>
+<li><a href="#index-input-filenames-215">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>
<li><a href="#index-install_002dfmts-_0040r_007bMake-target_007d-52"><code>install-fmts </code><span class="roman">Make target</span></a>: <a href="#Additional-targets">Additional targets</a></li>
<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>
@@ -4340,312 +4352,314 @@ Up:&nbsp;<a rel="up" accesskey="u" href="#Top">Top</a>
<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-755">kerning table, in TFM files</a>: <a href="#tftopl-invocation">tftopl invocation</a></li>
+<li><a href="#index-kerning-table_002c-in-TFM-files-760">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-483">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-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-KRN-_0040r_007bproperty_007d-758"><code>KRN </code><span class="roman">property</span></a>: <a href="#tftopl-invocation">tftopl invocation</a></li>
+<li><a href="#index-label-font-472">label font</a>: <a href="#gftodvi-invocation">gftodvi invocation</a></li>
+<li><a href="#index-LABEL-_0040r_007bproperty_007d-756"><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-Latin-Modern-789">Latin Modern</a>: <a href="#Font-utilities-available-elsewhere">Font utilities available elsewhere</a></li>
+<li><a href="#index-left-side-bearing-726">left side bearing</a>: <a href="#gftype-invocation">gftype invocation</a></li>
+<li><a href="#index-left-side-bearing-712">left side bearing</a>: <a href="#pktype-invocation">pktype invocation</a></li>
+<li><a href="#index-legalisms-813">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-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-LIG-_0040r_007bproperty_007d-757"><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-759">ligature table, in TFM files</a>: <a href="#tftopl-invocation">tftopl invocation</a></li>
+<li><a href="#index-LIGTABLE-_0040r_007bproperty_007d-755"><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-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-545">log file, BibTeX</a>: <a href="#bibtex-invocation">bibtex invocation</a></li>
+<li><a href="#index-links-to-binaries-185">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-582">literate programming</a>: <a href="#WEB">WEB</a></li>
+<li><a href="#index-LittleEndian-machines-192">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-550">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-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-machine-dependencies-195">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-781">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-770">machine-readable, converting property lists to</a>: <a href="#pltotf-invocation">pltotf invocation</a></li>
+<li><a href="#index-MacKay_002c-Pierre-675">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-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-macros_002c-predefining-in-memory-dumps-170">macros, predefining in memory dumps</a>: <a href="#Memory-dumps">Memory dumps</a></li>
+<li><a href="#index-magnification-643">magnification</a>: <a href="#dvitype-invocation">dvitype invocation</a></li>
+<li><a href="#index-magnification-628">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-Martin_002c-Rick-20">Martin, Rick</a>: <a href="#Introduction">Introduction</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-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>
-<li><a href="#index-memory-dumps-and-hardware-186">memory dumps and hardware</a>: <a href="#Hardware-and-memory-dumps">Hardware and memory dumps</a></li>
-<li><a href="#index-memory-dumps_002c-contain-date-and-time-204">memory dumps, contain date and time</a>: <a href="#Hardware-and-memory-dumps">Hardware and memory dumps</a></li>
-<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-mathematical-typesetting-230">mathematical typesetting</a>: <a href="#TeX">TeX</a></li>
+<li><a href="#index-mem-file_002c-determining-178">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-528">mem files</a>: <a href="#Initial-MetaPost">Initial MetaPost</a></li>
+<li><a href="#index-mem-files_002c-plain-only-531">mem files, plain only</a>: <a href="#Initial-MetaPost">Initial MetaPost</a></li>
+<li><a href="#index-mem-files_002c-sharing-191">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-175">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-168">memory dumps</a>: <a href="#Memory-dumps">Memory dumps</a></li>
+<li><a href="#index-memory-dumps-and-hardware-187">memory dumps and hardware</a>: <a href="#Hardware-and-memory-dumps">Hardware and memory dumps</a></li>
+<li><a href="#index-memory-dumps_002c-contain-date-and-time-205">memory dumps, contain date and time</a>: <a href="#Hardware-and-memory-dumps">Hardware and memory dumps</a></li>
+<li><a href="#index-memory-dumps_002c-creating-172">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-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-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-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-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-meta-characters-in-filenames-223">meta characters in filenames</a>: <a href="#g_t_005cinput-filenames">\input filenames</a></li>
+<li><a href="#index-Metafont-367">Metafont</a>: <a href="#Metafont">Metafont</a></li>
+<li><a href="#index-Metafont-geometry-458">Metafont geometry</a>: <a href="#Online-Metafont-graphics">Online Metafont graphics</a></li>
+<li><a href="#index-Metafont-graphics-414">Metafont graphics</a>: <a href="#Online-Metafont-graphics">Online Metafont graphics</a></li>
+<li><a href="#index-Metafont-input-files-375">Metafont input files</a>: <a href="#mf-invocation">mf invocation</a></li>
+<li><a href="#index-Metafont-invocation-373">Metafont invocation</a>: <a href="#mf-invocation">mf invocation</a></li>
+<li><a href="#index-Metafont-meets-PostScript-495">Metafont meets PostScript</a>: <a href="#MetaPost">MetaPost</a></li>
+<li><a href="#index-Metafont-online-support_002c-new-devices-463">Metafont online support, new devices</a>: <a href="#Online-Metafont-graphics">Online Metafont graphics</a></li>
+<li><a href="#index-Metafont-source_002c-prettyprinting-478">Metafont source, prettyprinting</a>: <a href="#mft-invocation">mft invocation</a></li>
+<li><a href="#index-Metafont_002c-compatibility-in-MetaPost-532">Metafont, compatibility in MetaPost</a>: <a href="#Initial-MetaPost">Initial MetaPost</a></li>
+<li><a href="#index-Metafont_002c-initial-392">Metafont, initial</a>: <a href="#Initial-Metafont">Initial Metafont</a></li>
+<li><a href="#index-Metafont_002c-MetaPost_002c-and-_0040TeX_007b_007d-160">Metafont, MetaPost, and TeX</a>: <a href="#Three-programs">Three programs</a></li>
+<li><a href="#index-MetaFun_002c-enhanced-MetaPost-537">MetaFun, enhanced MetaPost</a>: <a href="#Initial-MetaPost">Initial MetaPost</a></li>
+<li><a href="#index-metafun_002emp-536"><code>metafun.mp</code></a>: <a href="#Initial-MetaPost">Initial MetaPost</a></li>
+<li><a href="#index-MetaPost-493">MetaPost</a>: <a href="#MetaPost">MetaPost</a></li>
+<li><a href="#index-MetaPost-and-plain-Metafont-compatibility-534">MetaPost and plain Metafont compatibility</a>: <a href="#Initial-MetaPost">Initial MetaPost</a></li>
+<li><a href="#index-MetaPost-input-files-501">MetaPost input files</a>: <a href="#mpost-invocation">mpost invocation</a></li>
+<li><a href="#index-MetaPost-invocation-497">MetaPost invocation</a>: <a href="#mpost-invocation">mpost invocation</a></li>
+<li><a href="#index-MetaPost-source_002c-prettyprinting-492">MetaPost source, prettyprinting</a>: <a href="#mft-invocation">mft invocation</a></li>
+<li><a href="#index-MetaPost_002c-initial-526">MetaPost, initial</a>: <a href="#Initial-MetaPost">Initial MetaPost</a></li>
+<li><a href="#index-MetaPost_002c-_0040TeX_007b_007d_002c-and-Metafont-161">MetaPost, TeX, and Metafont</a>: <a href="#Three-programs">Three programs</a></li>
+<li><a href="#index-metatype1-788"><code>metatype1</code></a>: <a href="#Font-utilities-available-elsewhere">Font utilities available elsewhere</a></li>
+<li><a href="#index-mf-372"><code>mf</code></a>: <a href="#mf-invocation">mf invocation</a></li>
+<li><a href="#index-mf_002ebase-396"><code>mf.base</code></a>: <a href="#Initial-Metafont">Initial Metafont</a></li>
+<li><a href="#index-MFEDIT-212"><code>MFEDIT</code></a>: <a href="#Editor-invocation">Editor invocation</a></li>
+<li><a href="#index-mfplain_002emem-535"><code>mfplain.mem</code></a>: <a href="#Initial-MetaPost">Initial MetaPost</a></li>
+<li><a href="#index-mfput-379"><code>mfput</code></a>: <a href="#mf-invocation">mf invocation</a></li>
+<li><a href="#index-mft-477"><code>mft</code></a>: <a href="#mft-invocation">mft invocation</a></li>
+<li><a href="#index-mftalk-422"><code>mftalk</code></a>: <a href="#Online-Metafont-graphics">Online Metafont graphics</a></li>
+<li><a href="#index-MFTERM-415"><code>MFTERM</code></a>: <a href="#Online-Metafont-graphics">Online Metafont graphics</a></li>
+<li><a href="#index-mftmac_002etex-481"><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-mktexmf_0040r_007b_002c-disabling_007d-377"><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-239"><code>mktextfM</code><span class="roman">, disabling</span></a>: <a href="#tex-invocation">tex invocation</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-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-mode-needed-to-run-Metafont-385">mode needed to run Metafont</a>: <a href="#mf-invocation">mf invocation</a></li>
+<li><a href="#index-mode_005fdef-409"><code>mode_def</code></a>: <a href="#Modes">Modes</a></li>
+<li><a href="#index-mode_005fsetup-410"><code>mode_setup</code></a>: <a href="#Modes">Modes</a></li>
+<li><a href="#index-modes-file-needed-for-Metafont-403">modes file needed for Metafont</a>: <a href="#Modes">Modes</a></li>
+<li><a href="#index-modes_002emf-_0040r_007brecommended-modes-file_007d-407"><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-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-MPEDIT-213"><code>MPEDIT</code></a>: <a href="#Editor-invocation">Editor invocation</a></li>
+<li><a href="#index-mpgraph_002eps-499"><code>mpgraph.ps</code></a>: <a href="#mpost-invocation">mpost invocation</a></li>
+<li><a href="#index-mpman_002eps-498"><code>mpman.ps</code></a>: <a href="#mpost-invocation">mpost invocation</a></li>
+<li><a href="#index-mpost-496"><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-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-mpost_002emem-530"><code>mpost.mem</code></a>: <a href="#Initial-MetaPost">Initial MetaPost</a></li>
+<li><a href="#index-mpout-505"><code>mpout</code></a>: <a href="#mpost-invocation">mpost invocation</a></li>
+<li><a href="#index-mproof_002etex-513"><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-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-MPX-files_002c-converting-from-DVI-files-541">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-new-graphics-support-for-Metafont-464">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-730"><code>newrow </code><span class="roman">GF command</span></a>: <a href="#gftype-invocation">gftype invocation</a></li>
+<li><a href="#index-next-424"><code>next</code></a>: <a href="#Online-Metafont-graphics">Online Metafont graphics</a></li>
+<li><a href="#index-NO_005fX11WIN-442"><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-non_002dwindows_002dcapable-Metafont-453">non-windows-capable Metafont</a>: <a href="#Online-Metafont-graphics">Online Metafont graphics</a></li>
+<li><a href="#index-NUL_002c-not-allowed-in-filenames-221">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-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-offset-for-overflow-labels-476">offset for overflow labels</a>: <a href="#gftodvi-invocation">gftodvi invocation</a></li>
+<li><a href="#index-online-Metafont-graphics-413">online Metafont graphics</a>: <a href="#Online-Metafont-graphics">Online Metafont graphics</a></li>
+<li><a href="#index-opcodes_002c-showing-DVI-652">opcodes, showing DVI</a>: <a href="#dvitype-invocation">dvitype invocation</a></li>
+<li><a href="#index-optical-font-scaling-665">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-704">origin</a>: <a href="#pktype-invocation">pktype invocation</a></li>
+<li><a href="#index-origin-709">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-files_002c-written-by-_0040TeX_007b_007d-programs-243">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-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-overflow-label-offset-475">overflow label offset</a>: <a href="#gftodvi-invocation">gftodvi invocation</a></li>
+<li><a href="#index-packet-length-695">packet length</a>: <a href="#pktype-invocation">pktype invocation</a></li>
+<li><a href="#index-page_002c-starting-649">page, starting</a>: <a href="#dvitype-invocation">dvitype invocation</a></li>
+<li><a href="#index-page_002c-starting-633">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-586">Pascal, creating from WEB</a>: <a href="#tangle-invocation">tangle invocation</a></li>
+<li><a href="#index-Pascal_002c-creating-from-WEB-591">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-360">PDF</a>: <a href="#TeX-extensions">TeX extensions</a></li>
+<li><a href="#index-PDF_002c-and-_0040code_007b_002emps_007d-files-518">PDF, and <code>.mps</code> files</a>: <a href="#mpost-invocation">mpost invocation</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-permissions_002c-legal-815">permissions, legal</a>: <a href="#Legalisms">Legalisms</a></li>
+<li><a href="#index-PFA-and-PFB-conversion-804">PFA and PFB conversion</a>: <a href="#Font-utilities-available-elsewhere">Font utilities available elsewhere</a></li>
+<li><a href="#index-pfaedit-798"><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-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-pixel-height-704">pixel height</a>: <a href="#pktype-invocation">pktype invocation</a></li>
+<li><a href="#index-pixel-width-705">pixel width</a>: <a href="#pktype-invocation">pktype invocation</a></li>
+<li><a href="#index-PK-bitmaps-from-PostScript-799">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-670">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-382">PK files, not output by Metafont</a>: <a href="#mf-invocation">mf invocation</a></li>
+<li><a href="#index-PK-format-definition-659">PK format definition</a>: <a href="#Font-utilities">Font utilities</a></li>
+<li><a href="#index-PK_002c-converting-GF-to-679">PK, converting GF to</a>: <a href="#gftopk-invocation">gftopk invocation</a></li>
+<li><a href="#index-PK_002c-converting-to-GF-684">PK, converting to GF</a>: <a href="#pktogf-invocation">pktogf invocation</a></li>
+<li><a href="#index-pktogf-681"><code>pktogf</code></a>: <a href="#pktogf-invocation">pktogf invocation</a></li>
+<li><a href="#index-pktype-_0040r_007bPK-validation_007d-685"><code>pktype </code><span class="roman">PK validation</span></a>: <a href="#pktype-invocation">pktype invocation</a></li>
+<li><a href="#index-pktype_002eweb-657"><code>pktype.web</code></a>: <a href="#Font-utilities">Font utilities</a></li>
+<li><a href="#index-PL-files_002c-explained-672">PL files, explained</a>: <a href="#Font-file-formats">Font file formats</a></li>
+<li><a href="#index-plain-Metafont_002c-compatibility-in-MetaPost-533">plain Metafont, compatibility in MetaPost</a>: <a href="#Initial-MetaPost">Initial MetaPost</a></li>
+<li><a href="#index-plain-text_002c-converting-DVI-to-637">plain text, converting DVI to</a>: <a href="#dvitype-invocation">dvitype invocation</a></li>
+<li><a href="#index-plain-text_002c-converting-GF-to-718">plain text, converting GF to</a>: <a href="#gftype-invocation">gftype invocation</a></li>
+<li><a href="#index-plain-text_002c-converting-PK-to-687">plain text, converting PK to</a>: <a href="#pktype-invocation">pktype invocation</a></li>
+<li><a href="#index-plain-text_002c-converting-TFM-to-747">plain text, converting TFM to</a>: <a href="#tftopl-invocation">tftopl invocation</a></li>
+<li><a href="#index-plain-text_002c-converting-VF-to-776">plain text, converting VF to</a>: <a href="#vftovp-invocation">vftovp invocation</a></li>
+<li><a href="#index-plain_002ebase-395"><code>plain.base</code></a>: <a href="#Initial-Metafont">Initial Metafont</a></li>
+<li><a href="#index-plain_002ebst-573"><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-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-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-plain_002emem-529"><code>plain.mem</code></a>: <a href="#Initial-MetaPost">Initial MetaPost</a></li>
+<li><a href="#index-plain_002emft-488"><code>plain.mft</code></a>: <a href="#mft-invocation">mft invocation</a></li>
+<li><a href="#index-pltotf-767"><code>pltotf</code></a>: <a href="#pltotf-invocation">pltotf invocation</a></li>
+<li><a href="#index-pool-file_002c-writing-594">pool file, writing</a>: <a href="#tangle-invocation">tangle invocation</a></li>
+<li><a href="#index-Poole_002c-Simon-438">Poole, Simon</a>: <a href="#Online-Metafont-graphics">Online Metafont graphics</a></li>
+<li><a href="#index-pooltype-616"><code>pooltype</code></a>: <a href="#pooltype-invocation">pooltype invocation</a></li>
+<li><a href="#index-portable-filenames-224">portable filenames</a>: <a href="#g_t_005cinput-filenames">\input filenames</a></li>
+<li><a href="#index-PostScript-fonts_002c-and-Troff-510">PostScript fonts, and Troff</a>: <a href="#mpost-invocation">mpost invocation</a></li>
+<li><a href="#index-PostScript-meets-Metafont-494">PostScript meets Metafont</a>: <a href="#MetaPost">MetaPost</a></li>
+<li><a href="#index-PostScript-output-507">PostScript output</a>: <a href="#mpost-invocation">mpost invocation</a></li>
+<li><a href="#index-PostScript-to-PK-bitmaps-800">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-805">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-667">PostScript, and font scaling</a>: <a href="#Font-file-formats">Font file formats</a></li>
+<li><a href="#index-potrace-810"><code>potrace</code></a>: <a href="#Font-utilities-available-elsewhere">Font utilities available elsewhere</a></li>
+<li><a href="#index-Pragma-ADE-538">Pragma ADE</a>: <a href="#Initial-MetaPost">Initial MetaPost</a></li>
+<li><a href="#index-predefined-macros-and-memory-dumps-171">predefined macros and memory dumps</a>: <a href="#Memory-dumps">Memory dumps</a></li>
+<li><a href="#index-prettyprinting-Metafont-source-479">prettyprinting Metafont source</a>: <a href="#mft-invocation">mft invocation</a></li>
+<li><a href="#index-prettyprinting-WEB-programs-610">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-printer-characteristics_002c-for-Metafont-406">printer characteristics, for Metafont</a>: <a href="#Modes">Modes</a></li>
+<li><a href="#index-production-use-165">production use</a>: <a href="#Initial-and-virgin">Initial and virgin</a></li>
+<li><a href="#index-program-name_002c-determines-memory-dump-184">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-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-prologues-523"><code>prologues</code></a>: <a href="#mpost-invocation">mpost invocation</a></li>
+<li><a href="#index-prologues_0040r_007b_002c-and-EPSF-output_007d-516"><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-386"><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-469">proof sheets, of fonts</a>: <a href="#gftodvi-invocation">gftodvi invocation</a></li>
+<li><a href="#index-property-list-format-749">property list format</a>: <a href="#tftopl-invocation">tftopl invocation</a></li>
+<li><a href="#index-property-list_002c-converting-TFM-to-745">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-774">property list, converting VF to virtual</a>: <a href="#vftovp-invocation">vftovp invocation</a></li>
+<li><a href="#index-ps2pk-802"><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-517"><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-669">PXL files, explained</a>: <a href="#Font-file-formats">Font file formats</a></li>
+<li><a href="#index-pxtoch-796"><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-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-reference-pixel-710">reference pixel</a>: <a href="#pktype-invocation">pktype invocation</a></li>
+<li><a href="#index-references-816">references</a>: <a href="#References">References</a></li>
+<li><a href="#index-regis-427"><code>regis</code></a>: <a href="#Online-Metafont-graphics">Online Metafont graphics</a></li>
+<li><a href="#index-Regis-graphics-support-429">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-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-repeated-rows-715">repeated rows</a>: <a href="#pktype-invocation">pktype invocation</a></li>
+<li><a href="#index-representation-of-strings-620">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-right-side-bearing-727">right side bearing</a>: <a href="#gftype-invocation">gftype invocation</a></li>
+<li><a href="#index-right-side-bearing-713">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-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-run-length-encoded-bitmaps-729">run length encoded bitmaps</a>: <a href="#gftype-invocation">gftype invocation</a></li>
+<li><a href="#index-run-length-encoded-bitmaps-714">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-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-scaled-pixels-736">scaled pixels</a>: <a href="#gftype-invocation">gftype invocation</a></li>
+<li><a href="#index-scaled-pixels-701">scaled pixels</a>: <a href="#pktype-invocation">pktype invocation</a></li>
+<li><a href="#index-scaling-of-fonts-664">scaling of fonts</a>: <a href="#Font-file-formats">Font file formats</a></li>
+<li><a href="#index-scanned-images-of-fonts-806">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-242">security, and <code>\openout</code></a>: <a href="#tex-invocation">tex invocation</a></li>
+<li><a href="#index-security_002c-and-output-files-246">security, and output files</a>: <a href="#tex-invocation">tex invocation</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-security_002c-and-_0040code_007bwrite_007d-520">security, and <code>write</code></a>: <a href="#mpost-invocation">mpost invocation</a></li>
+<li><a href="#index-shapes-370">shapes</a>: <a href="#Metafont">Metafont</a></li>
+<li><a href="#index-sharing-memory-dumps-188">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-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-siam_002ebst-579"><code>siam.bst</code></a>: <a href="#Basic-BibTeX-style-files">Basic BibTeX style files</a></li>
+<li><a href="#index-side-bearings-728">side bearings</a>: <a href="#gftype-invocation">gftype invocation</a></li>
+<li><a href="#index-side-bearings-711">side bearings</a>: <a href="#pktype-invocation">pktype invocation</a></li>
+<li><a href="#index-slant-font-473">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-small-Metafont-memory-and-modes-408">small Metafont memory and modes</a>: <a href="#Modes">Modes</a></li>
+<li><a href="#index-smode-_0040r_007band-dynamic-Metafont-mode-definition_007d-411"><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-579">Spiderweb</a>: <a href="#WEB">WEB</a></li>
+<li><a href="#index-space_002dterminated-filenames-218">space-terminated filenames</a>: <a href="#g_t_005cinput-filenames">\input filenames</a></li>
+<li><a href="#index-Spiderweb-584">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-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-starting-page-648">starting page</a>: <a href="#dvitype-invocation">dvitype invocation</a></li>
+<li><a href="#index-starting-page-632">starting page</a>: <a href="#dvicopy-invocation">dvicopy invocation</a></li>
+<li><a href="#index-Steele-Jr_002e_002c-Guy-L_002e-207">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-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-string-numbers_002c-displaying-618">string numbers, displaying</a>: <a href="#pooltype-invocation">pooltype invocation</a></li>
+<li><a href="#index-string-pool_002c-writing-595">string pool, writing</a>: <a href="#tangle-invocation">tangle invocation</a></li>
+<li><a href="#index-string-representation-621">string representation</a>: <a href="#pooltype-invocation">pooltype invocation</a></li>
+<li><a href="#index-style-design_002c-for-Bib_0040TeX_007b_007d-564">style design, for BibTeX</a>: <a href="#bibtex-invocation">bibtex invocation</a></li>
+<li><a href="#index-style-files-487">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-sun-430"><code>sun</code></a>: <a href="#Online-Metafont-graphics">Online Metafont graphics</a></li>
+<li><a href="#index-sun_002dgfx_002ec-434"><code>sun-gfx.c</code></a>: <a href="#Online-Metafont-graphics">Online Metafont graphics</a></li>
+<li><a href="#index-Suntools-432">Suntools</a>: <a href="#Online-Metafont-graphics">Online Metafont graphics</a></li>
+<li><a href="#index-SunView-431">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-swapping-bytes-200">swapping bytes</a>: <a href="#Hardware-and-memory-dumps">Hardware and memory dumps</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-Tachikawa_002c-Elizabeth-676">Tachikawa, Elizabeth</a>: <a href="#Font-file-formats">Font file formats</a></li>
+<li><a href="#index-tangle-590"><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-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-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-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-tek-435"><code>tek</code></a>: <a href="#Online-Metafont-graphics">Online Metafont graphics</a></li>
+<li><a href="#index-Tektronix-436">Tektronix</a>: <a href="#Online-Metafont-graphics">Online Metafont graphics</a></li>
+<li><a href="#index-Tektronix-4014-440">Tektronix 4014</a>: <a href="#Online-Metafont-graphics">Online Metafont graphics</a></li>
+<li><a href="#index-TERM-416"><code>TERM</code></a>: <a href="#Online-Metafont-graphics">Online Metafont graphics</a></li>
+<li><a href="#index-terminator-for-filenames-220">terminator for filenames</a>: <a href="#g_t_005cinput-filenames">\input filenames</a></li>
+<li><a href="#index-terse-output-557">terse output</a>: <a href="#bibtex-invocation">bibtex invocation</a></li>
+<li><a href="#index-tex-233"><code>tex</code></a>: <a href="#tex-invocation">tex invocation</a></li>
+<li><a href="#index-g_t_0040TeX_007b_007d_002c-bibliographies-for-570">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-480">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-608">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-228">TeX, description of</a>: <a href="#TeX">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-input-files-found-236">TeX, input files found</a>: <a href="#tex-invocation">tex invocation</a></li>
+<li><a href="#index-g_t_0040TeX_007b_007d_002c-invocation-234">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-159">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_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-TEXBIB_0040r_007b_002c-search-path-for-bib-files_007d-553"><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-211"><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-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-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-texmfmp_002ec-465"><code>texmfmp.c</code></a>: <a href="#Online-Metafont-graphics">Online Metafont graphics</a></li>
+<li><a href="#index-TEXMFOUTPUT_0040r_007b_002c-used-for-reading_007d-157"><code>TEXMFOUTPUT</code><span class="roman">, used for reading</span></a>: <a href="#Output-file-location">Output file location</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-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-texput-237"><code>texput</code></a>: <a href="#tex-invocation">tex invocation</a></li>
+<li><a href="#index-TFM-files_002c-converting-property-lists-to-769">TFM files, converting property lists to</a>: <a href="#pltotf-invocation">pltotf invocation</a></li>
+<li><a href="#index-TFM-files_002c-explained-663">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-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-469">title font</a>: <a href="#gftodvi-invocation">gftodvi invocation</a></li>
+<li><a href="#index-TFM-files_002c-output-by-Metafont-384">TFM files, output by Metafont</a>: <a href="#mf-invocation">mf invocation</a></li>
+<li><a href="#index-TFM-files_002c-output-by-MetaPost-506">TFM files, output by MetaPost</a>: <a href="#mpost-invocation">mpost invocation</a></li>
+<li><a href="#index-TFM-width-of-characters-739">TFM width of characters</a>: <a href="#gftype-invocation">gftype invocation</a></li>
+<li><a href="#index-TFM-width-of-characters-696">TFM width of characters</a>: <a href="#pktype-invocation">pktype invocation</a></li>
+<li><a href="#index-tftopl-742"><code>tftopl</code></a>: <a href="#tftopl-invocation">tftopl invocation</a></li>
+<li><a href="#index-three-programs-158">three programs</a>: <a href="#Three-programs">Three programs</a></li>
+<li><a href="#index-time-and-date_002c-in-memory-dumps-204">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-471">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>
@@ -4658,74 +4672,75 @@ Up:&nbsp;<a rel="up" accesskey="u" href="#Top">Top</a>
<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_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-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-Troff_002c-and-MetaPost-511">Troff, and MetaPost</a>: <a href="#mpost-invocation">mpost invocation</a></li>
+<li><a href="#index-Troff_002c-WEB-for-589">Troff, WEB for</a>: <a href="#WEB">WEB</a></li>
+<li><a href="#index-Trojan-horses-and-_0040TeX_007b_007d-programs-244">Trojan horses and TeX programs</a>: <a href="#tex-invocation">tex invocation</a></li>
+<li><a href="#index-TUGboat-bibliography-569">TUGboat bibliography</a>: <a href="#bibtex-invocation">bibtex invocation</a></li>
+<li><a href="#index-Type-1-conversion-803">Type 1 conversion</a>: <a href="#Font-utilities-available-elsewhere">Font utilities available elsewhere</a></li>
+<li><a href="#index-type-design_002c-personal-402">type design, personal</a>: <a href="#Initial-Metafont">Initial Metafont</a></li>
+<li><a href="#index-type-programs_002c-DVI-639">type programs, DVI</a>: <a href="#dvitype-invocation">dvitype invocation</a></li>
+<li><a href="#index-type-programs_002c-GF-720">type programs, GF</a>: <a href="#gftype-invocation">gftype invocation</a></li>
+<li><a href="#index-type-programs_002c-PK-689">type programs, PK</a>: <a href="#pktype-invocation">pktype invocation</a></li>
+<li><a href="#index-type-programs_002c-pool-617">type programs, pool</a>: <a href="#pooltype-invocation">pooltype invocation</a></li>
+<li><a href="#index-typeface-families-368">typeface families</a>: <a href="#Metafont">Metafont</a></li>
+<li><a href="#index-typeface-specimen-sheets-807">typeface specimen sheets</a>: <a href="#Font-utilities-available-elsewhere">Font utilities available elsewhere</a></li>
+<li><a href="#index-typesetting-229">typesetting</a>: <a href="#TeX">TeX</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-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-uniterm-439"><code>uniterm</code></a>: <a href="#Online-Metafont-graphics">Online Metafont graphics</a></li>
+<li><a href="#index-unsrt_002ebst-580"><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-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-validation_002c-of-DVI-files-640">validation, of DVI files</a>: <a href="#dvitype-invocation">dvitype invocation</a></li>
+<li><a href="#index-validation_002c-of-GF-files-721">validation, of GF files</a>: <a href="#gftype-invocation">gftype invocation</a></li>
+<li><a href="#index-validation_002c-of-PK-files-690">validation, of PK files</a>: <a href="#pktype-invocation">pktype invocation</a></li>
+<li><a href="#index-validation_002c-of-TFM-files-744">validation, of TFM files</a>: <a href="#tftopl-invocation">tftopl invocation</a></li>
+<li><a href="#index-validation_002c-of-VF-files-773">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-558">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-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-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-vertical-escapement-734">vertical escapement</a>: <a href="#gftype-invocation">gftype invocation</a></li>
+<li><a href="#index-VF-files_002c-converting-property-lists-to-780">VF files, converting property lists to</a>: <a href="#vptovf-invocation">vptovf invocation</a></li>
+<li><a href="#index-vftovp-771"><code>vftovp</code></a>: <a href="#vftovp-invocation">vftovp invocation</a></li>
+<li><a href="#index-virgin-programs-164">virgin programs</a>: <a href="#Initial-and-virgin">Initial and virgin</a></li>
+<li><a href="#index-virtual-font-creation-811">virtual font creation</a>: <a href="#Font-utilities-available-elsewhere">Font utilities available elsewhere</a></li>
+<li><a href="#index-virtual-fonts_002c-expanding-626">virtual fonts, expanding</a>: <a href="#dvicopy-invocation">dvicopy invocation</a></li>
+<li><a href="#index-virtual_002dfonts_002eknuth-673"><code>virtual-fonts.knuth</code></a>: <a href="#Font-file-formats">Font file formats</a></li>
+<li><a href="#index-virtualfonts_002etxt-674"><code>virtualfonts.txt</code></a>: <a href="#Font-file-formats">Font file formats</a></li>
+<li><a href="#index-vptovf-778"><code>vptovf</code></a>: <a href="#vptovf-invocation">vptovf invocation</a></li>
+<li><a href="#index-weave-607"><code>weave</code></a>: <a href="#weave-invocation">weave invocation</a></li>
+<li><a href="#index-WEB-581">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-WEB-pool-files_002c-displaying-619">WEB pool files, displaying</a>: <a href="#pooltype-invocation">pooltype invocation</a></li>
+<li><a href="#index-WEB-programs_002c-compiling-592">WEB programs, compiling</a>: <a href="#tangle-invocation">tangle invocation</a></li>
+<li><a href="#index-WEB-programs_002c-typesetting-609">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-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-webmac_002etex-615"><code>webmac.tex</code></a>: <a href="#weave-invocation">weave invocation</a></li>
+<li><a href="#index-webman_002etex-583"><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-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-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-whitespace_002dterminated-filenames-219">whitespace-terminated filenames</a>: <a href="#g_t_005cinput-filenames">\input filenames</a></li>
+<li><a href="#index-width_002c-device_002dindependent-741">width, device-independent</a>: <a href="#gftype-invocation">gftype invocation</a></li>
+<li><a href="#index-width_002c-device_002dindependent-698">width, device-independent</a>: <a href="#pktype-invocation">pktype invocation</a></li>
+<li><a href="#index-width_002c-in-pixels-706">width, in pixels</a>: <a href="#pktype-invocation">pktype invocation</a></li>
+<li><a href="#index-word-processor_002c-not-232">word processor, not</a>: <a href="#TeX">TeX</a></li>
+<li><a href="#index-writing-memory-dumps-174">writing memory dumps</a>: <a href="#Creating-memory-dumps">Creating memory dumps</a></li>
+<li><a href="#index-X-bitmap-fonts-786">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-455">X class name for Metafont</a>: <a href="#Online-Metafont-graphics">Online Metafont graphics</a></li>
+<li><a href="#index-x-offset-707">x offset</a>: <a href="#pktype-invocation">pktype invocation</a></li>
+<li><a href="#index-X-resources-454">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-xampl_002ebib-566"><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-791"><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-Xe_0040TeX_007b_007d-365">XeTeX</a>: <a href="#TeX-extensions">TeX extensions</a></li>
+<li><a href="#index-xfed_0040r_007b_002c-bitmap-font-editor_007d-792"><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-793"><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-444"><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-443"><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>
+<li><a href="#index-xterm-445"><code>xterm</code></a>: <a href="#Online-Metafont-graphics">Online Metafont graphics</a></li>
+<li><a href="#index-y-offset-708">y offset</a>: <a href="#pktype-invocation">pktype invocation</a></li>
+<li><a href="#index-g_t_007e-_0040r_007bexpansion-in-filenames_007d-225"><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 8c309fef591..100e982d94e 100644
--- a/Master/texmf/doc/web2c/web2c.pdf
+++ b/Master/texmf/doc/web2c/web2c.pdf
Binary files differ