diff options
Diffstat (limited to 'systems')
20 files changed, 3920 insertions, 1841 deletions
diff --git a/systems/doc/dvipng/dvipng.html b/systems/doc/dvipng/dvipng.html index 9ca5f52f44..3c444c6f20 100644 --- a/systems/doc/dvipng/dvipng.html +++ b/systems/doc/dvipng/dvipng.html @@ -1,6 +1,6 @@ <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd"> <html> -<!-- 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"> <title>A DVI-to-PNG translator</title> @@ -10,17 +10,20 @@ <meta name="resource-type" content="document"> <meta name="distribution" content="global"> <meta name="Generator" content="makeinfo"> +<meta name="viewport" content="width=device-width,initial-scale=1"> + <link href="#Top" rel="start" title="Top"> <link href="#Index" rel="index" title="Index"> <link href="#SEC_Contents" rel="contents" title="Table of Contents"> <link href="http://tug.org/texinfohtml" rel="up" title="(dir)"> +<link href="#Introduction" rel="next" title="Introduction"> <style type="text/css"> <!-- +a.copiable-anchor {visibility: hidden; text-decoration: none; line-height: 0em} a.summary-letter {text-decoration: none} blockquote.indentedblock {margin-right: 0em} div.display {margin-left: 3.2em} div.example {margin-left: 3.2em} -div.lisp {margin-left: 3.2em} kbd {font-style: oblique} pre.display {font-family: inherit} pre.format {font-family: inherit} @@ -29,6 +32,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> @@ -45,7 +49,28 @@ ul.no-bullet {list-style: none} -<span id="SEC_Contents"></span> + +<div class="top" id="Top"> +<div class="header"> +<p> +Next: <a href="#Introduction" accesskey="n" rel="next">Introduction</a>, Up: <a href="http://tug.org/texinfohtml" accesskey="u" rel="up">(dir)</a> [<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="dvipng"></span><h1 class="top">dvipng</h1> + +<p>This manual documents dvipng, a program to translate a DVI (DeVice +Independent) file into PNG (Portable Network Graphics). +</p> +<p>This file documents dvipng version 1.17 +</p> +<p>Corrections or perhaps rewrites of sections are <em>very welcome</em>. +</p> +<p>Jan-Åke Larsson +</p> + + + + +<div class="Contents_element" id="SEC_Contents"> <h2 class="contents-heading">Table of Contents</h2> <div class="contents"> @@ -87,53 +112,12 @@ ul.no-bullet {list-style: none} <li><a id="toc-Index-1" href="#Index" rel="index">Index</a></li> </ul> </div> - - -<span id="Top"></span><div class="header"> -<p> -Next: <a href="#Introduction" accesskey="n" rel="next">Introduction</a>, Up: <a href="http://tug.org/texinfohtml" accesskey="u" rel="up">(dir)</a> [<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="dvipng"></span><h1 class="top">dvipng</h1> - -<p>This manual documents dvipng, a program to translate a DVI (DeVice -Independent) file into PNG (Portable Network Graphics). -</p> -<p>This file documents dvipng version 1.17 -</p> -<p>Corrections or perhaps rewrites of sections are <em>very welcome</em>. -</p> -<p>Jan-Åke Larsson -</p> - -<table class="menu" border="0" cellspacing="0"> -<tr><td align="left" valign="top">• <a href="#Introduction" accesskey="1">Introduction</a></td><td> </td><td align="left" valign="top">Introduction -</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 dvipng -</td></tr> -<tr><td align="left" valign="top">• <a href="#Basic-usage" accesskey="3">Basic usage</a></td><td> </td><td align="left" valign="top">First things first -</td></tr> -<tr><td align="left" valign="top">• <a href="#Command_002dline-options" accesskey="4">Command-line options</a></td><td> </td><td align="left" valign="top">Advanced usage -</td></tr> -<tr><td align="left" valign="top">• <a href="#Graphics" accesskey="5">Graphics</a></td><td> </td><td align="left" valign="top">Including PostScript and/or bitmaps -</td></tr> -<tr><td align="left" valign="top">• <a href="#Color" accesskey="6">Color</a></td><td> </td><td align="left" valign="top">Using color with dvipng -</td></tr> -<tr><td align="left" valign="top">• <a href="#Diagnosing-problems" accesskey="7">Diagnosing problems</a></td><td> </td><td align="left" valign="top">Problems? -</td></tr> -<tr><td align="left" valign="top">• <a href="#Credits" accesskey="8">Credits</a></td><td> </td><td align="left" valign="top">People who have contributed -</td></tr> -<tr><td align="left" valign="top">• <a href="#Copying" accesskey="9">Copying</a></td><td> </td><td align="left" valign="top">GNU Lesser General Public License -</td></tr> -<tr><td align="left" valign="top">• <a href="#Index" rel="index">Index</a></td><td> </td><td align="left" valign="top">General index -</td></tr> -</table> - - - <hr> -<span id="Introduction"></span><div class="header"> +<div class="chapter" id="Introduction"> +<div class="header"> <p> -Next: <a href="#Installation" accesskey="n" rel="next">Installation</a>, Previous: <a href="#Top" accesskey="p" rel="prev">Top</a>, Up: <a href="#Top" accesskey="u" rel="up">Top</a> [<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">dvipng</a>, Up: <a href="#Top" accesskey="u" rel="up">dvipng</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="Introduction-1"></span><h2 class="chapter">1 Introduction</h2> @@ -194,9 +178,11 @@ PNG, JPEG or GIF images. <hr> -<span id="Installation"></span><div class="header"> +</div> +<div class="chapter" id="Installation"> +<div class="header"> <p> -Next: <a href="#Basic-usage" accesskey="n" rel="next">Basic usage</a>, Previous: <a href="#Introduction" accesskey="p" rel="prev">Introduction</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="#Basic-usage" accesskey="n" rel="next">Basic usage of dvipng</a>, Previous: <a href="#Introduction" accesskey="p" rel="prev">Introduction</a>, Up: <a href="#Top" accesskey="u" rel="up">dvipng</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> @@ -209,21 +195,17 @@ Next: <a href="#Basic-usage" accesskey="n" rel="next">Basic usage</a>, Previous: <p>Installing dvipng should be simple: merely <code>./configure</code>, <code>make</code>, and <code>make install</code>. </p> -<table class="menu" border="0" cellspacing="0"> -<tr><td align="left" valign="top">• <a href="#Prerequisites" accesskey="1">Prerequisites</a></td><td> </td><td align="left" valign="top"> -</td></tr> -<tr><td align="left" valign="top">• <a href="#Configure" accesskey="2">Configure</a></td><td> </td><td align="left" valign="top"> -</td></tr> -<tr><td align="left" valign="top">• <a href="#Build_002finstall" accesskey="3">Build/install</a></td><td> </td><td align="left" valign="top"> -</td></tr> -<tr><td align="left" valign="top">• <a href="#Installation-outside-the-texmf-tree" accesskey="4">Installation outside the texmf tree</a></td><td> </td><td align="left" valign="top"> -</td></tr> -<tr><td align="left" valign="top">• <a href="#Advice-for-non_002dprivileged-users" accesskey="5">Advice for non-privileged users</a></td><td> </td><td align="left" valign="top"> -</td></tr> -</table> +<ul class="section-toc"> +<li><a href="#Prerequisites" accesskey="1">Prerequisites</a></li> +<li><a href="#Configure" accesskey="2">Configure</a></li> +<li><a href="#Build_002finstall" accesskey="3">Build/install</a></li> +<li><a href="#Installation-outside-the-texmf-tree" accesskey="4">Installation outside the texmf tree</a></li> +<li><a href="#Advice-for-non_002dprivileged-users" accesskey="5">Installation for non-privileged users</a></li> +</ul> <hr> -<span id="Prerequisites"></span><div class="header"> +<div class="section" id="Prerequisites"> +<div class="header"> <p> Next: <a href="#Configure" accesskey="n" rel="next">Configure</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> @@ -274,7 +256,9 @@ any modern system, if not, download them and install them. </p></li></ul> <hr> -<span id="Configure"></span><div class="header"> +</div> +<div class="section" id="Configure"> +<div class="header"> <p> Next: <a href="#Build_002finstall" accesskey="n" rel="next">Build/install</a>, Previous: <a href="#Prerequisites" accesskey="p" rel="prev">Prerequisites</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> @@ -341,7 +325,9 @@ are located in e.g., <samp>/sw/local/include</samp>, do <p>where the backslash denotes a continuation of the line. </p> <hr> -<span id="Build_002finstall"></span><div class="header"> +</div> +<div class="section" id="Build_002finstall"> +<div class="header"> <p> Next: <a href="#Installation-outside-the-texmf-tree" accesskey="n" rel="next">Installation outside the texmf tree</a>, Previous: <a href="#Configure" accesskey="p" rel="prev">Configure</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> @@ -364,9 +350,11 @@ To install the files into the locations chosen earlier, type into system directories. </p> <hr> -<span id="Installation-outside-the-texmf-tree"></span><div class="header"> +</div> +<div class="section" id="Installation-outside-the-texmf-tree"> +<div class="header"> <p> -Next: <a href="#Advice-for-non_002dprivileged-users" accesskey="n" rel="next">Advice for non-privileged users</a>, Previous: <a href="#Build_002finstall" accesskey="p" rel="prev">Build/install</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="#Advice-for-non_002dprivileged-users" accesskey="n" rel="next">Installation for non-privileged users</a>, Previous: <a href="#Build_002finstall" accesskey="p" rel="prev">Build/install</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="Installation-outside-the-texmf-tree-1"></span><h3 class="section">2.4 Installation outside the texmf tree</h3> @@ -380,7 +368,9 @@ dvipng adjust these three internally so that kpathsea thinks that dvipng <em>is</em> installed in the texmf tree. </p> <hr> -<span id="Advice-for-non_002dprivileged-users"></span><div class="header"> +</div> +<div class="section" id="Advice-for-non_002dprivileged-users"> +<div class="header"> <p> Previous: <a href="#Installation-outside-the-texmf-tree" accesskey="p" rel="prev">Installation outside the texmf tree</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> @@ -403,9 +393,12 @@ access the documentation. </p> <hr> -<span id="Basic-usage"></span><div class="header"> +</div> +</div> +<div class="chapter" id="Basic-usage"> +<div class="header"> <p> -Next: <a href="#Command_002dline-options" accesskey="n" rel="next">Command-line options</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="#Command_002dline-options" accesskey="n" rel="next">Command-line options</a>, Previous: <a href="#Installation" accesskey="p" rel="prev">Installation</a>, Up: <a href="#Top" accesskey="u" rel="up">dvipng</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="Basic-usage-of-dvipng"></span><h2 class="chapter">3 Basic usage of dvipng</h2> @@ -429,7 +422,7 @@ your system before, they may be automatically generated; this process can take a few minutes, so progress reports appear by default. The next time the same font is used, it will have been saved on disk, so rendering will go much faster. (If dvipng tries to endlessly generate -the same fonts over and over again, something is wrong. See <a href="https://tug.org/texinfohtml/kpathsea.html#Unable-to-generate-fonts">Unable to +the same fonts over and over again, something is wrong. 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 @@ -440,9 +433,11 @@ of available options, just type </pre></div> <hr> -<span id="Command_002dline-options"></span><div class="header"> +</div> +<div class="chapter" id="Command_002dline-options"> +<div class="header"> <p> -Next: <a href="#Graphics" accesskey="n" rel="next">Graphics</a>, Previous: <a href="#Basic-usage" accesskey="p" rel="prev">Basic usage</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="#Graphics" accesskey="n" rel="next">Graphics</a>, Previous: <a href="#Basic-usage" accesskey="p" rel="prev">Basic usage of dvipng</a>, Up: <a href="#Top" accesskey="u" rel="up">dvipng</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><h2 class="chapter">4 Command-line options</h2> @@ -452,16 +447,15 @@ Next: <a href="#Graphics" accesskey="n" rel="next">Graphics</a>, Previous: <a hr <p>dvipng 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 dvipng –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="section" 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> @@ -519,7 +513,9 @@ These do not correspond to dvips options: <hr> -<span id="Option-details"></span><div class="header"> +</div> +<div class="section" 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> @@ -533,26 +529,24 @@ 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-options_002c-reading-from-standard-input"></span> -<span id="index-standard-input_002c-reading-options-from"></span> +<dt id='index-options_002c-reading-from-standard-input'><span>‘<samp>-</samp>’<a href='#index-options_002c-reading-from-standard-input' class='copiable-anchor'> ¶</a></span></dt> +<dd><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> +<dt><span>‘<samp>--help</samp>’</span></dt> <dd><p>Print a usage message and exit. </p> </dd> -<dt>‘<samp>--version</samp>’</dt> +<dt><span>‘<samp>--version</samp>’</span></dt> <dd><p>Print the version number and exit. </p> </dd> -<dt>‘<samp>-bd <var>num</var></samp>’</dt> -<dt>‘<samp>-bd <var>color_spec</var></samp>’</dt> -<dt>‘<samp>-bd '<var>num</var> <var>color_spec</var>'</samp>’</dt> -<dd><span id="index-transparent-border-width"></span> -<span id="index-transparent-border-fallback-color"></span> +<dt><span>‘<samp>-bd <var>num</var></samp>’</span></dt> +<dt><span>‘<samp>-bd <var>color_spec</var></samp>’</span></dt> +<dt id='index-transparent-border-width'><span>‘<samp>-bd '<var>num</var> <var>color_spec</var>'</samp>’<a href='#index-transparent-border-width' class='copiable-anchor'> ¶</a></span></dt> +<dd><span id="index-transparent-border-fallback-color"></span> <p>Set the pixel width of the transparent border (default 0). Using this option will make the image edges transparent, but it only affects pixels with the background color. Giving a <var>color_spec</var> will set the @@ -562,18 +556,16 @@ TeX color \special syntax, e.g., ’rgb 1.0 0.0 0.0’. Setting the fallback color makes the default border width 1 px. See <a href="#Color">Color</a>. </p> </dd> -<dt>‘<samp>--bdpi <var>num</var></samp>’</dt> -<dd><span id="index-base-resolution_002c-setting"></span> -<p>This option only has an effect when using bitmapped (PK) fonts. The +<dt id='index-base-resolution_002c-setting'><span>‘<samp>--bdpi <var>num</var></samp>’<a href='#index-base-resolution_002c-setting' class='copiable-anchor'> ¶</a></span></dt> +<dd><p>This option only has an effect when using bitmapped (PK) fonts. The option sets the base (Metafont) resolution, both horizontal and vertical, to <var>num</var> dpi (dots per inch). This option is necessary when manually selecting Metafont mode with the –mode option (see below). </p> </dd> -<dt>‘<samp>-bg <var>color_spec</var></samp>’</dt> -<dd><span id="index-background-color-_0028option_0029"></span> -<p>Choose background color for the images. This option will be ignored if +<dt id='index-background-color-_0028option_0029'><span>‘<samp>-bg <var>color_spec</var></samp>’<a href='#index-background-color-_0028option_0029' class='copiable-anchor'> ¶</a></span></dt> +<dd><p>Choose background color for the images. This option will be ignored if there is a background color \special in the DVI. The color spec should be in TeX color \special syntax, e.g., ’rgb 1.0 0.0 0.0’. You can also specify ’Transparent’ or ’transparent’ which will give you a @@ -586,17 +578,15 @@ images do not support full alpha transparency, so in case of GIF output, both variants will use the latter behaviour. See <a href="#Color">Color</a>. </p> </dd> -<dt>‘<samp>-d <var>num</var></samp>’</dt> -<dd><span id="index-debugging"></span> -<p>Set the debug flags, showing what dvipng (thinks it) is doing. This will +<dt id='index-debugging'><span>‘<samp>-d <var>num</var></samp>’<a href='#index-debugging' class='copiable-anchor'> ¶</a></span></dt> +<dd><p>Set the debug flags, showing what dvipng (thinks it) is doing. This will work unless dvipng has been compiled without the <code>DEBUG</code> option (not recommended). Set the flags as you need them, use ‘<samp>-d -1</samp>’ as the first option for maximum output. See <a href="#Debug-options">Debug options</a>. </p> </dd> -<dt>‘<samp>-D <var>num</var></samp>’</dt> -<dd><span id="index-output-resolution_002c-setting"></span> -<p>Set the output resolution, both horizontal and vertical, to <var>num</var> +<dt id='index-output-resolution_002c-setting'><span>‘<samp>-D <var>num</var></samp>’<a href='#index-output-resolution_002c-setting' class='copiable-anchor'> ¶</a></span></dt> +<dd><p>Set the output resolution, both horizontal and vertical, to <var>num</var> dpi (dots per inch). </p> <p>One may want to adjust this to fit a certain text font size (e.g., on @@ -616,9 +606,8 @@ is usually 96 dpi) which means the formula is <p>On some high-res screens, the value is instead 120 dpi. Good luck! </p> </dd> -<dt>‘<samp>--depth*</samp>’</dt> -<dd><span id="index-baseline-reporting"></span> -<span id="index-depth-reporting"></span> +<dt id='index-baseline-reporting'><span>‘<samp>--depth*</samp>’<a href='#index-baseline-reporting' class='copiable-anchor'> ¶</a></span></dt> +<dd><span id="index-depth-reporting"></span> <p>Report the depth of the image. This only works reliably when the LaTeX style <samp>preview.sty</samp> from preview-latex is used with the ‘<samp>active</samp>’ option. It reports the number of pixels from the @@ -632,32 +621,29 @@ would use (Cascading StyleSheets 1) necessary, and the unit is pixels (px). </p> </dd> -<dt>‘<samp>--dvinum*</samp>’</dt> +<dt><span>‘<samp>--dvinum*</samp>’</span></dt> <dd><p>Set this option to make the output page number be the TeX page numbers rather than the physical page number. See the ‘<samp>-o</samp>’ switch. </p> </dd> -<dt>‘<samp>-fg <var>color_spec</var></samp>’</dt> -<dd><span id="index-foreground-color-_0028option_0029"></span> -<p>Choose foreground color for the images. This option will be ignored if +<dt id='index-foreground-color-_0028option_0029'><span>‘<samp>-fg <var>color_spec</var></samp>’<a href='#index-foreground-color-_0028option_0029' class='copiable-anchor'> ¶</a></span></dt> +<dd><p>Choose foreground color for the images. This option will be ignored if there is a foreground color \special in the DVI. The color spec should be in TeX color \special syntax, e.g., ’rgb 1.0 0.0 0.0’. See <a href="#Color">Color</a>. </p> </dd> -<dt>‘<samp>--follow*</samp>’</dt> -<dd><span id="index-follow-mode"></span> -<p>Wait for data at end-of-file. One of the benefits of dvipng is that it +<dt id='index-follow-mode'><span>‘<samp>--follow*</samp>’<a href='#index-follow-mode' class='copiable-anchor'> ¶</a></span></dt> +<dd><p>Wait for data at end-of-file. One of the benefits of dvipng is that it does not read the postamble, so it can be started before TeX finishes. This switch makes dvipng wait at end-of-file for further output, unless it finds the POST marker that indicates the end of the DVI. This is similar to ‘<samp>tail -f</samp>’ but for DVI-to-PNG conversion. </p> </dd> -<dt>‘<samp>--freetype*</samp>’</dt> -<dd><span id="index-FreeType-font-rendering"></span> -<p>Enable/disable FreeType font rendering (default on). This option is +<dt id='index-FreeType-font-rendering'><span>‘<samp>--freetype*</samp>’<a href='#index-FreeType-font-rendering' class='copiable-anchor'> ¶</a></span></dt> +<dd><p>Enable/disable FreeType font rendering (default on). This option is available if the FreeType2 font library was present at compilation time. If this is the case, dvipng will have direct support for PostScript Type1 and TrueType fonts internally, rather than using ‘<samp>gsftopk</samp>’ @@ -671,9 +657,8 @@ identical output on different platforms, since FreeType uses the native renderer and therefore can give slightly different output on each platform. </p> </dd> -<dt>‘<samp>--gamma <var>num</var></samp>’</dt> -<dd><span id="index-gamma"></span> -<span id="index-dark-fonts"></span> +<dt id='index-gamma'><span>‘<samp>--gamma <var>num</var></samp>’<a href='#index-gamma' class='copiable-anchor'> ¶</a></span></dt> +<dd><span id="index-dark-fonts"></span> <span id="index-light-fonts"></span> <span id="index-fuzzy-images"></span> <p>Control the interpolation of colors in the greyscale anti-aliasing @@ -682,9 +667,8 @@ fonts will be lighter (more like the background), and for <var>num</var> > 1, the fonts will be darker (more like the foreground). </p> </dd> -<dt>‘<samp>--gif*</samp>’</dt> -<dd><span id="index-GIF-image-format"></span> -<p>The images are output in the GIF format, if GIF support is enabled. +<dt id='index-GIF-image-format'><span>‘<samp>--gif*</samp>’<a href='#index-GIF-image-format' class='copiable-anchor'> ¶</a></span></dt> +<dd><p>The images are output in the GIF format, if GIF support is enabled. This is the default for the ‘<samp>dvigif</samp>’ binary, which only will be available when GIF support is enabled. GIF images are palette images (see the ‘<samp>--palette</samp>’ option) and does not support true alpha @@ -692,9 +676,8 @@ channels (see the ‘<samp>--bg</samp>’ option). See also the ‘< option. </p> </dd> -<dt>‘<samp>--height*</samp>’</dt> -<dd><span id="index-baseline-reporting-1"></span> -<span id="index-height-reporting"></span> +<dt id='index-baseline-reporting-1'><span>‘<samp>--height*</samp>’<a href='#index-baseline-reporting-1' class='copiable-anchor'> ¶</a></span></dt> +<dd><span id="index-height-reporting"></span> <p>Report the height of the image. This only works reliably when the LaTeX style <samp>preview.sty</samp> from preview-latex is used with the ‘<samp>active</samp>’ option. It reports the number of pixels from the top @@ -703,9 +686,8 @@ image is obtained as the sum of the values reported from ‘<samp>--height</samp>’ and ‘<samp>--depth</samp>’. </p> </dd> -<dt>‘<samp>-l [=]<var>num</var></samp>’</dt> -<dd><span id="index-last-page-printed"></span> -<span id="index-page_002c-last-printed"></span> +<dt id='index-last-page-printed'><span>‘<samp>-l [=]<var>num</var></samp>’<a href='#index-last-page-printed' class='copiable-anchor'> ¶</a></span></dt> +<dd><span id="index-page_002c-last-printed"></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 @@ -717,33 +699,29 @@ Thus, using ‘<samp>-l =9</samp>’ will end with the ninth page of the no matter what the pages are actually numbered. </p> </dd> -<dt>‘<samp>--mode <var>mode</var></samp>’</dt> -<dd><span id="index-mode-name_002c-specifying"></span> -<span id="index-Metafont-mode_002c-specifying"></span> +<dt id='index-mode-name_002c-specifying'><span>‘<samp>--mode <var>mode</var></samp>’<a href='#index-mode-name_002c-specifying' class='copiable-anchor'> ¶</a></span></dt> +<dd><span id="index-Metafont-mode_002c-specifying"></span> <p>This option only has an effect when using bitmapped (PK) fonts. Use <var>mode</var> as the Metafont device name for the PK fonts (both for path searching and font generation). This needs to be augmented with the base device resolution, given with the ‘<samp>--bdpi</samp>’ option. See the file <a href="ftp://ftp.tug.org/tex/modes.mf">ftp://ftp.tug.org/tex/modes.mf</a> for a list of resolutions and mode -names for most devices. See <a href="https://tug.org/texinfohtml/kpathsea.html#Unable-to-generate-fonts">Unable to generate fonts</a> in <cite>Kpathsea</cite>. +names for most devices. 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-font-generation_002c-avoiding"></span> -<span id="index-mktexpk_002c-avoiding"></span> +<dt id='index-font-generation_002c-avoiding'><span>‘<samp>-M*</samp>’<a href='#index-font-generation_002c-avoiding' class='copiable-anchor'> ¶</a></span></dt> +<dd><span id="index-mktexpk_002c-avoiding"></span> <p>This option only has an effect when using bitmapped (PK) fonts. It turns off automatic PK font generation (<samp>mktexpk</samp>). </p> </dd> -<dt>‘<samp>--nogs*</samp>’</dt> -<dd><span id="index-GhostScript_002c-turning-off"></span> -<p>This switch prohibits the internal call to GhostScript for displaying +<dt id='index-GhostScript_002c-turning-off'><span>‘<samp>--nogs*</samp>’<a href='#index-GhostScript_002c-turning-off' class='copiable-anchor'> ¶</a></span></dt> +<dd><p>This switch prohibits the internal call to GhostScript for displaying PostScript specials. ‘<samp>--nogs0</samp>’ turns the call back on. </p> </dd> -<dt>‘<samp>--nogssafer*</samp>’</dt> -<dd><span id="index-GhostScript-and-_002ddSAFER"></span> -<span id="index-_002ddSAFER"></span> +<dt id='index-GhostScript-and-_002ddSAFER'><span>‘<samp>--nogssafer*</samp>’<a href='#index-GhostScript-and-_002ddSAFER' class='copiable-anchor'> ¶</a></span></dt> +<dd><span id="index-_002ddSAFER"></span> <p>Normally, if GhostScript is used to render PostScript specials, the GhostScript interpreter is run with the option ‘<samp>-dSAFER</samp>’. The ‘<samp>--nogssafer</samp>’ option runs GhostScript without ‘<samp>-dSAFER</samp>’. The @@ -752,17 +730,15 @@ as deletefile, to prevent possibly malicious PostScript programs from having any effect. </p> </dd> -<dt>‘<samp>--norawps*</samp>’</dt> -<dd><span id="index-PostScript_002c-turning-off-raw-PostScript-specials"></span> -<p>Some packages generate raw PostScript specials, even non-rendering such +<dt id='index-PostScript_002c-turning-off-raw-PostScript-specials'><span>‘<samp>--norawps*</samp>’<a href='#index-PostScript_002c-turning-off-raw-PostScript-specials' class='copiable-anchor'> ¶</a></span></dt> +<dd><p>Some packages generate raw PostScript specials, even non-rendering such specials. This switch turns off the internal call to GhostScript intended to display these raw PostScript specials. ‘<samp>--norawps0</samp>’ turns the call back on. </p> </dd> -<dt>‘<samp>-o <var>name</var></samp>’</dt> -<dd><span id="index-output_002c-redirecting"></span> -<span id="index-standard-output_002c-output-to"></span> +<dt id='index-output_002c-redirecting'><span>‘<samp>-o <var>name</var></samp>’<a href='#index-output_002c-redirecting' class='copiable-anchor'> ¶</a></span></dt> +<dd><span id="index-standard-output_002c-output-to"></span> <p>Send output to the file <var>name</var>. A single occurrence of ‘<samp>%d</samp>’ or ‘<samp>%01d</samp>’, …, ‘<samp>%09d</samp>’ will be exchanged for the physical page number (this can be changed, see the ‘<samp>--dvinum</samp>’ switch). The @@ -770,18 +746,16 @@ default output filename is ‘<samp><var>file</var>%d.png</samp>’ wher file was ‘<samp><var>file</var>.dvi</samp>’. </p> </dd> -<dt>‘<samp>-O <var>x-offset</var>,<var>y-offset</var></samp>’</dt> -<dd><span id="index-offset-pages"></span> -<p>Move the origin by <var>x-offset</var>,<var>y-offset</var>, a comma-separated +<dt id='index-offset-pages'><span>‘<samp>-O <var>x-offset</var>,<var>y-offset</var></samp>’<a href='#index-offset-pages' class='copiable-anchor'> ¶</a></span></dt> +<dd><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>’. The origin of the page is shifted from the default position (of one inch down, one inch to the right from the upper left corner of the paper) by this amount. </p> </dd> -<dt>‘<samp>-p [=]<var>num</var></samp>’</dt> -<dd><span id="index-first-page-printed"></span> -<span id="index-page_002c-first-printed"></span> +<dt id='index-first-page-printed'><span>‘<samp>-p [=]<var>num</var></samp>’<a href='#index-first-page-printed' class='copiable-anchor'> ¶</a></span></dt> +<dd><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 @@ -793,9 +767,8 @@ DVI file. Thus, using ‘<samp>-p =3</samp>’ will start with the thir the document, no matter what the pages are actually numbered. </p> </dd> -<dt>‘<samp>--palette*</samp>’</dt> -<dd><span id="index-forcing-palette-output"></span> -<p>When an external image is included, ‘<samp>dvipng</samp>’ will automatically +<dt id='index-forcing-palette-output'><span>‘<samp>--palette*</samp>’<a href='#index-forcing-palette-output' class='copiable-anchor'> ¶</a></span></dt> +<dd><p>When an external image is included, ‘<samp>dvipng</samp>’ will automatically switch to truecolor mode, to avoid unnecessary delay and quality reduction, and enable the EPS translator to draw on a transparent background and outside of the boundingbox. This switch will force @@ -804,9 +777,8 @@ clipped image inclusion. This will also override the ‘<samp>--truecolor</s switch if present. </p> </dd> -<dt>‘<samp>--picky*</samp>’</dt> -<dd><span id="index-no-erroneous-images"></span> -<p>No images are output when a warning occurs. Normally, dvipng will +<dt id='index-no-erroneous-images'><span>‘<samp>--picky*</samp>’<a href='#index-no-erroneous-images' class='copiable-anchor'> ¶</a></span></dt> +<dd><p>No images are output when a warning occurs. Normally, dvipng will output an image in spite of a warning, but there may be something missing in this image. One reason to use this option would be if you have a more complete but slower fallback converter. Mainly, this is @@ -815,15 +787,13 @@ but warnings will also occur for missing or unknown color specs and missing PK fonts. </p> </dd> -<dt>‘<samp>--png*</samp>’</dt> -<dd><span id="index-PNG-image-format"></span> -<p>The images are output in the PNG format. This is the default for the +<dt id='index-PNG-image-format'><span>‘<samp>--png*</samp>’<a href='#index-PNG-image-format' class='copiable-anchor'> ¶</a></span></dt> +<dd><p>The images are output in the PNG format. This is the default for the ‘<samp>dvipng</samp>’ binary. See also the ‘<samp>--gif</samp>’ option. </p> </dd> -<dt>‘<samp>-pp <var>firstpage</var>-<var>lastpage</var></samp>’</dt> -<dd><span id="index-page-range"></span> -<p>Print pages <var>firstpage</var> through <var>lastpage</var>; but not quite +<dt id='index-page-range'><span>‘<samp>-pp <var>firstpage</var>-<var>lastpage</var></samp>’<a href='#index-page-range' class='copiable-anchor'> ¶</a></span></dt> +<dd><p>Print pages <var>firstpage</var> through <var>lastpage</var>; but not quite equivalent to ‘<samp>-p <var>firstpage</var> -l <var>lastpage</var></samp>’. For example, when rendering a book, there may be several instances of a page in the DVI file (one in <code>\frontmatter</code>, one in <code>\mainmatter</code>, and one @@ -842,17 +812,15 @@ page numbered -1 (only the table of contents, say) put ‘<samp>-pp -1--1</s or more readable, ‘<samp>-pp -1:-1</samp>’. </p> </dd> -<dt>‘<samp>-q*</samp>’</dt> -<dd><span id="index-quiet-operation"></span> -<span id="index-silent-operation"></span> +<dt id='index-quiet-operation'><span>‘<samp>-q*</samp>’<a href='#index-quiet-operation' class='copiable-anchor'> ¶</a></span></dt> +<dd><span id="index-silent-operation"></span> <span id="index-warnings_002c-suppressing"></span> <p>Run quietly. Don’t chatter about pages converted, etc. to standard output; report no warnings (only errors) to standard error. </p> </dd> -<dt>‘<samp>-Q <var>num</var></samp>’</dt> -<dd><span id="index-antialiasing-levels_002c-number-of"></span> -<span id="index-quality"></span> +<dt id='index-antialiasing-levels_002c-number-of'><span>‘<samp>-Q <var>num</var></samp>’<a href='#index-antialiasing-levels_002c-number-of' class='copiable-anchor'> ¶</a></span></dt> +<dd><span id="index-quality"></span> <p>Set the quality to <var>num</var>. That is, choose the number of antialiasing levels for bitmapped fonts (PK), to be <var>num</var>*<var>num</var>+1. The default value is 4 which gives 17 levels of @@ -860,23 +828,21 @@ antialiasing for antialiased fonts from these two. If FreeType is available, its rendering is unaffected by this option. </p> </dd> -<dt>‘<samp>-r*</samp>’</dt> -<dd><span id="index-reverse-pagination"></span> -<p>Toggle output of pages in reverse/forward order. By default, the first +<dt id='index-reverse-pagination'><span>‘<samp>-r*</samp>’<a href='#index-reverse-pagination' class='copiable-anchor'> ¶</a></span></dt> +<dd><p>Toggle output of pages in reverse/forward order. By default, the first page in the DVI is output first. </p> </dd> -<dt>‘<samp>--strict*</samp>’</dt> -<dd><span id="index-exit-on-erroneous-images"></span> -<p>The program exits when a warning occurs. Normally, dvipng will output +<dt id='index-exit-on-erroneous-images'><span>‘<samp>--strict*</samp>’<a href='#index-exit-on-erroneous-images' class='copiable-anchor'> ¶</a></span></dt> +<dd><p>The program exits when a warning occurs. Normally, dvipng will output an image in spite of a warning, but there may be something missing in this image. One reason to use this option would be if you have a more complete but slower fallback converter. See the ‘<samp>--picky</samp>’ option above for a list of when warnings occur. </p> </dd> -<dt>‘<samp>-T <var>image_size</var></samp>’</dt> +<dt><span>‘<samp>-T <var>image_size</var></samp>’</span></dt> <dd><p>Set the image size to <var>image_size</var> which can be either of ‘<samp>bbox</samp>’, ‘<samp>tight</samp>’, or a comma-separated pair of dimensions <var>hsize</var>,<var>vsize</var> such as ‘<samp>.1in,.3cm</samp>’. The default is @@ -887,31 +853,28 @@ the left in the produced image. The value ‘<samp>tight</samp>’ will only include all ink put on the page, producing neat images. </p> </dd> -<dt>‘<samp>--truecolor*</samp>’</dt> -<dd><span id="index-truecolor-output"></span> -<p>This will make ‘<samp>dvipng</samp>’ generate truecolor output. Note that +<dt id='index-truecolor-output'><span>‘<samp>--truecolor*</samp>’<a href='#index-truecolor-output' class='copiable-anchor'> ¶</a></span></dt> +<dd><p>This will make ‘<samp>dvipng</samp>’ generate truecolor output. Note that truecolor output is automatic if you include an external image in your DVI, e.g., via a PostScript special (i.e., the ‘<samp>graphics</samp>’ or ‘<samp>graphicx</samp>’ package). This switch is overridden by the ‘<samp>--palette</samp>’ switch. </p> </dd> -<dt>‘<samp>-v*</samp>’</dt> +<dt><span>‘<samp>-v*</samp>’</span></dt> <dd><p>Enable verbose operation. This will currently indicate what fonts is used, in addition to the usual output. </p> </dd> -<dt>‘<samp>--width*</samp>’</dt> -<dd><span id="index-width-reporting"></span> -<p>Report the width of the image. See also ‘<samp>--height</samp>’ and +<dt id='index-width-reporting'><span>‘<samp>--width*</samp>’<a href='#index-width-reporting' class='copiable-anchor'> ¶</a></span></dt> +<dd><p>Report the width of the image. See also ‘<samp>--height</samp>’ and ‘<samp>--depth</samp>’. </p> </dd> -<dt>‘<samp>-x <var>num</var></samp>’</dt> -<dd><span id="index-magnification_002c-overriding-DVI"></span> -<p>This option is deprecated; it should not be used. It is much better to +<dt id='index-magnification_002c-overriding-DVI'><span>‘<samp>-x <var>num</var></samp>’<a href='#index-magnification_002c-overriding-DVI' class='copiable-anchor'> ¶</a></span></dt> +<dd><p>This option is deprecated; it should not be used. It is much better to select the output resolution directly with the ‘<samp>-D</samp>’ option. This -option sets the magnification ratio to <em><var>num</var>/1000</em> and +option sets the magnification ratio to <em class='math'><var>num</var>/1000</em> and 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 @@ -919,9 +882,8 @@ total number of PK files generated. <var>num</var> may be a real number, not an integer, for increased precision. </p> </dd> -<dt>‘<samp>-z <var>num</var></samp>’</dt> -<dd><span id="index-compression"></span> -<p>Set the PNG compression level to <var>num</var>. This option is enabled if +<dt id='index-compression'><span>‘<samp>-z <var>num</var></samp>’<a href='#index-compression' class='copiable-anchor'> ¶</a></span></dt> +<dd><p>Set the PNG compression level to <var>num</var>. This option is enabled if your ‘<samp>libgd</samp>’ is new enough. The default compression level is 1, which selects maximum speed at the price of slightly larger PNGs. For an older ‘<samp>libgd</samp>’, the hard-soldered value 5 is used. The include file @@ -938,9 +900,12 @@ correspond directly to the zlib compression levels. </dl> <hr> -<span id="Graphics"></span><div class="header"> +</div> +</div> +<div class="chapter" id="Graphics"> +<div class="header"> <p> -Next: <a href="#Color" accesskey="n" rel="next">Color</a>, Previous: <a href="#Command_002dline-options" accesskey="p" rel="prev">Command-line options</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="#Command_002dline-options" accesskey="p" rel="prev">Command-line options</a>, Up: <a href="#Top" accesskey="u" rel="up">dvipng</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="Graphics-1"></span><h2 class="chapter">5 Graphics</h2> @@ -952,17 +917,15 @@ also able (from version 1.8) to include bitmapped graphics. It also tries to handle some of the raw PostScript that is output from various packages. Some of the possibilities and problems are mentioned below. </p> -<table class="menu" border="0" cellspacing="0"> -<tr><td align="left" valign="top">• <a href="#Encapsulated-PostScript" accesskey="1">Encapsulated PostScript</a></td><td> </td><td align="left" valign="top">An internal call to GhostScript -</td></tr> -<tr><td align="left" valign="top">• <a href="#Bitmapped-graphics" accesskey="2">Bitmapped graphics</a></td><td> </td><td align="left" valign="top">PNG, JPEG and GIF -</td></tr> -<tr><td align="left" valign="top">• <a href="#Raw-PostScript" accesskey="3">Raw PostScript</a></td><td> </td><td align="left" valign="top">Ignore or give to GhostScript -</td></tr> -</table> +<ul class="section-toc"> +<li><a href="#Encapsulated-PostScript" accesskey="1">Encapsulated PostScript</a></li> +<li><a href="#Bitmapped-graphics" accesskey="2">Bitmapped graphics</a></li> +<li><a href="#Raw-PostScript" accesskey="3">Raw PostScript</a></li> +</ul> <hr> -<span id="Encapsulated-PostScript"></span><div class="header"> +<div class="section" id="Encapsulated-PostScript"> +<div class="header"> <p> Next: <a href="#Bitmapped-graphics" accesskey="n" rel="next">Bitmapped graphics</a>, Up: <a href="#Graphics" accesskey="u" rel="up">Graphics</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> </div> @@ -996,7 +959,9 @@ in this example (using ‘<samp>graphicx</samp>’): <hr> -<span id="Bitmapped-graphics"></span><div class="header"> +</div> +<div class="section" id="Bitmapped-graphics"> +<div class="header"> <p> Next: <a href="#Raw-PostScript" accesskey="n" rel="next">Raw PostScript</a>, Previous: <a href="#Encapsulated-PostScript" accesskey="p" rel="prev">Encapsulated PostScript</a>, Up: <a href="#Graphics" accesskey="u" rel="up">Graphics</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> </div> @@ -1030,7 +995,9 @@ wide: </pre></div> <hr> -<span id="Raw-PostScript"></span><div class="header"> +</div> +<div class="section" id="Raw-PostScript"> +<div class="header"> <p> Previous: <a href="#Bitmapped-graphics" accesskey="p" rel="prev">Bitmapped graphics</a>, Up: <a href="#Graphics" accesskey="u" rel="up">Graphics</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> </div> @@ -1074,9 +1041,12 @@ is turned off, it gives a warning. It is now possible to use the switch the slower fallback for these pages. </p> <hr> -<span id="Color"></span><div class="header"> +</div> +</div> +<div class="chapter" id="Color"> +<div class="header"> <p> -Next: <a href="#Diagnosing-problems" accesskey="n" rel="next">Diagnosing problems</a>, Previous: <a href="#Graphics" accesskey="p" rel="prev">Graphics</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="#Diagnosing-problems" accesskey="n" rel="next">Diagnosing problems</a>, Previous: <a href="#Graphics" accesskey="p" rel="prev">Graphics</a>, Up: <a href="#Top" accesskey="u" rel="up">dvipng</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">6 Color</h2> @@ -1085,16 +1055,15 @@ generated by the ‘<samp>color</samp>’ and ‘<samp>xcolor</samp> 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="section" id="Color-specifications"> +<div class="header"> <p> Next: <a href="#Color-specials" accesskey="n" rel="next">Color specials</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> @@ -1123,7 +1092,9 @@ an argument to ‘<samp>--bg</samp>’ to choose transparent background. See <a href="#Option-details">Option details</a>. </p> <hr> -<span id="Color-specials"></span><div class="header"> +</div> +<div class="section" id="Color-specials"> +<div class="header"> <p> Previous: <a href="#Color-specifications" accesskey="p" rel="prev">Color specifications</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> @@ -1156,9 +1127,12 @@ that color. the pages are rendered repeatedly or in reverse order. </p> <hr> -<span id="Diagnosing-problems"></span><div class="header"> +</div> +</div> +<div class="chapter" id="Diagnosing-problems"> +<div class="header"> <p> -Next: <a href="#Credits" accesskey="n" rel="next">Credits</a>, 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> +Next: <a href="#Credits" accesskey="n" rel="next">Credits</a>, Previous: <a href="#Color" accesskey="p" rel="prev">Color</a>, Up: <a href="#Top" accesskey="u" rel="up">dvipng</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="Diagnosing-problems-1"></span><h2 class="chapter">7 Diagnosing problems</h2> @@ -1171,15 +1145,14 @@ all the instructions in this manual, and still can’t get something to work. The following sections provide some helpful hints if you find yourself in such a situation. </p> -<table class="menu" border="0" cellspacing="0"> -<tr><td align="left" valign="top">• <a href="#Contact-information" accesskey="1">Contact information</a></td><td> </td><td align="left" valign="top">Who to ask. -</td></tr> -<tr><td align="left" valign="top">• <a href="#Debug-options" accesskey="2">Debug options</a></td><td> </td><td align="left" valign="top">Getting diagnostics. -</td></tr> -</table> +<ul class="section-toc"> +<li><a href="#Contact-information" accesskey="1">Contact information</a></li> +<li><a href="#Debug-options" accesskey="2">Debug options</a></li> +</ul> <hr> -<span id="Contact-information"></span><div class="header"> +<div class="section" id="Contact-information"> +<div class="header"> <p> Next: <a href="#Debug-options" accesskey="n" rel="next">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> @@ -1198,11 +1171,13 @@ body to <a href="mailto:dvipng-request@nongnu.org">dvipng-request@nongnu.org</a> access, ask on <a href="mailto:dvipng@nongnu.org">dvipng@nongnu.org</a>. </p> <p>For details on the TeX path-searching library, and <code>mktexpk</code> -problems, see <a href="https://tug.org/texinfohtml/kpathsea.html#Common-problems">Common problems</a> in <cite>Kpathsea</cite>. +problems, see <a data-manual="kpathsea" href="https://tug.org/texinfohtml/kpathsea.html#Common-problems">Common problems</a> in <cite>Kpathsea</cite>. </p> <hr> -<span id="Debug-options"></span><div class="header"> +</div> +<div class="section" id="Debug-options"> +<div class="header"> <p> Previous: <a href="#Contact-information" accesskey="p" rel="prev">Contact information</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> @@ -1216,56 +1191,59 @@ multiple classes, sum the numbers of the classes you wish to track. To track all classes, you can use <code>-1</code>. </p> <p>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>). +(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>Normal dvi op-codes </p></dd> -<dt>2</dt> +<dt><span>2</span></dt> <dd><p>Virtual fonts </p></dd> -<dt>4</dt> +<dt><span>4</span></dt> <dd><p>PK fonts </p></dd> -<dt>8</dt> +<dt><span>8</span></dt> <dd><p>TFM files </p></dd> -<dt>16</dt> +<dt><span>16</span></dt> <dd><p>Glyph rendering </p></dd> -<dt>32</dt> +<dt><span>32</span></dt> <dd><p>FreeType calls </p></dd> -<dt>64</dt> +<dt><span>64</span></dt> <dd><p>Encoding loads </p></dd> -<dt>128</dt> +<dt><span>128</span></dt> <dd><p>Color specials </p></dd> -<dt>256</dt> +<dt><span>256</span></dt> <dd><p>GhostScript specials </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="Credits"></span><div class="header"> +</div> +</div> +<div class="chapter" id="Credits"> +<div class="header"> <p> -Next: <a href="#Copying" accesskey="n" rel="next">Copying</a>, Previous: <a href="#Diagnosing-problems" accesskey="p" rel="prev">Diagnosing problems</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="#Copying" accesskey="n" rel="next">Copying</a>, Previous: <a href="#Diagnosing-problems" accesskey="p" rel="prev">Diagnosing problems</a>, Up: <a href="#Top" accesskey="u" rel="up">dvipng</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="Credits-1"></span><h2 class="chapter">8 Credits</h2> @@ -1289,9 +1267,11 @@ Waldeck Schutzer, Ahzo, and Andy Nguyen. </p> <hr> -<span id="Copying"></span><div class="header"> +</div> +<div class="chapter" id="Copying"> +<div class="header"> <p> -Next: <a href="#Index" accesskey="n" rel="next">Index</a>, Previous: <a href="#Credits" accesskey="p" rel="prev">Credits</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="#Credits" accesskey="p" rel="prev">Credits</a>, Up: <a href="#Top" accesskey="u" rel="up">dvipng</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="Copying-1"></span><h2 class="chapter">9 Copying</h2> @@ -1314,9 +1294,11 @@ License along with this program. If not, see <p>Copyright © 2002-2015, 2019 Jan-Åke Larsson </p> <hr> -<span id="Index"></span><div class="header"> +</div> +<div class="unnumbered" id="Index"> +<div class="header"> <p> -Previous: <a href="#Copying" accesskey="p" rel="prev">Copying</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="#Copying" accesskey="p" rel="prev">Copying</a>, Up: <a href="#Top" accesskey="u" rel="up">dvipng</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> @@ -1515,7 +1497,8 @@ Previous: <a href="#Copying" accesskey="p" rel="prev">Copying</a>, Up: <a href=" <a class="summary-letter" href="#Index_cp_letter-W"><b>W</b></a> </td></tr></table> -<hr> +</div> +</div> diff --git a/systems/doc/dvipng/dvipng.pdf b/systems/doc/dvipng/dvipng.pdf Binary files differindex c92d4407a3..028cd521cf 100644 --- a/systems/doc/dvipng/dvipng.pdf +++ b/systems/doc/dvipng/dvipng.pdf diff --git a/systems/doc/dvips/dvips.html b/systems/doc/dvips/dvips.html index da5842dfc3..30e59aef42 100644 --- a/systems/doc/dvips/dvips.html +++ b/systems/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/systems/doc/dvips/dvips.pdf b/systems/doc/dvips/dvips.pdf Binary files differindex 767f8e378c..84c433c214 100644 --- a/systems/doc/dvips/dvips.pdf +++ b/systems/doc/dvips/dvips.pdf diff --git a/systems/doc/hitex/hint.ist b/systems/doc/hitex/hint.ist new file mode 100644 index 0000000000..5510d18027 --- /dev/null +++ b/systems/doc/hitex/hint.ist @@ -0,0 +1,16 @@ + +% quote '+' + +actual '+' +encap ':' +preamble "\\beginindex\n" +postamble "\\endindex\n" +headings_flag 1 +heading_prefix "\\indexheading " +symhead_positive "{Symbols}" +numhead_positive "{Numbers}" + +delim_0 "\\quad " +delim_1 "\\quad " +delim_2 "\\quad " + diff --git a/systems/doc/hitex/hint.sty b/systems/doc/hitex/hint.sty new file mode 100644 index 0000000000..4b702e84d5 --- /dev/null +++ b/systems/doc/hitex/hint.sty @@ -0,0 +1,1446 @@ +\input idxmac.tex +\let\displayverbatimfont=\tt +\input verbatim.tex + +%% +%% special treatment for @ +%% + +\def\makeatletter{\catcode`\@=11\relax} +\def\makeatother{\catcode`\@=12\relax} +\makeatletter + +%% +%% Conditionals +%% + +\newif\ifhint +\newif\ifbook +\newif\ifpdf + +% HINT +\ifx\HINTversion\undefined + \hintfalse +\else + \hinttrue +\fi + +% PDF +\ifx\pdfliteral\undefined % postscript und ps2pdf + \pdffalse +\else + \pdftrue +\fi + +% Book +\ifx\book\undefined + \ifhint\bookfalse + \else\ifpdf\bookfalse % This might change + \else\bookfalse + \fi\fi +\else +\booktrue +\hintfalse +\pdffalse +\fi + +\message{Book: \ifbook true \else false \fi} +\message{PDF: \ifpdf true \else false \fi} +\message{HINT: \ifhint true \else false \fi} + +%% +%% Additional fonts +%% + +\font\tenss=cmss10 % used for the HINT name +\font\tenssbx=cmssbx10 % used for the bold HINT name +\font\largess=cmss12 scaled\magstep1 % used for large HINT name +\font\largessbx=cmssbx10 scaled\magstep2 % used for large bold HINT name +\font\manual=manfnt % font used for the METAFONT logo, etc. +\let\sf\tenss +\def\bf{\let\sf\tenssbx\fam\bffam\tenbf} + + +%% Large Font for sections +%\font\largebf=cmb14 scaled\magstep0 +%\font\largebf=cmb12 scaled\magstep1 +\font\largebf=cmbx12 scaled\magstep1 +%\font\largebf=cmbx8 scaled\magstep3 +%\font\largeit=cmti14 scaled\magstep0 +\font\largeit=cmti12 scaled\magstep1 +%\font\largett=cmtt14 scaled\magstep0 +\font\largett=cmtt12 scaled\magstep1 +%\font\largerm=cmr14 scaled\magstep0 +\font\largerm=cmr12 scaled\magstep1 +% for mathbolditalic +%\font\tenmib=cmmib10 scaled\magstep0 +\font\tenmib=cmmib10 scaled\magstep0 +\font\largemib=cmmib10 scaled\magstep1 + +%% Small Fonts for Figure and Table descriptions +\font\figbf=cmbx9 scaled\magstep0 +\font\figit=cmti9 scaled\magstep0 +\font\figmit=cmmi9 scaled\magstep0 +\font\figsy=cmsy9 scaled\magstep0 +\font\figtt=cmtt9 scaled\magstep0 +\font\figrm=cmr9 scaled\magstep0 +% for mathbolditalic +\font\figmib=cmmib9 scaled\magstep0 + +\def\largebold{\let\bf\largebf\let\sf\largessbx\bf} + +\def\large{\def\rm{\fam0\largerm}\let\bf\largebold\let\it\largeit\let\tt\largett\let\mib\largemib\let\sf\largess% +\textfont0=\largerm\textfont1=\largeit +\setbox\strutbox=\hbox{\vrule height9.5pt depth5.0pt width\z@}\rm} + +\def\small{\def\rm{\fam0\figrm}\let\bf\figbf\let\it\figit\let\tt\figtt\let\mib\figmib% +\textfont0=\figrm\textfont1=\figmit\textfont2=\figsy% +\setbox\strutbox=\hbox{\vrule height9.0pt depth4.5pt width\z@}\rm} + +\let\tiny\eightrm +\let\mib\tenmib + + +%% +%% Logos +%% + +%\def\Pascal/{{\mc P\kern-.05emascal\spacefactor1000}} +\def\CEE{{\mc C\spacefactor1000}} +\def\Pascal{\leavevmode\hbox{\mc P\kern-.05emascal}} +\def\PDF{\leavevmode\hbox{\mc PDF}} +\def\WEB{\leavevmode\hbox{\tt WEB\spacefactor1000}} +\def\GNU{\leavevmode\hbox{\mc GNU}} +\def\Prote{{\tenrm P\kern-0.1em R\kern-0.15em\raise.11ex\hbox{o}% + \kern-0.22em T\kern-0.05em E}} +\def\eTeX{$\varepsilon$-\TeX} +\def\HINT{\leavevmode\hbox{\sf HINT\spacefactor1000}} +\def\cweb{\leavevmode\hbox{\tt cweb}} +\def\web2w{\leavevmode\hbox{\tt web2w}} +\def\LaTeX{L\kern-.36em\raise.3ex\hbox{\sc A}\kern-.15em\TeX}% +\def\MF{{\manual META}\-{\manual FONT}}% +\def\TL{\TeX~Live} +\def\kpse{\leavevmode\hbox{\tt kpathsearch\spacefactor1000}} +\def\TUB{{\sl TUGboat\/}} +\def\TUG{\TeX\ \UG} +\def\tug{\acro{TUG}} +\def\UG{Users Group} +\ifacro +\sanitizecommand{\TeX}{TeX} +\sanitizecommand{\eTeX}{eTeX} +\sanitizecommand{\Prote}{PRoTE} +\fi +%% +%% Special controlsequences +%% + +\def\abs#1{\left|#1\right|} +\def\<#1>{$\langle\,$#1$\,\rangle$} +\def\registered{{\ooalign{\hfil\raise.07ex\hbox{\sevenrm R}\hfil\crcr\Orb}}} +\def\hair{\kern.05em\relax} % teeny tiny space +\def\center#1{\bigskip\line{\hfil#1\hfil}\bigbreak} +\chardef\VB=`\| % vertical bar character in a string +\def\^{\ifmmode\mathchar"222 \else\char`^ \fi}%from webmac.tex: pointer or hat +\ifhint +\def\_{{\tt\UL}} % make underline an ordinary character for better searching +\fi + +% Bibtex needs this +\def\mbox#1{\leavevmode\hbox{#1}} + +% URLs +{\gdef\urldot{.}\catcode`.=13 + \gdef\urlslash{/}\catcode`/=13 + \gdef\urlspecials{\def.{\urldot\penalty 0}\def/{\urlslash\penalty 0}} +} +\def\url{\bgroup\hskip 1cm plus 5cm\penalty -100\hskip -1cm plus -5cm\tt + \catcode`_=12\catcode`\~=12\catcode`.=13\catcode`/=13\urlspecials} +\def\endurl{\egroup} + + +% for the index +\def\see#1#2{\hskip 0pt plus 100pt\penalty 0\hskip 0 pt plus -100pt{\it see\/} #1} + +% typewriter type for strings +\def\.#1{\leavevmode\hbox{\tt + \let\\=\BS % backslash in a string + \let\{=\LB % left brace in a string + \let\}=\RB % right brace in a string + \let\~=\TL % tilde in a string + \let\ =\SP % space in a string + \let\_=\UL % underline in a string + \let\&=\AM % ampersand in a string + \let\^=\CF % circumflex in a string + \let\|=\VB % vertical bar in a string + #1\kern.05em}} + +%{\rm\gdef\strutdepth{\dp\strutbox}} + + +%% +%% Environments +%% + +% Quotations (form the standard) +\def\beginquote{\bgroup\narrower\noindent\sl} +\def\endquote{\egroup} + +% Enumerate +\newcount\enum +%other styles use \medskip instead of \par +\def\enumerate{\par\bgroup\advance\leftskip by\parindent\enum=0% + \def\item{\advance\enum by 1\par\enumdest\smallskip\noindent\hbox to 0pt{\hss\the\enum.~}\ignorespaces}} +\def\endenumerate{\medskip\egroup\noindent} + +%Itemize +\def\itemize{\par\bgroup\advance\leftskip by\parindent\relax% + \def\item{\par\smallskip\noindent\llap{$\bullet$\enspace}\ignorespaces}} +\def\enditemize{\medskip\egroup\noindent} + +%Float +\long\def\float#1{\midinsert\parindent 0pt\relax#1\endinsert} +%\def\float#1{\midinsert +%\hsize\pagewidth +%\parindent 0pt\vbox{\hbox{\kern-\marginwidth\vbox{#1}}}\endinsert} + +%% +%% Redefining cwebmac.tex macros +%% + +%defining how to output terminals and nonterminals +\def\ts#1{\ifmmode\hbox{\sc #1}\else{\sc #1}\fi}% terminal symbol +\def\nts#1{{\sl #1\/}}% nonterminal symbol +% redefining the box around verbatim code +\def\vb#1{\hbox{\strut\.{#1}}} +% regular expressions and actions +\newbox\rebox +\def\re#1{\leavevmode\setbox\rebox\hbox{#1\hfill}\ifdim\wd\rebox<7em\wd\rebox=7em\fi\box\rebox\quad} +\def\ac{\global\ind=10\hangindent=\ind em\relax} +\def\eac{\global\ind=3\hangindent=\ind em\relax} +% yskip is usually a smallskip = 3pt pus 1pt minus 1pt +% I give it some extra stretchability +%\def\yskip{\vskip 3pt plus 3pt minus 1pt} +\let\yskip\smallbreak + +% redefine \5 for an optional break without the 2.5em reduced indentation +%\def\5{\hskip 0pt plus 2.5em\penalty-1\hskip 0pt plus -2.5em\kern0.5em\ignorespaces}% optional break +%redefine \5 to give some shrinkability +% form hitex and hint style: +%\def\5{\hfil\penalty-1\hskip 0pt minus 6pt\hfilneg\kern2.5em\copy\bakk\ignorespaces}% optional break +\def\5{\hfil\penalty10\hfilneg\hskip 0pt minus 6pt\kern2.5em\copy\bakk\ignorespaces}% optional break +\def\J{}% dont show @& in the tex output +\def\Y{\par\yskip} + +% start sections +\def\stsec{\rightskip=0pt % get out of C mode (cf. \B) + \sfcode`;=1500 \pretolerance 200 \hyphenpenalty 50 \exhyphenpenalty 50 % +} + +% the box for the points to operator "->" in C +\setbox\MGbox=\hbox{$\rightarrow$} + +% how to display NULL +\def\NULL{\tt NULL} + +%other styles make this a \par +\def\note#1#2.{} +%\Y\noindent{\hfill% +% \baselineskip10pt\tiny#1~\ifacro{\pdfnote#2.}\else#2\fi.\par}} + +%other styles make this minus 10pt +\def\B{\rightskip=0pt plus 100pt minus 0pt % go into C mode + \sfcode`;=3000 + \pretolerance 10000 + \hyphenpenalty 1000 % so strings can be broken (discretionary \ is inserted) + \exhyphenpenalty 1000 + \codedest + \global\ind=2 \1\ \unskip + \vadjust{\vtop to 0pt{\vss\hbox to \hsize{\hfill\tiny(\secstar)}\kern 0pt}}} + +% formating of C comments +\def\C#1{\5\hfill$/\ast\,${\cmntfont #1}$\,\ast/$} + +% section begin +\def\M#1{\MN{#1}\ifon\stsec\smallskip +%\everypar{{\setbox0=\lastbox}\everypar{}}% no indentation in the next paragraph +\noindent\ignorespaces}% beginning of section + +\def\N#1#2#3.{\MN{#1}\ifon\stsec\smallskip +%\everypar{{\setbox0=\lastbox}\everypar{}}% no indentation in the next paragraph +\noindent{\bf#3\quad}\ignorespaces}% beginning of section + +\def\MN#1{\smallskip + {\xdef\secstar{#1}\let\*=\empty\xdef\secno{#1}}% + \gdef\thecode{#1}% common code for \M, \N + \ontrue} + +% Used in section text +\def\U{\rightnote{Used in}} % xref for use of a section +\def\Us{\rightnote{Used in}} % xref for uses of a section +% replacing \note in \U and \Us by \rightnote +%\def\rightnote#1#2.{\vskip-\baselineskip\vtop to 0pt{\vss\hbox to \hsize{\hfill +% \tiny#1~\ifacro{\pdfnote#2.}\else#2\fi.}\kern 0pt}} +%\def\rightnote#1#2.{\vskip-\baselineskip\hbox to \hsize{\hfill +% \tiny#1~\ifacro{\pdfnote#2.}\else#2\fi.}} +%\def\rightnote#1#2.{\penalty1000\discretionary{}{\hbox{}}{\kern 2em}\penalty1000\hfill +% \hbox{\tiny#1~\ifacro{\pdfnote#2.}\else#2\fi.}} +\def\rightnote#1#2.{% + \penalty1000\discretionary{}{\hbox{}}{\kern 4em}\penalty1000\hfill + \hskip -4em plus 4em\hbox{\tiny #1~\codenote#2.}.} + +\def\X#1:#2\X{\ifmmode\gdef\XX{\null$\null}\else\gdef\XX{}\fi %$% section name + \XX$\langle\,${\let\I=\ne#2\kern.5em\coderef{#1}$\,\rangle$\XX}} + + +% how to display hex numbers +\def\hex{\hbox{$^{\scriptstyle\#}$\tt\aftergroup}} % CWEB style + +\def\(#1){} % this is used to make section names sort themselves better + + +%% +%% Dimensions to achive the desired layout +%% + + +% the other variables are defined in cwebmac.tex +\newdimen\headheight +\newdimen\footheight +\newdimen\leftmargin +\newdimen\rightmargin +\newdimen\topmargin +\newdimen\bottommargin +\newdimen\marginwidth + +\parskip 0pt plus .8pt + +\leftmargin=22mm +\rightmargin=22mm +\topmargin=15mm +\bottommargin=27mm +\marginwidth=0pt % we do not have notes in the margin + +\headheight=12pt % Text in Head +\advance\headheight+13pt % Abstand 1pt, Linie 0.47pt und Abstand zum Text 11.53pt +\footheight=0pt % Text in Footer + +\pagewidth=6.69in +\advance\pagewidth-\leftmargin % left margin/offset +\advance\pagewidth-\rightmargin % left margin/offset + +% 6.69in = 169.926 +% - 2*22mm = 125.926mm +% +% 9.61in = 244.094 +% - 15mm -27 mm = 202.094 +% (12+13)pt = 8.786 mm +% -8.786 = 193.308 mm + +\fullpageheight=9.61in +\advance\fullpageheight-\topmargin% topmargin +\advance\fullpageheight-\bottommargin% bottommargin + +\pageheight=\fullpageheight +\advance\pageheight-\headheight +\advance\pageheight-\footheight + +\def\setpage{\hsize\pagewidth\advance\hsize-\marginwidth\vsize\pageheight} % use after changing page size + +\setpage + +% setting the papersize for postscript and pdf + +\ifbook + %\overfullrule=0pt + \pdfpageheight=9.61in + \pdfpagewidth=6.69in + \pdfhorigin=\leftmargin + \pdfvorigin=\topmargin + \pdfcompresslevel=9 + \pdfdecimaldigits=4 + \pdfpkresolution=1200 + \pdfimageresolution=1200 +\else\ifpdf + \pdfpageheight=9.61in + \pdfpagewidth=6.69in + \pdfhorigin=\leftmargin + \pdfvorigin=\topmargin + \pdfcompresslevel=9 + \pdfdecimaldigits=4 + \pdfpkresolution=1200 + \pdfimageresolution=1200 +\else + \special{papersize=6.69in,9.61in}% postscript und ps2pdf +\fi\fi + + + +%% +%% Page layout +%% + +\long\def\leftmark#1#2{#1} +\long\def\subsectionmark#1#2{#2} +\long\def\rightmark#1#2{\if0#1\else\expandafter\subsectionmark\botmark\fi} + +\def\lheader{\mainfont\strut +\thepageno\hfill\expandafter\leftmark\firstmark} % top line on left-hand pages + +\def\rheader{\mainfont\strut +\expandafter\rightmark\firstmark\hfill\thepageno} % top line on right-hand pages + +\let\page=\pagebody +%\raggedbottom +\normalbottom +%\def\page{\box255 }\normalbottom % faster, but loses plain TeX footnotes +\def\normaloutput#1#2#3{\ifodd\pageno\hoffset=\pageshift\fi + \shipout\vbox{ + \vbox to\fullpageheight{\pagelabel + \iftitle\global\titlefalse + \else\hbox{\vbox to \headheight{ + \hbox to \pagewidth{\ifodd\pageno #3\else#2\fi} + \vskip 1pt\relax + \nointerlineskip + \hrule height .47pt +% \hbox{\hrule}%fill\psfig{file=image/topline.eps}\hfil}% + \vfil}}% + \fi + \nointerlineskip + \hbox{\kern\marginwidth\vbox to \pageheight{#1}}}} % parameter #1 is the page itself + \global\advance\pageno by1} + +\def\nomarginoutput#1#2#3{% + \ifodd\pageno\hoffset=\pageshift\fi + \shipout\vbox to\fullpageheight{\pagelabel\nointerlineskip + \iftitle\global\titlefalse + \hbox{\vbox to \headheight{\vfil}} + \else + \hbox{\vbox to \headheight{\nointerlineskip + \hbox to \pagewidth{\ifodd\pageno#3\else#2\fi}% + \vskip 1 pt + \nointerlineskip + \hrule height .47pt +% \hbox{\psfig{silent=,bbllx=0pt,bblly=0pt,bburx=368pt,bbury=2pt,file=image/topline.eps}\hfil}% + \vfil}}% + \fi\nointerlineskip #1 % parameter #1 is the page itself +% \vss +% \hbox to \pagewidth{\ifodd\pageno\else#2\fi}% +% \nointerlineskip +% \hbox{\psfig{file=image/topline.eps}\hfil}% +}% +\global\advance\pageno by1} + +%% switch to global nomargin +\let\normaloutput\nomarginoutput +\def\sectionbox#1{\hbox{#1}} +\marginwidth=0mm +\setpage + + +%% +%% Frontmatter and mainmatter +%% +\pageno=1 +\def\thepageno{\romannumeral\pageno} +\def\frontmatter{\pageno=4\def\thepageno{\romannumeral\pageno}} +\def\mainmatter{ +\mark{{\sectionname}{\subsectionname}} +%\message{Mark {\sectionname}{\subsectionname}} +\vfil\break\ifodd\pageno\pageno=1\else\pageno=0\fi +\def\thepageno{\the\pageno}% +\sectioncount=0 +\mark{{0}{0}}% +%\hbox{Mark empty empty}% +\gdef\sectionname{} +\gdef\subsectionname{} +\gdef\codetitle{} +\gdef\subcodetitle{} +} + + + + +%% +%% Sections +%% + +\newcount\sectioncount +\sectioncount=0 +\newcount\subsectioncount +\subsectioncount=0 +\newcount\subsubsectioncount +\subsubsectioncount=0 + +\newskip\abovesecskip +\newskip\belowsecskip +\newskip\abovesubsecskip +\newskip\belowsubsecskip + +%\abovesecskip= 6ex plus 1ex minus .2ex %space above the section +%\belowsecskip=3.7ex plus .2ex% space after section +\abovesecskip= 0.15\vsize plus 5ex minus 1ex %space above the section +\belowsecskip=10pt plus 2pt% space after section +\abovesubsecskip=9pt plus 4pt minus 2pt%space above the section +\belowsubsecskip=3pt plus 1pt minus 0.5pt% space after section + + +\newif\ifappendix +\appendixfalse + +\mark{{0}{0}}\vskip 0pt minus 100pt +%\hbox{Mark empty empty}% +\def\thesection{\the\sectioncount} +\def\topsection{\the\sectioncount} + +%\def\sectionbox#1{\hskip-\marginwidth\hbox to \marginwidth{#1\hfil}} + +\def\heading#1#2{% +\def\secno{{\noindent\large\bf\strut{#1}#2}}% +\par\ifhmode\unskip\fi% end paragraph and remove vertical space +\penalty-500 +\vskip 0pt plus 72pt%allow some empty space at the bottom +\penalty-500 +\vskip 0pt plus -72pt% room for stetching and a page break +\hbox{}\vskip\abovesecskip% space above the section +%%\titletrue % omits page header for section +%\hbox{Mark null null}% +\mark{{0}{0}}% +\secno% The section title +\mark{{\sectionname}{\sectionname}}% +%\message{Mark heading {\sectionname}{\subsectionname}} +\nobreak\vskip\belowsecskip% space after section +\everypar{{\setbox0=\lastbox}\everypar{}}% no indentation in the next paragraph +\ignorespaces} + + + +\newcount\plaincount +\def\plainsection#1{% +\mark{{\sectionname}{\subsectionname}}% +%\message{Mark plain {\sectionname}{\subsectionname}} +\subsubsectioncount=0\subsectioncount=0% +\advance\plaincount by 1\relax +\def\thesection{} +\sectionpage% +\gdef\sectionname{#1}% +\gdef\subsectionname{#1}% +\gdef\codetitle{#1}% +\gdef\subcodetitle{#1}% +\tocsection{0}{}{#1} +\heading{}{#1}% +} + + +\gdef\sectionname{} +\gdef\subsectionname{} +\gdef\codetitle{}% +\gdef\subcodetitle{} + +\def\sectionpage{% +\vfil\break +\ifodd\pageno\else +\hbox{}% +\titletrue +\fi +\vfil\break +} + + +\def\section#1{% +\mark{{\sectionname}{\subsectionname}}% +%\message{Mark section {\sectionname}{\subsectionname}} +\subsubsectioncount=0\subsectioncount=0% +\advance\sectioncount by 1%updating counts +\let\thesection\topsection +\sectionpage% +\gdef\sectionname{\topsection\quad#1}% +\gdef\subsectionname{\thesection\quad#1}% +\gdef\codetitle{#1}% +\gdef\subcodetitle{#1}% +\ifnum\sectioncount=1\ifappendix\tocsection{0}{}{Appendix}\heading{}{Appendix}\fi\fi +\tocsection{0}{\thesection}{#1}% +\heading{\thesection~}{#1}% +} + + +\def\subsection#1{% +\subsubsectioncount=0\advance\subsectioncount by 1%updating counts +\def\thesection{\topsection.\the\subsectioncount} +\def\secno{{\noindent\bf\strut\sectionbox{\thesection~}#1}}% +\par\ifhmode\unskip\fi% end paragraph and remove vertical space +\tocsection{1}{\thesection}{#1}% +\penalty-200 +\vskip 0pt plus 36pt% allow some empty space at the bottom +\penalty-200 +\vskip 0pt plus -36pt% room for stetching and a page break +\gdef\subsectionname{\thesection\quad#1}% +\mark{{\sectionname}{\subsectionname}}% +%\message{Mark subsection {\sectionname}{\subsectionname}} +\vskip\abovesubsecskip% space above the subsection +\secno% The subsection title +\gdef\subcodetitle{#1}% +%\mark{{\sectionname}{\subsectionname}}% +%\hbox{Mark {\sectionname}{\subsectionname}}% +\nobreak\vskip\belowsubsecskip% space after subsection +\everypar{{\setbox0=\lastbox}\everypar{}}% no indentation in the next paragraph +\ignorespaces} + + +\def\subsubsection#1{% +%\mark{{\sectionname}{\subsectionname}}% +%\hbox{Mark {\sectionname}{\subsectionname}}% + \advance\subsubsectioncount by 1%updating counts +\def\thesection{\topsection.\the\subsectioncount.\the\subsubsectioncount} +\def\secno{{\noindent\it\strut\sectionbox{\thesection~}#1}}% +\par\ifhmode\unskip\fi% end paragraph and remove vertical space +\tocsection{2}{\thesection}{#1}% +\penalty-200 +\vskip 0pt plus 36pt% allow some empty space at the bottom +\penalty-200 +\vskip 0pt plus -36pt% room for stetching and a page break +\vskip\abovesubsecskip% space above the subsection +\secno% The subsubsection title +\nobreak\vskip\belowsubsecskip% space after subsection +%\everypar{{\setbox0=\lastbox}\everypar{}}% no indentation in the next paragraph +%\noindent +\ignorespaces} + +%% +%% Appendix +%% + +\def\Alphanum#1{% + \ifcase#1\or A\or B\or C\or D\or E\or F\or G\or H\or I\or J\or + K\or L\or M\or N\or O\or P\or Q\or R\or S\or T\or U\or V\or W\or X\or + Y\or Z\else\number#1\fi} + +\def\appendix{% +\mark{{\sectionname}{\subsectionname}}% +%\message{Mark appendix {\sectionname}{\subsectionname}} +\sectioncount=0 +\subsectioncount=0 +\gdef\thesection{\Alphanum\sectioncount}% +\gdef\topsection{\Alphanum\sectioncount}% +\appendixtrue +} + +%% +%% Crossreference of Identifiers and Sections +%% +\iftrue %% No Crossreference of identifiers + \def\inx{\def\lr{L}} % this tells whether the left or right column is next +\else +\def\inx{% + \hsize=\pagewidth + \def\page{\box255 } \normalbottom + \output{\ifpagesaved\normaloutput{\box\sbox}\lheader\rheader\fi + \global\setbox\sbox=\page \global\pagesavedtrue} + \pagesavedfalse + \plainsection{Crossreference of Identifiers}% we are beginning the index + \mark{{0}{0}}% +%\hbox{Mark empty empty}% + \eject % eject the page-so-far and predecessors + \setbox\sbox\vbox{\unvbox\sbox} % take it out of its box + \vsize=\pageheight \advance\vsize by -\ht\sbox % the remaining height + \hsize=.5\pagewidth \advance\hsize by -10pt + % column width for the index (20pt between cols) + \parfillskip 0pt plus .6\hsize % try to avoid almost empty lines + \def\lr{L} % this tells whether the left or right column is next + \output{\if L\lr\global\setbox\lbox=\page \gdef\lr{R} + \else\nomarginoutput{\vbox to\pageheight{\box\sbox\vss + \hbox to\pagewidth{\box\lbox\hfil\page}}}\lheader\rheader + \global\vsize\pageheight\gdef\lr{L}\global\pagesavedfalse + \mark{{Crossreference of Identifiers}{Crossreference of Identifiers}}% + \fi} + \parfillskip 0pt plus 1fil + \let\topsecno=\nullsec + \message{Crossreference of Identifiers:} + \parskip 0pt plus .5pt + \outer\def\I##1, ##2.{\par\hangindent2em\noindent##1:\kern1em + \ifbook##2\else\ifpdf\pdfnote##2.\else##2\fi\fi.} % index entry + \def\[##1]{$\underline{##1}$} % underlined index item + \rm \rightskip0pt plus 2.5em \tolerance 10000 \let\*=\lapstar + \hyphenpenalty 10000 \parindent0pt + \small + \readindex +} +\fi + +\def\fin{% + \if L\lr\mark{{}{}}\fi + \vfill\eject % complete the current column. + \mark{{}{}} + \if R\lr\null\vfill\eject\fi % if necessarry add a right column + \setpage + \def\page{\box255 } \normalbottom + \output={\nomarginoutput\page\lheader\rheader} +} +\ifbook +\let\crosssections=\relax +\else +\def\crosssections{ + \plainsection{Crossreference of Code}% this is done when we are ending the index + \parindent 0pt + \parfillskip 0pt plus 1fil + \let\topsecno=\nullsec + \message{Crossreference of Code:} + \def\note##1##2.{\hfil\penalty-1\hfilneg\quad{\tiny##1~\ifbook##2\else + \ifpdf{\pdfnote##2.}\else + \ifhint\codenote##2.\else##2.\fi\fi\fi}} + \def\Q{\note{Cited in section}} % crossref for mention of a section + \def\Qs{\note{Cited in sections}} % crossref for mentions of a section + \def\U{\note{Used in}} % crossref for use of a section + \def\Us{\note{Used in}} % crossref for uses of a section + \def\I{\par\hangindent 2em}\let\*=* + \def\X##1:##2\X{\ifmmode\gdef\XX{\null$\null}\else\gdef\XX{}\fi %$% section name + \XX$\langle\,${\let\I=\ne##2}$\,\rangle$\XX\quad{\tiny Defined in~\codenote##1.}} + \readsections +} +\fi + + + +%% +%% Table of Content +%% + +% we separate the identification of a section used in links +%from the identification on paper, because plain sections dont +%have the latter. +\newcount\toccount +\toccount=0 + +\def\tocsection#1#2#3{% depth sectionnumber sectiontitle +\global\advance\toccount by 1% +\newdest{SC.\the\toccount}% +\ifhint + \immediate\write\cont{\noexpand\ZZ {#1}{#2}{#3}% write to contents file + {\noexpand\thepageno}{\the\toccount}} +\else +\edef\next{\write\cont{\noexpand\ZZ {#1}{#2}{#3}% write to contents file + {\noexpand\thepageno}{\the\toccount}}}\next % \tocline{depth}{sec}{title}{page}{toccount} +\fi +} + +\output{ + \ifhint + \shipout\box255\relax% otherwise I loose open, write, or close commands + \else + \setbox0=\page % the first page is garbage + \fi +% \openout\cont=\contentsfile +% \write\cont{\catcode `\noexpand\@=11\relax} % \makeatletter + \global\output{\normaloutput\page\lheader\rheader}} + + +\newbox\tocbox +\def\maketoc{% + \typeout{Reading table of contents} + \setbox\tocbox\vbox{% + \let\ZZ=\tocline + \ifbook\else\ifpdf\startpdf\fi\fi + \readcontents\relax + } + \typeout{Writing \contentsfile} + \immediate\openout\cont=\contentsfile\relax + \immediate\write\cont{\catcode `\noexpand\@=11\relax} +} + +\def\tableofcontent{\plainsection{Contents}\ifhint\HINTdest name {HINT.home}\fi +\unvbox\tocbox +} + + +\def\tocline#1#2#3#4#5{% depth sectionnumber sectiontitle page toccount +\ifnum#1=0 \smallskip\vskip 0pt plus 12pt\penalty -100\vskip 0pt plus -12pt\fi +\noindent +\line{% +\ifnum#1=0% + \hbox to 2em{\bf#2\hfill}{\bf#3~}\hfill + \hbox to 2em{\hss\bf\tocref{#1}{#3}{#4}{#5}}% +\else \ifnum#1=1% + \kern 2em\hbox to 3em{\rm#2\hfill}{\rm#3~}\leaders\hbox to .5em{.\hfil}\hfill + \hbox to 2em{\hss\tocref{#1}{#3}{#4}{#5}}% +\else + \kern 2em\hbox to 5em{\rm#2\hfill}{\it#3~}\leaders\hbox to .5em{.\hfil}\hfill + \hbox to 2em{\hss\tocref{#1}{#3}{#4}{#5}}\fi\fi +}} + + + +%% +%% Figures and Tables +%% + +\def\fig#1{\global\advance\figcount by 1% +\ifvmode\noindent\fi +\def\captype{Fig}% +\capskip=1em% +\vbox{\nointerlineskip\figdest +\hbox{\noindent#1\hskip -2pt\hskip 0pt plus 2pt minus 2pt}% +\medskip +\rlap{\small\unhbox\capbox}% +}} + +\def\tab#1{% +\ifvmode\noindent\fi +\def\captype{Tab}% +\capskip=0pt% +\vbox{#1\medskip\rlap{\small\unhbox\capbox}}} + +\def\table#1#2{\global\advance\tabcount by 1% +\ifvmode\noindent\fi +\def\captype{Tab}% +\capskip=0pt% +\vbox{\offinterlineskip\tabdest + \halign{\large\strut + \vrule##&&\quad\hfil##\hfil\quad\vrule\cr + \noalign{\hrule}#2\noalign{\hrule}}% + \medskip + \tabcaption{#1}% + \rlap{\small\unhbox\capbox}% + }% +} + +\def\captype{} +\newdimen\capskip +\capskip=1em +\newbox\capbox +\setbox\capbox\hbox{} +\newcount\figcount +\figcount=0 +\newcount\tabcount +\tabcount=0 + +\def\nextfigcaption#1{\small\strut\it\hskip\capskip\figindex{\captype}{\the\figcount}{#1}\captype.~\the\figcount:} + +\def\caption#1{\global\setbox\capbox\hbox{\nextfigcaption{#1} #1}} + +\def\nexttabcaption#1{\small\strut\it\hskip\capskip\tabindex{\captype}{\the\tabcount}{#1}\captype.~\the\tabcount:} +\def\tabcaption#1{\global\setbox\capbox\hbox{\nexttabcaption{#1} #1}} + + +%\long\def\leftfig#1#2#3{% +%\ifvmode\noindent\fi +%\def\captype{Fig}% +%\capskip=1em% +%\vbox{% +% \tabskip=0pt\halign to \hsize{% +% \vtop{\vskip 0pt\parskip=0pt\hsize=62.5mm\relax +% ##}\tabskip=5mm plus 2pt minus 2pt& +% \vtop{\vskip 0pt\parskip=0pt\hsize=62.5mm\relax##}\tabskip=0pt\cr +% #1&\capskip=0pt\nextfigcaption{#2} #3\cr}\medbreak}} + +\long\def\leftright#1#2#3#4{% +\ifvmode\noindent\else\par\noindent\fi +\vbox{\nointerlineskip + \advance\hsize by -\leftskip\advance\hsize by -\rightskip% + \leftskip=0pt\rightskip=0pt% + \hbox to \hsize{\strut + \raise\ht\strutbox + \vtop{\vskip 0pt\parskip=0pt\hsize=#1\hsize\advance\hsize by -2.5mm\relax + \noindent\strut\ignorespaces#3\vfill}\hfil + \raise\ht\strutbox + \vtop{\vskip 0pt\parskip=0pt\hsize=#2\hsize\advance\hsize by -2.5mm\relax + \noindent\strut\ignorespaces#4\vfill}}}} + + +\long\def\leftfig#1#2#3{% +\def\captype{Fig}% +\capskip=0pt% +\leftright{0.5}{0.5}{#1\kern -2pt\hskip 2pt plus 2pt minus 2pt}{\nextfigcaption{#2}\strut #3}} + + +\def\subindex#1{% + \par\ifhmode\unskip\fi% end paragraph and remove vertical space + \vskip\abovesubsecskip% space above the subsection + \vskip 0pt plus 72pt% allow some empty space at the bottom + \penalty-200\vskip 0pt plus -72pt % room for stetching and a page break + \noindent{\bf\strut#1}% + \nobreak\vskip\belowsubsecskip% space after subsection + \everypar{{\setbox0=\lastbox}\everypar{}}% no indentation in the next paragraph + \ignorespaces +} + +\newwrite\@figfile +\newwrite\@tabfile + +\def\makefigindex{% + \immediate\openout\@figfile=\jobname.fig\relax + \def\figindex{\@bsphack\begingroup\@sanitize\@wrfigindex\@figfile}% + \immediate\openout\@tabfile=\jobname.tab\relax + \def\tabindex{\@bsphack\begingroup\@sanitize\@wrfigindex\@tabfile}% + \typeout{Writing index files \jobname.fig \jobname.tab} +} + +\newdimen\iboxsize +\def\thefigindex{% + + \immediate\closeout\@figfile\relax + \immediate\closeout\@tabfile\relax + %\small\baselineskip=11pt + \plainsection{List of Figures and Tables} + \makeatletter + \iboxsize=3.7em\relax + \subindex{Figures} + \def\indexentry##1##2##3##4{% captype, fig/tab count, caption, page + \noindent + \line{\hbox to \iboxsize{% + \rm##1.~##2:\hfil}{\rm ##3}\ \leaders\hbox to .5em{.\hfil}% + \hfill\hbox to 1.4em{\hss + \ifbook##4\else + \ifpdf + \pagelnk{##4}% + \else\ifhint\figlink{##2} + \else##4\fi\fi\fi + }}\par + }% + \input\jobname.fig\relax + \iboxsize=3.9em\relax + \subindex{Tables} + \def\indexentry##1##2##3##4{% captype, fig/tab count, caption, page + \noindent + \line{\hbox to \iboxsize{% + \rm##1.~##2:\hfil}{\rm ##3}\ \leaders\hbox to .5em{.\hfil}% + \hfill\hbox to 1.4em{\hss + \ifbook##4\else + \ifpdf + \pagelnk{##4}% + \else\ifhint\tablink{##2} + \else##4\fi\fi\fi + }}\par + }% + \input\jobname.tab\relax + \makefigindex +} + + +\def\@wrfigindex#1#2#3#4{% file, captype, fig/tab count, caption + \xdef\gtempa{\write#1{\string\indexentry{#2}{#3}{#4}{\noexpand\thepageno}}}\endgroup\gtempa + \if@nobreak\ifvmode\@nobreak\fi\fi\@esphack} + +%% +%% Format Definitions +%% + +%\newbox\codebox +\newwrite\@getfile +\newwrite\@putfile +\newwrite\@redfile +\newwrite\@wrtfile + +\def\makecode{% + \immediate\openout\@getfile=\jobname.get\relax + \immediate\openout\@putfile=\jobname.put\relax + \immediate\openout\@redfile=\jobname.red\relax + \immediate\openout\@wrtfile=\jobname.wrt\relax + \typeout{Writing index files \jobname.get \jobname.put \jobname.red \jobname.wrt} +} + +\def\thecodeindex{% + \immediate\closeout\@getfile\relax + \immediate\closeout\@putfile\relax + \immediate\closeout\@redfile\relax + \immediate\closeout\@wrtfile\relax + \def\indexentry##1##2##3##4{% codecount, depth, pagenumber, section + \ifnum##2=0 \smallskip\vskip 0pt plus 12pt\penalty -100\vskip 0pt plus -12pt\fi + \noindent + \line{% + \ifnum##2=0##4\hfill + \else\qquad\rm##4\ \leaders\hbox to .5em{.\hfil}\hfill + \hbox to 1.4em{\hss\pagelnk{##3}} + \fi + }\par + }% + \section{Format Definitions} + \makeatletter + \subsection{Reading the Long Format}\label{codeindex} + \input\jobname.red.srt\relax + \subsection{Writing the Long Format} + \input\jobname.wrt.srt\relax + \subsection{Reading the Short Format} + \input\jobname.get.srt\relax + \subsection{Writing the Short Format} + \input\jobname.put.srt\relax +} + + +\newcount\codecount +\codecount=0 + +\ifhint +\def\@wrcodeindex#1#2#3#4{% file, depth, pagenumber, [sub]sectionname + \global\advance\indexcount by 1\indexdest + \xdef\gtempa{\write#1{\string\indexentry{#3}{#2}{\the\indexcount}{#4}}}\endgroup\gtempa\@esphack +} +\else +\def\@wrcodeindex#1#2#3#4{% file, depth, pagenumber, [sub]sectionname + \xdef\gtempa{\write#1{\string\indexentry{#3}{#2}{\noexpand\thepageno}{#4}}}\endgroup\gtempa\@esphack +} +\fi + +\def\getindex{\@bsphack\begingroup\@sanitize\@wrcodeindex\@getfile}% +\def\putindex{\@bsphack\begingroup\@sanitize\@wrcodeindex\@putfile}% +\def\redindex{\@bsphack\begingroup\@sanitize\@wrcodeindex\@redfile}% +\def\wrtindex{\@bsphack\begingroup\@sanitize\@wrcodeindex\@wrtfile}% + + +\def\codelabel#1#2#3{ + \getindex{#1}{#2}{#3}% + \putindex{#1}{#2}{#3}% + \redindex{#1}{#2}{#3}% + \wrtindex{#1}{#2}{#3}} +\def\getsymbol{$\cdots\Longrightarrow$} +\def\putsymbol{$\Longrightarrow\cdots$} +\def\redsymbol{$-{}-{}-{}\Longrightarrow$} +\def\wrtsymbol{$\Longrightarrow{}-{}-{}-$} +\def\getcode{\codesection{\getsymbol}{Reading the short format}\getindex{1}{\the\codecount}{\subcodetitle}} +\def\putcode{\codesection{\putsymbol}{Writing the short format}\putindex{1}{\the\codecount}{\subcodetitle}} +\def\writecode{\codesection{\wrtsymbol}{Writing the long format}\wrtindex{1}{\the\codecount}{\subcodetitle}} +\def\readcode{\codesection{\redsymbol}{Reading the long format}\redindex{1}{\the\codecount}{\subcodetitle}} +\newdimen\coderule +\def\codesection#1#2{% + \par\ifhmode\unskip\fi% end paragraph and remove vertical space + \penalty-200 + \vskip 0pt plus 72pt% allow some empty space at the bottom + \penalty-200 + \vskip 0pt plus -72pt% room for stetching and a page break +\vskip\abovesubsecskip% space above the subsection +%\line{\setbox0=\hbox{#1}% +%\coderule=\hsize\advance\coderule by -\wd0\advance\coderule by -2em% +%$\vcenter{\hrule width \coderule}$\hss\box0} +\line{{\it #2\/}:\hfill#1} +\nobreak\vskip\belowsubsecskip\nobreak% space after subsection +%\everypar{{\setbox0=\lastbox}\everypar{}}% no indentation in the next paragraph +%\noindent +\ignorespaces} + +\def\hascode{\global\advance\codecount by 1% +\codelabel{0}{\the\codecount}{\codetitle}}% + + +%% +%% Makeindex and the Index +%% + +\newwrite\@indexfile + +% new jobname for index file +\def\makeindex{ + \immediate\openout\@indexfile=\jobname.inx% + \def\index{\@bsphack\begingroup\@sanitize\@wrindex\@indexfile}% + \typeout{Writing index file \jobname.inx }% +} + +\def\@idxitem{\par\hangindent 40pt} + +\newif\ifnextindex +\nextindexfalse + +\def\beginindex{% +\ifhint\relax\else + \def\page{\box255} \normalbottom + \output{\ifpagesaved\normaloutput{\box\sbox}\lheader\rheader\fi + \global\setbox\sbox=\page \global\pagesavedtrue} + \pagesavedfalse \eject % eject the page-so-far and predecessors + \setbox\sbox\vbox{\unvbox\sbox} % take it out of its box + \vsize=\pageheight \advance\vsize by -\ht\sbox % the remaining height + \hsize=.5\pagewidth \advance\hsize by -10pt + % column width for the index (20pt between cols) + \parfillskip 0pt plus .6\hsize % try to avoid almost empty lines + \def\lr{L} % this tells whether the left or right column is next + \output{\if L\lr\global\setbox\lbox=\page \gdef\lr{R} + \else\nomarginoutput{\vbox to\pageheight{\box\sbox\vss + \hbox to\pagewidth{\box\lbox\hfil\page}}}\lheader\rheader + \global\nextindextrue + \global\vsize\pageheight\gdef\lr{L}\global\pagesavedfalse\fi} +\fi +\message{Index:} +\mark{{0}{0}} +\noindent\par +\begingroup + \rightskip 0pt plus 12pt + \parskip 0pt plus .5pt + \hyphenpenalty 10000 \parindent0pt + \small\baselineskip=11pt +\def\item{\par\hangindent 40pt\relax\ifnextindex\mark{{Index}{Index}}\fi}% +\def\subitem{\par\hangindent 40pt\hskip 20pt\relax}% +\def\subsubitem{\par\hangindent 40pt\hskip 30pt\relax}% +\def\indexspace{\par\vskip 12pt plus 6pt minus 4pt\vskip 12pt\goodbreak\vskip -12pt\relax}% +\def\indexheading##1{{\tenbf ##1}\nobreak\vskip 3pt\relax} +} +\def\endindex{% +\endgroup + \vfill\eject % complete the current column. +\ifhint\relax\else + \if R\lr\null\vfill\eject\fi % if necessarry add a right column +\fi +} + + +%% +%% Label page, section, toccount, figure, table, code, enum +%% +\newcount\cdcount +\cdcount=0 + +\newdimen\labelskip +\def\label#1{% writes \labeldef{name}{{page}{section}{toccount}{figure}{table}{code}{enum}} to aux + \ifhint + \global\advance\indexcount by 1\indexdest + \begingroup\@readauxfile + \edef\next{\@writeaux{\string\labeldef{#1}{{\the\indexcount}% + {\thesection}{\the\toccount}{\the\figcount}{\the\tabcount}{\the\cdcount}{\the\enum}}}\endgroup}% + \else + \begingroup\@readauxfile + \edef\next{\@writeaux{\string\labeldef{#1}{{\noexpand\thepageno}% + {\thesection}{\the\toccount}{\the\figcount}{\the\tabcount}{\the\cdcount}{\the\enum}}}\endgroup}% + \fi + \ifvmode %make \removelastskip work after \label + \labelskip=\lastskip + \vskip-\labelskip + \next + \vskip\labelskip + \else + \next + \fi +} + + +\def\m@kelabel#1{label@#1}% this makes the controlseqence from the name + +\def\labeldef#1#2{% #1 is name #2 is page section subsection figure table code +\expandafter\gdef\csname\m@kelabel{#1}\endcsname{#2}}% + +\def\@setref#1#2#3{% + \ifx#1\relax + \message{Undefined reference: #3} + \else + \expandafter#2#1% + \fi} + +\def\@iofvii#1#2#3#4#5#6#7{#1} +\def\@iiofvii#1#2#3#4#5#6#7{#2} +\def\@iiiofvii#1#2#3#4#5#6#7{#3} +\def\@ivofvii#1#2#3#4#5#6#7{#4} +\def\@vofvii#1#2#3#4#5#6#7{#5} +\def\@viofvii#1#2#3#4#5#6#7{#6} +\def\@viiofvii#1#2#3#4#5#6#7{#7} + + +\def\pageref#1{\@readauxfile + \pagelnk{\expandafter\@setref\csname\m@kelabel{#1}\endcsname\@iofvii{#1}}} +\def\secref#1{\@readauxfile + \sectionlink + {\expandafter\@setref\csname\m@kelabel{#1}\endcsname\@iiofvii{#1}}% + {\expandafter\@setref\csname\m@kelabel{#1}\endcsname\@iiiofvii{#1}}% +} +\def\figref#1{\@readauxfile +\figlink{\expandafter\@setref\csname\m@kelabel{#1}\endcsname\@ivofvii{#1}}} +\def\tabref#1{\@readauxfile +\tablink{\expandafter\@setref\csname\m@kelabel{#1}\endcsname\@vofvii{#1}}} +\def\cdref#1{\@readauxfile +\expandafter\@setref\csname\m@kelabel{#1}\endcsname\@viofvii{#1}} +\def\enumref#1{\@readauxfile +\enumlink{\expandafter\@setref\csname\m@kelabel{#1}\endcsname\@viiofvii{#1}}} + +%% +%% Links and Destinations +%% + +\ifbook + \def\pdflinkcolor{0 0 0} % the RGB values for hyperlink color + \def\linkcolor{\Black} + \def\pdflink#1#2{#1} + \def\pdfnote#1.{#1} + \message{No PDF Links} +\else + \def\pdflinkcolor{0 0 1} % the RGB values for hyperlink color + \def\linkcolor{\Blue} + \message{PDF Links are blue} +\fi + +\def\@esphack{\relax\ifhmode\spacefactor\@savsf + {}\ifdim \@savsk >\z@ \ignorespaces + \fi \fi} + +% +% Code destinations: by number +% + +%The number is set be \M and \N and stored as \secno +%The destination is set in \B where we go into C mode +\def\codedest{% +\ifbook\else +\ifhint\HINTdest num \thecode top\relax +\else\ifpdf\pdfdest num \thecode fith\relax +\else\relax +\fi\fi\fi +} +\def\coderef#1{% used in \X +\ifbook${}_{#1}$\else +\ifhint\HINTstartlink goto num #1 \hbox{${}_{#1}$}\HINTendlink +\else\ifpdf{\eightrm\pdfnote#1.} +\else${}_{#1}$\fi\fi\fi +} + +\def\codenote#1.{% replaces \pdfnote + \setbox0=\hbox{\toksA={#1.}\toksB={}\maketoks}\the\toksA} +% define the following like for pdf +\def\firstsecno#1.{\setbox0=\hbox{\toksA={#1.}\toksB={}% + \def\makenote{\addtokens\toksB{\the\toksC}\def\makenote{\toksD={} + \toksC={}\let\space\empty}\makenote}\maketoks}} +\def\addtokens#1#2{\edef\addtoks{\noexpand#1={\the#1#2}}\addtoks} +\def\poptoks#1#2|ENDTOKS|{\let\first=#1\toksD={#1}% + \ifcat\noexpand\first0\countB=`#1\else\countB=0\fi\toksA={#2}} +\def\maketoks{\expandafter\poptoks\the\toksA|ENDTOKS|% + \ifnum\countB>`9 \countB=0 \fi + \ifnum\countB<`0 + \ifnum0=\countC\else\makenote\fi + \ifx\first.\let\next=\maketoksdone\else + \let\next=\maketoks + \addtokens\toksB{\the\toksD} + \ifx\first,\addtokens\toksB{\space}\fi + \fi + \else \addtokens\toksC{\the\toksD}\global\countC=1\let\next=\maketoks + \fi + \next +} +\def\makenote{\addtokens\toksB + {\noexpand\codelink{\the\toksC}{\romannumeral\the\toksC}}\toksC={}\global\countC=0} +\def\maketoksdone{\edef\st{\global\noexpand\toksA={\the\toksB}}\st} + +\def\codelink#1#2{ +\ifbook#1\else +\ifhint\HINTstartlink goto num #1 #1\HINTendlink +\else\ifpdf\pdflink{#1}{#2}% +\else#1% +\fi\fi\fi} + +% +% new destinations and links: by name +% + +\def\newdest#1{% used to make a new destination +%\message{New destination #1}% +\ifbook +\else\ifpdf + \pdfdest name {#1} fith%\message{Defining pdf label #1}% +\else\ifhint + \HINTdest name {#1}%\message{Defining HINT label #1}% +\fi\fi\fi} + +\def\newlink#1#2{% + \ifbook #2\else + \ifpdf + \pdfstartlink goto name {#1}\linkcolor#2\Black\pdfendlink + \else\ifhint + \HINTstartlink goto name {#1}#2\HINTendlink + \else + #2% + \fi\fi\fi +} + + +%SC.-\the\plaincount for plain sections +%SC.\thesection for regular sections, with subsections and letters for the appendix + +\def\tocref#1#2#3#4{% depth, title, page, label used in tocline + \ifbook#3\else + \ifpdf + \pdfstartlink goto name {SC.#4}\relax \linkcolor#3\Black\pdfendlink + \ifnum#1=0\pdfoutline goto name {SC.#4} {#2}\fi + \else\ifhint + \HINTstartlink goto name {SC.#4}\relax $\rightarrow$\HINTendlink + \HINToutline goto name {SC.#4} depth #1 {#2}% + \else + #3% + \fi\fi\fi +}% + +% +% Page references from the index +% + +% \index{keyword} -> \@wrindex{file}{keyword} writes the nectessary information +% makeindex produces the index and pages are enclosed in \hyperref{pagenumber} +% Problems: +% pagenumbers may be roman numerals in the frontmatter +% hyperpage has to cope with 6 different formats +% \hyperpage{50} a single page number +% \hyperpage{51, 52} two numbers +% \hyperpage{53--59} a page range +% \hyperpage{xi} a roman numeral +% \hyperpage{xi, xii} two numbers +% \hyperpage{xi--xx} a page range + + +% Writing the index file: in HINT replacing the page number by the index count +\newcount\indexcount +\def\theindexcount{\the\indexcount} + +\ifhint + \def\@wrindex#1#2{% file, keyword + \global\advance\indexcount by 1\indexdest + \immediate\write#1{\string + \indexentry{#2:hyperpage}{\the\indexcount}}\endgroup + \if@nobreak \ifvmode\@nobreak\fi\fi\@esphack} + \else + \def\@wrindex#1#2{% + \xdef\gtempa{\write#1{\string + \indexentry{#2:hyperpage}{\noexpand\thepageno}}}\endgroup\gtempa + \if@nobreak \ifvmode\@nobreak\fi\fi\@esphack} +\fi + + +% for HINT and PDF we used hyperrange and hypercomma to split the +% arguments into index/page numbers and then use pagelink +\ifbook + \def\hyperpage#1{#1}\else +\ifhint + \def\hyperpage#1{\hyperrange#1----+\relax} +\else\ifpdf + \def\hyperpage#1{\hyperrange#1----+\relax} +\else + \def\hyperpage#1{#1} +\fi\fi\fi + +%\def\indexlink#1{#1} + +\def\hyperrange#1--#2--#3+{% + \ifx\empty#2\empty% + \hypercomma#1, ,+% + \else\ifhint + \pagelnk{#1}--\pagelink{#2}{$\leftarrow$}% + \else + \pagelnk{#1}--\pagelnk{#2}% + \fi\fi} + +\def\hypercomma#1, #2,#3+{% + \ifx\empty#2\empty% + \pagelnk{#1}% + \else\ifhint% + \pagelink{#1}{$\longrightarrow$}% + \else + \pagelnk{#1}% +% I omit the second page number \ifpdf, \pagelnk{#2}\fi + \fi\fi +} + + +% +% Labels +% + +% section references from \secref use \sectionlink +% for plainsections, we display the label name because there +%is no section number. + +\def\sectionlink#1#2{% \message{Sectionlink #1 : #2}% + \ifbook#1\else + \ifpdf + \pdfstartlink goto name {SC.#2} \linkcolor#1\Black\pdfendlink + \else\ifhint + \HINTstartlink goto name {SC.#2}#1\HINTendlink + \else + #1% + \fi\fi\fi +} + + +% page references from \label and \pageref use \pagelink as before +\def\indexdest{\newdest{page.\the\indexcount}} +\def\pagelnk#1{% + \ifhint + \pagelink{#1}{$\rightarrow$}% + \else + \pagelink{#1}{#1}% + \fi +} +\def\pagelink#1#2{\newlink{page.#1}{#2}} +% For hint the destination is generated with each \index and \label +% Because of the roman numerals, for pdf files +% the pdf destination is generated in the header using \pagelabel + + +\ifbook\let\pagelabel=\relax\else +\ifpdf +\def\pagelabel{\pdfdest name {page.\thepageno} fitv\relax} +\else +\let\pagelabel=\relax +\fi\fi + +% references to Figures, Tables, Enumerations +\def\figdest{\newdest{FI.\the\figcount}} +\def\figlink#1{\newlink{FI.#1}{#1}} +\def\tabdest{\newdest{TA.\the\tabcount}} +\def\tablink#1{\newlink{TA.#1}{#1}} +\def\enumdest{\newdest{EN.\the\enum}} +\def\enumlink#1{\newlink{EN.#1}{#1}} + +% +% References to the bibliography +% +\def\citedest#1{\newdest{CI.#1}} +\def\citelink#1{%\message{Citelink #1}% + \newlink{CI.#1}{#1}} + +\def\bblhook{%defined before reading the .bbl file + \def\biblabelprint##1{% + \citedest{##1}% + \noindent + \hbox to \biblabelwidth{% + \biblabelprecontents + \biblabelcontents{##1}% + \biblabelpostcontents + }% + \kern\biblabelextraspace + }% +} +\def\@onecitation#1\@@{%called for each citation + \if@notfirstcitation + \printbetweencitations + \fi + % + \expandafter \ifx \csname\@citelabel{#1}\endcsname \relax + \if@citewarning + \message{\@linenumber Undefined citation `#1'.}% + \fi + % Give it a dummy definition: + \expandafter\gdef\csname\@citelabel{#1}\endcsname{% + {\tt + \escapechar = -1 + \nobreak\hskip0pt + \expandafter\string\csname#1\endcsname + \nobreak\hskip0pt + }% + }% + \fi + % Now produce the text, whether it was undefined or not. + \citelink{\csname\@citelabel{#1}\endcsname}% + \@notfirstcitationtrue +}% +%% +%% Images +%% + +\ifbook +\def\includefig#1{\leavevmode\hbox{\immediate\pdfximage{image/#1.pdf}\pdfrefximage\pdflastximage}} +\else\ifpdf +\def\includefig#1{\leavevmode\hbox{\immediate\pdfximage{image/#1.pdf}\pdfrefximage\pdflastximage}} +\else\ifhint + \def\includefig#1{\image=image/#1.png\relax} +\else + \input epsf.tex + \def\includefig#1{\epsfbox{image/#1.eps}}% this is a \leavevmode\hbox{...} +\fi\fi\fi + +\ifhint\eject\fi% hitex will remove empty pages that were introduced by cwebmac +\makeatother + + + + + + + diff --git a/systems/doc/hitex/hitexman.hnt b/systems/doc/hitex/hitexman.hnt Binary files differnew file mode 100644 index 0000000000..f0e843bfa7 --- /dev/null +++ b/systems/doc/hitex/hitexman.hnt diff --git a/systems/doc/hitex/hitexman.pdf b/systems/doc/hitex/hitexman.pdf Binary files differnew file mode 100644 index 0000000000..6f96282e50 --- /dev/null +++ b/systems/doc/hitex/hitexman.pdf diff --git a/systems/doc/hitex/hitexman.tex b/systems/doc/hitex/hitexman.tex new file mode 100644 index 0000000000..2c58f877c4 --- /dev/null +++ b/systems/doc/hitex/hitexman.tex @@ -0,0 +1,707 @@ +% This file is part of HINT +% Copyright 2017-2021 Martin Ruckert, Hochschule Muenchen, Lothstrasse 64, 80336 Muenchen +% +% Permission is hereby granted, free of charge, to any person obtaining a copy +% of this software and associated documentation files (the "Software"), to deal +% in the Software without restriction, including without limitation the rights +% to use, copy, modify, merge, publish, distribute, sublicense, and/or sell +% copies of the Software, and to permit persons to whom the Software is +% furnished to do so, subject to the following conditions: +% +% The above copyright notice and this permission notice shall be +% included in all copies or substantial portions of the Software. +% +% THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR +% IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, +% FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE +% COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, +% WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT +% OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN +% THE SOFTWARE. +% +% Except as contained in this notice, the name of the copyright holders shall +% not be used in advertising or otherwise to promote the sale, use or other +% dealings in this Software without prior written authorization from the +% copyright holders. + +\input cwebmac +\input hint.sty + +\makeindex +\maketoc + +\titletrue +\pageno=-2 + +\def\lastrevision{${}$Revision: 2541 ${}$} +\def\lastdate{${}$Date: 2021-10-26 09:03:28 +0200 (Tue, 26 Oct 2021) ${}$} + +\font\largetitlefont=cmssbx10 scaled\magstep4 +\font\Largetitlefont=cmssbx10 at 40pt +\font\hugetitlefont=cmssbx10 at 48pt +\font\smalltitlefontit=cmbxti10 scaled\magstep3 +\font\smalltitlefont=cmssbx10 scaled\magstep3 + +\hbox{} +\vskip 0pt plus 1fill +{ + \baselineskip=1cm\parindent=0pt + \largetitlefont\raggedright Hi\TeX\par + \vskip 10pt plus 0.3fill + \leftline{\smalltitlefont User Manual} + \vskip-3pt + \vskip 10pt plus 0.3fill + \hskip 0pt plus 2fill \it F\"ur Beatriz\hskip 0pt plus 0.5fill\hbox{} + \vskip 10pt plus 3fill + \leftline{\smalltitlefont Version 1.1 (Draft)} + \bigskip + \raggedright\baselineskip=12pt + \bf MARTIN RUCKERT \ \it Munich University of Applied Sciences\par + \bigskip + \lastdate, \lastrevision\par + \smallskip +} +{\raggedright\advance\rightskip 3.5pc +\def\:{\discretionary{}{}{}} +\noindent +Internet page {\tt http:\://hint.\:userweb.\:mwn.\:de/\:hint/\:format.html} +may contain current information about this book, downloadable software, +and news. + +\smallskip +\noindent +Copyright $\copyright$ 2022 by Martin Ruckert +\smallskip +} +\frontmatter +\pageno=-1 + +\tableofcontent + +\mainmatter + +\def\rs{\hskip 2pt plus 3pt minus 2pt\penalty0\relax} +\def\rule#1:#2.{\par{\hangindent32pt\hangafter1\parindent0pt\rightskip 0pt plus 60pt#1{\bf:}\quad% + \hskip 0pt plus 60pt\penalty-300\hskip 0pt plus -60pt#2{\bf.}\par}} +\def\sym#1{\rs$<${\it #1\/}$>$\rs} +\def\OR{\rs${}\vert{}$\rs} +\def\opt#1{\rs$[{}$#1${}]$\rs} +\def\cs#1{\.{\BS #1}} + +\section{Hi\TeX\ primitives} + +While currently Hi\TeX\ is the only \TeX\ engine that supports output in the \HINT\ file +format, this might not be so forever. To avoid unnecessary complications for +package writers, it is strongly suggested that all such \TeX\ engines implement +the same primitives according to the same specification. The following is the first +draft of this specification. All the primitives use {\tt HINT} as a prefix to +avoid name conflicts. The prefix {\tt HINT}, as opposed to e.g. {\tt HiTeX}, +was chosen to stress the idea that these primitives are specific for the +output format---not for the \TeX\ engine. + +Because this is the first specification that will reach a wider user base, +it is reasonable to expect changes to occur in the future. Therefore it is +recommended that these primitives should not be used directly in a +\TeX\ document; instead they should be encapsulated in suitable +macros so that the consequences of any change to the primitives will +be local to these macros. + +\subsection{Syntax Description} +In the following, we describe the syntax of primitive control sequences which were +added to \TeX. + +\itemize +\item We use a {\tt typewriter font}\index{typewriter font} +for text that occurs \index{verbatim}verbatim in the \TeX\ document. +\item We use \sym{italics} enclosed in pointed brakets to denote symbols\index{symbol+\sym{symbol}}. +\item We use rules\index{rule} to define the meaning of symbols. +A rule starts with the symbol +to be explained, followed by a colon ``{\bf :}'', and then the text that this symbol +stands for. A rule ends with a period ``{\bf .}''. +\item Optional\index{optional+\opt{optional}} parts of the rule's text +are enclosed in \opt{square brackets}. +\item Alternatives\index{alternative} are seperated by a vertical bar ``\OR''\index{\OR}. +\item Some symbols refere to text that is defined as part of standard \TeX. These are explained here by an example: + +\medskip +\rule\sym{integer}: \index{integer+\sym{integer}} + an integer as in \cs{penalty}\sym{integer}. +\rule\sym{normal dimension}:\index{normal dimension+\sym{normal dimension}} + a dimension as in \cs{hrule} \.{width} \sym{normal dimension}. +\rule\sym{dimension}:\index{dimension+\sym{dimension}} + a dimension as in \cs{vskip} \.{0pt} \.{plus} \sym{dimension}. +\rule\sym{name}:\index{dimension+\sym{dimension}} + a name as in \cs{input} \sym{name}. +\rule\sym{vertical list}:\index{vertical list+\sym{vertical list}} + a token list with matching braces as in + \cs{vbox}\.{\LB}\sym{vertical list}\.{\RB}. +\rule\sym{horizontal list}:\index{horizontal list+\sym{horizontal list}} + a token list with matching braces as in + \cs{hbox}\.{\LB}\sym{horizontal list}\.{\RB}. +\rule\sym{general text}:\index{general text+\sym{general text}} + a token list with matching braces as in + \cs{write}\.{\LB}\sym{general text}\.{\RB}. +\medskip +\enditemize + +\subsection{Version and Revision} +The control sequences \cs{HINTversion}\index{HINTversion+\cs{HINTversion}} +and \cs{HINTsubversion}\index{HINTsubversion+\cs{HINTsubversion}} are +used to determine the version and subversion numbers of the HINT output format +that is generated by Hi\TeX. It can be used as part of the output as +in \verbatim|\the\HINTversion|. +The most important use, however, is testing whether the current \TeX\ engine +will in fact produce \HINT\ output. +As an example the file {\tt ifhint.tex}\index{ifhint.tex+{\tt ifhint.tex}} +contains the following code: + + +\verbatim/ +\newif\ifhint +\expandafter\ifx\csname HINTversion\endcsname\relax + \hintfalse\else\hinttrue\fi/ + + +\subsection{Images} +The primitive \cs{HINTimage}\index{HINTimage+\cs{HINTimage}} +includes an image\index{image} in a document. +The syntax is as follows: + +\medskip +\cs{HINTimage} \opt{\.{=}} \sym{name} +\opt{\sym{width}} \opt{\sym{height}} +\medskip + +The optional equal sign can be added to make the code look nicer. +The \sym{name} specifies the image file. +The width specification determines the width of the image. If omitted, +Hi\TeX\ tries to determine the image's width from the image file. +The same holds for the height specification. + +\medskip +\rule \sym{width}\index{width+\sym{width}}:\.{width} \sym{normal dimension}. +\rule \sym{height}\index{height+\sym{height}}:\.{height} \sym{normal dimension}. +\medskip + +Note that a \sym{normal dimension} that is computed from \cs{hsize} +or \cs{vsize} retains this dependency when processed by Hi\TeX. +This allows an image to adapt to the size of the viewing area. +Scaling in the \HINT\ viewer will, however, never change the +aspect ratio of an image. So it may become smaller or larger, +but it will never be distorted. +For this reason, Hi\TeX\ will inspect the image file to determine the +aspect ratio\index{aspect ratio} of the stored image. +The width and height values as given in the \TeX\ file serve +as the maximum values for the actual width and height. When rendering, +the image will become as large as possible within the given bounds. +If \TeX\ does not specify neither width nor height, the image file +must specify the absolute width and height of the image. +It is considered an error if valid settings for the image's width and height +can not be obtained. + +\subsection{Links, Labels, and Outlines} +A link\index{link} in a \HINT\ document refers to another location in the same document. +It can be used to navigate to that location. +A link is defined using the primitives +\cs{HINTstartlink}\index{HINTstartlink+\cs{HINTstartlink}} +and \cs{HINTendlink}\index{HINTendlink+\cs{HINTendlink}}. +Neither of them can be used in vertical mode. +The text between the start and the end of the link +constitutes the visible part of the link. Depending on the user interface, clicking +or tapping or otherwise activating the link (e.g. pronouncing) +will navigate to the destination of the link. +The user interface might provide a visual clue to make the user aware of the +available links but it also may choose to leave the visual clues to the author +of the document (e.g. using a special image or a special font). + +The syntax is +\cs{HINTstartlink} \sym{destination} +and +\cs{HINTendlink} +with + +\medskip +\rule \sym{destination}\index{destination+\sym{destination}}:\.{goto} \sym{label}. +\rule \sym{label}\index{label+\sym{label}}: + \.{name} \.{\LB}\sym{general text}\.{\RB} \OR\ \.{num} \sym{integer}. +\medskip + +As you can see, the link refers to its destination using a label +which is either a name or a number. +The destination can be defined by using the +\cs{HINTdest}\index{HINTdest+\cs{HINTdest}} primitive. +Forward and backward links are allowed; the definition of a lable can either +preceede or follow the use of the label. If at the end of the document a label +is undefined, a warning is given, and the label will reference the beginning of the +document. + +The syntax is +\cs{HINTdest} \sym{label} \opt{\sym{placement}} +with + +\medskip +\rule\sym{placement}\index{placement+\sym{placement}}: +\.{top}\index{top+{\tt top}} \OR\ \.{bot}\index{bot+{\tt bot}}. +\medskip + +The optional placement argument specifies how to build the page +containing the destination location. \.{top} demands +a page starting with the destination location. This is useful +if the destination is for example the start of a section or chapter heading. +Similarly \.{bot} asks for a page that ends with the destination location. +The most common case is to omit the placement argument. In this case, the +viewer will build a ``good'' page that includes the given destination. +In case of a section heading, for example, it will most probably start the +page with the section heading because section headings are usually preceded +by a negative penalty that will convince the page builder that this is a good +place to break the page. But if the section heading is immediately preceded +by a chapter heading, the negative penalty found there will probably +persuade the page builder to start with the chapter heading instead. + +There is a special label that has the form +\.{name} \.{\LB}\.{HINT.home}\.{\RB}\index{HINT.home+{\tt HINT.home}}. +It is used to mark the ``home page''\index{home page} of the document. User interfaces +are encouraged to offer a button or keyboard shortcut to navigate to the +document location labeled this way. The page should be a convenient +starting point to explore the document. The typical place for this label +would be the documents table of content. + +The labels that identify destinations in a document can also be used +to define document outlines. A document outline\index{outline} is a document summary +given as a hierarchical list of headings where each of them +refers to a specific location in the document. + +The syntax is +\cs{HINToutline}\index{HINToutline+\cs{HINToutline}} +\sym{destination} \opt{\sym{depth}} \.{\LB}\sym{horizontal list}\.{\RB}. + +\medskip +\rule \sym{depth}\index{depth+\sym{depth}}: \.{depth} \sym{integer}. +\medskip + +The user interface can format the \sym{horizontal list} much like +a \cs{hbox} would do and displays it to the user. When the user selects +this text, the document will be repositioned to show the destination location +in the same way as with a link. In order to support also simpler +user interfaces, the current \HINT\ backend also extracts the characters +(and spaces) from the horizontal list (in top-left to bottom-right order) +and makes this character string available to the user interface. + + +The order in which outline items are defined is important because +this is the order in which they will be presented to the reader of the +document. The optional depth argument allows to structure +the list of outline items as a hierarchy. Outline items with a higher depth value are considered to be sub-items of items earlier in the list with lower +depth values. If no depth value is given, the depth value is set to zero. +It is not necessary to define depth values strictly consecutive. + + +\subsection{Page Templates and Streams}\index{page template}\index{stream} + +To produce the final page, \TeX\ uses a special piece of program +called the output routine\index{output routine}. Because a \HINT\ +file is pure data, it can not contain output routines. Instead it +uses page templates to assemble pages from the main text, footnotes, +floating illustrations, and other material. I start here by +describing how \HINT's page templates work and the special syntax used +to specify them in a \TeX\ file that is about to be processed with +Hi\TeX. For those interested in how the design decision was made and +how page templates relate to \TeX's page building mechanism, a +separate section follows at the end. + +The syntax of a page template specification is: +\cs{HINTsetpage}\index{HINTsetpage+\cs{HINTsetpage}} +\sym{integer} \opt{\.{=}} \sym{name} +\opt{\sym{priority}} \opt{\sym{width}} \opt{\sym{height}} +\.{\LB}\sym{vertical list} \sym{stream definition list}\.{\RB} + + +The \sym{integer} specifies the page templates number in the range 1 +to 255. The number 0 is reserved for the build in page template of +the \HINT\ file format, which is used if no other page template has +been defined. The page template 0 can not be redefined. +The \sym{name} associates a name with the page template. The name can +be displayed by the \HINT\ viewer to help the user selecting a +suitable page template. + +After the name follows an optional priority; it is used to select the +``best page template'' if multiple templates are available. The +default value is~1. The build-in template has priority~0. + +\medskip +\rule\sym{priority}\index{priority+\sym{priority}}: {\tt priority} \sym{integer}. +\medskip + + +After that follows an optional width and height of the full page +including the margins. After subtracting \cs{hsize} from the width +and \cs{vsize} from the height, the remainder is used for the margins +around the displayed text. For example giving the width as +1.2\cs{hsize} will leave 0.1\cs{hsize} for the margins on both sides. +In this case the margins will grow together with the available width +of the display. If the width is computed by adding 20pt +to \cs{hsize}, the margin will be 10pt on both sides. In this case +the margin will not grow with the size of the display, but it will +grow with the magnification factor. Of course both methods can be +used together. The default is \cs{hsize} for the width and \cs{vsize} +for the height so there are no margins. + +The following \sym{vertical list} defines the page itself. It should assign suitable values +to \cs{topskip} and \cs{maxdepth} because the values valid at the end of the vertical list +are stored in the page template and are used in the page building process. +The vertical list usually also specifies the insertion of content streams using a \sym{stream insert point}. + +\medskip +\rule\sym{stream insert point}\index{stream insert point+\sym{stream insert point}}: + \cs{HINTstream} \sym{integer}. +\medskip + +Here the \sym{integer} must be in the range 0 to 254. The value 255 is invalid; +the value 0 indicates the main body of text (what \TeX's page builder would normally put into +box 255 before calling the output routine). +Otherwise, the \sym{integer} is TeX's insertion number, that is the number of \TeX's box +containing the insertions. As usual, this box is filled using \TeX's \cs{insert} primitive. +So after plain \TeX\ has defined \cs{footins}, +the footnotes for the current page can be inserted after the main body of text in the \sym{vertical list} +by saying \cs{HINTstream}\.0 followed by \cs{HINTstream}\cs{footins}. +Of course you might want to have a footnote rule and a small skip to separate the +footnotes ---if there are any---from the main text. This can be achieved by a suitable +\sym{stream definition} in the \sym{stream definition list}. + +\medskip +\rule\sym{stream definition list}\index{stream definition list+\sym{stream definition list}}: + \OR\ \sym{stream definition list} \sym{stream definition}. +\rule\sym{stream definition}\index{stream definition+\sym{stream definition}}: + \cs{HINTsetstream} \sym{integer} \opt{\.{=}} +\opt{{\tt preferred} \sym{integer}} +\opt{\.{next} \sym{integer}} +\opt{\.{ratio} \sym{integer}} \.{\LB}\sym{vertical list}\.{\RB}. +\medskip + + +The first \sym{integer} is the streams insertion number $i$, +and it must match the \sym{integer} +previously used in the \sym{stream insert point}. +Then follows the optional specification of a prefered stream with insertion number $p$, +a next stream with insertion number $n$, and a split ratio $r$. +If $r>0$, the contributions to stream $i$ are split between +stream $p$ and $n$ in the ratio $r/1000$ for $p$ and $1-r/1000$ for $n$ +before contributing streams $p$ and $r$ to the page. +Else if $p\ge0$ any insertion to stream $i$ is moved to stream $p$ as long as possible, +and if $n\ge0$ we move an insert to stream $n$ if there is ``no room left'' in $p$ nor in $i$. +How much ``room'' is available for the insertions is specified inside the vertical list +that follows. +Here \cs{dimen}$i$ should be set to the maximum total height of the insertions in class $i$ per page. +\cs{count}$i$ should be set to the magnification factor $f$, +such that inserting a box of height $h$ will contribute $h*f/1000$ to the main page; +and \cs{skip}$i$ should be set to the extra space needed if an insertion in class $i$ is present. + +This extra space is usually taken up by material that is inserted before and after the insertions, +such as for example the footnote rule. This material can be defined by a +\sym{before list} and an \sym{after list}. + +\medskip\index{HINTbefore+\cs{HINTbefore}}\index{HINTafter+\cs{HINTafter}} +\rule \sym{before list}\index{before list+\sym{before list}}: + \cs{HINTbefore} \opt{\.{=}} \.{\LB}\sym{vertical list}\.{\RB}. +\rule \sym{after list}\index{after list+\sym{after list}}: + \cs{HINTafter} \opt{\.{=}} \.{\LB}\sym{vertical list}\.{\RB}. +\medskip + +If you are interested in the design decision that motivate the definitions that have +be given in this section, you should read the next section. + + +\section{Replacing \TeX's Page Builder} + +\TeX\ uses an output\index{output routine} routine to finalize the page. +The output outine takes the material which the page builder had accumulated in {\tt box255} +and attaches headers, footers, and floating material +like figures, tables, and footnotes. The latter material is specified by insert nodes +while headers and footers are often constructed using mark nodes. +Running an output routine requires the full power of the \TeX\ engine and is not +part of the \HINT\ viewer. Therefore, \HINT\ replaces output routines by page templates\index{template}. +\TeX\ can use different output routines for different parts of a book---for example +the index might use a different output routine than the main body of text. + +\TeX\ uses insertions to describe floating content that is not necessarily displayed +where it is specified. Three examples may illustrate this: +\itemize +\item Footnotes\footnote*{Like this one.} are specified in the middle of the text but are displayed at the +bottom of the page. Several +footnotes\index{footnote} on the same page are collected and displayed together. The +page layout may specify a short rule to separate footnotes from the +main text, and if there are many short footnotes, it may use two columns +to display them. In extreme cases, the page layout may demand a long +footnote to be split and continued on the next page. + +\item Illustrations\index{illustration} may be displayed exactly where specified if there is enough +room on the page, but may move to the top of the page, the bottom of the page, +the top of next page, or a separate page at the end of the chapter. + +\item Margin notes\index{margin note} are displayed in the margin on the same page starting at the top +of the margin. +\enditemize + +\HINT\ uses page templates and content streams to achieve similar effects. +But before I describe the page building\index{page building} mechanisms of \HINT, +let me summarize \TeX's page builder. + +\subsection{\TeX's page building mechanism} +\TeX's page builder ignores leading glue\index{glue}, kern\index{kern}, +and penalty\index{penalty} nodes until the first +box\index{box node} or rule\index{rule node} node is encountered; +whatsit\index{whatsit node} nodes do not really contribute anything to +a page; mark\index{mark node} nodes are recorded for later use. Once +the first box, rule, or insert\index{insert node} arrives, \TeX\ makes +copies of all parameters that influence the page building process and +uses these copies. These parameters are the \.{page\_goal} and the +\.{page\_max\_depth}. Further, the variables {\tt page\_total}, {\tt page\_shrink}, +{\tt page\_stretch}, {\tt page\_depth}, and {\tt in\-sert\_pe\-nal\-ties} are +initialized to zero. The top skip\index{top skip} adjustment is made +when the first box or rule arrives---possibly after an insert. +Now the page builder accumulates material: normal material goes +into {\tt box255}\index{box 255} and will change {\tt page\_total}, {\tt page\_shrink}, +{\tt page\_stretch}, and {\tt page\_depth}. The latter is adjusted so that +is does not exceed {\tt page\_max\_depth}. + +The handling of inserts\index{insert node} is more complex. +\TeX\ creates an insert class using {\tt newinsert}. This reserves a number $i$ +and four registers: {\tt box\hair$i$} for the inserted material, +{\tt count\hair$i$} for the magnification factor $f$, {\tt dimen\hair$i$} +for the maximum size per page $d$, and {\tt skip\hair$i$} for the +extra space needed on a page if there are any insertions of class $i$. + +For example plain \TeX\ allocates $n=254$ for footnotes\index{footnote} and sets +{\tt count254} to~$1000$, {\tt dimen254} to 8in, and {\tt skip254} to {\tt \BS big\-skip\-amount}. + +An insertion node will specify the insertion class $i$, some vertical material, +its natural height plus depth $x$, a {\tt split\-\_top\-\_skip}, a {\tt split\-\_max\_depth}, +and a {\tt floa\-ting\-\_pe\-nal\-ty}. + + +Now assume that an insert node with subtype 254 arrives at the page builder. +If this is the first such insert, \TeX\ will decrease the {\tt page\_goal} +by the width of {\tt skip254} and adds its stretchability and shrinkability +to the total stretchability and shrinkability of the page. Later, +the output routine will add some space and the footnote rule to fill just that +much space and add just that much shrinkability and stretchability to the page. +Then \TeX\ will normally add the vertical material in the insert node to +{\tt box254} and decrease the {\tt page\_goal} by $x\times f/1000$. + +Special processing is required if \TeX\ detects that there is not enough space on +the current page to accommodate the complete insertion. +If already a previous insert did not fit on the page, simply the {\tt floating\_penalty} +as given in the insert node is added to the total {\tt insert\_penalties}. +Otherwise \TeX\ will test that the total natural height plus depth of {\tt box254} +including $x$ does not exceed the maximum size $d$ and that the +${\tt page\_total} + {\tt page\_depth} + x\times f/1000 - {\tt page\_shrink} \le {\tt page\_goal}$. +If one of these tests fails, the current insertion +is split in such a way as to make the size of the remaining insertions just pass the tests +just stated. + +Whenever a glue node, or penalty node, or a kern node that is followed by glue arrives +at the page builder, it rates the current position as a possible end of the page based on +the shrinkability of the page and the difference between {\tt page\_total} and {\tt page\_goal}. +As the page fills, the page breaks tend to become better and better until the +page starts to get overfull and the page breaks get worse and worse until +they reach the point where they become {\tt awful\_bad}. At that point, +the page builder returns to the best page break found so far and fires up the +output routine. + + +\subsection{\HINT\ Page Templates} +Let's look at the problems that show up when implementing a replacement for \TeX's +page building mechanism. + +\enumerate +\item +An insertion node can not always specify its height $x$ because insertions may contain paragraphs that need +to be broken in lines and the height of a paragraph depends in some non obvious way on +its width. + +\item +Before the viewer can compute the height $x$, it needs to know the width of the insertion. Just imagine +displaying footnotes in two columns or setting notes in the margin. Knowing the width, it +can pack the vertical material and derive its height and depth. + +\item +\TeX's plain format provides an insert macro that checks whether there is still space +on the current page, and if so, it creates a contribution to the main text body, otherwise it +creates a {\tt topinsert}. Such a decision needs to be postponed to the \HINT\ viewer. + +\item +\HINT\ has no output routines that would specify something like the space and the rule preceding the footnote. + +\item +\TeX's output routines have the ability to inspect the content of the boxes, +split them, and distribute the content over the page. +For example, the output routine for an index set in two column format might +expect a box containing index entries up to a height of $2\times\.{vsize}$. +It will split this box in the middle and display the top part in the left +column and the bottom part in the right column. With this approach, the +last page will show two partly filled columns of about equal size. + +\item +\HINT\ has no mark nodes that could be used to create page headers or footers. +Marks, like output routines, contain token lists and need the full \TeX\ interpreter +for processing them. Hence, \HINT\ does not support mark nodes. +\endenumerate + + +Instead of output routines, \HINT\ uses page templates. +Page templates are basically vertical boxes with \sym{stream insert points} marking the +positions where the content of the box registers, filled by the page builder, +should appear. +To output the page, the viewer traverses the page template, +replaces the placeholders by the appropriate box content, and +sets the glue. + +It is only natural to treat the page's main body, +inserts, and marks using the same mechanism. We call this +mechanism a content stream\index{stream}. +Content streams are identified by a stream number in the range 0 to 254; +the number 255 is used to indicate an invalid stream number. +The stream number 0 is reserved for the main content stream; it is always defined. + +\medskip +{\small \advance \leftskip by 30pt \advance \rightskip by 30pt +It is planed to implement a replacement for \TeX's mark nodes using +different types of streams: +\itemize +\item normal streams correspond to \TeX's inserts and accumulate content on the page, +\item first\index{first stream} streams correspond to \TeX's first marks and will contain only the first insertion of the page, +\item last\index{last stream} streams correspond to \TeX's bottom marks and will contain only the last insertion of the page, and +\item top\index{top stream} streams correspond to \TeX's top marks. Top streams are not yet implemented. +\enditemize +\medskip +} + +Nodes from the content section are considered contributions to stream~0 except +for insert nodes which will specify the stream number explicitly. +If the stream is not defined or is not used in the current page template, its content is simply ignored. + +The page builder needs a mechanism to redirect contributions from one content +stream to another content stream based on the availability of space. +Hence a \HINT\ content stream can optionally specify a preferred stream number, +where content should go if there is still space available, a next stream number, +where content should go if the present stream has no more space available, and +a split ratio if the content is to be split between these two streams before +filling in the template. + +Various stream parameters govern the treatment of contributions to the stream +and the page building process. + +\itemize +\item The magnification factor $f$: Inserting a box of height $h$ to this stream will contribute $h\times f/1000$ +to the height of the page under construction. For example, a stream +that uses a two column format will have an $f$ value of 500; a stream +that specifies notes that will be displayed in the page margin will +have an $f$ value of zero. + +\item The height $h$: The extended dimension $h$ gives the maximum height this +stream is allowed to occupy on the current page. +To continue the previous example, a stream that will be split into two columns +will have $h=2\cdot\.{vsize}$ , and a stream that specifies +notes that will be displayed in the page margin will have +$h=1\cdot\.{vsize}$. You can restrict the amount of space occupied by +footnotes to the bottom quarter by setting the corresponding $h$ value +to $h=0.25\cdot\.{vsize}$. + +\item The depth $d$: The dimension $d$ gives the maximum depth this +stream is allowed to have after formatting. + +\item The width $w$: The extended dimension $w$ gives the width of this stream +when formatting its content. For example margin notes +should have the width of the margin less some surrounding space. + +\item The ``before'' list $b$: If there are any contributions to this +stream on the current page, the material in list $b$ +is inserted {\it before\/} the material from the stream itself. For +example, the short line that separates the footnotes from the main +page will go, together with some surrounding space, into the list~$b$. + +\item The top skip glue $g$: This glue is inserted between the material +from list $b$ and the first box of the stream, reduced +by the height of the first box. Hence it specifies the distance between +the material in $b$ and the first baseline of the stream content. + +\item The ``after'' list $a$: The list $a$ is treated like list $b$ but +its material is placed {\it after\/} the material from the stream itself. + +\item The ``preferred'' stream number $p$: If $p\ne 255$, it is the number of +the {\it preferred\/} stream. If stream $p$ has still +enough room to accommodate the current contribution, move the +contribution to stream $p$, otherwise keep it. For example, you can +move an illustration to the main content stream, provided there is +still enough space for it on the current page, by setting $p=0$. + +\item The ``next'' stream number $n$: If $n\ne 255$, it is the number of the +{\it next\/} stream. If a contribution can not be +accommodated in stream $p$ nor in the current stream, treat it as an +insertion to stream $n$. For example, you can move contributions to +the next column after the first column is full, or move illustrations +to a separate page at the end of the chapter. + +\item The split ratio\index{split ratio} $r$: If $r$ is positive, both $p$ and $n$ must +be valid stream numbers and contents is not immediately moved to stream $p$ or $n$ as described before. +Instead the content is kept in the stream itself until the current page is complete. +Then, before inserting the streams into the page template, the content of +this stream is formatted as a vertical box, the vertical box is +split into a top fraction and a bottom fraction in the ratio $r/1000$ +for the top and $(1000-r)/1000$ for the bottom, and finally the top +fraction is moved to stream $p$ and the bottom fraction to stream +$n$. You can use this feature for example to implement footnotes +arranged in two columns of about equal size. By collecting all the +footnotes in one stream and then splitting the footnotes with $r=500$ +before placing them on the page into a right and left column. Even +three or more columns can be implemented by cascades of streams using +this mechanism. +\enditemize + +\HINT\ allows multiple page templates but Hi\TeX\ currently does not implement +restricting them to individual page ranges and the viewer selects +the page template with the highest priority. To support different output media, the page +templates are named and a suitable user interface may offer the user a selection +of possible page layouts. In this way, the page layout remains in the hands of the +book designer, and the user has still the opportunity to pick a layout that best fits +the display device. + +The build-in page template with number 0 is always defined and has priority 0. +It will display just the main content stream. It puts a small margin +of $\.{hsize}/8 -4.5\hbox{pt}$ all around it. +Given a letter size page, 8.5 inch wide, this formula yields a margin of 1 inch, +matching \TeX's plain format. The margin will be positive as long as +the page is wider than $1/2$ inch. For narrower pages, there will be no +margin at all. In general, the \HINT\ viewer will never set {\tt hsize} larger +than the width of the page and {\tt vsize} larger than its height. + +%8.5 in should give 1 inch margin 2/17 +%612pt should give 72pt margin +%72pt = 612/8-4.5pt +%This would give a positive margin starting at 36pt or 1/2 inch + + +%\appendix + +%\plainsection{References} + +%{\baselineskip=11pt +%\def\bfblrm{\small\rm}% +%\def\bblem{\small\it}% +%\bibliography{../hint} +%\bibliographystyle{plain} +%} + +\plainsection{Index} +{ +\def\_{{\tt \UL}} % underline in a string +\catcode`\_=\active \let_=\_ % underline is a letter +\input hitexman.ind +} + +\write\cont{} % ensure that the contents file isn't empty +% \write\cont{\catcode `\noexpand\@=12\relax} % \makeatother +\closeout\cont% the contents information has been fully gathered +\inx +\fin +\end diff --git a/systems/doc/hitex/verbatim.tex b/systems/doc/hitex/verbatim.tex new file mode 100644 index 0000000000..ed2aa700b9 --- /dev/null +++ b/systems/doc/hitex/verbatim.tex @@ -0,0 +1,48 @@ +% F I L E V E R B A T I M . T E X +% +% THIS SET OF MACROs IS TAKEN FROM D.E.K.'s TeXBook +% AND PROVIDES AN EASY WAY OF TYPESETTING TEXTS VERBATIM: +% +% 1. \verbatim<character><text without that character><character> +% causes the text to be set verbatim using \tt font; +% 2. if the text uses up all the alphabet, \doubleverbatim macro +% can be used instead; this is similar to the previous one but +% a pair of characters is now used as a delimiter; +% 3. in case of emergency \tripleverbatim macro may be of help... +% +%--------------------------------------------- +\def\uncatcodespecials % see D.E.K., pp. 344 and 380 + {\def\do##1{\catcode`##1=12}\dospecials}% +%--------------------------------------------- +{\catcode`\^^I=\active \gdef^^I{\ \ \ \ }% TAB character is replaced by + % 4 spaces; it is better than + % nothing, but it does not mimic + % true tabbing satisfactorily---maybe + % some nice day... + \catcode`\`=\active\gdef`{\relax\lq}}% this line inhibits Spanish + % ligatures ?` and !` of \tt font +\def\setupverbatim % see D.E.K., p. 381 + {\tt % + \spaceskip=0pt \xspaceskip=0pt % just in case... + \catcode`\^^I=\active % + \catcode`\`=\active % + \def\par{\leavevmode\endgraf}% this causes that empty lines aren't + % skipped + \obeylines \uncatcodespecials \obeyspaces}% +{\obeyspaces \global\let =\ }% this causes that leading blanks aren't + % skipped; cf. also def's of \space, \endgraf, + % \lq, \obeyspaces, and \obeylines, + % D.E.K., pp. 351--352 +%--------------------------------------------- +% see D.E.K., p. 382 +\def\doverbatim#1{\def\next##1#1{##1\endgroup}\next}% +\def\verbatim{\begingroup\setupverbatim\doverbatim}% +%---------- +\def\dodoubleverbatim#1#2{\def\next##1#1#2{##1\endgroup}\next}% +\def\doubleverbatim{\begingroup\setupverbatim\dodoubleverbatim}% +%---------- +\def\dotripleverbatim#1#2#3{\def\next##1#1#2#3{##1\endgroup}\next}% +\def\tripleverbatim{\begingroup\setupverbatim\dotripleverbatim}% +%--------------------------------------------- +\endinput + diff --git a/systems/doc/kpathsea/kpathsea.html b/systems/doc/kpathsea/kpathsea.html index 883cc12929..807fa6091a 100644 --- a/systems/doc/kpathsea/kpathsea.html +++ b/systems/doc/kpathsea/kpathsea.html @@ -1,8 +1,11 @@ <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd"> <html> +<!-- Created by GNU Texinfo 6.8, https://www.gnu.org/software/texinfo/ --> +<head> +<meta http-equiv="Content-Type" content="text/html; charset=utf-8"> <!-- This file documents the Kpathsea library for path searching. -Copyright (C) 1996-2021 Karl Berry & Olaf Weber. +Copyright (C) 1996-2022 Karl Berry & Olaf Weber. Permission is granted to make and distribute verbatim copies of this manual provided the copyright notice and this permission notice are @@ -18,9 +21,6 @@ Permission is granted to copy and distribute translations of this manual into another language, under the above conditions for modified versions, except that this permission notice may be stated in a translation approved by the TeX Users Group. --> -<!-- Created by GNU Texinfo 6.7, http://www.gnu.org/software/texinfo/ --> -<head> -<meta http-equiv="Content-Type" content="text/html; charset=utf-8"> <title>Kpathsea: A library for path searching</title> <meta name="description" content="Kpathsea: A library for path searching"> @@ -28,17 +28,20 @@ approved by the TeX Users Group. --> <meta name="resource-type" content="document"> <meta name="distribution" content="global"> <meta name="Generator" content="makeinfo"> +<meta name="viewport" content="width=device-width,initial-scale=1"> + <link href="#Top" rel="start" title="Top"> <link href="#Index" rel="index" title="Index"> <link href="#SEC_Contents" rel="contents" title="Table of Contents"> <link href="http://tug.org/texinfohtml" rel="up" title="(dir)"> +<link href="#Introduction" rel="next" title="Introduction"> <style type="text/css"> <!-- +a.copiable-anchor {visibility: hidden; text-decoration: none; line-height: 0em} a.summary-letter {text-decoration: none} blockquote.indentedblock {margin-right: 0em} div.display {margin-left: 3.2em} div.example {margin-left: 3.2em} -div.lisp {margin-left: 3.2em} kbd {font-style: oblique} pre.display {font-family: inherit} pre.format {font-family: inherit} @@ -47,6 +50,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> @@ -65,7 +69,22 @@ ul.no-bullet {list-style: none} -<span id="SEC_Contents"></span> + + +<div class="top" id="Top"> +<div class="header"> +<p> +Next: <a href="#Introduction" accesskey="n" rel="next">Introduction</a>, Up: <a href="http://tug.org/texinfohtml" accesskey="u" rel="up">(dir)</a> [<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="Kpathsea-library"></span><h1 class="top">Kpathsea library</h1> + +<p>This manual documents the Kpathsea library for path searching. It +corresponds to version 6.3.4, released in +January 2022. +</p> + + +<div class="Contents_element" id="SEC_Contents"> <h2 class="contents-heading">Table of Contents</h2> <div class="contents"> @@ -155,61 +174,20 @@ ul.no-bullet {list-style: none} <li><a id="toc-Index-1" href="#Index" rel="index">Index</a></li> </ul> </div> - - - -<span id="Top"></span><div class="header"> -<p> -Next: <a href="#Introduction" accesskey="n" rel="next">Introduction</a>, Up: <a href="http://tug.org/texinfohtml" accesskey="u" rel="up">(dir)</a> [<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="Kpathsea-library"></span><h1 class="top">Kpathsea library</h1> - -<p>This manual documents the Kpathsea library for path searching. It -corresponds to version 6.3.3, released in -February 2021. -</p> -<table class="menu" border="0" cellspacing="0"> -<tr><td align="left" valign="top">• <a href="#Introduction" accesskey="1">Introduction</a></td><td> </td><td align="left" valign="top">Overview and history. -</td></tr> -<tr><th colspan="3" align="left" valign="top"><pre class="menu-comment"> - -</pre></th></tr><tr><td align="left" valign="top">• <a href="#unixtex_002eftp" accesskey="2">unixtex.ftp</a></td><td> </td><td align="left" valign="top">Obtaining TeX software. -</td></tr> -<tr><td align="left" valign="top">• <a href="#Security" accesskey="3">Security</a></td><td> </td><td align="left" valign="top">Who can write what files, etc. -</td></tr> -<tr><td align="left" valign="top">• <a href="#TeX-directory-structure" accesskey="4">TeX directory structure</a></td><td> </td><td align="left" valign="top">Managing the horde of TeX input files. -</td></tr> -<tr><th colspan="3" align="left" valign="top"><pre class="menu-comment"> - -</pre></th></tr><tr><td align="left" valign="top">• <a href="#Path-searching" accesskey="5">Path searching</a></td><td> </td><td align="left" valign="top">How filename lookups work. -</td></tr> -<tr><td align="left" valign="top">• <a href="#TeX-support" accesskey="6">TeX support</a></td><td> </td><td align="left" valign="top">Special support for TeX-related file lookups. -</td></tr> -<tr><th colspan="3" align="left" valign="top"><pre class="menu-comment"> - -</pre></th></tr><tr><td align="left" valign="top">• <a href="#Programming" accesskey="7">Programming</a></td><td> </td><td align="left" valign="top">How to use Kpathsea features in your program. -</td></tr> -<tr><th colspan="3" align="left" valign="top"><pre class="menu-comment"> - -</pre></th></tr><tr><td align="left" valign="top">• <a href="#Reporting-bugs" accesskey="8">Reporting bugs</a></td><td> </td><td align="left" valign="top">Where and how to report bugs. -</td></tr> -<tr><td align="left" valign="top">• <a href="#Index" rel="index" accesskey="9">Index</a></td><td> </td><td align="left" valign="top">General index. -</td></tr> -</table> - - <hr> -<span id="Introduction"></span><div class="header"> +<div class="chapter" id="Introduction"> +<div class="header"> <p> -Next: <a href="#unixtex_002eftp" accesskey="n" rel="next">unixtex.ftp</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="#unixtex_002eftp" accesskey="n" rel="next"><samp>unixtex.ftp</samp>: Obtaining TeX</a>, Previous: <a href="#Top" accesskey="p" rel="prev">Kpathsea library</a>, Up: <a href="#Top" accesskey="u" rel="up">Kpathsea library</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="Introduction-1"></span><h2 class="chapter">1 Introduction</h2> <span id="index-introduction"></span> <span id="index-fundamental-purpose-of-Kpathsea"></span> -<p>This manual corresponds to version 6.3.3 of the Kpathsea -library, released in February 2021. +<p>This manual corresponds to version 6.3.4 of the Kpathsea +library, released in January 2022. </p> <p>The library’s fundamental purpose is to return a filename from a list of directories specified by the user, similar to what shells do when @@ -221,9 +199,9 @@ this library: </p> <ul> <li> Dviljk (see the ‘<samp>dvilj</samp>’ man page) -</li><li> Dvipsk (see <cite><a href="https://tug.org/texinfohtml/dvips.html#Top">Dvips: A DVI driver</a></cite>) -</li><li> GNU font utilities (see <cite><a href="fontu.html#Top">GNU font utilities</a></cite>) -</li><li> Web2c (see <cite><a href="https://tug.org/texinfohtml/web2c.html#Top">Web2c: A TeX implementation</a></cite>) +</li><li> Dvipsk (see <cite><a data-manual="dvips" href="https://tug.org/texinfohtml/dvips.html#Top">Dvips: A DVI driver</a></cite>) +</li><li> GNU font utilities (see <cite><a data-manual="fontu" href="fontu.html#Top">GNU font utilities</a></cite>) +</li><li> Web2c (see <cite><a data-manual="web2c" href="https://tug.org/texinfohtml/web2c.html#Top">Web2c: A TeX implementation</a></cite>) </li><li> Xdvik (see the ‘<samp>xdvi</samp>’ man page) </li></ul> @@ -232,7 +210,7 @@ this library: <p>Kpathsea is now maintained as part of the TeX Live distribution (<a href="https://tug.org/texlive">https://tug.org/texlive</a>), which includes several more Kpathsea-using programs. For information on configuration, building, -installing, and more, see <cite><a href="https://tug.org/texinfohtml/tlbuild.html#Top">Building TeX Live</a></cite>. +installing, and more, see <cite><a data-manual="tlbuild" href="https://tug.org/texinfohtml/tlbuild.html#Top">Building TeX Live</a></cite>. </p> <span id="index-interface_002c-not-frozen"></span> <span id="index-comments_002c-making"></span> @@ -261,14 +239,14 @@ you’re already a member, thanks!). TUG produces the periodical proceedings, and arranges courses on TeX for all levels of users throughout the world. See <a href="https://tug.org">https://tug.org</a> for information. </p> -<table class="menu" border="0" cellspacing="0"> -<tr><td align="left" valign="top">• <a href="#History" accesskey="1">History</a></td><td> </td><td align="left" valign="top"> -</td></tr> -</table> +<ul class="section-toc"> +<li><a href="#History" accesskey="1">History</a></li> +</ul> <hr> -<span id="History"></span><div class="header"> +<div class="section" id="History"> +<div class="header"> <p> Up: <a href="#Introduction" accesskey="u" rel="up">Introduction</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> </div> @@ -377,9 +355,12 @@ where Kpathsea is now maintained. <hr> -<span id="unixtex_002eftp"></span><div class="header"> +</div> +</div> +<div class="chapter" id="unixtex_002eftp"> +<div class="header"> <p> -Next: <a href="#Security" accesskey="n" rel="next">Security</a>, Previous: <a href="#Introduction" accesskey="p" rel="prev">Introduction</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="#Security" accesskey="n" rel="next">Security</a>, Previous: <a href="#Introduction" accesskey="p" rel="prev">Introduction</a>, Up: <a href="#Top" accesskey="u" rel="up">Kpathsea library</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="unixtex_002eftp_003a-Obtaining-TeX"></span><h2 class="chapter">2 <samp>unixtex.ftp</samp>: Obtaining TeX</h2> @@ -425,9 +406,11 @@ Comprehensive TeX Archive Network), <a href="https://ctan.org">https://ctan.org< <hr> -<span id="Security"></span><div class="header"> +</div> +<div class="chapter" id="Security"> +<div class="header"> <p> -Next: <a href="#TeX-directory-structure" accesskey="n" rel="next">TeX directory structure</a>, Previous: <a href="#unixtex_002eftp" accesskey="p" rel="prev">unixtex.ftp</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="#TeX-directory-structure" accesskey="n" rel="next">TeX directory structure</a>, Previous: <a href="#unixtex_002eftp" accesskey="p" rel="prev"><samp>unixtex.ftp</samp>: Obtaining TeX</a>, Up: <a href="#Top" accesskey="u" rel="up">Kpathsea library</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="Security-1"></span><h2 class="chapter">3 Security</h2> @@ -443,12 +426,12 @@ illegitimate root access. <samp>~/.rhosts</samp>, and thus an unwitting user who runs TeX on a random document is vulnerable to a trojan horse attack. This loophole is closed by default, but you can be permissive if you so desire in -<samp>texmf.cnf</samp>. See <a href="https://tug.org/texinfohtml/web2c.html#tex-invocation">tex invocation</a> in <cite>Web2c</cite>. MetaPost has +<samp>texmf.cnf</samp>. See <a data-manual="web2c" href="https://tug.org/texinfohtml/web2c.html#tex-invocation">tex invocation</a> in <cite>Web2c</cite>. MetaPost has the same issue. </p> <p>Dvips, Xdvi, and TeX can also execute shell commands under some -circumstances. To disable this, see the ‘<samp>-R</samp>’ option in <a href="https://tug.org/texinfohtml/dvips.html#Option-details">Option -details</a> in <cite>Dvips</cite>, the xdvi man page, and <a href="https://tug.org/texinfohtml/web2c.html#tex-invocation">tex +circumstances. To disable this, see the ‘<samp>-R</samp>’ option in <a data-manual="dvips" href="https://tug.org/texinfohtml/dvips.html#Option-details">Option +details</a> in <cite>Dvips</cite>, the xdvi man page, and <a data-manual="web2c" href="https://tug.org/texinfohtml/web2c.html#tex-invocation">tex invocation</a> in <cite>Web2c</cite>, respectively. </p> <span id="index-local-cache-of-fonts"></span> @@ -466,12 +449,12 @@ fonts is created on every machine. writable font tree desirable, in spite of the potential security problems. To do this you should change the value of <code>VARTEXFONTS</code> in <samp>texmf.cnf</samp> to refer to some globally known directory. -See <a href="#mktex-configuration">mktex configuration</a>. +See <a href="#mktex-configuration"><samp>mktex</samp> configuration</a>. </p> <span id="index-append_002donly-directories-and-mktexpk"></span> <p>The first restriction you can apply is to make newly-created directories under <samp>texmf</samp> be append-only with an option in <samp>mktex.cnf</samp>. -See <a href="#mktex-configuration">mktex configuration</a>. +See <a href="#mktex-configuration"><samp>mktex</samp> configuration</a>. </p> <span id="index-group_002dwritable-directories"></span> <span id="index-setgid-scripts"></span> @@ -497,9 +480,11 @@ always set. </p> <hr> -<span id="TeX-directory-structure"></span><div class="header"> +</div> +<div class="chapter" id="TeX-directory-structure"> +<div class="header"> <p> -Next: <a href="#Path-searching" accesskey="n" rel="next">Path searching</a>, Previous: <a href="#Security" accesskey="p" rel="prev">Security</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="#Path-searching" accesskey="n" rel="next">Path searching</a>, Previous: <a href="#Security" accesskey="p" rel="prev">Security</a>, Up: <a href="#Top" accesskey="u" rel="up">Kpathsea library</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="TeX-directory-structure-1"></span><h2 class="chapter">4 TeX directory structure</h2> @@ -514,8 +499,8 @@ distribution. It conforms to both the GNU coding standards and the TeX directory structure (TDS) standard. For rationale and further explanation, please see those documents. The GNU document is available from <a href="https://gnu.org/prep/standards">https://gnu.org/prep/standards</a>. The TDS -document is available from <a href="http://mirror.ctan.org/tds">http://mirror.ctan.org/tds</a> -(see <a href="#unixtex_002eftp">unixtex.ftp</a>). +document is available from <a href="https://ctan.org/pkg/tds">https://ctan.org/pkg/tds</a> +(see <a href="#unixtex_002eftp"><samp>unixtex.ftp</samp>: Obtaining TeX</a>). </p> <p>In short, here is a skeleton of the default directory structure, extracted from the TDS document: @@ -593,9 +578,11 @@ extracted from the TDS document: <hr> -<span id="Path-searching"></span><div class="header"> +</div> +<div class="chapter" id="Path-searching"> +<div class="header"> <p> -Next: <a href="#TeX-support" accesskey="n" rel="next">TeX support</a>, Previous: <a href="#TeX-directory-structure" accesskey="p" rel="prev">TeX directory structure</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="#TeX-support" accesskey="n" rel="next">TeX support</a>, Previous: <a href="#TeX-directory-structure" accesskey="p" rel="prev">TeX directory structure</a>, Up: <a href="#Top" accesskey="u" rel="up">Kpathsea library</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="Path-searching-1"></span><h2 class="chapter">5 Path searching</h2> @@ -611,24 +598,19 @@ other languages (Chinese, Spanish, Russian, Japanese, French, German, …) as part of the TeX Live guide; see <a href="https://tug.org/texlive/doc.html">https://tug.org/texlive/doc.html</a> for links. </p> -<table class="menu" border="0" cellspacing="0"> -<tr><td align="left" valign="top">• <a href="#Searching-overview" accesskey="1">Searching overview</a></td><td> </td><td align="left" valign="top">Basic scheme for searching. -</td></tr> -<tr><td align="left" valign="top">• <a href="#Path-sources" accesskey="2">Path sources</a></td><td> </td><td align="left" valign="top">Where search paths can be defined. -</td></tr> -<tr><td align="left" valign="top">• <a href="#Path-expansion" accesskey="3">Path expansion</a></td><td> </td><td align="left" valign="top">Special constructs in search paths. -</td></tr> -<tr><td align="left" valign="top">• <a href="#Casefolding-search" accesskey="4">Casefolding search</a></td><td> </td><td align="left" valign="top">Fallback to case-insensitive search. -</td></tr> -<tr><td align="left" valign="top">• <a href="#Filename-database" accesskey="5">Filename database</a></td><td> </td><td align="left" valign="top">Using an externally-built list to search. -</td></tr> -<tr><td align="left" valign="top">• <a href="#Invoking-kpsewhich" accesskey="6">Invoking kpsewhich</a></td><td> </td><td align="left" valign="top">Standalone path lookup. -</td></tr> -</table> +<ul class="section-toc"> +<li><a href="#Searching-overview" accesskey="1">Searching overview</a></li> +<li><a href="#Path-sources" accesskey="2">Path sources</a></li> +<li><a href="#Path-expansion" accesskey="3">Path expansion</a></li> +<li><a href="#Casefolding-search" accesskey="4">Casefolding search</a></li> +<li><a href="#Filename-database" accesskey="5">Filename database (<code>ls-R</code>)</a></li> +<li><a href="#Invoking-kpsewhich" accesskey="6"><code>kpsewhich</code>: Standalone path searching</a></li> +</ul> <hr> -<span id="Searching-overview"></span><div class="header"> +<div class="section" id="Searching-overview"> +<div class="header"> <p> Next: <a href="#Path-sources" accesskey="n" rel="next">Path sources</a>, Up: <a href="#Path-searching" accesskey="u" rel="up">Path searching</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> </div> @@ -656,7 +638,7 @@ operating systems’ conventions. <span id="index-database-search"></span> <span id="index-searching-the-database"></span> <p>To check a particular path element <var>e</var>, Kpathsea first sees if a -prebuilt database (see <a href="#Filename-database">Filename database</a>) applies to <var>e</var>, i.e., +prebuilt database (see <a href="#Filename-database">Filename database (<code>ls-R</code>)</a>) applies to <var>e</var>, i.e., if the database is in a directory that is a prefix of <var>e</var>. If so, the path specification is matched against the contents of the database. </p> @@ -734,7 +716,9 @@ algorithm when searching for a file of a particular type (see <a href="#File-loo </p> <hr> -<span id="Path-sources"></span><div class="header"> +</div> +<div class="section" id="Path-sources"> +<div class="header"> <p> Next: <a href="#Path-expansion" accesskey="n" rel="next">Path expansion</a>, Previous: <a href="#Searching-overview" accesskey="p" rel="prev">Searching overview</a>, Up: <a href="#Path-searching" accesskey="u" rel="up">Path searching</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> </div> @@ -758,7 +742,7 @@ override; for example, <code>TEXINPUTS_latex</code> overrides <code>TEXINPUTS</c if the program being run is named ‘<samp>latex</samp>’. </p> </li><li> A program-specific configuration file, e.g., an ‘<samp>S /a:/b</samp>’ line in -Dvips’ <samp>config.ps</samp> (see <a href="https://tug.org/texinfohtml/dvips.html#Config-files">Config files</a> in <cite>Dvips</cite>). +Dvips’ <samp>config.ps</samp> (see <a data-manual="dvips" href="https://tug.org/texinfohtml/dvips.html#Config-files">Config files</a> in <cite>Dvips</cite>). </li><li> <span id="index-configuration-file_002c-source-for-path"></span> <span id="index-Kpathsea-config-file_002c-source-for-path"></span> @@ -775,14 +759,14 @@ debugging options (see <a href="#Debugging">Debugging</a>). </p> <p>These sources may be combined via default expansion (see <a href="#Default-expansion">Default expansion</a>). </p> -<table class="menu" border="0" cellspacing="0"> -<tr><td align="left" valign="top">• <a href="#Config-files" accesskey="1">Config files</a></td><td> </td><td align="left" valign="top">Kpathsea’s runtime config files (texmf.cnf). -</td></tr> -</table> +<ul class="section-toc"> +<li><a href="#Config-files" accesskey="1">Config files</a></li> +</ul> <hr> -<span id="Config-files"></span><div class="header"> +<div class="subsection" id="Config-files"> +<div class="header"> <p> Up: <a href="#Path-sources" accesskey="u" rel="up">Path sources</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> </div> @@ -821,10 +805,10 @@ mentions most features. The format of <samp>texmf.cnf</samp> files follows: </p> <ul> <li> <span id="index-comments_002c-in-texmf_002ecnf"></span> -Comments start with ‘<samp>%</samp>’, either at the beginning of a line or -preceded by whitespace, and continue to the end of the line. That is, -similar to most shells, a ‘<samp>%</samp>’ in the “middle” of a value does not -start a comment. Examples: +Comments start with ‘<samp>%</samp>’ or ‘<samp>#</samp>’, either at the beginning of a +line or preceded by whitespace, and continue to the end of the line. +That is, similar to most shells, a comment character in the “middle” +of a value does not start a comment. Examples: <div class="example"> <pre class="example">% this is a comment @@ -898,16 +882,6 @@ TEXINPUTS.latex2e = $latex2e_inputs TEXINPUTS.latex = $latex2e_inputs </pre></div> -<span id="index-shell-scripts-as-configuration-files"></span> -<span id="index-configuration-files-as-shell-scripts_002e"></span> -<p>This format has some similarity to Bourne shell scripts—change the -comment character to <code>#</code>, disallow spaces around the <code>=</code>, -and get rid of the <code>.<var>name</var></code> convention, and it could be run -through the shell. However, there seemed little advantage in this, -since all the information would have to passed back to Kpathsea and -parsed there anyway, since the <code>sh</code> process couldn’t affect its -parent’s environment. -</p> <span id="index-_003d-omitted-in-texmf_002ecnf-and-misparsing"></span> <p>The combination of spaces being ignored before the <code>.</code> of a program name qualifer and the optional ‘<samp>=</samp>’ for the assignment has @@ -933,7 +907,10 @@ avoid them all. </p> <hr> -<span id="Path-expansion"></span><div class="header"> +</div> +</div> +<div class="section" id="Path-expansion"> +<div class="header"> <p> Next: <a href="#Casefolding-search" accesskey="n" rel="next">Casefolding search</a>, Previous: <a href="#Path-sources" accesskey="p" rel="prev">Path sources</a>, Up: <a href="#Path-searching" accesskey="u" rel="up">Path searching</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> </div> @@ -950,24 +927,19 @@ contain a directory or file <samp>baz</samp>. </p> <p>These expansions are explained in the sections below. </p> -<table class="menu" border="0" cellspacing="0"> -<tr><td align="left" valign="top">• <a href="#Default-expansion" accesskey="1">Default expansion</a></td><td> </td><td align="left" valign="top">a: or :a or a::b expands to a default. -</td></tr> -<tr><td align="left" valign="top">• <a href="#Variable-expansion" accesskey="2">Variable expansion</a></td><td> </td><td align="left" valign="top">$foo and ${foo} expand to environment values. -</td></tr> -<tr><td align="left" valign="top">• <a href="#Tilde-expansion" accesskey="3">Tilde expansion</a></td><td> </td><td align="left" valign="top">~ and ~user expand to home directories. -</td></tr> -<tr><td align="left" valign="top">• <a href="#Brace-expansion" accesskey="4">Brace expansion</a></td><td> </td><td align="left" valign="top">a{foo,bar}b expands to afoob abarb. -</td></tr> -<tr><td align="left" valign="top">• <a href="#KPSE_005fDOT-expansion" accesskey="5">KPSE_DOT expansion</a></td><td> </td><td align="left" valign="top">. is replaced with $KPSE_DOT if it is defined. -</td></tr> -<tr><td align="left" valign="top">• <a href="#Subdirectory-expansion" accesskey="6">Subdirectory expansion</a></td><td> </td><td align="left" valign="top">a// and a//b recursively expand to subdirs. -</td></tr> -</table> +<ul class="section-toc"> +<li><a href="#Default-expansion" accesskey="1">Default expansion</a></li> +<li><a href="#Variable-expansion" accesskey="2">Variable expansion</a></li> +<li><a href="#Tilde-expansion" accesskey="3">Tilde expansion</a></li> +<li><a href="#Brace-expansion" accesskey="4">Brace expansion</a></li> +<li><a href="#KPSE_005fDOT-expansion" accesskey="5"><code>KPSE_DOT</code> expansion</a></li> +<li><a href="#Subdirectory-expansion" accesskey="6">Subdirectory expansion</a></li> +</ul> <hr> -<span id="Default-expansion"></span><div class="header"> +<div class="subsection" id="Default-expansion"> +<div class="header"> <p> Next: <a href="#Variable-expansion" accesskey="n" rel="next">Variable expansion</a>, Up: <a href="#Path-expansion" accesskey="u" rel="up">Path expansion</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> </div> @@ -1040,7 +1012,9 @@ Default expansion is implemented in the source file </p> <hr> -<span id="Variable-expansion"></span><div class="header"> +</div> +<div class="subsection" id="Variable-expansion"> +<div class="header"> <p> Next: <a href="#Tilde-expansion" accesskey="n" rel="next">Tilde expansion</a>, Previous: <a href="#Default-expansion" accesskey="p" rel="prev">Default expansion</a>, Up: <a href="#Path-expansion" accesskey="u" rel="up">Path expansion</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> </div> @@ -1091,7 +1065,9 @@ paths are initialized (see <a href="#Path-sources">Path sources</a>). </p> <hr> -<span id="Tilde-expansion"></span><div class="header"> +</div> +<div class="subsection" id="Tilde-expansion"> +<div class="header"> <p> Next: <a href="#Brace-expansion" accesskey="n" rel="next">Brace expansion</a>, Previous: <a href="#Variable-expansion" accesskey="p" rel="prev">Variable expansion</a>, Up: <a href="#Path-expansion" accesskey="u" rel="up">Path expansion</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> </div> @@ -1134,9 +1110,11 @@ is ‘<samp>/</samp>’, the path element ‘<samp>~root/mymacros</s </p> <hr> -<span id="Brace-expansion"></span><div class="header"> +</div> +<div class="subsection" id="Brace-expansion"> +<div class="header"> <p> -Next: <a href="#KPSE_005fDOT-expansion" accesskey="n" rel="next">KPSE_DOT expansion</a>, Previous: <a href="#Tilde-expansion" accesskey="p" rel="prev">Tilde expansion</a>, Up: <a href="#Path-expansion" accesskey="u" rel="up">Path expansion</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="#KPSE_005fDOT-expansion" accesskey="n" rel="next"><code>KPSE_DOT</code> expansion</a>, Previous: <a href="#Tilde-expansion" accesskey="p" rel="prev">Tilde expansion</a>, Up: <a href="#Path-expansion" accesskey="u" rel="up">Path expansion</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="Brace-expansion-1"></span><h4 class="subsection">5.3.4 Brace expansion</h4> @@ -1175,7 +1153,9 @@ example could have been written ‘<samp>x{A:B}{1:2}y</samp>’ (on Unix </p> <hr> -<span id="KPSE_005fDOT-expansion"></span><div class="header"> +</div> +<div class="subsection" id="KPSE_005fDOT-expansion"> +<div class="header"> <p> Next: <a href="#Subdirectory-expansion" accesskey="n" rel="next">Subdirectory expansion</a>, Previous: <a href="#Brace-expansion" accesskey="p" rel="prev">Brace expansion</a>, Up: <a href="#Path-expansion" accesskey="u" rel="up">Path expansion</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> </div> @@ -1186,14 +1166,16 @@ Next: <a href="#Subdirectory-expansion" accesskey="n" rel="next">Subdirectory ex <p>When <code>KPSE_DOT</code> is defined in the environment, it names a directory that should be considered the current directory for the purpose of looking up files in the search paths. This feature is needed by the -‘<samp>mktex…</samp>’ scripts <a href="#mktex-scripts">mktex scripts</a>, because these +‘<samp>mktex…</samp>’ scripts <a href="#mktex-scripts"><samp>mktex</samp> scripts</a>, because these change the working directory. You should not ever define it yourself. </p> <hr> -<span id="Subdirectory-expansion"></span><div class="header"> +</div> +<div class="subsection" id="Subdirectory-expansion"> +<div class="header"> <p> -Previous: <a href="#KPSE_005fDOT-expansion" accesskey="p" rel="prev">KPSE_DOT expansion</a>, Up: <a href="#Path-expansion" accesskey="u" rel="up">Path expansion</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="#KPSE_005fDOT-expansion" accesskey="p" rel="prev"><code>KPSE_DOT</code> expansion</a>, Up: <a href="#Path-expansion" accesskey="u" rel="up">Path expansion</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="Subdirectory-expansion-1"></span><h4 class="subsection">5.3.6 Subdirectory expansion</h4> @@ -1259,9 +1241,12 @@ know. </p> <hr> -<span id="Casefolding-search"></span><div class="header"> +</div> +</div> +<div class="section" id="Casefolding-search"> +<div class="header"> <p> -Next: <a href="#Filename-database" accesskey="n" rel="next">Filename database</a>, Previous: <a href="#Path-expansion" accesskey="p" rel="prev">Path expansion</a>, Up: <a href="#Path-searching" accesskey="u" rel="up">Path searching</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="#Filename-database" accesskey="n" rel="next">Filename database (<code>ls-R</code>)</a>, Previous: <a href="#Path-expansion" accesskey="p" rel="prev">Path expansion</a>, Up: <a href="#Path-searching" accesskey="u" rel="up">Path searching</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="Casefolding-search-1"></span><h3 class="section">5.4 Casefolding search</h3> @@ -1280,15 +1265,14 @@ runtime by setting the configuration variable <code>texmf_casefold_search</code>, to a true value, e.g., ‘<samp>1</samp>’; this is done by default in TeX Live. </p> -<table class="menu" border="0" cellspacing="0"> -<tr><td align="left" valign="top">• <a href="#Casefolding-rationale" accesskey="1">Rationale</a></td><td> </td><td align="left" valign="top"> -</td></tr> -<tr><td align="left" valign="top">• <a href="#Casefolding-examples" accesskey="2">Examples</a></td><td> </td><td align="left" valign="top"> -</td></tr> -</table> +<ul class="section-toc"> +<li><a href="#Casefolding-rationale" accesskey="1">Casefolding rationale</a></li> +<li><a href="#Casefolding-examples" accesskey="2">Casefolding examples</a></li> +</ul> <hr> -<span id="Casefolding-rationale"></span><div class="header"> +<div class="subsection" id="Casefolding-rationale"> +<div class="header"> <p> Next: <a href="#Casefolding-examples" accesskey="n" rel="next">Casefolding examples</a>, Up: <a href="#Casefolding-search" accesskey="u" rel="up">Casefolding search</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> </div> @@ -1327,7 +1311,9 @@ always been true. </p> <hr> -<span id="Casefolding-examples"></span><div class="header"> +</div> +<div class="subsection" id="Casefolding-examples"> +<div class="header"> <p> Previous: <a href="#Casefolding-rationale" accesskey="p" rel="prev">Casefolding rationale</a>, Up: <a href="#Casefolding-search" accesskey="u" rel="up">Casefolding search</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> </div> @@ -1395,7 +1381,7 @@ case-sensitive systems), as it always has. <span id="index-_0021_0021-and-casefolding"></span> <p>The caveat about not searching the disk amounts to saying that casefolding does not happen in the trees specified with ‘<samp>!!</samp>’ -(see <a href="#ls_002dR">ls-R</a>), that is, where only database (<samp>ls-R</samp>) searching +(see <a href="#ls_002dR"><samp>ls-R</samp></a>), that is, where only database (<samp>ls-R</samp>) searching is done. In TeX Live, that is the ‘<samp>texmf-local</samp>’ and ‘<samp>texmf-dist</samp>’ trees (also <code>$TEXMFSYSCONFIG</code> and <code>$TEXMFSYSVAR</code>, but those are rarely noticed). The rationale for @@ -1444,9 +1430,12 @@ happens with the elements of the leaf directory. <hr> -<span id="Filename-database"></span><div class="header"> +</div> +</div> +<div class="section" id="Filename-database"> +<div class="header"> <p> -Next: <a href="#Invoking-kpsewhich" accesskey="n" rel="next">Invoking kpsewhich</a>, Previous: <a href="#Casefolding-search" accesskey="p" rel="prev">Casefolding search</a>, Up: <a href="#Path-searching" accesskey="u" rel="up">Path searching</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-kpsewhich" accesskey="n" rel="next"><code>kpsewhich</code>: Standalone path searching</a>, Previous: <a href="#Casefolding-search" accesskey="p" rel="prev">Casefolding search</a>, Up: <a href="#Path-searching" accesskey="u" rel="up">Path searching</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="Filename-database-_0028ls_002dR_0029"></span><h3 class="section">5.5 Filename database (<code>ls-R</code>)</h3> @@ -1469,20 +1458,18 @@ names to the files listed in <samp>ls-R</samp>. <p>The <samp>ls-R</samp> and <samp>aliases</samp> features are implemented in the source file <samp>kpathsea/db.c</samp>. </p> -<table class="menu" border="0" cellspacing="0"> -<tr><td align="left" valign="top">• <a href="#ls_002dR" accesskey="1">ls-R</a></td><td> </td><td align="left" valign="top">The main filename database. -</td></tr> -<tr><td align="left" valign="top">• <a href="#Filename-aliases" accesskey="2">Filename aliases</a></td><td> </td><td align="left" valign="top">Aliases for those names. -</td></tr> -<tr><td align="left" valign="top">• <a href="#Database-format" accesskey="3">Database format</a></td><td> </td><td align="left" valign="top">Syntax details of the database file. -</td></tr> -</table> +<ul class="section-toc"> +<li><a href="#ls_002dR" accesskey="1"><samp>ls-R</samp></a></li> +<li><a href="#Filename-aliases" accesskey="2">Filename aliases</a></li> +<li><a href="#Database-format" accesskey="3">Database format</a></li> +</ul> <hr> -<span id="ls_002dR"></span><div class="header"> +<div class="subsection" id="ls_002dR"> +<div class="header"> <p> -Next: <a href="#Filename-aliases" accesskey="n" rel="next">Filename aliases</a>, Up: <a href="#Filename-database" accesskey="u" rel="up">Filename database</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="#Filename-aliases" accesskey="n" rel="next">Filename aliases</a>, Up: <a href="#Filename-database" accesskey="u" rel="up">Filename database (<code>ls-R</code>)</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="ls_002dR-1"></span><h4 class="subsection">5.5.1 <samp>ls-R</samp></h4> @@ -1586,9 +1573,11 @@ found. <hr> -<span id="Filename-aliases"></span><div class="header"> +</div> +<div class="subsection" id="Filename-aliases"> +<div class="header"> <p> -Next: <a href="#Database-format" accesskey="n" rel="next">Database format</a>, Previous: <a href="#ls_002dR" accesskey="p" rel="prev">ls-R</a>, Up: <a href="#Filename-database" accesskey="u" rel="up">Filename database</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="#Database-format" accesskey="n" rel="next">Database format</a>, Previous: <a href="#ls_002dR" accesskey="p" rel="prev"><samp>ls-R</samp></a>, Up: <a href="#Filename-database" accesskey="u" rel="up">Filename database (<code>ls-R</code>)</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="Filename-aliases-1"></span><h4 class="subsection">5.5.2 Filename aliases</h4> @@ -1621,9 +1610,11 @@ aliases. </p> <hr> -<span id="Database-format"></span><div class="header"> +</div> +<div class="subsection" id="Database-format"> +<div class="header"> <p> -Previous: <a href="#Filename-aliases" accesskey="p" rel="prev">Filename aliases</a>, Up: <a href="#Filename-database" accesskey="u" rel="up">Filename database</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="#Filename-aliases" accesskey="p" rel="prev">Filename aliases</a>, Up: <a href="#Filename-database" accesskey="u" rel="up">Filename database (<code>ls-R</code>)</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="Database-format-1"></span><h4 class="subsection">5.5.3 Database format</h4> @@ -1673,9 +1664,12 @@ btxdoc.bib <hr> -<span id="Invoking-kpsewhich"></span><div class="header"> +</div> +</div> +<div class="section" id="Invoking-kpsewhich"> +<div class="header"> <p> -Previous: <a href="#Filename-database" accesskey="p" rel="prev">Filename database</a>, Up: <a href="#Path-searching" accesskey="u" rel="up">Path searching</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="#Filename-database" accesskey="p" rel="prev">Filename database (<code>ls-R</code>)</a>, Up: <a href="#Path-searching" accesskey="u" rel="up">Path searching</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="kpsewhich_003a-Standalone-path-searching"></span><h3 class="section">5.6 <code>kpsewhich</code>: Standalone path searching</h3> @@ -1699,22 +1693,19 @@ distributed ‘<samp>mktex…</samp>’ scripts. Options can start with either ‘<samp>-</samp>’ or ‘<samp>--</samp>’, and any unambiguous abbreviation is accepted. </p> -<table class="menu" border="0" cellspacing="0"> -<tr><td align="left" valign="top">• <a href="#Path-searching-options" accesskey="1">Path searching options</a></td><td> </td><td align="left" valign="top">Changing the mode, resolution, etc. -</td></tr> -<tr><td align="left" valign="top">• <a href="#Specially_002drecognized-files" accesskey="2">Specially-recognized files</a></td><td> </td><td align="left" valign="top">Default formats for texmf.cnf, etc. -</td></tr> -<tr><td align="left" valign="top">• <a href="#Auxiliary-tasks" accesskey="3">Auxiliary tasks</a></td><td> </td><td align="left" valign="top">Path and variable expansion, etc. -</td></tr> -<tr><td align="left" valign="top">• <a href="#Standard-options" accesskey="4">Standard options</a></td><td> </td><td align="left" valign="top">‘<samp>--help</samp>’ and ‘<samp>--version</samp>’. -</td></tr> -</table> +<ul class="section-toc"> +<li><a href="#Path-searching-options" accesskey="1">Path searching options</a></li> +<li><a href="#Specially_002drecognized-files" accesskey="2">Specially-recognized files for <code>kpsewhich</code></a></li> +<li><a href="#Auxiliary-tasks" accesskey="3">Auxiliary tasks</a></li> +<li><a href="#Standard-options" accesskey="4">Standard options</a></li> +</ul> <hr> -<span id="Path-searching-options"></span><div class="header"> +<div class="subsection" id="Path-searching-options"> +<div class="header"> <p> -Next: <a href="#Specially_002drecognized-files" accesskey="n" rel="next">Specially-recognized files</a>, Up: <a href="#Invoking-kpsewhich" accesskey="u" rel="up">Invoking kpsewhich</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="#Specially_002drecognized-files" accesskey="n" rel="next">Specially-recognized files for <code>kpsewhich</code></a>, Up: <a href="#Invoking-kpsewhich" accesskey="u" rel="up"><code>kpsewhich</code>: Standalone path searching</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="Path-searching-options-1"></span><h4 class="subsection">5.6.1 Path searching options</h4> @@ -1726,19 +1717,17 @@ filename, and returns the first file found. <p>Various options alter the path searching behavior: </p> <dl compact="compact"> -<dt>‘<samp>--all</samp>’</dt> -<dd><span id="index-_002d_002dall"></span> -<span id="index-all-matches_002c-finding"></span> +<dt id='index-_002d_002dall'><span>‘<samp>--all</samp>’<a href='#index-_002d_002dall' class='copiable-anchor'> ¶</a></span></dt> +<dd><span id="index-all-matches_002c-finding"></span> <p>Report all matches found, one per line. By default, if there is more than one match, just one will be reported (chosen effectively at random). Exception: with the glyph formats (<code>pk</code>, <code>gf</code>), this option has no effect and only the first match is returned. </p> </dd> -<dt>‘<samp>--casefold-search</samp>’</dt> -<dt>‘<samp>--no-casefold-search</samp>’</dt> -<dd><span id="index-_002d_002dcasefold_002dsearch"></span> -<span id="index-_002d_002dno_002dcasefold_002dsearch"></span> +<dt id='index-_002d_002dcasefold_002dsearch'><span>‘<samp>--casefold-search</samp>’<a href='#index-_002d_002dcasefold_002dsearch' class='copiable-anchor'> ¶</a></span></dt> +<dt><span>‘<samp>--no-casefold-search</samp>’</span></dt> +<dd><span id="index-_002d_002dno_002dcasefold_002dsearch"></span> <p>Explicitly enable or disable the fallback to a case-insensitive search on Unix platforms (see <a href="#Casefolding-search">Casefolding search</a>); no effect on Windows. The default is enabled, set in <code>texmf.cnf</code>. Disabling @@ -1748,9 +1737,8 @@ case-insensitive, it merely means that Kpathsea does not do any casefolding itself. </p> </dd> -<dt>‘<samp>--cnf-line=<var>str</var></samp>’</dt> -<dd><span id="index-_002d_002dcnf_002dline"></span> -<p>Parse <var>str</var> as if it were a line in the <samp>texmf.cnf</samp> +<dt id='index-_002d_002dcnf_002dline'><span>‘<samp>--cnf-line=<var>str</var></samp>’<a href='#index-_002d_002dcnf_002dline' class='copiable-anchor'> ¶</a></span></dt> +<dd><p>Parse <var>str</var> as if it were a line in the <samp>texmf.cnf</samp> configuration file (see <a href="#Config-files">Config files</a>), overriding settings in the actual configuration files, and also in the environment (see <a href="#Path-sources">Path sources</a>). This is implemented by making any settings from <var>str</var> in the environment, overwriting any value already there. Thus, an @@ -1770,18 +1758,16 @@ behavior is for values set on the command line with <code>--cnf-line</code> to override them. </p> </dd> -<dt>‘<samp>--dpi=<var>num</var></samp>’</dt> -<dd><span id="index-_002d_002ddpi_003dnum"></span> -<span id="index-_002dD-num"></span> +<dt id='index-_002d_002ddpi_003dnum'><span>‘<samp>--dpi=<var>num</var></samp>’<a href='#index-_002d_002ddpi_003dnum' class='copiable-anchor'> ¶</a></span></dt> +<dd><span id="index-_002dD-num"></span> <span id="index-resolution_002c-setting"></span> <p>Set the resolution to <var>num</var>; this only affects ‘<samp>gf</samp>’ and ‘<samp>pk</samp>’ lookups. ‘<samp>-D</samp>’ is a synonym, for compatibility with Dvips. Default is 600. </p> </dd> -<dt>‘<samp>--engine=<var>name</var></samp>’</dt> -<dd><span id="index-_002d_002dengine_003dname"></span> -<span id="index-engine-name"></span> +<dt id='index-_002d_002dengine_003dname'><span>‘<samp>--engine=<var>name</var></samp>’<a href='#index-_002d_002dengine_003dname' class='copiable-anchor'> ¶</a></span></dt> +<dd><span id="index-engine-name"></span> <p>Set the engine name to <var>name</var>. By default it is not set. The engine name is used in some search paths to allow files with the same name but used by different engines to coexist. @@ -1799,9 +1785,8 @@ a normal recursive search along the path where the dumps are stored, namely ‘<samp>$TEXMF/web2c{/$engine,}</samp>’.) </p> </dd> -<dt>‘<samp>--format=<var>name</var></samp>’</dt> -<dd><span id="index-_002d_002dformat_003dname"></span> -<p>Set the format for lookup to <var>name</var>. By default, the format is +<dt id='index-_002d_002dformat_003dname'><span>‘<samp>--format=<var>name</var></samp>’<a href='#index-_002d_002dformat_003dname' class='copiable-anchor'> ¶</a></span></dt> +<dd><p>Set the format for lookup to <var>name</var>. By default, the format is guessed from the filename, with ‘<samp>tex</samp>’ being used if nothing else fits. The recognized filename extensions (including any leading ‘<samp>.</samp>’) are also allowable <var>name</var>s. @@ -1884,40 +1869,35 @@ bltxml: .bltxml <p>This option and ‘<samp>--path</samp>’ are mutually exclusive. </p> </dd> -<dt>‘<samp>--interactive</samp>’</dt> -<dd><span id="index-_002d_002dinteractive"></span> -<span id="index-interactive-query"></span> +<dt id='index-_002d_002dinteractive'><span>‘<samp>--interactive</samp>’<a href='#index-_002d_002dinteractive' class='copiable-anchor'> ¶</a></span></dt> +<dd><span id="index-interactive-query"></span> <p>After processing the command line, read additional filenames to look up from standard input. </p> </dd> -<dt>‘<samp>--mktex=<var>filetype</var></samp>’</dt> -<dt>‘<samp>--no-mktex=<var>filetype</var></samp>’</dt> -<dd><span id="index-_002d_002dmktex_003dfiletype"></span> -<span id="index-_002d_002dno_002dmktex_003dfiletype"></span> +<dt id='index-_002d_002dmktex_003dfiletype'><span>‘<samp>--mktex=<var>filetype</var></samp>’<a href='#index-_002d_002dmktex_003dfiletype' class='copiable-anchor'> ¶</a></span></dt> +<dt><span>‘<samp>--no-mktex=<var>filetype</var></samp>’</span></dt> +<dd><span id="index-_002d_002dno_002dmktex_003dfiletype"></span> <p>Turn on or off the ‘<samp>mktex</samp>’ script associated with <var>filetype</var>. Usual values for <var>filetype</var> are ‘<samp>pk</samp>’, ‘<samp>mf</samp>’, ‘<samp>tex</samp>’, and ‘<samp>tfm</samp>’. By default, all are off in Kpsewhich, even if they are enabled for TeX. This option implies setting -<code>--must-exist</code>. See <a href="#mktex-scripts">mktex scripts</a>. +<code>--must-exist</code>. See <a href="#mktex-scripts"><samp>mktex</samp> scripts</a>. </p> </dd> -<dt>‘<samp>--mode=<var>string</var></samp>’</dt> -<dd><span id="index-_002d_002dmode_003dstring"></span> -<p>Set the mode name to <var>string</var>; this also only affects ‘<samp>gf</samp>’ and -‘<samp>pk</samp>’ lookups. No default: any mode will be found. See <a href="#mktex-script-arguments">mktex script arguments</a>. +<dt id='index-_002d_002dmode_003dstring'><span>‘<samp>--mode=<var>string</var></samp>’<a href='#index-_002d_002dmode_003dstring' class='copiable-anchor'> ¶</a></span></dt> +<dd><p>Set the mode name to <var>string</var>; this also only affects ‘<samp>gf</samp>’ and +‘<samp>pk</samp>’ lookups. No default: any mode will be found. See <a href="#mktex-script-arguments"><samp>mktex</samp> script arguments</a>. </p> </dd> -<dt>‘<samp>--must-exist</samp>’</dt> -<dd><span id="index-_002d_002dmust_002dexist"></span> -<p>Do everything possible to find the files, notably including searching +<dt id='index-_002d_002dmust_002dexist'><span>‘<samp>--must-exist</samp>’<a href='#index-_002d_002dmust_002dexist' class='copiable-anchor'> ¶</a></span></dt> +<dd><p>Do everything possible to find the files, notably including searching the disk and running the ‘<samp>mktex</samp>’ scripts. By default, only the <samp>ls-R</samp> database is checked, in the interest of efficiency. </p> </dd> -<dt>‘<samp>--path=<var>string</var></samp>’</dt> -<dd><span id="index-_002d_002dpath_003dstring"></span> -<p>Search along the path <var>string</var> (colon-separated as usual), instead +<dt id='index-_002d_002dpath_003dstring'><span>‘<samp>--path=<var>string</var></samp>’<a href='#index-_002d_002dpath_003dstring' class='copiable-anchor'> ¶</a></span></dt> +<dd><p>Search along the path <var>string</var> (colon-separated as usual), instead of guessing the search path from the filename. ‘<samp>//</samp>’ and all the usual expansions are supported (see <a href="#Path-expansion">Path expansion</a>). This option and ‘<samp>--format</samp>’ are mutually exclusive. To output the complete @@ -1925,16 +1905,14 @@ directory expansion of a path, instead of doing a one-shot lookup, see ‘<samp>--expand-path</samp>’ and ‘<samp>--show-path</samp>’ in the following section. </p> </dd> -<dt>‘<samp>--progname=<var>name</var></samp>’</dt> -<dd><span id="index-_002d_002dprogname_003dname"></span> -<p>Set the program name to <var>name</var>; default is ‘<samp>kpsewhich</samp>’. This +<dt id='index-_002d_002dprogname_003dname'><span>‘<samp>--progname=<var>name</var></samp>’<a href='#index-_002d_002dprogname_003dname' class='copiable-anchor'> ¶</a></span></dt> +<dd><p>Set the program name to <var>name</var>; default is ‘<samp>kpsewhich</samp>’. This can affect the search paths via the ‘<samp>.<var>prognam</var></samp>’ feature in configuration files (see <a href="#Config-files">Config files</a>). </p> </dd> -<dt>‘<samp>--subdir=<var>string</var></samp>’</dt> -<dd><span id="index-_002d_002dsubdir_003dstring"></span> -<p>Report only those matches whose directory part <em>ends</em> with +<dt id='index-_002d_002dsubdir_003dstring'><span>‘<samp>--subdir=<var>string</var></samp>’<a href='#index-_002d_002dsubdir_003dstring' class='copiable-anchor'> ¶</a></span></dt> +<dd><p>Report only those matches whose directory part <em>ends</em> with <var>string</var> (compared literally, except case is ignored on a case-insensitive operating system). For example, suppose there are two matches for a given name: @@ -2013,9 +1991,11 @@ in <samp>/some/coincidental/pkg1/path/</samp>, and we wouldn’t want to mat <hr> -<span id="Specially_002drecognized-files"></span><div class="header"> +</div> +<div class="subsection" id="Specially_002drecognized-files"> +<div class="header"> <p> -Next: <a href="#Auxiliary-tasks" accesskey="n" rel="next">Auxiliary tasks</a>, Previous: <a href="#Path-searching-options" accesskey="p" rel="prev">Path searching options</a>, Up: <a href="#Invoking-kpsewhich" accesskey="u" rel="up">Invoking kpsewhich</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="#Auxiliary-tasks" accesskey="n" rel="next">Auxiliary tasks</a>, Previous: <a href="#Path-searching-options" accesskey="p" rel="prev">Path searching options</a>, Up: <a href="#Invoking-kpsewhich" accesskey="u" rel="up"><code>kpsewhich</code>: Standalone path searching</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="Specially_002drecognized-files-for-kpsewhich"></span><h4 class="subsection">5.6.2 Specially-recognized files for <code>kpsewhich</code></h4> @@ -2033,49 +2013,49 @@ with their corresponding format: <dd> <span id="index-config_002eps"></span> </dd> -<dt><samp>config.ps</samp></dt> +<dt><span><samp>config.ps</samp></span></dt> <dd><p><code>dvips config</code> </p> <span id="index-dvipdfmx_002ecfg"></span> </dd> -<dt><samp>dvipdfmx.cfg</samp></dt> +<dt><span><samp>dvipdfmx.cfg</samp></span></dt> <dd><p>‘<samp>other text files</samp>’ </p> <span id="index-fmtutil_002ecnf"></span> </dd> -<dt><samp>fmtutil.cnf</samp></dt> +<dt><span><samp>fmtutil.cnf</samp></span></dt> <dd><p>‘<samp>web2c files</samp>’ </p> <span id="index-glyphlist_002etxt"></span> </dd> -<dt><samp>glyphlist.txt</samp></dt> +<dt><span><samp>glyphlist.txt</samp></span></dt> <dd><p>‘<samp>map</samp>’ </p> <span id="index-mktex_002ecnf"></span> </dd> -<dt><samp>mktex.cnf</samp></dt> +<dt><span><samp>mktex.cnf</samp></span></dt> <dd><p>‘<samp>web2c files</samp>’ </p> <span id="index-pdfglyphlist_002etxt"></span> </dd> -<dt><samp>pdfglyphlist.txt</samp></dt> +<dt><span><samp>pdfglyphlist.txt</samp></span></dt> <dd><p>‘<samp>map</samp>’ </p> <span id="index-pdftex_002ecfg"></span> <span id="index-pdftexconfig_002etex"></span> </dd> -<dt><samp>pdftex.cfg</samp></dt> +<dt><span><samp>pdftex.cfg</samp></span></dt> <dd><p>‘<samp>pdftex config</samp>’ (although <samp>pdftex.cfg</samp> is not used any more; look for the file <samp>pdftexconfig.tex</samp> instead.) </p> <span id="index-texmf_002ecnf"></span> </dd> -<dt><samp>texmf.cnf</samp></dt> +<dt><span><samp>texmf.cnf</samp></span></dt> <dd><p>‘<samp>cnf</samp>’ </p> <span id="index-XDvi"></span> </dd> -<dt><samp>XDvi</samp></dt> +<dt><span><samp>XDvi</samp></span></dt> <dd><p>‘<samp>other text files</samp>’ </p> </dd> @@ -2090,9 +2070,11 @@ information about the above configuration files (among others). </p> <hr> -<span id="Auxiliary-tasks"></span><div class="header"> +</div> +<div class="subsection" id="Auxiliary-tasks"> +<div class="header"> <p> -Next: <a href="#Standard-options" accesskey="n" rel="next">Standard options</a>, Previous: <a href="#Specially_002drecognized-files" accesskey="p" rel="prev">Specially-recognized files</a>, Up: <a href="#Invoking-kpsewhich" accesskey="u" rel="up">Invoking kpsewhich</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="#Standard-options" accesskey="n" rel="next">Standard options</a>, Previous: <a href="#Specially_002drecognized-files" accesskey="p" rel="prev">Specially-recognized files for <code>kpsewhich</code></a>, Up: <a href="#Invoking-kpsewhich" accesskey="u" rel="up"><code>kpsewhich</code>: Standalone path searching</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="Auxiliary-tasks-1"></span><h4 class="subsection">5.6.3 Auxiliary tasks</h4> @@ -2101,20 +2083,17 @@ Next: <a href="#Standard-options" accesskey="n" rel="next">Standard options</a>, <p>Kpsewhich provides some features in addition to path lookup as such: </p> <dl compact="compact"> -<dt>‘<samp>--debug=<var>num</var></samp>’</dt> -<dd><span id="index-_002d_002ddebug_003dnum"></span> -<p>Set debugging options to <var>num</var>. See <a href="#Debugging">Debugging</a>. +<dt id='index-_002d_002ddebug_003dnum'><span>‘<samp>--debug=<var>num</var></samp>’<a href='#index-_002d_002ddebug_003dnum' class='copiable-anchor'> ¶</a></span></dt> +<dd><p>Set debugging options to <var>num</var>. See <a href="#Debugging">Debugging</a>. </p> </dd> -<dt>‘<samp>--expand-braces=<var>string</var></samp>’</dt> -<dd><span id="index-_002d_002dexpand_002dbraces_003dstring"></span> -<p>Output variable, tilde, and brace expansion of <var>string</var>, which is +<dt id='index-_002d_002dexpand_002dbraces_003dstring'><span>‘<samp>--expand-braces=<var>string</var></samp>’<a href='#index-_002d_002dexpand_002dbraces_003dstring' class='copiable-anchor'> ¶</a></span></dt> +<dd><p>Output variable, tilde, and brace expansion of <var>string</var>, which is assumed to be a single path element. See <a href="#Path-expansion">Path expansion</a>. </p> </dd> -<dt>‘<samp>--expand-path=<var>string</var></samp>’</dt> -<dd><span id="index-_002d_002dexpand_002dpath_003dstring"></span> -<p>Output the complete expansion of <var>string</var>, with each element +<dt id='index-_002d_002dexpand_002dpath_003dstring'><span>‘<samp>--expand-path=<var>string</var></samp>’<a href='#index-_002d_002dexpand_002dpath_003dstring' class='copiable-anchor'> ¶</a></span></dt> +<dd><p>Output the complete expansion of <var>string</var>, with each element separated by the usual path separator on the current system (‘<samp>;</samp>’ on Windows, ‘<samp>:</samp>’ otherwise). This may be useful to construct a custom search path for a format not otherwise supported. To retrieve @@ -2134,9 +2113,8 @@ $ kpsewhich --expand-path '/nonesuch' ‘<samp>--path</samp>’ (see <a href="#Path-searching-options">Path searching options</a>). </p> </dd> -<dt>‘<samp>--expand-var=<var>string</var></samp>’</dt> -<dd><span id="index-_002d_002dexpand_002dvar_003dstring"></span> -<p>Output the variable and tilde expansion of <var>string</var>. For example, +<dt id='index-_002d_002dexpand_002dvar_003dstring'><span>‘<samp>--expand-var=<var>string</var></samp>’<a href='#index-_002d_002dexpand_002dvar_003dstring' class='copiable-anchor'> ¶</a></span></dt> +<dd><p>Output the variable and tilde expansion of <var>string</var>. For example, with the usual <samp>texmf.cnf</samp>, ‘<samp>kpsewhich --expand-var='$TEXMF'</samp>’ returns the TeX system hierarchy root(s). See <a href="#Path-expansion">Path expansion</a>. The specified <var>string</var> can contain @@ -2144,33 +2122,29 @@ anything, though, not just variable references. This calls <code>kpse_var_expand</code> (see <a href="#Programming-with-config-files">Programming with config files</a>). </p> </dd> -<dt>‘<samp>--help-formats</samp>’</dt> -<dd><span id="index-_002d_002dhelp_002dformats"></span> -<p>Output information about each supported format (see <a href="#Supported-file-formats">Supported file formats</a>), including the names and abbreviations, variables +<dt id='index-_002d_002dhelp_002dformats'><span>‘<samp>--help-formats</samp>’<a href='#index-_002d_002dhelp_002dformats' class='copiable-anchor'> ¶</a></span></dt> +<dd><p>Output information about each supported format (see <a href="#Supported-file-formats">Supported file formats</a>), including the names and abbreviations, variables looked for, and the original path. </p> </dd> -<dt>‘<samp>--safe-in-name=<var>name</var></samp>’</dt> -<dt>‘<samp>--safe-out-name=<var>name</var></samp>’</dt> -<dd><span id="index-_002d_002dsafe_002din_002dname_003dname"></span> -<span id="index-_002d_002dsafe_002dout_002dname_003dname"></span> +<dt id='index-_002d_002dsafe_002din_002dname_003dname'><span>‘<samp>--safe-in-name=<var>name</var></samp>’<a href='#index-_002d_002dsafe_002din_002dname_003dname' class='copiable-anchor'> ¶</a></span></dt> +<dt><span>‘<samp>--safe-out-name=<var>name</var></samp>’</span></dt> +<dd><span id="index-_002d_002dsafe_002dout_002dname_003dname"></span> <p>Exit successfully if <var>name</var> is safe to open for reading or writing, respectively, else unsuccessfully. No output is written. These tests take account of the related Kpathsea configuration settings (see <a href="#Calling-sequence">Calling sequence</a>). </p> </dd> -<dt>‘<samp>--show-path=<var>name</var></samp>’</dt> -<dd><span id="index-_002d_002dshow_002dpath_003dname"></span> -<p>Show the path that would be used for file lookups of file type +<dt id='index-_002d_002dshow_002dpath_003dname'><span>‘<samp>--show-path=<var>name</var></samp>’<a href='#index-_002d_002dshow_002dpath_003dname' class='copiable-anchor'> ¶</a></span></dt> +<dd><p>Show the path that would be used for file lookups of file type <var>name</var>. Either a filename extension (‘<samp>pk</samp>’, ‘<samp>.vf</samp>’, etc.) or an integer can be used, just as with ‘<samp>--format</samp>’, described in the previous section. </p> </dd> -<dt>‘<samp>--var-brace-value=<var>variable</var></samp>’</dt> -<dd><span id="index-_002d_002dvar_002dbrace_002dvalue_003dvariable"></span> -<p>Like ‘<samp>--var-value</samp>’ (next), but also expands ‘<samp>{...}</samp>’ +<dt id='index-_002d_002dvar_002dbrace_002dvalue_003dvariable'><span>‘<samp>--var-brace-value=<var>variable</var></samp>’<a href='#index-_002d_002dvar_002dbrace_002dvalue_003dvariable' class='copiable-anchor'> ¶</a></span></dt> +<dd><p>Like ‘<samp>--var-value</samp>’ (next), but also expands ‘<samp>{...}</samp>’ constructs. (see <a href="#Brace-expansion">Brace expansion</a>). Thus, the value is assumed to possibly be several path elements, and ‘<samp>~</samp>’ is expanded at the beginning of each. The path separator is changed to that of the @@ -2184,9 +2158,8 @@ value, as commonly used in <samp>texmf.cnf</samp>, has changed to a Windows-ish system, the ‘<samp>;</samp>’ would remain. </p> </dd> -<dt>‘<samp>--var-value=<var>variable</var></samp>’</dt> -<dd><span id="index-_002d_002dvar_002dvalue_003dvariable"></span> -<p>Outputs the value of <var>variable</var> (a simple identifier like +<dt id='index-_002d_002dvar_002dvalue_003dvariable'><span>‘<samp>--var-value=<var>variable</var></samp>’<a href='#index-_002d_002dvar_002dvalue_003dvariable' class='copiable-anchor'> ¶</a></span></dt> +<dd><p>Outputs the value of <var>variable</var> (a simple identifier like ‘<samp>TEXMFDIST</samp>’, with no ‘<samp>$</samp>’ or other constructs), expanding ‘<samp>$</samp>’ (see <a href="#Variable-expansion">Variable expansion</a>) and ‘<samp>~</samp>’ (see <a href="#Tilde-expansion">Tilde expansion</a>) constructs in the value. ‘<samp>~</samp>’ expansion happens at the beginning of the overall value and at the beginning of a variable @@ -2204,9 +2177,11 @@ input value, on all systems. <hr> -<span id="Standard-options"></span><div class="header"> +</div> +<div class="subsection" id="Standard-options"> +<div class="header"> <p> -Previous: <a href="#Auxiliary-tasks" accesskey="p" rel="prev">Auxiliary tasks</a>, Up: <a href="#Invoking-kpsewhich" accesskey="u" rel="up">Invoking kpsewhich</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="#Auxiliary-tasks" accesskey="p" rel="prev">Auxiliary tasks</a>, Up: <a href="#Invoking-kpsewhich" accesskey="u" rel="up"><code>kpsewhich</code>: Standalone path searching</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="Standard-options-1"></span><h4 class="subsection">5.6.4 Standard options</h4> @@ -2225,9 +2200,13 @@ successfully. <hr> -<span id="TeX-support"></span><div class="header"> +</div> +</div> +</div> +<div class="chapter" id="TeX-support"> +<div class="header"> <p> -Next: <a href="#Programming" accesskey="n" rel="next">Programming</a>, Previous: <a href="#Path-searching" accesskey="p" rel="prev">Path searching</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="#Programming" accesskey="n" rel="next">Programming</a>, Previous: <a href="#Path-searching" accesskey="p" rel="prev">Path searching</a>, Up: <a href="#Top" accesskey="u" rel="up">Kpathsea library</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="TeX-support-1"></span><h2 class="chapter">6 TeX support</h2> @@ -2251,22 +2230,18 @@ rest. Searches are based solely on names of files, not their contents—if a GF file is (mis)named <samp>cmr10.600pk</samp>, it will be found as a PK file. </p> -<table class="menu" border="0" cellspacing="0"> -<tr><td align="left" valign="top">• <a href="#Supported-file-formats" accesskey="1">Supported file formats</a></td><td> </td><td align="left" valign="top">File types Kpathsea knows about. -</td></tr> -<tr><td align="left" valign="top">• <a href="#File-lookup" accesskey="2">File lookup</a></td><td> </td><td align="left" valign="top">Searching for most kinds of files. -</td></tr> -<tr><td align="left" valign="top">• <a href="#Glyph-lookup" accesskey="3">Glyph lookup</a></td><td> </td><td align="left" valign="top">Searching for bitmap fonts. -</td></tr> -<tr><td align="left" valign="top">• <a href="#Suppressing-warnings" accesskey="4">Suppressing warnings</a></td><td> </td><td align="left" valign="top">Avoiding warnings via TEX_HUSH. -</td></tr> -<tr><td align="left" valign="top">• <a href="#mktex-scripts" accesskey="5">mktex scripts</a></td><td> </td><td align="left" valign="top">Generating files at runtime. -</td></tr> -</table> +<ul class="section-toc"> +<li><a href="#Supported-file-formats" accesskey="1">Supported file formats</a></li> +<li><a href="#File-lookup" accesskey="2">File lookup</a></li> +<li><a href="#Glyph-lookup" accesskey="3">Glyph lookup</a></li> +<li><a href="#Suppressing-warnings" accesskey="4">Suppressing warnings</a></li> +<li><a href="#mktex-scripts" accesskey="5"><samp>mktex</samp> scripts</a></li> +</ul> <hr> -<span id="Supported-file-formats"></span><div class="header"> +<div class="section" id="Supported-file-formats"> +<div class="header"> <p> Next: <a href="#File-lookup" accesskey="n" rel="next">File lookup</a>, Up: <a href="#TeX-support" accesskey="u" rel="up">TeX support</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> </div> @@ -2295,77 +2270,68 @@ list by giving the ‘<samp>--help-formats</samp>’ option to <code>kps (see <a href="#Auxiliary-tasks">Auxiliary tasks</a>). </p> <dl compact="compact"> -<dt>‘<samp>afm</samp>’</dt> -<dd><span id="index-_002eafm"></span> -<span id="index-AFMFONTS"></span> -<p>(Adobe font metrics, see <a href="https://tug.org/texinfohtml/dvips.html#Metric-files">Metric files</a> in <cite>Dvips</cite>) +<dt id='index-_002eafm'><span>‘<samp>afm</samp>’<a href='#index-_002eafm' class='copiable-anchor'> ¶</a></span></dt> +<dd><span id="index-AFMFONTS"></span> +<p>(Adobe font metrics, see <a data-manual="dvips" href="https://tug.org/texinfohtml/dvips.html#Metric-files">Metric files</a> in <cite>Dvips</cite>) <code>AFMFONTS</code>; suffix ‘<samp>.afm</samp>’. </p> </dd> -<dt>‘<samp>base</samp>’</dt> -<dd><span id="index-_002ebase"></span> -<span id="index-MFBASES"></span> +<dt id='index-_002ebase'><span>‘<samp>base</samp>’<a href='#index-_002ebase' class='copiable-anchor'> ¶</a></span></dt> +<dd><span id="index-MFBASES"></span> <span id="index-TEXMFINI"></span> -<p>(Metafont memory dump, see <a href="https://tug.org/texinfohtml/web2c.html#Memory-dumps">Memory dumps</a> in <cite>Web2c</cite>) +<p>(Metafont memory dump, see <a data-manual="web2c" href="https://tug.org/texinfohtml/web2c.html#Memory-dumps">Memory dumps</a> in <cite>Web2c</cite>) <code>MFBASES</code>, <code>TEXMFINI</code>; suffix ‘<samp>.base</samp>’. </p> </dd> -<dt>‘<samp>bib</samp>’</dt> -<dd><span id="index-_002ebib"></span> -<span id="index-BIBINPUTS"></span> +<dt id='index-_002ebib'><span>‘<samp>bib</samp>’<a href='#index-_002ebib' class='copiable-anchor'> ¶</a></span></dt> +<dd><span id="index-BIBINPUTS"></span> <span id="index-TEXBIB"></span> -<p>(BibTeX bibliography source, see <a href="https://tug.org/texinfohtml/web2c.html#bibtex-invocation">bibtex invocation</a> in <cite>Web2c</cite>) +<p>(BibTeX bibliography source, see <a data-manual="web2c" href="https://tug.org/texinfohtml/web2c.html#bibtex-invocation">bibtex invocation</a> in <cite>Web2c</cite>) <code>BIBINPUTS</code>, <code>TEXBIB</code>; suffix ‘<samp>.bib</samp>’. </p> </dd> -<dt>‘<samp>bltxml</samp>’</dt> -<dd><span id="index-_002ebltxml"></span> -<span id="index-BLTXMLINPUTS"></span> +<dt id='index-_002ebltxml'><span>‘<samp>bltxml</samp>’<a href='#index-_002ebltxml' class='copiable-anchor'> ¶</a></span></dt> +<dd><span id="index-BLTXMLINPUTS"></span> <p>(BibLaTeXML bibliography files for Biber, <a href="https://ctan.org/pkg/biber">https://ctan.org/pkg/biber</a>) <code>BLTXMLINPUTS</code> suffix ‘<samp>.bltxml</samp>’. </p> </dd> -<dt>‘<samp>bst</samp>’</dt> -<dd><span id="index-_002ebst"></span> -<span id="index-BSTINPUTS"></span> -<p>(BibTeX style, see <a href="https://tug.org/texinfohtml/web2c.html#Basic-BibTeX-style-files">Basic BibTeX +<dt id='index-_002ebst'><span>‘<samp>bst</samp>’<a href='#index-_002ebst' class='copiable-anchor'> ¶</a></span></dt> +<dd><span id="index-BSTINPUTS"></span> +<p>(BibTeX style, see <a data-manual="web2c" href="https://tug.org/texinfohtml/web2c.html#Basic-BibTeX-style-files">Basic BibTeX style files</a> in <cite>Web2c</cite>) <code>BSTINPUTS</code>; suffix ‘<samp>.bst</samp>’. </p> </dd> -<dt>‘<samp>clua</samp>’</dt> -<dd><span id="index-_002edll"></span> -<span id="index-_002eso"></span> +<dt id='index-_002edll'><span>‘<samp>clua</samp>’<a href='#index-_002edll' class='copiable-anchor'> ¶</a></span></dt> +<dd><span id="index-_002eso"></span> <span id="index-CLUAINPUTS"></span> <p>(dynamic libraries for Lua, <a href="https://ctan.org/pkg/luatex">https://ctan.org/pkg/luatex</a>) <code>CLUAINPUTS</code> suffixes ‘<samp>.dll</samp>’ and ‘<samp>.so</samp>’. </p> </dd> -<dt>‘<samp>cmap</samp>’</dt> -<dd><span id="index-_002ecmap"></span> -<span id="index-CMAPFONTS"></span> +<dt id='index-_002ecmap'><span>‘<samp>cmap</samp>’<a href='#index-_002ecmap' class='copiable-anchor'> ¶</a></span></dt> +<dd><span id="index-CMAPFONTS"></span> <p>(character map files) <code>CMAPFONTS</code>; suffix ‘<samp>.cmap</samp>’. </p> </dd> -<dt>‘<samp>cnf</samp>’</dt> -<dd><span id="index-_002ecnf"></span> -<span id="index-TEXMFCNF-1"></span> +<dt id='index-_002ecnf'><span>‘<samp>cnf</samp>’<a href='#index-_002ecnf' class='copiable-anchor'> ¶</a></span></dt> +<dd><span id="index-TEXMFCNF-1"></span> <p>(Runtime configuration files, see <a href="#Config-files">Config files</a>) <code>TEXMFCNF</code>; suffix ‘<samp>.cnf</samp>’. </p> </dd> -<dt>‘<samp>cweb</samp>’</dt> -<dd><span id="index-_002ew"></span> -<span id="index-_002eweb"></span> +<dt id='index-_002ew'><span>‘<samp>cweb</samp>’<a href='#index-_002ew' class='copiable-anchor'> ¶</a></span></dt> +<dd><span id="index-_002eweb"></span> <span id="index-CWEBINPUTS"></span> <p>(CWEB input files) <code>CWEBINPUTS</code>; @@ -2373,148 +2339,130 @@ suffixes ‘<samp>.w</samp>’, ‘<samp>.web</samp>’; additional suffix ‘<samp>.ch</samp>’. </p> </dd> -<dt>‘<samp>dvips config</samp>’</dt> -<dd><span id="index-TEXCONFIG"></span> -<span id="index-config_002eps_002c-search-path-for"></span> -<p>(Dvips ‘<samp>config.*</samp>’ files, such as <samp>config.ps</samp>, see <a href="https://tug.org/texinfohtml/dvips.html#Config-files">Config +<dt id='index-TEXCONFIG'><span>‘<samp>dvips config</samp>’<a href='#index-TEXCONFIG' class='copiable-anchor'> ¶</a></span></dt> +<dd><span id="index-config_002eps_002c-search-path-for"></span> +<p>(Dvips ‘<samp>config.*</samp>’ files, such as <samp>config.ps</samp>, see <a data-manual="dvips" href="https://tug.org/texinfohtml/dvips.html#Config-files">Config files</a> in <cite>Dvips</cite>) <code>TEXCONFIG</code>. </p> </dd> -<dt>‘<samp>enc files</samp>’</dt> -<dd><span id="index-_002eenc"></span> -<span id="index-ENCFONTS"></span> +<dt id='index-_002eenc'><span>‘<samp>enc files</samp>’<a href='#index-_002eenc' class='copiable-anchor'> ¶</a></span></dt> +<dd><span id="index-ENCFONTS"></span> <p>(encoding vectors) <code>ENCFONTS</code>; suffix ‘<samp>.enc</samp>’. </p> </dd> -<dt>‘<samp>fmt</samp>’</dt> -<dd><span id="index-_002efmt"></span> -<span id="index-TEXFORMATS"></span> +<dt id='index-_002efmt'><span>‘<samp>fmt</samp>’<a href='#index-_002efmt' class='copiable-anchor'> ¶</a></span></dt> +<dd><span id="index-TEXFORMATS"></span> <span id="index-TEXMFINI-1"></span> -<p>(TeX memory dump, see <a href="https://tug.org/texinfohtml/web2c.html#Memory-dumps">Memory dumps</a> in <cite>Web2c</cite>) +<p>(TeX memory dump, see <a data-manual="web2c" href="https://tug.org/texinfohtml/web2c.html#Memory-dumps">Memory dumps</a> in <cite>Web2c</cite>) <code>TEXFORMATS</code>, <code>TEXMFINI</code>; suffix ‘<samp>.fmt</samp>’. </p> </dd> -<dt>‘<samp>font cid map</samp>’</dt> -<dd><span id="index-_002ecid"></span> -<span id="index-FONTCIDMAPS"></span> +<dt id='index-_002ecid'><span>‘<samp>font cid map</samp>’<a href='#index-_002ecid' class='copiable-anchor'> ¶</a></span></dt> +<dd><span id="index-FONTCIDMAPS"></span> <p>(CJK mapping) <code>FONTCIDMAPS</code> suffix ‘<samp>.cid</samp>’. </p> </dd> -<dt>‘<samp>font feature files</samp>’</dt> -<dd><span id="index-_002efea"></span> -<span id="index-FONTFEATURES"></span> +<dt id='index-_002efea'><span>‘<samp>font feature files</samp>’<a href='#index-_002efea' class='copiable-anchor'> ¶</a></span></dt> +<dd><span id="index-FONTFEATURES"></span> <p>(primarily for OpenType font features) <code>FONTFEATURES</code> suffix ‘<samp>.fea</samp>’. </p> </dd> -<dt>‘<samp>gf</samp>’</dt> -<dd><span id="index-gf"></span> -<span id="index-GFFONTS"></span> +<dt id='index-gf'><span>‘<samp>gf</samp>’<a href='#index-gf' class='copiable-anchor'> ¶</a></span></dt> +<dd><span id="index-GFFONTS"></span> <span id="index-GLYPHFONTS"></span> <span id="index-TEXFONTS"></span> -<p>(generic font bitmap, see <a href="https://tug.org/texinfohtml/dvips.html#Glyph-files">Glyph files</a> in <cite>Dvips</cite>) +<p>(generic font bitmap, see <a data-manual="dvips" href="https://tug.org/texinfohtml/dvips.html#Glyph-files">Glyph files</a> in <cite>Dvips</cite>) <code><var>program</var>FONTS</code>, <code>GFFONTS</code>, <code>GLYPHFONTS</code>, <code>TEXFONTS</code>; suffix ‘<samp>gf</samp>’. </p> </dd> -<dt>‘<samp>graphic/figure</samp>’</dt> -<dd><span id="index-_002eeps"></span> -<span id="index-_002eepsi"></span> +<dt id='index-_002eeps'><span>‘<samp>graphic/figure</samp>’<a href='#index-_002eeps' class='copiable-anchor'> ¶</a></span></dt> +<dd><span id="index-_002eepsi"></span> <span id="index-TEXPICTS"></span> <span id="index-TEXINPUTS"></span> -<p>(Encapsulated PostScript figures, see <a href="https://tug.org/texinfohtml/dvips.html#PostScript-figures">PostScript figures</a> in <cite>Dvips</cite>) +<p>(Encapsulated PostScript figures, see <a data-manual="dvips" href="https://tug.org/texinfohtml/dvips.html#PostScript-figures">PostScript figures</a> in <cite>Dvips</cite>) <code>TEXPICTS</code>, <code>TEXINPUTS</code>; additional suffixes: ‘<samp>.eps</samp>’, ‘<samp>.epsi</samp>’. </p> </dd> -<dt>‘<samp>ist</samp>’</dt> -<dd><span id="index-_002eist"></span> -<span id="index-TEXINDEXSTYLE"></span> +<dt id='index-_002eist'><span>‘<samp>ist</samp>’<a href='#index-_002eist' class='copiable-anchor'> ¶</a></span></dt> +<dd><span id="index-TEXINDEXSTYLE"></span> <span id="index-INDEXSTYLE"></span> <p>(makeindex style files) <code>TEXINDEXSTYLE</code>, <code>INDEXSTYLE</code>; suffix ‘<samp>.ist</samp>’. </p> </dd> -<dt>‘<samp>lig files</samp>’</dt> -<dd><span id="index-_002elig"></span> -<span id="index-LIGFONTS"></span> +<dt id='index-_002elig'><span>‘<samp>lig files</samp>’<a href='#index-_002elig' class='copiable-anchor'> ¶</a></span></dt> +<dd><span id="index-LIGFONTS"></span> <p>(ligature definition files) <code>LIGFONTS</code>; suffix ‘<samp>.lig</samp>’. </p> </dd> -<dt>‘<samp>ls-R</samp>’</dt> -<dd><span id="index-ls_002dR"></span> -<span id="index-TEXMFDBS-1"></span> -<p>(Filename databases, see <a href="#Filename-database">Filename database</a>) +<dt id='index-ls_002dR'><span>‘<samp>ls-R</samp>’<a href='#index-ls_002dR' class='copiable-anchor'> ¶</a></span></dt> +<dd><span id="index-TEXMFDBS-1"></span> +<p>(Filename databases, see <a href="#Filename-database">Filename database (<code>ls-R</code>)</a>) <code>TEXMFDBS</code>. </p> </dd> -<dt>‘<samp>map</samp>’</dt> -<dd><span id="index-_002emap"></span> -<span id="index-TEXFONTMAPS"></span> +<dt id='index-_002emap'><span>‘<samp>map</samp>’<a href='#index-_002emap' class='copiable-anchor'> ¶</a></span></dt> +<dd><span id="index-TEXFONTMAPS"></span> <p>(Fontmaps, see <a href="#Fontmap">Fontmap</a>) <code>TEXFONTMAPS</code>; suffix ‘<samp>.map</samp>’. </p> </dd> -<dt>‘<samp>mem</samp>’</dt> -<dd><span id="index-_002emem"></span> -<span id="index-MPMEMS"></span> +<dt id='index-_002emem'><span>‘<samp>mem</samp>’<a href='#index-_002emem' class='copiable-anchor'> ¶</a></span></dt> +<dd><span id="index-MPMEMS"></span> <span id="index-TEXMFINI-2"></span> -<p>(MetaPost memory dump, see <a href="https://tug.org/texinfohtml/web2c.html#Memory-dumps">Memory dumps</a> in <cite>Web2c</cite>) +<p>(MetaPost memory dump, see <a data-manual="web2c" href="https://tug.org/texinfohtml/web2c.html#Memory-dumps">Memory dumps</a> in <cite>Web2c</cite>) <code>MPMEMS</code>, <code>TEXMFINI</code>; suffix ‘<samp>.mem</samp>’. </p> </dd> -<dt>‘<samp><span class="roman">MetaPost support</span></samp>’</dt> -<dd><span id="index-MPSUPPORT"></span> -<p>(MetaPost support files, used by DMP; see <a href="https://tug.org/texinfohtml/web2c.html#dmp-invocation">dmp invocation</a> in <cite>Web2c</cite>) +<dt id='index-MPSUPPORT'><span>‘<samp><span class="roman">MetaPost support</span></samp>’<a href='#index-MPSUPPORT' class='copiable-anchor'> ¶</a></span></dt> +<dd><p>(MetaPost support files, used by DMP; see <a data-manual="web2c" href="https://tug.org/texinfohtml/web2c.html#dmp-invocation">dmp invocation</a> in <cite>Web2c</cite>) <code>MPSUPPORT</code>. </p> </dd> -<dt>‘<samp>mf</samp>’</dt> -<dd><span id="index-_002emf"></span> -<span id="index-MFINPUTS"></span> -<p>(Metafont source, see <a href="https://tug.org/texinfohtml/web2c.html#mf-invocation">mf invocation</a> in <cite>Web2c</cite>) +<dt id='index-_002emf'><span>‘<samp>mf</samp>’<a href='#index-_002emf' class='copiable-anchor'> ¶</a></span></dt> +<dd><span id="index-MFINPUTS"></span> +<p>(Metafont source, see <a data-manual="web2c" href="https://tug.org/texinfohtml/web2c.html#mf-invocation">mf invocation</a> in <cite>Web2c</cite>) <code>MFINPUTS</code>; suffix ‘<samp>.mf</samp>’; dynamic creation program: <code>mktexmf</code>. </p> </dd> -<dt>‘<samp>mfpool</samp>’</dt> -<dd><span id="index-_002epool"></span> -<span id="index-MFPOOL"></span> -<p>(Metafont program strings, see <a href="https://tug.org/texinfohtml/web2c.html#pooltype-invocation">pooltype invocation</a> in <cite>Web2c</cite>) +<dt id='index-_002epool'><span>‘<samp>mfpool</samp>’<a href='#index-_002epool' class='copiable-anchor'> ¶</a></span></dt> +<dd><span id="index-MFPOOL"></span> +<p>(Metafont program strings, see <a data-manual="web2c" href="https://tug.org/texinfohtml/web2c.html#pooltype-invocation">pooltype invocation</a> in <cite>Web2c</cite>) <code>MFPOOL</code>, <code>TEXMFINI</code>; suffix ‘<samp>.pool</samp>’. </p> </dd> -<dt>‘<samp>mft</samp>’</dt> -<dd><span id="index-_002emft"></span> -<span id="index-MFTINPUTS"></span> -<p>(<code>MFT</code> style file, see <a href="https://tug.org/texinfohtml/web2c.html#mft-invocation">mft invocation</a> in <cite>Web2c</cite>) +<dt id='index-_002emft'><span>‘<samp>mft</samp>’<a href='#index-_002emft' class='copiable-anchor'> ¶</a></span></dt> +<dd><span id="index-MFTINPUTS"></span> +<p>(<code>MFT</code> style file, see <a data-manual="web2c" href="https://tug.org/texinfohtml/web2c.html#mft-invocation">mft invocation</a> in <cite>Web2c</cite>) <code>MFTINPUTS</code>; suffix ‘<samp>.mft</samp>’. </p> </dd> -<dt>‘<samp>misc fonts</samp>’</dt> -<dd><span id="index-MISCFONTS"></span> -<p>(font-related files that don’t fit the other categories) +<dt id='index-MISCFONTS'><span>‘<samp>misc fonts</samp>’<a href='#index-MISCFONTS' class='copiable-anchor'> ¶</a></span></dt> +<dd><p>(font-related files that don’t fit the other categories) <code>MISCFONTS</code> </p> </dd> -<dt>‘<samp>mlbib</samp>’</dt> -<dd><span id="index-_002emlbib"></span> -<span id="index-MLBIBINPUTS"></span> +<dt id='index-_002emlbib'><span>‘<samp>mlbib</samp>’<a href='#index-_002emlbib' class='copiable-anchor'> ¶</a></span></dt> +<dd><span id="index-MLBIBINPUTS"></span> <span id="index-BIBINPUTS-1"></span> <span id="index-TEXBIB-1"></span> <p>(MlBibTeX bibliography source) @@ -2522,230 +2470,202 @@ suffix ‘<samp>.mft</samp>’. suffixes ‘<samp>.mlbib</samp>’, ‘<samp>.mlbib</samp>’. </p> </dd> -<dt>‘<samp>mlbst</samp>’</dt> -<dd><span id="index-_002emlbst"></span> -<span id="index-MLBSTINPUTS"></span> +<dt id='index-_002emlbst'><span>‘<samp>mlbst</samp>’<a href='#index-_002emlbst' class='copiable-anchor'> ¶</a></span></dt> +<dd><span id="index-MLBSTINPUTS"></span> <span id="index-BSTINPUTS-1"></span> <p>(MlBibTeX style) <code>MLBSTINPUTS</code>, <code>BSTINPUTS</code>; suffixes ‘<samp>.mlbst</samp>’, ‘<samp>.bst</samp>’. </p> </dd> -<dt>‘<samp>mp</samp>’</dt> -<dd><span id="index-_002emp"></span> -<span id="index-MPINPUTS"></span> -<p>(MetaPost source, see <a href="https://tug.org/texinfohtml/web2c.html#mpost-invocation">mpost invocation</a> in <cite>Web2c</cite>) +<dt id='index-_002emp'><span>‘<samp>mp</samp>’<a href='#index-_002emp' class='copiable-anchor'> ¶</a></span></dt> +<dd><span id="index-MPINPUTS"></span> +<p>(MetaPost source, see <a data-manual="web2c" href="https://tug.org/texinfohtml/web2c.html#mpost-invocation">mpost invocation</a> in <cite>Web2c</cite>) <code>MPINPUTS</code>; suffix ‘<samp>.mp</samp>’. </p> </dd> -<dt>‘<samp>mppool</samp>’</dt> -<dd><span id="index-_002epool-1"></span> -<span id="index-MPPOOL"></span> -<p>(MetaPost program strings, see <a href="https://tug.org/texinfohtml/web2c.html#pooltype-invocation">pooltype invocation</a> in <cite>Web2c</cite>) +<dt id='index-_002epool-1'><span>‘<samp>mppool</samp>’<a href='#index-_002epool-1' class='copiable-anchor'> ¶</a></span></dt> +<dd><span id="index-MPPOOL"></span> +<p>(MetaPost program strings, see <a data-manual="web2c" href="https://tug.org/texinfohtml/web2c.html#pooltype-invocation">pooltype invocation</a> in <cite>Web2c</cite>) <code>MPPOOL</code>, <code>TEXMFINI</code>; suffix ‘<samp>.pool</samp>’. </p> </dd> -<dt>‘<samp>ocp</samp>’</dt> -<dd><span id="index-_002eocp"></span> -<span id="index-OCPINPUTS"></span> +<dt id='index-_002eocp'><span>‘<samp>ocp</samp>’<a href='#index-_002eocp' class='copiable-anchor'> ¶</a></span></dt> +<dd><span id="index-OCPINPUTS"></span> <p>(Omega compiled process files) <code>OCPINPUTS</code>; <br> suffix ‘<samp>.ocp</samp>’; dynamic creation program: <code>MakeOmegaOCP</code>. </p> </dd> -<dt>‘<samp>ofm</samp>’</dt> -<dd><span id="index-_002eofm"></span> -<span id="index-OFMFONTS"></span> +<dt id='index-_002eofm'><span>‘<samp>ofm</samp>’<a href='#index-_002eofm' class='copiable-anchor'> ¶</a></span></dt> +<dd><span id="index-OFMFONTS"></span> <p>(Omega font metrics) <code>OFMFONTS</code>, <code>TEXFONTS</code>; <br> suffixes ‘<samp>.ofm</samp>’, ‘<samp>.tfm</samp>’; dynamic creation program: <code>MakeOmegaOFM</code>. </p> </dd> -<dt>‘<samp>opentype fonts</samp>’</dt> -<dd><span id="index-OPENTYPEFONTS"></span> -<p>(OpenType fonts) +<dt id='index-OPENTYPEFONTS'><span>‘<samp>opentype fonts</samp>’<a href='#index-OPENTYPEFONTS' class='copiable-anchor'> ¶</a></span></dt> +<dd><p>(OpenType fonts) <code>OPENTYPEFONTS</code>. </p> </dd> -<dt>‘<samp>opl</samp>’</dt> -<dd><span id="index-_002eopl"></span> -<p>(Omega property lists) +<dt id='index-_002eopl'><span>‘<samp>opl</samp>’<a href='#index-_002eopl' class='copiable-anchor'> ¶</a></span></dt> +<dd><p>(Omega property lists) <code>OPLFONTS</code>, <code>TEXFONTS</code>; suffix ‘<samp>.opl</samp>’. </p> </dd> -<dt>‘<samp>otp</samp>’</dt> -<dd><span id="index-_002eotp"></span> -<span id="index-OTPINPUTS"></span> +<dt id='index-_002eotp'><span>‘<samp>otp</samp>’<a href='#index-_002eotp' class='copiable-anchor'> ¶</a></span></dt> +<dd><span id="index-OTPINPUTS"></span> <p>(Omega translation process files) <code>OTPINPUTS</code>; suffix ‘<samp>.otp</samp>’. </p> </dd> -<dt>‘<samp>ovf</samp>’</dt> -<dd><span id="index-_002eovf"></span> -<span id="index-OVFFONTS"></span> +<dt id='index-_002eovf'><span>‘<samp>ovf</samp>’<a href='#index-_002eovf' class='copiable-anchor'> ¶</a></span></dt> +<dd><span id="index-OVFFONTS"></span> <p>(Omega virtual fonts) <code>OVFFONTS</code>, <code>TEXFONTS</code>; suffix ‘<samp>.ovf</samp>’. </p> </dd> -<dt>‘<samp>ovp</samp>’</dt> -<dd><span id="index-_002eovp"></span> -<span id="index-OVPFONTS"></span> +<dt id='index-_002eovp'><span>‘<samp>ovp</samp>’<a href='#index-_002eovp' class='copiable-anchor'> ¶</a></span></dt> +<dd><span id="index-OVPFONTS"></span> <p>(Omega virtual property lists) <code>OVPFONTS</code>, <code>TEXFONTS</code>; suffix ‘<samp>.ovp</samp>’. </p> </dd> -<dt>‘<samp>pdftex config</samp>’</dt> -<dd><span id="index-PDFTEXCONFIG"></span> -<p>(PDFTeX-specific configuration files) +<dt id='index-PDFTEXCONFIG'><span>‘<samp>pdftex config</samp>’<a href='#index-PDFTEXCONFIG' class='copiable-anchor'> ¶</a></span></dt> +<dd><p>(PDFTeX-specific configuration files) <code>PDFTEXCONFIG</code>. </p> </dd> -<dt>‘<samp>pk</samp>’</dt> -<dd><span id="index-_002epk"></span> -<span id="index-PKFONTS"></span> +<dt id='index-_002epk'><span>‘<samp>pk</samp>’<a href='#index-_002epk' class='copiable-anchor'> ¶</a></span></dt> +<dd><span id="index-PKFONTS"></span> <span id="index-TEXPKS"></span> <span id="index-GLYPHFONTS-1"></span> <span id="index-TEXFONTS-1"></span> -<p>(packed bitmap fonts, see <a href="https://tug.org/texinfohtml/dvips.html#Glyph-files">Glyph files</a> in <cite>Dvips</cite>) +<p>(packed bitmap fonts, see <a data-manual="dvips" href="https://tug.org/texinfohtml/dvips.html#Glyph-files">Glyph files</a> in <cite>Dvips</cite>) <code><var>PROGRAM</var>FONTS</code> (<var>program</var> being ‘<samp>XDVI</samp>’, etc.), <code>PKFONTS</code>, <code>TEXPKS</code>, <code>GLYPHFONTS</code>, <code>TEXFONTS</code>; suffix ‘<samp>pk</samp>’; dynamic creation program: <code>mktexpk</code>. </p> </dd> -<dt>‘<samp>PostScript header</samp>’</dt> -<dd><span id="index-_002epro"></span> -<span id="index-TEXPSHEADERS"></span> +<dt id='index-_002epro'><span>‘<samp>PostScript header</samp>’<a href='#index-_002epro' class='copiable-anchor'> ¶</a></span></dt> +<dd><span id="index-TEXPSHEADERS"></span> <span id="index-PSHEADERS"></span> -<p>(downloadable PostScript, see <a href="https://tug.org/texinfohtml/dvips.html#Header-files">Header files</a> in <cite>Dvips</cite>) +<p>(downloadable PostScript, see <a data-manual="dvips" href="https://tug.org/texinfohtml/dvips.html#Header-files">Header files</a> in <cite>Dvips</cite>) <code>TEXPSHEADERS</code>, <code>PSHEADERS</code>; additional suffix ‘<samp>.pro</samp>’. </p> </dd> -<dt>‘<samp>ris</samp>’</dt> -<dd><span id="index-_002eris"></span> -<span id="index-RISINPUTS"></span> +<dt id='index-_002eris'><span>‘<samp>ris</samp>’<a href='#index-_002eris' class='copiable-anchor'> ¶</a></span></dt> +<dd><span id="index-RISINPUTS"></span> <p>(RIS bibliography files, primarily for Biber, <a href="https://ctan.org/pkg/biber">https://ctan.org/pkg/biber</a>) <code>RISINPUTS</code> suffix ‘<samp>.ris</samp>’. </p> </dd> -<dt>‘<samp>subfont definition files</samp>’</dt> -<dd><span id="index-_002esfd"></span> -<span id="index-SFDFONTS"></span> +<dt id='index-_002esfd'><span>‘<samp>subfont definition files</samp>’<a href='#index-_002esfd' class='copiable-anchor'> ¶</a></span></dt> +<dd><span id="index-SFDFONTS"></span> <p>(subfont definition files) <code>SFDFONTS</code> suffix ‘<samp>.sfd</samp>’. </p> </dd> -<dt>‘<samp>tex</samp>’</dt> -<dd><span id="index-_002etex"></span> -<span id="index-TEXINPUTS-1"></span> -<p>(TeX source, see <a href="https://tug.org/texinfohtml/web2c.html#tex-invocation">tex invocation</a> in <cite>Web2c</cite>) +<dt id='index-_002etex'><span>‘<samp>tex</samp>’<a href='#index-_002etex' class='copiable-anchor'> ¶</a></span></dt> +<dd><span id="index-TEXINPUTS-1"></span> +<p>(TeX source, see <a data-manual="web2c" href="https://tug.org/texinfohtml/web2c.html#tex-invocation">tex invocation</a> in <cite>Web2c</cite>) <code>TEXINPUTS</code>; suffix ‘<samp>.tex</samp>’; additional suffixes: none, because such a list cannot be complete; dynamic creation program: <code>mktextex</code>. </p> </dd> -<dt>‘<samp>TeX system documentation</samp>’</dt> -<dd><span id="index-doc-files"></span> -<span id="index-TEXDOCS"></span> +<dt id='index-doc-files'><span>‘<samp>TeX system documentation</samp>’<a href='#index-doc-files' class='copiable-anchor'> ¶</a></span></dt> +<dd><span id="index-TEXDOCS"></span> <p>(Documentation files for the TeX system) <code>TEXDOCS</code>. </p> </dd> -<dt>‘<samp>TeX system sources</samp>’</dt> -<dd><span id="index-source-files"></span> -<span id="index-TEXSOURCES"></span> +<dt id='index-source-files'><span>‘<samp>TeX system sources</samp>’<a href='#index-source-files' class='copiable-anchor'> ¶</a></span></dt> +<dd><span id="index-TEXSOURCES"></span> <p>(Source files for the TeX system) <code>TEXSOURCES</code>. </p> </dd> -<dt>‘<samp>texmfscripts</samp>’</dt> -<dd><span id="index-TEXMFSCRIPTS"></span> -<p>(Architecture-independent executables distributed in the texmf trees) +<dt id='index-TEXMFSCRIPTS'><span>‘<samp>texmfscripts</samp>’<a href='#index-TEXMFSCRIPTS' class='copiable-anchor'> ¶</a></span></dt> +<dd><p>(Architecture-independent executables distributed in the texmf trees) <code>TEXMFSCRIPTS</code>. </p> </dd> -<dt>‘<samp>texpool</samp>’</dt> -<dd><span id="index-_002epool-2"></span> -<span id="index-TEXPOOL"></span> -<p>(TeX program strings, see <a href="https://tug.org/texinfohtml/web2c.html#pooltype-invocation">pooltype invocation</a> in <cite>Web2c</cite>) +<dt id='index-_002epool-2'><span>‘<samp>texpool</samp>’<a href='#index-_002epool-2' class='copiable-anchor'> ¶</a></span></dt> +<dd><span id="index-TEXPOOL"></span> +<p>(TeX program strings, see <a data-manual="web2c" href="https://tug.org/texinfohtml/web2c.html#pooltype-invocation">pooltype invocation</a> in <cite>Web2c</cite>) <code>TEXPOOL</code>, <code>TEXMFINI</code>; suffix ‘<samp>.pool</samp>’. </p> </dd> -<dt>‘<samp>tfm</samp>’</dt> -<dd><span id="index-_002etfm"></span> -<span id="index-TFMFONTS"></span> +<dt id='index-_002etfm'><span>‘<samp>tfm</samp>’<a href='#index-_002etfm' class='copiable-anchor'> ¶</a></span></dt> +<dd><span id="index-TFMFONTS"></span> <span id="index-TEXFONTS-2"></span> -<p>(TeX font metrics, see <a href="https://tug.org/texinfohtml/dvips.html#Metric-files">Metric files</a> in <cite>Dvips</cite>) +<p>(TeX font metrics, see <a data-manual="dvips" href="https://tug.org/texinfohtml/dvips.html#Metric-files">Metric files</a> in <cite>Dvips</cite>) <code>TFMFONTS</code>, <code>TEXFONTS</code>; suffix ‘<samp>.tfm</samp>’; dynamic creation program: <code>mktextfm</code>. </p> </dd> -<dt>‘<samp>Troff fonts</samp>’</dt> -<dd><span id="index-TRFONTS"></span> -<p>(Troff fonts, used by DMP; see <a href="https://tug.org/texinfohtml/web2c.html#DMP-invocation">DMP invocation</a> in <cite>Web2c</cite>) +<dt id='index-TRFONTS'><span>‘<samp>Troff fonts</samp>’<a href='#index-TRFONTS' class='copiable-anchor'> ¶</a></span></dt> +<dd><p>(Troff fonts, used by DMP; see <a data-manual="web2c" href="https://tug.org/texinfohtml/web2c.html#DMP-invocation">DMP invocation</a> in <cite>Web2c</cite>) <code>TRFONTS</code>. </p> </dd> -<dt>‘<samp>truetype fonts</samp>’</dt> -<dd><span id="index-_002ettf"></span> -<span id="index-_002ettc"></span> +<dt id='index-_002ettf'><span>‘<samp>truetype fonts</samp>’<a href='#index-_002ettf' class='copiable-anchor'> ¶</a></span></dt> +<dd><span id="index-_002ettc"></span> <span id="index-TTFONTS"></span> <p>(TrueType outline fonts) <code>TTFONTS</code>; suffixes ‘<samp>.ttf</samp>’ and ‘<samp>.TTF</samp>’, ‘<samp>.ttc</samp>’ and ‘<samp>.TTC</samp>’, ‘<samp>.dfont</samp>’. </p> </dd> -<dt>‘<samp>type1 fonts</samp>’</dt> -<dd><span id="index-_002epfa"></span> -<span id="index-_002epfb"></span> +<dt id='index-_002epfa'><span>‘<samp>type1 fonts</samp>’<a href='#index-_002epfa' class='copiable-anchor'> ¶</a></span></dt> +<dd><span id="index-_002epfb"></span> <span id="index-T1FONTS"></span> <span id="index-T1INPUTS"></span> <span id="index-TEXPSHEADERS-1"></span> <span id="index-DVIPSHEADERS"></span> -<p>(Type 1 PostScript outline fonts, see <a href="https://tug.org/texinfohtml/dvips.html#Glyph-files">Glyph files</a> in <cite>Dvips</cite>) +<p>(Type 1 PostScript outline fonts, see <a data-manual="dvips" href="https://tug.org/texinfohtml/dvips.html#Glyph-files">Glyph files</a> in <cite>Dvips</cite>) <code>T1FONTS</code>, <code>T1INPUTS</code>, <code>TEXPSHEADERS</code>, <code>DVIPSHEADERS</code>; suffixes ‘<samp>.pfa</samp>’, ‘<samp>.pfb</samp>’. </p> </dd> -<dt>‘<samp>type42 fonts</samp>’</dt> -<dd><span id="index-T42FONTS"></span> -<p>(Type 42 PostScript outline fonts) <code>T42FONTS</code>. +<dt id='index-T42FONTS'><span>‘<samp>type42 fonts</samp>’<a href='#index-T42FONTS' class='copiable-anchor'> ¶</a></span></dt> +<dd><p>(Type 42 PostScript outline fonts) <code>T42FONTS</code>. </p> </dd> -<dt>‘<samp>vf</samp>’</dt> -<dd><span id="index-_002evf"></span> -<span id="index-VFFONTS"></span> +<dt id='index-_002evf'><span>‘<samp>vf</samp>’<a href='#index-_002evf' class='copiable-anchor'> ¶</a></span></dt> +<dd><span id="index-VFFONTS"></span> <span id="index-TEXFONTS-3"></span> -<p>(virtual fonts, see <a href="https://tug.org/texinfohtml/dvips.html#Virtual-fonts">Virtual fonts</a> in <cite>Dvips</cite>) +<p>(virtual fonts, see <a data-manual="dvips" href="https://tug.org/texinfohtml/dvips.html#Virtual-fonts">Virtual fonts</a> in <cite>Dvips</cite>) <code>VFFONTS</code>, <code>TEXFONTS</code>; suffix ‘<samp>.vf</samp>’. </p> </dd> -<dt>‘<samp>web</samp>’</dt> -<dd><span id="index-_002eweb-1"></span> -<span id="index-WEBINPUTS"></span> +<dt id='index-_002eweb-1'><span>‘<samp>web</samp>’<a href='#index-_002eweb-1' class='copiable-anchor'> ¶</a></span></dt> +<dd><span id="index-WEBINPUTS"></span> <p>(WEB input files) <code>WEBINPUTS</code>; suffix ‘<samp>.web</samp>’; additional suffix ‘<samp>.ch</samp>’. </p> </dd> -<dt>‘<samp>web2c files</samp>’</dt> -<dd><span id="index-WEB2C"></span> -<p>(files specific to the web2c implementation) +<dt id='index-WEB2C'><span>‘<samp>web2c files</samp>’<a href='#index-WEB2C' class='copiable-anchor'> ¶</a></span></dt> +<dd><p>(files specific to the web2c implementation) <code>WEB2C</code>. </p></dd> </dl> @@ -2757,15 +2677,13 @@ appending ‘<samp>INPUTS</samp>’. Assuming the program is called &ls this gives us the following table. </p> <dl compact="compact"> -<dt>‘<samp>other text files</samp>’</dt> -<dd><span id="index-FOOINPUTS"></span> -<p>(text files used by ‘<samp>foo</samp>’) +<dt id='index-FOOINPUTS'><span>‘<samp>other text files</samp>’<a href='#index-FOOINPUTS' class='copiable-anchor'> ¶</a></span></dt> +<dd><p>(text files used by ‘<samp>foo</samp>’) <code>FOOINPUTS</code>. </p> </dd> -<dt>‘<samp>other binary files</samp>’</dt> -<dd><span id="index-FOOINPUTS-1"></span> -<p>(binary files used by ‘<samp>foo</samp>’) +<dt id='index-FOOINPUTS-1'><span>‘<samp>other binary files</samp>’<a href='#index-FOOINPUTS-1' class='copiable-anchor'> ¶</a></span></dt> +<dd><p>(binary files used by ‘<samp>foo</samp>’) <code>FOOINPUTS</code>. </p></dd> </dl> @@ -2792,7 +2710,9 @@ Each program has its own font override path as well; e.g., <hr> -<span id="File-lookup"></span><div class="header"> +</div> +<div class="section" id="File-lookup"> +<div class="header"> <p> Next: <a href="#Glyph-lookup" accesskey="n" rel="next">Glyph lookup</a>, Previous: <a href="#Supported-file-formats" accesskey="p" rel="prev">Supported file formats</a>, Up: <a href="#TeX-support" accesskey="u" rel="up">TeX support</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> </div> @@ -2819,7 +2739,7 @@ the fontmaps. Example: given ‘<samp>foo.bar</samp>’, we also look f ‘<samp>foo.bar</samp>’. </li><li> If the file format defines a program to invoke to create missing files, -run it (see <a href="#mktex-scripts">mktex scripts</a>). +run it (see <a href="#mktex-scripts"><samp>mktex</samp> scripts</a>). </li></ol> <span id="index-extensions_002c-filename"></span> @@ -2848,7 +2768,9 @@ debugging options (see <a href="#Debugging">Debugging</a>). </p> <hr> -<span id="Glyph-lookup"></span><div class="header"> +</div> +<div class="section" id="Glyph-lookup"> +<div class="header"> <p> Next: <a href="#Suppressing-warnings" accesskey="n" rel="next">Suppressing warnings</a>, Previous: <a href="#File-lookup" accesskey="p" rel="prev">File lookup</a>, Up: <a href="#TeX-support" accesskey="u" rel="up">TeX support</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> </div> @@ -2874,7 +2796,7 @@ specified format(s). file <samp>texfonts.map</samp>, look for <var>f</var>.<var>dpi</var>. </li><li> Run an external program (typically named ‘<samp>mktexpk</samp>’) to -generate the font (see <a href="#mktex-scripts">mktex scripts</a>) +generate the font (see <a href="#mktex-scripts"><samp>mktex</samp> scripts</a>) </li><li> Look for <var>fallback</var>.<var>dpi</var>, where <var>fallback</var> is some last-resort font (typically ‘<samp>cmr10</samp>’). @@ -2885,18 +2807,16 @@ last-resort font (typically ‘<samp>cmr10</samp>’). <p>This is implemented in <code>kpathsea_find_glyph</code> in <samp>kpathsea/tex-glyph.c</samp>. </p> -<table class="menu" border="0" cellspacing="0"> -<tr><td align="left" valign="top">• <a href="#Basic-glyph-lookup" accesskey="1">Basic glyph lookup</a></td><td> </td><td align="left" valign="top">Features common to all glyph lookups. -</td></tr> -<tr><td align="left" valign="top">• <a href="#Fontmap" accesskey="2">Fontmap</a></td><td> </td><td align="left" valign="top">Aliases for fonts. -</td></tr> -<tr><td align="left" valign="top">• <a href="#Fallback-font" accesskey="3">Fallback font</a></td><td> </td><td align="left" valign="top">Resolutions and fonts of last resort. -</td></tr> -</table> +<ul class="section-toc"> +<li><a href="#Basic-glyph-lookup" accesskey="1">Basic glyph lookup</a></li> +<li><a href="#Fontmap" accesskey="2">Fontmap</a></li> +<li><a href="#Fallback-font" accesskey="3">Fallback font</a></li> +</ul> <hr> -<span id="Basic-glyph-lookup"></span><div class="header"> +<div class="subsection" id="Basic-glyph-lookup"> +<div class="header"> <p> Next: <a href="#Fontmap" accesskey="n" rel="next">Fontmap</a>, Up: <a href="#Glyph-lookup" accesskey="u" rel="up">Glyph lookup</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> </div> @@ -2926,7 +2846,9 @@ slightly more than the 0.2% minimum allowed by the DVI standard </p> <hr> -<span id="Fontmap"></span><div class="header"> +</div> +<div class="subsection" id="Fontmap"> +<div class="header"> <p> Next: <a href="#Fallback-font" accesskey="n" rel="next">Fallback font</a>, Previous: <a href="#Basic-glyph-lookup" accesskey="p" rel="prev">Basic glyph lookup</a>, Up: <a href="#Glyph-lookup" accesskey="u" rel="up">Glyph lookup</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> </div> @@ -2962,7 +2884,7 @@ file is; TeX documents will find their favorite name. </li></ol> -<p>The format of fontmap files is straightforward: +<p>The format of fontmap files: </p> <ul> <li> <span id="index-comments_002c-in-fontmap-files"></span> @@ -3009,11 +2931,13 @@ lcirc10 lcircle10 <p>Fontmaps are implemented in the file <samp>kpathsea/fontmap.c</samp>. The Fontname distribution has much more information on font naming -(see <cite><a href="fontname.html#Top">Filenames for TeX fonts</a></cite>). +(see <cite><a data-manual="fontname" href="fontname.html#Top">Filenames for TeX fonts</a></cite>). </p> <hr> -<span id="Fallback-font"></span><div class="header"> +</div> +<div class="subsection" id="Fallback-font"> +<div class="header"> <p> Previous: <a href="#Fontmap" accesskey="p" rel="prev">Fontmap</a>, Up: <a href="#Glyph-lookup" accesskey="u" rel="up">Glyph lookup</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> </div> @@ -3048,9 +2972,12 @@ must enable this feature by calling <code>kpathsea_init_prog</code> </p> <hr> -<span id="Suppressing-warnings"></span><div class="header"> +</div> +</div> +<div class="section" id="Suppressing-warnings"> +<div class="header"> <p> -Next: <a href="#mktex-scripts" accesskey="n" rel="next">mktex scripts</a>, Previous: <a href="#Glyph-lookup" accesskey="p" rel="prev">Glyph lookup</a>, Up: <a href="#TeX-support" accesskey="u" rel="up">TeX support</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="#mktex-scripts" accesskey="n" rel="next"><samp>mktex</samp> scripts</a>, Previous: <a href="#Glyph-lookup" accesskey="p" rel="prev">Glyph lookup</a>, Up: <a href="#TeX-support" accesskey="u" rel="up">TeX support</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="Suppressing-warnings-1"></span><h3 class="section">6.4 Suppressing warnings</h3> @@ -3066,44 +2993,32 @@ do this, you set the environment variable or configuration file value possibilities: </p> <dl compact="compact"> -<dt>‘<samp>all</samp>’ -<span id="index-all"></span> -</dt> +<dt id='index-all'><span>‘<samp>all</samp>’<a href='#index-all' class='copiable-anchor'> ¶</a></span></dt> <dd><p>Suppress everything possible. </p> </dd> -<dt>‘<samp>checksum</samp>’ -<span id="index-checksum"></span> -</dt> +<dt id='index-checksum'><span>‘<samp>checksum</samp>’<a href='#index-checksum' class='copiable-anchor'> ¶</a></span></dt> <dd><span id="index-mismatched-checksum-warnings"></span> <p>Suppress mismatched font checksum warnings. </p> </dd> -<dt>‘<samp>lostchar</samp>’ -<span id="index-lostchar"></span> -</dt> +<dt id='index-lostchar'><span>‘<samp>lostchar</samp>’<a href='#index-lostchar' class='copiable-anchor'> ¶</a></span></dt> <dd><span id="index-missing-character-warnings"></span> <p>Suppress warnings when a character is missing from a font that a DVI or VF file tries to typeset. </p> </dd> -<dt>‘<samp>none</samp>’ -<span id="index-none"></span> -</dt> +<dt id='index-none'><span>‘<samp>none</samp>’<a href='#index-none' class='copiable-anchor'> ¶</a></span></dt> <dd><p>Don’t suppress any warnings. </p> </dd> -<dt>‘<samp>readable</samp>’ -<span id="index-readable"></span> -</dt> +<dt id='index-readable'><span>‘<samp>readable</samp>’<a href='#index-readable' class='copiable-anchor'> ¶</a></span></dt> <dd><span id="index-unreadable-file-warnings"></span> <p>Suppress warnings about attempts to access a file whose permissions render it unreadable. </p> </dd> -<dt>‘<samp>special</samp>’ -<span id="index-special"></span> -</dt> +<dt id='index-special'><span>‘<samp>special</samp>’<a href='#index-special' class='copiable-anchor'> ¶</a></span></dt> <dd><span id="index-unknown-special-warnings"></span> <span id="index-_005cspecial_002c-suppressing-warnings-about"></span> <p>Suppresses warnings about an unimplemented or unparsable @@ -3117,7 +3032,9 @@ appropriate. </p> <hr> -<span id="mktex-scripts"></span><div class="header"> +</div> +<div class="section" id="mktex-scripts"> +<div class="header"> <p> Previous: <a href="#Suppressing-warnings" accesskey="p" rel="prev">Suppressing warnings</a>, Up: <a href="#TeX-support" accesskey="u" rel="up">TeX support</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> </div> @@ -3132,7 +3049,7 @@ Previous: <a href="#Suppressing-warnings" accesskey="p" rel="prev">Suppressing w <span id="index-EC-fonts_002c-and-dynamic-source-creation"></span> <p>If Kpathsea cannot otherwise find a file, for some file types it is configured by default to invoke an external program to create it -dynamically (see <a href="#mktex-configuration">mktex configuration</a>). These are collectively +dynamically (see <a href="#mktex-configuration"><samp>mktex</samp> configuration</a>). These are collectively known as <em><code>mktex</code> scripts</em>, since most of them are named <code>mktex...</code>. </p> @@ -3143,7 +3060,7 @@ Building all fonts in advance is therefore impractical, if not impossible. </p> <p>It is also useful for the TeX ‘<samp>.fmt</samp>’ (and Metafont -‘<samp>.base</samp>’ and Metapost ‘<samp>.mem</samp>’ files, see <a href="Web2c.html#Memory-dumps">Memory +‘<samp>.base</samp>’ and Metapost ‘<samp>.mem</samp>’ files, see <a data-manual="Web2c" href="Web2c.html#Memory-dumps">Memory dumps</a> in <cite>web2c</cite>), where pre-generating every format consumes a lot of both time and space. </p> @@ -3152,20 +3069,18 @@ arguments, as explained below. It must echo the full pathname of the file it created (and nothing else) to standard output; it can write diagnostics to standard error. </p> -<table class="menu" border="0" cellspacing="0"> -<tr><td align="left" valign="top">• <a href="#mktex-configuration" accesskey="1">config</a></td><td> </td><td align="left" valign="top"> -</td></tr> -<tr><td align="left" valign="top">• <a href="#mktex-script-names" accesskey="2">names</a></td><td> </td><td align="left" valign="top"> -</td></tr> -<tr><td align="left" valign="top">• <a href="#mktex-script-arguments" accesskey="3">args</a></td><td> </td><td align="left" valign="top"> -</td></tr> -</table> +<ul class="section-toc"> +<li><a href="#mktex-configuration" accesskey="1"><samp>mktex</samp> configuration</a></li> +<li><a href="#mktex-script-names" accesskey="2"><samp>mktex</samp> script names</a></li> +<li><a href="#mktex-script-arguments" accesskey="3"><samp>mktex</samp> script arguments</a></li> +</ul> <hr> -<span id="mktex-configuration"></span><div class="header"> +<div class="subsection" id="mktex-configuration"> +<div class="header"> <p> -Next: <a href="#mktex-script-names" accesskey="n" rel="next">mktex script names</a>, Up: <a href="#mktex-scripts" accesskey="u" rel="up">mktex scripts</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="#mktex-script-names" accesskey="n" rel="next"><samp>mktex</samp> script names</a>, Up: <a href="#mktex-scripts" accesskey="u" rel="up"><samp>mktex</samp> scripts</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="mktex-configuration-1"></span><h4 class="subsection">6.5.1 <samp>mktex</samp> configuration</h4> @@ -3200,7 +3115,7 @@ options to change the defaults are: <p>The <code>configure</code> setting is overridden if the environment variable or configuration file value named for the script is set; e.g., -<samp>MKTEXPK</samp> (see <a href="#mktex-script-arguments">mktex script arguments</a>). +<samp>MKTEXPK</samp> (see <a href="#mktex-script-arguments"><samp>mktex</samp> script arguments</a>). </p> <span id="index-fmtutils_002ecnf"></span> <p><code>mktexfmt</code> reads a file <samp>fmtutil.cnf</samp>, typically located in @@ -3251,21 +3166,17 @@ directory is used. <p>The ‘<samp>appendonlydir</samp>’ option is enabled by default. </p> <dl compact="compact"> -<dt>‘<samp>appendonlydir</samp>’ -<span id="index-appendonlydir"></span> -</dt> +<dt id='index-appendonlydir'><span>‘<samp>appendonlydir</samp>’<a href='#index-appendonlydir' class='copiable-anchor'> ¶</a></span></dt> <dd><span id="index-directories_002c-making-append_002donly"></span> <span id="index-mktexdir"></span> <p>Tell <code>mktexdir</code> to create directories append-only, i.e., set -their sticky bit (see <a href="https://www.gnu.org/software/coreutils/manual/coreutils#Mode-Structure">Mode Structure</a> in <cite>GNU Core +their sticky bit (see <a data-manual="coreutils" href="https://www.gnu.org/software/coreutils/manual/coreutils#Mode-Structure">Mode Structure</a> in <cite>GNU Core Utilities</cite>). This feature is silently ignored on non-Unix platforms (e.g. Windows/NT and MS-DOS) which don’t support similar functionality. This feature is enabled by default. </p> </dd> -<dt>‘<samp>dosnames</samp>’ -<span id="index-dosnames"></span> -</dt> +<dt id='index-dosnames'><span>‘<samp>dosnames</samp>’<a href='#index-dosnames' class='copiable-anchor'> ¶</a></span></dt> <dd><span id="index-8_002e3-filenames_002c-using"></span> <span id="index-DOS-compatible-names"></span> <span id="index-dpinnn-directories"></span> @@ -3288,59 +3199,45 @@ TeX-related files and are therefore unchanged. the emulation programs don’t consult <samp>mktex.opt</samp>. </p> </dd> -<dt>‘<samp>fontmaps</samp>’ -<span id="index-fontmaps-1"></span> -</dt> +<dt id='index-fontmaps-1'><span>‘<samp>fontmaps</samp>’<a href='#index-fontmaps-1' class='copiable-anchor'> ¶</a></span></dt> <dd><span id="index-fontmaps"></span> <span id="index-fontname"></span> <p>Instead of deriving the location of a font in the destination tree from the location of the sources, the aliases and directory names from the -Fontname distribution are used. (see <a href="fontname.html#Top">Introduction</a> in <cite>Fontname</cite>). +Fontname distribution are used. (see <a data-manual="fontname" href="fontname.html#Top">Introduction</a> in <cite>Fontname</cite>). </p> </dd> -<dt>‘<samp>nomfdrivers</samp>’ -<span id="index-nomfdrivers"></span> -</dt> +<dt id='index-nomfdrivers'><span>‘<samp>nomfdrivers</samp>’<a href='#index-nomfdrivers' class='copiable-anchor'> ¶</a></span></dt> <dd><span id="index-metafont-driver-files"></span> <p>Let mktexpk and mktextfm create metafont driver files in a temporary directory. These will be used for just one metafont run and not installed permanently. </p> </dd> -<dt>‘<samp>nomode</samp>’ -<span id="index-nomode"></span> -</dt> +<dt id='index-nomode'><span>‘<samp>nomode</samp>’<a href='#index-nomode' class='copiable-anchor'> ¶</a></span></dt> <dd><span id="index-mode-directory_002c-omitting"></span> <p>Omit the directory level for the mode name; this is fine as long as you generate fonts for only one mode. </p> </dd> -<dt>‘<samp>stripsupplier</samp>’ -<span id="index-stripsupplier"></span> -</dt> +<dt id='index-stripsupplier'><span>‘<samp>stripsupplier</samp>’<a href='#index-stripsupplier' class='copiable-anchor'> ¶</a></span></dt> <dd><span id="index-supplier-directory_002c-omitting"></span> <p>Omit the font supplier name directory level. </p> </dd> -<dt>‘<samp>striptypeface</samp>’ -<span id="index-striptypeface"></span> -</dt> +<dt id='index-striptypeface'><span>‘<samp>striptypeface</samp>’<a href='#index-striptypeface' class='copiable-anchor'> ¶</a></span></dt> <dd><span id="index-typeface-directory_002c-omitting"></span> <p>Omit the font typeface name directory level. </p> </dd> -<dt>‘<samp>strip</samp>’ -<span id="index-strip"></span> -</dt> +<dt id='index-strip'><span>‘<samp>strip</samp>’<a href='#index-strip' class='copiable-anchor'> ¶</a></span></dt> <dd><span id="index-supplier-directory_002c-omitting-1"></span> <span id="index-typeface-directory_002c-omitting-1"></span> <p>Omit the font supplier and typeface name directory levels. This feature is deprecated in favour of ‘<samp>stripsupplier</samp>’ and ‘<samp>striptypeface</samp>’. </p> </dd> -<dt>‘<samp>varfonts</samp>’ -<span id="index-varfonts"></span> -</dt> +<dt id='index-varfonts'><span>‘<samp>varfonts</samp>’<a href='#index-varfonts' class='copiable-anchor'> ¶</a></span></dt> <dd><span id="index-_002fvar_002ftmp_002ftexfonts"></span> <span id="index-VARTEXFONTS"></span> <span id="index-Linux-File-System-Standard"></span> @@ -3356,9 +3253,7 @@ recommends <samp>/var/tex/fonts</samp>. feature is enabled, and if set to ‘<samp>0</samp>’, the feature is disabled. </p> </dd> -<dt>‘<samp>texmfvar</samp>’ -<span id="index-texmfvar"></span> -</dt> +<dt id='index-texmfvar'><span>‘<samp>texmfvar</samp>’<a href='#index-texmfvar' class='copiable-anchor'> ¶</a></span></dt> <dd><span id="index-TEXMFVAR"></span> <p>Force generated files that would go into a system tree (as defined by <code>SYSTEXMF</code>) into <code>TEXMFVAR</code>. Starting with teTeX-3.0, the @@ -3374,9 +3269,11 @@ feature is enabled, and if set to ‘<samp>0</samp>’, the feature is d <hr> -<span id="mktex-script-names"></span><div class="header"> +</div> +<div class="subsection" id="mktex-script-names"> +<div class="header"> <p> -Next: <a href="#mktex-script-arguments" accesskey="n" rel="next">mktex script arguments</a>, Previous: <a href="#mktex-configuration" accesskey="p" rel="prev">mktex configuration</a>, Up: <a href="#mktex-scripts" accesskey="u" rel="up">mktex scripts</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="#mktex-script-arguments" accesskey="n" rel="next"><samp>mktex</samp> script arguments</a>, Previous: <a href="#mktex-configuration" accesskey="p" rel="prev"><samp>mktex</samp> configuration</a>, Up: <a href="#mktex-scripts" accesskey="u" rel="up"><samp>mktex</samp> scripts</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="mktex-script-names-1"></span><h4 class="subsection">6.5.2 <samp>mktex</samp> script names</h4> @@ -3387,42 +3284,35 @@ Next: <a href="#mktex-script-arguments" accesskey="n" rel="next">mktex script ar of the file types which support runtime generation. </p> <dl compact="compact"> -<dt><samp>mktexfmt</samp></dt> -<dd><span id="index-mktexfmt"></span> -<span id="index-fmtutil"></span> +<dt id='index-mktexfmt'><span><samp>mktexfmt</samp><a href='#index-mktexfmt' class='copiable-anchor'> ¶</a></span></dt> +<dd><span id="index-fmtutil"></span> <p>(‘<samp>.fmt</samp>’, ‘<samp>.base</samp>’, ‘<samp>.mem</samp>’) TeX/Metafont/MetaPost formats. This script is also named <code>fmtutil</code>, and reads <samp>fmtutil.cnf</samp> for configuration information. </p> </dd> -<dt><samp>mktexmf</samp></dt> -<dd><span id="index-mktexmf"></span> -<p>(‘<samp>.mf</samp>’) Metafont input files. +<dt id='index-mktexmf'><span><samp>mktexmf</samp><a href='#index-mktexmf' class='copiable-anchor'> ¶</a></span></dt> +<dd><p>(‘<samp>.mf</samp>’) Metafont input files. </p> </dd> -<dt><samp>mkocp</samp></dt> -<dd><span id="index-mkocp"></span> -<p>(‘<samp>.ocp</samp>’) Omega compiled process files. +<dt id='index-mkocp'><span><samp>mkocp</samp><a href='#index-mkocp' class='copiable-anchor'> ¶</a></span></dt> +<dd><p>(‘<samp>.ocp</samp>’) Omega compiled process files. </p> </dd> -<dt><samp>mkofm</samp></dt> -<dd><span id="index-mkofm"></span> -<p>(‘<samp>.ofm</samp>’) Omega font metric files. +<dt id='index-mkofm'><span><samp>mkofm</samp><a href='#index-mkofm' class='copiable-anchor'> ¶</a></span></dt> +<dd><p>(‘<samp>.ofm</samp>’) Omega font metric files. </p> </dd> -<dt><samp>mktexpk</samp></dt> -<dd><span id="index-mktexpk"></span> -<p>(‘<samp>pk</samp>’) Glyph fonts. +<dt id='index-mktexpk'><span><samp>mktexpk</samp><a href='#index-mktexpk' class='copiable-anchor'> ¶</a></span></dt> +<dd><p>(‘<samp>pk</samp>’) Glyph fonts. </p> </dd> -<dt><samp>mktextex</samp></dt> -<dd><span id="index-mktextex"></span> -<p>(‘<samp>.tex</samp>’) TeX input files (disabled by default). +<dt id='index-mktextex'><span><samp>mktextex</samp><a href='#index-mktextex' class='copiable-anchor'> ¶</a></span></dt> +<dd><p>(‘<samp>.tex</samp>’) TeX input files (disabled by default). </p> </dd> -<dt><samp>mktextfm</samp></dt> -<dd><span id="index-mktextfm"></span> -<p>(‘<samp>.tfm</samp>’) TFM files. +<dt id='index-mktextfm'><span><samp>mktextfm</samp><a href='#index-mktextfm' class='copiable-anchor'> ¶</a></span></dt> +<dd><p>(‘<samp>.tfm</samp>’) TFM files. </p></dd> </dl> @@ -3449,9 +3339,11 @@ configuration file value. </p> <hr> -<span id="mktex-script-arguments"></span><div class="header"> +</div> +<div class="subsection" id="mktex-script-arguments"> +<div class="header"> <p> -Previous: <a href="#mktex-script-names" accesskey="p" rel="prev">mktex script names</a>, Up: <a href="#mktex-scripts" accesskey="u" rel="up">mktex scripts</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="#mktex-script-names" accesskey="p" rel="prev"><samp>mktex</samp> script names</a>, Up: <a href="#mktex-scripts" accesskey="u" rel="up"><samp>mktex</samp> scripts</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="mktex-script-arguments-1"></span><h4 class="subsection">6.5.3 <samp>mktex</samp> script arguments</h4> @@ -3464,21 +3356,21 @@ of the file to be created. also be passed: </p> <dl compact="compact"> -<dt>‘<samp>--dpi <var>num</var></samp>’</dt> +<dt><span>‘<samp>--dpi <var>num</var></samp>’</span></dt> <dd><p>Sets the resolution of the generated font to <var>num</var>. </p></dd> -<dt>‘<samp>--mfmode <var>name</var></samp>’</dt> +<dt><span>‘<samp>--mfmode <var>name</var></samp>’</span></dt> <dd><p>Sets the Metafont mode to <var>name</var>. </p></dd> -<dt>‘<samp>--bdpi <var>num</var></samp>’</dt> +<dt><span>‘<samp>--bdpi <var>num</var></samp>’</span></dt> <dd><p>Sets the “base dpi” for the font. This must match the mode being used. </p></dd> -<dt>‘<samp>--mag <var>string</var></samp>’</dt> +<dt><span>‘<samp>--mag <var>string</var></samp>’</span></dt> <dd><p>A “magstep” string suitable for the Metafont <code>mag</code> variable. This must match the combination of <var>bdpi</var> and <var>dpi</var> being used. </p></dd> -<dt>‘<samp>--destdir <var>string</var></samp>’</dt> +<dt><span>‘<samp>--destdir <var>string</var></samp>’</span></dt> <dd><p>A directory name. If the directory is absolute, it is used as-is. Otherwise, it is appended to the root destination directory set in the script. @@ -3487,9 +3379,13 @@ script. <hr> -<span id="Programming"></span><div class="header"> +</div> +</div> +</div> +<div class="chapter" id="Programming"> +<div class="header"> <p> -Next: <a href="#Reporting-bugs" accesskey="n" rel="next">Reporting bugs</a>, Previous: <a href="#TeX-support" accesskey="p" rel="prev">TeX support</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="#Reporting-bugs" accesskey="n" rel="next">Reporting bugs</a>, Previous: <a href="#TeX-support" accesskey="p" rel="prev">TeX support</a>, Up: <a href="#Top" accesskey="u" rel="up">Kpathsea library</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="Programming-1"></span><h2 class="chapter">7 Programming</h2> @@ -3497,20 +3393,17 @@ Next: <a href="#Reporting-bugs" accesskey="n" rel="next">Reporting bugs</a>, Pre See <a href="#Introduction">Introduction</a>, for the conditions under which you may do so (in short, it is released under LGPLv2.1 or later). </p> -<table class="menu" border="0" cellspacing="0"> -<tr><td align="left" valign="top">• <a href="#Programming-overview" accesskey="1">Overview</a></td><td> </td><td align="left" valign="top">Introduction. -</td></tr> -<tr><td align="left" valign="top">• <a href="#Calling-sequence" accesskey="2">Calling sequence</a></td><td> </td><td align="left" valign="top">Specifics of what to call. -</td></tr> -<tr><td align="left" valign="top">• <a href="#Program_002dspecific-files" accesskey="3">Program-specific files</a></td><td> </td><td align="left" valign="top">How to handle these. -</td></tr> -<tr><td align="left" valign="top">• <a href="#Programming-with-config-files" accesskey="4">Config</a></td><td> </td><td align="left" valign="top">Getting info from texmf.cnf. -</td></tr> -</table> +<ul class="section-toc"> +<li><a href="#Programming-overview" accesskey="1">Programming overview</a></li> +<li><a href="#Calling-sequence" accesskey="2">Calling sequence</a></li> +<li><a href="#Program_002dspecific-files" accesskey="3">Program-specific files</a></li> +<li><a href="#Programming-with-config-files" accesskey="4">Programming with config files</a></li> +</ul> <hr> -<span id="Programming-overview"></span><div class="header"> +<div class="section" id="Programming-overview"> +<div class="header"> <p> Next: <a href="#Calling-sequence" accesskey="n" rel="next">Calling sequence</a>, Up: <a href="#Programming" accesskey="u" rel="up">Programming</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> </div> @@ -3579,7 +3472,9 @@ above, of course. </p> <hr> -<span id="Calling-sequence"></span><div class="header"> +</div> +<div class="section" id="Calling-sequence"> +<div class="header"> <p> Next: <a href="#Program_002dspecific-files" accesskey="n" rel="next">Program-specific files</a>, Previous: <a href="#Programming-overview" accesskey="p" rel="prev">Programming overview</a>, Up: <a href="#Programming" accesskey="u" rel="up">Programming</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> </div> @@ -3741,7 +3636,9 @@ They are available from <a href="https://gnu.org/software">https://gnu.org/softw </p> <hr> -<span id="Program_002dspecific-files"></span><div class="header"> +</div> +<div class="section" id="Program_002dspecific-files"> +<div class="header"> <p> Next: <a href="#Programming-with-config-files" accesskey="n" rel="next">Programming with config files</a>, Previous: <a href="#Calling-sequence" accesskey="p" rel="prev">Calling sequence</a>, Up: <a href="#Programming" accesskey="u" rel="up">Programming</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> </div> @@ -3749,7 +3646,7 @@ Next: <a href="#Programming-with-config-files" accesskey="n" rel="next">Programm <p>Many programs will need to find some configuration files. Kpathsea contains some support to make it easy to place them in their own -directories. The Standard TeX directory structure (see <a href="tds.html#Top">Introduction</a> in <cite>A Directory Structure for TeX files</cite>), specifies +directories. The Standard TeX directory structure (see <a data-manual="tds" href="tds.html#Top">Introduction</a> in <cite>A Directory Structure for TeX files</cite>), specifies that such files should go into a subdirectory named after the program, like ‘<samp>texmf/ttf2pk</samp>’. </p> @@ -3767,7 +3664,9 @@ mode. </p> <hr> -<span id="Programming-with-config-files"></span><div class="header"> +</div> +<div class="section" id="Programming-with-config-files"> +<div class="header"> <p> Previous: <a href="#Program_002dspecific-files" accesskey="p" rel="prev">Program-specific files</a>, Up: <a href="#Programming" accesskey="u" rel="up">Programming</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> </div> @@ -3813,9 +3712,12 @@ with the string <var>var</var>. </p> <hr> -<span id="Reporting-bugs"></span><div class="header"> +</div> +</div> +<div class="chapter" id="Reporting-bugs"> +<div class="header"> <p> -Next: <a href="#Index" accesskey="n" rel="next">Index</a>, Previous: <a href="#Programming" accesskey="p" rel="prev">Programming</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="#Programming" accesskey="p" rel="prev">Programming</a>, Up: <a href="#Top" accesskey="u" rel="up">Kpathsea library</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="Reporting-bugs-1"></span><h2 class="chapter">8 Reporting bugs</h2> @@ -3831,22 +3733,18 @@ Next: <a href="#Index" accesskey="n" rel="next">Index</a>, Previous: <a href="#P inconsistent behavior, but unclear or incomplete explanations, typos, wrong fonts, … </p> -<table class="menu" border="0" cellspacing="0"> -<tr><td align="left" valign="top">• <a href="#Bug-checklist" accesskey="1">Bug checklist</a></td><td> </td><td align="left" valign="top">What to include in a good bug report. -</td></tr> -<tr><td align="left" valign="top">• <a href="#Mailing-lists" accesskey="2">Mailing lists</a></td><td> </td><td align="left" valign="top">Joining the bugs or announcements mailing lists. -</td></tr> -<tr><td align="left" valign="top">• <a href="#Debugging" accesskey="3">Debugging</a></td><td> </td><td align="left" valign="top">Analyzing runtime problems. -</td></tr> -<tr><td align="left" valign="top">• <a href="#Logging" accesskey="4">Logging</a></td><td> </td><td align="left" valign="top">Recording searches. -</td></tr> -<tr><td align="left" valign="top">• <a href="#Common-problems" accesskey="5">Common problems</a></td><td> </td><td align="left" valign="top">When things go wrong. -</td></tr> -</table> +<ul class="section-toc"> +<li><a href="#Bug-checklist" accesskey="1">Bug checklist</a></li> +<li><a href="#Mailing-lists" accesskey="2">Mailing lists</a></li> +<li><a href="#Debugging" accesskey="3">Debugging</a></li> +<li><a href="#Logging" accesskey="4">Logging</a></li> +<li><a href="#Common-problems" accesskey="5">Common problems</a></li> +</ul> <hr> -<span id="Bug-checklist"></span><div class="header"> +<div class="section" id="Bug-checklist"> +<div class="header"> <p> Next: <a href="#Mailing-lists" accesskey="n" rel="next">Mailing lists</a>, Up: <a href="#Reporting-bugs" accesskey="u" rel="up">Reporting bugs</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> </div> @@ -3939,7 +3837,9 @@ diagnosing, or fixing the bug. <hr> -<span id="Mailing-lists"></span><div class="header"> +</div> +<div class="section" id="Mailing-lists"> +<div class="header"> <p> Next: <a href="#Debugging" accesskey="n" rel="next">Debugging</a>, Previous: <a href="#Bug-checklist" accesskey="p" rel="prev">Bug checklist</a>, Up: <a href="#Reporting-bugs" accesskey="u" rel="up">Reporting bugs</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> </div> @@ -3965,7 +3865,9 @@ full TeX system or how to use LaTeX, please see </p> <hr> -<span id="Debugging"></span><div class="header"> +</div> +<div class="section" id="Debugging"> +<div class="header"> <p> Next: <a href="#Logging" accesskey="n" rel="next">Logging</a>, Previous: <a href="#Mailing-lists" accesskey="p" rel="prev">Mailing lists</a>, Up: <a href="#Reporting-bugs" accesskey="u" rel="up">Reporting bugs</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> </div> @@ -4011,7 +3913,7 @@ easily. For example, in Bourne-compatible shells: <span id="index-Kpsewhich_002c-and-debugging"></span> <p>It is sometimes helpful to run the standalone Kpsewhich utility -(see <a href="#Invoking-kpsewhich">Invoking kpsewhich</a>), instead of the original program. +(see <a href="#Invoking-kpsewhich"><code>kpsewhich</code>: Standalone path searching</a>), instead of the original program. </p> <span id="index-numeric-debugging-values"></span> <p>In any case, you cannot use the names below; you must always use @@ -4019,29 +3921,23 @@ somebody’s numbers. (Sorry.) To set more than one option, just sum the corresponding numbers. </p> <dl compact="compact"> -<dt><code>KPSE_DEBUG_STAT <span class="roman">(1)</span></code> -<span id="index-KPSE_005fDEBUG_005fSTAT-_00281_0029"></span> -</dt> +<dt id='index-KPSE_005fDEBUG_005fSTAT-_00281_0029'><span><code>KPSE_DEBUG_STAT <span class="roman">(1)</span></code><a href='#index-KPSE_005fDEBUG_005fSTAT-_00281_0029' class='copiable-anchor'> ¶</a></span></dt> <dd><p>Report ‘<samp>stat</samp>’(2) calls. This is useful for verifying that your directory structure is not forcing Kpathsea to do many additional file tests (see <a href="#Slow-path-searching">Slow path searching</a>, and see <a href="#Subdirectory-expansion">Subdirectory expansion</a>). If you are using an up-to-date <samp>ls-R</samp> database -(see <a href="#Filename-database">Filename database</a>), this should produce no output unless a +(see <a href="#Filename-database">Filename database (<code>ls-R</code>)</a>), this should produce no output unless a nonexistent file that must exist is searched for. </p> </dd> -<dt><code>KPSE_DEBUG_HASH <span class="roman">(2)</span></code> -<span id="index-KPSE_005fDEBUG_005fHASH-_00282_0029"></span> -</dt> +<dt id='index-KPSE_005fDEBUG_005fHASH-_00282_0029'><span><code>KPSE_DEBUG_HASH <span class="roman">(2)</span></code><a href='#index-KPSE_005fDEBUG_005fHASH-_00282_0029' class='copiable-anchor'> ¶</a></span></dt> <dd><p>Report lookups in all hash tables: <samp>ls-R</samp> and <samp>aliases</samp> -(see <a href="#Filename-database">Filename database</a>); font aliases (see <a href="#Fontmap">Fontmap</a>); and config +(see <a href="#Filename-database">Filename database (<code>ls-R</code>)</a>); font aliases (see <a href="#Fontmap">Fontmap</a>); and config file values (see <a href="#Config-files">Config files</a>). Useful when expected values are not being found, e.g.., file searches are looking at the disk instead of using <samp>ls-R</samp>. </p> </dd> -<dt><code>KPSE_DEBUG_FOPEN <span class="roman">(4)</span></code> -<span id="index-KPSE_005fDEBUG_005fFOPEN-_00284_0029"></span> -</dt> +<dt id='index-KPSE_005fDEBUG_005fFOPEN-_00284_0029'><span><code>KPSE_DEBUG_FOPEN <span class="roman">(4)</span></code><a href='#index-KPSE_005fDEBUG_005fFOPEN-_00284_0029' class='copiable-anchor'> ¶</a></span></dt> <dd><span id="index-fopen_002c-redefined"></span> <p>Report file openings and closings. Especially useful when your system’s file table is full, for seeing which files have been opened but never @@ -4050,9 +3946,7 @@ redefining ‘<samp>fopen</samp>’ (‘<samp>fclose</samp>’) (‘<samp>kpse_fclose_trace</samp>’). </p> </dd> -<dt><code>KPSE_DEBUG_PATHS <span class="roman">(8)</span></code> -<span id="index-KPSE_005fDEBUG_005fPATHS-_00288_0029"></span> -</dt> +<dt id='index-KPSE_005fDEBUG_005fPATHS-_00288_0029'><span><code>KPSE_DEBUG_PATHS <span class="roman">(8)</span></code><a href='#index-KPSE_005fDEBUG_005fPATHS-_00288_0029' class='copiable-anchor'> ¶</a></span></dt> <dd><span id="index-kpse_005fformat_005finfo_005ftype"></span> <p>Report general path information for each file type Kpathsea is asked to search. This is useful when you are trying to track down how a @@ -4062,17 +3956,13 @@ contents of the <code>kpse_format_info_type</code> structure defined in <samp>tex-file.h</samp>. </p> </dd> -<dt><code>KPSE_DEBUG_EXPAND <span class="roman">(16)</span></code> -<span id="index-KPSE_005fDEBUG_005fEXPAND-_002816_0029"></span> -</dt> +<dt id='index-KPSE_005fDEBUG_005fEXPAND-_002816_0029'><span><code>KPSE_DEBUG_EXPAND <span class="roman">(16)</span></code><a href='#index-KPSE_005fDEBUG_005fEXPAND-_002816_0029' class='copiable-anchor'> ¶</a></span></dt> <dd><p>Report the directory list corresponding to each path element Kpathsea searches. This is only relevant when Kpathsea searches the disk, since <samp>ls-R</samp> searches don’t look through directory lists in this way. </p> </dd> -<dt><code>KPSE_DEBUG_SEARCH <span class="roman">(32)</span></code> -<span id="index-KPSE_005fDEBUG_005fSEARCH-_002832_0029"></span> -</dt> +<dt id='index-KPSE_005fDEBUG_005fSEARCH-_002832_0029'><span><code>KPSE_DEBUG_SEARCH <span class="roman">(32)</span></code><a href='#index-KPSE_005fDEBUG_005fSEARCH-_002832_0029' class='copiable-anchor'> ¶</a></span></dt> <dd><p>Report on each file search: the name of the file searched for, the path searched in, whether or not the file must exist (when drivers search for <samp>cmr10.vf</samp>, it need not exist), and whether or not we are @@ -4082,22 +3972,16 @@ most lookups). This can help you correlate what Kpathsea is doing with what is in your input file. </p> </dd> -<dt><code>KPSE_DEBUG_VARS <span class="roman">(64)</span></code> -<span id="index-KPSE_005fDEBUG_005fVARS-_002864_0029"></span> -</dt> +<dt id='index-KPSE_005fDEBUG_005fVARS-_002864_0029'><span><code>KPSE_DEBUG_VARS <span class="roman">(64)</span></code><a href='#index-KPSE_005fDEBUG_005fVARS-_002864_0029' class='copiable-anchor'> ¶</a></span></dt> <dd><p>Report the value of each variable Kpathsea looks up. This is useful for verifying that variables do indeed obtain their correct values. </p> </dd> -<dt><code>GSFTOPK_DEBUG <span class="roman">(128)</span></code> -<span id="index-GSFTOPK_005fDEBUG-_0028128_0029"></span> -</dt> +<dt id='index-GSFTOPK_005fDEBUG-_0028128_0029'><span><code>GSFTOPK_DEBUG <span class="roman">(128)</span></code><a href='#index-GSFTOPK_005fDEBUG-_0028128_0029' class='copiable-anchor'> ¶</a></span></dt> <dd><p>Activates debugging printout specific to <code>gsftopk</code> program. </p> </dd> -<dt><code>MAKETEX_DEBUG <span class="roman">(512)</span></code> -<span id="index-MAKETEX_005fDEBUG-_0028512_0029"></span> -</dt> +<dt id='index-MAKETEX_005fDEBUG-_0028512_0029'><span><code>MAKETEX_DEBUG <span class="roman">(512)</span></code><a href='#index-MAKETEX_005fDEBUG-_0028512_0029' class='copiable-anchor'> ¶</a></span></dt> <dd><p>If you use the optional <code>mktex</code> programs instead of the traditional shell scripts, this will report the name of the site file (<samp>mktex.cnf</samp> by default) which is read, directories created by @@ -4107,9 +3991,7 @@ parameters from <code>mktexnam</code>, filenames added by <code>mktexupd</code>, and some subsidiary commands run by the programs. </p> </dd> -<dt><code>MAKETEX_FINE_DEBUG <span class="roman">(1024)</span></code> -<span id="index-MAKETEX_005fFINE_005fDEBUG-_00281024_0029"></span> -</dt> +<dt id='index-MAKETEX_005fFINE_005fDEBUG-_00281024_0029'><span><code>MAKETEX_FINE_DEBUG <span class="roman">(1024)</span></code><a href='#index-MAKETEX_005fFINE_005fDEBUG-_00281024_0029' class='copiable-anchor'> ¶</a></span></dt> <dd><p>When the optional <code>mktex</code> programs are used, this will print additional debugging info from functions internal to these programs. </p></dd> @@ -4126,7 +4008,9 @@ variable in <samp>kpathsea/db.c</samp>.) </p> <hr> -<span id="Logging"></span><div class="header"> +</div> +<div class="section" id="Logging"> +<div class="header"> <p> Next: <a href="#Common-problems" accesskey="n" rel="next">Common problems</a>, Previous: <a href="#Debugging" accesskey="p" rel="prev">Debugging</a>, Up: <a href="#Reporting-bugs" accesskey="u" rel="up">Reporting bugs</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> </div> @@ -4185,7 +4069,9 @@ else. </p> <hr> -<span id="Common-problems"></span><div class="header"> +</div> +<div class="section" id="Common-problems"> +<div class="header"> <p> Previous: <a href="#Logging" accesskey="p" rel="prev">Logging</a>, Up: <a href="#Reporting-bugs" accesskey="u" rel="up">Reporting bugs</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> </div> @@ -4198,19 +4084,16 @@ Previous: <a href="#Logging" accesskey="p" rel="prev">Logging</a>, Up: <a href=" <p>Here are some common problems with configuration, compilation, linking, execution, … </p> -<table class="menu" border="0" cellspacing="0"> -<tr><td align="left" valign="top">• <a href="#Unable-to-find-files" accesskey="1">Unable to find files</a></td><td> </td><td align="left" valign="top">If your program can’t find fonts (or whatever). -</td></tr> -<tr><td align="left" valign="top">• <a href="#Slow-path-searching" accesskey="2">Slow path searching</a></td><td> </td><td align="left" valign="top">If it takes forever to find anything. -</td></tr> -<tr><td align="left" valign="top">• <a href="#Unable-to-generate-fonts" accesskey="3">Unable to generate fonts</a></td><td> </td><td align="left" valign="top">If mktexpk fails. -</td></tr> -<tr><td align="left" valign="top">• <a href="#TeX-or-Metafont-failing" accesskey="4">TeX or Metafont failing</a></td><td> </td><td align="left" valign="top">Likely compiler bugs. -</td></tr> -</table> +<ul class="section-toc"> +<li><a href="#Unable-to-find-files" accesskey="1">Unable to find files</a></li> +<li><a href="#Slow-path-searching" accesskey="2">Slow path searching</a></li> +<li><a href="#Unable-to-generate-fonts" accesskey="3">Unable to generate fonts</a></li> +<li><a href="#TeX-or-Metafont-failing" accesskey="4">TeX or Metafont failing</a></li> +</ul> <hr> -<span id="Unable-to-find-files"></span><div class="header"> +<div class="subsection" id="Unable-to-find-files"> +<div class="header"> <p> Next: <a href="#Slow-path-searching" accesskey="n" rel="next">Slow path searching</a>, Up: <a href="#Common-problems" accesskey="u" rel="up">Common 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> @@ -4226,7 +4109,7 @@ debugging options helpful. See <a href="#Debugging">Debugging</a>. <ul> <li> Perhaps you simply haven’t installed all the necessary files; the basic fonts and input files are distributed separately from the programs. -See <a href="#unixtex_002eftp">unixtex.ftp</a>. +See <a href="#unixtex_002eftp"><samp>unixtex.ftp</samp>: Obtaining TeX</a>. </li><li> <span id="index-_002fetc_002fprofile"></span> <span id="index-environment-variables_002c-old"></span> @@ -4263,14 +4146,16 @@ error message saying something like ‘<samp>Can't find font <var>fontname</var></samp>’. The best solution is to fix (or at least report) the bug in <code>mktexpk</code>; the workaround is to generate the necessary fonts by hand with Metafont, or to grab them from a CTAN site -(see <a href="#unixtex_002eftp">unixtex.ftp</a>). +(see <a href="#unixtex_002eftp"><samp>unixtex.ftp</samp>: Obtaining TeX</a>). </li><li> There is a bug in the library. See <a href="#Reporting-bugs">Reporting bugs</a>. </li></ul> <hr> -<span id="Slow-path-searching"></span><div class="header"> +</div> +<div class="subsection" id="Slow-path-searching"> +<div class="header"> <p> Next: <a href="#Unable-to-generate-fonts" accesskey="n" rel="next">Unable to generate fonts</a>, Previous: <a href="#Unable-to-find-files" accesskey="p" rel="prev">Unable to find files</a>, Up: <a href="#Common-problems" accesskey="u" rel="up">Common 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> @@ -4287,7 +4172,7 @@ input files, but does eventually succeed, here are some possible culprits: <li> Most likely, you just have a lot of directories to search, and that takes a noticeable time. The solution is to create and maintain a separate <samp>ls-R</samp> file that lists all the files in your main TeX -hierarchy. See <a href="#Filename-database">Filename database</a>. Kpathsea always uses <samp>ls-R</samp> +hierarchy. See <a href="#Filename-database">Filename database (<code>ls-R</code>)</a>. Kpathsea always uses <samp>ls-R</samp> if it’s present; there’s no need to recompile or reconfigure any of the programs. @@ -4307,7 +4192,9 @@ precisely when the disk or network is being pounded. See <a href="#Debugging">D </p> <hr> -<span id="Unable-to-generate-fonts"></span><div class="header"> +</div> +<div class="subsection" id="Unable-to-generate-fonts"> +<div class="header"> <p> Next: <a href="#TeX-or-Metafont-failing" accesskey="n" rel="next">TeX or Metafont failing</a>, Previous: <a href="#Slow-path-searching" accesskey="p" rel="prev">Slow path searching</a>, Up: <a href="#Common-problems" accesskey="u" rel="up">Common 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> @@ -4332,7 +4219,7 @@ mktexpk: Use a config file to specify the mode, or update me. specifying the resolution, as in <code>-D 360</code>, is not enough. </p> <p>You can specify the mode name with the <code>-mode</code> option on the -Dvips command line, or in a Dvips configuration file (see <a href="https://tug.org/texinfohtml/dvips.html#Config-files">Config +Dvips command line, or in a Dvips configuration file (see <a data-manual="dvips" href="https://tug.org/texinfohtml/dvips.html#Config-files">Config files</a> in <cite>Dvips</cite>), such as <samp>config.ps</samp> in your document directory, <samp>~/.dvipsrc</samp> in your home directory, or in a system directory (again named <samp>config.ps</samp>). (Other drivers use other @@ -4377,15 +4264,17 @@ the base files are stored on your system (<samp>/usr/local/share/texmf/web2c</samp> by default), and make a link (either hard or soft) from <samp>plain.base</samp> to <samp>mf.base</samp> in that directory. -See <a href="https://tug.org/texinfohtml/web2c.html#inimf-invocation">inimf invocation</a> in <cite>Web2c</cite>. +See <a data-manual="web2c" href="https://tug.org/texinfohtml/web2c.html#inimf-invocation">inimf invocation</a> in <cite>Web2c</cite>. </p> <span id="index-Metafont-installation"></span> <p>If <code>mf</code> is a command not found at all by <code>mktexpk</code>, then you -need to install Metafont (see <a href="#unixtex_002eftp">unixtex.ftp</a>). +need to install Metafont (see <a href="#unixtex_002eftp"><samp>unixtex.ftp</samp>: Obtaining TeX</a>). </p> <hr> -<span id="TeX-or-Metafont-failing"></span><div class="header"> +</div> +<div class="subsection" id="TeX-or-Metafont-failing"> +<div class="header"> <p> Previous: <a href="#Unable-to-generate-fonts" accesskey="p" rel="prev">Unable to generate fonts</a>, Up: <a href="#Common-problems" accesskey="u" rel="up">Common 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> @@ -4409,7 +4298,7 @@ to run the program under the debugger and see where it’s failing. <span id="index-system-C-compiler-bugs"></span> <p>Also, if you have trouble with a system C compiler, I advise trying the GNU C compiler. And vice versa, unfortunately; but in that case I also -recommend reporting a bug to the GCC mailing list; see <a href="https://gcc.gnu.org/onlinedocs/gcc/Bugs.html#Bugs">Bugs</a> in <cite>Using and Porting GNU CC</cite>. +recommend reporting a bug to the GCC mailing list; see <a data-manual="gcc" href="https://gcc.gnu.org/onlinedocs/gcc/Bugs.html#Bugs">Bugs</a> in <cite>Using and Porting GNU CC</cite>. </p> <span id="index-compiler-bugs_002c-finding"></span> <p>To report compiler bugs effectively requires perseverance and @@ -4419,9 +4308,13 @@ through TeX’s (or whatever program’s) data structures. Good luck. </p> <hr> -<span id="Index"></span><div class="header"> +</div> +</div> +</div> +<div class="unnumbered" id="Index"> +<div class="header"> <p> -Previous: <a href="#Reporting-bugs" accesskey="p" rel="prev">Reporting bugs</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="#Reporting-bugs" accesskey="p" rel="prev">Reporting bugs</a>, Up: <a href="#Top" accesskey="u" rel="up">Kpathsea library</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> @@ -4722,7 +4615,6 @@ Previous: <a href="#Reporting-bugs" accesskey="p" rel="prev">Reporting bugs</a>, <tr><td></td><td valign="top"><a href="#index-config_002estatus"><code>config.status</code></a>:</td><td> </td><td valign="top"><a href="#Bug-checklist">Bug checklist</a></td></tr> <tr><td></td><td valign="top"><a href="#index-configuration-bugs">configuration bugs</a>:</td><td> </td><td valign="top"><a href="#Bug-checklist">Bug checklist</a></td></tr> <tr><td></td><td valign="top"><a href="#index-configuration-file_002c-source-for-path">configuration file, source for path</a>:</td><td> </td><td valign="top"><a href="#Path-sources">Path sources</a></td></tr> -<tr><td></td><td valign="top"><a href="#index-configuration-files-as-shell-scripts_002e">configuration files as shell scripts.</a>:</td><td> </td><td valign="top"><a href="#Config-files">Config files</a></td></tr> <tr><td></td><td valign="top"><a href="#index-configuration-of-mktex-scripts">configuration of <samp>mktex</samp> scripts</a>:</td><td> </td><td valign="top"><a href="#mktex-configuration">mktex configuration</a></td></tr> <tr><td></td><td valign="top"><a href="#index-configure-options-for-mktex-scripts"><code>configure</code> options for <samp>mktex</samp> scripts</a>:</td><td> </td><td valign="top"><a href="#mktex-configuration">mktex configuration</a></td></tr> <tr><td></td><td valign="top"><a href="#index-context-diff">context diff</a>:</td><td> </td><td valign="top"><a href="#Bug-checklist">Bug checklist</a></td></tr> @@ -5072,7 +4964,6 @@ Previous: <a href="#Reporting-bugs" accesskey="p" rel="prev">Reporting bugs</a>, <tr><td></td><td valign="top"><a href="#index-sending-patches">sending patches</a>:</td><td> </td><td valign="top"><a href="#Bug-checklist">Bug checklist</a></td></tr> <tr><td></td><td valign="top"><a href="#index-setgid-scripts">setgid scripts</a>:</td><td> </td><td valign="top"><a href="#Security">Security</a></td></tr> <tr><td></td><td valign="top"><a href="#index-SFDFONTS"><code>SFDFONTS</code></a>:</td><td> </td><td valign="top"><a href="#Supported-file-formats">Supported file formats</a></td></tr> -<tr><td></td><td valign="top"><a href="#index-shell-scripts-as-configuration-files">shell scripts as configuration files</a>:</td><td> </td><td valign="top"><a href="#Config-files">Config files</a></td></tr> <tr><td></td><td valign="top"><a href="#index-shell-variables">shell variables</a>:</td><td> </td><td valign="top"><a href="#Variable-expansion">Variable expansion</a></td></tr> <tr><td></td><td valign="top"><a href="#index-shell_005fescape_002c-example-for-code"><code>shell_escape<span class="roman">, example for code</span></code></a>:</td><td> </td><td valign="top"><a href="#Programming-with-config-files">Programming with config files</a></td></tr> <tr><td></td><td valign="top"><a href="#index-site-overrides-for-mktex_2026">site overrides for <code>mktex…</code></a>:</td><td> </td><td valign="top"><a href="#mktex-configuration">mktex configuration</a></td></tr> @@ -5312,7 +5203,8 @@ Previous: <a href="#Reporting-bugs" accesskey="p" rel="prev">Reporting bugs</a>, </td></tr></table> -<hr> +</div> +</div> diff --git a/systems/doc/kpathsea/kpathsea.pdf b/systems/doc/kpathsea/kpathsea.pdf Binary files differindex 1ff6d90fb8..a189490124 100644 --- a/systems/doc/kpathsea/kpathsea.pdf +++ b/systems/doc/kpathsea/kpathsea.pdf diff --git a/systems/texlive/tlnet/tlpkg/installer/ctan-mirrors.pl b/systems/texlive/tlnet/tlpkg/installer/ctan-mirrors.pl index 36275a52f9..2d316edce2 100644 --- a/systems/texlive/tlnet/tlpkg/installer/ctan-mirrors.pl +++ b/systems/texlive/tlnet/tlpkg/installer/ctan-mirrors.pl @@ -38,7 +38,6 @@ $mirrors = { 'http://ctan.yazd.ac.ir/' => 1, 'https://ctan.asis.ai/' => 1, 'https://ctan.um.ac.ir/' => 1, - 'https://mirror.bardia.tech/ctan/' => 1, }, 'Japan' => { 'http://ring.airnet.ne.jp/archives/text/CTAN/' => 1, @@ -63,6 +62,9 @@ $mirrors = { 'Singapore' => { 'https://download.nus.edu.sg/mirror/ctan/' => 1, }, + 'Taiwan' => { + 'https://ftp.ntou.edu.tw/ctan/' => 1, + }, 'Thailand' => { 'https://mirror.kku.ac.th/CTAN/' => 1, }, diff --git a/systems/texlive/tlnet/tlpkg/texlive.tlpdb b/systems/texlive/tlnet/tlpkg/texlive.tlpdb index af80a03157..c350becd8d 100644 --- a/systems/texlive/tlnet/tlpkg/texlive.tlpdb +++ b/systems/texlive/tlnet/tlpkg/texlive.tlpdb @@ -26,7 +26,7 @@ depend container_split_src_files/1 depend frozen/0 depend minrelease/2016 depend release/2021 -depend revision/62361 +depend revision/62383 name 00texlive.image category TLCore @@ -4539,7 +4539,7 @@ depend setting_available_architectures:aarch64-linux amd64-freebsd amd64-netbsd name 00texlive.installer category TLCore -revision 62336 +revision 62363 shortdesc TeX Live standalone installer package longdesc This package defines the files to go into the installer longdesc archives (install-tl-unx.tar.gz, install-tl.zip) built by the @@ -39193,17 +39193,18 @@ catalogue-version 0.0.1 name biblatex-software category Package -revision 57366 +revision 62372 shortdesc BibLaTeX stylefiles for software products relocated 1 longdesc This package implements software entry types for BibLaTeX in longdesc the form of a bibliography style extension. It requires the longdesc Biber backend. -containersize 3424 -containerchecksum 25c2a7ebf41761d3b2b7b2dce0f754073d8808b6bf7bd413fbb10aedc465de543431fb297914236c51546b362b9215423e94f9464c5e071d24c6f7b9064e6b1d -doccontainersize 312212 -doccontainerchecksum 5b9671e77ed59b57724a7682ad3b23f7403d4fbc31387443e5adcc170f3aac4ea288454263c091ef71530f3ae7c5b458e48065de9c7f66182b036a9db9119ed9 -docfiles size=92 +containersize 3540 +containerchecksum fb8ddc8a678724558ad01a50bf7808f8a58fa80f1a9c4818b363e65d2b2f7ac1127de4b62bed313430581417987f1ccff095e4eebad868b532b523755e2540bd +doccontainersize 314620 +doccontainerchecksum 84503fbe1152b53520cdf1204c86406e9daba9ee4c348688fbb08f4a8de18da1edd6e7d41e4a1261a3d2be8542ae750cc489a3363ea5470b4cd0aadc4f046323 +docfiles size=95 + RELOC/doc/latex/biblatex-software/Changes RELOC/doc/latex/biblatex-software/LICENSE RELOC/doc/latex/biblatex-software/README.md details="Readme" RELOC/doc/latex/biblatex-software/biblio.bib @@ -39218,8 +39219,8 @@ docfiles size=92 RELOC/doc/latex/biblatex-software/software-biblatex.tex RELOC/doc/latex/biblatex-software/stublist RELOC/doc/latex/biblatex-software/swentries.tex -srccontainersize 1160 -srccontainerchecksum e3ed4c9292271223c084bb66913a6c4c7a27774cf2590e63820a40efe36cfb53e452e45d5b2d0d73390a42d51c38a51a84f8894d24685026731dfe6e34b6f6ce +srccontainersize 1164 +srccontainerchecksum 5ac10388ace19d5e808f6cc94cc800a43030b8386a16516eb5df94741381976a5bebbb239b65d9eb2cfe80e2494b0d3c7c3123872ff6ea65143f77fe731d70b2 srcfiles size=1 RELOC/source/latex/biblatex-software/Makefile runfiles size=7 @@ -39233,7 +39234,7 @@ catalogue-contact-repository https://gitlab.inria.fr/gt-sw-citation/bibtex-sw-en catalogue-ctan /macros/latex/contrib/biblatex-contrib/biblatex-software catalogue-license lppl1.3 catalogue-topics biblatex -catalogue-version 1.2-3 +catalogue-version 1.2-4 name biblatex-source-division category Package @@ -217235,7 +217236,7 @@ catalogue-version 1.0 name newtx category Package -revision 61581 +revision 62370 shortdesc Alternative uses of the TX fonts, with improved metrics relocated 1 longdesc The bundle splits txfonts.sty (from the TX fonts distribution) @@ -217250,11 +217251,11 @@ longdesc garamondx package, thus offering a garamond-alike longdesc text-with-maths combination. depend kastrup execute addMap newtx.map -containersize 6408360 -containerchecksum 7e7bf18d36ab9b4769e033a0654d3e2ff2d11beb11a16a9bd6ab3203e7cafbfe9632cefb157c70e6b6ae85221f930c48e935e1c4ca5351757245780e26ceab54 -doccontainersize 631452 -doccontainerchecksum 24f58169ea7262cc87a397637a7f580fdf68126c367b5e0519a83c0f1f45f80558f651fbaa68b9951057d668e0c16cf75c7e3d3ee7db06be779d3f9a33edcd40 -docfiles size=225 +containersize 6414664 +containerchecksum 422176ee7322b2c98064aa10d367f812b240f2d9d440bc1ef1339b25429bfc398093974ba511e9e6cbec01f13e8841ad6a6b7372b5199b4b1c2b367d11f657d5 +doccontainersize 639876 +doccontainerchecksum db0725c233d0f135b434cf8690c87d9b433c52e80aca8e0f62b873438028d8793660e934f97b255ffa67cff75751a9635487ef3d4a086a0bbcdc8746bccfb2f4 +docfiles size=231 RELOC/doc/fonts/newtx/MANIFEST-newtx.txt RELOC/doc/fonts/newtx/README details="Readme" RELOC/doc/fonts/newtx/implementation.pdf details="Implementation notes" @@ -217269,7 +217270,7 @@ docfiles size=225 RELOC/doc/fonts/newtx/sample-ntx-crop.pdf RELOC/doc/fonts/newtx/sample-ptmx-crop.pdf RELOC/doc/fonts/newtx/sample-tx-crop.pdf -runfiles size=4494 +runfiles size=4512 RELOC/fonts/afm/public/newtx/LibertineI-5nu.afm RELOC/fonts/afm/public/newtx/LibertineMathBMI.afm RELOC/fonts/afm/public/newtx/LibertineMathBMI5.afm @@ -218150,7 +218151,9 @@ runfiles size=4494 RELOC/tex/latex/newtx/TeXGyreTermesX.fontspec RELOC/tex/latex/newtx/lmsntxsy.fd RELOC/tex/latex/newtx/lmxntxexx.fd + RELOC/tex/latex/newtx/ly1minebgaramond.fd RELOC/tex/latex/newtx/ly1minlibertine.fd + RELOC/tex/latex/newtx/ly1minntx.fd RELOC/tex/latex/newtx/ly1ntxdnom.fd RELOC/tex/latex/newtx/ly1ntxinf.fd RELOC/tex/latex/newtx/ly1ntxlf.fd @@ -218176,7 +218179,9 @@ runfiles size=4494 RELOC/tex/latex/newtx/omlzbvmi.fd RELOC/tex/latex/newtx/omlzmnmi.fd RELOC/tex/latex/newtx/omlzutmi.fd + RELOC/tex/latex/newtx/ot1minebgaramond.fd RELOC/tex/latex/newtx/ot1minlibertine.fd + RELOC/tex/latex/newtx/ot1minntx.fd RELOC/tex/latex/newtx/ot1ntxdnom.fd RELOC/tex/latex/newtx/ot1ntxinf.fd RELOC/tex/latex/newtx/ot1ntxlf.fd @@ -218190,7 +218195,9 @@ runfiles size=4494 RELOC/tex/latex/newtx/ot1ntxtosf.fd RELOC/tex/latex/newtx/ot1ntxtt.fd RELOC/tex/latex/newtx/t1fxl1.fd + RELOC/tex/latex/newtx/t1minebgaramond.fd RELOC/tex/latex/newtx/t1minlibertine.fd + RELOC/tex/latex/newtx/t1minntx.fd RELOC/tex/latex/newtx/t1ntxdnom.fd RELOC/tex/latex/newtx/t1ntxinf.fd RELOC/tex/latex/newtx/t1ntxlf.fd @@ -218219,7 +218226,7 @@ catalogue-also minion2newtx catalogue-ctan /fonts/newtx catalogue-license lppl1.3 catalogue-topics font font-body font-maths font-serif font-proportional font-type1 font-otf font-supp font-t1enc -catalogue-version 1.705 +catalogue-version 1.71 name newtxsf category Package @@ -238051,21 +238058,21 @@ binfiles arch=x86_64-solaris size=1 name penlight category Package -revision 62255 +revision 62374 shortdesc Penlight Lua libraries made available to LuaLaTeX users relocated 1 longdesc This LuaLaTeX package provides a wrapper to use the penlight longdesc Lua libraries with LuaLaTeX, with some extra functionality longdesc added. -containersize 105380 -containerchecksum 1bd82e613fe994f246d3bfab1311f74bfb93bbcde353dcedd0eb8dc5dcb2d279213ab885bdee47855720a0f5025ad6b3bdeec284313da9efe0cdc17925ac2701 -doccontainersize 34912 -doccontainerchecksum 29a48f688b586a02b64d322022c077db861b523764fba7e67bca6b8a053b9cebdc8eee76d65540db7c4ed8a463845061d99f919375be28a65a06ad646404e4fc +containersize 105768 +containerchecksum fc4b4f0f3d2e45bced19ff64c8e970e8da67dda498c99b69914a01dc91a26aea8518e21439cfcdf02aff2034d98d250f8d31c9444484a0a981730ace01af7c06 +doccontainersize 35004 +doccontainerchecksum 20ae20a2932a9d72fbc4cc591e935c0f9c06bd10d5ec8e9a7d2647a0a05dd951834511e135a96349b39050724cc7b5b9b95db6b4f9161334f41082bb803f4cfe docfiles size=13 RELOC/doc/luatex/penlight/README.md details="Readme" RELOC/doc/luatex/penlight/penlight.pdf details="Package documentation" RELOC/doc/luatex/penlight/penlight.tex -runfiles size=109 +runfiles size=110 RELOC/tex/luatex/penlight/penlight.lua RELOC/tex/luatex/penlight/penlight.sty RELOC/tex/luatex/penlight/penlightextras.lua @@ -298830,7 +298837,7 @@ binfiles arch=x86_64-solaris size=1 name texdoc category TLCore -revision 59283 +revision 62380 shortdesc Documentation access for TeX Live longdesc texdoc is a Lua script providing easy access to the longdesc documentation in TeX Live: PDF, DVI, plain text files, and @@ -298840,10 +298847,10 @@ longdesc program by the same name to do the same job, but its longdesc implementation is unrelated. depend kpathsea depend texdoc.ARCH -containersize 26932 -containerchecksum 1504bbeb86a1329632fad25b98b967bad8c68fe8249f1ac9f4c017a50fc1c79994f58f3545681741213fe28d94b568bf4afb8b2010e93198a7df2c75bc3cebeb -doccontainersize 135656 -doccontainerchecksum bb79a2cf6c9a013a9b3c4c11597f86617043c8abea84b86f11a9ad5093655d68e0ce8d04e59b077f832c513c25e407d9ec06bdc412c3427d9ec43bb5103ea42e +containersize 27488 +containerchecksum 83551289e923ecf13ffbd27d950d4fb8026d06d2600160fea6d397d5fbbdf2deb80ca8f0286bd022308910fd0b5ee00f235598324453a3cd4eab7b6956a34958 +doccontainersize 135720 +doccontainerchecksum 5c8ea335b2b1d1c7829653a1ca0df3eb3a5f75f808d8bc2b2a8177f01d8d317e76f536cb6b55471cc4076c2938ae01623185a90033bd453b94134ba35a9a0062 docfiles size=53 texmf-dist/doc/man/man1/texdoc.1 texmf-dist/doc/man/man1/texdoc.man1.pdf @@ -298853,7 +298860,7 @@ docfiles size=53 texmf-dist/doc/support/texdoc/texdoc-doc.cls texmf-dist/doc/support/texdoc/texdoc.pdf details="Package documentation" texmf-dist/doc/support/texdoc/texdoc.tex -runfiles size=30 +runfiles size=31 texmf-dist/scripts/texdoc/texdoc.tlu texmf-dist/scripts/texdoc/texdoclib-alias.tlu texmf-dist/scripts/texdoc/texdoclib-cli.tlu @@ -298873,7 +298880,7 @@ catalogue-contact-support https://lists.tug.org/texdoc catalogue-ctan /support/texdoc catalogue-license gpl catalogue-topics view-doc -catalogue-version 3.3.1 +catalogue-version 3.4 name texdoc.aarch64-linux category TLCore @@ -299785,7 +299792,7 @@ docfiles size=376 name texlive-scripts category TLCore -revision 62336 +revision 62363 shortdesc TeX Live infrastructure programs longdesc Includes install-tl, tl-portable, rungs, etc.; not needed for longdesc tlmgr to run but still ours. Not included in tlcritical. @@ -299793,10 +299800,10 @@ depend texlive-scripts.ARCH depend texlive.infra execute addMap mathpple.map postaction shortcut type=menu name="TeX Live command-line" cmd=TEXDIR/tlpkg/installer/tl-cmd.bat -containersize 108776 -containerchecksum 12b67b6e9fe969cbd44ff735361594277aee0c482768819fab39e4cb8b375828bcedbb908b71e46716d4401ff9efad700e3130afe3d9ad7cc87f63cc3c3af35f -doccontainersize 404068 -doccontainerchecksum 0edf24111b13e0a131c5217fd699cf546549ed02b92bd32fc0bbb114f871306038327c50b7ced1dd2ee75bcbffac613c000a4b411d8a0a28a975d5d648dc6b5a +containersize 108784 +containerchecksum 5e0cfb63d80cc1cd9bd247a75e3e0f79569ed18ac9e332b7a47360e8135ab28c424bded67b6ff825fdf57aeee28e8439d2474ae8efe1df4a185c6e5cd011499f +doccontainersize 404064 +doccontainerchecksum f54911a8fcb49ac906e75d1c359b8dcb6f4b672b3644b191f0d35a4f3ba896589373521ae68b32150a41fb1e5e7a4a02d3f9227a2cfdcc52aacc08e0229690ec docfiles size=502 doc.html texmf-dist/doc/man/man1/fmtutil-sys.1 @@ -317589,7 +317596,7 @@ catalogue-version 0.03 name ucharclasses category Package -revision 58029 +revision 62378 shortdesc Font actions in XeTeX according to what is being processed relocated 1 longdesc The package takes care of switching fonts when you switch from @@ -317597,10 +317604,10 @@ longdesc one Unicode block to another in the text of a document. This longdesc way, you can write a document with no explicit font selection, longdesc but a series of rules of the form "when entering block ..., longdesc switch font to use ...". -containersize 8772 -containerchecksum 2b4a160c145fa6e4d73be4f0590d73a302655bf4274822219c5b41e145a8dc5076b3b8bf39dda488a5cec80329290db6f3dce431733ed8b4b9c59bd22a0187d5 -doccontainersize 142052 -doccontainerchecksum 4d715b69d34dd6a2eb485aa4098e51f2f72213ba5972bb51bb0fd60bbdbc3db5846f87c859d77e694b2d55be4475bdabf3bb507020480f68f7b5f3884dd3382c +containersize 8928 +containerchecksum 07dfeeefbb785bf8adfd8487e8ab607ce8d3a40b44994c8a989cf273d7dca866418e8ed175141dcce2b0e37e2611580c94e50027f5a727369f776097e4ac6eac +doccontainersize 143332 +doccontainerchecksum 3286668974165c8afe477b71cb136e6ecff7269df27d93cbb1ad5f923d891575f5abad1a60bd63967cee991cba3592acdf9b280f04b6e0db983d53ecfa6e26b4 docfiles size=42 RELOC/doc/xelatex/ucharclasses/README details="Readme" RELOC/doc/xelatex/ucharclasses/ucharclasses.pdf details="Package documentation" @@ -317615,7 +317622,7 @@ catalogue-contact-support https://github.com/Pomax/ucharclasses/issues catalogue-ctan /macros/xetex/latex/ucharclasses catalogue-license pd catalogue-topics xetex font-supp -catalogue-version 2.4 +catalogue-version 2.5 name ucs category Package @@ -341079,15 +341086,15 @@ catalogue-version 1.1 name yamlvars category Package -revision 62176 +revision 62376 shortdesc A YAML parser and tool for easy LaTeX definition creation relocated 1 longdesc This LuaLaTeX package provides a YAML parser and some functions longdesc to declare and define LaTeX definitions using YAML files. -containersize 5072 -containerchecksum 8f3dcee513796ec56dfa61d7f5f05ece6b851de7ac1f2ad311425ea863880e513f3c264a7828d02cbd9b55c76fae94a86785d17a7c312b0bbc4dc76b484fa661 -doccontainersize 65536 -doccontainerchecksum 15757be1037952d3ac2a172f530b74c858b3d5aaa3c42c02427978d05d89790ec8c9511a8bcc7847895222b09bb485a80006fde1715953ef4f3d7f8ddafcc300 +containersize 4956 +containerchecksum 0fcc1e1863db3412718e136d4ab08cc2c5b4ea7e88bc4164bb0bb165011f39c6c10a33e099f676421644448aef1ccddd4451a5375cb84d3c90e2227a6447e5a7 +doccontainersize 65520 +doccontainerchecksum 1df59fd4278feee321a1cb52aa52d3daace9ace7788bad9bf75094342f6505b30b9c9de3ec16ef3e1db640dfa6cb770902f80f0f2d9f356810b69d74221de8fb docfiles size=22 RELOC/doc/lualatex/yamlvars/README.md details="Readme" RELOC/doc/lualatex/yamlvars/yamlvars.pdf details="Package documentation" diff --git a/systems/texlive/tlnet/tlpkg/texlive.tlpdb.md5 b/systems/texlive/tlnet/tlpkg/texlive.tlpdb.md5 index 8784df926b..710ebad8a2 100644 --- a/systems/texlive/tlnet/tlpkg/texlive.tlpdb.md5 +++ b/systems/texlive/tlnet/tlpkg/texlive.tlpdb.md5 @@ -1 +1 @@ -b1df018a45f3bd56c5d03d247e18a7c1 texlive.tlpdb +c978f644b6a45bf31cbdf4c8ff6cc2c9 texlive.tlpdb diff --git a/systems/texlive/tlnet/tlpkg/texlive.tlpdb.sha512 b/systems/texlive/tlnet/tlpkg/texlive.tlpdb.sha512 index 977502760e..c9bfb14639 100644 --- a/systems/texlive/tlnet/tlpkg/texlive.tlpdb.sha512 +++ b/systems/texlive/tlnet/tlpkg/texlive.tlpdb.sha512 @@ -1 +1 @@ -da0ccb9e814fb41055267a89b091a4545151f82cc8993a8b409cea898f3e12f84f43f19b618800d9ee48d9a7a396401f21831ffa90474b3bc0b7ad18fc4e9212 texlive.tlpdb +f139088d3495f1e9600517b647d5cd02e821be3765eb2e35a31e9b75f9a8c0edbd62165475d50d329ab3395ee65547fa9eeba927b106d8066d9b2954b321c31d texlive.tlpdb diff --git a/systems/texlive/tlnet/tlpkg/texlive.tlpdb.sha512.asc b/systems/texlive/tlnet/tlpkg/texlive.tlpdb.sha512.asc index dab1319c94..0f40ae6f6a 100644 --- a/systems/texlive/tlnet/tlpkg/texlive.tlpdb.sha512.asc +++ b/systems/texlive/tlnet/tlpkg/texlive.tlpdb.sha512.asc @@ -1,10 +1,10 @@ -----BEGIN PGP SIGNATURE----- -iQEcBAEBCgAGBQJiICiTAAoJEEzhh34ZQ4xwmrAIALTBBtiWdfWkui0k/A7UzMwv -9AH2soRspuWHJulFpRUdLiRjOYDuMCUfqfJb4XW0zGdTqvbxRf75P9o+1JnJLfg2 -rk0QEDJb9jUgjB5tqhjnwm1OGGltpmiOhkNt8WhlMJBXcJKhGIECB8OwZL+yVoTh -IckAK9IvG8xI1RgR6oTd7IgVMdR3C1KpZ/WreSKpi5gtsiFcIOQNp0/NrW5yVLyw -88mC1i1PSVfgLqsktIbfno/XuzeTXUgYQJP4OYTngZSapDBjNjMOdjP7atJUXv3q -UsYm8JohZw/bFAUVuIO+uIpU24VCwEr9tX6gGmxvu17hHrnI8BLkWG3WJSpw6wI= -=MAI9 +iQEcBAEBCgAGBQJiIXo1AAoJEEzhh34ZQ4xwKYEH/025cHH2HBBxdbUFg0CNVHX2 +J+xLCwzzsjw7E/ZiKpnBavOKJUv6b2tC9GB41WoOi1z86bKCDgixjhVQJ1jqGutw +ufYEQmtqpg+nJGP6ehFO1HQF58CT76YU+3AwIcu+4RA5tGudWbtGZNQRGZ+WK4OX +yaGA4DvFniR1KXs57DzGTtz0ca8PRIi7UeLkZJ3fsvaxKBb1tTRBeJVDR62M0X3s +/SG/c5/m4F5LWDCQDWwSmO29uGgnqdxMIq2k1rOvFML2yAbo7sew5gdx3ASPj8Mt +c2ktNvOZkKuhj+W6QbJgTn8C/KC429HGCNWBz90tUICV7CJSLWTpxNfHA1DIiNw= +=c54N -----END PGP SIGNATURE----- diff --git a/systems/texlive/tlnet/tlpkg/texlive.tlpdb.xz b/systems/texlive/tlnet/tlpkg/texlive.tlpdb.xz Binary files differindex b86ff80b7e..978a725bfc 100644 --- a/systems/texlive/tlnet/tlpkg/texlive.tlpdb.xz +++ b/systems/texlive/tlnet/tlpkg/texlive.tlpdb.xz diff --git a/systems/win32/miktex/tm/packages/next/pr.ini b/systems/win32/miktex/tm/packages/next/pr.ini index 1b646a8234..c0ed798044 100644 --- a/systems/win32/miktex/tm/packages/next/pr.ini +++ b/systems/win32/miktex/tm/packages/next/pr.ini @@ -1,13 +1,13 @@ [repository]
-date=1646342248
+date=1646428640
lastupd=miktex-arctrl-bin-2.9 miktex-arctrl-bin-x64-2.9 miktex-asymptote-bin-2.9 miktex-asymptote-bin-x64-2.9 miktex-autosp-bin-2.9 miktex-autosp-bin-x64-2.9 miktex-axohelp-bin-2.9 miktex-axohelp-bin-x64-2.9 miktex-bibarts-bin-2.9 miktex-bibarts-bin-x64-2.9 miktex-bibtex-bin-2.9 miktex-bibtex-bin-x64-2.9 miktex-bibtex8bit-bin-2.9 miktex-bibtex8bit-bin-x64-2.9 miktex-bzip2-bin-2.9 miktex-bzip2-bin-x64-2.9 miktex-cairo-bin-2.9 miktex-cairo-bin-x64-2.9 miktex-chktex-bin-2.9 miktex-chktex-bin-x64-2.9
-lstdigest=360de18e7c9d21e89c35fcffb910ab0a
+lstdigest=9ff1798c4b92df32fca2e9d4eefc4d7b
numpkg=5396
relstate=next
-version=8097
+version=8098
;;;;This configuration file is signed by a MiKTeX maintainer. The signature follows.
;;;;-----BEGIN MIKTEX SIGNATURE-----
-;;;; signature/miktex: mEztrIOPuB3BqpLmNeMrXRiYZA8+Pgc2cSYi9DfyCgI9I11/wZFovA2WZG9FybioWpMCL7FOWhSungdfDdpT2fGz1vDSXPl3h0dIOdvizgBSI8k+C0wsNGpM2B6uzidRISRw1/G3rVGhML7EUsjxlyP2K5YsQ5w1ikBEfjqUEp8NfPHNlzdrux3gMUpIDSdvOBBB8BJYOhL+UJ6slvxNc/wz+LDDGW1LshzkrR7x8slkLUOdVfUJmAKje6cFLUkyOuyEZFvJGtTPnWBxmMpnGyqN0Ieozt35ETXOaGBUdvLzqgil5m86JLgsQfG5dLEkGCSZ3Th7K+Z8HPDwaA1xoQ==
+;;;; signature/miktex: hVDkIf+qO4sCLqlLwdobeKaYcalED1hLah+tRUhzgdtNYW2JxdkP6s5h4VfljXIo0MVagPPNQEv+TLgm+/dFoqEHJOM7Nt4ttnAtJp8TWkg6m3BQFIa+FnqVi/9WYc/ZXzVx/mtU/OA2KDYE0UtP0x/y+9KPKz7WQPIks+UxEVgu+rl1Qkh2DLmL0c2QYX4VjaOmeUawieuBBEe6War9X/N8cUgCgs4UOGZxBFe58CXm/CrdwbCvaoGyG7uY6A65teq6cFcVVOGQVY7j+jT/FJdUsvXRf7ClRAD946uwj0TnXFfqhtLtgnvIz1gNcXx8neUN397j12QIAz0B4H/BFg==
;;;;-----END MIKTEX SIGNATURE-----
diff --git a/systems/win32/miktex/tm/packages/pr.ini b/systems/win32/miktex/tm/packages/pr.ini index 0c38d88cc3..c1303a9acd 100644 --- a/systems/win32/miktex/tm/packages/pr.ini +++ b/systems/win32/miktex/tm/packages/pr.ini @@ -1,13 +1,13 @@ [repository]
-date=1646341893
+date=1646428286
lastupd=andika andika__doc animate animate__doc animate__source beamertheme-focus beamertheme-focus__doc beamertheme-focus__source bfh-ci bfh-ci__doc biblatex-mla biblatex-mla__doc biblatex-mla__source bidi bidi__doc bidi__source caption caption__doc caption__source crefthe
-lstdigest=6716f96c257904ceba5508e62cc613d5
+lstdigest=b7c73dff6a3a7e25bb3589e35070ee3a
numpkg=5394
relstate=stable
-version=8097
+version=8098
;;;;This configuration file is signed by a MiKTeX maintainer. The signature follows.
;;;;-----BEGIN MIKTEX SIGNATURE-----
-;;;; signature/miktex: ceIz8Mzm/rS4q8XMkgKPDbgpWq8uqDIbVf5CHfdJE7hs4dah3AUM+uHBq53Wq7oZEZMEoecTQY/4nBVx4Yhf+n6XjItbosQCoKjzawZcMLHNdiBQfHfmm8zpDJc3Gg4EnBjQC6PBerJX7H4lT1PCHV0Pi7BTL58fuqkfNOY9/TG3sQ1FH55vLjJJtVJHVW0hb26df45A8BPQ6HYqKedMVyjH9/BNfq3fnY62FcTpjfUz8ZgRWDrF8TJ4CNCv8Std/mxcxfNUJeVb9hctBK9IrkfZJZ2jAKtZDtiGGunJ77DbBXz7CHsx3EHH7tyuiJjROjaOzRNLP+xw7eN9fGXvzw==
+;;;; signature/miktex: uoOI5itZDPL8TQdM2FegtXT6g40naQvPpY5oIbC6c1Oq4aecRQTNp7azV5e5IL6ZkGCeF10rWuoZL0m3KPMBAXkf8/0nV7TZHFpzYxo7Di91F0tmSLFkFQkh+ObYuaWjlU6DjVhmUHVOxKjjowEs5SeJWG7tWqOR1oPTJsUymplNJ1s6I96JhfWvTMQ88O12/e2zfI5S1Y7R4sLj3t77Vz03lGa0J9Hn2qSQvzX/KS+sG3pxxR+NoDGuBMCLrt2BXTHBVcdaq+uewSQRJsa2XMZi6298UZ3upjqBeK58PKvSCdLgWPnFRxernEuDEn0D37puwulNboiTCk7YvYfLlw==
;;;;-----END MIKTEX SIGNATURE-----
|