summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/dvips
diff options
context:
space:
mode:
authorKarl Berry <karl@freefriends.org>2016-04-26 16:52:45 +0000
committerKarl Berry <karl@freefriends.org>2016-04-26 16:52:45 +0000
commit7df10419479604eddc4a871f949c1166a32934f5 (patch)
tree67e7c0c7359e27bb8962c2a0d05bc3d24d36011a /Master/texmf-dist/doc/dvips
parentdd1d5f2e87df4dddeba293c2f8d579129162901a (diff)
-mtl16 update of (tex)info files, with new latex2e-fr
git-svn-id: svn://tug.org/texlive/trunk@40765 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/doc/dvips')
-rw-r--r--Master/texmf-dist/doc/dvips/dvips.html144
-rw-r--r--Master/texmf-dist/doc/dvips/dvips.pdfbin403454 -> 404161 bytes
2 files changed, 81 insertions, 63 deletions
diff --git a/Master/texmf-dist/doc/dvips/dvips.html b/Master/texmf-dist/doc/dvips/dvips.html
index 5ff67700e09..9ee7e75896a 100644
--- a/Master/texmf-dist/doc/dvips/dvips.html
+++ b/Master/texmf-dist/doc/dvips/dvips.html
@@ -1,9 +1,9 @@
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<html>
-<!-- This manual documents Dvips version 5.995
-(April 2015), a program to translate a DVI file into
+<!-- This manual documents Dvips version 5.996
+(April 2016), a program to translate a DVI file into
PostScript. You may freely use, modify and/or distribute this file. -->
-<!-- Created by GNU Texinfo 5.2, http://www.gnu.org/software/texinfo/ -->
+<!-- Created by GNU Texinfo 6.1, http://www.gnu.org/software/texinfo/ -->
<head>
<title>Dvips: A DVI-to-PostScript translator</title>
@@ -20,16 +20,16 @@ PostScript. You may freely use, modify and/or distribute this file. -->
<style type="text/css">
<!--
a.summary-letter {text-decoration: none}
+blockquote.indentedblock {margin-right: 0em}
+blockquote.smallindentedblock {margin-right: 0em; font-size: smaller}
blockquote.smallquotation {font-size: smaller}
div.display {margin-left: 3.2em}
div.example {margin-left: 3.2em}
-div.indentedblock {margin-left: 3.2em}
div.lisp {margin-left: 3.2em}
div.smalldisplay {margin-left: 3.2em}
div.smallexample {margin-left: 3.2em}
-div.smallindentedblock {margin-left: 3.2em; font-size: smaller}
div.smalllisp {margin-left: 3.2em}
-kbd {font-style:oblique}
+kbd {font-style: oblique}
pre.display {font-family: inherit}
pre.format {font-family: inherit}
pre.menu-comment {font-family: serif}
@@ -38,10 +38,9 @@ pre.smalldisplay {font-family: inherit; font-size: smaller}
pre.smallexample {font-size: smaller}
pre.smallformat {font-family: inherit; font-size: smaller}
pre.smalllisp {font-size: smaller}
-span.nocodebreak {white-space:nowrap}
-span.nolinebreak {white-space:nowrap}
-span.roman {font-family:serif; font-weight:normal}
-span.sansserif {font-family:sans-serif; font-weight:normal}
+span.nolinebreak {white-space: nowrap}
+span.roman {font-family: initial; font-weight: normal}
+span.sansserif {font-family: sans-serif; font-weight: normal}
ul.no-bullet {list-style: none}
-->
</style>
@@ -49,7 +48,7 @@ ul.no-bullet {list-style: none}
</head>
-<body lang="en" bgcolor="#FFFFFF" text="#000000" link="#0000FF" vlink="#800080" alink="#FF0000">
+<body lang="en">
<h1 class="settitle" align="center">Dvips: A DVI-to-PostScript translator</h1>
@@ -205,8 +204,8 @@ Next: <a href="#Why-Dvips" accesskey="n" rel="next">Why Dvips</a>, Up: <a href="
<a name="Dvips"></a>
<h1 class="top">Dvips</h1>
-<p>This manual documents Dvips version 5.995
-(April 2015), a program to translate a DVI file into
+<p>This manual documents Dvips version 5.996
+(April 2016), a program to translate a DVI file into
PostScript. You may freely use, modify and/or distribute this file.
</p>
@@ -314,10 +313,10 @@ Next: <a href="#Invoking-Dvips" accesskey="n" rel="next">Invoking Dvips</a>, Pre
<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> in <cite>Kpathsea</cite>.
+see <a href="http://tug.org/texinfohtml/kpathsea.html#Installation">Installation</a> in <cite>Kpathsea</cite>.
</p>
<p>For solutions to common installation problems and information on how to
-report a bug, see the file <samp>kpathsea/BUGS</samp> (see <a href="kpathsea.html#Bugs">Bugs</a> in <cite>Kpathsea</cite>). For solutions to Dvips-specific problems,
+report a bug, see the file <samp>kpathsea/BUGS</samp> (see <a href="http://tug.org/texinfohtml/kpathsea.html#Bugs">Bugs</a> in <cite>Kpathsea</cite>). For solutions to Dvips-specific problems,
see <a href="#Debug-options">Debug options</a>. Also see the Dvips home page at
<a href="http://www.radicaleye.com/dvips">http://www.radicaleye.com/dvips</a>.
</p>
@@ -357,7 +356,7 @@ printer (output device). Since these are site-specific, <code>make
install</code> does not create them; you must create them yourself.
</p>
<p>(These Dvips configuration files are independent of the Kpathsea
-configuration file <samp>texmf.cnf</samp> (see <a href="kpathsea.html#Config-files">Config files</a> in <cite>Kpathsea</cite>).
+configuration file <samp>texmf.cnf</samp> (see <a href="http://tug.org/texinfohtml/kpathsea.html#Config-files">Config files</a> in <cite>Kpathsea</cite>).
</p>
<a name="index-config_002eproto"></a>
<a name="index-prototype-printer-configuration-file"></a>
@@ -511,7 +510,7 @@ work. The following sections provide some helpful hints if you find
yourself in such a situation.
</p>
<p>For details on effective bug reporting, common installation problems,
-and <code>mktexpk</code> problems, see <a href="kpathsea.html#Bugs">Bugs</a> in <cite>Kpathsea</cite>.
+and <code>mktexpk</code> problems, see <a href="http://tug.org/texinfohtml/kpathsea.html#Bugs">Bugs</a> in <cite>Kpathsea</cite>.
</p>
<p>A good first debugging operation is to set the environment variable
<code>DVIPSDEBUG</code>, which will display any configuration and map files
@@ -555,7 +554,7 @@ To track all classes, you can use <code>-1</code>.
</p>
<p>You can also set the environment variable <code>KPATHSEA_DEBUG</code> instead
of using &lsquo;<samp>-d</samp>&rsquo;. Some of these debugging options are actually
-provided by Kpathsea (see <a href="kpathsea.html#Debugging">Debugging</a> in <cite>Kpathsea</cite>).
+provided by Kpathsea (see <a href="http://tug.org/texinfohtml/kpathsea.html#Debugging">Debugging</a> in <cite>Kpathsea</cite>).
</p>
<p>The classes are:
</p>
@@ -822,7 +821,7 @@ progress reports appear by default. The next time that document is
printed, these fonts will have been saved in the proper directories, so
printing will go much faster. (If Dvips tries to endlessly generate the
same fonts over and over again, it hasn&rsquo;t been installed properly.
-See <a href="kpathsea.html#Unable-to-generate-fonts">Unable to generate fonts</a> in <cite>Kpathsea</cite>.)
+See <a href="http://tug.org/texinfohtml/kpathsea.html#Unable-to-generate-fonts">Unable to generate fonts</a> in <cite>Kpathsea</cite>.)
</p>
<p>Many options are available (see the next section). For a brief summary
of available options, just type
@@ -1190,8 +1189,8 @@ no matter what the pages are actually numbered.
generation. This overrides any value from configuration files. With
the default paths, explicitly specifying the mode also makes the program
assume the fonts are in a subdirectory named <var>mode</var>.
-See <a href="kpathsea.html#TeX-directory-structure">TeX directory structure</a> in <cite>Kpathsea</cite>. If Metafont does not understand the <var>mode</var> name, see
-<a href="kpathsea.html#Unable-to-generate-fonts">Unable to generate fonts</a> in <cite>Kpathsea</cite>.
+See <a href="http://tug.org/texinfohtml/kpathsea.html#TeX-directory-structure">TeX directory structure</a> in <cite>Kpathsea</cite>. If Metafont does not understand the <var>mode</var> name, see
+<a href="http://tug.org/texinfohtml/kpathsea.html#Unable-to-generate-fonts">Unable to generate fonts</a> in <cite>Kpathsea</cite>.
</p>
</dd>
<dt>&lsquo;<samp>-M*</samp>&rsquo;</dt>
@@ -1259,7 +1258,7 @@ 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>-noptex</samp>&rsquo;, or both by using &lsquo;<samp>-noomega</samp>&rsquo;
(but please do send a bug report if you find such problems,
-see <a href="kpathsea.html#Bugs">Bugs</a> in <cite>Kpathsea</cite>).
+see <a href="http://tug.org/texinfohtml/kpathsea.html#Bugs">Bugs</a> in <cite>Kpathsea</cite>).
</p>
</dd>
<dt>&lsquo;<samp>-o <var>name</var></samp>&rsquo;</dt>
@@ -1561,7 +1560,7 @@ configuration files are read, so they override values in the
configuration files. (Except for <code>TEXCONFIG</code>, which defines where
the configuration files themselves are found.)
</p>
-<p>See <a href="kpathsea.html#Path-specifications">Path specifications</a> in <cite>Kpathsea</cite>, for details of
+<p>See <a href="http://tug.org/texinfohtml/kpathsea.html#Path-specifications">Path specifications</a> in <cite>Kpathsea</cite>, for details of
interpretation of path and other environment variables common to all
Kpathsea-using programs. Only the environment variables specific to
Dvips are mentioned here.
@@ -1576,7 +1575,7 @@ standard output, for debugging. This isn&rsquo;t done by default because
these files are read even before the banner is printed. For
voluminous additional debugging, set the environment variable
<code>KPATHSEA_DEBUG</code> to &lsquo;<samp>-1</samp>&rsquo;
-(see <a href="kpathsea.html#Debugging">Debugging</a> in <cite>Kpathsea</cite>). (If <code>KPATHSEA_DEBUG</code> is
+(see <a href="http://tug.org/texinfohtml/kpathsea.html#Debugging">Debugging</a> in <cite>Kpathsea</cite>). (If <code>KPATHSEA_DEBUG</code> is
set to any value, it automatically turns on <code>DVIPSDEBUG</code>.)
</p>
</dd>
@@ -1584,7 +1583,7 @@ set to any value, it automatically turns on <code>DVIPSDEBUG</code>.)
<a name="index-DVIPSFONTS"></a>
</dt>
<dd><p>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
+config file options and other environment variables (see <a href="http://tug.org/texinfohtml/kpathsea.html#Supported-file-formats">Supported
file formats</a> in <cite>Kpathsea</cite>).
</p>
</dd>
@@ -1602,7 +1601,7 @@ config file option (see <a href="#Configuration-file-commands">Configuration fil
<p>Overrides &lsquo;<samp>mktexpk</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> in <cite>Kpathsea</cite>.
+variable; see <a href="http://tug.org/texinfohtml/kpathsea.html#MakeTeX-script-arguments">MakeTeX script arguments</a> in <cite>Kpathsea</cite>.
</p>
</dd>
<dt><code>DVIPSRC</code>
@@ -1644,7 +1643,7 @@ platforms.)
</dt>
<dd><p>Path to search for included graphics files. Overrides the &lsquo;<samp>S</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> in <cite>Kpathsea</cite>.
+<code>TEXINPUTS</code> is looked for. See <a href="http://tug.org/texinfohtml/kpathsea.html#Supported-file-formats">Supported file formats</a> in <cite>Kpathsea</cite>.
</p>
</dd>
</dl>
@@ -1665,7 +1664,7 @@ Previous: <a href="#Environment-variables" accesskey="p" rel="prev">Environment
device configuration files (called <samp>*.cfg</samp> on MS-DOS), which
override the <samp>texmf.cnf</samp>
configuration files generic to Kpathsea which Dvips also reads
-(see <a href="kpathsea.html#Config-files">Config files</a> in <cite>Kpathsea</cite>).
+(see <a href="http://tug.org/texinfohtml/kpathsea.html#Config-files">Config files</a> in <cite>Kpathsea</cite>).
</p>
<p>For information about installing these files, including a prototype file
you can copy, see <a href="#config_002eps-installation">config.ps installation</a>.
@@ -1698,7 +1697,7 @@ or individually by each user.
<li> <a name="index-config_002eps_002c-searched-for"></a>
Dvips first reads (if it exists) <samp>config.ps</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> in <cite>Kpathsea</cite>.
+<a href="http://tug.org/texinfohtml/kpathsea.html#Supported-file-formats">Supported file formats</a> in <cite>Kpathsea</cite>.
</li><li> <a name="index-_002edvipsrc_002c-searched-for"></a>
A user-specific startup file is loaded, so individual users can override
@@ -1710,7 +1709,7 @@ the name <samp>$HOME/.dvipsrc</samp>, which is in the user&rsquo;s home director
On MS-DOS and MS-Windows, where users generally don&rsquo;t have their private
directories, the startup file is called <samp>dvips.ini</samp> and 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> in <cite>Kpathsea</cite>.); users are
+in <a href="http://tug.org/texinfohtml/kpathsea.html#Supported-file-formats">Supported file formats</a> in <cite>Kpathsea</cite>.); users are
expected to set this path as they see fit for their taste.
</li><li> <a name="index-_002dPprinter_002c-and-config-file-searching"></a>
@@ -1964,7 +1963,7 @@ global map file. This can be used for font families.
<a name="index-TEXFONTS_002c-overrides-P"></a>
<p>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> in <cite>Kpathsea</cite>.
+environment variables override this. See <a href="http://tug.org/texinfohtml/kpathsea.html#Supported-file-formats">Supported file formats</a> in <cite>Kpathsea</cite>.
</p>
</dd>
<dt>&lsquo;<samp>q*</samp>&rsquo;</dt>
@@ -2601,8 +2600,8 @@ TeX, add a line like this near the top of your input file:
<pre class="example">\input epsf
</pre></div>
-<a name="index-epsf_002esty"></a>
-<p>If you are using LaTeX 2.09, add the &lsquo;<samp>epsf</samp>&rsquo; style option, as in:
+<p><a name="index-epsf_002esty"></a>
+If you are using LaTeX 2.09, add the &lsquo;<samp>epsf</samp>&rsquo; style option, as in:
</p>
<div class="example">
<pre class="example">\documentstyle[12pt,epsf]{article}
@@ -2956,8 +2955,8 @@ file to standard output. For example:
<pre class="example">\special{psfile=&quot;`gnuplot foo&quot;}
</pre></div>
-<a name="index-gnuplot"></a>
-<p>to include the file <samp>foo</samp>. Of course, the command to be executed
+<p><a name="index-gnuplot"></a>
+to include the file <samp>foo</samp>. Of course, the command to be executed
can be anything, including using a file conversion utility such as
<samp>tek2ps</samp> or whatever is appropriate. This feature can be disabled
with the &lsquo;<samp>-R</samp>&rsquo; command-line option or &lsquo;<samp>R</samp>&rsquo; configuration option.
@@ -3023,7 +3022,7 @@ treated as a bitmap. For example, if your figure used the single letter
</dl>
<p>MetaPost&rsquo;s output figures contain lines like this for bitmap fonts used
-in a MetaPost label (see <a href="web2c.html#MetaPost">MetaPost</a> in <cite>Web2c</cite>).
+in a MetaPost label (see <a href="http://tug.org/texinfohtml/web2c.html#MetaPost">MetaPost</a> in <cite>Web2c</cite>).
</p>
<hr>
@@ -3314,8 +3313,8 @@ PostScript comments, for example.
<pre class="example">\special{ps: plotfile <var>filename</var>}
</pre></div>
-<a name="index-rotate_002etex"></a>
-<p>inserts the contents of <var>filename</var> verbatim into the output (except
+<p><a name="index-rotate_002etex"></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>rotate.tex</samp>, which makes
it easy to typeset text turned in multiples of 90 degrees.
@@ -3485,7 +3484,7 @@ are supported; Ghostscript includes limited distiller support
</p>
<p>Macros you can use in your TeX document to insert the specials in the
first place are available from <samp><var>CTAN:</var>/support/hypertex</samp>. For
-CTAN info, see <a href="kpathsea.html#unixtex_002eftp">unixtex.ftp</a> in <cite>Kpathsea</cite>.
+CTAN info, see <a href="http://tug.org/texinfohtml/kpathsea.html#unixtex_002eftp">unixtex.ftp</a> in <cite>Kpathsea</cite>.
</p>
<a name="index-http_003a_002f_002fwww_002ewin_002etue_002enl_002f_007edickie_002fidvi"></a>
<a name="index-http_003a_002f_002fxxx_002elanl_002egov_002fhypertex"></a>
@@ -3570,7 +3569,7 @@ package (e.g., <code>tetex-extra</code> in Debian). Failing that,
commercial versions of the Computer Modern fonts are available from
Blue Sky; public domain versions - in particular, the lm fonts, and
the cm-super fonts, are available from CTAN sites (for CTAN info,
-see <a href="kpathsea.html#unixtex_002eftp">unixtex.ftp</a> in <cite>Kpathsea</cite>).
+see <a href="http://tug.org/texinfohtml/kpathsea.html#unixtex_002eftp">unixtex.ftp</a> in <cite>Kpathsea</cite>).
</p>
<p>You can convert a PostScript file to PDF using <code>distill</code>, which
comes with Adobe Acrobat, or <code>ps2pdf</code>, which comes with
@@ -3837,7 +3836,7 @@ can get AFM files for Adobe&rsquo;s fonts from
TeX uses <em>TeX font metrics</em> (&lsquo;<samp>.tfm</samp>&rsquo;) files. When you say
&lsquo;<samp>\font = <var>font</var></samp>&rsquo; in your TeX document, TeX reads a file
named &lsquo;<samp><var>font</var>.tfm</samp>&rsquo;. (Well, except for the <samp>texfonts.map</samp>
-feature; see <a href="kpathsea.html#Fontmap">Fontmap</a> in <cite>Kpathsea</cite>). TeX can then
+feature; see <a href="http://tug.org/texinfohtml/kpathsea.html#Fontmap">Fontmap</a> in <cite>Kpathsea</cite>). TeX can then
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.
@@ -3847,11 +3846,11 @@ DVI file produced by TeX may need to look at the TFM file.
<a name="index-pltotf"></a>
<a name="index-_002epl-property-list-files"></a>
<p>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
+files). You can use the <code>tftopl</code> program (see <a href="http://tug.org/texinfohtml/web2c.html#tftopl-invocation">tftopl
invocation</a> in <cite>Web2c</cite>) that comes with TeX to transform a TFM
file into a human-readable &ldquo;property list&rdquo; (&lsquo;<samp>.pl</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> in <cite>Web2c</cite>). Editing metrics by hand is not something you&rsquo;re likely to want
+the companion program <code>pltotf</code> (see <a href="http://tug.org/texinfohtml/web2c.html#pltotf-invocation">pltotf invocation</a> in <cite>Web2c</cite>). Editing metrics by hand is not something you&rsquo;re likely to want
to do often, but the capability is there.
</p>
</li><li> <a name="index-pfm-files"></a>
@@ -3957,7 +3956,7 @@ isn&rsquo;t a reference manual on virtual fonts. For more information: The
primary document on virtual fonts is Donald E. Knuth, <cite>TUGboat</cite>
11(1), Apr. 1990, pp. 13&ndash;23, &ldquo;Virtual Fonts: More Fun for Grand
Wizards&rdquo; (<samp><var>CTAN:</var>/info/virtual-fonts.knuth</samp>; for CTAN info,
-see <a href="kpathsea.html#unixtex_002eftp">unixtex.ftp</a> in <cite>Kpathsea</cite>). (Don&rsquo;t be intimidated by
+see <a href="http://tug.org/texinfohtml/kpathsea.html#unixtex_002eftp">unixtex.ftp</a> in <cite>Kpathsea</cite>). (Don&rsquo;t be intimidated by
the subtitle.)
</p>
<a name="index-vf-files"></a>
@@ -3966,8 +3965,8 @@ the subtitle.)
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> in <cite>Web2c</cite>, and <a href="web2c.html#vptovf-invocation">vptovf invocation</a> in <cite>Web2c</cite>.
+(virtual property list) format and back again. See <a href="http://tug.org/texinfohtml/web2c.html#vftovp-invocation">vftovp
+invocation</a> in <cite>Web2c</cite>, and <a href="http://tug.org/texinfohtml/web2c.html#vptovf-invocation">vptovf invocation</a> in <cite>Web2c</cite>.
</p>
<a name="index-base-fonts"></a>
<p>In the case of a PostScript font <var>f</var> being used in a straightforward
@@ -3984,7 +3983,7 @@ created when you run <code>vptovf</code>.
<a name="index-expansion_002c-of-virtual-fonts"></a>
<a name="index-virtual-font-expansion"></a>
<p>You can <em>expand</em> virtual fonts into their base fonts with DVIcopy
-(see <a href="web2c.html#dvicopy-invocation">dvicopy invocation</a> in <cite>Web2c</cite>). This is useful if you are
+(see <a href="http://tug.org/texinfohtml/web2c.html#dvicopy-invocation">dvicopy invocation</a> in <cite>Web2c</cite>). This is useful if you are
using a DVI translator that doesn&rsquo;t understand vf&rsquo;s itself.
</p>
@@ -4303,10 +4302,11 @@ can also obtain special effects such as an oblique font.
<a name="index-fontinst"></a>
<a name="index-virtual-fonts_002c-creating"></a>
<a name="index-Jeffrey_002c-Alan"></a>
-<p>An alternative to Afm2tfm for creating virtual fonts is Alan Jeffrey&rsquo;s
-<code>fontinst</code> program, available from
-<samp><var>CTAN:</var>fonts/utilities/fontinst</samp> (for CTAN info,
-see <a href="kpathsea.html#unixtex_002eftp">unixtex.ftp</a> in <cite>Kpathsea</cite>).
+<p>Alternatives to Afm2tfm for creating virtual fonts include
+<code>fontinst</code> <a href="http://ctan.org/pkg/fontinst">http://ctan.org/pkg/fontinst</a>,
+<code>lcdf-typetools</code>, particularly <code>otftotfm</code>
+(<a href="http://ctan.org/pkg/lcdf-typetools">http://ctan.org/pkg/lcdf-typetools</a>), and <code>afm2p</code>
+(<a href="http://tex.aanhet.net/afm2pl/">http://tex.aanhet.net/afm2pl/</a>), among others.
</p>
<table class="menu" border="0" cellspacing="0">
<tr><td align="left" valign="top">&bull; <a href="#Changing-font-encodings" accesskey="1">Changing font encodings</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">Reencoding with -t, -p, -T.
@@ -4687,8 +4687,8 @@ put the line
<pre class="example">rptmro Times-Roman &quot;.167 SlantFont&quot;
</pre></div>
-<a name="index-psfonts_002emap-1"></a>
-<p>into <samp>psfonts.map</samp>. Then &lsquo;<samp>rptmro</samp>&rsquo; (our name for the obliqued
+<p><a name="index-psfonts_002emap-1"></a>
+into <samp>psfonts.map</samp>. Then &lsquo;<samp>rptmro</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).
@@ -4769,9 +4769,10 @@ Previous: <a href="#Special-font-effects" accesskey="p" rel="prev">Special font
<pre class="example">afm2tfm [<var>option</var>]&hellip; <var>afmfile</var>[.afm] [<var>tfmfile</var>[.tfm]]
</pre></div>
-<p>Afm2tfm reads <var>afmfile</var> and writes a corresponding (but raw) TFM
-file. If <var>tfmfile</var> is not supplied, the base name of the AFM file is
-extended with &lsquo;<samp>.tfm</samp>&rsquo; to get the output filename.
+<p>Afm2tfm reads <var>afmfile</var> and writes a corresponding (but &ldquo;raw&rdquo;,
+see below) TFM file. If <var>tfmfile</var> is not supplied, the base name
+of the AFM file is extended with &lsquo;<samp>.tfm</samp>&rsquo; to get the output
+filename.
</p>
<p>The simplest example:
</p>
@@ -4780,14 +4781,15 @@ extended with &lsquo;<samp>.tfm</samp>&rsquo; to get the output filename.
</pre></div>
<a name="index-accents_002c-wrong"></a>
+<a name="index-raw-tfm-files"></a>
<p>The TFM file thus created is <em>raw</em> 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
+kern information, and does no character remapping; it contains only
+the character information in the AFM file in TFM format, which is the form
that TeX understands. The characters have the same code in the TFM
file as in the AFM file. For text fonts, this means printable ASCII
characters will work ok, but little else, because standard PostScript
fonts have a different encoding scheme than the one that plain TeX
-expects (see <a href="#Encodings">Encodings</a>). Although both schemes agree for the
+expects (see <a href="#Encodings">Encodings</a>). Although the encodings agree for most
printable ASCII characters, other characters such as ligatures and
accents vary. Thus, in practice, it&rsquo;s almost always desirable to create
a virtual font as well with the &lsquo;<samp>-v</samp>&rsquo; or &lsquo;<samp>-V</samp>&rsquo; option.
@@ -4796,6 +4798,19 @@ See <a href="#Making-a-font-available">Making a font available</a>.
<p>The command line options to Afm2tfm:
</p>
<dl compact="compact">
+<dt>&lsquo;<samp>-a</samp>&rsquo;</dt>
+<dd><a name="index-_002da-1"></a>
+<a name="index-accent-height-adjustment_002c-omitting"></a>
+<p>By default, Afm2tfm looks for precomposed accented characters, such as
+tdieresis, and possibly adjusts the height of the basic letter (t)
+upward so that the result of using <code>\accent</code> (as in <code>\&quot;t</code>)
+is visually the same as the precomposed characters. The <code>-a</code>
+option omits such adjustments, so that all characters&rsquo; heights remain
+as they are given in the AFM file. (Until Afm2tfm 8.4, released in
+2016, heights could also be adjusted downward, but this is no longer
+the case.)
+</p>
+</dd>
<dt>&lsquo;<samp>-c <var>ratio</var></samp>&rsquo;</dt>
<dd><a name="index-_002dc-ratio"></a>
<a name="index-scaling-small-caps"></a>
@@ -5114,8 +5129,8 @@ example:
\Blue{nesting blue}, recovering the red} and back to original.
</pre></div>
-<a name="index-color-nesting-level"></a>
-<p>The color nesting level has no hard limit, but it is not advisable to
+<p><a name="index-color-nesting-level"></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>
<p>The global color command has the form
@@ -5124,8 +5139,8 @@ nest too deeply lest you and the reader lose track of the color history.
<pre class="example">\text<var>ColorName</var>
</pre></div>
-<a name="index-_005ctextColorName"></a>
-<p>These macros take no arguments and changes the default color from that
+<p><a name="index-_005ctextColorName"></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
@@ -5563,6 +5578,7 @@ Previous: <a href="#Color" accesskey="p" rel="prev">Color</a>, Up: <a href="#Top
<tr><td></td><td valign="top"><a href="#index-_002d_002dversion"><code>--version</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Option-details">Option details</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-_002da"><code>-a</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Option-details">Option details</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-_002dA"><code>-A</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Option-details">Option details</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-_002da-1"><code>-a</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Afm2tfm-options">Afm2tfm options</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-_002dB"><code>-B</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Option-details">Option details</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-_002db-num"><code>-b <var>num</var></code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Option-details">Option details</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-_002dc-num"><code>-c <var>num</var></code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Option-details">Option details</a></td></tr>
@@ -5697,6 +5713,7 @@ Previous: <a href="#Color" accesskey="p" rel="prev">Color</a>, Up: <a href="#Top
<tr><td></td><td valign="top"><a href="#index-absolute-filenames_002c-disabling">absolute filenames, disabling</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Option-details">Option details</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-absolute-page-number_002c-and-_002dl">absolute page number, and &lsquo;<samp>-l</samp>&rsquo;</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Option-details">Option details</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-absolute-page-number_002c-and-_002dp">absolute page number, and &lsquo;<samp>-p</samp>&rsquo;</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Option-details">Option details</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-accent-height-adjustment_002c-omitting">accent height adjustment, omitting</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Afm2tfm-options">Afm2tfm options</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-accents_002c-in-wrong-position">accents, in wrong position</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Reencoding-with-Afm2tfm">Reencoding with Afm2tfm</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-accents_002c-wrong">accents, wrong</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Afm2tfm-options">Afm2tfm options</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-accuracy-in-positioning">accuracy in positioning</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Option-details">Option details</a></td></tr>
@@ -6147,6 +6164,7 @@ Previous: <a href="#Color" accesskey="p" rel="prev">Color</a>, Up: <a href="#Top
<tr><th><a name="Index_cp_letter-R">R</a></th><td></td><td></td></tr>
<tr><td></td><td valign="top"><a href="#index-r-config-command-_0028page-reversal_0029"><code>r <span class="roman">config command (page reversal)</span></code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Configuration-file-commands">Configuration file commands</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-R-fallback-resolution-config-command"><code>R <span class="roman">fallback resolution config command</span></code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Configuration-file-commands">Configuration file commands</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-raw-tfm-files">raw tfm files</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Afm2tfm-options">Afm2tfm options</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-reencode_002f_002a_002eenc"><code>reencode/*.enc</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Encodings">Encodings</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-reencoding">reencoding</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Reencoding-with-Afm2tfm">Reencoding with Afm2tfm</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-reencoding-PostScript-fonts">reencoding PostScript fonts</a>:</td><td>&nbsp;</td><td valign="top"><a href="#psfonts_002emap">psfonts.map</a></td></tr>
diff --git a/Master/texmf-dist/doc/dvips/dvips.pdf b/Master/texmf-dist/doc/dvips/dvips.pdf
index 0312e5aedf8..2ec950f0e02 100644
--- a/Master/texmf-dist/doc/dvips/dvips.pdf
+++ b/Master/texmf-dist/doc/dvips/dvips.pdf
Binary files differ