diff options
author | Karl Berry <karl@freefriends.org> | 2022-03-04 16:00:29 +0000 |
---|---|---|
committer | Karl Berry <karl@freefriends.org> | 2022-03-04 16:00:29 +0000 |
commit | 5027858830867ff20c7eca53eed6f8b798c5ad9c (patch) | |
tree | 842f07fed6d88920a1bcdc035157bb20e17e7904 /Master/texmf-dist/doc/dvips | |
parent | f23f3a09677e44ad094dcf2aa3ac0c3dc3893238 (diff) |
2022 doc (+sync) update
git-svn-id: svn://tug.org/texlive/trunk@62387 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/doc/dvips')
-rw-r--r-- | Master/texmf-dist/doc/dvips/dvips.html | 1676 | ||||
-rw-r--r-- | Master/texmf-dist/doc/dvips/dvips.pdf | bin | 412464 -> 417101 bytes |
2 files changed, 827 insertions, 849 deletions
diff --git a/Master/texmf-dist/doc/dvips/dvips.html b/Master/texmf-dist/doc/dvips/dvips.html index da5842dfc30..30e59aef42e 100644 --- a/Master/texmf-dist/doc/dvips/dvips.html +++ b/Master/texmf-dist/doc/dvips/dvips.html @@ -1,11 +1,11 @@ <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd"> <html> -<!-- This manual documents Dvips version 2021.1 -(February 2021), a program to translate a DVI file into -PostScript. You may freely use, modify and/or distribute this file. --> -<!-- Created by GNU Texinfo 6.7, http://www.gnu.org/software/texinfo/ --> +<!-- Created by GNU Texinfo 6.8, https://www.gnu.org/software/texinfo/ --> <head> <meta http-equiv="Content-Type" content="text/html; charset=utf-8"> +<!-- This manual documents Dvips version 2022.1 +(January 2022), a program to translate a DVI file into +PostScript. You may freely use, modify and/or distribute this file. --> <title>Dvips: A DVI-to-PostScript translator</title> <meta name="description" content="Dvips: A DVI-to-PostScript translator"> @@ -13,17 +13,20 @@ PostScript. You may freely use, modify and/or distribute this file. --> <meta name="resource-type" content="document"> <meta name="distribution" content="global"> <meta name="Generator" content="makeinfo"> +<meta name="viewport" content="width=device-width,initial-scale=1"> + <link href="#Top" rel="start" title="Top"> <link href="#Index" rel="index" title="Index"> <link href="#SEC_Contents" rel="contents" title="Table of Contents"> <link href="http://tug.org/texinfohtml" rel="up" title="(dir)"> +<link href="#Why-Dvips" rel="next" title="Why Dvips"> <style type="text/css"> <!-- +a.copiable-anchor {visibility: hidden; text-decoration: none; line-height: 0em} a.summary-letter {text-decoration: none} blockquote.indentedblock {margin-right: 0em} div.display {margin-left: 3.2em} div.example {margin-left: 3.2em} -div.lisp {margin-left: 3.2em} kbd {font-style: oblique} pre.display {font-family: inherit} pre.format {font-family: inherit} @@ -32,6 +35,7 @@ pre.menu-preformatted {font-family: serif} span.nolinebreak {white-space: nowrap} span.roman {font-family: initial; font-weight: normal} span.sansserif {font-family: sans-serif; font-weight: normal} +span:hover a.copiable-anchor {visibility: visible} ul.no-bullet {list-style: none} --> </style> @@ -48,23 +52,21 @@ ul.no-bullet {list-style: none} -<span id="SEC_Overview"></span> -<h2 class="shortcontents-heading">Short Table of Contents</h2> -<div class="shortcontents"> -<ul class="no-bullet"> -<li><a id="stoc-Why-use-Dvips_003f" href="#toc-Why-use-Dvips_003f">1 Why use Dvips?</a></li> -<li><a id="stoc-Installation-1" href="#toc-Installation-1">2 Installation</a></li> -<li><a id="stoc-Invoking-Dvips-1" href="#toc-Invoking-Dvips-1">3 Invoking Dvips</a></li> -<li><a id="stoc-Paper-size-and-landscape-orientation" href="#toc-Paper-size-and-landscape-orientation">4 Paper size and landscape orientation</a></li> -<li><a id="stoc-Interaction-with-PostScript-1" href="#toc-Interaction-with-PostScript-1">5 Interaction with PostScript</a></li> -<li><a id="stoc-PostScript-fonts-1" href="#toc-PostScript-fonts-1">6 PostScript fonts</a></li> -<li><a id="stoc-Color-1" href="#toc-Color-1">7 Color</a></li> -<li><a id="stoc-Index-1" href="#toc-Index-1" rel="index">Index</a></li> -</ul> +<div class="top" id="Top"> +<div class="header"> +<p> +Next: <a href="#Why-Dvips" accesskey="n" rel="next">Why use Dvips?</a>, Up: <a href="http://tug.org/texinfohtml" accesskey="u" rel="up">(dir)</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> </div> +<span id="Dvips"></span><h1 class="top">Dvips</h1> + +<p>This manual documents Dvips version 2022.1 +(January 2022), a program to translate a DVI file into +PostScript. You may freely use, modify and/or distribute this file. +</p> + -<span id="SEC_Contents"></span> +<div class="Contents_element" id="SEC_Contents"> <h2 class="contents-heading">Table of Contents</h2> <div class="contents"> @@ -185,42 +187,28 @@ ul.no-bullet {list-style: none} <li><a id="toc-Index-1" href="#Index" rel="index">Index</a></li> </ul> </div> - - -<span id="Top"></span><div class="header"> -<p> -Next: <a href="#Why-Dvips" accesskey="n" rel="next">Why Dvips</a>, Up: <a href="http://tug.org/texinfohtml" accesskey="u" rel="up">(dir)</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> </div> -<span id="Dvips"></span><h1 class="top">Dvips</h1> - -<p>This manual documents Dvips version 2021.1 -(February 2021), a program to translate a DVI file into -PostScript. You may freely use, modify and/or distribute this file. -</p> -<table class="menu" border="0" cellspacing="0"> -<tr><td align="left" valign="top">• <a href="#Why-Dvips" accesskey="1">Why Dvips</a></td><td> </td><td align="left" valign="top">Why use Dvips? -</td></tr> -<tr><td align="left" valign="top">• <a href="#Installation" accesskey="2">Installation</a></td><td> </td><td align="left" valign="top">How to compile and install Dvips. -</td></tr> -<tr><td align="left" valign="top">• <a href="#Invoking-Dvips" accesskey="3">Invoking Dvips</a></td><td> </td><td align="left" valign="top">Command-line options, configuration files, etc. -</td></tr> -<tr><td align="left" valign="top">• <a href="#Paper-size-and-landscape" accesskey="4">Paper size and landscape</a></td><td> </td><td align="left" valign="top">Changing the paper dimensions. -</td></tr> -<tr><td align="left" valign="top">• <a href="#Interaction-with-PostScript" accesskey="5">Interaction with PostScript</a></td><td> </td><td align="left" valign="top">TeX meets Dvips meets PostScript. -</td></tr> -<tr><td align="left" valign="top">• <a href="#PostScript-fonts" accesskey="6">PostScript fonts</a></td><td> </td><td align="left" valign="top">Installing and using PostScript fonts. -</td></tr> -<tr><td align="left" valign="top">• <a href="#Color" accesskey="7">Color</a></td><td> </td><td align="left" valign="top">Using color with Dvips. -</td></tr> -<tr><td align="left" valign="top">• <a href="#Index" rel="index" accesskey="8">Index</a></td><td> </td><td align="left" valign="top">General index. -</td></tr> -</table> - +<div class="Overview_element" id="SEC_Overview"> +<h2 class="shortcontents-heading">Short Table of Contents</h2> +<div class="shortcontents"> +<ul class="no-bullet"> +<li><a id="stoc-Why-use-Dvips_003f" href="#toc-Why-use-Dvips_003f">1 Why use Dvips?</a></li> +<li><a id="stoc-Installation-1" href="#toc-Installation-1">2 Installation</a></li> +<li><a id="stoc-Invoking-Dvips-1" href="#toc-Invoking-Dvips-1">3 Invoking Dvips</a></li> +<li><a id="stoc-Paper-size-and-landscape-orientation" href="#toc-Paper-size-and-landscape-orientation">4 Paper size and landscape orientation</a></li> +<li><a id="stoc-Interaction-with-PostScript-1" href="#toc-Interaction-with-PostScript-1">5 Interaction with PostScript</a></li> +<li><a id="stoc-PostScript-fonts-1" href="#toc-PostScript-fonts-1">6 PostScript fonts</a></li> +<li><a id="stoc-Color-1" href="#toc-Color-1">7 Color</a></li> +<li><a id="stoc-Index-1" href="#toc-Index-1" rel="index">Index</a></li> +</ul> +</div> +</div> <hr> -<span id="Why-Dvips"></span><div class="header"> +<div class="chapter" id="Why-Dvips"> +<div class="header"> <p> -Next: <a href="#Installation" accesskey="n" rel="next">Installation</a>, Previous: <a href="#Top" accesskey="p" rel="prev">Top</a>, Up: <a href="#Top" accesskey="u" rel="up">Top</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> +Next: <a href="#Installation" accesskey="n" rel="next">Installation</a>, Previous: <a href="#Top" accesskey="p" rel="prev">Dvips</a>, Up: <a href="#Top" accesskey="u" rel="up">Dvips</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> </div> <span id="Why-use-Dvips_003f"></span><h2 class="chapter">1 Why use Dvips?</h2> @@ -276,9 +264,11 @@ structure of the program. </p> <hr> -<span id="Installation"></span><div class="header"> +</div> +<div class="chapter" id="Installation"> +<div class="header"> <p> -Next: <a href="#Invoking-Dvips" accesskey="n" rel="next">Invoking Dvips</a>, Previous: <a href="#Why-Dvips" accesskey="p" rel="prev">Why Dvips</a>, Up: <a href="#Top" accesskey="u" rel="up">Top</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> +Next: <a href="#Invoking-Dvips" accesskey="n" rel="next">Invoking Dvips</a>, Previous: <a href="#Why-Dvips" accesskey="p" rel="prev">Why use Dvips?</a>, Up: <a href="#Top" accesskey="u" rel="up">Dvips</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> </div> <span id="Installation-1"></span><h2 class="chapter">2 Installation</h2> @@ -289,29 +279,26 @@ 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="https://tug.org/texinfohtml/kpathsea.html#Installation">Installation</a> in <cite>Kpathsea</cite>. +see <a data-manual="kpathsea" href="https://tug.org/texinfohtml/kpathsea.html#Installation">Installation</a> in <cite>Kpathsea</cite>. </p> <p>For solutions to common installation problems and information on how to -report a bug, see the file <samp>kpathsea/BUGS</samp> (see <a href="https://tug.org/texinfohtml/kpathsea.html#Bugs">Bugs</a> in <cite>Kpathsea</cite>). For solutions to Dvips-specific problems, +report a bug, see the file <samp>kpathsea/BUGS</samp> (see <a data-manual="kpathsea" href="https://tug.org/texinfohtml/kpathsea.html#Bugs">Bugs</a> in <cite>Kpathsea</cite>). For solutions to Dvips-specific problems, see <a href="#Debug-options">Debug options</a>. </p> <p>Dvips does require some additional installation, detailed in the sections below. Also, to configure color devices, see <a href="#Color-device-configuration">Color device configuration</a>. </p> -<table class="menu" border="0" cellspacing="0"> -<tr><td align="left" valign="top">• <a href="#config_002eps-installation" accesskey="1">config.ps installation</a></td><td> </td><td align="left" valign="top">Printer and site Dvips configuration. -</td></tr> -<tr><td align="left" valign="top">• <a href="#PostScript-font-installation" accesskey="2">PostScript font installation</a></td><td> </td><td align="left" valign="top">Many PostScript fonts are freely available. -</td></tr> -<tr><td align="left" valign="top">• <a href="#Ghostscript-installation" accesskey="3">Ghostscript installation</a></td><td> </td><td align="left" valign="top">A free PostScript interpreter. -</td></tr> -<tr><td align="left" valign="top">• <a href="#Diagnosing-problems" accesskey="4">Diagnosing problems</a></td><td> </td><td align="left" valign="top">Some common runtime difficulties. -</td></tr> -</table> +<ul class="section-toc"> +<li><a href="#config_002eps-installation" accesskey="1"><samp>config.ps</samp> installation</a></li> +<li><a href="#PostScript-font-installation" accesskey="2">PostScript font installation</a></li> +<li><a href="#Ghostscript-installation" accesskey="3">Ghostscript installation</a></li> +<li><a href="#Diagnosing-problems" accesskey="4">Diagnosing problems</a></li> +</ul> <hr> -<span id="config_002eps-installation"></span><div class="header"> +<div class="section" id="config_002eps-installation"> +<div class="header"> <p> Next: <a href="#PostScript-font-installation" accesskey="n" rel="next">PostScript font installation</a>, Up: <a href="#Installation" accesskey="u" rel="up">Installation</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> </div> @@ -329,16 +316,16 @@ 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="https://tug.org/texinfohtml/kpathsea.html#Config-files">Config files</a> in <cite>Kpathsea</cite>). +configuration file <samp>texmf.cnf</samp> (see <a data-manual="kpathsea" href="https://tug.org/texinfohtml/kpathsea.html#Config-files">Config files</a> in <cite>Kpathsea</cite>). </p> <span id="index-config_002eproto"></span> <span id="index-prototype-printer-configuration-file"></span> <span id="index-printer-configuration-file_002c-prototype"></span> <span id="index-configuration-files_002c-prototype"></span> <p>Dvips configuration files contents and searching are described fully in -<a href="#Config-files">Config files</a>. The simplest way to create a new configuration file +<a href="#Config-files">Dvips configuration files</a>. The simplest way to create a new configuration file is to copy and modify the file <samp>dvipsk/contrib/config.proto</samp>, -seasoning with options to your taste from <a href="#Config-files">Config files</a>. Here is +seasoning with options to your taste from <a href="#Config-files">Dvips configuration files</a>. Here is <samp>config.proto</samp> for your reading pleasure: </p><div class="example"> @@ -395,9 +382,11 @@ Z <hr> -<span id="PostScript-font-installation"></span><div class="header"> +</div> +<div class="section" id="PostScript-font-installation"> +<div class="header"> <p> -Next: <a href="#Ghostscript-installation" accesskey="n" rel="next">Ghostscript installation</a>, Previous: <a href="#config_002eps-installation" accesskey="p" rel="prev">config.ps installation</a>, Up: <a href="#Installation" accesskey="u" rel="up">Installation</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> +Next: <a href="#Ghostscript-installation" accesskey="n" rel="next">Ghostscript installation</a>, Previous: <a href="#config_002eps-installation" accesskey="p" rel="prev"><samp>config.ps</samp> installation</a>, Up: <a href="#Installation" accesskey="u" rel="up">Installation</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> </div> <span id="PostScript-font-installation-1"></span><h3 class="section">2.2 PostScript font installation</h3> @@ -415,16 +404,18 @@ come with support for 35 base PostScript fonts and many more. <span id="index-psfonts_002emap"></span> <p>If you have additional PostScript fonts, you can make them available to Dvips by (1) giving them appropriate filenames; and -(2) running Afm2tfm (see <a href="#Making-a-font-available">Making a font available</a>) to make TFM +(2) running Afm2tfm (see <a href="#Making-a-font-available">Making a PostScript font available</a>) to make TFM and VF metrics for TeX and Dvips to use. Also add them to -<samp>psfonts.map</samp> (see <a href="#psfonts_002emap">psfonts.map</a>); this file must contain +<samp>psfonts.map</samp> (see <a href="#psfonts_002emap"><samp>psfonts.map</samp>: PostScript font catalog</a>); this file must contain everything available in the system. The <code>updmap</code> program is usually used to maintain <samp>psfonts.map</samp>; run ‘<samp>updmap --help</samp>’ for lots of information about how it works. </p> <hr> -<span id="Ghostscript-installation"></span><div class="header"> +</div> +<div class="section" id="Ghostscript-installation"> +<div class="header"> <p> Next: <a href="#Diagnosing-problems" accesskey="n" rel="next">Diagnosing problems</a>, Previous: <a href="#PostScript-font-installation" accesskey="p" rel="prev">PostScript font installation</a>, Up: <a href="#Installation" accesskey="u" rel="up">Installation</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> </div> @@ -455,13 +446,15 @@ format. The latest version is available via <p>The program Ghostview, originally written by Johannes Plass and Tim Theisen, provides typical previewing capabilities (next page/previous page, magnification, etc.). It requires Ghostscript to run, and files -in structured Postscript, specifically with ‘<samp>%%Page</samp>’ comments (no +in structured PostScript, specifically with ‘<samp>%%Page</samp>’ comments (no ‘<samp>N</samp>’ in <samp>config.ps</samp>). The current version is known as GV, and is available from <a href="https://www.gnu.org/software/gv">https://www.gnu.org/software/gv</a>. </p> <hr> -<span id="Diagnosing-problems"></span><div class="header"> +</div> +<div class="section" id="Diagnosing-problems"> +<div class="header"> <p> Previous: <a href="#Ghostscript-installation" accesskey="p" rel="prev">Ghostscript installation</a>, Up: <a href="#Installation" accesskey="u" rel="up">Installation</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> </div> @@ -477,33 +470,28 @@ 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="https://tug.org/texinfohtml/kpathsea.html#Bugs">Bugs</a> in <cite>Kpathsea</cite>. +and <code>mktexpk</code> problems, see <a data-manual="kpathsea" href="https://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 read by Dvips. This way you can be sure it’s finding the files and settings you expect. </p> -<table class="menu" border="0" cellspacing="0"> -<tr><td align="left" valign="top">• <a href="#Debug-options" accesskey="1">Debug options</a></td><td> </td><td align="left" valign="top">Getting diagnostics. -</td></tr> -<tr><td align="left" valign="top">• <a href="#No-output" accesskey="2">No output</a></td><td> </td><td align="left" valign="top">No output at all. -</td></tr> -<tr><td align="left" valign="top">• <a href="#Small-or-inverted" accesskey="3">Small or inverted</a></td><td> </td><td align="left" valign="top">Output too small or inverted. -</td></tr> -<tr><td align="left" valign="top">• <a href="#Printer-errors" accesskey="4">Printer errors</a></td><td> </td><td align="left" valign="top">The printer sends back errors. -</td></tr> -<tr><td align="left" valign="top">• <a href="#Long-documents-fail" accesskey="5">Long documents fail</a></td><td> </td><td align="left" valign="top">Long documents fail to print. -</td></tr> -<tr><td align="left" valign="top">• <a href="#Including-graphics-fails" accesskey="6">Including graphics fails</a></td><td> </td><td align="left" valign="top">Figures don’t work. -</td></tr> -</table> +<ul class="section-toc"> +<li><a href="#Debug-options" accesskey="1">Debug options</a></li> +<li><a href="#No-output" accesskey="2">No output at all</a></li> +<li><a href="#Small-or-inverted" accesskey="3">Output too small or inverted</a></li> +<li><a href="#Printer-errors" accesskey="4">Error messages from printer</a></li> +<li><a href="#Long-documents-fail" accesskey="5">Long documents fail to print</a></li> +<li><a href="#Including-graphics-fails" accesskey="6">Including graphics fails</a></li> +</ul> <hr> -<span id="Debug-options"></span><div class="header"> +<div class="subsection" id="Debug-options"> +<div class="header"> <p> -Next: <a href="#No-output" accesskey="n" rel="next">No output</a>, Up: <a href="#Diagnosing-problems" accesskey="u" rel="up">Diagnosing problems</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> +Next: <a href="#No-output" accesskey="n" rel="next">No output at all</a>, Up: <a href="#Diagnosing-problems" accesskey="u" rel="up">Diagnosing problems</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> </div> <span id="Debug-options-1"></span><h4 class="subsection">2.4.1 Debug options</h4> @@ -519,57 +507,59 @@ 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 ‘<samp>-d</samp>’. Some of these debugging options are actually -provided by Kpathsea (see <a href="https://tug.org/texinfohtml/kpathsea.html#Debugging">Debugging</a> in <cite>Kpathsea</cite>). +provided by Kpathsea (see <a data-manual="kpathsea" href="https://tug.org/texinfohtml/kpathsea.html#Debugging">Debugging</a> in <cite>Kpathsea</cite>). </p> <p>The classes are: </p> <dl compact="compact"> -<dt>1</dt> +<dt><span>1</span></dt> <dd><p>specials </p></dd> -<dt>2</dt> +<dt><span>2</span></dt> <dd><p>paths </p></dd> -<dt>4</dt> +<dt><span>4</span></dt> <dd><p>fonts </p></dd> -<dt>8</dt> +<dt><span>8</span></dt> <dd><p>pages </p></dd> -<dt>16</dt> +<dt><span>16</span></dt> <dd><p>headers </p></dd> -<dt>32</dt> +<dt><span>32</span></dt> <dd><p>font compression </p></dd> -<dt>64</dt> +<dt><span>64</span></dt> <dd><p>files </p></dd> -<dt>128</dt> +<dt><span>128</span></dt> <dd><p>(omitted) </p></dd> -<dt>256</dt> +<dt><span>256</span></dt> <dd><p>config files </p></dd> -<dt>512</dt> +<dt><span>512</span></dt> <dd><p>Kpathsea <code>stat</code> calls </p></dd> -<dt>1024</dt> +<dt><span>1024</span></dt> <dd><p>Kpathsea hash table lookups </p></dd> -<dt>2048</dt> +<dt><span>2048</span></dt> <dd><p>Kpathsea path element expansion </p></dd> -<dt>4096</dt> +<dt><span>4096</span></dt> <dd><p>Kpathsea path searches </p></dd> </dl> <hr> -<span id="No-output"></span><div class="header"> +</div> +<div class="subsection" id="No-output"> +<div class="header"> <p> -Next: <a href="#Small-or-inverted" accesskey="n" rel="next">Small or inverted</a>, Previous: <a href="#Debug-options" accesskey="p" rel="prev">Debug options</a>, Up: <a href="#Diagnosing-problems" accesskey="u" rel="up">Diagnosing problems</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> +Next: <a href="#Small-or-inverted" accesskey="n" rel="next">Output too small or inverted</a>, Previous: <a href="#Debug-options" accesskey="p" rel="prev">Debug options</a>, Up: <a href="#Diagnosing-problems" accesskey="u" rel="up">Diagnosing problems</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> </div> <span id="No-output-at-all"></span><h4 class="subsection">2.4.2 No output at all</h4> @@ -608,9 +598,11 @@ comments and see what happens. </p> <hr> -<span id="Small-or-inverted"></span><div class="header"> +</div> +<div class="subsection" id="Small-or-inverted"> +<div class="header"> <p> -Next: <a href="#Printer-errors" accesskey="n" rel="next">Printer errors</a>, Previous: <a href="#No-output" accesskey="p" rel="prev">No output</a>, Up: <a href="#Diagnosing-problems" accesskey="u" rel="up">Diagnosing problems</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> +Next: <a href="#Printer-errors" accesskey="n" rel="next">Error messages from printer</a>, Previous: <a href="#No-output" accesskey="p" rel="prev">No output at all</a>, Up: <a href="#Diagnosing-problems" accesskey="u" rel="up">Diagnosing problems</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> </div> <span id="Output-too-small-or-inverted"></span><h4 class="subsection">2.4.3 Output too small or inverted</h4> @@ -627,13 +619,15 @@ force Dvips to do this with the ‘<samp>-F</samp>’ flag (or ‘<s option), but this generates files with a terminating binary character (control-D). You can also try using the ‘<samp>-s</samp>’ flag (or ‘<samp>s</samp>’ config file option) to enclose the entire job in a save/restore pair. -See <a href="#Command_002dline-options">Command-line options</a>, and <a href="#Config-files">Config files</a>. +See <a href="#Command_002dline-options">Command-line options</a>, and <a href="#Config-files">Dvips configuration files</a>. </p> <hr> -<span id="Printer-errors"></span><div class="header"> +</div> +<div class="subsection" id="Printer-errors"> +<div class="header"> <p> -Next: <a href="#Long-documents-fail" accesskey="n" rel="next">Long documents fail</a>, Previous: <a href="#Small-or-inverted" accesskey="p" rel="prev">Small or inverted</a>, Up: <a href="#Diagnosing-problems" accesskey="u" rel="up">Diagnosing problems</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> +Next: <a href="#Long-documents-fail" accesskey="n" rel="next">Long documents fail to print</a>, Previous: <a href="#Small-or-inverted" accesskey="p" rel="prev">Output too small or inverted</a>, Up: <a href="#Diagnosing-problems" accesskey="u" rel="up">Diagnosing problems</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> </div> <span id="Error-messages-from-printer"></span><h4 class="subsection">2.4.4 Error messages from printer</h4> @@ -668,9 +662,11 @@ might be a problem with the printer itself. </p> <hr> -<span id="Long-documents-fail"></span><div class="header"> +</div> +<div class="subsection" id="Long-documents-fail"> +<div class="header"> <p> -Next: <a href="#Including-graphics-fails" accesskey="n" rel="next">Including graphics fails</a>, Previous: <a href="#Printer-errors" accesskey="p" rel="prev">Printer errors</a>, Up: <a href="#Diagnosing-problems" accesskey="u" rel="up">Diagnosing problems</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> +Next: <a href="#Including-graphics-fails" accesskey="n" rel="next">Including graphics fails</a>, Previous: <a href="#Printer-errors" accesskey="p" rel="prev">Error messages from printer</a>, Up: <a href="#Diagnosing-problems" accesskey="u" rel="up">Diagnosing problems</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> </div> <span id="Long-documents-fail-to-print"></span><h4 class="subsection">2.4.5 Long documents fail to print</h4> @@ -682,9 +678,11 @@ the printer has in the configuration file; see the previous section. </p> <hr> -<span id="Including-graphics-fails"></span><div class="header"> +</div> +<div class="subsection" id="Including-graphics-fails"> +<div class="header"> <p> -Previous: <a href="#Long-documents-fail" accesskey="p" rel="prev">Long documents fail</a>, Up: <a href="#Diagnosing-problems" accesskey="u" rel="up">Diagnosing problems</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> +Previous: <a href="#Long-documents-fail" accesskey="p" rel="prev">Long documents fail to print</a>, Up: <a href="#Diagnosing-problems" accesskey="u" rel="up">Diagnosing problems</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> </div> <span id="Including-graphics-fails-1"></span><h4 class="subsection">2.4.6 Including graphics fails</h4> @@ -693,7 +691,7 @@ Previous: <a href="#Long-documents-fail" accesskey="p" rel="prev">Long documents <span id="index-failure_002c-to-include-graphics"></span> <p>The most common problem with including graphics is an incorrect bounding -box (see <a href="#Bounding-box">Bounding box</a>). Complain to whoever wrote the software that +box (see <a href="#Bounding-box">The bounding box comment</a>). Complain to whoever wrote the software that generated the file if the bounding box is indeed incorrect. </p> <span id="index-Illustrator_002c-workaround-for"></span> @@ -716,9 +714,13 @@ looking for a particular comment. </p> <hr> -<span id="Invoking-Dvips"></span><div class="header"> +</div> +</div> +</div> +<div class="chapter" id="Invoking-Dvips"> +<div class="header"> <p> -Next: <a href="#Paper-size-and-landscape" accesskey="n" rel="next">Paper size and landscape</a>, Previous: <a href="#Installation" accesskey="p" rel="prev">Installation</a>, Up: <a href="#Top" accesskey="u" rel="up">Top</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> +Next: <a href="#Paper-size-and-landscape" accesskey="n" rel="next">Paper size and landscape orientation</a>, Previous: <a href="#Installation" accesskey="p" rel="prev">Installation</a>, Up: <a href="#Top" accesskey="u" rel="up">Dvips</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> </div> <span id="Invoking-Dvips-1"></span><h2 class="chapter">3 Invoking Dvips</h2> @@ -734,20 +736,17 @@ chapters in this document. <p>There many ways to control Dvips’ behavior: configuration files, environment variables, and command-line options. </p> -<table class="menu" border="0" cellspacing="0"> -<tr><td align="left" valign="top">• <a href="#Basic-usage" accesskey="1">Basic usage</a></td><td> </td><td align="left" valign="top"> -</td></tr> -<tr><td align="left" valign="top">• <a href="#Command_002dline-options" accesskey="2">Command-line options</a></td><td> </td><td align="left" valign="top"> -</td></tr> -<tr><td align="left" valign="top">• <a href="#Environment-variables" accesskey="3">Environment variables</a></td><td> </td><td align="left" valign="top"> -</td></tr> -<tr><td align="left" valign="top">• <a href="#Config-files" accesskey="4">Config files</a></td><td> </td><td align="left" valign="top"> -</td></tr> -</table> +<ul class="section-toc"> +<li><a href="#Basic-usage" accesskey="1">Basic usage of Dvips</a></li> +<li><a href="#Command_002dline-options" accesskey="2">Command-line options</a></li> +<li><a href="#Environment-variables" accesskey="3">Environment variables</a></li> +<li><a href="#Config-files" accesskey="4">Dvips configuration files</a></li> +</ul> <hr> -<span id="Basic-usage"></span><div class="header"> +<div class="section" id="Basic-usage"> +<div class="header"> <p> Next: <a href="#Command_002dline-options" accesskey="n" rel="next">Command-line options</a>, Up: <a href="#Invoking-Dvips" accesskey="u" rel="up">Invoking Dvips</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> </div> @@ -772,7 +771,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’t been installed properly. -See <a href="https://tug.org/texinfohtml/kpathsea.html#Unable-to-generate-fonts">Unable to generate fonts</a> in <cite>Kpathsea</cite>.) +See <a data-manual="kpathsea" href="https://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, run @@ -783,25 +782,26 @@ of available options, run <hr> -<span id="Command_002dline-options"></span><div class="header"> +</div> +<div class="section" id="Command_002dline-options"> +<div class="header"> <p> -Next: <a href="#Environment-variables" accesskey="n" rel="next">Environment variables</a>, Previous: <a href="#Basic-usage" accesskey="p" rel="prev">Basic usage</a>, Up: <a href="#Invoking-Dvips" accesskey="u" rel="up">Invoking Dvips</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> +Next: <a href="#Environment-variables" accesskey="n" rel="next">Environment variables</a>, Previous: <a href="#Basic-usage" accesskey="p" rel="prev">Basic usage of Dvips</a>, Up: <a href="#Invoking-Dvips" accesskey="u" rel="up">Invoking Dvips</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> </div> <span id="Command_002dline-options-1"></span><h3 class="section">3.2 Command-line options</h3> <p>Dvips has a plethora of command line options. Reading through this section will give a good idea of the capabilities of the driver. </p> -<table class="menu" border="0" cellspacing="0"> -<tr><td align="left" valign="top">• <a href="#Option-summary" accesskey="1">Option summary</a></td><td> </td><td align="left" valign="top">Quick listing, from Dvips –help. -</td></tr> -<tr><td align="left" valign="top">• <a href="#Option-details" accesskey="2">Option details</a></td><td> </td><td align="left" valign="top">More information about each option. -</td></tr> -</table> +<ul class="section-toc"> +<li><a href="#Option-summary" accesskey="1">Option summary</a></li> +<li><a href="#Option-details" accesskey="2">Option details</a></li> +</ul> <hr> -<span id="Option-summary"></span><div class="header"> +<div class="subsection" id="Option-summary"> +<div class="header"> <p> Next: <a href="#Option-details" accesskey="n" rel="next">Option details</a>, Up: <a href="#Command_002dline-options" accesskey="u" rel="up">Command-line options</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> </div> @@ -855,7 +855,9 @@ Email bug reports to tex-k@mail.tug.org. </pre> <hr> -<span id="Option-details"></span><div class="header"> +</div> +<div class="subsection" id="Option-details"> +<div class="header"> <p> Previous: <a href="#Option-summary" accesskey="p" rel="prev">Option summary</a>, Up: <a href="#Command_002dline-options" accesskey="u" rel="up">Command-line options</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> </div> @@ -869,42 +871,36 @@ page reversal, use ‘<samp>-r0</samp>’. Such options are marked with ‘<samp>*</samp>’. </p> <dl compact="compact"> -<dt>‘<samp>-</samp>’</dt> -<dd><span id="index-_002d"></span> -<span id="index-options_002c-reading-from-standard-input"></span> +<dt id='index-_002d'><span>‘<samp>-</samp>’<a href='#index-_002d' class='copiable-anchor'> ¶</a></span></dt> +<dd><span id="index-options_002c-reading-from-standard-input"></span> <span id="index-standard-input_002c-reading-options-from"></span> <p>Read additional options from standard input after processing the command line. </p> </dd> -<dt>‘<samp>--help</samp>’</dt> -<dd><span id="index-_002d_002dhelp-1"></span> -<p>Print a usage message and exit. +<dt id='index-_002d_002dhelp-1'><span>‘<samp>--help</samp>’<a href='#index-_002d_002dhelp-1' class='copiable-anchor'> ¶</a></span></dt> +<dd><p>Print a usage message and exit. </p> </dd> -<dt>‘<samp>--version</samp>’</dt> -<dd><span id="index-_002d_002dversion"></span> -<p>Print the version number and exit. +<dt id='index-_002d_002dversion'><span>‘<samp>--version</samp>’<a href='#index-_002d_002dversion' class='copiable-anchor'> ¶</a></span></dt> +<dd><p>Print the version number and exit. </p> </dd> -<dt>‘<samp>-a*</samp>’</dt> -<dd><span id="index-_002da"></span> -<span id="index-memory_002c-conserving"></span> +<dt id='index-_002da'><span>‘<samp>-a*</samp>’<a href='#index-_002da' class='copiable-anchor'> ¶</a></span></dt> +<dd><span id="index-memory_002c-conserving"></span> <p>Conserve memory by making three passes over the DVI file instead of two and only loading those characters actually used. Generally only useful on machines with a very limited amount of memory, like some PCs. </p> </dd> -<dt>‘<samp>-A</samp>’</dt> -<dd><span id="index-_002dA"></span> -<span id="index-odd-pages-only"></span> +<dt id='index-_002dA'><span>‘<samp>-A</samp>’<a href='#index-_002dA' class='copiable-anchor'> ¶</a></span></dt> +<dd><span id="index-odd-pages-only"></span> <p>Print only the odd pages. This option uses TeX page numbers, not physical page numbers. </p> </dd> -<dt>‘<samp>-b <var>num</var></samp>’</dt> -<dd><span id="index-_002db-num"></span> -<span id="index-_002f_0023copies"></span> +<dt id='index-_002db-num'><span>‘<samp>-b <var>num</var></samp>’<a href='#index-_002db-num' class='copiable-anchor'> ¶</a></span></dt> +<dd><span id="index-_002f_0023copies"></span> <span id="index-copies_002c-duplicated-page-bodies"></span> <span id="index-color-separations"></span> <p>Generate <var>num</var> copies of each page, but duplicating the page body @@ -913,25 +909,22 @@ be useful in conjunction with a header file setting ‘<samp>bop-hook</samp> do color separations or other neat tricks. </p> </dd> -<dt>‘<samp>-B</samp>’</dt> -<dd><span id="index-_002dB"></span> -<span id="index-even-pages-only"></span> +<dt id='index-_002dB'><span>‘<samp>-B</samp>’<a href='#index-_002dB' class='copiable-anchor'> ¶</a></span></dt> +<dd><span id="index-even-pages-only"></span> <span id="index-double_002dsided-printing"></span> <p>Print only the even pages. This option uses TeX page numbers, not physical page numbers. </p> </dd> -<dt>‘<samp>-bitmapfontenc <var>option</var></samp>’</dt> -<dd><span id="index-_002dbitmapfontenc-option"></span> -<span id="index-bitmap-font-encoding"></span> +<dt id='index-_002dbitmapfontenc-option'><span>‘<samp>-bitmapfontenc <var>option</var></samp>’<a href='#index-_002dbitmapfontenc-option' class='copiable-anchor'> ¶</a></span></dt> +<dd><span id="index-bitmap-font-encoding"></span> <p>Turns bitmap font encoding to ‘<samp>off</samp>’, ‘<samp>on</samp>’ (no warnings for missing bitmap font encodings), or ‘<samp>strict</samp>’ (with warnings for missing bitmap font encodings). </p> </dd> -<dt>‘<samp>-c <var>num</var></samp>’</dt> -<dd><span id="index-_002dc-num"></span> -<span id="index-_002f_0023copies-1"></span> +<dt id='index-_002dc-num'><span>‘<samp>-c <var>num</var></samp>’<a href='#index-_002dc-num' class='copiable-anchor'> ¶</a></span></dt> +<dd><span id="index-_002f_0023copies-1"></span> <span id="index-copies_002c-uncollated"></span> <span id="index-uncollated-copies"></span> <p>Generate <var>num</var> consecutive copies of every page, i.e., the output is @@ -939,9 +932,8 @@ uncollated. This merely sets the builtin PostScript variable ‘<samp>/#copies</samp>’. </p> </dd> -<dt>‘<samp>-C <var>num</var></samp>’</dt> -<dd><span id="index-_002dC-num"></span> -<span id="index-copies_002c-collated"></span> +<dt id='index-_002dC-num'><span>‘<samp>-C <var>num</var></samp>’<a href='#index-_002dC-num' class='copiable-anchor'> ¶</a></span></dt> +<dd><span id="index-copies_002c-collated"></span> <span id="index-collated-copies"></span> <p>Generate <var>num</var> copies, but collated (by replicating the data in the PostScript file). Slower than the ‘<samp>-c</samp>’ option, but easier on the @@ -949,18 +941,16 @@ hands, and faster than resubmitting the same PostScript file multiple times. </p> </dd> -<dt>‘<samp>-d <var>num</var></samp>’</dt> -<dd><span id="index-_002dd-num"></span> -<span id="index-debugging-1"></span> +<dt id='index-_002dd-num'><span>‘<samp>-d <var>num</var></samp>’<a href='#index-_002dd-num' class='copiable-anchor'> ¶</a></span></dt> +<dd><span id="index-debugging-1"></span> <p>Set the debug flags, showing what Dvips (thinks it) is doing. This will work unless Dvips has been compiled without the ‘<samp>DEBUG</samp>’ option (not recommended). See <a href="#Debug-options">Debug options</a>, for the possible values of <var>num</var>. Use ‘<samp>-d -1</samp>’ as the first option for maximum output. </p> </dd> -<dt>‘<samp>-D <var>num</var></samp>’</dt> -<dd><span id="index-_002dD-num"></span> -<span id="index-resolution_002c-setting"></span> +<dt id='index-_002dD-num'><span>‘<samp>-D <var>num</var></samp>’<a href='#index-_002dD-num' class='copiable-anchor'> ¶</a></span></dt> +<dd><span id="index-resolution_002c-setting"></span> <p>Set both the horizontal and vertical resolution to <var>num</var>, given in dpi (dots per inch). This affects the choice of bitmap fonts that are loaded and also the positioning of letters in resident PostScript @@ -974,9 +964,8 @@ that you use or Metafont will fail. See the file names for most devices. </p> </dd> -<dt>‘<samp>-e <var>num</var></samp>’</dt> -<dd><span id="index-_002de-num"></span> -<span id="index-maxdrift"></span> +<dt id='index-_002de-num'><span>‘<samp>-e <var>num</var></samp>’<a href='#index-_002de-num' class='copiable-anchor'> ¶</a></span></dt> +<dd><span id="index-maxdrift"></span> <span id="index-accuracy-in-positioning"></span> <span id="index-positioning-accuracy"></span> <p>Maximum drift in pixels of each character from its ‘true’ @@ -990,9 +979,8 @@ position at the beginning of each new word, improves the spacing of letters in words. </p> </dd> -<dt>‘<samp>-E*</samp>’</dt> -<dd><span id="index-_002dE"></span> -<span id="index-EPSF_002c-generating"></span> +<dt id='index-_002dE'><span>‘<samp>-E*</samp>’<a href='#index-_002dE' class='copiable-anchor'> ¶</a></span></dt> +<dd><span id="index-EPSF_002c-generating"></span> <span id="index-tight-bounding-box_002c-finding"></span> <span id="index-bounding-box_002c-finding-tight"></span> <p>Generate an EPSF file with a tight bounding box. This only looks at @@ -1010,9 +998,8 @@ each page as a separate EPSF file; otherwise, all the pages are overlaid in the single output file. </p> </dd> -<dt>‘<samp>-f*</samp>’</dt> -<dd><span id="index-_002df"></span> -<span id="index-filter_002c-running-as-a"></span> +<dt id='index-_002df'><span>‘<samp>-f*</samp>’<a href='#index-_002df' class='copiable-anchor'> ¶</a></span></dt> +<dd><span id="index-filter_002c-running-as-a"></span> <span id="index-standard-I_002fO"></span> <span id="index-pipes_002c-not-readable"></span> <span id="index-PRINTER_002c-avoided-with-_002df"></span> @@ -1027,9 +1014,8 @@ control-D if it was turned on with the ‘<samp>-F</samp>’ option or i configuration file; use ‘<samp>-F</samp>’ after the ‘<samp>-f</samp>’ to send it anyway. </p> </dd> -<dt>‘<samp>-F*</samp>’</dt> -<dd><span id="index-_002dF"></span> -<span id="index-EOF"></span> +<dt id='index-_002dF'><span>‘<samp>-F*</samp>’<a href='#index-_002dF' class='copiable-anchor'> ¶</a></span></dt> +<dd><span id="index-EOF"></span> <span id="index-control_002dD"></span> <span id="index-printer_002c-driving-directly"></span> <span id="index-spooler_002c-lacking"></span> @@ -1040,27 +1026,26 @@ systems. On systems shared by more than one person, this is not recommended. </p> </dd> -<dt>‘<samp>-G*</samp>’</dt> -<dd><span id="index-_002dG"></span> -<span id="index-low-characters_002c-shifting"></span> +<dt id='index-_002dG'><span>‘<samp>-G*</samp>’<a href='#index-_002dG' class='copiable-anchor'> ¶</a></span></dt> +<dd><span id="index-low-characters_002c-shifting"></span> <span id="index-non_002dprinting-characters_002c-shifting"></span> <p>Shift non-printing characters (ASCII 0-32, 127) to higher-numbered positions. This was useful to work around bugs in old versions of Adobe’s PDF reader. It’s more likely to cause problems nowadays. </p> </dd> -<dt>‘<samp>-h <var>name</var></samp>’</dt> -<dd><span id="index-_002dh-name"></span> -<span id="index-header-file_002c-downloading"></span> +<dt id='index-_002dh-name'><span>‘<samp>-h <var>name</var></samp>’<a href='#index-_002dh-name' class='copiable-anchor'> ¶</a></span></dt> +<dd><span id="index-header-file_002c-downloading"></span> <span id="index-userdict_002c-used-for-header-files"></span> <p>Prepend <var>name</var> as an additional header file, or, if <var>name</var> is -‘<samp>-</samp>’, suppress all header files. Any definitions in the header file -get added to the PostScript ‘<samp>userdict</samp>’. +‘<samp>-</samp>’, suppress inclusion of default header files. If <code>-h</code> is +given multiple times, the headers are included in the order given. +Any definitions in the header file get added to the PostScript +‘<samp>userdict</samp>’. </p> </dd> -<dt>‘<samp>-i*</samp>’</dt> -<dd><span id="index-_002di"></span> -<span id="index-sections-output_002c-in-separate-files"></span> +<dt id='index-_002di'><span>‘<samp>-i*</samp>’<a href='#index-_002di' class='copiable-anchor'> ¶</a></span></dt> +<dd><span id="index-sections-output_002c-in-separate-files"></span> <span id="index-multiple-output-files"></span> <span id="index-output-files_002c-multiple"></span> <p>Make each section be a separate file; a <em>section</em> is a part of the @@ -1080,17 +1065,15 @@ output into unwanted sections, to try to avoid overflowing printer memory. See <a href="#Headers-and-memory-usage">Headers and memory usage</a>, for ways to handle this. </p> </dd> -<dt>‘<samp>-j*</samp>’</dt> -<dd><span id="index-_002dj-for-partial-font-downloading"></span> -<p>Download only needed characters from Type 1 fonts. This is the +<dt id='index-_002dj-for-partial-font-downloading'><span>‘<samp>-j*</samp>’<a href='#index-_002dj-for-partial-font-downloading' class='copiable-anchor'> ¶</a></span></dt> +<dd><p>Download only needed characters from Type 1 fonts. This is the default in the current release. Some debugging flags trace this operation (see <a href="#Debug-options">Debug options</a>). You can also control partial downloading on a -per-font basis (see <a href="#psfonts_002emap">psfonts.map</a>). +per-font basis (see <a href="#psfonts_002emap"><samp>psfonts.map</samp>: PostScript font catalog</a>). </p> </dd> -<dt>‘<samp>-k*</samp>’</dt> -<dd><span id="index-_002dk-for-cropmarks"></span> -<span id="index-cropmarks"></span> +<dt id='index-_002dk-for-cropmarks'><span>‘<samp>-k*</samp>’<a href='#index-_002dk-for-cropmarks' class='copiable-anchor'> ¶</a></span></dt> +<dd><span id="index-cropmarks"></span> <span id="index-crop_002epro"></span> <p>Print crop marks. This option increases the paper size (which should be specified, either with a paper size special or with the ‘<samp>-T</samp>’ @@ -1100,9 +1083,8 @@ typesetters that can set the page size automatically. This works by downloading <samp>crop.pro</samp>. </p> </dd> -<dt>‘<samp>-K*</samp>’</dt> -<dd><span id="index-_002dK"></span> -<span id="index-comments_002c-removing-included"></span> +<dt id='index-_002dK'><span>‘<samp>-K*</samp>’<a href='#index-_002dK' class='copiable-anchor'> ¶</a></span></dt> +<dd><span id="index-comments_002c-removing-included"></span> <span id="index-_0025_0025Page_002c-removing"></span> <p>Remove comments in included PostScript graphics, font files, and headers; only necessary to get around bugs in spoolers or PostScript @@ -1113,49 +1095,65 @@ macros from some software packages read portion the input stream line by line, searching for a particular comment. </p> </dd> -<dt>‘<samp>-l [=]<var>num</var></samp>’</dt> -<dd><span id="index-_002dl-_005b_003d_005dnum"></span> -<span id="index-last-page-printed"></span> +<dt id='index-_002dl-_005b_003d_005dnum_005b_002epageseq_005d'><span>‘<samp>-l [=]<var>num</var>[.<var>pageseq</var>]</samp>’<a href='#index-_002dl-_005b_003d_005dnum_005b_002epageseq_005d' class='copiable-anchor'> ¶</a></span></dt> +<dd><span id="index-last-page-printed"></span> <span id="index-page_002c-last-printed"></span> +<span id="index-page-numbers_002c-multiple-repetitions-of"></span> <span id="index-physical-page-number_002c-and-_002dl"></span> <span id="index-absolute-page-number_002c-and-_002dl"></span> -<p>The last page printed will be the first one numbered <var>num</var>. Default -is the last page in the document. If <var>num</var> is prefixed by an equals -sign, then it (and the argument to the ‘<samp>-p</samp>’ option, if specified) -is treated as a physical (absolute) page number, rather than a value to -compare with the TeX ‘<samp>\count0</samp>’ values stored in the DVI file. -Thus, using ‘<samp>-l =9</samp>’ will end with the ninth page of the document, -no matter what the pages are actually numbered. -</p> -</dd> -<dt>‘<samp>-L*</samp>’</dt> -<dd><span id="index-_002dL"></span> -<span id="index-papersize-special_002c-first-vs_002e-last"></span> +<p>The last page printed will be the first one numbered <var>num</var>; the +default is the last page in the document. +</p> +<p>By default, <var>num</var> is compared to TeX’s idea of the page number +(more precisely, the <code>\count0</code> value written in the DVI file). +But if <var>num</var> is prefixed by an equals sign, then it (and the +argument to the ‘<samp>-p</samp>’ option, if specified) is treated as a +physical (absolute) page number, Thus, using ‘<samp>-l =9</samp>’ will end the +output with the ninth page of the document, no matter what the pages +are actually numbered. +</p> +<p>On the other hand, if <var>pageseq</var> is specified, the <var>pageseq</var>th +occurrence of the given TeX page number is used. For example, +‘<samp>-l 99.2</samp>’ says to end with the second page numbered 99 in the +document. The ‘<samp>=</samp>’ and <var>lastseq</var> features aren’t useful +together. +</p> +</dd> +<dt id='index-_002dL'><span>‘<samp>-L*</samp>’<a href='#index-_002dL' class='copiable-anchor'> ¶</a></span></dt> +<dd><span id="index-papersize-special_002c-first-vs_002e-last"></span> <p>By default or with <code>-L1</code>, the last ‘<samp>papersize</samp>’ special wins; with <code>-L0</code>, the first special wins. See <a href="#papersize-special">‘<samp>papersize</samp>’ special</a>. </p> </dd> -<dt>‘<samp>-m*</samp>’</dt> -<dd><span id="index-_002dm"></span> -<span id="index-manual-feed"></span> +<dt id='index-_002dlandscaperotate'><span>‘<samp>-landscaperotate*</samp>’<a href='#index-_002dlandscaperotate' class='copiable-anchor'> ¶</a></span></dt> +<dd><span id="index-landscaperotate"></span> +<p>When looking for matching paper sizes, permit rotation of page content +on the page to match the given size; the default, as of Dvips 2022.1, +is not to do this. It should not be needed in modern systems with +normal print spoolers, and can be harmful when converting to PDF +(see <a href="#Config-file-paper-sizes">Configuration file paper size command</a>). This option accepts an optional +suffix of 0 (to explicitly disable) or 1 (to explicitly enable); if +the option is specified without a suffix, it enables the behavior. +</p> +</dd> +<dt id='index-_002dm'><span>‘<samp>-m*</samp>’<a href='#index-_002dm' class='copiable-anchor'> ¶</a></span></dt> +<dd><span id="index-manual-feed"></span> <p>Specify manual feed, if supported by the output device. </p> </dd> -<dt>‘<samp>-mode <var>mode</var></samp>’</dt> -<dd><span id="index-_002dmode-mode"></span> -<span id="index-mode-name_002c-specifying"></span> +<dt id='index-_002dmode-mode'><span>‘<samp>-mode <var>mode</var></samp>’<a href='#index-_002dmode-mode' class='copiable-anchor'> ¶</a></span></dt> +<dd><span id="index-mode-name_002c-specifying"></span> <span id="index-Metafont-mode_002c-specifying"></span> <p>Use <var>mode</var> as the Metafont device name for path searching and font 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="https://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="https://tug.org/texinfohtml/kpathsea.html#Unable-to-generate-fonts">Unable to generate fonts</a> in <cite>Kpathsea</cite>. +See <a data-manual="kpathsea" href="https://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 data-manual="kpathsea" href="https://tug.org/texinfohtml/kpathsea.html#Unable-to-generate-fonts">Unable to generate fonts</a> in <cite>Kpathsea</cite>. </p> </dd> -<dt>‘<samp>-M*</samp>’</dt> -<dd><span id="index-_002dM"></span> -<span id="index-font-generation_002c-avoiding"></span> +<dt id='index-_002dM'><span>‘<samp>-M*</samp>’<a href='#index-_002dM' class='copiable-anchor'> ¶</a></span></dt> +<dd><span id="index-font-generation_002c-avoiding"></span> <span id="index-mktexpk_002c-avoiding"></span> <span id="index-missfont_002elog"></span> <p>Turns off automatic font generation (<samp>mktexpk</samp>). If @@ -1172,16 +1170,14 @@ overridden by the ‘<samp>MISSFONT_LOG</samp>’ environment variable o configuration file value. </p> </dd> -<dt>‘<samp>-n <var>num</var></samp>’</dt> -<dd><span id="index-_002dn-num"></span> -<span id="index-maximum-pages-printed"></span> +<dt id='index-_002dn-num'><span>‘<samp>-n <var>num</var></samp>’<a href='#index-_002dn-num' class='copiable-anchor'> ¶</a></span></dt> +<dd><span id="index-maximum-pages-printed"></span> <span id="index-pages_002c-maximum-printed"></span> <p>Print at most <var>num</var> pages. Default is 100000. </p> </dd> -<dt>‘<samp>-N*</samp>’</dt> -<dd><span id="index-_002dN"></span> -<span id="index-structured-comments"></span> +<dt id='index-_002dN'><span>‘<samp>-N*</samp>’<a href='#index-_002dN' class='copiable-anchor'> ¶</a></span></dt> +<dd><span id="index-structured-comments"></span> <span id="index-TranScript"></span> <span id="index-_0025_0025Page_002c-not-generating"></span> <p>Turns off generation of structured comments such as ‘<samp>%%Page</samp>’; this @@ -1192,9 +1188,8 @@ Beware: This also disables page movement, etc., in PostScript viewers such as Ghostview. </p> </dd> -<dt>‘<samp>-noomega</samp>’</dt> -<dd><span id="index-_002dnoomega"></span> -<span id="index-Omega-extensions"></span> +<dt id='index-_002dnoomega'><span>‘<samp>-noomega</samp>’<a href='#index-_002dnoomega' class='copiable-anchor'> ¶</a></span></dt> +<dd><span id="index-Omega-extensions"></span> <span id="index-pTeX-extensions"></span> <p>Disable the use of Omega extensions when interpreting DVI files. By default, the additional opcodes ‘<samp>129</samp>’ and ‘<samp>134</samp>’ @@ -1202,9 +1197,8 @@ are recognized by Dvips as Omega or pTeX extensions and interpreted as requests to set 2-byte characters. </p> </dd> -<dt>‘<samp>-noptex</samp>’</dt> -<dd><span id="index-_002dnoptex"></span> -<span id="index-pTeX-extensions-1"></span> +<dt id='index-_002dnoptex'><span>‘<samp>-noptex</samp>’<a href='#index-_002dnoptex' class='copiable-anchor'> ¶</a></span></dt> +<dd><span id="index-pTeX-extensions-1"></span> <p>Disable the use of pTeX extensions when interpreting DVI files. By default, the additional opcodes ‘<samp>130</samp>’ and ‘<samp>135</samp>’ are recognized by Dvips as Omega extensions and interpreted as requests to @@ -1218,12 +1212,11 @@ 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 ‘<samp>-noptex</samp>’, or both by using ‘<samp>-noomega</samp>’ (but please do send a bug report if you find such problems, -see <a href="https://tug.org/texinfohtml/kpathsea.html#Bugs">Bugs</a> in <cite>Kpathsea</cite>). +see <a data-manual="kpathsea" href="https://tug.org/texinfohtml/kpathsea.html#Bugs">Bugs</a> in <cite>Kpathsea</cite>). </p> </dd> -<dt>‘<samp>-o <var>name</var></samp>’</dt> -<dd><span id="index-_002do-name"></span> -<span id="index-output_002c-redirecting"></span> +<dt id='index-_002do-name'><span>‘<samp>-o <var>name</var></samp>’<a href='#index-_002do-name' class='copiable-anchor'> ¶</a></span></dt> +<dd><span id="index-output_002c-redirecting"></span> <span id="index-standard-output_002c-output-to"></span> <p>Send output to the file <var>name</var>. If ‘<samp>-o</samp>’ is specified without <var>name</var> (i.e., it is the last thing on the command line), the @@ -1250,9 +1243,8 @@ environment variable, and turns off the automatic sending of control-D. See the ‘<samp>-f</samp>’ option for how to override this. </p> </dd> -<dt>‘<samp>-O <var>x-offset</var>,<var>y-offset</var></samp>’</dt> -<dd><span id="index-_002dO-x_002doffset_002cy_002doffset"></span> -<span id="index-offset-pages"></span> +<dt id='index-_002dO-x_002doffset_002cy_002doffset'><span>‘<samp>-O <var>x-offset</var>,<var>y-offset</var></samp>’<a href='#index-_002dO-x_002doffset_002cy_002doffset' class='copiable-anchor'> ¶</a></span></dt> +<dd><span id="index-offset-pages"></span> <span id="index-printer-offset"></span> <p>Move the origin by <var>x-offset</var>,<var>y-offset</var>, a comma-separated pair of dimensions such as ‘<samp>.1in,-.3cm</samp>’ (see <a href="#papersize-special">‘<samp>papersize</samp>’ special</a>). The origin of the page is shifted from the default position @@ -1271,24 +1263,17 @@ same <code>O</code> value—some printers vary widely from run to run. page, your best recourse is to use ‘<samp>bop-hook</samp>’ (see <a href="#PostScript-hooks">PostScript hooks</a>). </p> </dd> -<dt>‘<samp>-p [=]<var>num</var></samp>’</dt> -<dd><span id="index-_002dp-_005b_003d_005dnum"></span> -<span id="index-first-page-printed"></span> +<dt id='index-_002dp-_005b_003d_005dnum_005b_002epageseq_005d'><span>‘<samp>-p [=]<var>num</var>[.<var>pageseq</var>]</samp>’<a href='#index-_002dp-_005b_003d_005dnum_005b_002epageseq_005d' class='copiable-anchor'> ¶</a></span></dt> +<dd><span id="index-first-page-printed"></span> <span id="index-page_002c-first-printed"></span> <span id="index-physical-page-number_002c-and-_002dp"></span> <span id="index-absolute-page-number_002c-and-_002dp"></span> -<p>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 ‘<samp>-l</samp>’ option, if -specified) is treated as a physical (absolute) page number, rather than -a value to compare with the TeX ‘<samp>\count0</samp>’ values stored in the -DVI file. Thus, using ‘<samp>-p =3</samp>’ will start with the third page of -the document, no matter what the pages are actually numbered. -</p> -</dd> -<dt>‘<samp>-pp <var>first</var>-<var>last</var></samp>’</dt> -<dd><span id="index-_002dpp-first_002dlast"></span> -<span id="index-page-range"></span> +<p>Exactly analogous to <code>-l</code> (q.v.), but specifying the first page +number to be printed (processed). +</p> +</dd> +<dt id='index-_002dpp-first_002dlast'><span>‘<samp>-pp <var>first</var>-<var>last</var></samp>’<a href='#index-_002dpp-first_002dlast' class='copiable-anchor'> ¶</a></span></dt> +<dd><span id="index-page-range"></span> <span id="index-_002dpp-range"></span> <p>Print pages <var>first</var> through <var>last</var>; equivalent to ‘<samp>-p <var>first</var> -l <var>last</var></samp>’, except that multiple ‘<samp>-pp</samp>’ options @@ -1296,9 +1281,8 @@ accumulate, unlike ‘<samp>-p</samp>’ and ‘<samp>-l</samp>&rsqu also be ‘<samp>:</samp>’. </p> </dd> -<dt>‘<samp>-P <var>printer</var></samp>’</dt> -<dd><span id="index-_002dP-printer"></span> -<span id="index-config_002eps"></span> +<dt id='index-_002dP-printer'><span>‘<samp>-P <var>printer</var></samp>’<a href='#index-_002dP-printer' class='copiable-anchor'> ¶</a></span></dt> +<dd><span id="index-config_002eps"></span> <p>Read the configuration file <samp>config.<var>printer</var></samp> (<samp><var>printer</var>.cfg</samp> on MS-DOS), which typically sets the output name (most likely ‘<samp>o |lpr -P<var>printer</var></samp>’), resolution, Metafont @@ -1320,53 +1304,47 @@ exists, it is read. See <a href="#Configuration-file-searching">Configuration file searching</a>. </p> </dd> -<dt>‘<samp>-q*</samp>’</dt> -<dd><span id="index-_002dq"></span> -<span id="index-quiet-operation"></span> +<dt id='index-_002dq'><span>‘<samp>-q*</samp>’<a href='#index-_002dq' class='copiable-anchor'> ¶</a></span></dt> +<dd><span id="index-quiet-operation"></span> <span id="index-silent-operation"></span> <span id="index-warnings_002c-suppressing"></span> <p>Run quietly. Don’t chatter about pages converted, etc., and report no warnings (only errors) to standard error. </p> </dd> -<dt>‘<samp>-r*</samp>’</dt> -<dd><span id="index-_002dr"></span> -<span id="index-reverse-pagination"></span> +<dt id='index-_002dr'><span>‘<samp>-r*</samp>’<a href='#index-_002dr' class='copiable-anchor'> ¶</a></span></dt> +<dd><span id="index-reverse-pagination"></span> <p>Output pages in reverse order. By default, page 1 is output first. </p> </dd> -<dt>‘<samp>-R</samp>’</dt> -<dd><span id="index-_002dR"></span> -<span id="index-security"></span> +<dt id='index-_002dR'><span>‘<samp>-R</samp>’<a href='#index-_002dR' class='copiable-anchor'> ¶</a></span></dt> +<dd><span id="index-security"></span> <span id="index-shell-command-execution_002c-disabling"></span> <span id="index-absolute-filenames_002c-disabling"></span> <span id="index-_002e_002e_002drelative-filenames"></span> <p>Run securely. ‘<samp>-R2</samp>’ disables both shell command execution in -<code>\special</code> (via ‘<samp>`</samp>’, see <a href="#Dynamic-creation-of-graphics">Dynamic creation of graphics</a>) +<code>\special</code> (via ‘<samp>`</samp>’, see <a href="#Dynamic-creation-of-graphics">Dynamic creation of PostScript graphics files</a>) and config files (via the ‘<samp>E</samp>’ option, see <a href="#Configuration-file-commands">Configuration file commands</a>) and opening of any absolute or <samp>..</samp>-relative filenames. ‘<samp>-R1</samp>’, the default, forbids shell escapes but allows absolute filenames. ‘<samp>-R0</samp>’ allows both. </p> </dd> -<dt>‘<samp>-s*</samp>’</dt> -<dd><span id="index-_002ds"></span> -<span id="index-save_002frestore_002c-generating-global"></span> +<dt id='index-_002ds'><span>‘<samp>-s*</samp>’<a href='#index-_002ds' class='copiable-anchor'> ¶</a></span></dt> +<dd><span id="index-save_002frestore_002c-generating-global"></span> <p>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. </p> </dd> -<dt>‘<samp>-S <var>num</var></samp>’</dt> -<dd><span id="index-_002dS-num"></span> -<p>Set the maximum number of pages in each ‘section’. This option is most +<dt id='index-_002dS-num'><span>‘<samp>-S <var>num</var></samp>’<a href='#index-_002dS-num' class='copiable-anchor'> ¶</a></span></dt> +<dd><p>Set the maximum number of pages in each ‘section’. This option is most commonly used with the ‘<samp>-i</samp>’ option; see its description above for more information. </p> </dd> -<dt>‘<samp>-t <var>papertype</var></samp>’</dt> -<dd><span id="index-_002dt-papertype"></span> -<span id="index-paper-type"></span> +<dt id='index-_002dt-papertype'><span>‘<samp>-t <var>papertype</var></samp>’<a href='#index-_002dt-papertype' class='copiable-anchor'> ¶</a></span></dt> +<dd><span id="index-paper-type"></span> <span id="index-media"></span> <span id="index-letter-papertype"></span> <span id="index-legal-papertype"></span> @@ -1377,7 +1355,7 @@ more information. <span id="index-papersize-special_002c-and-no-_002dt"></span> <p>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>). +select it (see <a href="#Config-file-paper-sizes">Configuration file paper size command</a>). </p><ul class="no-bullet"> <li>- You can also specify a <var>papertype</var> of ‘<samp>landscape</samp>’, which rotates a document by 90 degrees. @@ -1397,9 +1375,8 @@ you can use ‘<samp>-E</samp>’ to get pure EPSF output.) </li></ul> </dd> -<dt>‘<samp>-title <var>string</var></samp>’</dt> -<dd><span id="index-_002dtitle-str"></span> -<span id="index-title_002c-specifying"></span> +<dt id='index-_002dtitle-str'><span>‘<samp>-title <var>string</var></samp>’<a href='#index-_002dtitle-str' class='copiable-anchor'> ¶</a></span></dt> +<dd><span id="index-title_002c-specifying"></span> <span id="index-output-title_002c-specifying"></span> <span id="index-document-title_002c-specifying"></span> <span id="index-_0025_0025Title"></span> @@ -1409,17 +1386,15 @@ input file; for example, running <code>dvips /foo/bar.dvi</code> will have a <code>%%Title</code> of ‘<samp>bar.dvi</samp>’. </p> </dd> -<dt>‘<samp>-T <var>hsize</var>,<var>vsize</var></samp>’</dt> -<dd><span id="index-_002dT-hsize_002cvsize"></span> -<p>Set the paper size to (<var>hsize</var>,<var>vsize</var>), a comma-separated +<dt id='index-_002dT-hsize_002cvsize'><span>‘<samp>-T <var>hsize</var>,<var>vsize</var></samp>’<a href='#index-_002dT-hsize_002cvsize' class='copiable-anchor'> ¶</a></span></dt> +<dd><p>Set the paper size to (<var>hsize</var>,<var>vsize</var>), a comma-separated pair of dimensions such as ‘<samp>.1in,-.3cm</samp>’ (see <a href="#papersize-special">‘<samp>papersize</samp>’ 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 ‘<samp>-tunknown</samp>’. </p> </dd> -<dt>‘<samp>-u <var>psmapfile</var></samp>’</dt> -<dd><span id="index-_002du-psmapfile"></span> -<span id="index-PostScript-font-alias-file"></span> +<dt id='index-_002du-psmapfile'><span>‘<samp>-u <var>psmapfile</var></samp>’<a href='#index-_002du-psmapfile' class='copiable-anchor'> ¶</a></span></dt> +<dd><span id="index-PostScript-font-alias-file"></span> <span id="index-resident-fonts_002c-different-in-different-printers"></span> <p>Set <var>psmapfile</var> to be the file that dvips uses for looking up PostScript font aliases. If <var>psmapfile</var> begins with a ‘<samp>+</samp>’ @@ -1429,9 +1404,8 @@ the list). In either case, if the name has no extension, then ‘<samp>.map is added at the end. </p> </dd> -<dt>‘<samp>-U*</samp>’</dt> -<dd><span id="index-_002dU"></span> -<span id="index-Xerox-4045"></span> +<dt id='index-_002dU'><span>‘<samp>-U*</samp>’<a href='#index-_002dU' class='copiable-anchor'> ¶</a></span></dt> +<dd><span id="index-Xerox-4045"></span> <p>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 @@ -1440,14 +1414,12 @@ bottom of each character. Not recommended unless you must drive this printer. </p> </dd> -<dt>‘<samp>-v</samp>’</dt> -<dd><span id="index-_002dv"></span> -<p>Print the dvips version number and exit. +<dt id='index-_002dv'><span>‘<samp>-v</samp>’<a href='#index-_002dv' class='copiable-anchor'> ¶</a></span></dt> +<dd><p>Print the dvips version number and exit. </p> </dd> -<dt>‘<samp>-V*</samp>’</dt> -<dd><span id="index-_002dV"></span> -<p>Download non-resident PostScript fonts as bitmaps. This requires use +<dt id='index-_002dV'><span>‘<samp>-V*</samp>’<a href='#index-_002dV' class='copiable-anchor'> ¶</a></span></dt> +<dd><p>Download non-resident PostScript fonts as bitmaps. This requires use <span id="index-mtpk"></span> <span id="index-gsftopk"></span> <span id="index-pstopk"></span> @@ -1460,10 +1432,9 @@ printers that have no resident fonts, i.e., very rarely. </p> </dd> -<dt>‘<samp>-x <var>num</var></samp>’</dt> -<dd><span id="index-_002dx-num"></span> -<span id="index-magnification_002c-overriding-DVI"></span> -<p>Set the magnification ratio to <em><var>num</var>/1000</em>. Overrides +<dt id='index-_002dx-num'><span>‘<samp>-x <var>num</var></samp>’<a href='#index-_002dx-num' class='copiable-anchor'> ¶</a></span></dt> +<dd><span id="index-magnification_002c-overriding-DVI"></span> +<p>Set the magnification ratio to <em class='math'><var>num</var>/1000</em>. 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 @@ -1471,40 +1442,35 @@ number of PK files generated. <var>num</var> may be a real number, not an integer, for increased precision. </p> </dd> -<dt>‘<samp>-X <var>num</var></samp>’</dt> -<dd><span id="index-_002dX-num"></span> -<span id="index-resolution"></span> +<dt id='index-_002dX-num'><span>‘<samp>-X <var>num</var></samp>’<a href='#index-_002dX-num' class='copiable-anchor'> ¶</a></span></dt> +<dd><span id="index-resolution"></span> <p>Set the horizontal resolution in dots per inch to <var>num</var>. </p> </dd> -<dt>‘<samp>-y <var>num</var></samp>’</dt> -<dd><span id="index-magnification_002c-vertical"></span> -<p>Set the magnification ratio to <em><var>num</var>/1000</em> times the +<dt id='index-magnification_002c-vertical'><span>‘<samp>-y <var>num</var></samp>’<a href='#index-magnification_002c-vertical' class='copiable-anchor'> ¶</a></span></dt> +<dd><p>Set the magnification ratio to <em class='math'><var>num</var>/1000</em> times the magnification specified in the DVI file. See ‘<samp>-x</samp>’ above. </p> </dd> -<dt>‘<samp>-Y <var>num</var></samp>’</dt> -<dd><span id="index-_002dY-num"></span> -<p>Set the vertical resolution in dots per inch to <var>num.</var> +<dt id='index-_002dY-num'><span>‘<samp>-Y <var>num</var></samp>’<a href='#index-_002dY-num' class='copiable-anchor'> ¶</a></span></dt> +<dd><p>Set the vertical resolution in dots per inch to <var>num.</var> <span id="index-resolution-1"></span> </p> </dd> -<dt>‘<samp>-z*</samp>’</dt> -<dd><span id="index-_002dz-for-recognizing-hyperdvi"></span> -<span id="index-hyperdvi-extensions_002c-enabling"></span> +<dt id='index-_002dz-for-recognizing-hyperdvi'><span>‘<samp>-z*</samp>’<a href='#index-_002dz-for-recognizing-hyperdvi' class='copiable-anchor'> ¶</a></span></dt> +<dd><span id="index-hyperdvi-extensions_002c-enabling"></span> <span id="index-distillation_002c-and-_002dz"></span> <span id="index-PDF-files_002c-option-for"></span> <span id="index-html-specials_002c-and-_002dz"></span> <p>Pass ‘<samp>html</samp>’ 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>. +creating the output. See <a href="#Hypertext">HyperTeXt</a>. </p> </dd> -<dt>‘<samp>-Z*</samp>’</dt> -<dd><span id="index-_002dZ-for-compressing-bitmap-fonts"></span> -<span id="index-compressing-bitmap-fonts"></span> +<dt id='index-_002dZ-for-compressing-bitmap-fonts'><span>‘<samp>-Z*</samp>’<a href='#index-_002dZ-for-compressing-bitmap-fonts' class='copiable-anchor'> ¶</a></span></dt> +<dd><span id="index-compressing-bitmap-fonts"></span> <p>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 @@ -1516,9 +1482,12 @@ enabled in the configuration file (see <a href="#Configuration-file-commands">Co <hr> -<span id="Environment-variables"></span><div class="header"> +</div> +</div> +<div class="section" id="Environment-variables"> +<div class="header"> <p> -Next: <a href="#Config-files" accesskey="n" rel="next">Config files</a>, Previous: <a href="#Command_002dline-options" accesskey="p" rel="prev">Command-line options</a>, Up: <a href="#Invoking-Dvips" accesskey="u" rel="up">Invoking Dvips</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> +Next: <a href="#Config-files" accesskey="n" rel="next">Dvips configuration files</a>, Previous: <a href="#Command_002dline-options" accesskey="p" rel="prev">Command-line options</a>, Up: <a href="#Invoking-Dvips" accesskey="u" rel="up">Invoking Dvips</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> </div> <span id="Environment-variables-1"></span><h3 class="section">3.3 Environment variables</h3> @@ -1530,75 +1499,59 @@ 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="https://tug.org/texinfohtml/kpathsea.html#Path-specifications">Path specifications</a> in <cite>Kpathsea</cite>, for details of +<p>See <a data-manual="kpathsea" href="https://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. </p> <dl compact="compact"> -<dt><code>DVIPSDEBUG</code> -<span id="index-DVIPSDEBUG"></span> -</dt> +<dt id='index-DVIPSDEBUG'><span><code>DVIPSDEBUG</code><a href='#index-DVIPSDEBUG' class='copiable-anchor'> ¶</a></span></dt> <dd><span id="index-KPATHSEA_005fDEBUG"></span> <p>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 <code>KPATHSEA_DEBUG</code> to ‘<samp>-1</samp>’ -(see <a href="https://tug.org/texinfohtml/kpathsea.html#Debugging">Debugging</a> in <cite>Kpathsea</cite>). (If <code>KPATHSEA_DEBUG</code> is +(see <a data-manual="kpathsea" href="https://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> -<dt><code>DVIPSFONTS</code> -<span id="index-DVIPSFONTS"></span> -</dt> +<dt id='index-DVIPSFONTS'><span><code>DVIPSFONTS</code><a href='#index-DVIPSFONTS' class='copiable-anchor'> ¶</a></span></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="https://tug.org/texinfohtml/kpathsea.html#Supported-file-formats">Supported +config file options and other environment variables (see <a data-manual="kpathsea" href="https://tug.org/texinfohtml/kpathsea.html#Supported-file-formats">Supported file formats</a> in <cite>Kpathsea</cite>). </p> </dd> -<dt><code>DVIPSHEADERS</code> -<span id="index-DVIPSHEADERS"></span> -</dt> +<dt id='index-DVIPSHEADERS'><span><code>DVIPSHEADERS</code><a href='#index-DVIPSHEADERS' class='copiable-anchor'> ¶</a></span></dt> <dd><p>Default path to search for PostScript header files. Overrides the ‘<samp>H</samp>’ config file option (see <a href="#Configuration-file-commands">Configuration file commands</a>). </p> </dd> -<dt><code>DVIPSMAKEPK</code> -<span id="index-DVIPSMAKEPK"></span> -</dt> +<dt id='index-DVIPSMAKEPK'><span><code>DVIPSMAKEPK</code><a href='#index-DVIPSMAKEPK' class='copiable-anchor'> ¶</a></span></dt> <dd><span id="index-mktexpk_002c-changing-name"></span> <p>Overrides ‘<samp>mktexpk</samp>’ 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="https://tug.org/texinfohtml/kpathsea.html#MakeTeX-script-arguments">MakeTeX script arguments</a> in <cite>Kpathsea</cite>. +variable; see <a data-manual="kpathsea" href="https://tug.org/texinfohtml/kpathsea.html#MakeTeX-script-arguments">MakeTeX script arguments</a> in <cite>Kpathsea</cite>. </p> </dd> -<dt><code>DVIPSRC</code> -<span id="index-DVIPSRC"></span> -</dt> +<dt id='index-DVIPSRC'><span><code>DVIPSRC</code><a href='#index-DVIPSRC' class='copiable-anchor'> ¶</a></span></dt> <dd><p>Specifies the name of the startup file (see <a href="#Configuration-file-searching">Configuration file searching</a>) which is read after <samp>config.ps</samp> but before any printer-specific configuration files. </p> </dd> -<dt><code>DVIPSSIZES</code> -<span id="index-DVIPSSIZES"></span> -</dt> +<dt id='index-DVIPSSIZES'><span><code>DVIPSSIZES</code><a href='#index-DVIPSSIZES' class='copiable-anchor'> ¶</a></span></dt> <dd><span id="index-last_002dresort-font-scaling_002c-with-DVIPSSIZES"></span> <p>Last-resort sizes for scaling of unfound fonts. Overrides the ‘<samp>R</samp>’ definition in config files (see <a href="#Configuration-file-commands">Configuration file commands</a>). </p> </dd> -<dt><code>PRINTER</code> -<span id="index-PRINTER"></span> -</dt> +<dt id='index-PRINTER'><span><code>PRINTER</code><a href='#index-PRINTER' class='copiable-anchor'> ¶</a></span></dt> <dd><p>Determine the default printer configuration file. (Dvips itself does not use <code>PRINTER</code> to determine the output destination in any way.) </p> </dd> -<dt><code>TEXCONFIG</code> -<span id="index-TEXCONFIG"></span> -</dt> +<dt id='index-TEXCONFIG'><span><code>TEXCONFIG</code><a href='#index-TEXCONFIG' class='copiable-anchor'> ¶</a></span></dt> <dd><span id="index-configuration-file-path"></span> <p>Path to search for Dvips’ <samp>config.<var>printer</var></samp> configuration files, including the base <samp>config.ps</samp>. Using this single @@ -1608,19 +1561,19 @@ on MS-DOS, but <samp>config.ps</samp> is called by that name on all platforms.) </p> </dd> -<dt><code>TEXPICTS</code> -<span id="index-TEXPICTS"></span> -</dt> +<dt id='index-TEXPICTS'><span><code>TEXPICTS</code><a href='#index-TEXPICTS' class='copiable-anchor'> ¶</a></span></dt> <dd><p>Path to search for included graphics files. Overrides the ‘<samp>S</samp>’ 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="https://tug.org/texinfohtml/kpathsea.html#Supported-file-formats">Supported file formats</a> in <cite>Kpathsea</cite>. +<code>TEXINPUTS</code> is looked for. See <a data-manual="kpathsea" href="https://tug.org/texinfohtml/kpathsea.html#Supported-file-formats">Supported file formats</a> in <cite>Kpathsea</cite>. </p> </dd> </dl> <hr> -<span id="Config-files"></span><div class="header"> +</div> +<div class="section" id="Config-files"> +<div class="header"> <p> Previous: <a href="#Environment-variables" accesskey="p" rel="prev">Environment variables</a>, Up: <a href="#Invoking-Dvips" accesskey="u" rel="up">Invoking Dvips</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> </div> @@ -1632,23 +1585,22 @@ 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="https://tug.org/texinfohtml/kpathsea.html#Config-files">Config files</a> in <cite>Kpathsea</cite>). +(see <a data-manual="kpathsea" href="https://tug.org/texinfohtml/kpathsea.html#Config-files">Config files</a> in <cite>Kpathsea</cite>). </p> <p>For information about installing these files, including a prototype file -you can copy, see <a href="#config_002eps-installation">config.ps installation</a>. +you can copy, see <a href="#config_002eps-installation"><samp>config.ps</samp> installation</a>. </p> -<table class="menu" border="0" cellspacing="0"> -<tr><td align="left" valign="top">• <a href="#Configuration-file-searching" accesskey="1">Configuration file searching</a></td><td> </td><td align="left" valign="top">Where config.* files are searched for. -</td></tr> -<tr><td align="left" valign="top">• <a href="#Configuration-file-commands" accesskey="2">Configuration file commands</a></td><td> </td><td align="left" valign="top">What can go in a config.* file. -</td></tr> -</table> +<ul class="section-toc"> +<li><a href="#Configuration-file-searching" accesskey="1">Configuration file searching</a></li> +<li><a href="#Configuration-file-commands" accesskey="2">Configuration file commands</a></li> +</ul> <hr> -<span id="Configuration-file-searching"></span><div class="header"> +<div class="subsection" id="Configuration-file-searching"> +<div class="header"> <p> -Next: <a href="#Configuration-file-commands" accesskey="n" rel="next">Configuration file commands</a>, Up: <a href="#Config-files" accesskey="u" rel="up">Config files</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> +Next: <a href="#Configuration-file-commands" accesskey="n" rel="next">Configuration file commands</a>, Up: <a href="#Config-files" accesskey="u" rel="up">Dvips configuration files</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> </div> <span id="Configuration-file-searching-1"></span><h4 class="subsection">3.4.1 Configuration file searching</h4> @@ -1663,7 +1615,7 @@ or individually by each user. <li> <span id="index-config_002eps_002c-searched-for"></span> 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="https://tug.org/texinfohtml/kpathsea.html#Supported-file-formats">Supported file formats</a> in <cite>Kpathsea</cite>. +<a data-manual="kpathsea" href="https://tug.org/texinfohtml/kpathsea.html#Supported-file-formats">Supported file formats</a> in <cite>Kpathsea</cite>. </li><li> <span id="index-_002edvipsrc_002c-searched-for"></span> A user-specific startup file is loaded, so individual users can override @@ -1675,7 +1627,7 @@ the name <samp>$HOME/.dvipsrc</samp>, which is in the user’s home director On MS-DOS and MS-Windows, where users generally don’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="https://tug.org/texinfohtml/kpathsea.html#Supported-file-formats">Supported file formats</a> in <cite>Kpathsea</cite>.); users are +in <a data-manual="kpathsea" href="https://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> <span id="index-_002dPprinter_002c-and-config-file-searching"></span> @@ -1707,19 +1659,19 @@ configuration files to be found before the system’s. overridden by configuration files: </p> <dl compact="compact"> -<dt>‘<samp>-D</samp>’</dt> +<dt><span>‘<samp>-D</samp>’</span></dt> <dd><p>As well as setting the resolution, this unsets the mode, if the mode was previously set from a configuration file. If <samp>config.$PRINTER</samp> is read, however, any ‘<samp>D</samp>’ or ‘<samp>M</samp>’ lines from there will take effect. </p> </dd> -<dt>‘<samp>-mode</samp>’</dt> +<dt><span>‘<samp>-mode</samp>’</span></dt> <dd><p>This overrides any mode setting (‘<samp>M</samp>’ line) in configuration files. ‘<samp>-mode</samp>’ does not affect the resolution. </p> </dd> -<dt>‘<samp>-o</samp>’</dt> +<dt><span>‘<samp>-o</samp>’</span></dt> <dd><p>This overrides any output setting (‘<samp>o</samp>’ line) in configuration files. </p> </dd> @@ -1732,9 +1684,11 @@ possible. </p> <hr> -<span id="Configuration-file-commands"></span><div class="header"> +</div> +<div class="subsection" id="Configuration-file-commands"> +<div class="header"> <p> -Previous: <a href="#Configuration-file-searching" accesskey="p" rel="prev">Configuration file searching</a>, Up: <a href="#Config-files" accesskey="u" rel="up">Config files</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> +Previous: <a href="#Configuration-file-searching" accesskey="p" rel="prev">Configuration file searching</a>, Up: <a href="#Config-files" accesskey="u" rel="up">Dvips configuration files</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> </div> <span id="Configuration-file-commands-1"></span><h4 class="subsection">3.4.2 Configuration file commands</h4> @@ -1755,47 +1709,39 @@ space, asterisk, equal sign, percent sign, or pound sign are ignored. There is no provision for continuation lines. </p> <dl compact="compact"> -<dt>‘<samp>@ <var>name hsize vsize</var></samp>’</dt> -<dd><span id="index-_0040-config-command-_0028define-paper-sizes_0029"></span> -<p>Define paper sizes. See <a href="#Config-file-paper-sizes">Config file paper sizes</a>. +<dt id='index-_0040-config-command-_0028define-paper-sizes_0029'><span>‘<samp>@ <var>name hsize vsize</var></samp>’<a href='#index-_0040-config-command-_0028define-paper-sizes_0029' class='copiable-anchor'> ¶</a></span></dt> +<dd><p>Define paper sizes. See <a href="#Config-file-paper-sizes">Configuration file paper size command</a>. </p> </dd> -<dt>‘<samp>a*</samp>’</dt> -<dd><span id="index-a-config-command-_0028conserve-memory_0029"></span> -<p>Memory conservation. Same as ‘<samp>-a</samp>’, see <a href="#Option-details">Option details</a>. +<dt id='index-a-config-command-_0028conserve-memory_0029'><span>‘<samp>a*</samp>’<a href='#index-a-config-command-_0028conserve-memory_0029' class='copiable-anchor'> ¶</a></span></dt> +<dd><p>Memory conservation. Same as ‘<samp>-a</samp>’, see <a href="#Option-details">Option details</a>. </p> </dd> -<dt>‘<samp>b <var>#copies</var></samp>’</dt> -<dd><span id="index-b-config-command-_0028_0023copies_0029"></span> -<p>Multiple copies. Same as ‘<samp>-b</samp>’, see <a href="#Option-details">Option details</a>. +<dt id='index-b-config-command-_0028_0023copies_0029'><span>‘<samp>b <var>#copies</var></samp>’<a href='#index-b-config-command-_0028_0023copies_0029' class='copiable-anchor'> ¶</a></span></dt> +<dd><p>Multiple copies. Same as ‘<samp>-b</samp>’, see <a href="#Option-details">Option details</a>. </p> </dd> -<dt>‘<samp>bitmapfontenc <var>option</var></samp>’</dt> -<dd><span id="index-bitmapfontenc-config-command-_0028bitmap-font-encoding_0029"></span> -<p>Turns bitmap font encoding to ‘<samp>off</samp>’, ‘<samp>on</samp>’ (no warnings +<dt id='index-bitmapfontenc-config-command-_0028bitmap-font-encoding_0029'><span>‘<samp>bitmapfontenc <var>option</var></samp>’<a href='#index-bitmapfontenc-config-command-_0028bitmap-font-encoding_0029' class='copiable-anchor'> ¶</a></span></dt> +<dd><p>Turns bitmap font encoding to ‘<samp>off</samp>’, ‘<samp>on</samp>’ (no warnings for missing bitmap font encodings), or ‘<samp>strict</samp>’ (with warnings for missing bitmap font encodings). </p> </dd> -<dt>‘<samp>c <var>filename</var></samp>’</dt> -<dd><span id="index-c-config-command-_0028include-another-config-file_0029"></span> -<p>Include <var>filename</var> as an additional configuration file, read +<dt id='index-c-config-command-_0028include-another-config-file_0029'><span>‘<samp>c <var>filename</var></samp>’<a href='#index-c-config-command-_0028include-another-config-file_0029' class='copiable-anchor'> ¶</a></span></dt> +<dd><p>Include <var>filename</var> as an additional configuration file, read immediately. </p> </dd> -<dt>‘<samp>D <var>dpi</var></samp>’</dt> -<dd><span id="index-D-config-command-_0028dpi_0029"></span> -<p>Output resolution. Same as ‘<samp>-D</samp>’, see <a href="#Option-details">Option details</a>. +<dt id='index-D-config-command-_0028dpi_0029'><span>‘<samp>D <var>dpi</var></samp>’<a href='#index-D-config-command-_0028dpi_0029' class='copiable-anchor'> ¶</a></span></dt> +<dd><p>Output resolution. Same as ‘<samp>-D</samp>’, see <a href="#Option-details">Option details</a>. </p> </dd> -<dt>‘<samp>e <var>num</var></samp>’</dt> -<dd><span id="index-e-config-command-_0028maxdrift_0029"></span> -<p>Max drift. Same as ‘<samp>-e</samp>’, see <a href="#Option-details">Option details</a>. +<dt id='index-e-config-command-_0028maxdrift_0029'><span>‘<samp>e <var>num</var></samp>’<a href='#index-e-config-command-_0028maxdrift_0029' class='copiable-anchor'> ¶</a></span></dt> +<dd><p>Max drift. Same as ‘<samp>-e</samp>’, see <a href="#Option-details">Option details</a>. </p> </dd> -<dt>‘<samp>E <var>command</var></samp>’</dt> -<dd><span id="index-E-config-command-_0028shell-escape_0029"></span> -<span id="index-system-in-config-file"></span> +<dt id='index-E-config-command-_0028shell-escape_0029'><span>‘<samp>E <var>command</var></samp>’<a href='#index-E-config-command-_0028shell-escape_0029' class='copiable-anchor'> ¶</a></span></dt> +<dd><span id="index-system-in-config-file"></span> <span id="index-datestamp_002c-in-output"></span> <span id="index-shell-escape_002c-in-config-file"></span> <p>Executes the command listed with <code>system</code>(3); can be used to get @@ -1804,57 +1750,55 @@ Possibly dangerous; this may be disabled, in which case a warning will be printed if the option is used (and warnings are not suppressed). </p> </dd> -<dt>‘<samp>f*</samp>’</dt> -<dt>‘<samp>F</samp>’</dt> -<dd><span id="index-f-config-command-_0028filter_0029"></span> -<span id="index-F-config-command-_0028filter_0029"></span> +<dt id='index-f-config-command-_0028filter_0029'><span>‘<samp>f*</samp>’<a href='#index-f-config-command-_0028filter_0029' class='copiable-anchor'> ¶</a></span></dt> +<dt><span>‘<samp>F</samp>’</span></dt> +<dd><span id="index-F-config-command-_0028filter_0029"></span> <p>Run as a filter. Same as ‘<samp>-f</samp>’, see <a href="#Option-details">Option details</a>. </p> </dd> -<dt>‘<samp>G*</samp>’</dt> -<dd><span id="index-G-config-command-_0028character-shifting_0029"></span> -<p>Shift low-numbered characters; obsolete. Same as ‘<samp>-G</samp>’, +<dt id='index-G-config-command-_0028character-shifting_0029'><span>‘<samp>G*</samp>’<a href='#index-G-config-command-_0028character-shifting_0029' class='copiable-anchor'> ¶</a></span></dt> +<dd><p>Shift low-numbered characters; obsolete. Same as ‘<samp>-G</samp>’, see <a href="#Option-details">Option details</a>. </p> </dd> -<dt>‘<samp>h <var>header</var></samp>’</dt> -<dd><span id="index-h-config-command-_0028download-additional-header_0029"></span> -<p>Prepend <var>header</var> to output. Same as ‘<samp>h-</samp>’, see <a href="#Option-details">Option details</a>. +<dt id='index-h-config-command-_0028download-additional-header_0029'><span>‘<samp>h <var>header</var></samp>’<a href='#index-h-config-command-_0028download-additional-header_0029' class='copiable-anchor'> ¶</a></span></dt> +<dd><p>Prepend <var>header</var> to output. Same as ‘<samp>h-</samp>’; that is, the +config file <code>h</code> directive suppresses any inclusion of standard +headers (see <a href="#Option-details">Option details</a>). </p> </dd> -<dt>‘<samp>H <var>path</var></samp>’</dt> -<dd><span id="index-H-config-command-_0028PostScript-header-path_0029"></span> -<span id="index-header-path_002c-defining"></span> +<dt id='index-H-config-command-_0028PostScript-header-path_0029'><span>‘<samp>H <var>path</var></samp>’<a href='#index-H-config-command-_0028PostScript-header-path_0029' class='copiable-anchor'> ¶</a></span></dt> +<dd><span id="index-header-path_002c-defining"></span> <span id="index-DVIPSHEADERS_002c-overrides-H"></span> <p>Use <var>path</var> to search for PostScript header files. The environment variable <code>DVIPSHEADERS</code> overrides this. </p> </dd> -<dt>‘<samp>i <var>n</var></samp>’</dt> -<dd><span id="index-i-config-command-_0028pages_002fsection_0029"></span> -<p>Make multiple output files. Same as ‘<samp>-i -S <var>n</var></samp>’, see <a href="#Option-details">Option details</a>. +<dt id='index-i-config-command-_0028pages_002fsection_0029'><span>‘<samp>i <var>n</var></samp>’<a href='#index-i-config-command-_0028pages_002fsection_0029' class='copiable-anchor'> ¶</a></span></dt> +<dd><p>Make multiple output files. Same as ‘<samp>-i -S <var>n</var></samp>’, see <a href="#Option-details">Option details</a>. </p> </dd> -<dt>‘<samp>j*</samp>’</dt> -<dd><span id="index-j-config-command-_0028partial-font-downloading_0029"></span> -<p>Partially download Type 1 fonts. Same as ‘<samp>-j</samp>’, see <a href="#Option-details">Option details</a>. +<dt id='index-j-config-command-_0028partial-font-downloading_0029'><span>‘<samp>j*</samp>’<a href='#index-j-config-command-_0028partial-font-downloading_0029' class='copiable-anchor'> ¶</a></span></dt> +<dd><p>Partially download Type 1 fonts. Same as ‘<samp>-j</samp>’, see <a href="#Option-details">Option details</a>. </p> </dd> -<dt>‘<samp>K*</samp>’</dt> -<dd><span id="index-K-config-command-_0028comment-removal_0029"></span> -<p>Remove comments from included PostScript files. Same as ‘<samp>-K</samp>’, +<dt id='index-K-config-command-_0028comment-removal_0029'><span>‘<samp>K*</samp>’<a href='#index-K-config-command-_0028comment-removal_0029' class='copiable-anchor'> ¶</a></span></dt> +<dd><p>Remove comments from included PostScript files. Same as ‘<samp>-K</samp>’, see <a href="#Option-details">Option details</a>. </p> </dd> -<dt>‘<samp>L*</samp>’</dt> -<dd><span id="index-L-config-command-_0028last-paper-size-wins_0029"></span> -<p>If zero, the first paper size specified is effective, else the last. +<dt id='index-L-config-command-_0028last-paper-size-wins_0029'><span>‘<samp>L*</samp>’<a href='#index-L-config-command-_0028last-paper-size-wins_0029' class='copiable-anchor'> ¶</a></span></dt> +<dd><p>If zero, the first paper size specified is effective, else the last. Same as ‘<samp>-L</samp>’, see <a href="#Option-details">Option details</a>. </p> </dd> -<dt>‘<samp>m <var>num</var></samp>’</dt> -<dd><span id="index-m-config-command-_0028available-memory_0029"></span> -<span id="index-memory-available"></span> +<dt id='index-landscaperotate-config-command'><span>‘<samp>landscaperotate</samp>’<a href='#index-landscaperotate-config-command' class='copiable-anchor'> ¶</a></span></dt> +<dd><p>Permit rotation of page content to match page size. +Same as ‘<samp>-landscaperotate</samp>’, see <a href="#Option-details">Option details</a>. +</p> +</dd> +<dt id='index-m-config-command-_0028available-memory_0029'><span>‘<samp>m <var>num</var></samp>’<a href='#index-m-config-command-_0028available-memory_0029' class='copiable-anchor'> ¶</a></span></dt> +<dd><span id="index-memory-available"></span> <span id="index-printer-memory"></span> <p>Declare <var>num</var> as the memory available for fonts and strings in the printer. The compile-time default is 180000, but this is typically @@ -1886,21 +1830,18 @@ splitting of the output is desirable. The Dvips config file ‘<samp>dvips -Pmaxmem</samp>’. </p> </dd> -<dt>‘<samp>M <var>mode</var></samp>’</dt> -<dd><span id="index-M-config-command-_0028mf-mode_0029"></span> -<p>Metafont mode. Same as ‘<samp>-mode</samp>’, see <a href="#Option-details">Option details</a>. +<dt id='index-M-config-command-_0028mf-mode_0029'><span>‘<samp>M <var>mode</var></samp>’<a href='#index-M-config-command-_0028mf-mode_0029' class='copiable-anchor'> ¶</a></span></dt> +<dd><p>Metafont mode. Same as ‘<samp>-mode</samp>’, see <a href="#Option-details">Option details</a>. </p> </dd> -<dt>‘<samp>N*</samp>’</dt> -<dd><span id="index-N--config-command-_0028disable-EPS_0029"></span> -<p>Disable structured comments. Beware: This also turns off displaying -page numbers or changing to specific pagenumbers in PostScript viewers. +<dt id='index-N--config-command-_0028disable-EPS_0029'><span>‘<samp>N*</samp>’<a href='#index-N--config-command-_0028disable-EPS_0029' class='copiable-anchor'> ¶</a></span></dt> +<dd><p>Disable structured comments. Beware: This also turns off displaying +page numbers or changing to specific page numbers in PostScript viewers. Same as ‘<samp>-N</samp>’, see <a href="#Option-details">Option details</a>. </p> </dd> -<dt>‘<samp>o <var>name</var></samp>’</dt> -<dd><span id="index-o-config-command-_0028output-destination_0029"></span> -<span id="index-output-file_002c-setting"></span> +<dt id='index-o-config-command-_0028output-destination_0029'><span>‘<samp>o <var>name</var></samp>’<a href='#index-o-config-command-_0028output-destination_0029' class='copiable-anchor'> ¶</a></span></dt> +<dd><span id="index-output-file_002c-setting"></span> <p>Send output to <var>name</var>. Same as ‘<samp>-o</samp>’, see <a href="#Option-details">Option details</a>. In the file <samp>config.foo</samp>, a setting like this is probably appropriate: @@ -1912,14 +1853,12 @@ the local printer device <samp>PRN</samp> if it doesn’t find an executable program by that name in the current directory or along the <code>PATH</code>. </p> </dd> -<dt>‘<samp>O <var>xoff</var>,<var>yoff</var></samp>’</dt> -<dd><span id="index-O-config-command-_0028page-offsets_0029"></span> -<p>Origin offset. Same as ‘<samp>-O</samp>’, see <a href="#Option-details">Option details</a>. +<dt id='index-O-config-command-_0028page-offsets_0029'><span>‘<samp>O <var>xoff</var>,<var>yoff</var></samp>’<a href='#index-O-config-command-_0028page-offsets_0029' class='copiable-anchor'> ¶</a></span></dt> +<dd><p>Origin offset. Same as ‘<samp>-O</samp>’, see <a href="#Option-details">Option details</a>. </p> </dd> -<dt>‘<samp>p <span class="roman">[+]</span><var>name</var></samp>’</dt> -<dd><span id="index-p-config-command-_0028font-aliases_0029"></span> -<span id="index-PostScript-font-alias-file-1"></span> +<dt id='index-p-config-command-_0028font-aliases_0029'><span>‘<samp>p <span class="roman">[+]</span><var>name</var></samp>’<a href='#index-p-config-command-_0028font-aliases_0029' class='copiable-anchor'> ¶</a></span></dt> +<dd><span id="index-PostScript-font-alias-file-1"></span> <span id="index-resident-fonts_002c-different-in-different-printers-1"></span> <span id="index-_002bpsmapfile"></span> <p>Examine <var>name</var> for PostScript font aliases. Default is @@ -1931,32 +1870,28 @@ map files pointed to by local configuration files that append to the global map file. This can be used for font families. </p> </dd> -<dt>‘<samp>P <var>path</var></samp>’</dt> -<dd><span id="index-P-config-command-_0028PK-path_0029"></span> -<span id="index-PKFONTS_002c-overrides-P"></span> +<dt id='index-P-config-command-_0028PK-path_0029'><span>‘<samp>P <var>path</var></samp>’<a href='#index-P-config-command-_0028PK-path_0029' class='copiable-anchor'> ¶</a></span></dt> +<dd><span id="index-PKFONTS_002c-overrides-P"></span> <span id="index-TEXPKS_002c-overrides-P"></span> <span id="index-GLYPHFONTS_002c-overrides-P"></span> <span id="index-TEXFONTS_002c-overrides-P"></span> <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="https://tug.org/texinfohtml/kpathsea.html#Supported-file-formats">Supported file formats</a> in <cite>Kpathsea</cite>. +environment variables override this. See <a data-manual="kpathsea" href="https://tug.org/texinfohtml/kpathsea.html#Supported-file-formats">Supported file formats</a> in <cite>Kpathsea</cite>. </p> </dd> -<dt>‘<samp>q*</samp>’</dt> -<dt>‘<samp>Q</samp>’</dt> -<dd><span id="index-q-config-command-_0028quiet_0029"></span> -<span id="index-Q-config-command-_0028quiet_0029"></span> +<dt id='index-q-config-command-_0028quiet_0029'><span>‘<samp>q*</samp>’<a href='#index-q-config-command-_0028quiet_0029' class='copiable-anchor'> ¶</a></span></dt> +<dt><span>‘<samp>Q</samp>’</span></dt> +<dd><span id="index-Q-config-command-_0028quiet_0029"></span> <p>Run quietly. Same as ‘<samp>-q</samp>’, see <a href="#Option-details">Option details</a>. </p> </dd> -<dt>‘<samp>r*</samp>’</dt> -<dd><span id="index-r-config-command-_0028page-reversal_0029"></span> -<p>Page reversal. Same as ‘<samp>-r</samp>’, see <a href="#Option-details">Option details</a>. +<dt id='index-r-config-command-_0028page-reversal_0029'><span>‘<samp>r*</samp>’<a href='#index-r-config-command-_0028page-reversal_0029' class='copiable-anchor'> ¶</a></span></dt> +<dd><p>Page reversal. Same as ‘<samp>-r</samp>’, see <a href="#Option-details">Option details</a>. </p> </dd> -<dt>‘<samp>R <var>num1 num2 …</var></samp>’</dt> -<dd><span id="index-R-config-command-_0028fallback-resolution_0029"></span> -<span id="index-fallback-resolutions"></span> +<dt id='index-R-config-command-_0028fallback-resolution_0029'><span>‘<samp>R <var>num1 num2 …</var></samp>’<a href='#index-R-config-command-_0028fallback-resolution_0029' class='copiable-anchor'> ¶</a></span></dt> +<dd><span id="index-fallback-resolutions"></span> <span id="index-default-resolutions"></span> <span id="index-last_002dresort-scaling_002c-with-R"></span> <p>Define the list of default resolutions for PK fonts. If a font size @@ -1983,46 +1918,40 @@ the Makefile variable ‘<samp>default_texsizes</samp>’, defined in th <samp>make/paths.make</samp>. </p> </dd> -<dt>‘<samp>s*</samp>’</dt> -<dd><span id="index-s-config-command-_0028global-save_002frestore_0029"></span> -<p>Output global save/restore. Same as ‘<samp>-s</samp>’, see <a href="#Option-details">Option details</a>. +<dt id='index-s-config-command-_0028global-save_002frestore_0029'><span>‘<samp>s*</samp>’<a href='#index-s-config-command-_0028global-save_002frestore_0029' class='copiable-anchor'> ¶</a></span></dt> +<dd><p>Output global save/restore. Same as ‘<samp>-s</samp>’, see <a href="#Option-details">Option details</a>. </p> </dd> -<dt>‘<samp>S <var>path</var></samp>’</dt> -<dd><span id="index-S-config-command-_0028pict-path_0029"></span> -<span id="index-TEXPICTS_002c-overrides-S"></span> +<dt id='index-S-config-command-_0028pict-path_0029'><span>‘<samp>S <var>path</var></samp>’<a href='#index-S-config-command-_0028pict-path_0029' class='copiable-anchor'> ¶</a></span></dt> +<dd><span id="index-TEXPICTS_002c-overrides-S"></span> <span id="index-TEXINPUTS_002c-overrides-S"></span> <p>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. </p> </dd> -<dt>‘<samp>T <var>path</var></samp>’</dt> -<dd><span id="index-T-config-command-_0028TFM-path_0029"></span> -<span id="index-TFMFONTS_002c-overrides-T"></span> +<dt id='index-T-config-command-_0028TFM-path_0029'><span>‘<samp>T <var>path</var></samp>’<a href='#index-T-config-command-_0028TFM-path_0029' class='copiable-anchor'> ¶</a></span></dt> +<dd><span id="index-TFMFONTS_002c-overrides-T"></span> <span id="index-TEXFONTS_002c-overrides-T"></span> <p>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. </p> </dd> -<dt>‘<samp>U*</samp>’</dt> -<dd><span id="index-U-config-command-_0028Xerox-4045_0029"></span> -<p>Work around bug in Xerox 4045 printer. Same as ‘<samp>-U</samp>’, see <a href="#Option-details">Option details</a>. +<dt id='index-U-config-command-_0028Xerox-4045_0029'><span>‘<samp>U*</samp>’<a href='#index-U-config-command-_0028Xerox-4045_0029' class='copiable-anchor'> ¶</a></span></dt> +<dd><p>Work around bug in Xerox 4045 printer. Same as ‘<samp>-U</samp>’, see <a href="#Option-details">Option details</a>. </p> </dd> -<dt>‘<samp>V <var>path</var></samp>’</dt> -<dd><span id="index-V-config-command-_0028vf-path_0029"></span> -<span id="index-virtual-font-path"></span> +<dt id='index-V-config-command-_0028vf-path_0029'><span>‘<samp>V <var>path</var></samp>’<a href='#index-V-config-command-_0028vf-path_0029' class='copiable-anchor'> ¶</a></span></dt> +<dd><span id="index-virtual-font-path"></span> <span id="index-device-dependency_002c-and-virtual-fonts"></span> <p>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. </p> </dd> -<dt>‘<samp>W <span class="roman">[<var>string</var>]</span></samp>’</dt> -<dd><span id="index-W-config-command-_0028emit-warning_0029"></span> -<span id="index-warning-messages_002c-defining"></span> +<dt id='index-W-config-command-_0028emit-warning_0029'><span>‘<samp>W <span class="roman">[<var>string</var>]</span></samp>’<a href='#index-W-config-command-_0028emit-warning_0029' class='copiable-anchor'> ¶</a></span></dt> +<dd><span id="index-warning-messages_002c-defining"></span> <p>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 ‘<samp>W</samp>’ message. This is useful in the default configuration file to @@ -2030,24 +1959,20 @@ remind users to specify a printer, for instance, or to notify users about special characteristics of a particular printer. </p> </dd> -<dt>‘<samp>X <var>num</var></samp>’</dt> -<dd><span id="index-X-config-command-_0028horizontal-resolution_0029"></span> -<p>Horizontal resolution. Same as ‘<samp>-X</samp>’ (see <a href="#Option-details">Option details</a>). +<dt id='index-X-config-command-_0028horizontal-resolution_0029'><span>‘<samp>X <var>num</var></samp>’<a href='#index-X-config-command-_0028horizontal-resolution_0029' class='copiable-anchor'> ¶</a></span></dt> +<dd><p>Horizontal resolution. Same as ‘<samp>-X</samp>’ (see <a href="#Option-details">Option details</a>). </p> </dd> -<dt>‘<samp>Y <var>num</var></samp>’</dt> -<dd><span id="index-Y-config-command-_0028vertical-resolution_0029"></span> -<p>Vertical resolution. Same as ‘<samp>-Y</samp>’ (see <a href="#Option-details">Option details</a>). +<dt id='index-Y-config-command-_0028vertical-resolution_0029'><span>‘<samp>Y <var>num</var></samp>’<a href='#index-Y-config-command-_0028vertical-resolution_0029' class='copiable-anchor'> ¶</a></span></dt> +<dd><p>Vertical resolution. Same as ‘<samp>-Y</samp>’ (see <a href="#Option-details">Option details</a>). </p> </dd> -<dt>‘<samp>Z*</samp>’</dt> -<dd><span id="index-Z-config-command-_0028compress-fonts_0029"></span> -<p>Compress bitmap fonts. Same as ‘<samp>-Z</samp>’ (see <a href="#Option-details">Option details</a>). +<dt id='index-Z-config-command-_0028compress-fonts_0029'><span>‘<samp>Z*</samp>’<a href='#index-Z-config-command-_0028compress-fonts_0029' class='copiable-anchor'> ¶</a></span></dt> +<dd><p>Compress bitmap fonts. Same as ‘<samp>-Z</samp>’ (see <a href="#Option-details">Option details</a>). </p> </dd> -<dt>‘<samp>z*</samp>’</dt> -<dd><span id="index-z-config-command-_0028secure-mode_0029"></span> -<p>Disables execution of system commands, like ‘<samp>-R</samp>’ +<dt id='index-z-config-command-_0028secure-mode_0029'><span>‘<samp>z*</samp>’<a href='#index-z-config-command-_0028secure-mode_0029' class='copiable-anchor'> ¶</a></span></dt> +<dd><p>Disables execution of system commands, like ‘<samp>-R</samp>’ (see <a href="#Option-details">Option details</a>). If ‘<samp>-R</samp>’ is specified on the command line, that takes precedence. </p> @@ -2056,9 +1981,13 @@ on the command line, that takes precedence. <hr> -<span id="Paper-size-and-landscape"></span><div class="header"> +</div> +</div> +</div> +<div class="chapter" id="Paper-size-and-landscape"> +<div class="header"> <p> -Next: <a href="#Interaction-with-PostScript" accesskey="n" rel="next">Interaction with PostScript</a>, Previous: <a href="#Invoking-Dvips" accesskey="p" rel="prev">Invoking Dvips</a>, Up: <a href="#Top" accesskey="u" rel="up">Top</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> +Next: <a href="#Interaction-with-PostScript" accesskey="n" rel="next">Interaction with PostScript</a>, Previous: <a href="#Invoking-Dvips" accesskey="p" rel="prev">Invoking Dvips</a>, Up: <a href="#Top" accesskey="u" rel="up">Dvips</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> </div> <span id="Paper-size-and-landscape-orientation"></span><h2 class="chapter">4 Paper size and landscape orientation</h2> @@ -2090,20 +2019,18 @@ printer drivers. ‘<samp>papersize</samp>’ special into the DVI file. In this case, you need not and should not attempt to override it manually. </p> -<table class="menu" border="0" cellspacing="0"> -<tr><td align="left" valign="top">• <a href="#papersize-special" accesskey="1">‘<samp>papersize</samp>’ special</a></td><td> </td><td align="left" valign="top">Specifying the paper size in TeX. -</td></tr> -<tr><td align="left" valign="top">• <a href="#Config-file-paper-sizes" accesskey="2">Config file paper sizes</a></td><td> </td><td align="left" valign="top">Specifying printer- and site-specific sizes. -</td></tr> -<tr><td align="left" valign="top">• <a href="#Paper-trays" accesskey="3">Paper trays</a></td><td> </td><td align="left" valign="top">Changing paper trays automatically. -</td></tr> -</table> +<ul class="section-toc"> +<li><a href="#papersize-special" accesskey="1">‘<samp>papersize</samp>’ special</a></li> +<li><a href="#Config-file-paper-sizes" accesskey="2">Configuration file paper size command</a></li> +<li><a href="#Paper-trays" accesskey="3">Paper trays</a></li> +</ul> <hr> -<span id="papersize-special"></span><div class="header"> +<div class="section" id="papersize-special"> +<div class="header"> <p> -Next: <a href="#Config-file-paper-sizes" accesskey="n" rel="next">Config file paper sizes</a>, Up: <a href="#Paper-size-and-landscape" accesskey="u" rel="up">Paper size and landscape</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> +Next: <a href="#Config-file-paper-sizes" accesskey="n" rel="next">Configuration file paper size command</a>, Up: <a href="#Paper-size-and-landscape" accesskey="u" rel="up">Paper size and landscape orientation</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> </div> <span id="papersize-special-1"></span><h3 class="section">4.1 ‘<samp>papersize</samp>’ special</h3> @@ -2133,7 +2060,7 @@ unit), pc (picas), dd (didot points), and cc (ciceros). </pre></div> <p>This is supported for backward compatibility, but it is hoped that -reventually the ‘<samp>papersize</samp>’ comment will dominate. +eventually the ‘<samp>papersize</samp>’ comment will dominate. </p> <p>Of course, such a <code>\special</code> only informs Dvips of the desired paper size; you must also adjust <code>\hsize</code> and <code>\vsize</code> in your @@ -2156,9 +2083,11 @@ behavior of Dvips prior to the 2017 release. </p> <hr> -<span id="Config-file-paper-sizes"></span><div class="header"> +</div> +<div class="section" id="Config-file-paper-sizes"> +<div class="header"> <p> -Next: <a href="#Paper-trays" accesskey="n" rel="next">Paper trays</a>, Previous: <a href="#papersize-special" accesskey="p" rel="prev">‘<samp>papersize</samp>’ special</a>, Up: <a href="#Paper-size-and-landscape" accesskey="u" rel="up">Paper size and landscape</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> +Next: <a href="#Paper-trays" accesskey="n" rel="next">Paper trays</a>, Previous: <a href="#papersize-special" accesskey="p" rel="prev">‘<samp>papersize</samp>’ special</a>, Up: <a href="#Paper-size-and-landscape" accesskey="u" rel="up">Paper size and landscape orientation</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> </div> <span id="Configuration-file-paper-size-command"></span><h3 class="section">4.2 Configuration file paper size command</h3> @@ -2226,8 +2155,26 @@ zero dimensions is used; this should be the <code>unknown</code> paper size definition mentioned below, resulting in the actual dimensions being used. </p> -<p>Landscape mode for all paper sizes is automatically supported. -</p> +<span id="index-landscaperotate-configuration-file-command"></span> +<span id="index-landscaperotate-command-line-option"></span> +<p>In versions of Dvips prior to 2022.1, if the paper size specified did +not match one of the defined paper sizes, Dvips considered rotated +page content and rotated paper sizes for a match. This provided some +automatic support for landscape mode on raw printers, but today it can +be harmful when generating PDF. (Specifically, the ‘<samp>/MediaBox</samp>’ +then ends up with rotated values, which is not expected by PDF +viewers, e.g., when a document intentionally has a single page +rotated.) +</p> +<p>Further, on all recent computer systems, this facility is typically +provided instead by a print spooler that considers the bounding box of +the document and inserts appropriate media selection commands as part +of the print job. So, this automatic rotation is no longer done by +default by Dvips. If you want to enable it, the +‘<samp>-landscaperotate</samp>’ command line option or ‘<samp>landscaperotate</samp>’ +configuration file option can be used. See <a href="#Option-details">Option details</a>. +</p> +<span id="index-zero-dimensions-and-setting-paper-size"></span> <p>If your printer has a command to set a special paper size, then give dimensions of ‘<samp>0in 0in</samp>’; the PostScript code that sets the paper size can refer to the dimensions the user requested as ‘<samp>hsize</samp>’ @@ -2275,9 +2222,11 @@ synonyms for <code>letter</code> and <code>a4</code>. </p> <hr> -<span id="Paper-trays"></span><div class="header"> +</div> +<div class="section" id="Paper-trays"> +<div class="header"> <p> -Previous: <a href="#Config-file-paper-sizes" accesskey="p" rel="prev">Config file paper sizes</a>, Up: <a href="#Paper-size-and-landscape" accesskey="u" rel="up">Paper size and landscape</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> +Previous: <a href="#Config-file-paper-sizes" accesskey="p" rel="prev">Configuration file paper size command</a>, Up: <a href="#Paper-size-and-landscape" accesskey="u" rel="up">Paper size and landscape orientation</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> </div> <span id="Paper-trays-1"></span><h3 class="section">4.3 Paper trays</h3> @@ -2322,9 +2271,12 @@ commands to select the paper trays. On the 4SI, <var>alternatetray</var> is <hr> -<span id="Interaction-with-PostScript"></span><div class="header"> +</div> +</div> +<div class="chapter" id="Interaction-with-PostScript"> +<div class="header"> <p> -Next: <a href="#PostScript-fonts" accesskey="n" rel="next">PostScript fonts</a>, Previous: <a href="#Paper-size-and-landscape" accesskey="p" rel="prev">Paper size and landscape</a>, Up: <a href="#Top" accesskey="u" rel="up">Top</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> +Next: <a href="#PostScript-fonts" accesskey="n" rel="next">PostScript fonts</a>, Previous: <a href="#Paper-size-and-landscape" accesskey="p" rel="prev">Paper size and landscape orientation</a>, Up: <a href="#Top" accesskey="u" rel="up">Dvips</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> </div> <span id="Interaction-with-PostScript-1"></span><h2 class="chapter">5 Interaction with PostScript</h2> @@ -2335,22 +2287,19 @@ Next: <a href="#PostScript-fonts" accesskey="n" rel="next">PostScript fonts</a>, PostScript), downloading other header files (e.g., fonts), including literal PostScript code, and hypertext. </p> -<table class="menu" border="0" cellspacing="0"> -<tr><td align="left" valign="top">• <a href="#PostScript-figures" accesskey="1">PostScript figures</a></td><td> </td><td align="left" valign="top">Including an Encapsulated PostScript figure. -</td></tr> -<tr><td align="left" valign="top">• <a href="#Header-files" accesskey="2">Header files</a></td><td> </td><td align="left" valign="top">Downloading extra definitions. -</td></tr> -<tr><td align="left" valign="top">• <a href="#Literal-PS" accesskey="3">Literal PS</a></td><td> </td><td align="left" valign="top">Writing literal PostScript code. -</td></tr> -<tr><td align="left" valign="top">• <a href="#Hypertext" accesskey="4">Hypertext</a></td><td> </td><td align="left" valign="top">Producing HyperPostScript to make PDF. -</td></tr> -</table> +<ul class="section-toc"> +<li><a href="#PostScript-figures" accesskey="1">PostScript figures</a></li> +<li><a href="#Header-files" accesskey="2">PostScript header files</a></li> +<li><a href="#Literal-PS" accesskey="3">Literal PostScript</a></li> +<li><a href="#Hypertext" accesskey="4">HyperTeXt</a></li> +</ul> <hr> -<span id="PostScript-figures"></span><div class="header"> +<div class="section" id="PostScript-figures"> +<div class="header"> <p> -Next: <a href="#Header-files" accesskey="n" rel="next">Header files</a>, Up: <a href="#Interaction-with-PostScript" accesskey="u" rel="up">Interaction with PostScript</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> +Next: <a href="#Header-files" accesskey="n" rel="next">PostScript header files</a>, Up: <a href="#Interaction-with-PostScript" accesskey="u" rel="up">Interaction with PostScript</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> </div> <span id="PostScript-figures-1"></span><h3 class="section">5.1 PostScript figures</h3> @@ -2358,26 +2307,21 @@ Next: <a href="#Header-files" accesskey="n" rel="next">Header files</a>, Up: <a file is correctly formed. Even if it is not, however, the file can usually be accommodated with just a little more work. </p> -<table class="menu" border="0" cellspacing="0"> -<tr><td align="left" valign="top">• <a href="#Bounding-box" accesskey="1">Bounding box</a></td><td> </td><td align="left" valign="top">The %%BoundingBox EPS comment. -</td></tr> -<tr><td align="left" valign="top">• <a href="#g_t_005cincludegraphics" accesskey="2">\includegraphics</a></td><td> </td><td align="left" valign="top">The LaTeX \includegraphics macro. -</td></tr> -<tr><td align="left" valign="top">• <a href="#EPSF-macros" accesskey="3">EPSF macros</a></td><td> </td><td align="left" valign="top">Including the file in TeX. -</td></tr> -<tr><td align="left" valign="top">• <a href="#psfile-special" accesskey="4">psfile special</a></td><td> </td><td align="left" valign="top">The basic special. -</td></tr> -<tr><td align="left" valign="top">• <a href="#Dynamic-creation-of-graphics" accesskey="5">Dynamic creation of graphics</a></td><td> </td><td align="left" valign="top">Handling compressed or generated figures. -</td></tr> -<tr><td align="left" valign="top">• <a href="#Fonts-in-figures" accesskey="6">Fonts in figures</a></td><td> </td><td align="left" valign="top">The %*Font comment. -</td></tr> -</table> +<ul class="section-toc"> +<li><a href="#Bounding-box" accesskey="1">The bounding box comment</a></li> +<li><a href="#g_t_005cincludegraphics" accesskey="2">The \includegraphics macro for LaTeX</a></li> +<li><a href="#EPSF-macros" accesskey="3">Using the EPSF macros</a></li> +<li><a href="#psfile-special" accesskey="4">‘<samp>psfile</samp>’ special</a></li> +<li><a href="#Dynamic-creation-of-graphics" accesskey="5">Dynamic creation of PostScript graphics files</a></li> +<li><a href="#Fonts-in-figures" accesskey="6">Fonts in figures</a></li> +</ul> <hr> -<span id="Bounding-box"></span><div class="header"> +<div class="subsection" id="Bounding-box"> +<div class="header"> <p> -Next: <a href="#g_t_005cincludegraphics" accesskey="n" rel="next">\includegraphics</a>, Up: <a href="#PostScript-figures" accesskey="u" rel="up">PostScript figures</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> +Next: <a href="#g_t_005cincludegraphics" accesskey="n" rel="next">The \includegraphics macro for LaTeX</a>, Up: <a href="#PostScript-figures" accesskey="u" rel="up">PostScript figures</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> </div> <span id="The-bounding-box-comment"></span><h4 class="subsection">5.1.1 The bounding box comment</h4> @@ -2472,9 +2416,11 @@ the file. </p> <hr> -<span id="g_t_005cincludegraphics"></span><div class="header"> +</div> +<div class="subsection" id="g_t_005cincludegraphics"> +<div class="header"> <p> -Next: <a href="#EPSF-macros" accesskey="n" rel="next">EPSF macros</a>, Previous: <a href="#Bounding-box" accesskey="p" rel="prev">Bounding box</a>, Up: <a href="#PostScript-figures" accesskey="u" rel="up">PostScript figures</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> +Next: <a href="#EPSF-macros" accesskey="n" rel="next">Using the EPSF macros</a>, Previous: <a href="#Bounding-box" accesskey="p" rel="prev">The bounding box comment</a>, Up: <a href="#PostScript-figures" accesskey="u" rel="up">PostScript figures</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> </div> <span id="The-_005cincludegraphics-macro-for-LaTeX"></span><h4 class="subsection">5.1.2 The \includegraphics macro for LaTeX</h4> @@ -2543,9 +2489,11 @@ account. </p> <hr> -<span id="EPSF-macros"></span><div class="header"> +</div> +<div class="subsection" id="EPSF-macros"> +<div class="header"> <p> -Next: <a href="#psfile-special" accesskey="n" rel="next">psfile special</a>, Previous: <a href="#g_t_005cincludegraphics" accesskey="p" rel="prev">\includegraphics</a>, Up: <a href="#PostScript-figures" accesskey="u" rel="up">PostScript figures</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> +Next: <a href="#psfile-special" accesskey="n" rel="next">‘<samp>psfile</samp>’ special</a>, Previous: <a href="#g_t_005cincludegraphics" accesskey="p" rel="prev">The \includegraphics macro for LaTeX</a>, Up: <a href="#PostScript-figures" accesskey="u" rel="up">PostScript figures</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> </div> <span id="Using-the-EPSF-macros"></span><h4 class="subsection">5.1.3 Using the EPSF macros</h4> @@ -2553,7 +2501,7 @@ Next: <a href="#psfile-special" accesskey="n" rel="next">psfile special</a>, Pre <span id="index-macros-for-epsf-inclusion-1"></span> <p>If you are using LaTeX2e, use the ‘<samp>graphics</samp>’ or ‘<samp>graphicx</samp>’ -package. See <a href="#g_t_005cincludegraphics">\includegraphics</a>. +package. See <a href="#g_t_005cincludegraphics">The \includegraphics macro for LaTeX</a>. </p> <p>If you are using plain TeX or LaTeX 2.09, you need <samp>epsf.tex</samp> (for plain TeX) and <samp>epsf.sty</samp> (for LaTeX). For plain @@ -2616,18 +2564,17 @@ terminal when it processes each figure, give the command: <pre class="example">\epsfverbosetrue </pre></div> -<table class="menu" border="0" cellspacing="0"> -<tr><td align="left" valign="top">• <a href="#EPSF-scaling" accesskey="1">EPSF scaling</a></td><td> </td><td align="left" valign="top"> -</td></tr> -<tr><td align="left" valign="top">• <a href="#EPSF-clipping" accesskey="2">EPSF clipping</a></td><td> </td><td align="left" valign="top"> -</td></tr> -</table> +<ul class="section-toc"> +<li><a href="#EPSF-scaling" accesskey="1">EPSF scaling</a></li> +<li><a href="#EPSF-clipping" accesskey="2">EPSF clipping</a></li> +</ul> <hr> -<span id="EPSF-scaling"></span><div class="header"> +<div class="subsubsection" id="EPSF-scaling"> +<div class="header"> <p> -Next: <a href="#EPSF-clipping" accesskey="n" rel="next">EPSF clipping</a>, Up: <a href="#EPSF-macros" accesskey="u" rel="up">EPSF macros</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> +Next: <a href="#EPSF-clipping" accesskey="n" rel="next">EPSF clipping</a>, Up: <a href="#EPSF-macros" accesskey="u" rel="up">Using the EPSF macros</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> </div> <span id="EPSF-scaling-1"></span><h4 class="subsubsection">5.1.3.1 EPSF scaling</h4> @@ -2677,31 +2624,31 @@ that is, the width of the <code>\vbox</code>. Schematically: <p>Some useful definitions of <var>body</var>: </p> <dl compact="compact"> -<dt>‘<samp>\epsfxsize</samp>’</dt> +<dt><span>‘<samp>\epsfxsize</samp>’</span></dt> <dd><p>This definition (the default) enables the default features listed above, by setting <code>\epsfxsize</code> to the same value it had before the macro was called. </p> </dd> -<dt>‘<samp>#1</samp>’</dt> +<dt><span>‘<samp>#1</samp>’</span></dt> <dd><p>Force the natural size by returning the first parameter (the original width). </p> </dd> -<dt>‘<samp>0pt</samp>’</dt> +<dt><span>‘<samp>0pt</samp>’</span></dt> <dd><p>A special case, equivalent to ‘<samp>#1</samp>’. </p> </dd> -<dt>‘<samp>0.5#1</samp>’</dt> +<dt><span>‘<samp>0.5#1</samp>’</span></dt> <dd><p>Scale to half the natural size. </p> </dd> -<dt>‘<samp>\hsize</samp>’</dt> +<dt><span>‘<samp>\hsize</samp>’</span></dt> <dd><p>Scale to the current <code>\hsize</code>. (In LaTeX, use <code>\textwidth</code> instead of <code>\hsize</code>.) </p> </dd> -<dt>‘<samp>\ifnum#1>\hsize\hsize\else#1\fi</samp>’</dt> +<dt><span>‘<samp>\ifnum#1>\hsize\hsize\else#1\fi</samp>’</span></dt> <dd><p>If the natural width is greater than the current <code>\hsize</code>, scale to <code>\hsize</code>, otherwise use the natural width. </p> @@ -2732,9 +2679,11 @@ scale or otherwise modify the document. </p> <hr> -<span id="EPSF-clipping"></span><div class="header"> +</div> +<div class="subsubsection" id="EPSF-clipping"> +<div class="header"> <p> -Previous: <a href="#EPSF-scaling" accesskey="p" rel="prev">EPSF scaling</a>, Up: <a href="#EPSF-macros" accesskey="u" rel="up">EPSF macros</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> +Previous: <a href="#EPSF-scaling" accesskey="p" rel="prev">EPSF scaling</a>, Up: <a href="#EPSF-macros" accesskey="u" rel="up">Using the EPSF macros</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> </div> <span id="EPSF-clipping-1"></span><h4 class="subsubsection">5.1.3.2 EPSF clipping</h4> @@ -2763,9 +2712,12 @@ turn clipping on, just use the command <hr> -<span id="psfile-special"></span><div class="header"> +</div> +</div> +<div class="subsection" id="psfile-special"> +<div class="header"> <p> -Next: <a href="#Dynamic-creation-of-graphics" accesskey="n" rel="next">Dynamic creation of graphics</a>, Previous: <a href="#EPSF-macros" accesskey="p" rel="prev">EPSF macros</a>, Up: <a href="#PostScript-figures" accesskey="u" rel="up">PostScript figures</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> +Next: <a href="#Dynamic-creation-of-graphics" accesskey="n" rel="next">Dynamic creation of PostScript graphics files</a>, Previous: <a href="#EPSF-macros" accesskey="p" rel="prev">Using the EPSF macros</a>, Up: <a href="#PostScript-figures" accesskey="u" rel="up">PostScript figures</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> </div> <span id="psfile-special-1"></span><h4 class="subsection">5.1.4 ‘<samp>psfile</samp>’ special</h4> @@ -2785,58 +2737,48 @@ specify transformations on the PostScript. <p>The possible <var>key</var>s are: </p> <dl compact="compact"> -<dt>‘<samp>hoffset</samp>’</dt> -<dd><span id="index-hoffset-_0028psfile-special-option_0029"></span> -<p>The horizontal offset (default 0). +<dt id='index-hoffset-_0028psfile-special-option_0029'><span>‘<samp>hoffset</samp>’<a href='#index-hoffset-_0028psfile-special-option_0029' class='copiable-anchor'> ¶</a></span></dt> +<dd><p>The horizontal offset (default 0). </p> </dd> -<dt>‘<samp>voffset</samp>’</dt> -<dd><span id="index-voffset-_0028psfile-special-option_0029"></span> -<p>The vertical offset (default 0). +<dt id='index-voffset-_0028psfile-special-option_0029'><span>‘<samp>voffset</samp>’<a href='#index-voffset-_0028psfile-special-option_0029' class='copiable-anchor'> ¶</a></span></dt> +<dd><p>The vertical offset (default 0). </p> </dd> -<dt>‘<samp>hsize</samp>’</dt> -<dd><span id="index-hsize-_0028psfile-special-option_0029"></span> -<p>The horizontal clipping size (default 612). +<dt id='index-hsize-_0028psfile-special-option_0029'><span>‘<samp>hsize</samp>’<a href='#index-hsize-_0028psfile-special-option_0029' class='copiable-anchor'> ¶</a></span></dt> +<dd><p>The horizontal clipping size (default 612). </p> </dd> -<dt>‘<samp>vsize</samp>’</dt> -<dd><span id="index-vsize-_0028psfile-special-option_0029"></span> -<p>The vertical clipping size (default 792). +<dt id='index-vsize-_0028psfile-special-option_0029'><span>‘<samp>vsize</samp>’<a href='#index-vsize-_0028psfile-special-option_0029' class='copiable-anchor'> ¶</a></span></dt> +<dd><p>The vertical clipping size (default 792). </p> </dd> -<dt>‘<samp>hscale</samp>’</dt> -<dd><span id="index-hscale-_0028psfile-special-option_0029"></span> -<p>The horizontal scaling factor, as a percentage (default 100). +<dt id='index-hscale-_0028psfile-special-option_0029'><span>‘<samp>hscale</samp>’<a href='#index-hscale-_0028psfile-special-option_0029' class='copiable-anchor'> ¶</a></span></dt> +<dd><p>The horizontal scaling factor, as a percentage (default 100). </p> </dd> -<dt>‘<samp>vscale</samp>’</dt> -<dd><span id="index-vscale-_0028psfile-special-option_0029"></span> -<p>The vertical scaling factor, as a percentage (default 100). +<dt id='index-vscale-_0028psfile-special-option_0029'><span>‘<samp>vscale</samp>’<a href='#index-vscale-_0028psfile-special-option_0029' class='copiable-anchor'> ¶</a></span></dt> +<dd><p>The vertical scaling factor, as a percentage (default 100). </p> </dd> -<dt>‘<samp>angle</samp>’</dt> -<dd><span id="index-angle-_0028psfile-special-option_0029"></span> -<p>The rotation, in degrees (default 0). +<dt id='index-angle-_0028psfile-special-option_0029'><span>‘<samp>angle</samp>’<a href='#index-angle-_0028psfile-special-option_0029' class='copiable-anchor'> ¶</a></span></dt> +<dd><p>The rotation, in degrees (default 0). </p> </dd> -<dt>‘<samp>clip</samp>’</dt> -<dd><span id="index-clip-_0028psfile-special-option_0029"></span> -<p>Enable clipping to the bounding box (default disabled). +<dt id='index-clip-_0028psfile-special-option_0029'><span>‘<samp>clip</samp>’<a href='#index-clip-_0028psfile-special-option_0029' class='copiable-anchor'> ¶</a></span></dt> +<dd><p>Enable clipping to the bounding box (default disabled). </p> </dd> -<dt>‘<samp>llx, lly, urx, ury</samp>’</dt> -<dd><span id="index-llx-_0028psfile-special-option_0029"></span> -<span id="index-lly-_0028psfile-special-option_0029"></span> +<dt id='index-llx-_0028psfile-special-option_0029'><span>‘<samp>llx, lly, urx, ury</samp>’<a href='#index-llx-_0028psfile-special-option_0029' class='copiable-anchor'> ¶</a></span></dt> +<dd><span id="index-lly-_0028psfile-special-option_0029"></span> <span id="index-urx-_0028psfile-special-option_0029"></span> <span id="index-ury-_0028psfile-special-option_0029"></span> <p>Bounding box of the included image, just as in a <code>%%BoundingBox</code> comment. Values are in big points, and may be fractional. </p> </dd> -<dt>‘<samp>rhi, rwi</samp>’</dt> -<dd><span id="index-rhi-_0028psfile-special-option_0029"></span> -<span id="index-rwi-_0028psfile-special-option_0029"></span> +<dt id='index-rhi-_0028psfile-special-option_0029'><span>‘<samp>rhi, rwi</samp>’<a href='#index-rhi-_0028psfile-special-option_0029' class='copiable-anchor'> ¶</a></span></dt> +<dd><span id="index-rwi-_0028psfile-special-option_0029"></span> <p>Desired width and height of the resulting figure in the output, in tenths of big points (720 to the inch); may be fractional. </p> @@ -2878,9 +2820,11 @@ scale factor. </p> <hr> -<span id="Dynamic-creation-of-graphics"></span><div class="header"> +</div> +<div class="subsection" id="Dynamic-creation-of-graphics"> +<div class="header"> <p> -Next: <a href="#Fonts-in-figures" accesskey="n" rel="next">Fonts in figures</a>, Previous: <a href="#psfile-special" accesskey="p" rel="prev">psfile special</a>, Up: <a href="#PostScript-figures" accesskey="u" rel="up">PostScript figures</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> +Next: <a href="#Fonts-in-figures" accesskey="n" rel="next">Fonts in figures</a>, Previous: <a href="#psfile-special" accesskey="p" rel="prev">‘<samp>psfile</samp>’ special</a>, Up: <a href="#PostScript-figures" accesskey="u" rel="up">PostScript figures</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> </div> <span id="Dynamic-creation-of-PostScript-graphics-files"></span><h4 class="subsection">5.1.5 Dynamic creation of PostScript graphics files</h4> @@ -2919,9 +2863,11 @@ with the ‘<samp>-R</samp>’ command-line option or ‘<samp>R</sa </p> <hr> -<span id="Fonts-in-figures"></span><div class="header"> +</div> +<div class="subsection" id="Fonts-in-figures"> +<div class="header"> <p> -Previous: <a href="#Dynamic-creation-of-graphics" accesskey="p" rel="prev">Dynamic creation of graphics</a>, Up: <a href="#PostScript-figures" accesskey="u" rel="up">PostScript figures</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> +Previous: <a href="#Dynamic-creation-of-graphics" accesskey="p" rel="prev">Dynamic creation of PostScript graphics files</a>, Up: <a href="#PostScript-figures" accesskey="u" rel="up">PostScript figures</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> </div> <span id="Fonts-in-figures-1"></span><h4 class="subsection">5.1.6 Fonts in figures</h4> @@ -2940,31 +2886,31 @@ file. Schematically, this looks like: <p>Here is the meaning of each of these elements: </p> <dl compact="compact"> -<dt><var>tfmname</var></dt> +<dt><span><var>tfmname</var></span></dt> <dd><p>The TeX TFM filename, e.g., <samp>cmr10</samp>. You can give the same <var>tfmname</var> on more than one ‘<samp>%*Font</samp>’ line; this is useful when the number of characters from the font used needs a longer <var>hex-bitstring</var> (see item below) than conveniently fits on one line. </p> </dd> -<dt><var>scaledbp</var></dt> +<dt><span><var>scaledbp</var></span></dt> <dd><p>The size at which you are using the font, in PostScript points (TeX big points). 72bp = 72.27pt = 1in. </p> </dd> -<dt><var>designbp</var></dt> +<dt><span><var>designbp</var></span></dt> <dd><p>The designsize of the font, again in PostScript points. This should match the value in the TFM file <var>tfmname</var>. Thus, for <samp>cmr10</samp>, it should be ‘<samp>9.96265</samp>’. </p> </dd> -<dt><var>hex-start</var></dt> +<dt><span><var>hex-start</var></span></dt> <dd><p>The character code of the first character used from the font, specified as two ASCII hexadecimal characters, e.g., ‘<samp>4b</samp>’ or ‘<samp>4B</samp>’ for ‘<samp>K</samp>’. </p> </dd> -<dt><var>hex-bitstring</var></dt> +<dt><span><var>hex-bitstring</var></span></dt> <dd><p>An arbitrary number of ASCII hexadecimal digits specifying which characters following (and including) <var>hex-start</var> are used. This is treated as a bitmap. For example, if your figure used the single letter @@ -2976,13 +2922,16 @@ treated as a bitmap. For example, if your figure used the single letter </dl> <p>MetaPost’s output figures contain lines like this for bitmap fonts used -in a MetaPost label (see <a href="https://tug.org/texinfohtml/web2c.html#MetaPost">MetaPost</a> in <cite>Web2c</cite>). +in a MetaPost label (see <a data-manual="web2c" href="https://tug.org/texinfohtml/web2c.html#MetaPost">MetaPost</a> in <cite>Web2c</cite>). </p> <hr> -<span id="Header-files"></span><div class="header"> +</div> +</div> +<div class="section" id="Header-files"> +<div class="header"> <p> -Next: <a href="#Literal-PS" accesskey="n" rel="next">Literal PS</a>, Previous: <a href="#PostScript-figures" accesskey="p" rel="prev">PostScript figures</a>, Up: <a href="#Interaction-with-PostScript" accesskey="u" rel="up">Interaction with PostScript</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> +Next: <a href="#Literal-PS" accesskey="n" rel="next">Literal PostScript</a>, Previous: <a href="#PostScript-figures" accesskey="p" rel="prev">PostScript figures</a>, Up: <a href="#Interaction-with-PostScript" accesskey="u" rel="up">Interaction with PostScript</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> </div> <span id="PostScript-header-files"></span><h3 class="section">5.2 PostScript header files</h3> @@ -3013,20 +2962,18 @@ version. <p>The PostScript dictionary stack will be at the ‘<samp>userdict</samp>’ level when header files are included. </p> -<table class="menu" border="0" cellspacing="0"> -<tr><td align="left" valign="top">• <a href="#Including-headers-from-TeX" accesskey="1">Including headers from TeX</a></td><td> </td><td align="left" valign="top"> -</td></tr> -<tr><td align="left" valign="top">• <a href="#Including-headers-from-the-command-line" accesskey="2">Including headers from the command line</a></td><td> </td><td align="left" valign="top"> -</td></tr> -<tr><td align="left" valign="top">• <a href="#Headers-and-memory-usage" accesskey="3">Headers and memory usage</a></td><td> </td><td align="left" valign="top"> -</td></tr> -</table> +<ul class="section-toc"> +<li><a href="#Including-headers-from-TeX" accesskey="1">Including headers from TeX</a></li> +<li><a href="#Including-headers-from-the-command-line" accesskey="2">Including headers from the command line</a></li> +<li><a href="#Headers-and-memory-usage" accesskey="3">Headers and memory usage</a></li> +</ul> <hr> -<span id="Including-headers-from-TeX"></span><div class="header"> +<div class="subsection" id="Including-headers-from-TeX"> +<div class="header"> <p> -Next: <a href="#Including-headers-from-the-command-line" accesskey="n" rel="next">Including headers from the command line</a>, Up: <a href="#Header-files" accesskey="u" rel="up">Header files</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> +Next: <a href="#Including-headers-from-the-command-line" accesskey="n" rel="next">Including headers from the command line</a>, Up: <a href="#Header-files" accesskey="u" rel="up">PostScript header files</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> </div> <span id="Including-headers-from-TeX-1"></span><h4 class="subsection">5.2.1 Including headers from TeX</h4> @@ -3089,9 +3036,11 @@ which are installed in the <samp>tex/</samp> tree. </p> <hr> -<span id="Including-headers-from-the-command-line"></span><div class="header"> +</div> +<div class="subsection" id="Including-headers-from-the-command-line"> +<div class="header"> <p> -Next: <a href="#Headers-and-memory-usage" accesskey="n" rel="next">Headers and memory usage</a>, Previous: <a href="#Including-headers-from-TeX" accesskey="p" rel="prev">Including headers from TeX</a>, Up: <a href="#Header-files" accesskey="u" rel="up">Header files</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> +Next: <a href="#Headers-and-memory-usage" accesskey="n" rel="next">Headers and memory usage</a>, Previous: <a href="#Including-headers-from-TeX" accesskey="p" rel="prev">Including headers from TeX</a>, Up: <a href="#Header-files" accesskey="u" rel="up">PostScript header files</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> </div> <span id="Including-headers-from-the-command-line-1"></span><h4 class="subsection">5.2.2 Including headers from the command line</h4> @@ -3119,9 +3068,11 @@ mode on duplex printers, and setting various screen frequencies; </p> <hr> -<span id="Headers-and-memory-usage"></span><div class="header"> +</div> +<div class="subsection" id="Headers-and-memory-usage"> +<div class="header"> <p> -Previous: <a href="#Including-headers-from-the-command-line" accesskey="p" rel="prev">Including headers from the command line</a>, Up: <a href="#Header-files" accesskey="u" rel="up">Header files</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> +Previous: <a href="#Including-headers-from-the-command-line" accesskey="p" rel="prev">Including headers from the command line</a>, Up: <a href="#Header-files" accesskey="u" rel="up">PostScript header files</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> </div> <span id="Headers-and-memory-usage-1"></span><h4 class="subsection">5.2.3 Headers and memory usage</h4> @@ -3157,9 +3108,12 @@ to a very large number. (See the ‘<samp>m</samp>’ item in <a href=" </p> <hr> -<span id="Literal-PS"></span><div class="header"> +</div> +</div> +<div class="section" id="Literal-PS"> +<div class="header"> <p> -Next: <a href="#Hypertext" accesskey="n" rel="next">Hypertext</a>, Previous: <a href="#Header-files" accesskey="p" rel="prev">Header files</a>, Up: <a href="#Interaction-with-PostScript" accesskey="u" rel="up">Interaction with PostScript</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> +Next: <a href="#Hypertext" accesskey="n" rel="next">HyperTeXt</a>, Previous: <a href="#Header-files" accesskey="p" rel="prev">PostScript header files</a>, Up: <a href="#Interaction-with-PostScript" accesskey="u" rel="up">Interaction with PostScript</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> </div> <span id="Literal-PostScript"></span><h3 class="section">5.3 Literal PostScript</h3> @@ -3168,24 +3122,20 @@ Next: <a href="#Hypertext" accesskey="n" rel="next">Hypertext</a>, Previous: <a <p>You can include literal PostScript code in your document in several ways. </p> -<table class="menu" border="0" cellspacing="0"> -<tr><td align="left" valign="top">• <a href="#g_t_0022-special" accesskey="1">" special</a></td><td> </td><td align="left" valign="top">To include inline PostScript code. -</td></tr> -<tr><td align="left" valign="top">• <a href="#ps-special" accesskey="2">ps special</a></td><td> </td><td align="left" valign="top">Inline PostScript without save/restore. -</td></tr> -<tr><td align="left" valign="top">• <a href="#Literal-headers" accesskey="3">Literal headers</a></td><td> </td><td align="left" valign="top">Literal PostScript for the whole document. -</td></tr> -<tr><td align="left" valign="top">• <a href="#PostScript-hooks" accesskey="4">PostScript hooks</a></td><td> </td><td align="left" valign="top">Specifying code to run in the PS interpreter. -</td></tr> -<tr><td align="left" valign="top">• <a href="#Literal-examples" accesskey="5">Literal examples</a></td><td> </td><td align="left" valign="top">Neat example. -</td></tr> -</table> +<ul class="section-toc"> +<li><a href="#g_t_0022-special" accesskey="1"><code>"</code> special: Literal PostScript</a></li> +<li><a href="#ps-special" accesskey="2">‘<samp>ps</samp>’ special</a></li> +<li><a href="#Literal-headers" accesskey="3">Literal headers: ‘<samp>!</samp>’ <code>\special</code></a></li> +<li><a href="#PostScript-hooks" accesskey="4">PostScript hooks</a></li> +<li><a href="#Literal-examples" accesskey="5">Literal examples</a></li> +</ul> <hr> -<span id="g_t_0022-special"></span><div class="header"> +<div class="subsection" id="g_t_0022-special"> +<div class="header"> <p> -Next: <a href="#ps-special" accesskey="n" rel="next">ps special</a>, Up: <a href="#Literal-PS" accesskey="u" rel="up">Literal PS</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> +Next: <a href="#ps-special" accesskey="n" rel="next">‘<samp>ps</samp>’ special</a>, Up: <a href="#Literal-PS" accesskey="u" rel="up">Literal PostScript</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> </div> <span id="g_t_0022-special_003a-Literal-PostScript"></span><h4 class="subsection">5.3.1 <code>"</code> special: Literal PostScript</h4> @@ -3211,9 +3161,11 @@ the <code>\vbox</code> above. </p> <hr> -<span id="ps-special"></span><div class="header"> +</div> +<div class="subsection" id="ps-special"> +<div class="header"> <p> -Next: <a href="#Literal-headers" accesskey="n" rel="next">Literal headers</a>, Previous: <a href="#g_t_0022-special" accesskey="p" rel="prev">" special</a>, Up: <a href="#Literal-PS" accesskey="u" rel="up">Literal PS</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> +Next: <a href="#Literal-headers" accesskey="n" rel="next">Literal headers: ‘<samp>!</samp>’ <code>\special</code></a>, Previous: <a href="#g_t_0022-special" accesskey="p" rel="prev"><code>"</code> special: Literal PostScript</a>, Up: <a href="#Literal-PS" accesskey="u" rel="up">Literal PostScript</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> </div> <span id="ps-special-1"></span><h4 class="subsection">5.3.2 ‘<samp>ps</samp>’ special</h4> @@ -3261,9 +3213,11 @@ it easy to typeset text turned in multiples of 90 degrees. </p> <hr> -<span id="Literal-headers"></span><div class="header"> +</div> +<div class="subsection" id="Literal-headers"> +<div class="header"> <p> -Next: <a href="#PostScript-hooks" accesskey="n" rel="next">PostScript hooks</a>, Previous: <a href="#ps-special" accesskey="p" rel="prev">ps special</a>, Up: <a href="#Literal-PS" accesskey="u" rel="up">Literal PS</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> +Next: <a href="#PostScript-hooks" accesskey="n" rel="next">PostScript hooks</a>, Previous: <a href="#ps-special" accesskey="p" rel="prev">‘<samp>ps</samp>’ special</a>, Up: <a href="#Literal-PS" accesskey="u" rel="up">Literal PostScript</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> </div> <span id="Literal-headers_003a-_0021-_005cspecial"></span><h4 class="subsection">5.3.3 Literal headers: ‘<samp>!</samp>’ <code>\special</code></h4> @@ -3289,9 +3243,11 @@ literally (the ‘<samp>"</samp>’ special) or through macros (e.g <hr> -<span id="PostScript-hooks"></span><div class="header"> +</div> +<div class="subsection" id="PostScript-hooks"> +<div class="header"> <p> -Next: <a href="#Literal-examples" accesskey="n" rel="next">Literal examples</a>, Previous: <a href="#Literal-headers" accesskey="p" rel="prev">Literal headers</a>, Up: <a href="#Literal-PS" accesskey="u" rel="up">Literal PS</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> +Next: <a href="#Literal-examples" accesskey="n" rel="next">Literal examples</a>, Previous: <a href="#Literal-headers" accesskey="p" rel="prev">Literal headers: ‘<samp>!</samp>’ <code>\special</code></a>, Up: <a href="#Literal-PS" accesskey="u" rel="up">Literal PostScript</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> </div> <span id="PostScript-hooks-1"></span><h4 class="subsection">5.3.4 PostScript hooks</h4> @@ -3347,9 +3303,11 @@ independent. </p> <hr> -<span id="Literal-examples"></span><div class="header"> +</div> +<div class="subsection" id="Literal-examples"> +<div class="header"> <p> -Previous: <a href="#PostScript-hooks" accesskey="p" rel="prev">PostScript hooks</a>, Up: <a href="#Literal-PS" accesskey="u" rel="up">Literal PS</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> +Previous: <a href="#PostScript-hooks" accesskey="p" rel="prev">PostScript hooks</a>, Up: <a href="#Literal-PS" accesskey="u" rel="up">Literal PostScript</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> </div> <span id="Literal-examples-1"></span><h4 class="subsection">5.3.5 Literal examples</h4> @@ -3390,9 +3348,12 @@ has a useful trick that appears again and again. </p> <hr> -<span id="Hypertext"></span><div class="header"> +</div> +</div> +<div class="section" id="Hypertext"> +<div class="header"> <p> -Previous: <a href="#Literal-PS" accesskey="p" rel="prev">Literal PS</a>, Up: <a href="#Interaction-with-PostScript" accesskey="u" rel="up">Interaction with PostScript</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> +Previous: <a href="#Literal-PS" accesskey="p" rel="prev">Literal PostScript</a>, Up: <a href="#Interaction-with-PostScript" accesskey="u" rel="up">Interaction with PostScript</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> </div> <span id="HyperTeXt"></span><h3 class="section">5.4 HyperTeXt</h3> @@ -3419,7 +3380,6 @@ output is <code>hyperref</code> (<a href="https://ctan.org/pkg/hyperref">https:/ plain TeX, the Eplain package has some hyperlink support (<a href="https://tug.org/eplain">https://tug.org/eplain</a>). </p> -<span id="index-http_003a_002f_002fxxx_002elanl_002egov_002fhypertex"></span> <span id="index-Doyle_002c-Mark"></span> <span id="index-Bhattacharya_002c-Tanmoy"></span> <span id="index-dvihps_002c-hyperdvi-to-PostScript"></span> @@ -3427,18 +3387,17 @@ plain TeX, the Eplain package has some hyperlink support written by Mark Doyle and Tanmoy Bhattacharya as the ‘<samp>dvihps</samp>’ program. </p> -<table class="menu" border="0" cellspacing="0"> -<tr><td align="left" valign="top">• <a href="#Hypertext-caveats" accesskey="1">Hypertext caveats</a></td><td> </td><td align="left" valign="top">Font quality, missing character psi. -</td></tr> -<tr><td align="left" valign="top">• <a href="#Hypertext-specials" accesskey="2">Hypertext specials</a></td><td> </td><td align="left" valign="top">The details on the specials. -</td></tr> -</table> +<ul class="section-toc"> +<li><a href="#Hypertext-caveats" accesskey="1">Hypertext caveats</a></li> +<li><a href="#Hypertext-specials" accesskey="2">Hypertext specials</a></li> +</ul> <hr> -<span id="Hypertext-caveats"></span><div class="header"> +<div class="subsection" id="Hypertext-caveats"> +<div class="header"> <p> -Next: <a href="#Hypertext-specials" accesskey="n" rel="next">Hypertext specials</a>, Up: <a href="#Hypertext" accesskey="u" rel="up">Hypertext</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> +Next: <a href="#Hypertext-specials" accesskey="n" rel="next">Hypertext specials</a>, Up: <a href="#Hypertext" accesskey="u" rel="up">HyperTeXt</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> </div> <span id="Hypertext-caveats-1"></span><h4 class="subsection">5.4.1 Hypertext caveats</h4> @@ -3528,16 +3487,13 @@ more, but copies are available elsewhere: <a href="http://www.utdallas.edu/~cantrell/online/543e.html">http://www.utdallas.edu/~cantrell/online/543e.html</a> </pre></div> -<p>You may also want to check “Notes on converting (La)TeX documents -to robust PDF using Rokicki’s dvips and Acrobat Distiller” by -Timothy P. Van Zandt:<br> -<a href="http://www.emrg.com/texpdf.htmlhttp://zandtwerk.insead.fr/tex2pdf.html">http://www.emrg.com/texpdf.htmlhttp://zandtwerk.insead.fr/tex2pdf.html</a>. -</p> <hr> -<span id="Hypertext-specials"></span><div class="header"> +</div> +<div class="subsection" id="Hypertext-specials"> +<div class="header"> <p> -Previous: <a href="#Hypertext-caveats" accesskey="p" rel="prev">Hypertext caveats</a>, Up: <a href="#Hypertext" accesskey="u" rel="up">Hypertext</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> +Previous: <a href="#Hypertext-caveats" accesskey="p" rel="prev">Hypertext caveats</a>, Up: <a href="#Hypertext" accesskey="u" rel="up">HyperTeXt</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> </div> <span id="Hypertext-specials-1"></span><h4 class="subsection">5.4.2 Hypertext specials</h4> @@ -3581,9 +3537,7 @@ for a precise description of base URL’s. </p> <p>Descriptions of the <code>\special</code>’s: </p><dl compact="compact"> -<dt>‘<samp>href</samp>’ -<span id="index-href"></span> -</dt> +<dt id='index-href'><span>‘<samp>href</samp>’<a href='#index-href' class='copiable-anchor'> ¶</a></span></dt> <dd><span id="index-links_002c-hypertext"></span> <p>Creates links in your TeX document. For example: </p><div class="example"> @@ -3596,9 +3550,7 @@ this is for illustration. In practice, you most likely want to use macros to insert the <code>\special</code> commands; reference above.) </p> </dd> -<dt>‘<samp>name</samp>’ -<span id="index-name"></span> -</dt> +<dt id='index-name'><span>‘<samp>name</samp>’<a href='#index-name' class='copiable-anchor'> ¶</a></span></dt> <dd><span id="index-Anderson_002c-Laurie"></span> <p>Defines URL targets in your TeX documents, so links can be resolved. For example: @@ -3612,18 +3564,14 @@ existing macro packages which take care of all the details, such as <samp>hyperref</samp> for LaTeX. The <a href="http://arxiv.org/hypertex/">HyperTeX FAQ</a> has more information. </p> </dd> -<dt>‘<samp>img</samp>’ -<span id="index-img"></span> -</dt> +<dt id='index-img'><span>‘<samp>img</samp>’<a href='#index-img' class='copiable-anchor'> ¶</a></span></dt> <dd><span id="index-mailcap-and-hypertext"></span> <p>Links to an arbitrary external file. Interactively, a viewer is spawned to read the file according to the file extension and your <samp>mailcap</samp> file (see the Xdvi documentation). </p> </dd> -<dt>‘<samp>base</samp>’ -<span id="index-base"></span> -</dt> +<dt id='index-base'><span>‘<samp>base</samp>’<a href='#index-base' class='copiable-anchor'> ¶</a></span></dt> <dd><p>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. @@ -3635,9 +3583,13 @@ the NeXTSTEP DVI viewer. </p> <hr> -<span id="PostScript-fonts"></span><div class="header"> +</div> +</div> +</div> +<div class="chapter" id="PostScript-fonts"> +<div class="header"> <p> -Next: <a href="#Color" accesskey="n" rel="next">Color</a>, Previous: <a href="#Interaction-with-PostScript" accesskey="p" rel="prev">Interaction with PostScript</a>, Up: <a href="#Top" accesskey="u" rel="up">Top</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> +Next: <a href="#Color" accesskey="n" rel="next">Color</a>, Previous: <a href="#Interaction-with-PostScript" accesskey="p" rel="prev">Interaction with PostScript</a>, Up: <a href="#Top" accesskey="u" rel="up">Dvips</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> </div> <span id="PostScript-fonts-1"></span><h2 class="chapter">6 PostScript fonts</h2> @@ -3656,22 +3608,19 @@ installation procedure (see <a href="#Installation">Installation</a>). This cha therefore relevant only if you are installing new PostScript fonts not supplied with Dvips. (Or if you’re curious.) </p> -<table class="menu" border="0" cellspacing="0"> -<tr><td align="left" valign="top">• <a href="#Font-concepts" accesskey="1">Font concepts</a></td><td> </td><td align="left" valign="top">Metrics, glyphs, virtual fonts, and encodings. -</td></tr> -<tr><td align="left" valign="top">• <a href="#Making-a-font-available" accesskey="2">Making a font available</a></td><td> </td><td align="left" valign="top">Installing and using a PostScript font. -</td></tr> -<tr><td align="left" valign="top">• <a href="#Invoking-afm2tfm" accesskey="3">Invoking afm2tfm</a></td><td> </td><td align="left" valign="top">Creating TFM and AFM files for a virtual font. -</td></tr> -<tr><td align="left" valign="top">• <a href="#psfonts_002emap" accesskey="4">psfonts.map</a></td><td> </td><td align="left" valign="top">Defining available PostScript fonts. -</td></tr> -</table> +<ul class="section-toc"> +<li><a href="#Font-concepts" accesskey="1">Font concepts</a></li> +<li><a href="#Making-a-font-available" accesskey="2">Making a PostScript font available</a></li> +<li><a href="#Invoking-afm2tfm" accesskey="3">Invoking Afm2tfm</a></li> +<li><a href="#psfonts_002emap" accesskey="4"><samp>psfonts.map</samp>: PostScript font catalog</a></li> +</ul> <hr> -<span id="Font-concepts"></span><div class="header"> +<div class="section" id="Font-concepts"> +<div class="header"> <p> -Next: <a href="#Making-a-font-available" accesskey="n" rel="next">Making a font available</a>, Up: <a href="#PostScript-fonts" accesskey="u" rel="up">PostScript fonts</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> +Next: <a href="#Making-a-font-available" accesskey="n" rel="next">Making a PostScript font available</a>, Up: <a href="#PostScript-fonts" accesskey="u" rel="up">PostScript fonts</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> </div> <span id="Font-concepts-1"></span><h3 class="section">6.1 Font concepts</h3> @@ -3690,24 +3639,19 @@ numbers of the characters in a font and their descriptive names. Two encoding files used together can describe a reencoding that rearranges, i.e., renumbers, the characters of a font. </p> -<table class="menu" border="0" cellspacing="0"> -<tr><td align="left" valign="top">• <a href="#Metric-files" accesskey="1">Metric files</a></td><td> </td><td align="left" valign="top">Shape-independent font information. -</td></tr> -<tr><td align="left" valign="top">• <a href="#Glyph-files" accesskey="2">Glyph files</a></td><td> </td><td align="left" valign="top">Character shapes. -</td></tr> -<tr><td align="left" valign="top">• <a href="#Virtual-fonts" accesskey="3">Virtual fonts</a></td><td> </td><td align="left" valign="top">Constructing one font from others. -</td></tr> -<tr><td align="left" valign="top">• <a href="#Encodings" accesskey="4">Encodings</a></td><td> </td><td align="left" valign="top">Character codes and character names. -</td></tr> -<tr><td align="left" valign="top">• <a href="#Bitmap-font-encodings" accesskey="5">Bitmap font encodings</a></td><td> </td><td align="left" valign="top">Encodings for bitmapped fonts. -</td></tr> -<tr><td align="left" valign="top">• <a href="#PostScript-typesetting" accesskey="6">PostScript typesetting</a></td><td> </td><td align="left" valign="top">How PostScript typesets a character. -</td></tr> -</table> +<ul class="section-toc"> +<li><a href="#Metric-files" accesskey="1">Metric files</a></li> +<li><a href="#Glyph-files" accesskey="2">Glyph files</a></li> +<li><a href="#Virtual-fonts" accesskey="3">Virtual fonts</a></li> +<li><a href="#Encodings" accesskey="4">Encodings</a></li> +<li><a href="#Bitmap-font-encodings" accesskey="5">Bitmap font encodings</a></li> +<li><a href="#PostScript-typesetting" accesskey="6">How PostScript typesets a character</a></li> +</ul> <hr> -<span id="Metric-files"></span><div class="header"> +<div class="subsection" id="Metric-files"> +<div class="header"> <p> Next: <a href="#Glyph-files" accesskey="n" rel="next">Glyph files</a>, Up: <a href="#Font-concepts" accesskey="u" rel="up">Font concepts</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> </div> @@ -3740,7 +3684,7 @@ the only common ligatures are fi, fl, ff, ffi, and ffl.) <ul> <li> <span id="index-afm-files"></span> <span id="index-_002eafm-Adobe-metric-files"></span> -Each Postscript font has an <em>Adobe font metrics</em> (‘<samp>.afm</samp>’) +Each PostScript font has an <em>Adobe font metrics</em> (‘<samp>.afm</samp>’) 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>. @@ -3750,7 +3694,7 @@ can get AFM files for Adobe’s fonts from TeX uses <em>TeX font metrics</em> (‘<samp>.tfm</samp>’) files. When you say ‘<samp>\font = <var>font</var></samp>’ in your TeX document, TeX reads a file named ‘<samp><var>font</var>.tfm</samp>’. (Well, except for the <samp>texfonts.map</samp> -feature; see <a href="https://tug.org/texinfohtml/kpathsea.html#Fontmap">Fontmap</a> in <cite>Kpathsea</cite>). TeX can then +feature; see <a data-manual="kpathsea" href="https://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. @@ -3760,11 +3704,11 @@ DVI file produced by TeX may need to look at the TFM file. <span id="index-pltotf"></span> <span id="index-_002epl-property-list-files"></span> <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="https://tug.org/texinfohtml/web2c.html#tftopl-invocation">tftopl +files). You can use the <code>tftopl</code> program (see <a data-manual="web2c" href="https://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 “property list” (‘<samp>.pl</samp>’) 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="https://tug.org/texinfohtml/web2c.html#pltotf-invocation">pltotf invocation</a> in <cite>Web2c</cite>). Editing metrics by hand is not something you’re likely to want +the companion program <code>pltotf</code> (see <a data-manual="web2c" href="https://tug.org/texinfohtml/web2c.html#pltotf-invocation">pltotf invocation</a> in <cite>Web2c</cite>). Editing metrics by hand is not something you’re likely to want to do often, but the capability is there. </p> </li><li> <span id="index-pfm-files"></span> @@ -3778,11 +3722,13 @@ further. <p>The Afm2tfm program distributed with Dvips converts an AFM file to a TFM file and performs other useful transformations as well. -See <a href="#Invoking-afm2tfm">Invoking afm2tfm</a>. +See <a href="#Invoking-afm2tfm">Invoking Afm2tfm</a>. </p> <hr> -<span id="Glyph-files"></span><div class="header"> +</div> +<div class="subsection" id="Glyph-files"> +<div class="header"> <p> Next: <a href="#Virtual-fonts" accesskey="n" rel="next">Virtual fonts</a>, Previous: <a href="#Metric-files" accesskey="p" rel="prev">Metric files</a>, Up: <a href="#Font-concepts" accesskey="u" rel="up">Font concepts</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> </div> @@ -3819,7 +3765,7 @@ appearance of the font at small sizes or low resolutions. <span id="index-_002epfb-printer-font-binary-files"></span> <p>Although various kinds of PostScript outline fonts exist, by far the most common, and the only one we will consider, is called <em>Type 1</em>. -The glyph files for Postscript Type 1 fonts typically have names ending +The glyph files for PostScript Type 1 fonts typically have names ending in ‘<samp>.pfa</samp>’ (“printer font ASCII”) or ‘<samp>.pfb</samp>’ (“printer font binary”). </p> @@ -3850,7 +3796,9 @@ format is a historical artifact.) </p> <hr> -<span id="Virtual-fonts"></span><div class="header"> +</div> +<div class="subsection" id="Virtual-fonts"> +<div class="header"> <p> Next: <a href="#Encodings" accesskey="n" rel="next">Encodings</a>, Previous: <a href="#Glyph-files" accesskey="p" rel="prev">Glyph files</a>, Up: <a href="#Font-concepts" accesskey="u" rel="up">Font concepts</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> </div> @@ -3875,8 +3823,8 @@ intimidated by 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="https://tug.org/texinfohtml/web2c.html#vftovp-invocation">vftovp -invocation</a> in <cite>Web2c</cite>, and <a href="https://tug.org/texinfohtml/web2c.html#vptovf-invocation">vptovf invocation</a> in <cite>Web2c</cite>. +(virtual property list) format and back again. See <a data-manual="web2c" href="https://tug.org/texinfohtml/web2c.html#vftovp-invocation">vftovp +invocation</a> in <cite>Web2c</cite>, and <a data-manual="web2c" href="https://tug.org/texinfohtml/web2c.html#vptovf-invocation">vptovf invocation</a> in <cite>Web2c</cite>. </p> <span id="index-base-fonts"></span> <p>In the case of a PostScript font <var>f</var> being used in a straightforward @@ -3893,7 +3841,7 @@ created when you run <code>vptovf</code>. <span id="index-expansion_002c-of-virtual-fonts"></span> <span id="index-virtual-font-expansion"></span> <p>You can <em>expand</em> virtual fonts into their base fonts with DVIcopy -(see <a href="https://tug.org/texinfohtml/web2c.html#dvicopy-invocation">dvicopy invocation</a> in <cite>Web2c</cite>). This is useful if you are +(see <a data-manual="web2c" href="https://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’t itself understand vf’s. </p> <span id="index-ptex-JFM"></span> @@ -3909,7 +3857,9 @@ information about the extensive support of Japanese in TeX, see </p> <hr> -<span id="Encodings"></span><div class="header"> +</div> +<div class="subsection" id="Encodings"> +<div class="header"> <p> Next: <a href="#Bitmap-font-encodings" accesskey="n" rel="next">Bitmap font encodings</a>, Previous: <a href="#Virtual-fonts" accesskey="p" rel="prev">Virtual fonts</a>, Up: <a href="#Font-concepts" accesskey="u" rel="up">Font concepts</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> </div> @@ -3937,7 +3887,7 @@ of normal PostScript fonts. <p>It’s possible but painful to change all the macros that assume 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>. +TeX expects it to be. See <a href="#Making-a-font-available">Making a PostScript font available</a>. </p> <span id="index-PostScript-encoding"></span> <span id="index-encoding-files"></span> @@ -3970,9 +3920,11 @@ italics, and <samp>texmsym.enc</samp> for math symbols. </p> <hr> -<span id="Bitmap-font-encodings"></span><div class="header"> +</div> +<div class="subsection" id="Bitmap-font-encodings"> +<div class="header"> <p> -Next: <a href="#PostScript-typesetting" accesskey="n" rel="next">PostScript typesetting</a>, Previous: <a href="#Encodings" accesskey="p" rel="prev">Encodings</a>, Up: <a href="#Font-concepts" accesskey="u" rel="up">Font concepts</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> +Next: <a href="#PostScript-typesetting" accesskey="n" rel="next">How PostScript typesets a character</a>, Previous: <a href="#Encodings" accesskey="p" rel="prev">Encodings</a>, Up: <a href="#Font-concepts" accesskey="u" rel="up">Font concepts</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> </div> <span id="Bitmap-font-encodings-1"></span><h4 class="subsection">6.1.5 Bitmap font encodings</h4> @@ -3984,7 +3936,7 @@ Next: <a href="#PostScript-typesetting" accesskey="n" rel="next">PostScript type are simply a vector of glyphs. By comparison, PostScript fonts are required to contain an encoding vector that at least provides glyph names; these names can permit PostScript and PDF viewers to -extract legible text from Postscript and PDF output. +extract legible text from PostScript and PDF output. </p> <p>Unlike previous versions, dvips versions 2020 and later add glyph naming information to Type 3 bitmapped fonts (if they can locate such @@ -4028,7 +3980,9 @@ font coordinate system. </p> <hr> -<span id="PostScript-typesetting"></span><div class="header"> +</div> +<div class="subsection" id="PostScript-typesetting"> +<div class="header"> <p> Previous: <a href="#Bitmap-font-encodings" accesskey="p" rel="prev">Bitmap font encodings</a>, Up: <a href="#Font-concepts" accesskey="u" rel="up">Font concepts</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> </div> @@ -4116,9 +4070,12 @@ information. </p> <hr> -<span id="Making-a-font-available"></span><div class="header"> +</div> +</div> +<div class="section" id="Making-a-font-available"> +<div class="header"> <p> -Next: <a href="#Invoking-afm2tfm" accesskey="n" rel="next">Invoking afm2tfm</a>, Previous: <a href="#Font-concepts" accesskey="p" rel="prev">Font concepts</a>, Up: <a href="#PostScript-fonts" accesskey="u" rel="up">PostScript fonts</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> +Next: <a href="#Invoking-afm2tfm" accesskey="n" rel="next">Invoking Afm2tfm</a>, Previous: <a href="#Font-concepts" accesskey="p" rel="prev">Font concepts</a>, Up: <a href="#PostScript-fonts" accesskey="u" rel="up">PostScript fonts</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> </div> <span id="Making-a-PostScript-font-available"></span><h3 class="section">6.2 Making a PostScript font available</h3> @@ -4156,7 +4113,7 @@ from the VPL file: <pre class="example">vptovf ptmr.vpl ptmr.vf ptmr.tfm </pre></div> -</li><li> Insert an entry for the font in <samp>psfonts.map</samp> (see <a href="#psfonts_002emap">psfonts.map</a>): +</li><li> Insert an entry for the font in <samp>psfonts.map</samp> (see <a href="#psfonts_002emap"><samp>psfonts.map</samp>: PostScript font catalog</a>): <div class="example"> <pre class="example">rptmr Times-Roman <ptmr8a.pfa </pre></div> @@ -4179,7 +4136,7 @@ like this: </pre></div> <p>This reads the file <samp>Times-Roman.afm</samp>, and produces two files as -output, namely the virtual property list’file <samp>ptmr.vpl</samp>, and the +output, namely the virtual property list file <samp>ptmr.vpl</samp>, and the “raw” font metric file <samp>rptmr.tfm</samp>. To use the font in TeX, you first run </p> @@ -4234,7 +4191,7 @@ separately). See <a href="#Reencoding-with-Afm2tfm">Reencoding with Afm2tfm</a> </p> <p>As a final step you need to record information about both the virtual font and the original font (if you ever might want to use it) in the -<samp>psfonts.map</samp> file (see <a href="#psfonts_002emap">psfonts.map</a>). For our example, you’d +<samp>psfonts.map</samp> file (see <a href="#psfonts_002emap"><samp>psfonts.map</samp>: PostScript font catalog</a>). For our example, you’d insert the following into <samp>psfonts.map</samp>: </p><div class="example"> <pre class="example">rptmr Times-Roman <ptmr8a.pfa @@ -4255,9 +4212,11 @@ the built-in PostScript fonts. </p> <hr> -<span id="Invoking-afm2tfm"></span><div class="header"> +</div> +<div class="section" id="Invoking-afm2tfm"> +<div class="header"> <p> -Next: <a href="#psfonts_002emap" accesskey="n" rel="next">psfonts.map</a>, Previous: <a href="#Making-a-font-available" accesskey="p" rel="prev">Making a font available</a>, Up: <a href="#PostScript-fonts" accesskey="u" rel="up">PostScript fonts</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> +Next: <a href="#psfonts_002emap" accesskey="n" rel="next"><samp>psfonts.map</samp>: PostScript font catalog</a>, Previous: <a href="#Making-a-font-available" accesskey="p" rel="prev">Making a PostScript font available</a>, Up: <a href="#PostScript-fonts" accesskey="u" rel="up">PostScript fonts</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> </div> <span id="Invoking-Afm2tfm"></span><h3 class="section">6.3 Invoking Afm2tfm</h3> @@ -4279,20 +4238,18 @@ can also obtain special effects such as an oblique font. (<a href="https://ctan.org/pkg/lcdf-typetools">https://ctan.org/pkg/lcdf-typetools</a>), and <code>afm2pl</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">• <a href="#Changing-font-encodings" accesskey="1">Changing font encodings</a></td><td> </td><td align="left" valign="top">Reencoding with -t, -p, -T. -</td></tr> -<tr><td align="left" valign="top">• <a href="#Special-font-effects" accesskey="2">Special font effects</a></td><td> </td><td align="left" valign="top">Oblique fonts, small caps, and such. -</td></tr> -<tr><td align="left" valign="top">• <a href="#Afm2tfm-options" accesskey="3">Afm2tfm options</a></td><td> </td><td align="left" valign="top">afm2tfm command-line options. -</td></tr> -</table> +<ul class="section-toc"> +<li><a href="#Changing-font-encodings" accesskey="1">Changing font encodings</a></li> +<li><a href="#Special-font-effects" accesskey="2">Special font effects</a></li> +<li><a href="#Afm2tfm-options" accesskey="3">Afm2tfm options</a></li> +</ul> <hr> -<span id="Changing-font-encodings"></span><div class="header"> +<div class="subsection" id="Changing-font-encodings"> +<div class="header"> <p> -Next: <a href="#Special-font-effects" accesskey="n" rel="next">Special font effects</a>, Up: <a href="#Invoking-afm2tfm" accesskey="u" rel="up">Invoking afm2tfm</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> +Next: <a href="#Special-font-effects" accesskey="n" rel="next">Special font effects</a>, Up: <a href="#Invoking-afm2tfm" accesskey="u" rel="up">Invoking Afm2tfm</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> </div> <span id="Changing-font-encodings-1"></span><h4 class="subsection">6.3.1 Changing font encodings</h4> @@ -4305,24 +4262,20 @@ Next: <a href="#Special-font-effects" accesskey="n" rel="next">Special font effe PostScript encoding, and ‘<samp>-T</samp>’ changes both simultaneously, as detailed in the sections below. </p> -<table class="menu" border="0" cellspacing="0"> -<tr><td align="left" valign="top">• <a href="#Changing-TeX-encodings" accesskey="1">Changing TeX encodings</a></td><td> </td><td align="left" valign="top">Where TeX finds a character. -</td></tr> -<tr><td align="left" valign="top">• <a href="#Changing-PostScript-encodings" accesskey="2">Changing PostScript encodings</a></td><td> </td><td align="left" valign="top">Where PostScript finds a character. -</td></tr> -<tr><td align="left" valign="top">• <a href="#Changing-both-encodings" accesskey="3">Changing both encodings</a></td><td> </td><td align="left" valign="top">One and the same, simultaneously. -</td></tr> -<tr><td align="left" valign="top">• <a href="#Reencoding-with-Afm2tfm" accesskey="4">Reencoding with Afm2tfm</a></td><td> </td><td align="left" valign="top">Problems with the default encoding. -</td></tr> -<tr><td align="left" valign="top">• <a href="#Encoding-file-format" accesskey="5">Encoding file format</a></td><td> </td><td align="left" valign="top">Syntax of an encoding file. -</td></tr> -</table> +<ul class="section-toc"> +<li><a href="#Changing-TeX-encodings" accesskey="1">‘<samp>-t</samp>’: Changing TeX encodings</a></li> +<li><a href="#Changing-PostScript-encodings" accesskey="2">‘<samp>-p</samp>’: Changing PostScript encodings</a></li> +<li><a href="#Changing-both-encodings" accesskey="3">‘<samp>-T</samp>’: Changing both TeX and PostScript encodings</a></li> +<li><a href="#Reencoding-with-Afm2tfm" accesskey="4">Reencoding with Afm2tfm</a></li> +<li><a href="#Encoding-file-format" accesskey="5">Encoding file format</a></li> +</ul> <hr> -<span id="Changing-TeX-encodings"></span><div class="header"> +<div class="subsubsection" id="Changing-TeX-encodings"> +<div class="header"> <p> -Next: <a href="#Changing-PostScript-encodings" accesskey="n" rel="next">Changing PostScript encodings</a>, Up: <a href="#Changing-font-encodings" accesskey="u" rel="up">Changing font encodings</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> +Next: <a href="#Changing-PostScript-encodings" accesskey="n" rel="next">‘<samp>-p</samp>’: Changing PostScript encodings</a>, Up: <a href="#Changing-font-encodings" accesskey="u" rel="up">Changing font encodings</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> </div> <span id="g_t_002dt_003a-Changing-TeX-encodings"></span><h4 class="subsubsection">6.3.1.1 ‘<samp>-t</samp>’: Changing TeX encodings</h4> @@ -4351,9 +4304,11 @@ encoding.) </p> <hr> -<span id="Changing-PostScript-encodings"></span><div class="header"> +</div> +<div class="subsubsection" id="Changing-PostScript-encodings"> +<div class="header"> <p> -Next: <a href="#Changing-both-encodings" accesskey="n" rel="next">Changing both encodings</a>, Previous: <a href="#Changing-TeX-encodings" accesskey="p" rel="prev">Changing TeX encodings</a>, Up: <a href="#Changing-font-encodings" accesskey="u" rel="up">Changing font encodings</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> +Next: <a href="#Changing-both-encodings" accesskey="n" rel="next">‘<samp>-T</samp>’: Changing both TeX and PostScript encodings</a>, Previous: <a href="#Changing-TeX-encodings" accesskey="p" rel="prev">‘<samp>-t</samp>’: Changing TeX encodings</a>, Up: <a href="#Changing-font-encodings" accesskey="u" rel="up">Changing font encodings</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> </div> <span id="g_t_002dp_003a-Changing-PostScript-encodings"></span><h4 class="subsubsection">6.3.1.2 ‘<samp>-p</samp>’: Changing PostScript encodings</h4> @@ -4370,7 +4325,7 @@ ligkern info is always omitted from the raw TFM. </p> <p>If you use this option, you must also arrange to download <var>ps-enc</var> as part of any document that uses this font. You do this by adding a -line like the following one to <samp>psfonts.map</samp> (see <a href="#psfonts_002emap">psfonts.map</a>): +line like the following one to <samp>psfonts.map</samp> (see <a href="#psfonts_002emap"><samp>psfonts.map</samp>: PostScript font catalog</a>): </p><div class="example"> <pre class="example">zpopr Optima "MyEncoding ReEncodeFont" <myenc.enc </pre></div> @@ -4390,9 +4345,11 @@ distribution does do this reencoding, for precisely this reason. </p> <hr> -<span id="Changing-both-encodings"></span><div class="header"> +</div> +<div class="subsubsection" id="Changing-both-encodings"> +<div class="header"> <p> -Next: <a href="#Reencoding-with-Afm2tfm" accesskey="n" rel="next">Reencoding with Afm2tfm</a>, Previous: <a href="#Changing-PostScript-encodings" accesskey="p" rel="prev">Changing PostScript encodings</a>, Up: <a href="#Changing-font-encodings" accesskey="u" rel="up">Changing font encodings</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> +Next: <a href="#Reencoding-with-Afm2tfm" accesskey="n" rel="next">Reencoding with Afm2tfm</a>, Previous: <a href="#Changing-PostScript-encodings" accesskey="p" rel="prev">‘<samp>-p</samp>’: Changing PostScript encodings</a>, Up: <a href="#Changing-font-encodings" accesskey="u" rel="up">Changing font encodings</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> </div> <span id="g_t_002dT_003a-Changing-both-TeX-and-PostScript-encodings"></span><h4 class="subsubsection">6.3.1.3 ‘<samp>-T</samp>’: Changing both TeX and PostScript encodings</h4> @@ -4408,9 +4365,11 @@ particular PostScript font. </p> <hr> -<span id="Reencoding-with-Afm2tfm"></span><div class="header"> +</div> +<div class="subsubsection" id="Reencoding-with-Afm2tfm"> +<div class="header"> <p> -Next: <a href="#Encoding-file-format" accesskey="n" rel="next">Encoding file format</a>, Previous: <a href="#Changing-both-encodings" accesskey="p" rel="prev">Changing both encodings</a>, Up: <a href="#Changing-font-encodings" accesskey="u" rel="up">Changing font encodings</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> +Next: <a href="#Encoding-file-format" accesskey="n" rel="next">Encoding file format</a>, Previous: <a href="#Changing-both-encodings" accesskey="p" rel="prev">‘<samp>-T</samp>’: Changing both TeX and PostScript encodings</a>, Up: <a href="#Changing-font-encodings" accesskey="u" rel="up">Changing font encodings</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> </div> <span id="Reencoding-with-Afm2tfm-1"></span><h4 class="subsubsection">6.3.1.4 Reencoding with Afm2tfm</h4> @@ -4479,25 +4438,25 @@ of the distributed <samp>psfonts.sty</samp> for use with LaTeX. the various possible choices for reencoding. </p> <dl compact="compact"> -<dt>default encoding</dt> +<dt><span>default encoding</span></dt> <dd><div class="example"> <pre class="example">(CODINGSCHEME TeX text + AdobeStandardEncoding) </pre></div> </dd> -<dt>‘<samp>-p dc.enc</samp>’</dt> +<dt><span>‘<samp>-p dc.enc</samp>’</span></dt> <dd><div class="example"> <pre class="example">(CODINGSCHEME TeX text + DCEncoding) </pre></div> </dd> -<dt>‘<samp>-t dc.enc</samp>’</dt> +<dt><span>‘<samp>-t dc.enc</samp>’</span></dt> <dd><div class="example"> <pre class="example">(CODINGSCHEME DCEncoding + AdobeStandardEncoding) </pre></div> </dd> -<dt>‘<samp>-T dc.enc</samp>’</dt> +<dt><span>‘<samp>-T dc.enc</samp>’</span></dt> <dd><div class="example"> <pre class="example">(CODINGSCHEME DCEncoding + DCEncoding) </pre></div> @@ -4510,7 +4469,9 @@ ignored by Dvips. </p> <hr> -<span id="Encoding-file-format"></span><div class="header"> +</div> +<div class="subsubsection" id="Encoding-file-format"> +<div class="header"> <p> Previous: <a href="#Reencoding-with-Afm2tfm" accesskey="p" rel="prev">Reencoding with Afm2tfm</a>, Up: <a href="#Changing-font-encodings" accesskey="u" rel="up">Changing font encodings</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> </div> @@ -4617,9 +4578,12 @@ operation, so there are a total of eight possibilities: <hr> -<span id="Special-font-effects"></span><div class="header"> +</div> +</div> +<div class="subsection" id="Special-font-effects"> +<div class="header"> <p> -Next: <a href="#Afm2tfm-options" accesskey="n" rel="next">Afm2tfm options</a>, Previous: <a href="#Changing-font-encodings" accesskey="p" rel="prev">Changing font encodings</a>, Up: <a href="#Invoking-afm2tfm" accesskey="u" rel="up">Invoking afm2tfm</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> +Next: <a href="#Afm2tfm-options" accesskey="n" rel="next">Afm2tfm options</a>, Previous: <a href="#Changing-font-encodings" accesskey="p" rel="prev">Changing font encodings</a>, Up: <a href="#Invoking-afm2tfm" accesskey="u" rel="up">Invoking Afm2tfm</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> </div> <span id="Special-font-effects-1"></span><h4 class="subsection">6.3.2 Special font effects</h4> @@ -4710,9 +4674,11 @@ different output encodings) may be based on it. </p> <hr> -<span id="Afm2tfm-options"></span><div class="header"> +</div> +<div class="subsection" id="Afm2tfm-options"> +<div class="header"> <p> -Previous: <a href="#Special-font-effects" accesskey="p" rel="prev">Special font effects</a>, Up: <a href="#Invoking-afm2tfm" accesskey="u" rel="up">Invoking afm2tfm</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> +Previous: <a href="#Special-font-effects" accesskey="p" rel="prev">Special font effects</a>, Up: <a href="#Invoking-afm2tfm" accesskey="u" rel="up">Invoking Afm2tfm</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> </div> <span id="Afm2tfm-options-1"></span><h4 class="subsection">6.3.3 Afm2tfm options</h4> @@ -4748,14 +4714,13 @@ expects (see <a href="#Encodings">Encodings</a>). Although the encodings agree printable ASCII characters, other characters such as ligatures and accents vary. Thus, in practice, it’s almost always desirable to create a virtual font as well with the ‘<samp>-v</samp>’ or ‘<samp>-V</samp>’ option. -See <a href="#Making-a-font-available">Making a font available</a>. +See <a href="#Making-a-font-available">Making a PostScript font available</a>. </p> <p>The command line options to Afm2tfm: </p> <dl compact="compact"> -<dt>‘<samp>-a</samp>’</dt> -<dd><span id="index-_002da-1"></span> -<span id="index-accent-height-adjustment_002c-omitting"></span> +<dt id='index-_002da-1'><span>‘<samp>-a</samp>’<a href='#index-_002da-1' class='copiable-anchor'> ¶</a></span></dt> +<dd><span id="index-accent-height-adjustment_002c-omitting"></span> <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>\"t</code>) @@ -4766,74 +4731,64 @@ as they are given in the AFM file. (Until Afm2tfm 8.4, released in the case.) </p> </dd> -<dt>‘<samp>-c <var>ratio</var></samp>’</dt> -<dd><span id="index-_002dc-ratio"></span> -<span id="index-scaling-small-caps"></span> +<dt id='index-_002dc-ratio'><span>‘<samp>-c <var>ratio</var></samp>’<a href='#index-_002dc-ratio' class='copiable-anchor'> ¶</a></span></dt> +<dd><span id="index-scaling-small-caps"></span> <p>See ‘<samp>-V</samp>’; overrides the default ratio of 0.8 for the scaling of small caps. </p> </dd> -<dt>‘<samp>-e <var>ratio</var></samp>’</dt> -<dd><span id="index-_002de-ratio"></span> -<span id="index-expanded-fonts-1"></span> +<dt id='index-_002de-ratio'><span>‘<samp>-e <var>ratio</var></samp>’<a href='#index-_002de-ratio' class='copiable-anchor'> ¶</a></span></dt> +<dd><span id="index-expanded-fonts-1"></span> <span id="index-condensed-fonts"></span> <p>Stretch characters horizontally by <var>ratio</var>; if less than 1.0, you get a condensed font. </p> </dd> -<dt>‘<samp>-O</samp>’</dt> -<dd><span id="index-_002dO"></span> -<span id="index-octal-character-codes"></span> +<dt id='index-_002dO'><span>‘<samp>-O</samp>’<a href='#index-_002dO' class='copiable-anchor'> ¶</a></span></dt> +<dd><span id="index-octal-character-codes"></span> <p>Output all character codes in the ‘<samp>vpl</samp>’ file as octal numbers, not names; this is useful for symbol or other special-purpose fonts where character names such as ‘<samp>A</samp>’ have no meaning. </p> </dd> -<dt>‘<samp>-p <var>ps-enc</var></samp>’</dt> -<dd><span id="index-_002dp-ps_002denc-1"></span> -<p>Use <var>ps-enc</var> for the destination (PostScript) encoding of the font; +<dt id='index-_002dp-ps_002denc-1'><span>‘<samp>-p <var>ps-enc</var></samp>’<a href='#index-_002dp-ps_002denc-1' class='copiable-anchor'> ¶</a></span></dt> +<dd><p>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 ‘<samp>psfonts.map</samp>’. -See <a href="#Changing-PostScript-encodings">Changing PostScript encodings</a>. +See <a href="#Changing-PostScript-encodings">‘<samp>-p</samp>’: Changing PostScript encodings</a>. </p> </dd> -<dt>‘<samp>-s <var>slant</var></samp>’</dt> -<dd><span id="index-_002ds-slant"></span> -<span id="index-slanted-fonts_002c-making"></span> +<dt id='index-_002ds-slant'><span>‘<samp>-s <var>slant</var></samp>’<a href='#index-_002ds-slant' class='copiable-anchor'> ¶</a></span></dt> +<dd><span id="index-slanted-fonts_002c-making"></span> <p>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). </p> </dd> -<dt>‘<samp>-t <var>tex-enc</var></samp>’</dt> -<dd><span id="index-_002dt-tex_002denc-1"></span> -<p>Use <var>tex-enc</var> for the target (TeX) encoding of the font. +<dt id='index-_002dt-tex_002denc-1'><span>‘<samp>-t <var>tex-enc</var></samp>’<a href='#index-_002dt-tex_002denc-1' class='copiable-anchor'> ¶</a></span></dt> +<dd><p>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>psfonts.map</samp>. </p> </dd> -<dt>‘<samp>-T <var>ps-tex-enc</var></samp>’</dt> -<dd><span id="index-_002dT-ps_002dtex_002denc"></span> -<p>Use <var>ps-tex-enc</var> for both the PostScript and target TeX encodings +<dt id='index-_002dT-ps_002dtex_002denc'><span>‘<samp>-T <var>ps-tex-enc</var></samp>’<a href='#index-_002dT-ps_002dtex_002denc' class='copiable-anchor'> ¶</a></span></dt> +<dd><p>Use <var>ps-tex-enc</var> for both the PostScript and target TeX encodings of the font. Equivalent to ‘<samp>-p <var>file</var> -t <var>file</var></samp>’. </p> </dd> -<dt>‘<samp>-u</samp>’</dt> -<dd><span id="index-_002du"></span> -<p>Use only those characters specified in the TeX encoding, and no +<dt id='index-_002du'><span>‘<samp>-u</samp>’<a href='#index-_002du' class='copiable-anchor'> ¶</a></span></dt> +<dd><p>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). </p> </dd> -<dt>‘<samp>-v <var>vpl-file</var></samp>’</dt> -<dd><span id="index-_002dv-vpl_002dfile"></span> -<p>Output a VPL (virtual property list) file, as well as a TFM file. +<dt id='index-_002dv-vpl_002dfile'><span>‘<samp>-v <var>vpl-file</var></samp>’<a href='#index-_002dv-vpl_002dfile' class='copiable-anchor'> ¶</a></span></dt> +<dd><p>Output a VPL (virtual property list) file, as well as a TFM file. </p> </dd> -<dt>‘<samp>-V <var>vpl-file</var></samp>’</dt> -<dd><span id="index-_002dV-vpl_002dfile"></span> -<p>Same as ‘<samp>-v</samp>’, but the virtual font generated is a pseudo small caps +<dt id='index-_002dV-vpl_002dfile'><span>‘<samp>-V <var>vpl-file</var></samp>’<a href='#index-_002dV-vpl_002dfile' class='copiable-anchor'> ¶</a></span></dt> +<dd><p>Same as ‘<samp>-v</samp>’, 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. @@ -4842,9 +4797,12 @@ kerning. <hr> -<span id="psfonts_002emap"></span><div class="header"> +</div> +</div> +<div class="section" id="psfonts_002emap"> +<div class="header"> <p> -Previous: <a href="#Invoking-afm2tfm" accesskey="p" rel="prev">Invoking afm2tfm</a>, Up: <a href="#PostScript-fonts" accesskey="u" rel="up">PostScript fonts</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> +Previous: <a href="#Invoking-afm2tfm" accesskey="p" rel="prev">Invoking Afm2tfm</a>, Up: <a href="#PostScript-fonts" accesskey="u" rel="up">PostScript fonts</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> </div> <span id="psfonts_002emap_003a-PostScript-font-catalog"></span><h3 class="section">6.4 <samp>psfonts.map</samp>: PostScript font catalog</h3> @@ -4866,7 +4824,7 @@ files and constructs. Each line has the format: <pre class="example">rpstrn StoneInformal <StoneInformal.pfb </pre></div> <p>causes Dvips to download <samp>StoneInformal.pfb</samp> (just as if it were -a header file, see <a href="#Header-files">Header files</a>) if the DVI file (or a virtual +a header file, see <a href="#Header-files">PostScript header files</a>) if the DVI file (or a virtual font, see <a href="#Virtual-fonts">Virtual fonts</a>) references the TFM file ‘<samp>rpstrn</samp>’. The PostScript <code>/FontName</code> of the font defined inside the ‘<samp>pfb</samp>’ file should be <code>StoneInformal</code>. @@ -4923,7 +4881,7 @@ syntax, or Dvips will not download the font properly. <p>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>). +memory usage, just as it does for other header files (see <a href="#Header-files">PostScript header files</a>). </p> <span id="index-partial-font-downloading"></span> <span id="index-downloading-fonts-partially"></span> @@ -4984,9 +4942,12 @@ name, it is used for both the TeX name and the PostScript name. <hr> -<span id="Color"></span><div class="header"> +</div> +</div> +<div class="chapter" id="Color"> +<div class="header"> <p> -Next: <a href="#Index" accesskey="n" rel="next">Index</a>, Previous: <a href="#PostScript-fonts" accesskey="p" rel="prev">PostScript fonts</a>, Up: <a href="#Top" accesskey="u" rel="up">Top</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> +Next: <a href="#Index" accesskey="n" rel="next">Index</a>, Previous: <a href="#PostScript-fonts" accesskey="p" rel="prev">PostScript fonts</a>, Up: <a href="#Top" accesskey="u" rel="up">Dvips</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> </div> <span id="Color-1"></span><h2 class="chapter">7 Color</h2> @@ -5005,24 +4966,19 @@ LaTeX. preparer’s point of view and then add some instructions on installation for the TeX administrator. </p> -<table class="menu" border="0" cellspacing="0"> -<tr><td align="left" valign="top">• <a href="#Color-macro-files" accesskey="1">Color macro files</a></td><td> </td><td align="left" valign="top">TeX macro definitions. -</td></tr> -<tr><td align="left" valign="top">• <a href="#User_002ddefinable-colors" accesskey="2">User-definable colors</a></td><td> </td><td align="left" valign="top">Adding your own colors. -</td></tr> -<tr><td align="left" valign="top">• <a href="#Color-subtleties" accesskey="3">Color subtleties</a></td><td> </td><td align="left" valign="top">Subtleties in using color. -</td></tr> -<tr><td align="left" valign="top">• <a href="#Ted-Turner" accesskey="4">Ted Turner</a></td><td> </td><td align="left" valign="top">Printing in black/white after colorizing. -</td></tr> -<tr><td align="left" valign="top">• <a href="#Color-device-configuration" accesskey="5">Color device configuration</a></td><td> </td><td align="left" valign="top">Configuring Dvips for color devices. -</td></tr> -<tr><td align="left" valign="top">• <a href="#Color-support-details" accesskey="6">Color support details</a></td><td> </td><td align="left" valign="top">Color support details -</td></tr> -</table> +<ul class="section-toc"> +<li><a href="#Color-macro-files" accesskey="1">Color macro files</a></li> +<li><a href="#User_002ddefinable-colors" accesskey="2">User-definable colors</a></li> +<li><a href="#Color-subtleties" accesskey="3">Color subtleties</a></li> +<li><a href="#Ted-Turner" accesskey="4">Printing in black/white after colorizing</a></li> +<li><a href="#Color-device-configuration" accesskey="5">Color device configuration</a></li> +<li><a href="#Color-support-details" accesskey="6">Color support details</a></li> +</ul> <hr> -<span id="Color-macro-files"></span><div class="header"> +<div class="section" id="Color-macro-files"> +<div class="header"> <p> Next: <a href="#User_002ddefinable-colors" accesskey="n" rel="next">User-definable colors</a>, Up: <a href="#Color" accesskey="u" rel="up">Color</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> </div> @@ -5120,7 +5076,9 @@ and LaTeX use compatible. </p> <hr> -<span id="User_002ddefinable-colors"></span><div class="header"> +</div> +<div class="section" id="User_002ddefinable-colors"> +<div class="header"> <p> Next: <a href="#Color-subtleties" accesskey="n" rel="next">Color subtleties</a>, Previous: <a href="#Color-macro-files" accesskey="p" rel="prev">Color macro files</a>, Up: <a href="#Color" accesskey="u" rel="up">Color</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> </div> @@ -5160,9 +5118,11 @@ and do its best to recover by discarding the current color history. </p> <hr> -<span id="Color-subtleties"></span><div class="header"> +</div> +<div class="section" id="Color-subtleties"> +<div class="header"> <p> -Next: <a href="#Ted-Turner" accesskey="n" rel="next">Ted Turner</a>, Previous: <a href="#User_002ddefinable-colors" accesskey="p" rel="prev">User-definable colors</a>, Up: <a href="#Color" accesskey="u" rel="up">Color</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> +Next: <a href="#Ted-Turner" accesskey="n" rel="next">Printing in black/white after colorizing</a>, Previous: <a href="#User_002ddefinable-colors" accesskey="p" rel="prev">User-definable colors</a>, Up: <a href="#Color" accesskey="u" rel="up">Color</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> </div> <span id="Color-subtleties-1"></span><h3 class="section">7.3 Color subtleties</h3> @@ -5201,7 +5161,9 @@ be done by prefixing the color command with <code>\leavevmode</code>. </p> <hr> -<span id="Ted-Turner"></span><div class="header"> +</div> +<div class="section" id="Ted-Turner"> +<div class="header"> <p> Next: <a href="#Color-device-configuration" accesskey="n" rel="next">Color device configuration</a>, Previous: <a href="#Color-subtleties" accesskey="p" rel="prev">Color subtleties</a>, Up: <a href="#Color" accesskey="u" rel="up">Color</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> </div> @@ -5226,9 +5188,11 @@ compatible with some form of color support. </p> <hr> -<span id="Color-device-configuration"></span><div class="header"> +</div> +<div class="section" id="Color-device-configuration"> +<div class="header"> <p> -Next: <a href="#Color-support-details" accesskey="n" rel="next">Color support details</a>, Previous: <a href="#Ted-Turner" accesskey="p" rel="prev">Ted Turner</a>, Up: <a href="#Color" accesskey="u" rel="up">Color</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> +Next: <a href="#Color-support-details" accesskey="n" rel="next">Color support details</a>, Previous: <a href="#Ted-Turner" accesskey="p" rel="prev">Printing in black/white after colorizing</a>, Up: <a href="#Color" accesskey="u" rel="up">Color</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> </div> <span id="Color-device-configuration-1"></span><h3 class="section">7.5 Color device configuration</h3> @@ -5289,7 +5253,9 @@ predefine other colors for your users. </p> <hr> -<span id="Color-support-details"></span><div class="header"> +</div> +<div class="section" id="Color-support-details"> +<div class="header"> <p> Previous: <a href="#Color-device-configuration" accesskey="p" rel="prev">Color device configuration</a>, Up: <a href="#Color" accesskey="u" rel="up">Color</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> </div> @@ -5299,16 +5265,15 @@ Previous: <a href="#Color-device-configuration" accesskey="p" rel="prev">Color d specials start with the keyword ‘<samp>color</samp>’ or the keyword ‘<samp>background</samp>’, followed by a color specification. </p> -<table class="menu" border="0" cellspacing="0"> -<tr><td align="left" valign="top">• <a href="#Color-specifications" accesskey="1">Color specifications</a></td><td> </td><td align="left" valign="top"> -</td></tr> -<tr><td align="left" valign="top">• <a href="#Color-specials" accesskey="2">Color specials</a></td><td> </td><td align="left" valign="top"> -</td></tr> -</table> +<ul class="section-toc"> +<li><a href="#Color-specifications" accesskey="1">Color specifications</a></li> +<li><a href="#Color-specials" accesskey="2">Color specials</a></li> +</ul> <hr> -<span id="Color-specifications"></span><div class="header"> +<div class="subsection" id="Color-specifications"> +<div class="header"> <p> Next: <a href="#Color-specials" accesskey="n" rel="next">Color specials</a>, Up: <a href="#Color-support-details" accesskey="u" rel="up">Color support details</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> </div> @@ -5342,7 +5307,9 @@ pattern (assuming such exists.) </p> <hr> -<span id="Color-specials"></span><div class="header"> +</div> +<div class="subsection" id="Color-specials"> +<div class="header"> <p> Previous: <a href="#Color-specifications" accesskey="p" rel="prev">Color specifications</a>, Up: <a href="#Color-support-details" accesskey="u" rel="up">Color support details</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> </div> @@ -5388,9 +5355,13 @@ categories of color-like state. </p> <hr> -<span id="Index"></span><div class="header"> +</div> +</div> +</div> +<div class="unnumbered" id="Index"> +<div class="header"> <p> -Previous: <a href="#Color" accesskey="p" rel="prev">Color</a>, Up: <a href="#Top" accesskey="u" rel="up">Top</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> +Previous: <a href="#Color" accesskey="p" rel="prev">Color</a>, Up: <a href="#Top" accesskey="u" rel="up">Dvips</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> </div> <span id="Index-1"></span><h2 class="unnumbered">Index</h2> @@ -5533,7 +5504,8 @@ Previous: <a href="#Color" accesskey="p" rel="prev">Color</a>, Up: <a href="#Top <tr><td></td><td valign="top"><a href="#index-_002dK"><code>-K</code></a>:</td><td> </td><td valign="top"><a href="#Option-details">Option details</a></td></tr> <tr><td></td><td valign="top"><a href="#index-_002dk-for-cropmarks"><code>-k <span class="roman">for cropmarks</span></code></a>:</td><td> </td><td valign="top"><a href="#Option-details">Option details</a></td></tr> <tr><td></td><td valign="top"><a href="#index-_002dL"><code>-L</code></a>:</td><td> </td><td valign="top"><a href="#Option-details">Option details</a></td></tr> -<tr><td></td><td valign="top"><a href="#index-_002dl-_005b_003d_005dnum"><code>-l [=]<var>num</var></code></a>:</td><td> </td><td valign="top"><a href="#Option-details">Option details</a></td></tr> +<tr><td></td><td valign="top"><a href="#index-_002dl-_005b_003d_005dnum_005b_002epageseq_005d"><code>-l [=]<var>num</var>[.<var>pageseq</var>]</code></a>:</td><td> </td><td valign="top"><a href="#Option-details">Option details</a></td></tr> +<tr><td></td><td valign="top"><a href="#index-_002dlandscaperotate"><code>-landscaperotate</code></a>:</td><td> </td><td valign="top"><a href="#Option-details">Option details</a></td></tr> <tr><td></td><td valign="top"><a href="#index-_002dm"><code>-m</code></a>:</td><td> </td><td valign="top"><a href="#Option-details">Option details</a></td></tr> <tr><td></td><td valign="top"><a href="#index-_002dM"><code>-M</code></a>:</td><td> </td><td valign="top"><a href="#Option-details">Option details</a></td></tr> <tr><td></td><td valign="top"><a href="#index-_002dmode-mode"><code>-mode <var>mode</var></code></a>:</td><td> </td><td valign="top"><a href="#Option-details">Option details</a></td></tr> @@ -5547,7 +5519,7 @@ Previous: <a href="#Color" accesskey="p" rel="prev">Color</a>, Up: <a href="#Top <tr><td></td><td valign="top"><a href="#index-_002dP-printer"><code>-P <var>printer</var></code></a>:</td><td> </td><td valign="top"><a href="#Option-details">Option details</a></td></tr> <tr><td></td><td valign="top"><a href="#index-_002dp-ps_002denc"><code>-p <var>ps-enc</var></code></a>:</td><td> </td><td valign="top"><a href="#Changing-PostScript-encodings">Changing PostScript encodings</a></td></tr> <tr><td></td><td valign="top"><a href="#index-_002dp-ps_002denc-1"><code>-p <var>ps-enc</var></code></a>:</td><td> </td><td valign="top"><a href="#Afm2tfm-options">Afm2tfm options</a></td></tr> -<tr><td></td><td valign="top"><a href="#index-_002dp-_005b_003d_005dnum"><code>-p [=]<var>num</var></code></a>:</td><td> </td><td valign="top"><a href="#Option-details">Option details</a></td></tr> +<tr><td></td><td valign="top"><a href="#index-_002dp-_005b_003d_005dnum_005b_002epageseq_005d"><code>-p [=]<var>num</var>[.<var>pageseq</var>]</code></a>:</td><td> </td><td valign="top"><a href="#Option-details">Option details</a></td></tr> <tr><td></td><td valign="top"><a href="#index-_002dpp-first_002dlast"><code>-pp <var>first</var>-<var>last</var></code></a>:</td><td> </td><td valign="top"><a href="#Option-details">Option details</a></td></tr> <tr><td></td><td valign="top"><a href="#index-_002dpp-range"><code>-pp <var>range</var></code></a>:</td><td> </td><td valign="top"><a href="#Option-details">Option details</a></td></tr> <tr><td></td><td valign="top"><a href="#index-_002dPprinter_002c-and-config-file-searching"><code>-P<var>printer</var><span class="roman">, and config file searching</span></code></a>:</td><td> </td><td valign="top"><a href="#Configuration-file-searching">Configuration file searching</a></td></tr> @@ -5889,7 +5861,6 @@ Previous: <a href="#Color" accesskey="p" rel="prev">Color</a>, Up: <a href="#Top <tr><td></td><td valign="top"><a href="#index-hsize-_0028psfile-special-option_0029"><code>hsize <span class="roman">(‘<samp>psfile</samp>’ special option)</span></code></a>:</td><td> </td><td valign="top"><a href="#psfile-special">psfile special</a></td></tr> <tr><td></td><td valign="top"><a href="#index-html-specials"><code>html <span class="roman">specials</span></code></a>:</td><td> </td><td valign="top"><a href="#Hypertext">Hypertext</a></td></tr> <tr><td></td><td valign="top"><a href="#index-html-specials_002c-and-_002dz"><code>html <span class="roman">specials, and ‘<samp>-z</samp>’</span></code></a>:</td><td> </td><td valign="top"><a href="#Option-details">Option details</a></td></tr> -<tr><td></td><td valign="top"><a href="#index-http_003a_002f_002fxxx_002elanl_002egov_002fhypertex"><code><code>http://xxx.lanl.gov/hypertex</code></code></a>:</td><td> </td><td valign="top"><a href="#Hypertext">Hypertext</a></td></tr> <tr><td></td><td valign="top"><a href="#index-Hungarian-umlaut">Hungarian umlaut</a>:</td><td> </td><td valign="top"><a href="#Reencoding-with-Afm2tfm">Reencoding with Afm2tfm</a></td></tr> <tr><td></td><td valign="top"><a href="#index-hyperdvi-extensions_002c-enabling">hyperdvi extensions, enabling</a>:</td><td> </td><td valign="top"><a href="#Option-details">Option details</a></td></tr> <tr><td></td><td valign="top"><a href="#index-hypertext-and-bitmap-fonts">hypertext and bitmap fonts</a>:</td><td> </td><td valign="top"><a href="#Hypertext-caveats">Hypertext caveats</a></td></tr> @@ -5929,6 +5900,10 @@ Previous: <a href="#Color" accesskey="p" rel="prev">Color</a>, Up: <a href="#Top <tr><td></td><td valign="top"><a href="#index-landscape-orientation_002c-defined">landscape orientation, defined</a>:</td><td> </td><td valign="top"><a href="#Paper-size-and-landscape">Paper size and landscape</a></td></tr> <tr><td></td><td valign="top"><a href="#index-landscape-papertype">landscape papertype</a>:</td><td> </td><td valign="top"><a href="#Option-details">Option details</a></td></tr> <tr><td></td><td valign="top"><a href="#index-landscape_002c-as-_005cspecial"><code>landscape<span class="roman">, as <code>\special</code></span></code></a>:</td><td> </td><td valign="top"><a href="#papersize-special">‘<samp>papersize</samp>’ special</a></td></tr> +<tr><td></td><td valign="top"><a href="#index-landscaperotate">landscaperotate</a>:</td><td> </td><td valign="top"><a href="#Option-details">Option details</a></td></tr> +<tr><td></td><td valign="top"><a href="#index-landscaperotate-command-line-option">landscaperotate command line option</a>:</td><td> </td><td valign="top"><a href="#Config-file-paper-sizes">Config file paper sizes</a></td></tr> +<tr><td></td><td valign="top"><a href="#index-landscaperotate-config-command"><code>landscaperotate <span class="roman">config command</span></code></a>:</td><td> </td><td valign="top"><a href="#Configuration-file-commands">Configuration file commands</a></td></tr> +<tr><td></td><td valign="top"><a href="#index-landscaperotate-configuration-file-command">landscaperotate configuration file command</a>:</td><td> </td><td valign="top"><a href="#Config-file-paper-sizes">Config file paper sizes</a></td></tr> <tr><td></td><td valign="top"><a href="#index-last-page-printed">last page printed</a>:</td><td> </td><td valign="top"><a href="#Option-details">Option details</a></td></tr> <tr><td></td><td valign="top"><a href="#index-last_002dresort-font-scaling_002c-with-DVIPSSIZES">last-resort font scaling, with <code>DVIPSSIZES</code></a>:</td><td> </td><td valign="top"><a href="#Environment-variables">Environment variables</a></td></tr> <tr><td></td><td valign="top"><a href="#index-last_002dresort-scaling_002c-with-R">last-resort scaling, with <code>R</code></a>:</td><td> </td><td valign="top"><a href="#Configuration-file-commands">Configuration file commands</a></td></tr> @@ -6026,6 +6001,7 @@ Previous: <a href="#Color" accesskey="p" rel="prev">Color</a>, Up: <a href="#Top <tr><th id="Index_cp_letter-P">P</th><td></td><td></td></tr> <tr><td></td><td valign="top"><a href="#index-p-config-command-_0028font-aliases_0029"><code>p <span class="roman">config command (font aliases)</span></code></a>:</td><td> </td><td valign="top"><a href="#Configuration-file-commands">Configuration file commands</a></td></tr> <tr><td></td><td valign="top"><a href="#index-P-config-command-_0028PK-path_0029"><code>P <span class="roman">config command (PK path)</span></code></a>:</td><td> </td><td valign="top"><a href="#Configuration-file-commands">Configuration file commands</a></td></tr> +<tr><td></td><td valign="top"><a href="#index-page-numbers_002c-multiple-repetitions-of">page numbers, multiple repetitions of</a>:</td><td> </td><td valign="top"><a href="#Option-details">Option details</a></td></tr> <tr><td></td><td valign="top"><a href="#index-page-range">page range</a>:</td><td> </td><td valign="top"><a href="#Option-details">Option details</a></td></tr> <tr><td></td><td valign="top"><a href="#index-page_002c-first-printed">page, first printed</a>:</td><td> </td><td valign="top"><a href="#Option-details">Option details</a></td></tr> <tr><td></td><td valign="top"><a href="#index-page_002c-last-printed">page, last printed</a>:</td><td> </td><td valign="top"><a href="#Option-details">Option details</a></td></tr> @@ -6256,6 +6232,7 @@ Previous: <a href="#Color" accesskey="p" rel="prev">Color</a>, Up: <a href="#Top <tr><th id="Index_cp_letter-Z">Z</th><td></td><td></td></tr> <tr><td></td><td valign="top"><a href="#index-Z-config-command-_0028compress-fonts_0029"><code>Z <span class="roman">config command (compress fonts)</span></code></a>:</td><td> </td><td valign="top"><a href="#Configuration-file-commands">Configuration file commands</a></td></tr> <tr><td></td><td valign="top"><a href="#index-z-config-command-_0028secure-mode_0029"><code>z <span class="roman">config command (secure mode)</span></code></a>:</td><td> </td><td valign="top"><a href="#Configuration-file-commands">Configuration file commands</a></td></tr> +<tr><td></td><td valign="top"><a href="#index-zero-dimensions-and-setting-paper-size">zero dimensions and setting paper size</a>:</td><td> </td><td valign="top"><a href="#Config-file-paper-sizes">Config file paper sizes</a></td></tr> <tr><td colspan="4"> <hr></td></tr> </table> <table><tr><th valign="top">Jump to: </th><td><a class="summary-letter" href="#Index_cp_symbol-1"><b>!</b></a> @@ -6343,7 +6320,8 @@ Previous: <a href="#Color" accesskey="p" rel="prev">Color</a>, Up: <a href="#Top </td></tr></table> -<hr> +</div> +</div> diff --git a/Master/texmf-dist/doc/dvips/dvips.pdf b/Master/texmf-dist/doc/dvips/dvips.pdf Binary files differindex 767f8e378c2..84c433c2148 100644 --- a/Master/texmf-dist/doc/dvips/dvips.pdf +++ b/Master/texmf-dist/doc/dvips/dvips.pdf |