diff options
author | Karl Berry <karl@freefriends.org> | 2022-03-04 16:00:29 +0000 |
---|---|---|
committer | Karl Berry <karl@freefriends.org> | 2022-03-04 16:00:29 +0000 |
commit | 5027858830867ff20c7eca53eed6f8b798c5ad9c (patch) | |
tree | 842f07fed6d88920a1bcdc035157bb20e17e7904 /Master | |
parent | f23f3a09677e44ad094dcf2aa3ac0c3dc3893238 (diff) |
2022 doc (+sync) update
git-svn-id: svn://tug.org/texlive/trunk@62387 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master')
180 files changed, 5748 insertions, 5558 deletions
diff --git a/Master/texmf-dist/doc/dvipng/dvipng.html b/Master/texmf-dist/doc/dvipng/dvipng.html index 9ca5f52f442..3c444c6f204 100644 --- a/Master/texmf-dist/doc/dvipng/dvipng.html +++ b/Master/texmf-dist/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/Master/texmf-dist/doc/dvipng/dvipng.pdf b/Master/texmf-dist/doc/dvipng/dvipng.pdf Binary files differindex c92d4407a32..028cd521cf1 100644 --- a/Master/texmf-dist/doc/dvipng/dvipng.pdf +++ b/Master/texmf-dist/doc/dvipng/dvipng.pdf diff --git a/Master/texmf-dist/doc/dvips/dvips.html b/Master/texmf-dist/doc/dvips/dvips.html index da5842dfc30..30e59aef42e 100644 --- a/Master/texmf-dist/doc/dvips/dvips.html +++ b/Master/texmf-dist/doc/dvips/dvips.html @@ -1,11 +1,11 @@ <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd"> <html> -<!-- This manual documents Dvips version 2021.1 -(February 2021), a program to translate a DVI file into -PostScript. You may freely use, modify and/or distribute this file. --> -<!-- Created by GNU Texinfo 6.7, http://www.gnu.org/software/texinfo/ --> +<!-- Created by GNU Texinfo 6.8, https://www.gnu.org/software/texinfo/ --> <head> <meta http-equiv="Content-Type" content="text/html; charset=utf-8"> +<!-- This manual documents Dvips version 2022.1 +(January 2022), a program to translate a DVI file into +PostScript. You may freely use, modify and/or distribute this file. --> <title>Dvips: A DVI-to-PostScript translator</title> <meta name="description" content="Dvips: A DVI-to-PostScript translator"> @@ -13,17 +13,20 @@ PostScript. You may freely use, modify and/or distribute this file. --> <meta name="resource-type" content="document"> <meta name="distribution" content="global"> <meta name="Generator" content="makeinfo"> +<meta name="viewport" content="width=device-width,initial-scale=1"> + <link href="#Top" rel="start" title="Top"> <link href="#Index" rel="index" title="Index"> <link href="#SEC_Contents" rel="contents" title="Table of Contents"> <link href="http://tug.org/texinfohtml" rel="up" title="(dir)"> +<link href="#Why-Dvips" rel="next" title="Why Dvips"> <style type="text/css"> <!-- +a.copiable-anchor {visibility: hidden; text-decoration: none; line-height: 0em} a.summary-letter {text-decoration: none} blockquote.indentedblock {margin-right: 0em} div.display {margin-left: 3.2em} div.example {margin-left: 3.2em} -div.lisp {margin-left: 3.2em} kbd {font-style: oblique} pre.display {font-family: inherit} pre.format {font-family: inherit} @@ -32,6 +35,7 @@ pre.menu-preformatted {font-family: serif} span.nolinebreak {white-space: nowrap} span.roman {font-family: initial; font-weight: normal} span.sansserif {font-family: sans-serif; font-weight: normal} +span:hover a.copiable-anchor {visibility: visible} ul.no-bullet {list-style: none} --> </style> @@ -48,23 +52,21 @@ ul.no-bullet {list-style: none} -<span id="SEC_Overview"></span> -<h2 class="shortcontents-heading">Short Table of Contents</h2> -<div class="shortcontents"> -<ul class="no-bullet"> -<li><a id="stoc-Why-use-Dvips_003f" href="#toc-Why-use-Dvips_003f">1 Why use Dvips?</a></li> -<li><a id="stoc-Installation-1" href="#toc-Installation-1">2 Installation</a></li> -<li><a id="stoc-Invoking-Dvips-1" href="#toc-Invoking-Dvips-1">3 Invoking Dvips</a></li> -<li><a id="stoc-Paper-size-and-landscape-orientation" href="#toc-Paper-size-and-landscape-orientation">4 Paper size and landscape orientation</a></li> -<li><a id="stoc-Interaction-with-PostScript-1" href="#toc-Interaction-with-PostScript-1">5 Interaction with PostScript</a></li> -<li><a id="stoc-PostScript-fonts-1" href="#toc-PostScript-fonts-1">6 PostScript fonts</a></li> -<li><a id="stoc-Color-1" href="#toc-Color-1">7 Color</a></li> -<li><a id="stoc-Index-1" href="#toc-Index-1" rel="index">Index</a></li> -</ul> +<div class="top" id="Top"> +<div class="header"> +<p> +Next: <a href="#Why-Dvips" accesskey="n" rel="next">Why use Dvips?</a>, Up: <a href="http://tug.org/texinfohtml" accesskey="u" rel="up">(dir)</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> </div> +<span id="Dvips"></span><h1 class="top">Dvips</h1> + +<p>This manual documents Dvips version 2022.1 +(January 2022), a program to translate a DVI file into +PostScript. You may freely use, modify and/or distribute this file. +</p> + -<span id="SEC_Contents"></span> +<div class="Contents_element" id="SEC_Contents"> <h2 class="contents-heading">Table of Contents</h2> <div class="contents"> @@ -185,42 +187,28 @@ ul.no-bullet {list-style: none} <li><a id="toc-Index-1" href="#Index" rel="index">Index</a></li> </ul> </div> - - -<span id="Top"></span><div class="header"> -<p> -Next: <a href="#Why-Dvips" accesskey="n" rel="next">Why Dvips</a>, Up: <a href="http://tug.org/texinfohtml" accesskey="u" rel="up">(dir)</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> </div> -<span id="Dvips"></span><h1 class="top">Dvips</h1> - -<p>This manual documents Dvips version 2021.1 -(February 2021), a program to translate a DVI file into -PostScript. You may freely use, modify and/or distribute this file. -</p> -<table class="menu" border="0" cellspacing="0"> -<tr><td align="left" valign="top">• <a href="#Why-Dvips" accesskey="1">Why Dvips</a></td><td> </td><td align="left" valign="top">Why use Dvips? -</td></tr> -<tr><td align="left" valign="top">• <a href="#Installation" accesskey="2">Installation</a></td><td> </td><td align="left" valign="top">How to compile and install Dvips. -</td></tr> -<tr><td align="left" valign="top">• <a href="#Invoking-Dvips" accesskey="3">Invoking Dvips</a></td><td> </td><td align="left" valign="top">Command-line options, configuration files, etc. -</td></tr> -<tr><td align="left" valign="top">• <a href="#Paper-size-and-landscape" accesskey="4">Paper size and landscape</a></td><td> </td><td align="left" valign="top">Changing the paper dimensions. -</td></tr> -<tr><td align="left" valign="top">• <a href="#Interaction-with-PostScript" accesskey="5">Interaction with PostScript</a></td><td> </td><td align="left" valign="top">TeX meets Dvips meets PostScript. -</td></tr> -<tr><td align="left" valign="top">• <a href="#PostScript-fonts" accesskey="6">PostScript fonts</a></td><td> </td><td align="left" valign="top">Installing and using PostScript fonts. -</td></tr> -<tr><td align="left" valign="top">• <a href="#Color" accesskey="7">Color</a></td><td> </td><td align="left" valign="top">Using color with Dvips. -</td></tr> -<tr><td align="left" valign="top">• <a href="#Index" rel="index" accesskey="8">Index</a></td><td> </td><td align="left" valign="top">General index. -</td></tr> -</table> - +<div class="Overview_element" id="SEC_Overview"> +<h2 class="shortcontents-heading">Short Table of Contents</h2> +<div class="shortcontents"> +<ul class="no-bullet"> +<li><a id="stoc-Why-use-Dvips_003f" href="#toc-Why-use-Dvips_003f">1 Why use Dvips?</a></li> +<li><a id="stoc-Installation-1" href="#toc-Installation-1">2 Installation</a></li> +<li><a id="stoc-Invoking-Dvips-1" href="#toc-Invoking-Dvips-1">3 Invoking Dvips</a></li> +<li><a id="stoc-Paper-size-and-landscape-orientation" href="#toc-Paper-size-and-landscape-orientation">4 Paper size and landscape orientation</a></li> +<li><a id="stoc-Interaction-with-PostScript-1" href="#toc-Interaction-with-PostScript-1">5 Interaction with PostScript</a></li> +<li><a id="stoc-PostScript-fonts-1" href="#toc-PostScript-fonts-1">6 PostScript fonts</a></li> +<li><a id="stoc-Color-1" href="#toc-Color-1">7 Color</a></li> +<li><a id="stoc-Index-1" href="#toc-Index-1" rel="index">Index</a></li> +</ul> +</div> +</div> <hr> -<span id="Why-Dvips"></span><div class="header"> +<div class="chapter" id="Why-Dvips"> +<div class="header"> <p> -Next: <a href="#Installation" accesskey="n" rel="next">Installation</a>, Previous: <a href="#Top" accesskey="p" rel="prev">Top</a>, Up: <a href="#Top" accesskey="u" rel="up">Top</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> +Next: <a href="#Installation" accesskey="n" rel="next">Installation</a>, Previous: <a href="#Top" accesskey="p" rel="prev">Dvips</a>, Up: <a href="#Top" accesskey="u" rel="up">Dvips</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> </div> <span id="Why-use-Dvips_003f"></span><h2 class="chapter">1 Why use Dvips?</h2> @@ -276,9 +264,11 @@ structure of the program. </p> <hr> -<span id="Installation"></span><div class="header"> +</div> +<div class="chapter" id="Installation"> +<div class="header"> <p> -Next: <a href="#Invoking-Dvips" accesskey="n" rel="next">Invoking Dvips</a>, Previous: <a href="#Why-Dvips" accesskey="p" rel="prev">Why Dvips</a>, Up: <a href="#Top" accesskey="u" rel="up">Top</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> +Next: <a href="#Invoking-Dvips" accesskey="n" rel="next">Invoking Dvips</a>, Previous: <a href="#Why-Dvips" accesskey="p" rel="prev">Why use Dvips?</a>, Up: <a href="#Top" accesskey="u" rel="up">Dvips</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> </div> <span id="Installation-1"></span><h2 class="chapter">2 Installation</h2> @@ -289,29 +279,26 @@ Next: <a href="#Invoking-Dvips" accesskey="n" rel="next">Invoking Dvips</a>, Pre <p>Installing Dvips is mostly the same as installing any Kpathsea-using program. Therefore, for the basic steps involved, -see <a href="https://tug.org/texinfohtml/kpathsea.html#Installation">Installation</a> in <cite>Kpathsea</cite>. +see <a data-manual="kpathsea" href="https://tug.org/texinfohtml/kpathsea.html#Installation">Installation</a> in <cite>Kpathsea</cite>. </p> <p>For solutions to common installation problems and information on how to -report a bug, see the file <samp>kpathsea/BUGS</samp> (see <a href="https://tug.org/texinfohtml/kpathsea.html#Bugs">Bugs</a> in <cite>Kpathsea</cite>). For solutions to Dvips-specific problems, +report a bug, see the file <samp>kpathsea/BUGS</samp> (see <a data-manual="kpathsea" href="https://tug.org/texinfohtml/kpathsea.html#Bugs">Bugs</a> in <cite>Kpathsea</cite>). For solutions to Dvips-specific problems, see <a href="#Debug-options">Debug options</a>. </p> <p>Dvips does require some additional installation, detailed in the sections below. Also, to configure color devices, see <a href="#Color-device-configuration">Color device configuration</a>. </p> -<table class="menu" border="0" cellspacing="0"> -<tr><td align="left" valign="top">• <a href="#config_002eps-installation" accesskey="1">config.ps installation</a></td><td> </td><td align="left" valign="top">Printer and site Dvips configuration. -</td></tr> -<tr><td align="left" valign="top">• <a href="#PostScript-font-installation" accesskey="2">PostScript font installation</a></td><td> </td><td align="left" valign="top">Many PostScript fonts are freely available. -</td></tr> -<tr><td align="left" valign="top">• <a href="#Ghostscript-installation" accesskey="3">Ghostscript installation</a></td><td> </td><td align="left" valign="top">A free PostScript interpreter. -</td></tr> -<tr><td align="left" valign="top">• <a href="#Diagnosing-problems" accesskey="4">Diagnosing problems</a></td><td> </td><td align="left" valign="top">Some common runtime difficulties. -</td></tr> -</table> +<ul class="section-toc"> +<li><a href="#config_002eps-installation" accesskey="1"><samp>config.ps</samp> installation</a></li> +<li><a href="#PostScript-font-installation" accesskey="2">PostScript font installation</a></li> +<li><a href="#Ghostscript-installation" accesskey="3">Ghostscript installation</a></li> +<li><a href="#Diagnosing-problems" accesskey="4">Diagnosing problems</a></li> +</ul> <hr> -<span id="config_002eps-installation"></span><div class="header"> +<div class="section" id="config_002eps-installation"> +<div class="header"> <p> Next: <a href="#PostScript-font-installation" accesskey="n" rel="next">PostScript font installation</a>, Up: <a href="#Installation" accesskey="u" rel="up">Installation</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> </div> @@ -329,16 +316,16 @@ printer (output device). Since these are site-specific, <code>make install</code> does not create them; you must create them yourself. </p> <p>(These Dvips configuration files are independent of the Kpathsea -configuration file <samp>texmf.cnf</samp> (see <a href="https://tug.org/texinfohtml/kpathsea.html#Config-files">Config files</a> in <cite>Kpathsea</cite>). +configuration file <samp>texmf.cnf</samp> (see <a data-manual="kpathsea" href="https://tug.org/texinfohtml/kpathsea.html#Config-files">Config files</a> in <cite>Kpathsea</cite>). </p> <span id="index-config_002eproto"></span> <span id="index-prototype-printer-configuration-file"></span> <span id="index-printer-configuration-file_002c-prototype"></span> <span id="index-configuration-files_002c-prototype"></span> <p>Dvips configuration files contents and searching are described fully in -<a href="#Config-files">Config files</a>. The simplest way to create a new configuration file +<a href="#Config-files">Dvips configuration files</a>. The simplest way to create a new configuration file is to copy and modify the file <samp>dvipsk/contrib/config.proto</samp>, -seasoning with options to your taste from <a href="#Config-files">Config files</a>. Here is +seasoning with options to your taste from <a href="#Config-files">Dvips configuration files</a>. Here is <samp>config.proto</samp> for your reading pleasure: </p><div class="example"> @@ -395,9 +382,11 @@ Z <hr> -<span id="PostScript-font-installation"></span><div class="header"> +</div> +<div class="section" id="PostScript-font-installation"> +<div class="header"> <p> -Next: <a href="#Ghostscript-installation" accesskey="n" rel="next">Ghostscript installation</a>, Previous: <a href="#config_002eps-installation" accesskey="p" rel="prev">config.ps installation</a>, Up: <a href="#Installation" accesskey="u" rel="up">Installation</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> +Next: <a href="#Ghostscript-installation" accesskey="n" rel="next">Ghostscript installation</a>, Previous: <a href="#config_002eps-installation" accesskey="p" rel="prev"><samp>config.ps</samp> installation</a>, Up: <a href="#Installation" accesskey="u" rel="up">Installation</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> </div> <span id="PostScript-font-installation-1"></span><h3 class="section">2.2 PostScript font installation</h3> @@ -415,16 +404,18 @@ come with support for 35 base PostScript fonts and many more. <span id="index-psfonts_002emap"></span> <p>If you have additional PostScript fonts, you can make them available to Dvips by (1) giving them appropriate filenames; and -(2) running Afm2tfm (see <a href="#Making-a-font-available">Making a font available</a>) to make TFM +(2) running Afm2tfm (see <a href="#Making-a-font-available">Making a PostScript font available</a>) to make TFM and VF metrics for TeX and Dvips to use. Also add them to -<samp>psfonts.map</samp> (see <a href="#psfonts_002emap">psfonts.map</a>); this file must contain +<samp>psfonts.map</samp> (see <a href="#psfonts_002emap"><samp>psfonts.map</samp>: PostScript font catalog</a>); this file must contain everything available in the system. The <code>updmap</code> program is usually used to maintain <samp>psfonts.map</samp>; run ‘<samp>updmap --help</samp>’ for lots of information about how it works. </p> <hr> -<span id="Ghostscript-installation"></span><div class="header"> +</div> +<div class="section" id="Ghostscript-installation"> +<div class="header"> <p> Next: <a href="#Diagnosing-problems" accesskey="n" rel="next">Diagnosing problems</a>, Previous: <a href="#PostScript-font-installation" accesskey="p" rel="prev">PostScript font installation</a>, Up: <a href="#Installation" accesskey="u" rel="up">Installation</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> </div> @@ -455,13 +446,15 @@ format. The latest version is available via <p>The program Ghostview, originally written by Johannes Plass and Tim Theisen, provides typical previewing capabilities (next page/previous page, magnification, etc.). It requires Ghostscript to run, and files -in structured Postscript, specifically with ‘<samp>%%Page</samp>’ comments (no +in structured PostScript, specifically with ‘<samp>%%Page</samp>’ comments (no ‘<samp>N</samp>’ in <samp>config.ps</samp>). The current version is known as GV, and is available from <a href="https://www.gnu.org/software/gv">https://www.gnu.org/software/gv</a>. </p> <hr> -<span id="Diagnosing-problems"></span><div class="header"> +</div> +<div class="section" id="Diagnosing-problems"> +<div class="header"> <p> Previous: <a href="#Ghostscript-installation" accesskey="p" rel="prev">Ghostscript installation</a>, Up: <a href="#Installation" accesskey="u" rel="up">Installation</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> </div> @@ -477,33 +470,28 @@ work. The following sections provide some helpful hints if you find yourself in such a situation. </p> <p>For details on effective bug reporting, common installation problems, -and <code>mktexpk</code> problems, see <a href="https://tug.org/texinfohtml/kpathsea.html#Bugs">Bugs</a> in <cite>Kpathsea</cite>. +and <code>mktexpk</code> problems, see <a data-manual="kpathsea" href="https://tug.org/texinfohtml/kpathsea.html#Bugs">Bugs</a> in <cite>Kpathsea</cite>. </p> <p>A good first debugging operation is to set the environment variable <code>DVIPSDEBUG</code>, which will display any configuration and map files read by Dvips. This way you can be sure it’s finding the files and settings you expect. </p> -<table class="menu" border="0" cellspacing="0"> -<tr><td align="left" valign="top">• <a href="#Debug-options" accesskey="1">Debug options</a></td><td> </td><td align="left" valign="top">Getting diagnostics. -</td></tr> -<tr><td align="left" valign="top">• <a href="#No-output" accesskey="2">No output</a></td><td> </td><td align="left" valign="top">No output at all. -</td></tr> -<tr><td align="left" valign="top">• <a href="#Small-or-inverted" accesskey="3">Small or inverted</a></td><td> </td><td align="left" valign="top">Output too small or inverted. -</td></tr> -<tr><td align="left" valign="top">• <a href="#Printer-errors" accesskey="4">Printer errors</a></td><td> </td><td align="left" valign="top">The printer sends back errors. -</td></tr> -<tr><td align="left" valign="top">• <a href="#Long-documents-fail" accesskey="5">Long documents fail</a></td><td> </td><td align="left" valign="top">Long documents fail to print. -</td></tr> -<tr><td align="left" valign="top">• <a href="#Including-graphics-fails" accesskey="6">Including graphics fails</a></td><td> </td><td align="left" valign="top">Figures don’t work. -</td></tr> -</table> +<ul class="section-toc"> +<li><a href="#Debug-options" accesskey="1">Debug options</a></li> +<li><a href="#No-output" accesskey="2">No output at all</a></li> +<li><a href="#Small-or-inverted" accesskey="3">Output too small or inverted</a></li> +<li><a href="#Printer-errors" accesskey="4">Error messages from printer</a></li> +<li><a href="#Long-documents-fail" accesskey="5">Long documents fail to print</a></li> +<li><a href="#Including-graphics-fails" accesskey="6">Including graphics fails</a></li> +</ul> <hr> -<span id="Debug-options"></span><div class="header"> +<div class="subsection" id="Debug-options"> +<div class="header"> <p> -Next: <a href="#No-output" accesskey="n" rel="next">No output</a>, Up: <a href="#Diagnosing-problems" accesskey="u" rel="up">Diagnosing problems</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> +Next: <a href="#No-output" accesskey="n" rel="next">No output at all</a>, Up: <a href="#Diagnosing-problems" accesskey="u" rel="up">Diagnosing problems</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> </div> <span id="Debug-options-1"></span><h4 class="subsection">2.4.1 Debug options</h4> @@ -519,57 +507,59 @@ To track all classes, you can use <code>-1</code>. </p> <p>You can also set the environment variable <code>KPATHSEA_DEBUG</code> instead of using ‘<samp>-d</samp>’. Some of these debugging options are actually -provided by Kpathsea (see <a href="https://tug.org/texinfohtml/kpathsea.html#Debugging">Debugging</a> in <cite>Kpathsea</cite>). +provided by Kpathsea (see <a data-manual="kpathsea" href="https://tug.org/texinfohtml/kpathsea.html#Debugging">Debugging</a> in <cite>Kpathsea</cite>). </p> <p>The classes are: </p> <dl compact="compact"> -<dt>1</dt> +<dt><span>1</span></dt> <dd><p>specials </p></dd> -<dt>2</dt> +<dt><span>2</span></dt> <dd><p>paths </p></dd> -<dt>4</dt> +<dt><span>4</span></dt> <dd><p>fonts </p></dd> -<dt>8</dt> +<dt><span>8</span></dt> <dd><p>pages </p></dd> -<dt>16</dt> +<dt><span>16</span></dt> <dd><p>headers </p></dd> -<dt>32</dt> +<dt><span>32</span></dt> <dd><p>font compression </p></dd> -<dt>64</dt> +<dt><span>64</span></dt> <dd><p>files </p></dd> -<dt>128</dt> +<dt><span>128</span></dt> <dd><p>(omitted) </p></dd> -<dt>256</dt> +<dt><span>256</span></dt> <dd><p>config files </p></dd> -<dt>512</dt> +<dt><span>512</span></dt> <dd><p>Kpathsea <code>stat</code> calls </p></dd> -<dt>1024</dt> +<dt><span>1024</span></dt> <dd><p>Kpathsea hash table lookups </p></dd> -<dt>2048</dt> +<dt><span>2048</span></dt> <dd><p>Kpathsea path element expansion </p></dd> -<dt>4096</dt> +<dt><span>4096</span></dt> <dd><p>Kpathsea path searches </p></dd> </dl> <hr> -<span id="No-output"></span><div class="header"> +</div> +<div class="subsection" id="No-output"> +<div class="header"> <p> -Next: <a href="#Small-or-inverted" accesskey="n" rel="next">Small or inverted</a>, Previous: <a href="#Debug-options" accesskey="p" rel="prev">Debug options</a>, Up: <a href="#Diagnosing-problems" accesskey="u" rel="up">Diagnosing problems</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> +Next: <a href="#Small-or-inverted" accesskey="n" rel="next">Output too small or inverted</a>, Previous: <a href="#Debug-options" accesskey="p" rel="prev">Debug options</a>, Up: <a href="#Diagnosing-problems" accesskey="u" rel="up">Diagnosing problems</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> </div> <span id="No-output-at-all"></span><h4 class="subsection">2.4.2 No output at all</h4> @@ -608,9 +598,11 @@ comments and see what happens. </p> <hr> -<span id="Small-or-inverted"></span><div class="header"> +</div> +<div class="subsection" id="Small-or-inverted"> +<div class="header"> <p> -Next: <a href="#Printer-errors" accesskey="n" rel="next">Printer errors</a>, Previous: <a href="#No-output" accesskey="p" rel="prev">No output</a>, Up: <a href="#Diagnosing-problems" accesskey="u" rel="up">Diagnosing problems</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> +Next: <a href="#Printer-errors" accesskey="n" rel="next">Error messages from printer</a>, Previous: <a href="#No-output" accesskey="p" rel="prev">No output at all</a>, Up: <a href="#Diagnosing-problems" accesskey="u" rel="up">Diagnosing problems</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> </div> <span id="Output-too-small-or-inverted"></span><h4 class="subsection">2.4.3 Output too small or inverted</h4> @@ -627,13 +619,15 @@ force Dvips to do this with the ‘<samp>-F</samp>’ flag (or ‘<s option), but this generates files with a terminating binary character (control-D). You can also try using the ‘<samp>-s</samp>’ flag (or ‘<samp>s</samp>’ config file option) to enclose the entire job in a save/restore pair. -See <a href="#Command_002dline-options">Command-line options</a>, and <a href="#Config-files">Config files</a>. +See <a href="#Command_002dline-options">Command-line options</a>, and <a href="#Config-files">Dvips configuration files</a>. </p> <hr> -<span id="Printer-errors"></span><div class="header"> +</div> +<div class="subsection" id="Printer-errors"> +<div class="header"> <p> -Next: <a href="#Long-documents-fail" accesskey="n" rel="next">Long documents fail</a>, Previous: <a href="#Small-or-inverted" accesskey="p" rel="prev">Small or inverted</a>, Up: <a href="#Diagnosing-problems" accesskey="u" rel="up">Diagnosing problems</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> +Next: <a href="#Long-documents-fail" accesskey="n" rel="next">Long documents fail to print</a>, Previous: <a href="#Small-or-inverted" accesskey="p" rel="prev">Output too small or inverted</a>, Up: <a href="#Diagnosing-problems" accesskey="u" rel="up">Diagnosing problems</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> </div> <span id="Error-messages-from-printer"></span><h4 class="subsection">2.4.4 Error messages from printer</h4> @@ -668,9 +662,11 @@ might be a problem with the printer itself. </p> <hr> -<span id="Long-documents-fail"></span><div class="header"> +</div> +<div class="subsection" id="Long-documents-fail"> +<div class="header"> <p> -Next: <a href="#Including-graphics-fails" accesskey="n" rel="next">Including graphics fails</a>, Previous: <a href="#Printer-errors" accesskey="p" rel="prev">Printer errors</a>, Up: <a href="#Diagnosing-problems" accesskey="u" rel="up">Diagnosing problems</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> +Next: <a href="#Including-graphics-fails" accesskey="n" rel="next">Including graphics fails</a>, Previous: <a href="#Printer-errors" accesskey="p" rel="prev">Error messages from printer</a>, Up: <a href="#Diagnosing-problems" accesskey="u" rel="up">Diagnosing problems</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> </div> <span id="Long-documents-fail-to-print"></span><h4 class="subsection">2.4.5 Long documents fail to print</h4> @@ -682,9 +678,11 @@ the printer has in the configuration file; see the previous section. </p> <hr> -<span id="Including-graphics-fails"></span><div class="header"> +</div> +<div class="subsection" id="Including-graphics-fails"> +<div class="header"> <p> -Previous: <a href="#Long-documents-fail" accesskey="p" rel="prev">Long documents fail</a>, Up: <a href="#Diagnosing-problems" accesskey="u" rel="up">Diagnosing problems</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> +Previous: <a href="#Long-documents-fail" accesskey="p" rel="prev">Long documents fail to print</a>, Up: <a href="#Diagnosing-problems" accesskey="u" rel="up">Diagnosing problems</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> </div> <span id="Including-graphics-fails-1"></span><h4 class="subsection">2.4.6 Including graphics fails</h4> @@ -693,7 +691,7 @@ Previous: <a href="#Long-documents-fail" accesskey="p" rel="prev">Long documents <span id="index-failure_002c-to-include-graphics"></span> <p>The most common problem with including graphics is an incorrect bounding -box (see <a href="#Bounding-box">Bounding box</a>). Complain to whoever wrote the software that +box (see <a href="#Bounding-box">The bounding box comment</a>). Complain to whoever wrote the software that generated the file if the bounding box is indeed incorrect. </p> <span id="index-Illustrator_002c-workaround-for"></span> @@ -716,9 +714,13 @@ looking for a particular comment. </p> <hr> -<span id="Invoking-Dvips"></span><div class="header"> +</div> +</div> +</div> +<div class="chapter" id="Invoking-Dvips"> +<div class="header"> <p> -Next: <a href="#Paper-size-and-landscape" accesskey="n" rel="next">Paper size and landscape</a>, Previous: <a href="#Installation" accesskey="p" rel="prev">Installation</a>, Up: <a href="#Top" accesskey="u" rel="up">Top</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> +Next: <a href="#Paper-size-and-landscape" accesskey="n" rel="next">Paper size and landscape orientation</a>, Previous: <a href="#Installation" accesskey="p" rel="prev">Installation</a>, Up: <a href="#Top" accesskey="u" rel="up">Dvips</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> </div> <span id="Invoking-Dvips-1"></span><h2 class="chapter">3 Invoking Dvips</h2> @@ -734,20 +736,17 @@ chapters in this document. <p>There many ways to control Dvips’ behavior: configuration files, environment variables, and command-line options. </p> -<table class="menu" border="0" cellspacing="0"> -<tr><td align="left" valign="top">• <a href="#Basic-usage" accesskey="1">Basic usage</a></td><td> </td><td align="left" valign="top"> -</td></tr> -<tr><td align="left" valign="top">• <a href="#Command_002dline-options" accesskey="2">Command-line options</a></td><td> </td><td align="left" valign="top"> -</td></tr> -<tr><td align="left" valign="top">• <a href="#Environment-variables" accesskey="3">Environment variables</a></td><td> </td><td align="left" valign="top"> -</td></tr> -<tr><td align="left" valign="top">• <a href="#Config-files" accesskey="4">Config files</a></td><td> </td><td align="left" valign="top"> -</td></tr> -</table> +<ul class="section-toc"> +<li><a href="#Basic-usage" accesskey="1">Basic usage of Dvips</a></li> +<li><a href="#Command_002dline-options" accesskey="2">Command-line options</a></li> +<li><a href="#Environment-variables" accesskey="3">Environment variables</a></li> +<li><a href="#Config-files" accesskey="4">Dvips configuration files</a></li> +</ul> <hr> -<span id="Basic-usage"></span><div class="header"> +<div class="section" id="Basic-usage"> +<div class="header"> <p> Next: <a href="#Command_002dline-options" accesskey="n" rel="next">Command-line options</a>, Up: <a href="#Invoking-Dvips" accesskey="u" rel="up">Invoking Dvips</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> </div> @@ -772,7 +771,7 @@ progress reports appear by default. The next time that document is printed, these fonts will have been saved in the proper directories, so printing will go much faster. (If Dvips tries to endlessly generate the same fonts over and over again, it hasn’t been installed properly. -See <a href="https://tug.org/texinfohtml/kpathsea.html#Unable-to-generate-fonts">Unable to generate fonts</a> in <cite>Kpathsea</cite>.) +See <a data-manual="kpathsea" href="https://tug.org/texinfohtml/kpathsea.html#Unable-to-generate-fonts">Unable to generate fonts</a> in <cite>Kpathsea</cite>.) </p> <p>Many options are available (see the next section). For a brief summary of available options, run @@ -783,25 +782,26 @@ of available options, run <hr> -<span id="Command_002dline-options"></span><div class="header"> +</div> +<div class="section" id="Command_002dline-options"> +<div class="header"> <p> -Next: <a href="#Environment-variables" accesskey="n" rel="next">Environment variables</a>, Previous: <a href="#Basic-usage" accesskey="p" rel="prev">Basic usage</a>, Up: <a href="#Invoking-Dvips" accesskey="u" rel="up">Invoking Dvips</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> +Next: <a href="#Environment-variables" accesskey="n" rel="next">Environment variables</a>, Previous: <a href="#Basic-usage" accesskey="p" rel="prev">Basic usage of Dvips</a>, Up: <a href="#Invoking-Dvips" accesskey="u" rel="up">Invoking Dvips</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> </div> <span id="Command_002dline-options-1"></span><h3 class="section">3.2 Command-line options</h3> <p>Dvips has a plethora of command line options. Reading through this section will give a good idea of the capabilities of the driver. </p> -<table class="menu" border="0" cellspacing="0"> -<tr><td align="left" valign="top">• <a href="#Option-summary" accesskey="1">Option summary</a></td><td> </td><td align="left" valign="top">Quick listing, from Dvips –help. -</td></tr> -<tr><td align="left" valign="top">• <a href="#Option-details" accesskey="2">Option details</a></td><td> </td><td align="left" valign="top">More information about each option. -</td></tr> -</table> +<ul class="section-toc"> +<li><a href="#Option-summary" accesskey="1">Option summary</a></li> +<li><a href="#Option-details" accesskey="2">Option details</a></li> +</ul> <hr> -<span id="Option-summary"></span><div class="header"> +<div class="subsection" id="Option-summary"> +<div class="header"> <p> Next: <a href="#Option-details" accesskey="n" rel="next">Option details</a>, Up: <a href="#Command_002dline-options" accesskey="u" rel="up">Command-line options</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> </div> @@ -855,7 +855,9 @@ Email bug reports to tex-k@mail.tug.org. </pre> <hr> -<span id="Option-details"></span><div class="header"> +</div> +<div class="subsection" id="Option-details"> +<div class="header"> <p> Previous: <a href="#Option-summary" accesskey="p" rel="prev">Option summary</a>, Up: <a href="#Command_002dline-options" accesskey="u" rel="up">Command-line options</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> </div> @@ -869,42 +871,36 @@ page reversal, use ‘<samp>-r0</samp>’. Such options are marked with ‘<samp>*</samp>’. </p> <dl compact="compact"> -<dt>‘<samp>-</samp>’</dt> -<dd><span id="index-_002d"></span> -<span id="index-options_002c-reading-from-standard-input"></span> +<dt id='index-_002d'><span>‘<samp>-</samp>’<a href='#index-_002d' class='copiable-anchor'> ¶</a></span></dt> +<dd><span id="index-options_002c-reading-from-standard-input"></span> <span id="index-standard-input_002c-reading-options-from"></span> <p>Read additional options from standard input after processing the command line. </p> </dd> -<dt>‘<samp>--help</samp>’</dt> -<dd><span id="index-_002d_002dhelp-1"></span> -<p>Print a usage message and exit. +<dt id='index-_002d_002dhelp-1'><span>‘<samp>--help</samp>’<a href='#index-_002d_002dhelp-1' class='copiable-anchor'> ¶</a></span></dt> +<dd><p>Print a usage message and exit. </p> </dd> -<dt>‘<samp>--version</samp>’</dt> -<dd><span id="index-_002d_002dversion"></span> -<p>Print the version number and exit. +<dt id='index-_002d_002dversion'><span>‘<samp>--version</samp>’<a href='#index-_002d_002dversion' class='copiable-anchor'> ¶</a></span></dt> +<dd><p>Print the version number and exit. </p> </dd> -<dt>‘<samp>-a*</samp>’</dt> -<dd><span id="index-_002da"></span> -<span id="index-memory_002c-conserving"></span> +<dt id='index-_002da'><span>‘<samp>-a*</samp>’<a href='#index-_002da' class='copiable-anchor'> ¶</a></span></dt> +<dd><span id="index-memory_002c-conserving"></span> <p>Conserve memory by making three passes over the DVI file instead of two and only loading those characters actually used. Generally only useful on machines with a very limited amount of memory, like some PCs. </p> </dd> -<dt>‘<samp>-A</samp>’</dt> -<dd><span id="index-_002dA"></span> -<span id="index-odd-pages-only"></span> +<dt id='index-_002dA'><span>‘<samp>-A</samp>’<a href='#index-_002dA' class='copiable-anchor'> ¶</a></span></dt> +<dd><span id="index-odd-pages-only"></span> <p>Print only the odd pages. This option uses TeX page numbers, not physical page numbers. </p> </dd> -<dt>‘<samp>-b <var>num</var></samp>’</dt> -<dd><span id="index-_002db-num"></span> -<span id="index-_002f_0023copies"></span> +<dt id='index-_002db-num'><span>‘<samp>-b <var>num</var></samp>’<a href='#index-_002db-num' class='copiable-anchor'> ¶</a></span></dt> +<dd><span id="index-_002f_0023copies"></span> <span id="index-copies_002c-duplicated-page-bodies"></span> <span id="index-color-separations"></span> <p>Generate <var>num</var> copies of each page, but duplicating the page body @@ -913,25 +909,22 @@ be useful in conjunction with a header file setting ‘<samp>bop-hook</samp> do color separations or other neat tricks. </p> </dd> -<dt>‘<samp>-B</samp>’</dt> -<dd><span id="index-_002dB"></span> -<span id="index-even-pages-only"></span> +<dt id='index-_002dB'><span>‘<samp>-B</samp>’<a href='#index-_002dB' class='copiable-anchor'> ¶</a></span></dt> +<dd><span id="index-even-pages-only"></span> <span id="index-double_002dsided-printing"></span> <p>Print only the even pages. This option uses TeX page numbers, not physical page numbers. </p> </dd> -<dt>‘<samp>-bitmapfontenc <var>option</var></samp>’</dt> -<dd><span id="index-_002dbitmapfontenc-option"></span> -<span id="index-bitmap-font-encoding"></span> +<dt id='index-_002dbitmapfontenc-option'><span>‘<samp>-bitmapfontenc <var>option</var></samp>’<a href='#index-_002dbitmapfontenc-option' class='copiable-anchor'> ¶</a></span></dt> +<dd><span id="index-bitmap-font-encoding"></span> <p>Turns bitmap font encoding to ‘<samp>off</samp>’, ‘<samp>on</samp>’ (no warnings for missing bitmap font encodings), or ‘<samp>strict</samp>’ (with warnings for missing bitmap font encodings). </p> </dd> -<dt>‘<samp>-c <var>num</var></samp>’</dt> -<dd><span id="index-_002dc-num"></span> -<span id="index-_002f_0023copies-1"></span> +<dt id='index-_002dc-num'><span>‘<samp>-c <var>num</var></samp>’<a href='#index-_002dc-num' class='copiable-anchor'> ¶</a></span></dt> +<dd><span id="index-_002f_0023copies-1"></span> <span id="index-copies_002c-uncollated"></span> <span id="index-uncollated-copies"></span> <p>Generate <var>num</var> consecutive copies of every page, i.e., the output is @@ -939,9 +932,8 @@ uncollated. This merely sets the builtin PostScript variable ‘<samp>/#copies</samp>’. </p> </dd> -<dt>‘<samp>-C <var>num</var></samp>’</dt> -<dd><span id="index-_002dC-num"></span> -<span id="index-copies_002c-collated"></span> +<dt id='index-_002dC-num'><span>‘<samp>-C <var>num</var></samp>’<a href='#index-_002dC-num' class='copiable-anchor'> ¶</a></span></dt> +<dd><span id="index-copies_002c-collated"></span> <span id="index-collated-copies"></span> <p>Generate <var>num</var> copies, but collated (by replicating the data in the PostScript file). Slower than the ‘<samp>-c</samp>’ option, but easier on the @@ -949,18 +941,16 @@ hands, and faster than resubmitting the same PostScript file multiple times. </p> </dd> -<dt>‘<samp>-d <var>num</var></samp>’</dt> -<dd><span id="index-_002dd-num"></span> -<span id="index-debugging-1"></span> +<dt id='index-_002dd-num'><span>‘<samp>-d <var>num</var></samp>’<a href='#index-_002dd-num' class='copiable-anchor'> ¶</a></span></dt> +<dd><span id="index-debugging-1"></span> <p>Set the debug flags, showing what Dvips (thinks it) is doing. This will work unless Dvips has been compiled without the ‘<samp>DEBUG</samp>’ option (not recommended). See <a href="#Debug-options">Debug options</a>, for the possible values of <var>num</var>. Use ‘<samp>-d -1</samp>’ as the first option for maximum output. </p> </dd> -<dt>‘<samp>-D <var>num</var></samp>’</dt> -<dd><span id="index-_002dD-num"></span> -<span id="index-resolution_002c-setting"></span> +<dt id='index-_002dD-num'><span>‘<samp>-D <var>num</var></samp>’<a href='#index-_002dD-num' class='copiable-anchor'> ¶</a></span></dt> +<dd><span id="index-resolution_002c-setting"></span> <p>Set both the horizontal and vertical resolution to <var>num</var>, given in dpi (dots per inch). This affects the choice of bitmap fonts that are loaded and also the positioning of letters in resident PostScript @@ -974,9 +964,8 @@ that you use or Metafont will fail. See the file names for most devices. </p> </dd> -<dt>‘<samp>-e <var>num</var></samp>’</dt> -<dd><span id="index-_002de-num"></span> -<span id="index-maxdrift"></span> +<dt id='index-_002de-num'><span>‘<samp>-e <var>num</var></samp>’<a href='#index-_002de-num' class='copiable-anchor'> ¶</a></span></dt> +<dd><span id="index-maxdrift"></span> <span id="index-accuracy-in-positioning"></span> <span id="index-positioning-accuracy"></span> <p>Maximum drift in pixels of each character from its ‘true’ @@ -990,9 +979,8 @@ position at the beginning of each new word, improves the spacing of letters in words. </p> </dd> -<dt>‘<samp>-E*</samp>’</dt> -<dd><span id="index-_002dE"></span> -<span id="index-EPSF_002c-generating"></span> +<dt id='index-_002dE'><span>‘<samp>-E*</samp>’<a href='#index-_002dE' class='copiable-anchor'> ¶</a></span></dt> +<dd><span id="index-EPSF_002c-generating"></span> <span id="index-tight-bounding-box_002c-finding"></span> <span id="index-bounding-box_002c-finding-tight"></span> <p>Generate an EPSF file with a tight bounding box. This only looks at @@ -1010,9 +998,8 @@ each page as a separate EPSF file; otherwise, all the pages are overlaid in the single output file. </p> </dd> -<dt>‘<samp>-f*</samp>’</dt> -<dd><span id="index-_002df"></span> -<span id="index-filter_002c-running-as-a"></span> +<dt id='index-_002df'><span>‘<samp>-f*</samp>’<a href='#index-_002df' class='copiable-anchor'> ¶</a></span></dt> +<dd><span id="index-filter_002c-running-as-a"></span> <span id="index-standard-I_002fO"></span> <span id="index-pipes_002c-not-readable"></span> <span id="index-PRINTER_002c-avoided-with-_002df"></span> @@ -1027,9 +1014,8 @@ control-D if it was turned on with the ‘<samp>-F</samp>’ option or i configuration file; use ‘<samp>-F</samp>’ after the ‘<samp>-f</samp>’ to send it anyway. </p> </dd> -<dt>‘<samp>-F*</samp>’</dt> -<dd><span id="index-_002dF"></span> -<span id="index-EOF"></span> +<dt id='index-_002dF'><span>‘<samp>-F*</samp>’<a href='#index-_002dF' class='copiable-anchor'> ¶</a></span></dt> +<dd><span id="index-EOF"></span> <span id="index-control_002dD"></span> <span id="index-printer_002c-driving-directly"></span> <span id="index-spooler_002c-lacking"></span> @@ -1040,27 +1026,26 @@ systems. On systems shared by more than one person, this is not recommended. </p> </dd> -<dt>‘<samp>-G*</samp>’</dt> -<dd><span id="index-_002dG"></span> -<span id="index-low-characters_002c-shifting"></span> +<dt id='index-_002dG'><span>‘<samp>-G*</samp>’<a href='#index-_002dG' class='copiable-anchor'> ¶</a></span></dt> +<dd><span id="index-low-characters_002c-shifting"></span> <span id="index-non_002dprinting-characters_002c-shifting"></span> <p>Shift non-printing characters (ASCII 0-32, 127) to higher-numbered positions. This was useful to work around bugs in old versions of Adobe’s PDF reader. It’s more likely to cause problems nowadays. </p> </dd> -<dt>‘<samp>-h <var>name</var></samp>’</dt> -<dd><span id="index-_002dh-name"></span> -<span id="index-header-file_002c-downloading"></span> +<dt id='index-_002dh-name'><span>‘<samp>-h <var>name</var></samp>’<a href='#index-_002dh-name' class='copiable-anchor'> ¶</a></span></dt> +<dd><span id="index-header-file_002c-downloading"></span> <span id="index-userdict_002c-used-for-header-files"></span> <p>Prepend <var>name</var> as an additional header file, or, if <var>name</var> is -‘<samp>-</samp>’, suppress all header files. Any definitions in the header file -get added to the PostScript ‘<samp>userdict</samp>’. +‘<samp>-</samp>’, suppress inclusion of default header files. If <code>-h</code> is +given multiple times, the headers are included in the order given. +Any definitions in the header file get added to the PostScript +‘<samp>userdict</samp>’. </p> </dd> -<dt>‘<samp>-i*</samp>’</dt> -<dd><span id="index-_002di"></span> -<span id="index-sections-output_002c-in-separate-files"></span> +<dt id='index-_002di'><span>‘<samp>-i*</samp>’<a href='#index-_002di' class='copiable-anchor'> ¶</a></span></dt> +<dd><span id="index-sections-output_002c-in-separate-files"></span> <span id="index-multiple-output-files"></span> <span id="index-output-files_002c-multiple"></span> <p>Make each section be a separate file; a <em>section</em> is a part of the @@ -1080,17 +1065,15 @@ output into unwanted sections, to try to avoid overflowing printer memory. See <a href="#Headers-and-memory-usage">Headers and memory usage</a>, for ways to handle this. </p> </dd> -<dt>‘<samp>-j*</samp>’</dt> -<dd><span id="index-_002dj-for-partial-font-downloading"></span> -<p>Download only needed characters from Type 1 fonts. This is the +<dt id='index-_002dj-for-partial-font-downloading'><span>‘<samp>-j*</samp>’<a href='#index-_002dj-for-partial-font-downloading' class='copiable-anchor'> ¶</a></span></dt> +<dd><p>Download only needed characters from Type 1 fonts. This is the default in the current release. Some debugging flags trace this operation (see <a href="#Debug-options">Debug options</a>). You can also control partial downloading on a -per-font basis (see <a href="#psfonts_002emap">psfonts.map</a>). +per-font basis (see <a href="#psfonts_002emap"><samp>psfonts.map</samp>: PostScript font catalog</a>). </p> </dd> -<dt>‘<samp>-k*</samp>’</dt> -<dd><span id="index-_002dk-for-cropmarks"></span> -<span id="index-cropmarks"></span> +<dt id='index-_002dk-for-cropmarks'><span>‘<samp>-k*</samp>’<a href='#index-_002dk-for-cropmarks' class='copiable-anchor'> ¶</a></span></dt> +<dd><span id="index-cropmarks"></span> <span id="index-crop_002epro"></span> <p>Print crop marks. This option increases the paper size (which should be specified, either with a paper size special or with the ‘<samp>-T</samp>’ @@ -1100,9 +1083,8 @@ typesetters that can set the page size automatically. This works by downloading <samp>crop.pro</samp>. </p> </dd> -<dt>‘<samp>-K*</samp>’</dt> -<dd><span id="index-_002dK"></span> -<span id="index-comments_002c-removing-included"></span> +<dt id='index-_002dK'><span>‘<samp>-K*</samp>’<a href='#index-_002dK' class='copiable-anchor'> ¶</a></span></dt> +<dd><span id="index-comments_002c-removing-included"></span> <span id="index-_0025_0025Page_002c-removing"></span> <p>Remove comments in included PostScript graphics, font files, and headers; only necessary to get around bugs in spoolers or PostScript @@ -1113,49 +1095,65 @@ macros from some software packages read portion the input stream line by line, searching for a particular comment. </p> </dd> -<dt>‘<samp>-l [=]<var>num</var></samp>’</dt> -<dd><span id="index-_002dl-_005b_003d_005dnum"></span> -<span id="index-last-page-printed"></span> +<dt id='index-_002dl-_005b_003d_005dnum_005b_002epageseq_005d'><span>‘<samp>-l [=]<var>num</var>[.<var>pageseq</var>]</samp>’<a href='#index-_002dl-_005b_003d_005dnum_005b_002epageseq_005d' class='copiable-anchor'> ¶</a></span></dt> +<dd><span id="index-last-page-printed"></span> <span id="index-page_002c-last-printed"></span> +<span id="index-page-numbers_002c-multiple-repetitions-of"></span> <span id="index-physical-page-number_002c-and-_002dl"></span> <span id="index-absolute-page-number_002c-and-_002dl"></span> -<p>The last page printed will be the first one numbered <var>num</var>. Default -is the last page in the document. If <var>num</var> is prefixed by an equals -sign, then it (and the argument to the ‘<samp>-p</samp>’ option, if specified) -is treated as a physical (absolute) page number, rather than a value to -compare with the TeX ‘<samp>\count0</samp>’ values stored in the DVI file. -Thus, using ‘<samp>-l =9</samp>’ will end with the ninth page of the document, -no matter what the pages are actually numbered. -</p> -</dd> -<dt>‘<samp>-L*</samp>’</dt> -<dd><span id="index-_002dL"></span> -<span id="index-papersize-special_002c-first-vs_002e-last"></span> +<p>The last page printed will be the first one numbered <var>num</var>; the +default is the last page in the document. +</p> +<p>By default, <var>num</var> is compared to TeX’s idea of the page number +(more precisely, the <code>\count0</code> value written in the DVI file). +But if <var>num</var> is prefixed by an equals sign, then it (and the +argument to the ‘<samp>-p</samp>’ option, if specified) is treated as a +physical (absolute) page number, Thus, using ‘<samp>-l =9</samp>’ will end the +output with the ninth page of the document, no matter what the pages +are actually numbered. +</p> +<p>On the other hand, if <var>pageseq</var> is specified, the <var>pageseq</var>th +occurrence of the given TeX page number is used. For example, +‘<samp>-l 99.2</samp>’ says to end with the second page numbered 99 in the +document. The ‘<samp>=</samp>’ and <var>lastseq</var> features aren’t useful +together. +</p> +</dd> +<dt id='index-_002dL'><span>‘<samp>-L*</samp>’<a href='#index-_002dL' class='copiable-anchor'> ¶</a></span></dt> +<dd><span id="index-papersize-special_002c-first-vs_002e-last"></span> <p>By default or with <code>-L1</code>, the last ‘<samp>papersize</samp>’ special wins; with <code>-L0</code>, the first special wins. See <a href="#papersize-special">‘<samp>papersize</samp>’ special</a>. </p> </dd> -<dt>‘<samp>-m*</samp>’</dt> -<dd><span id="index-_002dm"></span> -<span id="index-manual-feed"></span> +<dt id='index-_002dlandscaperotate'><span>‘<samp>-landscaperotate*</samp>’<a href='#index-_002dlandscaperotate' class='copiable-anchor'> ¶</a></span></dt> +<dd><span id="index-landscaperotate"></span> +<p>When looking for matching paper sizes, permit rotation of page content +on the page to match the given size; the default, as of Dvips 2022.1, +is not to do this. It should not be needed in modern systems with +normal print spoolers, and can be harmful when converting to PDF +(see <a href="#Config-file-paper-sizes">Configuration file paper size command</a>). This option accepts an optional +suffix of 0 (to explicitly disable) or 1 (to explicitly enable); if +the option is specified without a suffix, it enables the behavior. +</p> +</dd> +<dt id='index-_002dm'><span>‘<samp>-m*</samp>’<a href='#index-_002dm' class='copiable-anchor'> ¶</a></span></dt> +<dd><span id="index-manual-feed"></span> <p>Specify manual feed, if supported by the output device. </p> </dd> -<dt>‘<samp>-mode <var>mode</var></samp>’</dt> -<dd><span id="index-_002dmode-mode"></span> -<span id="index-mode-name_002c-specifying"></span> +<dt id='index-_002dmode-mode'><span>‘<samp>-mode <var>mode</var></samp>’<a href='#index-_002dmode-mode' class='copiable-anchor'> ¶</a></span></dt> +<dd><span id="index-mode-name_002c-specifying"></span> <span id="index-Metafont-mode_002c-specifying"></span> <p>Use <var>mode</var> as the Metafont device name for path searching and font generation. This overrides any value from configuration files. With the default paths, explicitly specifying the mode also makes the program assume the fonts are in a subdirectory named <var>mode</var>. -See <a href="https://tug.org/texinfohtml/kpathsea.html#TeX-directory-structure">TeX directory structure</a> in <cite>Kpathsea</cite>. If Metafont does not understand the <var>mode</var> name, see -<a href="https://tug.org/texinfohtml/kpathsea.html#Unable-to-generate-fonts">Unable to generate fonts</a> in <cite>Kpathsea</cite>. +See <a data-manual="kpathsea" href="https://tug.org/texinfohtml/kpathsea.html#TeX-directory-structure">TeX directory structure</a> in <cite>Kpathsea</cite>. If Metafont does not understand the <var>mode</var> name, see +<a data-manual="kpathsea" href="https://tug.org/texinfohtml/kpathsea.html#Unable-to-generate-fonts">Unable to generate fonts</a> in <cite>Kpathsea</cite>. </p> </dd> -<dt>‘<samp>-M*</samp>’</dt> -<dd><span id="index-_002dM"></span> -<span id="index-font-generation_002c-avoiding"></span> +<dt id='index-_002dM'><span>‘<samp>-M*</samp>’<a href='#index-_002dM' class='copiable-anchor'> ¶</a></span></dt> +<dd><span id="index-font-generation_002c-avoiding"></span> <span id="index-mktexpk_002c-avoiding"></span> <span id="index-missfont_002elog"></span> <p>Turns off automatic font generation (<samp>mktexpk</samp>). If @@ -1172,16 +1170,14 @@ overridden by the ‘<samp>MISSFONT_LOG</samp>’ environment variable o configuration file value. </p> </dd> -<dt>‘<samp>-n <var>num</var></samp>’</dt> -<dd><span id="index-_002dn-num"></span> -<span id="index-maximum-pages-printed"></span> +<dt id='index-_002dn-num'><span>‘<samp>-n <var>num</var></samp>’<a href='#index-_002dn-num' class='copiable-anchor'> ¶</a></span></dt> +<dd><span id="index-maximum-pages-printed"></span> <span id="index-pages_002c-maximum-printed"></span> <p>Print at most <var>num</var> pages. Default is 100000. </p> </dd> -<dt>‘<samp>-N*</samp>’</dt> -<dd><span id="index-_002dN"></span> -<span id="index-structured-comments"></span> +<dt id='index-_002dN'><span>‘<samp>-N*</samp>’<a href='#index-_002dN' class='copiable-anchor'> ¶</a></span></dt> +<dd><span id="index-structured-comments"></span> <span id="index-TranScript"></span> <span id="index-_0025_0025Page_002c-not-generating"></span> <p>Turns off generation of structured comments such as ‘<samp>%%Page</samp>’; this @@ -1192,9 +1188,8 @@ Beware: This also disables page movement, etc., in PostScript viewers such as Ghostview. </p> </dd> -<dt>‘<samp>-noomega</samp>’</dt> -<dd><span id="index-_002dnoomega"></span> -<span id="index-Omega-extensions"></span> +<dt id='index-_002dnoomega'><span>‘<samp>-noomega</samp>’<a href='#index-_002dnoomega' class='copiable-anchor'> ¶</a></span></dt> +<dd><span id="index-Omega-extensions"></span> <span id="index-pTeX-extensions"></span> <p>Disable the use of Omega extensions when interpreting DVI files. By default, the additional opcodes ‘<samp>129</samp>’ and ‘<samp>134</samp>’ @@ -1202,9 +1197,8 @@ are recognized by Dvips as Omega or pTeX extensions and interpreted as requests to set 2-byte characters. </p> </dd> -<dt>‘<samp>-noptex</samp>’</dt> -<dd><span id="index-_002dnoptex"></span> -<span id="index-pTeX-extensions-1"></span> +<dt id='index-_002dnoptex'><span>‘<samp>-noptex</samp>’<a href='#index-_002dnoptex' class='copiable-anchor'> ¶</a></span></dt> +<dd><span id="index-pTeX-extensions-1"></span> <p>Disable the use of pTeX extensions when interpreting DVI files. By default, the additional opcodes ‘<samp>130</samp>’ and ‘<samp>135</samp>’ are recognized by Dvips as Omega extensions and interpreted as requests to @@ -1218,12 +1212,11 @@ larger. If you find this unacceptable or encounter another problem with the Omega or pTeX extensions, you can switch off the pTeX extension by using ‘<samp>-noptex</samp>’, or both by using ‘<samp>-noomega</samp>’ (but please do send a bug report if you find such problems, -see <a href="https://tug.org/texinfohtml/kpathsea.html#Bugs">Bugs</a> in <cite>Kpathsea</cite>). +see <a data-manual="kpathsea" href="https://tug.org/texinfohtml/kpathsea.html#Bugs">Bugs</a> in <cite>Kpathsea</cite>). </p> </dd> -<dt>‘<samp>-o <var>name</var></samp>’</dt> -<dd><span id="index-_002do-name"></span> -<span id="index-output_002c-redirecting"></span> +<dt id='index-_002do-name'><span>‘<samp>-o <var>name</var></samp>’<a href='#index-_002do-name' class='copiable-anchor'> ¶</a></span></dt> +<dd><span id="index-output_002c-redirecting"></span> <span id="index-standard-output_002c-output-to"></span> <p>Send output to the file <var>name</var>. If ‘<samp>-o</samp>’ is specified without <var>name</var> (i.e., it is the last thing on the command line), the @@ -1250,9 +1243,8 @@ environment variable, and turns off the automatic sending of control-D. See the ‘<samp>-f</samp>’ option for how to override this. </p> </dd> -<dt>‘<samp>-O <var>x-offset</var>,<var>y-offset</var></samp>’</dt> -<dd><span id="index-_002dO-x_002doffset_002cy_002doffset"></span> -<span id="index-offset-pages"></span> +<dt id='index-_002dO-x_002doffset_002cy_002doffset'><span>‘<samp>-O <var>x-offset</var>,<var>y-offset</var></samp>’<a href='#index-_002dO-x_002doffset_002cy_002doffset' class='copiable-anchor'> ¶</a></span></dt> +<dd><span id="index-offset-pages"></span> <span id="index-printer-offset"></span> <p>Move the origin by <var>x-offset</var>,<var>y-offset</var>, a comma-separated pair of dimensions such as ‘<samp>.1in,-.3cm</samp>’ (see <a href="#papersize-special">‘<samp>papersize</samp>’ special</a>). The origin of the page is shifted from the default position @@ -1271,24 +1263,17 @@ same <code>O</code> value—some printers vary widely from run to run. page, your best recourse is to use ‘<samp>bop-hook</samp>’ (see <a href="#PostScript-hooks">PostScript hooks</a>). </p> </dd> -<dt>‘<samp>-p [=]<var>num</var></samp>’</dt> -<dd><span id="index-_002dp-_005b_003d_005dnum"></span> -<span id="index-first-page-printed"></span> +<dt id='index-_002dp-_005b_003d_005dnum_005b_002epageseq_005d'><span>‘<samp>-p [=]<var>num</var>[.<var>pageseq</var>]</samp>’<a href='#index-_002dp-_005b_003d_005dnum_005b_002epageseq_005d' class='copiable-anchor'> ¶</a></span></dt> +<dd><span id="index-first-page-printed"></span> <span id="index-page_002c-first-printed"></span> <span id="index-physical-page-number_002c-and-_002dp"></span> <span id="index-absolute-page-number_002c-and-_002dp"></span> -<p>The first page printed will be the first one numbered <var>num</var>. Default -is the first page in the document. If <var>num</var> is prefixed by an -equals sign, then it (and the argument to the ‘<samp>-l</samp>’ option, if -specified) is treated as a physical (absolute) page number, rather than -a value to compare with the TeX ‘<samp>\count0</samp>’ values stored in the -DVI file. Thus, using ‘<samp>-p =3</samp>’ will start with the third page of -the document, no matter what the pages are actually numbered. -</p> -</dd> -<dt>‘<samp>-pp <var>first</var>-<var>last</var></samp>’</dt> -<dd><span id="index-_002dpp-first_002dlast"></span> -<span id="index-page-range"></span> +<p>Exactly analogous to <code>-l</code> (q.v.), but specifying the first page +number to be printed (processed). +</p> +</dd> +<dt id='index-_002dpp-first_002dlast'><span>‘<samp>-pp <var>first</var>-<var>last</var></samp>’<a href='#index-_002dpp-first_002dlast' class='copiable-anchor'> ¶</a></span></dt> +<dd><span id="index-page-range"></span> <span id="index-_002dpp-range"></span> <p>Print pages <var>first</var> through <var>last</var>; equivalent to ‘<samp>-p <var>first</var> -l <var>last</var></samp>’, except that multiple ‘<samp>-pp</samp>’ options @@ -1296,9 +1281,8 @@ accumulate, unlike ‘<samp>-p</samp>’ and ‘<samp>-l</samp>&rsqu also be ‘<samp>:</samp>’. </p> </dd> -<dt>‘<samp>-P <var>printer</var></samp>’</dt> -<dd><span id="index-_002dP-printer"></span> -<span id="index-config_002eps"></span> +<dt id='index-_002dP-printer'><span>‘<samp>-P <var>printer</var></samp>’<a href='#index-_002dP-printer' class='copiable-anchor'> ¶</a></span></dt> +<dd><span id="index-config_002eps"></span> <p>Read the configuration file <samp>config.<var>printer</var></samp> (<samp><var>printer</var>.cfg</samp> on MS-DOS), which typically sets the output name (most likely ‘<samp>o |lpr -P<var>printer</var></samp>’), resolution, Metafont @@ -1320,53 +1304,47 @@ exists, it is read. See <a href="#Configuration-file-searching">Configuration file searching</a>. </p> </dd> -<dt>‘<samp>-q*</samp>’</dt> -<dd><span id="index-_002dq"></span> -<span id="index-quiet-operation"></span> +<dt id='index-_002dq'><span>‘<samp>-q*</samp>’<a href='#index-_002dq' class='copiable-anchor'> ¶</a></span></dt> +<dd><span id="index-quiet-operation"></span> <span id="index-silent-operation"></span> <span id="index-warnings_002c-suppressing"></span> <p>Run quietly. Don’t chatter about pages converted, etc., and report no warnings (only errors) to standard error. </p> </dd> -<dt>‘<samp>-r*</samp>’</dt> -<dd><span id="index-_002dr"></span> -<span id="index-reverse-pagination"></span> +<dt id='index-_002dr'><span>‘<samp>-r*</samp>’<a href='#index-_002dr' class='copiable-anchor'> ¶</a></span></dt> +<dd><span id="index-reverse-pagination"></span> <p>Output pages in reverse order. By default, page 1 is output first. </p> </dd> -<dt>‘<samp>-R</samp>’</dt> -<dd><span id="index-_002dR"></span> -<span id="index-security"></span> +<dt id='index-_002dR'><span>‘<samp>-R</samp>’<a href='#index-_002dR' class='copiable-anchor'> ¶</a></span></dt> +<dd><span id="index-security"></span> <span id="index-shell-command-execution_002c-disabling"></span> <span id="index-absolute-filenames_002c-disabling"></span> <span id="index-_002e_002e_002drelative-filenames"></span> <p>Run securely. ‘<samp>-R2</samp>’ disables both shell command execution in -<code>\special</code> (via ‘<samp>`</samp>’, see <a href="#Dynamic-creation-of-graphics">Dynamic creation of graphics</a>) +<code>\special</code> (via ‘<samp>`</samp>’, see <a href="#Dynamic-creation-of-graphics">Dynamic creation of PostScript graphics files</a>) and config files (via the ‘<samp>E</samp>’ option, see <a href="#Configuration-file-commands">Configuration file commands</a>) and opening of any absolute or <samp>..</samp>-relative filenames. ‘<samp>-R1</samp>’, the default, forbids shell escapes but allows absolute filenames. ‘<samp>-R0</samp>’ allows both. </p> </dd> -<dt>‘<samp>-s*</samp>’</dt> -<dd><span id="index-_002ds"></span> -<span id="index-save_002frestore_002c-generating-global"></span> +<dt id='index-_002ds'><span>‘<samp>-s*</samp>’<a href='#index-_002ds' class='copiable-anchor'> ¶</a></span></dt> +<dd><span id="index-save_002frestore_002c-generating-global"></span> <p>Enclose the output in a global save/restore pair. This causes the file to not be truly conformant, and is thus not recommended, but is useful if you are driving a deficient printer directly and thus don’t care too much about the portability of the output to other environments. </p> </dd> -<dt>‘<samp>-S <var>num</var></samp>’</dt> -<dd><span id="index-_002dS-num"></span> -<p>Set the maximum number of pages in each ‘section’. This option is most +<dt id='index-_002dS-num'><span>‘<samp>-S <var>num</var></samp>’<a href='#index-_002dS-num' class='copiable-anchor'> ¶</a></span></dt> +<dd><p>Set the maximum number of pages in each ‘section’. This option is most commonly used with the ‘<samp>-i</samp>’ option; see its description above for more information. </p> </dd> -<dt>‘<samp>-t <var>papertype</var></samp>’</dt> -<dd><span id="index-_002dt-papertype"></span> -<span id="index-paper-type"></span> +<dt id='index-_002dt-papertype'><span>‘<samp>-t <var>papertype</var></samp>’<a href='#index-_002dt-papertype' class='copiable-anchor'> ¶</a></span></dt> +<dd><span id="index-paper-type"></span> <span id="index-media"></span> <span id="index-letter-papertype"></span> <span id="index-legal-papertype"></span> @@ -1377,7 +1355,7 @@ more information. <span id="index-papersize-special_002c-and-no-_002dt"></span> <p>Set the paper type to <var>papertype</var>, usually defined in one of the configuration files, along with the appropriate PostScript code to -select it (see <a href="#Config-file-paper-sizes">Config file paper sizes</a>). +select it (see <a href="#Config-file-paper-sizes">Configuration file paper size command</a>). </p><ul class="no-bullet"> <li>- You can also specify a <var>papertype</var> of ‘<samp>landscape</samp>’, which rotates a document by 90 degrees. @@ -1397,9 +1375,8 @@ you can use ‘<samp>-E</samp>’ to get pure EPSF output.) </li></ul> </dd> -<dt>‘<samp>-title <var>string</var></samp>’</dt> -<dd><span id="index-_002dtitle-str"></span> -<span id="index-title_002c-specifying"></span> +<dt id='index-_002dtitle-str'><span>‘<samp>-title <var>string</var></samp>’<a href='#index-_002dtitle-str' class='copiable-anchor'> ¶</a></span></dt> +<dd><span id="index-title_002c-specifying"></span> <span id="index-output-title_002c-specifying"></span> <span id="index-document-title_002c-specifying"></span> <span id="index-_0025_0025Title"></span> @@ -1409,17 +1386,15 @@ input file; for example, running <code>dvips /foo/bar.dvi</code> will have a <code>%%Title</code> of ‘<samp>bar.dvi</samp>’. </p> </dd> -<dt>‘<samp>-T <var>hsize</var>,<var>vsize</var></samp>’</dt> -<dd><span id="index-_002dT-hsize_002cvsize"></span> -<p>Set the paper size to (<var>hsize</var>,<var>vsize</var>), a comma-separated +<dt id='index-_002dT-hsize_002cvsize'><span>‘<samp>-T <var>hsize</var>,<var>vsize</var></samp>’<a href='#index-_002dT-hsize_002cvsize' class='copiable-anchor'> ¶</a></span></dt> +<dd><p>Set the paper size to (<var>hsize</var>,<var>vsize</var>), a comma-separated pair of dimensions such as ‘<samp>.1in,-.3cm</samp>’ (see <a href="#papersize-special">‘<samp>papersize</samp>’ special</a>). It overrides any paper size special in the DVI file. Be careful, as the paper size will stick to a predefined size if there is one close enough. To disable this behavior, use ‘<samp>-tunknown</samp>’. </p> </dd> -<dt>‘<samp>-u <var>psmapfile</var></samp>’</dt> -<dd><span id="index-_002du-psmapfile"></span> -<span id="index-PostScript-font-alias-file"></span> +<dt id='index-_002du-psmapfile'><span>‘<samp>-u <var>psmapfile</var></samp>’<a href='#index-_002du-psmapfile' class='copiable-anchor'> ¶</a></span></dt> +<dd><span id="index-PostScript-font-alias-file"></span> <span id="index-resident-fonts_002c-different-in-different-printers"></span> <p>Set <var>psmapfile</var> to be the file that dvips uses for looking up PostScript font aliases. If <var>psmapfile</var> begins with a ‘<samp>+</samp>’ @@ -1429,9 +1404,8 @@ the list). In either case, if the name has no extension, then ‘<samp>.map is added at the end. </p> </dd> -<dt>‘<samp>-U*</samp>’</dt> -<dd><span id="index-_002dU"></span> -<span id="index-Xerox-4045"></span> +<dt id='index-_002dU'><span>‘<samp>-U*</samp>’<a href='#index-_002dU' class='copiable-anchor'> ¶</a></span></dt> +<dd><span id="index-Xerox-4045"></span> <p>Disable a PostScript virtual memory-saving optimization that stores the character metric information in the same string that is used to store the bitmap information. This is only necessary when driving the Xerox @@ -1440,14 +1414,12 @@ bottom of each character. Not recommended unless you must drive this printer. </p> </dd> -<dt>‘<samp>-v</samp>’</dt> -<dd><span id="index-_002dv"></span> -<p>Print the dvips version number and exit. +<dt id='index-_002dv'><span>‘<samp>-v</samp>’<a href='#index-_002dv' class='copiable-anchor'> ¶</a></span></dt> +<dd><p>Print the dvips version number and exit. </p> </dd> -<dt>‘<samp>-V*</samp>’</dt> -<dd><span id="index-_002dV"></span> -<p>Download non-resident PostScript fonts as bitmaps. This requires use +<dt id='index-_002dV'><span>‘<samp>-V*</samp>’<a href='#index-_002dV' class='copiable-anchor'> ¶</a></span></dt> +<dd><p>Download non-resident PostScript fonts as bitmaps. This requires use <span id="index-mtpk"></span> <span id="index-gsftopk"></span> <span id="index-pstopk"></span> @@ -1460,10 +1432,9 @@ printers that have no resident fonts, i.e., very rarely. </p> </dd> -<dt>‘<samp>-x <var>num</var></samp>’</dt> -<dd><span id="index-_002dx-num"></span> -<span id="index-magnification_002c-overriding-DVI"></span> -<p>Set the magnification ratio to <em><var>num</var>/1000</em>. Overrides +<dt id='index-_002dx-num'><span>‘<samp>-x <var>num</var></samp>’<a href='#index-_002dx-num' class='copiable-anchor'> ¶</a></span></dt> +<dd><span id="index-magnification_002c-overriding-DVI"></span> +<p>Set the magnification ratio to <em class='math'><var>num</var>/1000</em>. Overrides the magnification specified in the DVI file. Must be between 10 and 100000. It is recommended that you use standard magstep values (1095, 1200, 1440, 1728, 2074, 2488, 2986, and so on) to help reduce the total @@ -1471,40 +1442,35 @@ number of PK files generated. <var>num</var> may be a real number, not an integer, for increased precision. </p> </dd> -<dt>‘<samp>-X <var>num</var></samp>’</dt> -<dd><span id="index-_002dX-num"></span> -<span id="index-resolution"></span> +<dt id='index-_002dX-num'><span>‘<samp>-X <var>num</var></samp>’<a href='#index-_002dX-num' class='copiable-anchor'> ¶</a></span></dt> +<dd><span id="index-resolution"></span> <p>Set the horizontal resolution in dots per inch to <var>num</var>. </p> </dd> -<dt>‘<samp>-y <var>num</var></samp>’</dt> -<dd><span id="index-magnification_002c-vertical"></span> -<p>Set the magnification ratio to <em><var>num</var>/1000</em> times the +<dt id='index-magnification_002c-vertical'><span>‘<samp>-y <var>num</var></samp>’<a href='#index-magnification_002c-vertical' class='copiable-anchor'> ¶</a></span></dt> +<dd><p>Set the magnification ratio to <em class='math'><var>num</var>/1000</em> times the magnification specified in the DVI file. See ‘<samp>-x</samp>’ above. </p> </dd> -<dt>‘<samp>-Y <var>num</var></samp>’</dt> -<dd><span id="index-_002dY-num"></span> -<p>Set the vertical resolution in dots per inch to <var>num.</var> +<dt id='index-_002dY-num'><span>‘<samp>-Y <var>num</var></samp>’<a href='#index-_002dY-num' class='copiable-anchor'> ¶</a></span></dt> +<dd><p>Set the vertical resolution in dots per inch to <var>num.</var> <span id="index-resolution-1"></span> </p> </dd> -<dt>‘<samp>-z*</samp>’</dt> -<dd><span id="index-_002dz-for-recognizing-hyperdvi"></span> -<span id="index-hyperdvi-extensions_002c-enabling"></span> +<dt id='index-_002dz-for-recognizing-hyperdvi'><span>‘<samp>-z*</samp>’<a href='#index-_002dz-for-recognizing-hyperdvi' class='copiable-anchor'> ¶</a></span></dt> +<dd><span id="index-hyperdvi-extensions_002c-enabling"></span> <span id="index-distillation_002c-and-_002dz"></span> <span id="index-PDF-files_002c-option-for"></span> <span id="index-html-specials_002c-and-_002dz"></span> <p>Pass ‘<samp>html</samp>’ hyperdvi specials through to the output for eventual distillation into PDF. This is not enabled by default to avoid including the header files unnecessarily, and use of temporary files in -creating the output. See <a href="#Hypertext">Hypertext</a>. +creating the output. See <a href="#Hypertext">HyperTeXt</a>. </p> </dd> -<dt>‘<samp>-Z*</samp>’</dt> -<dd><span id="index-_002dZ-for-compressing-bitmap-fonts"></span> -<span id="index-compressing-bitmap-fonts"></span> +<dt id='index-_002dZ-for-compressing-bitmap-fonts'><span>‘<samp>-Z*</samp>’<a href='#index-_002dZ-for-compressing-bitmap-fonts' class='copiable-anchor'> ¶</a></span></dt> +<dd><span id="index-compressing-bitmap-fonts"></span> <p>Compress bitmap fonts in the output file, thereby reducing the size of what gets downloaded. Especially useful at high resolutions or when very large fonts are used. May slow down printing, especially on early @@ -1516,9 +1482,12 @@ enabled in the configuration file (see <a href="#Configuration-file-commands">Co <hr> -<span id="Environment-variables"></span><div class="header"> +</div> +</div> +<div class="section" id="Environment-variables"> +<div class="header"> <p> -Next: <a href="#Config-files" accesskey="n" rel="next">Config files</a>, Previous: <a href="#Command_002dline-options" accesskey="p" rel="prev">Command-line options</a>, Up: <a href="#Invoking-Dvips" accesskey="u" rel="up">Invoking Dvips</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> +Next: <a href="#Config-files" accesskey="n" rel="next">Dvips configuration files</a>, Previous: <a href="#Command_002dline-options" accesskey="p" rel="prev">Command-line options</a>, Up: <a href="#Invoking-Dvips" accesskey="u" rel="up">Invoking Dvips</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> </div> <span id="Environment-variables-1"></span><h3 class="section">3.3 Environment variables</h3> @@ -1530,75 +1499,59 @@ configuration files are read, so they override values in the configuration files. (Except for <code>TEXCONFIG</code>, which defines where the configuration files themselves are found.) </p> -<p>See <a href="https://tug.org/texinfohtml/kpathsea.html#Path-specifications">Path specifications</a> in <cite>Kpathsea</cite>, for details of +<p>See <a data-manual="kpathsea" href="https://tug.org/texinfohtml/kpathsea.html#Path-specifications">Path specifications</a> in <cite>Kpathsea</cite>, for details of interpretation of path and other environment variables common to all Kpathsea-using programs. Only the environment variables specific to Dvips are mentioned here. </p> <dl compact="compact"> -<dt><code>DVIPSDEBUG</code> -<span id="index-DVIPSDEBUG"></span> -</dt> +<dt id='index-DVIPSDEBUG'><span><code>DVIPSDEBUG</code><a href='#index-DVIPSDEBUG' class='copiable-anchor'> ¶</a></span></dt> <dd><span id="index-KPATHSEA_005fDEBUG"></span> <p>Write the absolute path names of any configuration or map files to standard output, for debugging. This isn’t done by default because these files are read even before the banner is printed. For voluminous additional debugging, set the environment variable <code>KPATHSEA_DEBUG</code> to ‘<samp>-1</samp>’ -(see <a href="https://tug.org/texinfohtml/kpathsea.html#Debugging">Debugging</a> in <cite>Kpathsea</cite>). (If <code>KPATHSEA_DEBUG</code> is +(see <a data-manual="kpathsea" href="https://tug.org/texinfohtml/kpathsea.html#Debugging">Debugging</a> in <cite>Kpathsea</cite>). (If <code>KPATHSEA_DEBUG</code> is set to any value, it automatically turns on <code>DVIPSDEBUG</code>.) </p> </dd> -<dt><code>DVIPSFONTS</code> -<span id="index-DVIPSFONTS"></span> -</dt> +<dt id='index-DVIPSFONTS'><span><code>DVIPSFONTS</code><a href='#index-DVIPSFONTS' class='copiable-anchor'> ¶</a></span></dt> <dd><p>Default path to search for all fonts. Overrides all the font path -config file options and other environment variables (see <a href="https://tug.org/texinfohtml/kpathsea.html#Supported-file-formats">Supported +config file options and other environment variables (see <a data-manual="kpathsea" href="https://tug.org/texinfohtml/kpathsea.html#Supported-file-formats">Supported file formats</a> in <cite>Kpathsea</cite>). </p> </dd> -<dt><code>DVIPSHEADERS</code> -<span id="index-DVIPSHEADERS"></span> -</dt> +<dt id='index-DVIPSHEADERS'><span><code>DVIPSHEADERS</code><a href='#index-DVIPSHEADERS' class='copiable-anchor'> ¶</a></span></dt> <dd><p>Default path to search for PostScript header files. Overrides the ‘<samp>H</samp>’ config file option (see <a href="#Configuration-file-commands">Configuration file commands</a>). </p> </dd> -<dt><code>DVIPSMAKEPK</code> -<span id="index-DVIPSMAKEPK"></span> -</dt> +<dt id='index-DVIPSMAKEPK'><span><code>DVIPSMAKEPK</code><a href='#index-DVIPSMAKEPK' class='copiable-anchor'> ¶</a></span></dt> <dd><span id="index-mktexpk_002c-changing-name"></span> <p>Overrides ‘<samp>mktexpk</samp>’ as the name of the program to invoke to create missing PK fonts. You can change the arguments passed to the <code>mktexpk</code> program with the <code>MAKETEXPK</code> environment -variable; see <a href="https://tug.org/texinfohtml/kpathsea.html#MakeTeX-script-arguments">MakeTeX script arguments</a> in <cite>Kpathsea</cite>. +variable; see <a data-manual="kpathsea" href="https://tug.org/texinfohtml/kpathsea.html#MakeTeX-script-arguments">MakeTeX script arguments</a> in <cite>Kpathsea</cite>. </p> </dd> -<dt><code>DVIPSRC</code> -<span id="index-DVIPSRC"></span> -</dt> +<dt id='index-DVIPSRC'><span><code>DVIPSRC</code><a href='#index-DVIPSRC' class='copiable-anchor'> ¶</a></span></dt> <dd><p>Specifies the name of the startup file (see <a href="#Configuration-file-searching">Configuration file searching</a>) which is read after <samp>config.ps</samp> but before any printer-specific configuration files. </p> </dd> -<dt><code>DVIPSSIZES</code> -<span id="index-DVIPSSIZES"></span> -</dt> +<dt id='index-DVIPSSIZES'><span><code>DVIPSSIZES</code><a href='#index-DVIPSSIZES' class='copiable-anchor'> ¶</a></span></dt> <dd><span id="index-last_002dresort-font-scaling_002c-with-DVIPSSIZES"></span> <p>Last-resort sizes for scaling of unfound fonts. Overrides the ‘<samp>R</samp>’ definition in config files (see <a href="#Configuration-file-commands">Configuration file commands</a>). </p> </dd> -<dt><code>PRINTER</code> -<span id="index-PRINTER"></span> -</dt> +<dt id='index-PRINTER'><span><code>PRINTER</code><a href='#index-PRINTER' class='copiable-anchor'> ¶</a></span></dt> <dd><p>Determine the default printer configuration file. (Dvips itself does not use <code>PRINTER</code> to determine the output destination in any way.) </p> </dd> -<dt><code>TEXCONFIG</code> -<span id="index-TEXCONFIG"></span> -</dt> +<dt id='index-TEXCONFIG'><span><code>TEXCONFIG</code><a href='#index-TEXCONFIG' class='copiable-anchor'> ¶</a></span></dt> <dd><span id="index-configuration-file-path"></span> <p>Path to search for Dvips’ <samp>config.<var>printer</var></samp> configuration files, including the base <samp>config.ps</samp>. Using this single @@ -1608,19 +1561,19 @@ on MS-DOS, but <samp>config.ps</samp> is called by that name on all platforms.) </p> </dd> -<dt><code>TEXPICTS</code> -<span id="index-TEXPICTS"></span> -</dt> +<dt id='index-TEXPICTS'><span><code>TEXPICTS</code><a href='#index-TEXPICTS' class='copiable-anchor'> ¶</a></span></dt> <dd><p>Path to search for included graphics files. Overrides the ‘<samp>S</samp>’ config file option (see <a href="#Configuration-file-commands">Configuration file commands</a>). If not set, -<code>TEXINPUTS</code> is looked for. See <a href="https://tug.org/texinfohtml/kpathsea.html#Supported-file-formats">Supported file formats</a> in <cite>Kpathsea</cite>. +<code>TEXINPUTS</code> is looked for. See <a data-manual="kpathsea" href="https://tug.org/texinfohtml/kpathsea.html#Supported-file-formats">Supported file formats</a> in <cite>Kpathsea</cite>. </p> </dd> </dl> <hr> -<span id="Config-files"></span><div class="header"> +</div> +<div class="section" id="Config-files"> +<div class="header"> <p> Previous: <a href="#Environment-variables" accesskey="p" rel="prev">Environment variables</a>, Up: <a href="#Invoking-Dvips" accesskey="u" rel="up">Invoking Dvips</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> </div> @@ -1632,23 +1585,22 @@ Previous: <a href="#Environment-variables" accesskey="p" rel="prev">Environment device configuration files (called <samp>*.cfg</samp> on MS-DOS), which override the <samp>texmf.cnf</samp> configuration files generic to Kpathsea which Dvips also reads -(see <a href="https://tug.org/texinfohtml/kpathsea.html#Config-files">Config files</a> in <cite>Kpathsea</cite>). +(see <a data-manual="kpathsea" href="https://tug.org/texinfohtml/kpathsea.html#Config-files">Config files</a> in <cite>Kpathsea</cite>). </p> <p>For information about installing these files, including a prototype file -you can copy, see <a href="#config_002eps-installation">config.ps installation</a>. +you can copy, see <a href="#config_002eps-installation"><samp>config.ps</samp> installation</a>. </p> -<table class="menu" border="0" cellspacing="0"> -<tr><td align="left" valign="top">• <a href="#Configuration-file-searching" accesskey="1">Configuration file searching</a></td><td> </td><td align="left" valign="top">Where config.* files are searched for. -</td></tr> -<tr><td align="left" valign="top">• <a href="#Configuration-file-commands" accesskey="2">Configuration file commands</a></td><td> </td><td align="left" valign="top">What can go in a config.* file. -</td></tr> -</table> +<ul class="section-toc"> +<li><a href="#Configuration-file-searching" accesskey="1">Configuration file searching</a></li> +<li><a href="#Configuration-file-commands" accesskey="2">Configuration file commands</a></li> +</ul> <hr> -<span id="Configuration-file-searching"></span><div class="header"> +<div class="subsection" id="Configuration-file-searching"> +<div class="header"> <p> -Next: <a href="#Configuration-file-commands" accesskey="n" rel="next">Configuration file commands</a>, Up: <a href="#Config-files" accesskey="u" rel="up">Config files</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> +Next: <a href="#Configuration-file-commands" accesskey="n" rel="next">Configuration file commands</a>, Up: <a href="#Config-files" accesskey="u" rel="up">Dvips configuration files</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> </div> <span id="Configuration-file-searching-1"></span><h4 class="subsection">3.4.1 Configuration file searching</h4> @@ -1663,7 +1615,7 @@ or individually by each user. <li> <span id="index-config_002eps_002c-searched-for"></span> Dvips first reads (if it exists) <samp>config.ps</samp>; it is searched for along the path for Dvips configuration files, as described in -<a href="https://tug.org/texinfohtml/kpathsea.html#Supported-file-formats">Supported file formats</a> in <cite>Kpathsea</cite>. +<a data-manual="kpathsea" href="https://tug.org/texinfohtml/kpathsea.html#Supported-file-formats">Supported file formats</a> in <cite>Kpathsea</cite>. </li><li> <span id="index-_002edvipsrc_002c-searched-for"></span> A user-specific startup file is loaded, so individual users can override @@ -1675,7 +1627,7 @@ the name <samp>$HOME/.dvipsrc</samp>, which is in the user’s home director On MS-DOS and MS-Windows, where users generally don’t have their private directories, the startup file is called <samp>dvips.ini</samp> and it is searched for along the path for Dvips configuration files (as described -in <a href="https://tug.org/texinfohtml/kpathsea.html#Supported-file-formats">Supported file formats</a> in <cite>Kpathsea</cite>.); users are +in <a data-manual="kpathsea" href="https://tug.org/texinfohtml/kpathsea.html#Supported-file-formats">Supported file formats</a> in <cite>Kpathsea</cite>.); users are expected to set this path as they see fit for their taste. </li><li> <span id="index-_002dPprinter_002c-and-config-file-searching"></span> @@ -1707,19 +1659,19 @@ configuration files to be found before the system’s. overridden by configuration files: </p> <dl compact="compact"> -<dt>‘<samp>-D</samp>’</dt> +<dt><span>‘<samp>-D</samp>’</span></dt> <dd><p>As well as setting the resolution, this unsets the mode, if the mode was previously set from a configuration file. If <samp>config.$PRINTER</samp> is read, however, any ‘<samp>D</samp>’ or ‘<samp>M</samp>’ lines from there will take effect. </p> </dd> -<dt>‘<samp>-mode</samp>’</dt> +<dt><span>‘<samp>-mode</samp>’</span></dt> <dd><p>This overrides any mode setting (‘<samp>M</samp>’ line) in configuration files. ‘<samp>-mode</samp>’ does not affect the resolution. </p> </dd> -<dt>‘<samp>-o</samp>’</dt> +<dt><span>‘<samp>-o</samp>’</span></dt> <dd><p>This overrides any output setting (‘<samp>o</samp>’ line) in configuration files. </p> </dd> @@ -1732,9 +1684,11 @@ possible. </p> <hr> -<span id="Configuration-file-commands"></span><div class="header"> +</div> +<div class="subsection" id="Configuration-file-commands"> +<div class="header"> <p> -Previous: <a href="#Configuration-file-searching" accesskey="p" rel="prev">Configuration file searching</a>, Up: <a href="#Config-files" accesskey="u" rel="up">Config files</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> +Previous: <a href="#Configuration-file-searching" accesskey="p" rel="prev">Configuration file searching</a>, Up: <a href="#Config-files" accesskey="u" rel="up">Dvips configuration files</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> </div> <span id="Configuration-file-commands-1"></span><h4 class="subsection">3.4.2 Configuration file commands</h4> @@ -1755,47 +1709,39 @@ space, asterisk, equal sign, percent sign, or pound sign are ignored. There is no provision for continuation lines. </p> <dl compact="compact"> -<dt>‘<samp>@ <var>name hsize vsize</var></samp>’</dt> -<dd><span id="index-_0040-config-command-_0028define-paper-sizes_0029"></span> -<p>Define paper sizes. See <a href="#Config-file-paper-sizes">Config file paper sizes</a>. +<dt id='index-_0040-config-command-_0028define-paper-sizes_0029'><span>‘<samp>@ <var>name hsize vsize</var></samp>’<a href='#index-_0040-config-command-_0028define-paper-sizes_0029' class='copiable-anchor'> ¶</a></span></dt> +<dd><p>Define paper sizes. See <a href="#Config-file-paper-sizes">Configuration file paper size command</a>. </p> </dd> -<dt>‘<samp>a*</samp>’</dt> -<dd><span id="index-a-config-command-_0028conserve-memory_0029"></span> -<p>Memory conservation. Same as ‘<samp>-a</samp>’, see <a href="#Option-details">Option details</a>. +<dt id='index-a-config-command-_0028conserve-memory_0029'><span>‘<samp>a*</samp>’<a href='#index-a-config-command-_0028conserve-memory_0029' class='copiable-anchor'> ¶</a></span></dt> +<dd><p>Memory conservation. Same as ‘<samp>-a</samp>’, see <a href="#Option-details">Option details</a>. </p> </dd> -<dt>‘<samp>b <var>#copies</var></samp>’</dt> -<dd><span id="index-b-config-command-_0028_0023copies_0029"></span> -<p>Multiple copies. Same as ‘<samp>-b</samp>’, see <a href="#Option-details">Option details</a>. +<dt id='index-b-config-command-_0028_0023copies_0029'><span>‘<samp>b <var>#copies</var></samp>’<a href='#index-b-config-command-_0028_0023copies_0029' class='copiable-anchor'> ¶</a></span></dt> +<dd><p>Multiple copies. Same as ‘<samp>-b</samp>’, see <a href="#Option-details">Option details</a>. </p> </dd> -<dt>‘<samp>bitmapfontenc <var>option</var></samp>’</dt> -<dd><span id="index-bitmapfontenc-config-command-_0028bitmap-font-encoding_0029"></span> -<p>Turns bitmap font encoding to ‘<samp>off</samp>’, ‘<samp>on</samp>’ (no warnings +<dt id='index-bitmapfontenc-config-command-_0028bitmap-font-encoding_0029'><span>‘<samp>bitmapfontenc <var>option</var></samp>’<a href='#index-bitmapfontenc-config-command-_0028bitmap-font-encoding_0029' class='copiable-anchor'> ¶</a></span></dt> +<dd><p>Turns bitmap font encoding to ‘<samp>off</samp>’, ‘<samp>on</samp>’ (no warnings for missing bitmap font encodings), or ‘<samp>strict</samp>’ (with warnings for missing bitmap font encodings). </p> </dd> -<dt>‘<samp>c <var>filename</var></samp>’</dt> -<dd><span id="index-c-config-command-_0028include-another-config-file_0029"></span> -<p>Include <var>filename</var> as an additional configuration file, read +<dt id='index-c-config-command-_0028include-another-config-file_0029'><span>‘<samp>c <var>filename</var></samp>’<a href='#index-c-config-command-_0028include-another-config-file_0029' class='copiable-anchor'> ¶</a></span></dt> +<dd><p>Include <var>filename</var> as an additional configuration file, read immediately. </p> </dd> -<dt>‘<samp>D <var>dpi</var></samp>’</dt> -<dd><span id="index-D-config-command-_0028dpi_0029"></span> -<p>Output resolution. Same as ‘<samp>-D</samp>’, see <a href="#Option-details">Option details</a>. +<dt id='index-D-config-command-_0028dpi_0029'><span>‘<samp>D <var>dpi</var></samp>’<a href='#index-D-config-command-_0028dpi_0029' class='copiable-anchor'> ¶</a></span></dt> +<dd><p>Output resolution. Same as ‘<samp>-D</samp>’, see <a href="#Option-details">Option details</a>. </p> </dd> -<dt>‘<samp>e <var>num</var></samp>’</dt> -<dd><span id="index-e-config-command-_0028maxdrift_0029"></span> -<p>Max drift. Same as ‘<samp>-e</samp>’, see <a href="#Option-details">Option details</a>. +<dt id='index-e-config-command-_0028maxdrift_0029'><span>‘<samp>e <var>num</var></samp>’<a href='#index-e-config-command-_0028maxdrift_0029' class='copiable-anchor'> ¶</a></span></dt> +<dd><p>Max drift. Same as ‘<samp>-e</samp>’, see <a href="#Option-details">Option details</a>. </p> </dd> -<dt>‘<samp>E <var>command</var></samp>’</dt> -<dd><span id="index-E-config-command-_0028shell-escape_0029"></span> -<span id="index-system-in-config-file"></span> +<dt id='index-E-config-command-_0028shell-escape_0029'><span>‘<samp>E <var>command</var></samp>’<a href='#index-E-config-command-_0028shell-escape_0029' class='copiable-anchor'> ¶</a></span></dt> +<dd><span id="index-system-in-config-file"></span> <span id="index-datestamp_002c-in-output"></span> <span id="index-shell-escape_002c-in-config-file"></span> <p>Executes the command listed with <code>system</code>(3); can be used to get @@ -1804,57 +1750,55 @@ Possibly dangerous; this may be disabled, in which case a warning will be printed if the option is used (and warnings are not suppressed). </p> </dd> -<dt>‘<samp>f*</samp>’</dt> -<dt>‘<samp>F</samp>’</dt> -<dd><span id="index-f-config-command-_0028filter_0029"></span> -<span id="index-F-config-command-_0028filter_0029"></span> +<dt id='index-f-config-command-_0028filter_0029'><span>‘<samp>f*</samp>’<a href='#index-f-config-command-_0028filter_0029' class='copiable-anchor'> ¶</a></span></dt> +<dt><span>‘<samp>F</samp>’</span></dt> +<dd><span id="index-F-config-command-_0028filter_0029"></span> <p>Run as a filter. Same as ‘<samp>-f</samp>’, see <a href="#Option-details">Option details</a>. </p> </dd> -<dt>‘<samp>G*</samp>’</dt> -<dd><span id="index-G-config-command-_0028character-shifting_0029"></span> -<p>Shift low-numbered characters; obsolete. Same as ‘<samp>-G</samp>’, +<dt id='index-G-config-command-_0028character-shifting_0029'><span>‘<samp>G*</samp>’<a href='#index-G-config-command-_0028character-shifting_0029' class='copiable-anchor'> ¶</a></span></dt> +<dd><p>Shift low-numbered characters; obsolete. Same as ‘<samp>-G</samp>’, see <a href="#Option-details">Option details</a>. </p> </dd> -<dt>‘<samp>h <var>header</var></samp>’</dt> -<dd><span id="index-h-config-command-_0028download-additional-header_0029"></span> -<p>Prepend <var>header</var> to output. Same as ‘<samp>h-</samp>’, see <a href="#Option-details">Option details</a>. +<dt id='index-h-config-command-_0028download-additional-header_0029'><span>‘<samp>h <var>header</var></samp>’<a href='#index-h-config-command-_0028download-additional-header_0029' class='copiable-anchor'> ¶</a></span></dt> +<dd><p>Prepend <var>header</var> to output. Same as ‘<samp>h-</samp>’; that is, the +config file <code>h</code> directive suppresses any inclusion of standard +headers (see <a href="#Option-details">Option details</a>). </p> </dd> -<dt>‘<samp>H <var>path</var></samp>’</dt> -<dd><span id="index-H-config-command-_0028PostScript-header-path_0029"></span> -<span id="index-header-path_002c-defining"></span> +<dt id='index-H-config-command-_0028PostScript-header-path_0029'><span>‘<samp>H <var>path</var></samp>’<a href='#index-H-config-command-_0028PostScript-header-path_0029' class='copiable-anchor'> ¶</a></span></dt> +<dd><span id="index-header-path_002c-defining"></span> <span id="index-DVIPSHEADERS_002c-overrides-H"></span> <p>Use <var>path</var> to search for PostScript header files. The environment variable <code>DVIPSHEADERS</code> overrides this. </p> </dd> -<dt>‘<samp>i <var>n</var></samp>’</dt> -<dd><span id="index-i-config-command-_0028pages_002fsection_0029"></span> -<p>Make multiple output files. Same as ‘<samp>-i -S <var>n</var></samp>’, see <a href="#Option-details">Option details</a>. +<dt id='index-i-config-command-_0028pages_002fsection_0029'><span>‘<samp>i <var>n</var></samp>’<a href='#index-i-config-command-_0028pages_002fsection_0029' class='copiable-anchor'> ¶</a></span></dt> +<dd><p>Make multiple output files. Same as ‘<samp>-i -S <var>n</var></samp>’, see <a href="#Option-details">Option details</a>. </p> </dd> -<dt>‘<samp>j*</samp>’</dt> -<dd><span id="index-j-config-command-_0028partial-font-downloading_0029"></span> -<p>Partially download Type 1 fonts. Same as ‘<samp>-j</samp>’, see <a href="#Option-details">Option details</a>. +<dt id='index-j-config-command-_0028partial-font-downloading_0029'><span>‘<samp>j*</samp>’<a href='#index-j-config-command-_0028partial-font-downloading_0029' class='copiable-anchor'> ¶</a></span></dt> +<dd><p>Partially download Type 1 fonts. Same as ‘<samp>-j</samp>’, see <a href="#Option-details">Option details</a>. </p> </dd> -<dt>‘<samp>K*</samp>’</dt> -<dd><span id="index-K-config-command-_0028comment-removal_0029"></span> -<p>Remove comments from included PostScript files. Same as ‘<samp>-K</samp>’, +<dt id='index-K-config-command-_0028comment-removal_0029'><span>‘<samp>K*</samp>’<a href='#index-K-config-command-_0028comment-removal_0029' class='copiable-anchor'> ¶</a></span></dt> +<dd><p>Remove comments from included PostScript files. Same as ‘<samp>-K</samp>’, see <a href="#Option-details">Option details</a>. </p> </dd> -<dt>‘<samp>L*</samp>’</dt> -<dd><span id="index-L-config-command-_0028last-paper-size-wins_0029"></span> -<p>If zero, the first paper size specified is effective, else the last. +<dt id='index-L-config-command-_0028last-paper-size-wins_0029'><span>‘<samp>L*</samp>’<a href='#index-L-config-command-_0028last-paper-size-wins_0029' class='copiable-anchor'> ¶</a></span></dt> +<dd><p>If zero, the first paper size specified is effective, else the last. Same as ‘<samp>-L</samp>’, see <a href="#Option-details">Option details</a>. </p> </dd> -<dt>‘<samp>m <var>num</var></samp>’</dt> -<dd><span id="index-m-config-command-_0028available-memory_0029"></span> -<span id="index-memory-available"></span> +<dt id='index-landscaperotate-config-command'><span>‘<samp>landscaperotate</samp>’<a href='#index-landscaperotate-config-command' class='copiable-anchor'> ¶</a></span></dt> +<dd><p>Permit rotation of page content to match page size. +Same as ‘<samp>-landscaperotate</samp>’, see <a href="#Option-details">Option details</a>. +</p> +</dd> +<dt id='index-m-config-command-_0028available-memory_0029'><span>‘<samp>m <var>num</var></samp>’<a href='#index-m-config-command-_0028available-memory_0029' class='copiable-anchor'> ¶</a></span></dt> +<dd><span id="index-memory-available"></span> <span id="index-printer-memory"></span> <p>Declare <var>num</var> as the memory available for fonts and strings in the printer. The compile-time default is 180000, but this is typically @@ -1886,21 +1830,18 @@ splitting of the output is desirable. The Dvips config file ‘<samp>dvips -Pmaxmem</samp>’. </p> </dd> -<dt>‘<samp>M <var>mode</var></samp>’</dt> -<dd><span id="index-M-config-command-_0028mf-mode_0029"></span> -<p>Metafont mode. Same as ‘<samp>-mode</samp>’, see <a href="#Option-details">Option details</a>. +<dt id='index-M-config-command-_0028mf-mode_0029'><span>‘<samp>M <var>mode</var></samp>’<a href='#index-M-config-command-_0028mf-mode_0029' class='copiable-anchor'> ¶</a></span></dt> +<dd><p>Metafont mode. Same as ‘<samp>-mode</samp>’, see <a href="#Option-details">Option details</a>. </p> </dd> -<dt>‘<samp>N*</samp>’</dt> -<dd><span id="index-N--config-command-_0028disable-EPS_0029"></span> -<p>Disable structured comments. Beware: This also turns off displaying -page numbers or changing to specific pagenumbers in PostScript viewers. +<dt id='index-N--config-command-_0028disable-EPS_0029'><span>‘<samp>N*</samp>’<a href='#index-N--config-command-_0028disable-EPS_0029' class='copiable-anchor'> ¶</a></span></dt> +<dd><p>Disable structured comments. Beware: This also turns off displaying +page numbers or changing to specific page numbers in PostScript viewers. Same as ‘<samp>-N</samp>’, see <a href="#Option-details">Option details</a>. </p> </dd> -<dt>‘<samp>o <var>name</var></samp>’</dt> -<dd><span id="index-o-config-command-_0028output-destination_0029"></span> -<span id="index-output-file_002c-setting"></span> +<dt id='index-o-config-command-_0028output-destination_0029'><span>‘<samp>o <var>name</var></samp>’<a href='#index-o-config-command-_0028output-destination_0029' class='copiable-anchor'> ¶</a></span></dt> +<dd><span id="index-output-file_002c-setting"></span> <p>Send output to <var>name</var>. Same as ‘<samp>-o</samp>’, see <a href="#Option-details">Option details</a>. In the file <samp>config.foo</samp>, a setting like this is probably appropriate: @@ -1912,14 +1853,12 @@ the local printer device <samp>PRN</samp> if it doesn’t find an executable program by that name in the current directory or along the <code>PATH</code>. </p> </dd> -<dt>‘<samp>O <var>xoff</var>,<var>yoff</var></samp>’</dt> -<dd><span id="index-O-config-command-_0028page-offsets_0029"></span> -<p>Origin offset. Same as ‘<samp>-O</samp>’, see <a href="#Option-details">Option details</a>. +<dt id='index-O-config-command-_0028page-offsets_0029'><span>‘<samp>O <var>xoff</var>,<var>yoff</var></samp>’<a href='#index-O-config-command-_0028page-offsets_0029' class='copiable-anchor'> ¶</a></span></dt> +<dd><p>Origin offset. Same as ‘<samp>-O</samp>’, see <a href="#Option-details">Option details</a>. </p> </dd> -<dt>‘<samp>p <span class="roman">[+]</span><var>name</var></samp>’</dt> -<dd><span id="index-p-config-command-_0028font-aliases_0029"></span> -<span id="index-PostScript-font-alias-file-1"></span> +<dt id='index-p-config-command-_0028font-aliases_0029'><span>‘<samp>p <span class="roman">[+]</span><var>name</var></samp>’<a href='#index-p-config-command-_0028font-aliases_0029' class='copiable-anchor'> ¶</a></span></dt> +<dd><span id="index-PostScript-font-alias-file-1"></span> <span id="index-resident-fonts_002c-different-in-different-printers-1"></span> <span id="index-_002bpsmapfile"></span> <p>Examine <var>name</var> for PostScript font aliases. Default is @@ -1931,32 +1870,28 @@ map files pointed to by local configuration files that append to the global map file. This can be used for font families. </p> </dd> -<dt>‘<samp>P <var>path</var></samp>’</dt> -<dd><span id="index-P-config-command-_0028PK-path_0029"></span> -<span id="index-PKFONTS_002c-overrides-P"></span> +<dt id='index-P-config-command-_0028PK-path_0029'><span>‘<samp>P <var>path</var></samp>’<a href='#index-P-config-command-_0028PK-path_0029' class='copiable-anchor'> ¶</a></span></dt> +<dd><span id="index-PKFONTS_002c-overrides-P"></span> <span id="index-TEXPKS_002c-overrides-P"></span> <span id="index-GLYPHFONTS_002c-overrides-P"></span> <span id="index-TEXFONTS_002c-overrides-P"></span> <p>Use <var>path</var> to search for bitmap PK font files is <var>path</var>. The <code>PKFONTS</code>, <code>TEXPKS</code>, <code>GLYPHFONTS</code>, and <code>TEXFONTS</code> -environment variables override this. See <a href="https://tug.org/texinfohtml/kpathsea.html#Supported-file-formats">Supported file formats</a> in <cite>Kpathsea</cite>. +environment variables override this. See <a data-manual="kpathsea" href="https://tug.org/texinfohtml/kpathsea.html#Supported-file-formats">Supported file formats</a> in <cite>Kpathsea</cite>. </p> </dd> -<dt>‘<samp>q*</samp>’</dt> -<dt>‘<samp>Q</samp>’</dt> -<dd><span id="index-q-config-command-_0028quiet_0029"></span> -<span id="index-Q-config-command-_0028quiet_0029"></span> +<dt id='index-q-config-command-_0028quiet_0029'><span>‘<samp>q*</samp>’<a href='#index-q-config-command-_0028quiet_0029' class='copiable-anchor'> ¶</a></span></dt> +<dt><span>‘<samp>Q</samp>’</span></dt> +<dd><span id="index-Q-config-command-_0028quiet_0029"></span> <p>Run quietly. Same as ‘<samp>-q</samp>’, see <a href="#Option-details">Option details</a>. </p> </dd> -<dt>‘<samp>r*</samp>’</dt> -<dd><span id="index-r-config-command-_0028page-reversal_0029"></span> -<p>Page reversal. Same as ‘<samp>-r</samp>’, see <a href="#Option-details">Option details</a>. +<dt id='index-r-config-command-_0028page-reversal_0029'><span>‘<samp>r*</samp>’<a href='#index-r-config-command-_0028page-reversal_0029' class='copiable-anchor'> ¶</a></span></dt> +<dd><p>Page reversal. Same as ‘<samp>-r</samp>’, see <a href="#Option-details">Option details</a>. </p> </dd> -<dt>‘<samp>R <var>num1 num2 …</var></samp>’</dt> -<dd><span id="index-R-config-command-_0028fallback-resolution_0029"></span> -<span id="index-fallback-resolutions"></span> +<dt id='index-R-config-command-_0028fallback-resolution_0029'><span>‘<samp>R <var>num1 num2 …</var></samp>’<a href='#index-R-config-command-_0028fallback-resolution_0029' class='copiable-anchor'> ¶</a></span></dt> +<dd><span id="index-fallback-resolutions"></span> <span id="index-default-resolutions"></span> <span id="index-last_002dresort-scaling_002c-with-R"></span> <p>Define the list of default resolutions for PK fonts. If a font size @@ -1983,46 +1918,40 @@ the Makefile variable ‘<samp>default_texsizes</samp>’, defined in th <samp>make/paths.make</samp>. </p> </dd> -<dt>‘<samp>s*</samp>’</dt> -<dd><span id="index-s-config-command-_0028global-save_002frestore_0029"></span> -<p>Output global save/restore. Same as ‘<samp>-s</samp>’, see <a href="#Option-details">Option details</a>. +<dt id='index-s-config-command-_0028global-save_002frestore_0029'><span>‘<samp>s*</samp>’<a href='#index-s-config-command-_0028global-save_002frestore_0029' class='copiable-anchor'> ¶</a></span></dt> +<dd><p>Output global save/restore. Same as ‘<samp>-s</samp>’, see <a href="#Option-details">Option details</a>. </p> </dd> -<dt>‘<samp>S <var>path</var></samp>’</dt> -<dd><span id="index-S-config-command-_0028pict-path_0029"></span> -<span id="index-TEXPICTS_002c-overrides-S"></span> +<dt id='index-S-config-command-_0028pict-path_0029'><span>‘<samp>S <var>path</var></samp>’<a href='#index-S-config-command-_0028pict-path_0029' class='copiable-anchor'> ¶</a></span></dt> +<dd><span id="index-TEXPICTS_002c-overrides-S"></span> <span id="index-TEXINPUTS_002c-overrides-S"></span> <p>Use <var>path</var> to search for special illustrations (Encapsulated PostScript files or psfiles). The <code>TEXPICTS</code> and then <code>TEXINPUTS</code> environment variables override this. </p> </dd> -<dt>‘<samp>T <var>path</var></samp>’</dt> -<dd><span id="index-T-config-command-_0028TFM-path_0029"></span> -<span id="index-TFMFONTS_002c-overrides-T"></span> +<dt id='index-T-config-command-_0028TFM-path_0029'><span>‘<samp>T <var>path</var></samp>’<a href='#index-T-config-command-_0028TFM-path_0029' class='copiable-anchor'> ¶</a></span></dt> +<dd><span id="index-TFMFONTS_002c-overrides-T"></span> <span id="index-TEXFONTS_002c-overrides-T"></span> <p>Use <var>path</var> to search for TFM files. The <code>TFMFONTS</code> and then <code>TEXFONTS</code> environment variables overrides this. This path is used for resident fonts and fonts that can’t otherwise be found. </p> </dd> -<dt>‘<samp>U*</samp>’</dt> -<dd><span id="index-U-config-command-_0028Xerox-4045_0029"></span> -<p>Work around bug in Xerox 4045 printer. Same as ‘<samp>-U</samp>’, see <a href="#Option-details">Option details</a>. +<dt id='index-U-config-command-_0028Xerox-4045_0029'><span>‘<samp>U*</samp>’<a href='#index-U-config-command-_0028Xerox-4045_0029' class='copiable-anchor'> ¶</a></span></dt> +<dd><p>Work around bug in Xerox 4045 printer. Same as ‘<samp>-U</samp>’, see <a href="#Option-details">Option details</a>. </p> </dd> -<dt>‘<samp>V <var>path</var></samp>’</dt> -<dd><span id="index-V-config-command-_0028vf-path_0029"></span> -<span id="index-virtual-font-path"></span> +<dt id='index-V-config-command-_0028vf-path_0029'><span>‘<samp>V <var>path</var></samp>’<a href='#index-V-config-command-_0028vf-path_0029' class='copiable-anchor'> ¶</a></span></dt> +<dd><span id="index-virtual-font-path"></span> <span id="index-device-dependency_002c-and-virtual-fonts"></span> <p>Use <var>path</var> to search for virtual font files. This may be device-dependent if you use virtual fonts to simulate actual fonts on different devices. </p> </dd> -<dt>‘<samp>W <span class="roman">[<var>string</var>]</span></samp>’</dt> -<dd><span id="index-W-config-command-_0028emit-warning_0029"></span> -<span id="index-warning-messages_002c-defining"></span> +<dt id='index-W-config-command-_0028emit-warning_0029'><span>‘<samp>W <span class="roman">[<var>string</var>]</span></samp>’<a href='#index-W-config-command-_0028emit-warning_0029' class='copiable-anchor'> ¶</a></span></dt> +<dd><span id="index-warning-messages_002c-defining"></span> <p>If <var>string</var> is supplied, write it to standard error after reading all the configuration files; with no <var>string</var>, cancel any previous ‘<samp>W</samp>’ message. This is useful in the default configuration file to @@ -2030,24 +1959,20 @@ remind users to specify a printer, for instance, or to notify users about special characteristics of a particular printer. </p> </dd> -<dt>‘<samp>X <var>num</var></samp>’</dt> -<dd><span id="index-X-config-command-_0028horizontal-resolution_0029"></span> -<p>Horizontal resolution. Same as ‘<samp>-X</samp>’ (see <a href="#Option-details">Option details</a>). +<dt id='index-X-config-command-_0028horizontal-resolution_0029'><span>‘<samp>X <var>num</var></samp>’<a href='#index-X-config-command-_0028horizontal-resolution_0029' class='copiable-anchor'> ¶</a></span></dt> +<dd><p>Horizontal resolution. Same as ‘<samp>-X</samp>’ (see <a href="#Option-details">Option details</a>). </p> </dd> -<dt>‘<samp>Y <var>num</var></samp>’</dt> -<dd><span id="index-Y-config-command-_0028vertical-resolution_0029"></span> -<p>Vertical resolution. Same as ‘<samp>-Y</samp>’ (see <a href="#Option-details">Option details</a>). +<dt id='index-Y-config-command-_0028vertical-resolution_0029'><span>‘<samp>Y <var>num</var></samp>’<a href='#index-Y-config-command-_0028vertical-resolution_0029' class='copiable-anchor'> ¶</a></span></dt> +<dd><p>Vertical resolution. Same as ‘<samp>-Y</samp>’ (see <a href="#Option-details">Option details</a>). </p> </dd> -<dt>‘<samp>Z*</samp>’</dt> -<dd><span id="index-Z-config-command-_0028compress-fonts_0029"></span> -<p>Compress bitmap fonts. Same as ‘<samp>-Z</samp>’ (see <a href="#Option-details">Option details</a>). +<dt id='index-Z-config-command-_0028compress-fonts_0029'><span>‘<samp>Z*</samp>’<a href='#index-Z-config-command-_0028compress-fonts_0029' class='copiable-anchor'> ¶</a></span></dt> +<dd><p>Compress bitmap fonts. Same as ‘<samp>-Z</samp>’ (see <a href="#Option-details">Option details</a>). </p> </dd> -<dt>‘<samp>z*</samp>’</dt> -<dd><span id="index-z-config-command-_0028secure-mode_0029"></span> -<p>Disables execution of system commands, like ‘<samp>-R</samp>’ +<dt id='index-z-config-command-_0028secure-mode_0029'><span>‘<samp>z*</samp>’<a href='#index-z-config-command-_0028secure-mode_0029' class='copiable-anchor'> ¶</a></span></dt> +<dd><p>Disables execution of system commands, like ‘<samp>-R</samp>’ (see <a href="#Option-details">Option details</a>). If ‘<samp>-R</samp>’ is specified on the command line, that takes precedence. </p> @@ -2056,9 +1981,13 @@ on the command line, that takes precedence. <hr> -<span id="Paper-size-and-landscape"></span><div class="header"> +</div> +</div> +</div> +<div class="chapter" id="Paper-size-and-landscape"> +<div class="header"> <p> -Next: <a href="#Interaction-with-PostScript" accesskey="n" rel="next">Interaction with PostScript</a>, Previous: <a href="#Invoking-Dvips" accesskey="p" rel="prev">Invoking Dvips</a>, Up: <a href="#Top" accesskey="u" rel="up">Top</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> +Next: <a href="#Interaction-with-PostScript" accesskey="n" rel="next">Interaction with PostScript</a>, Previous: <a href="#Invoking-Dvips" accesskey="p" rel="prev">Invoking Dvips</a>, Up: <a href="#Top" accesskey="u" rel="up">Dvips</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> </div> <span id="Paper-size-and-landscape-orientation"></span><h2 class="chapter">4 Paper size and landscape orientation</h2> @@ -2090,20 +2019,18 @@ printer drivers. ‘<samp>papersize</samp>’ special into the DVI file. In this case, you need not and should not attempt to override it manually. </p> -<table class="menu" border="0" cellspacing="0"> -<tr><td align="left" valign="top">• <a href="#papersize-special" accesskey="1">‘<samp>papersize</samp>’ special</a></td><td> </td><td align="left" valign="top">Specifying the paper size in TeX. -</td></tr> -<tr><td align="left" valign="top">• <a href="#Config-file-paper-sizes" accesskey="2">Config file paper sizes</a></td><td> </td><td align="left" valign="top">Specifying printer- and site-specific sizes. -</td></tr> -<tr><td align="left" valign="top">• <a href="#Paper-trays" accesskey="3">Paper trays</a></td><td> </td><td align="left" valign="top">Changing paper trays automatically. -</td></tr> -</table> +<ul class="section-toc"> +<li><a href="#papersize-special" accesskey="1">‘<samp>papersize</samp>’ special</a></li> +<li><a href="#Config-file-paper-sizes" accesskey="2">Configuration file paper size command</a></li> +<li><a href="#Paper-trays" accesskey="3">Paper trays</a></li> +</ul> <hr> -<span id="papersize-special"></span><div class="header"> +<div class="section" id="papersize-special"> +<div class="header"> <p> -Next: <a href="#Config-file-paper-sizes" accesskey="n" rel="next">Config file paper sizes</a>, Up: <a href="#Paper-size-and-landscape" accesskey="u" rel="up">Paper size and landscape</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> +Next: <a href="#Config-file-paper-sizes" accesskey="n" rel="next">Configuration file paper size command</a>, Up: <a href="#Paper-size-and-landscape" accesskey="u" rel="up">Paper size and landscape orientation</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> </div> <span id="papersize-special-1"></span><h3 class="section">4.1 ‘<samp>papersize</samp>’ special</h3> @@ -2133,7 +2060,7 @@ unit), pc (picas), dd (didot points), and cc (ciceros). </pre></div> <p>This is supported for backward compatibility, but it is hoped that -reventually the ‘<samp>papersize</samp>’ comment will dominate. +eventually the ‘<samp>papersize</samp>’ comment will dominate. </p> <p>Of course, such a <code>\special</code> only informs Dvips of the desired paper size; you must also adjust <code>\hsize</code> and <code>\vsize</code> in your @@ -2156,9 +2083,11 @@ behavior of Dvips prior to the 2017 release. </p> <hr> -<span id="Config-file-paper-sizes"></span><div class="header"> +</div> +<div class="section" id="Config-file-paper-sizes"> +<div class="header"> <p> -Next: <a href="#Paper-trays" accesskey="n" rel="next">Paper trays</a>, Previous: <a href="#papersize-special" accesskey="p" rel="prev">‘<samp>papersize</samp>’ special</a>, Up: <a href="#Paper-size-and-landscape" accesskey="u" rel="up">Paper size and landscape</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> +Next: <a href="#Paper-trays" accesskey="n" rel="next">Paper trays</a>, Previous: <a href="#papersize-special" accesskey="p" rel="prev">‘<samp>papersize</samp>’ special</a>, Up: <a href="#Paper-size-and-landscape" accesskey="u" rel="up">Paper size and landscape orientation</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> </div> <span id="Configuration-file-paper-size-command"></span><h3 class="section">4.2 Configuration file paper size command</h3> @@ -2226,8 +2155,26 @@ zero dimensions is used; this should be the <code>unknown</code> paper size definition mentioned below, resulting in the actual dimensions being used. </p> -<p>Landscape mode for all paper sizes is automatically supported. -</p> +<span id="index-landscaperotate-configuration-file-command"></span> +<span id="index-landscaperotate-command-line-option"></span> +<p>In versions of Dvips prior to 2022.1, if the paper size specified did +not match one of the defined paper sizes, Dvips considered rotated +page content and rotated paper sizes for a match. This provided some +automatic support for landscape mode on raw printers, but today it can +be harmful when generating PDF. (Specifically, the ‘<samp>/MediaBox</samp>’ +then ends up with rotated values, which is not expected by PDF +viewers, e.g., when a document intentionally has a single page +rotated.) +</p> +<p>Further, on all recent computer systems, this facility is typically +provided instead by a print spooler that considers the bounding box of +the document and inserts appropriate media selection commands as part +of the print job. So, this automatic rotation is no longer done by +default by Dvips. If you want to enable it, the +‘<samp>-landscaperotate</samp>’ command line option or ‘<samp>landscaperotate</samp>’ +configuration file option can be used. See <a href="#Option-details">Option details</a>. +</p> +<span id="index-zero-dimensions-and-setting-paper-size"></span> <p>If your printer has a command to set a special paper size, then give dimensions of ‘<samp>0in 0in</samp>’; the PostScript code that sets the paper size can refer to the dimensions the user requested as ‘<samp>hsize</samp>’ @@ -2275,9 +2222,11 @@ synonyms for <code>letter</code> and <code>a4</code>. </p> <hr> -<span id="Paper-trays"></span><div class="header"> +</div> +<div class="section" id="Paper-trays"> +<div class="header"> <p> -Previous: <a href="#Config-file-paper-sizes" accesskey="p" rel="prev">Config file paper sizes</a>, Up: <a href="#Paper-size-and-landscape" accesskey="u" rel="up">Paper size and landscape</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> +Previous: <a href="#Config-file-paper-sizes" accesskey="p" rel="prev">Configuration file paper size command</a>, Up: <a href="#Paper-size-and-landscape" accesskey="u" rel="up">Paper size and landscape orientation</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> </div> <span id="Paper-trays-1"></span><h3 class="section">4.3 Paper trays</h3> @@ -2322,9 +2271,12 @@ commands to select the paper trays. On the 4SI, <var>alternatetray</var> is <hr> -<span id="Interaction-with-PostScript"></span><div class="header"> +</div> +</div> +<div class="chapter" id="Interaction-with-PostScript"> +<div class="header"> <p> -Next: <a href="#PostScript-fonts" accesskey="n" rel="next">PostScript fonts</a>, Previous: <a href="#Paper-size-and-landscape" accesskey="p" rel="prev">Paper size and landscape</a>, Up: <a href="#Top" accesskey="u" rel="up">Top</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> +Next: <a href="#PostScript-fonts" accesskey="n" rel="next">PostScript fonts</a>, Previous: <a href="#Paper-size-and-landscape" accesskey="p" rel="prev">Paper size and landscape orientation</a>, Up: <a href="#Top" accesskey="u" rel="up">Dvips</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> </div> <span id="Interaction-with-PostScript-1"></span><h2 class="chapter">5 Interaction with PostScript</h2> @@ -2335,22 +2287,19 @@ Next: <a href="#PostScript-fonts" accesskey="n" rel="next">PostScript fonts</a>, PostScript), downloading other header files (e.g., fonts), including literal PostScript code, and hypertext. </p> -<table class="menu" border="0" cellspacing="0"> -<tr><td align="left" valign="top">• <a href="#PostScript-figures" accesskey="1">PostScript figures</a></td><td> </td><td align="left" valign="top">Including an Encapsulated PostScript figure. -</td></tr> -<tr><td align="left" valign="top">• <a href="#Header-files" accesskey="2">Header files</a></td><td> </td><td align="left" valign="top">Downloading extra definitions. -</td></tr> -<tr><td align="left" valign="top">• <a href="#Literal-PS" accesskey="3">Literal PS</a></td><td> </td><td align="left" valign="top">Writing literal PostScript code. -</td></tr> -<tr><td align="left" valign="top">• <a href="#Hypertext" accesskey="4">Hypertext</a></td><td> </td><td align="left" valign="top">Producing HyperPostScript to make PDF. -</td></tr> -</table> +<ul class="section-toc"> +<li><a href="#PostScript-figures" accesskey="1">PostScript figures</a></li> +<li><a href="#Header-files" accesskey="2">PostScript header files</a></li> +<li><a href="#Literal-PS" accesskey="3">Literal PostScript</a></li> +<li><a href="#Hypertext" accesskey="4">HyperTeXt</a></li> +</ul> <hr> -<span id="PostScript-figures"></span><div class="header"> +<div class="section" id="PostScript-figures"> +<div class="header"> <p> -Next: <a href="#Header-files" accesskey="n" rel="next">Header files</a>, Up: <a href="#Interaction-with-PostScript" accesskey="u" rel="up">Interaction with PostScript</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> +Next: <a href="#Header-files" accesskey="n" rel="next">PostScript header files</a>, Up: <a href="#Interaction-with-PostScript" accesskey="u" rel="up">Interaction with PostScript</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> </div> <span id="PostScript-figures-1"></span><h3 class="section">5.1 PostScript figures</h3> @@ -2358,26 +2307,21 @@ Next: <a href="#Header-files" accesskey="n" rel="next">Header files</a>, Up: <a file is correctly formed. Even if it is not, however, the file can usually be accommodated with just a little more work. </p> -<table class="menu" border="0" cellspacing="0"> -<tr><td align="left" valign="top">• <a href="#Bounding-box" accesskey="1">Bounding box</a></td><td> </td><td align="left" valign="top">The %%BoundingBox EPS comment. -</td></tr> -<tr><td align="left" valign="top">• <a href="#g_t_005cincludegraphics" accesskey="2">\includegraphics</a></td><td> </td><td align="left" valign="top">The LaTeX \includegraphics macro. -</td></tr> -<tr><td align="left" valign="top">• <a href="#EPSF-macros" accesskey="3">EPSF macros</a></td><td> </td><td align="left" valign="top">Including the file in TeX. -</td></tr> -<tr><td align="left" valign="top">• <a href="#psfile-special" accesskey="4">psfile special</a></td><td> </td><td align="left" valign="top">The basic special. -</td></tr> -<tr><td align="left" valign="top">• <a href="#Dynamic-creation-of-graphics" accesskey="5">Dynamic creation of graphics</a></td><td> </td><td align="left" valign="top">Handling compressed or generated figures. -</td></tr> -<tr><td align="left" valign="top">• <a href="#Fonts-in-figures" accesskey="6">Fonts in figures</a></td><td> </td><td align="left" valign="top">The %*Font comment. -</td></tr> -</table> +<ul class="section-toc"> +<li><a href="#Bounding-box" accesskey="1">The bounding box comment</a></li> +<li><a href="#g_t_005cincludegraphics" accesskey="2">The \includegraphics macro for LaTeX</a></li> +<li><a href="#EPSF-macros" accesskey="3">Using the EPSF macros</a></li> +<li><a href="#psfile-special" accesskey="4">‘<samp>psfile</samp>’ special</a></li> +<li><a href="#Dynamic-creation-of-graphics" accesskey="5">Dynamic creation of PostScript graphics files</a></li> +<li><a href="#Fonts-in-figures" accesskey="6">Fonts in figures</a></li> +</ul> <hr> -<span id="Bounding-box"></span><div class="header"> +<div class="subsection" id="Bounding-box"> +<div class="header"> <p> -Next: <a href="#g_t_005cincludegraphics" accesskey="n" rel="next">\includegraphics</a>, Up: <a href="#PostScript-figures" accesskey="u" rel="up">PostScript figures</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> +Next: <a href="#g_t_005cincludegraphics" accesskey="n" rel="next">The \includegraphics macro for LaTeX</a>, Up: <a href="#PostScript-figures" accesskey="u" rel="up">PostScript figures</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> </div> <span id="The-bounding-box-comment"></span><h4 class="subsection">5.1.1 The bounding box comment</h4> @@ -2472,9 +2416,11 @@ the file. </p> <hr> -<span id="g_t_005cincludegraphics"></span><div class="header"> +</div> +<div class="subsection" id="g_t_005cincludegraphics"> +<div class="header"> <p> -Next: <a href="#EPSF-macros" accesskey="n" rel="next">EPSF macros</a>, Previous: <a href="#Bounding-box" accesskey="p" rel="prev">Bounding box</a>, Up: <a href="#PostScript-figures" accesskey="u" rel="up">PostScript figures</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> +Next: <a href="#EPSF-macros" accesskey="n" rel="next">Using the EPSF macros</a>, Previous: <a href="#Bounding-box" accesskey="p" rel="prev">The bounding box comment</a>, Up: <a href="#PostScript-figures" accesskey="u" rel="up">PostScript figures</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> </div> <span id="The-_005cincludegraphics-macro-for-LaTeX"></span><h4 class="subsection">5.1.2 The \includegraphics macro for LaTeX</h4> @@ -2543,9 +2489,11 @@ account. </p> <hr> -<span id="EPSF-macros"></span><div class="header"> +</div> +<div class="subsection" id="EPSF-macros"> +<div class="header"> <p> -Next: <a href="#psfile-special" accesskey="n" rel="next">psfile special</a>, Previous: <a href="#g_t_005cincludegraphics" accesskey="p" rel="prev">\includegraphics</a>, Up: <a href="#PostScript-figures" accesskey="u" rel="up">PostScript figures</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> +Next: <a href="#psfile-special" accesskey="n" rel="next">‘<samp>psfile</samp>’ special</a>, Previous: <a href="#g_t_005cincludegraphics" accesskey="p" rel="prev">The \includegraphics macro for LaTeX</a>, Up: <a href="#PostScript-figures" accesskey="u" rel="up">PostScript figures</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> </div> <span id="Using-the-EPSF-macros"></span><h4 class="subsection">5.1.3 Using the EPSF macros</h4> @@ -2553,7 +2501,7 @@ Next: <a href="#psfile-special" accesskey="n" rel="next">psfile special</a>, Pre <span id="index-macros-for-epsf-inclusion-1"></span> <p>If you are using LaTeX2e, use the ‘<samp>graphics</samp>’ or ‘<samp>graphicx</samp>’ -package. See <a href="#g_t_005cincludegraphics">\includegraphics</a>. +package. See <a href="#g_t_005cincludegraphics">The \includegraphics macro for LaTeX</a>. </p> <p>If you are using plain TeX or LaTeX 2.09, you need <samp>epsf.tex</samp> (for plain TeX) and <samp>epsf.sty</samp> (for LaTeX). For plain @@ -2616,18 +2564,17 @@ terminal when it processes each figure, give the command: <pre class="example">\epsfverbosetrue </pre></div> -<table class="menu" border="0" cellspacing="0"> -<tr><td align="left" valign="top">• <a href="#EPSF-scaling" accesskey="1">EPSF scaling</a></td><td> </td><td align="left" valign="top"> -</td></tr> -<tr><td align="left" valign="top">• <a href="#EPSF-clipping" accesskey="2">EPSF clipping</a></td><td> </td><td align="left" valign="top"> -</td></tr> -</table> +<ul class="section-toc"> +<li><a href="#EPSF-scaling" accesskey="1">EPSF scaling</a></li> +<li><a href="#EPSF-clipping" accesskey="2">EPSF clipping</a></li> +</ul> <hr> -<span id="EPSF-scaling"></span><div class="header"> +<div class="subsubsection" id="EPSF-scaling"> +<div class="header"> <p> -Next: <a href="#EPSF-clipping" accesskey="n" rel="next">EPSF clipping</a>, Up: <a href="#EPSF-macros" accesskey="u" rel="up">EPSF macros</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> +Next: <a href="#EPSF-clipping" accesskey="n" rel="next">EPSF clipping</a>, Up: <a href="#EPSF-macros" accesskey="u" rel="up">Using the EPSF macros</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> </div> <span id="EPSF-scaling-1"></span><h4 class="subsubsection">5.1.3.1 EPSF scaling</h4> @@ -2677,31 +2624,31 @@ that is, the width of the <code>\vbox</code>. Schematically: <p>Some useful definitions of <var>body</var>: </p> <dl compact="compact"> -<dt>‘<samp>\epsfxsize</samp>’</dt> +<dt><span>‘<samp>\epsfxsize</samp>’</span></dt> <dd><p>This definition (the default) enables the default features listed above, by setting <code>\epsfxsize</code> to the same value it had before the macro was called. </p> </dd> -<dt>‘<samp>#1</samp>’</dt> +<dt><span>‘<samp>#1</samp>’</span></dt> <dd><p>Force the natural size by returning the first parameter (the original width). </p> </dd> -<dt>‘<samp>0pt</samp>’</dt> +<dt><span>‘<samp>0pt</samp>’</span></dt> <dd><p>A special case, equivalent to ‘<samp>#1</samp>’. </p> </dd> -<dt>‘<samp>0.5#1</samp>’</dt> +<dt><span>‘<samp>0.5#1</samp>’</span></dt> <dd><p>Scale to half the natural size. </p> </dd> -<dt>‘<samp>\hsize</samp>’</dt> +<dt><span>‘<samp>\hsize</samp>’</span></dt> <dd><p>Scale to the current <code>\hsize</code>. (In LaTeX, use <code>\textwidth</code> instead of <code>\hsize</code>.) </p> </dd> -<dt>‘<samp>\ifnum#1>\hsize\hsize\else#1\fi</samp>’</dt> +<dt><span>‘<samp>\ifnum#1>\hsize\hsize\else#1\fi</samp>’</span></dt> <dd><p>If the natural width is greater than the current <code>\hsize</code>, scale to <code>\hsize</code>, otherwise use the natural width. </p> @@ -2732,9 +2679,11 @@ scale or otherwise modify the document. </p> <hr> -<span id="EPSF-clipping"></span><div class="header"> +</div> +<div class="subsubsection" id="EPSF-clipping"> +<div class="header"> <p> -Previous: <a href="#EPSF-scaling" accesskey="p" rel="prev">EPSF scaling</a>, Up: <a href="#EPSF-macros" accesskey="u" rel="up">EPSF macros</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> +Previous: <a href="#EPSF-scaling" accesskey="p" rel="prev">EPSF scaling</a>, Up: <a href="#EPSF-macros" accesskey="u" rel="up">Using the EPSF macros</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> </div> <span id="EPSF-clipping-1"></span><h4 class="subsubsection">5.1.3.2 EPSF clipping</h4> @@ -2763,9 +2712,12 @@ turn clipping on, just use the command <hr> -<span id="psfile-special"></span><div class="header"> +</div> +</div> +<div class="subsection" id="psfile-special"> +<div class="header"> <p> -Next: <a href="#Dynamic-creation-of-graphics" accesskey="n" rel="next">Dynamic creation of graphics</a>, Previous: <a href="#EPSF-macros" accesskey="p" rel="prev">EPSF macros</a>, Up: <a href="#PostScript-figures" accesskey="u" rel="up">PostScript figures</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> +Next: <a href="#Dynamic-creation-of-graphics" accesskey="n" rel="next">Dynamic creation of PostScript graphics files</a>, Previous: <a href="#EPSF-macros" accesskey="p" rel="prev">Using the EPSF macros</a>, Up: <a href="#PostScript-figures" accesskey="u" rel="up">PostScript figures</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> </div> <span id="psfile-special-1"></span><h4 class="subsection">5.1.4 ‘<samp>psfile</samp>’ special</h4> @@ -2785,58 +2737,48 @@ specify transformations on the PostScript. <p>The possible <var>key</var>s are: </p> <dl compact="compact"> -<dt>‘<samp>hoffset</samp>’</dt> -<dd><span id="index-hoffset-_0028psfile-special-option_0029"></span> -<p>The horizontal offset (default 0). +<dt id='index-hoffset-_0028psfile-special-option_0029'><span>‘<samp>hoffset</samp>’<a href='#index-hoffset-_0028psfile-special-option_0029' class='copiable-anchor'> ¶</a></span></dt> +<dd><p>The horizontal offset (default 0). </p> </dd> -<dt>‘<samp>voffset</samp>’</dt> -<dd><span id="index-voffset-_0028psfile-special-option_0029"></span> -<p>The vertical offset (default 0). +<dt id='index-voffset-_0028psfile-special-option_0029'><span>‘<samp>voffset</samp>’<a href='#index-voffset-_0028psfile-special-option_0029' class='copiable-anchor'> ¶</a></span></dt> +<dd><p>The vertical offset (default 0). </p> </dd> -<dt>‘<samp>hsize</samp>’</dt> -<dd><span id="index-hsize-_0028psfile-special-option_0029"></span> -<p>The horizontal clipping size (default 612). +<dt id='index-hsize-_0028psfile-special-option_0029'><span>‘<samp>hsize</samp>’<a href='#index-hsize-_0028psfile-special-option_0029' class='copiable-anchor'> ¶</a></span></dt> +<dd><p>The horizontal clipping size (default 612). </p> </dd> -<dt>‘<samp>vsize</samp>’</dt> -<dd><span id="index-vsize-_0028psfile-special-option_0029"></span> -<p>The vertical clipping size (default 792). +<dt id='index-vsize-_0028psfile-special-option_0029'><span>‘<samp>vsize</samp>’<a href='#index-vsize-_0028psfile-special-option_0029' class='copiable-anchor'> ¶</a></span></dt> +<dd><p>The vertical clipping size (default 792). </p> </dd> -<dt>‘<samp>hscale</samp>’</dt> -<dd><span id="index-hscale-_0028psfile-special-option_0029"></span> -<p>The horizontal scaling factor, as a percentage (default 100). +<dt id='index-hscale-_0028psfile-special-option_0029'><span>‘<samp>hscale</samp>’<a href='#index-hscale-_0028psfile-special-option_0029' class='copiable-anchor'> ¶</a></span></dt> +<dd><p>The horizontal scaling factor, as a percentage (default 100). </p> </dd> -<dt>‘<samp>vscale</samp>’</dt> -<dd><span id="index-vscale-_0028psfile-special-option_0029"></span> -<p>The vertical scaling factor, as a percentage (default 100). +<dt id='index-vscale-_0028psfile-special-option_0029'><span>‘<samp>vscale</samp>’<a href='#index-vscale-_0028psfile-special-option_0029' class='copiable-anchor'> ¶</a></span></dt> +<dd><p>The vertical scaling factor, as a percentage (default 100). </p> </dd> -<dt>‘<samp>angle</samp>’</dt> -<dd><span id="index-angle-_0028psfile-special-option_0029"></span> -<p>The rotation, in degrees (default 0). +<dt id='index-angle-_0028psfile-special-option_0029'><span>‘<samp>angle</samp>’<a href='#index-angle-_0028psfile-special-option_0029' class='copiable-anchor'> ¶</a></span></dt> +<dd><p>The rotation, in degrees (default 0). </p> </dd> -<dt>‘<samp>clip</samp>’</dt> -<dd><span id="index-clip-_0028psfile-special-option_0029"></span> -<p>Enable clipping to the bounding box (default disabled). +<dt id='index-clip-_0028psfile-special-option_0029'><span>‘<samp>clip</samp>’<a href='#index-clip-_0028psfile-special-option_0029' class='copiable-anchor'> ¶</a></span></dt> +<dd><p>Enable clipping to the bounding box (default disabled). </p> </dd> -<dt>‘<samp>llx, lly, urx, ury</samp>’</dt> -<dd><span id="index-llx-_0028psfile-special-option_0029"></span> -<span id="index-lly-_0028psfile-special-option_0029"></span> +<dt id='index-llx-_0028psfile-special-option_0029'><span>‘<samp>llx, lly, urx, ury</samp>’<a href='#index-llx-_0028psfile-special-option_0029' class='copiable-anchor'> ¶</a></span></dt> +<dd><span id="index-lly-_0028psfile-special-option_0029"></span> <span id="index-urx-_0028psfile-special-option_0029"></span> <span id="index-ury-_0028psfile-special-option_0029"></span> <p>Bounding box of the included image, just as in a <code>%%BoundingBox</code> comment. Values are in big points, and may be fractional. </p> </dd> -<dt>‘<samp>rhi, rwi</samp>’</dt> -<dd><span id="index-rhi-_0028psfile-special-option_0029"></span> -<span id="index-rwi-_0028psfile-special-option_0029"></span> +<dt id='index-rhi-_0028psfile-special-option_0029'><span>‘<samp>rhi, rwi</samp>’<a href='#index-rhi-_0028psfile-special-option_0029' class='copiable-anchor'> ¶</a></span></dt> +<dd><span id="index-rwi-_0028psfile-special-option_0029"></span> <p>Desired width and height of the resulting figure in the output, in tenths of big points (720 to the inch); may be fractional. </p> @@ -2878,9 +2820,11 @@ scale factor. </p> <hr> -<span id="Dynamic-creation-of-graphics"></span><div class="header"> +</div> +<div class="subsection" id="Dynamic-creation-of-graphics"> +<div class="header"> <p> -Next: <a href="#Fonts-in-figures" accesskey="n" rel="next">Fonts in figures</a>, Previous: <a href="#psfile-special" accesskey="p" rel="prev">psfile special</a>, Up: <a href="#PostScript-figures" accesskey="u" rel="up">PostScript figures</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> +Next: <a href="#Fonts-in-figures" accesskey="n" rel="next">Fonts in figures</a>, Previous: <a href="#psfile-special" accesskey="p" rel="prev">‘<samp>psfile</samp>’ special</a>, Up: <a href="#PostScript-figures" accesskey="u" rel="up">PostScript figures</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> </div> <span id="Dynamic-creation-of-PostScript-graphics-files"></span><h4 class="subsection">5.1.5 Dynamic creation of PostScript graphics files</h4> @@ -2919,9 +2863,11 @@ with the ‘<samp>-R</samp>’ command-line option or ‘<samp>R</sa </p> <hr> -<span id="Fonts-in-figures"></span><div class="header"> +</div> +<div class="subsection" id="Fonts-in-figures"> +<div class="header"> <p> -Previous: <a href="#Dynamic-creation-of-graphics" accesskey="p" rel="prev">Dynamic creation of graphics</a>, Up: <a href="#PostScript-figures" accesskey="u" rel="up">PostScript figures</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> +Previous: <a href="#Dynamic-creation-of-graphics" accesskey="p" rel="prev">Dynamic creation of PostScript graphics files</a>, Up: <a href="#PostScript-figures" accesskey="u" rel="up">PostScript figures</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> </div> <span id="Fonts-in-figures-1"></span><h4 class="subsection">5.1.6 Fonts in figures</h4> @@ -2940,31 +2886,31 @@ file. Schematically, this looks like: <p>Here is the meaning of each of these elements: </p> <dl compact="compact"> -<dt><var>tfmname</var></dt> +<dt><span><var>tfmname</var></span></dt> <dd><p>The TeX TFM filename, e.g., <samp>cmr10</samp>. You can give the same <var>tfmname</var> on more than one ‘<samp>%*Font</samp>’ line; this is useful when the number of characters from the font used needs a longer <var>hex-bitstring</var> (see item below) than conveniently fits on one line. </p> </dd> -<dt><var>scaledbp</var></dt> +<dt><span><var>scaledbp</var></span></dt> <dd><p>The size at which you are using the font, in PostScript points (TeX big points). 72bp = 72.27pt = 1in. </p> </dd> -<dt><var>designbp</var></dt> +<dt><span><var>designbp</var></span></dt> <dd><p>The designsize of the font, again in PostScript points. This should match the value in the TFM file <var>tfmname</var>. Thus, for <samp>cmr10</samp>, it should be ‘<samp>9.96265</samp>’. </p> </dd> -<dt><var>hex-start</var></dt> +<dt><span><var>hex-start</var></span></dt> <dd><p>The character code of the first character used from the font, specified as two ASCII hexadecimal characters, e.g., ‘<samp>4b</samp>’ or ‘<samp>4B</samp>’ for ‘<samp>K</samp>’. </p> </dd> -<dt><var>hex-bitstring</var></dt> +<dt><span><var>hex-bitstring</var></span></dt> <dd><p>An arbitrary number of ASCII hexadecimal digits specifying which characters following (and including) <var>hex-start</var> are used. This is treated as a bitmap. For example, if your figure used the single letter @@ -2976,13 +2922,16 @@ treated as a bitmap. For example, if your figure used the single letter </dl> <p>MetaPost’s output figures contain lines like this for bitmap fonts used -in a MetaPost label (see <a href="https://tug.org/texinfohtml/web2c.html#MetaPost">MetaPost</a> in <cite>Web2c</cite>). +in a MetaPost label (see <a data-manual="web2c" href="https://tug.org/texinfohtml/web2c.html#MetaPost">MetaPost</a> in <cite>Web2c</cite>). </p> <hr> -<span id="Header-files"></span><div class="header"> +</div> +</div> +<div class="section" id="Header-files"> +<div class="header"> <p> -Next: <a href="#Literal-PS" accesskey="n" rel="next">Literal PS</a>, Previous: <a href="#PostScript-figures" accesskey="p" rel="prev">PostScript figures</a>, Up: <a href="#Interaction-with-PostScript" accesskey="u" rel="up">Interaction with PostScript</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> +Next: <a href="#Literal-PS" accesskey="n" rel="next">Literal PostScript</a>, Previous: <a href="#PostScript-figures" accesskey="p" rel="prev">PostScript figures</a>, Up: <a href="#Interaction-with-PostScript" accesskey="u" rel="up">Interaction with PostScript</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> </div> <span id="PostScript-header-files"></span><h3 class="section">5.2 PostScript header files</h3> @@ -3013,20 +2962,18 @@ version. <p>The PostScript dictionary stack will be at the ‘<samp>userdict</samp>’ level when header files are included. </p> -<table class="menu" border="0" cellspacing="0"> -<tr><td align="left" valign="top">• <a href="#Including-headers-from-TeX" accesskey="1">Including headers from TeX</a></td><td> </td><td align="left" valign="top"> -</td></tr> -<tr><td align="left" valign="top">• <a href="#Including-headers-from-the-command-line" accesskey="2">Including headers from the command line</a></td><td> </td><td align="left" valign="top"> -</td></tr> -<tr><td align="left" valign="top">• <a href="#Headers-and-memory-usage" accesskey="3">Headers and memory usage</a></td><td> </td><td align="left" valign="top"> -</td></tr> -</table> +<ul class="section-toc"> +<li><a href="#Including-headers-from-TeX" accesskey="1">Including headers from TeX</a></li> +<li><a href="#Including-headers-from-the-command-line" accesskey="2">Including headers from the command line</a></li> +<li><a href="#Headers-and-memory-usage" accesskey="3">Headers and memory usage</a></li> +</ul> <hr> -<span id="Including-headers-from-TeX"></span><div class="header"> +<div class="subsection" id="Including-headers-from-TeX"> +<div class="header"> <p> -Next: <a href="#Including-headers-from-the-command-line" accesskey="n" rel="next">Including headers from the command line</a>, Up: <a href="#Header-files" accesskey="u" rel="up">Header files</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> +Next: <a href="#Including-headers-from-the-command-line" accesskey="n" rel="next">Including headers from the command line</a>, Up: <a href="#Header-files" accesskey="u" rel="up">PostScript header files</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> </div> <span id="Including-headers-from-TeX-1"></span><h4 class="subsection">5.2.1 Including headers from TeX</h4> @@ -3089,9 +3036,11 @@ which are installed in the <samp>tex/</samp> tree. </p> <hr> -<span id="Including-headers-from-the-command-line"></span><div class="header"> +</div> +<div class="subsection" id="Including-headers-from-the-command-line"> +<div class="header"> <p> -Next: <a href="#Headers-and-memory-usage" accesskey="n" rel="next">Headers and memory usage</a>, Previous: <a href="#Including-headers-from-TeX" accesskey="p" rel="prev">Including headers from TeX</a>, Up: <a href="#Header-files" accesskey="u" rel="up">Header files</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> +Next: <a href="#Headers-and-memory-usage" accesskey="n" rel="next">Headers and memory usage</a>, Previous: <a href="#Including-headers-from-TeX" accesskey="p" rel="prev">Including headers from TeX</a>, Up: <a href="#Header-files" accesskey="u" rel="up">PostScript header files</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> </div> <span id="Including-headers-from-the-command-line-1"></span><h4 class="subsection">5.2.2 Including headers from the command line</h4> @@ -3119,9 +3068,11 @@ mode on duplex printers, and setting various screen frequencies; </p> <hr> -<span id="Headers-and-memory-usage"></span><div class="header"> +</div> +<div class="subsection" id="Headers-and-memory-usage"> +<div class="header"> <p> -Previous: <a href="#Including-headers-from-the-command-line" accesskey="p" rel="prev">Including headers from the command line</a>, Up: <a href="#Header-files" accesskey="u" rel="up">Header files</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> +Previous: <a href="#Including-headers-from-the-command-line" accesskey="p" rel="prev">Including headers from the command line</a>, Up: <a href="#Header-files" accesskey="u" rel="up">PostScript header files</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> </div> <span id="Headers-and-memory-usage-1"></span><h4 class="subsection">5.2.3 Headers and memory usage</h4> @@ -3157,9 +3108,12 @@ to a very large number. (See the ‘<samp>m</samp>’ item in <a href=" </p> <hr> -<span id="Literal-PS"></span><div class="header"> +</div> +</div> +<div class="section" id="Literal-PS"> +<div class="header"> <p> -Next: <a href="#Hypertext" accesskey="n" rel="next">Hypertext</a>, Previous: <a href="#Header-files" accesskey="p" rel="prev">Header files</a>, Up: <a href="#Interaction-with-PostScript" accesskey="u" rel="up">Interaction with PostScript</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> +Next: <a href="#Hypertext" accesskey="n" rel="next">HyperTeXt</a>, Previous: <a href="#Header-files" accesskey="p" rel="prev">PostScript header files</a>, Up: <a href="#Interaction-with-PostScript" accesskey="u" rel="up">Interaction with PostScript</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> </div> <span id="Literal-PostScript"></span><h3 class="section">5.3 Literal PostScript</h3> @@ -3168,24 +3122,20 @@ Next: <a href="#Hypertext" accesskey="n" rel="next">Hypertext</a>, Previous: <a <p>You can include literal PostScript code in your document in several ways. </p> -<table class="menu" border="0" cellspacing="0"> -<tr><td align="left" valign="top">• <a href="#g_t_0022-special" accesskey="1">" special</a></td><td> </td><td align="left" valign="top">To include inline PostScript code. -</td></tr> -<tr><td align="left" valign="top">• <a href="#ps-special" accesskey="2">ps special</a></td><td> </td><td align="left" valign="top">Inline PostScript without save/restore. -</td></tr> -<tr><td align="left" valign="top">• <a href="#Literal-headers" accesskey="3">Literal headers</a></td><td> </td><td align="left" valign="top">Literal PostScript for the whole document. -</td></tr> -<tr><td align="left" valign="top">• <a href="#PostScript-hooks" accesskey="4">PostScript hooks</a></td><td> </td><td align="left" valign="top">Specifying code to run in the PS interpreter. -</td></tr> -<tr><td align="left" valign="top">• <a href="#Literal-examples" accesskey="5">Literal examples</a></td><td> </td><td align="left" valign="top">Neat example. -</td></tr> -</table> +<ul class="section-toc"> +<li><a href="#g_t_0022-special" accesskey="1"><code>"</code> special: Literal PostScript</a></li> +<li><a href="#ps-special" accesskey="2">‘<samp>ps</samp>’ special</a></li> +<li><a href="#Literal-headers" accesskey="3">Literal headers: ‘<samp>!</samp>’ <code>\special</code></a></li> +<li><a href="#PostScript-hooks" accesskey="4">PostScript hooks</a></li> +<li><a href="#Literal-examples" accesskey="5">Literal examples</a></li> +</ul> <hr> -<span id="g_t_0022-special"></span><div class="header"> +<div class="subsection" id="g_t_0022-special"> +<div class="header"> <p> -Next: <a href="#ps-special" accesskey="n" rel="next">ps special</a>, Up: <a href="#Literal-PS" accesskey="u" rel="up">Literal PS</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> +Next: <a href="#ps-special" accesskey="n" rel="next">‘<samp>ps</samp>’ special</a>, Up: <a href="#Literal-PS" accesskey="u" rel="up">Literal PostScript</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> </div> <span id="g_t_0022-special_003a-Literal-PostScript"></span><h4 class="subsection">5.3.1 <code>"</code> special: Literal PostScript</h4> @@ -3211,9 +3161,11 @@ the <code>\vbox</code> above. </p> <hr> -<span id="ps-special"></span><div class="header"> +</div> +<div class="subsection" id="ps-special"> +<div class="header"> <p> -Next: <a href="#Literal-headers" accesskey="n" rel="next">Literal headers</a>, Previous: <a href="#g_t_0022-special" accesskey="p" rel="prev">" special</a>, Up: <a href="#Literal-PS" accesskey="u" rel="up">Literal PS</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> +Next: <a href="#Literal-headers" accesskey="n" rel="next">Literal headers: ‘<samp>!</samp>’ <code>\special</code></a>, Previous: <a href="#g_t_0022-special" accesskey="p" rel="prev"><code>"</code> special: Literal PostScript</a>, Up: <a href="#Literal-PS" accesskey="u" rel="up">Literal PostScript</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> </div> <span id="ps-special-1"></span><h4 class="subsection">5.3.2 ‘<samp>ps</samp>’ special</h4> @@ -3261,9 +3213,11 @@ it easy to typeset text turned in multiples of 90 degrees. </p> <hr> -<span id="Literal-headers"></span><div class="header"> +</div> +<div class="subsection" id="Literal-headers"> +<div class="header"> <p> -Next: <a href="#PostScript-hooks" accesskey="n" rel="next">PostScript hooks</a>, Previous: <a href="#ps-special" accesskey="p" rel="prev">ps special</a>, Up: <a href="#Literal-PS" accesskey="u" rel="up">Literal PS</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> +Next: <a href="#PostScript-hooks" accesskey="n" rel="next">PostScript hooks</a>, Previous: <a href="#ps-special" accesskey="p" rel="prev">‘<samp>ps</samp>’ special</a>, Up: <a href="#Literal-PS" accesskey="u" rel="up">Literal PostScript</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> </div> <span id="Literal-headers_003a-_0021-_005cspecial"></span><h4 class="subsection">5.3.3 Literal headers: ‘<samp>!</samp>’ <code>\special</code></h4> @@ -3289,9 +3243,11 @@ literally (the ‘<samp>"</samp>’ special) or through macros (e.g <hr> -<span id="PostScript-hooks"></span><div class="header"> +</div> +<div class="subsection" id="PostScript-hooks"> +<div class="header"> <p> -Next: <a href="#Literal-examples" accesskey="n" rel="next">Literal examples</a>, Previous: <a href="#Literal-headers" accesskey="p" rel="prev">Literal headers</a>, Up: <a href="#Literal-PS" accesskey="u" rel="up">Literal PS</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> +Next: <a href="#Literal-examples" accesskey="n" rel="next">Literal examples</a>, Previous: <a href="#Literal-headers" accesskey="p" rel="prev">Literal headers: ‘<samp>!</samp>’ <code>\special</code></a>, Up: <a href="#Literal-PS" accesskey="u" rel="up">Literal PostScript</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> </div> <span id="PostScript-hooks-1"></span><h4 class="subsection">5.3.4 PostScript hooks</h4> @@ -3347,9 +3303,11 @@ independent. </p> <hr> -<span id="Literal-examples"></span><div class="header"> +</div> +<div class="subsection" id="Literal-examples"> +<div class="header"> <p> -Previous: <a href="#PostScript-hooks" accesskey="p" rel="prev">PostScript hooks</a>, Up: <a href="#Literal-PS" accesskey="u" rel="up">Literal PS</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> +Previous: <a href="#PostScript-hooks" accesskey="p" rel="prev">PostScript hooks</a>, Up: <a href="#Literal-PS" accesskey="u" rel="up">Literal PostScript</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> </div> <span id="Literal-examples-1"></span><h4 class="subsection">5.3.5 Literal examples</h4> @@ -3390,9 +3348,12 @@ has a useful trick that appears again and again. </p> <hr> -<span id="Hypertext"></span><div class="header"> +</div> +</div> +<div class="section" id="Hypertext"> +<div class="header"> <p> -Previous: <a href="#Literal-PS" accesskey="p" rel="prev">Literal PS</a>, Up: <a href="#Interaction-with-PostScript" accesskey="u" rel="up">Interaction with PostScript</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> +Previous: <a href="#Literal-PS" accesskey="p" rel="prev">Literal PostScript</a>, Up: <a href="#Interaction-with-PostScript" accesskey="u" rel="up">Interaction with PostScript</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> </div> <span id="HyperTeXt"></span><h3 class="section">5.4 HyperTeXt</h3> @@ -3419,7 +3380,6 @@ output is <code>hyperref</code> (<a href="https://ctan.org/pkg/hyperref">https:/ plain TeX, the Eplain package has some hyperlink support (<a href="https://tug.org/eplain">https://tug.org/eplain</a>). </p> -<span id="index-http_003a_002f_002fxxx_002elanl_002egov_002fhypertex"></span> <span id="index-Doyle_002c-Mark"></span> <span id="index-Bhattacharya_002c-Tanmoy"></span> <span id="index-dvihps_002c-hyperdvi-to-PostScript"></span> @@ -3427,18 +3387,17 @@ plain TeX, the Eplain package has some hyperlink support written by Mark Doyle and Tanmoy Bhattacharya as the ‘<samp>dvihps</samp>’ program. </p> -<table class="menu" border="0" cellspacing="0"> -<tr><td align="left" valign="top">• <a href="#Hypertext-caveats" accesskey="1">Hypertext caveats</a></td><td> </td><td align="left" valign="top">Font quality, missing character psi. -</td></tr> -<tr><td align="left" valign="top">• <a href="#Hypertext-specials" accesskey="2">Hypertext specials</a></td><td> </td><td align="left" valign="top">The details on the specials. -</td></tr> -</table> +<ul class="section-toc"> +<li><a href="#Hypertext-caveats" accesskey="1">Hypertext caveats</a></li> +<li><a href="#Hypertext-specials" accesskey="2">Hypertext specials</a></li> +</ul> <hr> -<span id="Hypertext-caveats"></span><div class="header"> +<div class="subsection" id="Hypertext-caveats"> +<div class="header"> <p> -Next: <a href="#Hypertext-specials" accesskey="n" rel="next">Hypertext specials</a>, Up: <a href="#Hypertext" accesskey="u" rel="up">Hypertext</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> +Next: <a href="#Hypertext-specials" accesskey="n" rel="next">Hypertext specials</a>, Up: <a href="#Hypertext" accesskey="u" rel="up">HyperTeXt</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> </div> <span id="Hypertext-caveats-1"></span><h4 class="subsection">5.4.1 Hypertext caveats</h4> @@ -3528,16 +3487,13 @@ more, but copies are available elsewhere: <a href="http://www.utdallas.edu/~cantrell/online/543e.html">http://www.utdallas.edu/~cantrell/online/543e.html</a> </pre></div> -<p>You may also want to check “Notes on converting (La)TeX documents -to robust PDF using Rokicki’s dvips and Acrobat Distiller” by -Timothy P. Van Zandt:<br> -<a href="http://www.emrg.com/texpdf.htmlhttp://zandtwerk.insead.fr/tex2pdf.html">http://www.emrg.com/texpdf.htmlhttp://zandtwerk.insead.fr/tex2pdf.html</a>. -</p> <hr> -<span id="Hypertext-specials"></span><div class="header"> +</div> +<div class="subsection" id="Hypertext-specials"> +<div class="header"> <p> -Previous: <a href="#Hypertext-caveats" accesskey="p" rel="prev">Hypertext caveats</a>, Up: <a href="#Hypertext" accesskey="u" rel="up">Hypertext</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> +Previous: <a href="#Hypertext-caveats" accesskey="p" rel="prev">Hypertext caveats</a>, Up: <a href="#Hypertext" accesskey="u" rel="up">HyperTeXt</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> </div> <span id="Hypertext-specials-1"></span><h4 class="subsection">5.4.2 Hypertext specials</h4> @@ -3581,9 +3537,7 @@ for a precise description of base URL’s. </p> <p>Descriptions of the <code>\special</code>’s: </p><dl compact="compact"> -<dt>‘<samp>href</samp>’ -<span id="index-href"></span> -</dt> +<dt id='index-href'><span>‘<samp>href</samp>’<a href='#index-href' class='copiable-anchor'> ¶</a></span></dt> <dd><span id="index-links_002c-hypertext"></span> <p>Creates links in your TeX document. For example: </p><div class="example"> @@ -3596,9 +3550,7 @@ this is for illustration. In practice, you most likely want to use macros to insert the <code>\special</code> commands; reference above.) </p> </dd> -<dt>‘<samp>name</samp>’ -<span id="index-name"></span> -</dt> +<dt id='index-name'><span>‘<samp>name</samp>’<a href='#index-name' class='copiable-anchor'> ¶</a></span></dt> <dd><span id="index-Anderson_002c-Laurie"></span> <p>Defines URL targets in your TeX documents, so links can be resolved. For example: @@ -3612,18 +3564,14 @@ existing macro packages which take care of all the details, such as <samp>hyperref</samp> for LaTeX. The <a href="http://arxiv.org/hypertex/">HyperTeX FAQ</a> has more information. </p> </dd> -<dt>‘<samp>img</samp>’ -<span id="index-img"></span> -</dt> +<dt id='index-img'><span>‘<samp>img</samp>’<a href='#index-img' class='copiable-anchor'> ¶</a></span></dt> <dd><span id="index-mailcap-and-hypertext"></span> <p>Links to an arbitrary external file. Interactively, a viewer is spawned to read the file according to the file extension and your <samp>mailcap</samp> file (see the Xdvi documentation). </p> </dd> -<dt>‘<samp>base</samp>’ -<span id="index-base"></span> -</dt> +<dt id='index-base'><span>‘<samp>base</samp>’<a href='#index-base' class='copiable-anchor'> ¶</a></span></dt> <dd><p>Defines a base URL that is prepended to all the <code>name</code> targets. Typically unnecessary, as the name of the DVI file being read is used by default. @@ -3635,9 +3583,13 @@ the NeXTSTEP DVI viewer. </p> <hr> -<span id="PostScript-fonts"></span><div class="header"> +</div> +</div> +</div> +<div class="chapter" id="PostScript-fonts"> +<div class="header"> <p> -Next: <a href="#Color" accesskey="n" rel="next">Color</a>, Previous: <a href="#Interaction-with-PostScript" accesskey="p" rel="prev">Interaction with PostScript</a>, Up: <a href="#Top" accesskey="u" rel="up">Top</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> +Next: <a href="#Color" accesskey="n" rel="next">Color</a>, Previous: <a href="#Interaction-with-PostScript" accesskey="p" rel="prev">Interaction with PostScript</a>, Up: <a href="#Top" accesskey="u" rel="up">Dvips</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> </div> <span id="PostScript-fonts-1"></span><h2 class="chapter">6 PostScript fonts</h2> @@ -3656,22 +3608,19 @@ installation procedure (see <a href="#Installation">Installation</a>). This cha therefore relevant only if you are installing new PostScript fonts not supplied with Dvips. (Or if you’re curious.) </p> -<table class="menu" border="0" cellspacing="0"> -<tr><td align="left" valign="top">• <a href="#Font-concepts" accesskey="1">Font concepts</a></td><td> </td><td align="left" valign="top">Metrics, glyphs, virtual fonts, and encodings. -</td></tr> -<tr><td align="left" valign="top">• <a href="#Making-a-font-available" accesskey="2">Making a font available</a></td><td> </td><td align="left" valign="top">Installing and using a PostScript font. -</td></tr> -<tr><td align="left" valign="top">• <a href="#Invoking-afm2tfm" accesskey="3">Invoking afm2tfm</a></td><td> </td><td align="left" valign="top">Creating TFM and AFM files for a virtual font. -</td></tr> -<tr><td align="left" valign="top">• <a href="#psfonts_002emap" accesskey="4">psfonts.map</a></td><td> </td><td align="left" valign="top">Defining available PostScript fonts. -</td></tr> -</table> +<ul class="section-toc"> +<li><a href="#Font-concepts" accesskey="1">Font concepts</a></li> +<li><a href="#Making-a-font-available" accesskey="2">Making a PostScript font available</a></li> +<li><a href="#Invoking-afm2tfm" accesskey="3">Invoking Afm2tfm</a></li> +<li><a href="#psfonts_002emap" accesskey="4"><samp>psfonts.map</samp>: PostScript font catalog</a></li> +</ul> <hr> -<span id="Font-concepts"></span><div class="header"> +<div class="section" id="Font-concepts"> +<div class="header"> <p> -Next: <a href="#Making-a-font-available" accesskey="n" rel="next">Making a font available</a>, Up: <a href="#PostScript-fonts" accesskey="u" rel="up">PostScript fonts</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> +Next: <a href="#Making-a-font-available" accesskey="n" rel="next">Making a PostScript font available</a>, Up: <a href="#PostScript-fonts" accesskey="u" rel="up">PostScript fonts</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> </div> <span id="Font-concepts-1"></span><h3 class="section">6.1 Font concepts</h3> @@ -3690,24 +3639,19 @@ numbers of the characters in a font and their descriptive names. Two encoding files used together can describe a reencoding that rearranges, i.e., renumbers, the characters of a font. </p> -<table class="menu" border="0" cellspacing="0"> -<tr><td align="left" valign="top">• <a href="#Metric-files" accesskey="1">Metric files</a></td><td> </td><td align="left" valign="top">Shape-independent font information. -</td></tr> -<tr><td align="left" valign="top">• <a href="#Glyph-files" accesskey="2">Glyph files</a></td><td> </td><td align="left" valign="top">Character shapes. -</td></tr> -<tr><td align="left" valign="top">• <a href="#Virtual-fonts" accesskey="3">Virtual fonts</a></td><td> </td><td align="left" valign="top">Constructing one font from others. -</td></tr> -<tr><td align="left" valign="top">• <a href="#Encodings" accesskey="4">Encodings</a></td><td> </td><td align="left" valign="top">Character codes and character names. -</td></tr> -<tr><td align="left" valign="top">• <a href="#Bitmap-font-encodings" accesskey="5">Bitmap font encodings</a></td><td> </td><td align="left" valign="top">Encodings for bitmapped fonts. -</td></tr> -<tr><td align="left" valign="top">• <a href="#PostScript-typesetting" accesskey="6">PostScript typesetting</a></td><td> </td><td align="left" valign="top">How PostScript typesets a character. -</td></tr> -</table> +<ul class="section-toc"> +<li><a href="#Metric-files" accesskey="1">Metric files</a></li> +<li><a href="#Glyph-files" accesskey="2">Glyph files</a></li> +<li><a href="#Virtual-fonts" accesskey="3">Virtual fonts</a></li> +<li><a href="#Encodings" accesskey="4">Encodings</a></li> +<li><a href="#Bitmap-font-encodings" accesskey="5">Bitmap font encodings</a></li> +<li><a href="#PostScript-typesetting" accesskey="6">How PostScript typesets a character</a></li> +</ul> <hr> -<span id="Metric-files"></span><div class="header"> +<div class="subsection" id="Metric-files"> +<div class="header"> <p> Next: <a href="#Glyph-files" accesskey="n" rel="next">Glyph files</a>, Up: <a href="#Font-concepts" accesskey="u" rel="up">Font concepts</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> </div> @@ -3740,7 +3684,7 @@ the only common ligatures are fi, fl, ff, ffi, and ffl.) <ul> <li> <span id="index-afm-files"></span> <span id="index-_002eafm-Adobe-metric-files"></span> -Each Postscript font has an <em>Adobe font metrics</em> (‘<samp>.afm</samp>’) +Each PostScript font has an <em>Adobe font metrics</em> (‘<samp>.afm</samp>’) file. These files are plain text, so you can inspect them easily. You can get AFM files for Adobe’s fonts from <a href="ftp://ftp.adobe.com/pub/adobe/Fonts/AFMs">ftp://ftp.adobe.com/pub/adobe/Fonts/AFMs</a>. @@ -3750,7 +3694,7 @@ can get AFM files for Adobe’s fonts from TeX uses <em>TeX font metrics</em> (‘<samp>.tfm</samp>’) files. When you say ‘<samp>\font = <var>font</var></samp>’ in your TeX document, TeX reads a file named ‘<samp><var>font</var>.tfm</samp>’. (Well, except for the <samp>texfonts.map</samp> -feature; see <a href="https://tug.org/texinfohtml/kpathsea.html#Fontmap">Fontmap</a> in <cite>Kpathsea</cite>). TeX can then +feature; see <a data-manual="kpathsea" href="https://tug.org/texinfohtml/kpathsea.html#Fontmap">Fontmap</a> in <cite>Kpathsea</cite>). TeX can then calculate the space occupied by characters from the font when typesetting. In addition, the DVI drivers you use to print or view the DVI file produced by TeX may need to look at the TFM file. @@ -3760,11 +3704,11 @@ DVI file produced by TeX may need to look at the TFM file. <span id="index-pltotf"></span> <span id="index-_002epl-property-list-files"></span> <p>TFM files are binary (and hence are typically much smaller than AFM -files). You can use the <code>tftopl</code> program (see <a href="https://tug.org/texinfohtml/web2c.html#tftopl-invocation">tftopl +files). You can use the <code>tftopl</code> program (see <a data-manual="web2c" href="https://tug.org/texinfohtml/web2c.html#tftopl-invocation">tftopl invocation</a> in <cite>Web2c</cite>) that comes with TeX to transform a TFM file into a human-readable “property list” (‘<samp>.pl</samp>’) file. You can also edit a PL file and transform it back to a TeX-readable TFM with -the companion program <code>pltotf</code> (see <a href="https://tug.org/texinfohtml/web2c.html#pltotf-invocation">pltotf invocation</a> in <cite>Web2c</cite>). Editing metrics by hand is not something you’re likely to want +the companion program <code>pltotf</code> (see <a data-manual="web2c" href="https://tug.org/texinfohtml/web2c.html#pltotf-invocation">pltotf invocation</a> in <cite>Web2c</cite>). Editing metrics by hand is not something you’re likely to want to do often, but the capability is there. </p> </li><li> <span id="index-pfm-files"></span> @@ -3778,11 +3722,13 @@ further. <p>The Afm2tfm program distributed with Dvips converts an AFM file to a TFM file and performs other useful transformations as well. -See <a href="#Invoking-afm2tfm">Invoking afm2tfm</a>. +See <a href="#Invoking-afm2tfm">Invoking Afm2tfm</a>. </p> <hr> -<span id="Glyph-files"></span><div class="header"> +</div> +<div class="subsection" id="Glyph-files"> +<div class="header"> <p> Next: <a href="#Virtual-fonts" accesskey="n" rel="next">Virtual fonts</a>, Previous: <a href="#Metric-files" accesskey="p" rel="prev">Metric files</a>, Up: <a href="#Font-concepts" accesskey="u" rel="up">Font concepts</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> </div> @@ -3819,7 +3765,7 @@ appearance of the font at small sizes or low resolutions. <span id="index-_002epfb-printer-font-binary-files"></span> <p>Although various kinds of PostScript outline fonts exist, by far the most common, and the only one we will consider, is called <em>Type 1</em>. -The glyph files for Postscript Type 1 fonts typically have names ending +The glyph files for PostScript Type 1 fonts typically have names ending in ‘<samp>.pfa</samp>’ (“printer font ASCII”) or ‘<samp>.pfb</samp>’ (“printer font binary”). </p> @@ -3850,7 +3796,9 @@ format is a historical artifact.) </p> <hr> -<span id="Virtual-fonts"></span><div class="header"> +</div> +<div class="subsection" id="Virtual-fonts"> +<div class="header"> <p> Next: <a href="#Encodings" accesskey="n" rel="next">Encodings</a>, Previous: <a href="#Glyph-files" accesskey="p" rel="prev">Glyph files</a>, Up: <a href="#Font-concepts" accesskey="u" rel="up">Font concepts</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> </div> @@ -3875,8 +3823,8 @@ intimidated by the subtitle.) virtual font, a recipe for typesetting that character. A VF file, like a TFM file, is in a compressed binary format. The <code>vftovp</code> and <code>vptovf</code> programs convert a VF file to a human-readable VPL -(virtual property list) format and back again. See <a href="https://tug.org/texinfohtml/web2c.html#vftovp-invocation">vftovp -invocation</a> in <cite>Web2c</cite>, and <a href="https://tug.org/texinfohtml/web2c.html#vptovf-invocation">vptovf invocation</a> in <cite>Web2c</cite>. +(virtual property list) format and back again. See <a data-manual="web2c" href="https://tug.org/texinfohtml/web2c.html#vftovp-invocation">vftovp +invocation</a> in <cite>Web2c</cite>, and <a data-manual="web2c" href="https://tug.org/texinfohtml/web2c.html#vptovf-invocation">vptovf invocation</a> in <cite>Web2c</cite>. </p> <span id="index-base-fonts"></span> <p>In the case of a PostScript font <var>f</var> being used in a straightforward @@ -3893,7 +3841,7 @@ created when you run <code>vptovf</code>. <span id="index-expansion_002c-of-virtual-fonts"></span> <span id="index-virtual-font-expansion"></span> <p>You can <em>expand</em> virtual fonts into their base fonts with DVIcopy -(see <a href="https://tug.org/texinfohtml/web2c.html#dvicopy-invocation">dvicopy invocation</a> in <cite>Web2c</cite>). This is useful if you are +(see <a data-manual="web2c" href="https://tug.org/texinfohtml/web2c.html#dvicopy-invocation">dvicopy invocation</a> in <cite>Web2c</cite>). This is useful if you are using a DVI translator that doesn’t itself understand vf’s. </p> <span id="index-ptex-JFM"></span> @@ -3909,7 +3857,9 @@ information about the extensive support of Japanese in TeX, see </p> <hr> -<span id="Encodings"></span><div class="header"> +</div> +<div class="subsection" id="Encodings"> +<div class="header"> <p> Next: <a href="#Bitmap-font-encodings" accesskey="n" rel="next">Bitmap font encodings</a>, Previous: <a href="#Virtual-fonts" accesskey="p" rel="prev">Virtual fonts</a>, Up: <a href="#Font-concepts" accesskey="u" rel="up">Font concepts</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> </div> @@ -3937,7 +3887,7 @@ of normal PostScript fonts. <p>It’s possible but painful to change all the macros that assume particular character positions. A better solution is to create a new font with the information for the acute accent at position 19, where -TeX expects it to be. See <a href="#Making-a-font-available">Making a font available</a>. +TeX expects it to be. See <a href="#Making-a-font-available">Making a PostScript font available</a>. </p> <span id="index-PostScript-encoding"></span> <span id="index-encoding-files"></span> @@ -3970,9 +3920,11 @@ italics, and <samp>texmsym.enc</samp> for math symbols. </p> <hr> -<span id="Bitmap-font-encodings"></span><div class="header"> +</div> +<div class="subsection" id="Bitmap-font-encodings"> +<div class="header"> <p> -Next: <a href="#PostScript-typesetting" accesskey="n" rel="next">PostScript typesetting</a>, Previous: <a href="#Encodings" accesskey="p" rel="prev">Encodings</a>, Up: <a href="#Font-concepts" accesskey="u" rel="up">Font concepts</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> +Next: <a href="#PostScript-typesetting" accesskey="n" rel="next">How PostScript typesets a character</a>, Previous: <a href="#Encodings" accesskey="p" rel="prev">Encodings</a>, Up: <a href="#Font-concepts" accesskey="u" rel="up">Font concepts</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> </div> <span id="Bitmap-font-encodings-1"></span><h4 class="subsection">6.1.5 Bitmap font encodings</h4> @@ -3984,7 +3936,7 @@ Next: <a href="#PostScript-typesetting" accesskey="n" rel="next">PostScript type are simply a vector of glyphs. By comparison, PostScript fonts are required to contain an encoding vector that at least provides glyph names; these names can permit PostScript and PDF viewers to -extract legible text from Postscript and PDF output. +extract legible text from PostScript and PDF output. </p> <p>Unlike previous versions, dvips versions 2020 and later add glyph naming information to Type 3 bitmapped fonts (if they can locate such @@ -4028,7 +3980,9 @@ font coordinate system. </p> <hr> -<span id="PostScript-typesetting"></span><div class="header"> +</div> +<div class="subsection" id="PostScript-typesetting"> +<div class="header"> <p> Previous: <a href="#Bitmap-font-encodings" accesskey="p" rel="prev">Bitmap font encodings</a>, Up: <a href="#Font-concepts" accesskey="u" rel="up">Font concepts</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> </div> @@ -4116,9 +4070,12 @@ information. </p> <hr> -<span id="Making-a-font-available"></span><div class="header"> +</div> +</div> +<div class="section" id="Making-a-font-available"> +<div class="header"> <p> -Next: <a href="#Invoking-afm2tfm" accesskey="n" rel="next">Invoking afm2tfm</a>, Previous: <a href="#Font-concepts" accesskey="p" rel="prev">Font concepts</a>, Up: <a href="#PostScript-fonts" accesskey="u" rel="up">PostScript fonts</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> +Next: <a href="#Invoking-afm2tfm" accesskey="n" rel="next">Invoking Afm2tfm</a>, Previous: <a href="#Font-concepts" accesskey="p" rel="prev">Font concepts</a>, Up: <a href="#PostScript-fonts" accesskey="u" rel="up">PostScript fonts</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> </div> <span id="Making-a-PostScript-font-available"></span><h3 class="section">6.2 Making a PostScript font available</h3> @@ -4156,7 +4113,7 @@ from the VPL file: <pre class="example">vptovf ptmr.vpl ptmr.vf ptmr.tfm </pre></div> -</li><li> Insert an entry for the font in <samp>psfonts.map</samp> (see <a href="#psfonts_002emap">psfonts.map</a>): +</li><li> Insert an entry for the font in <samp>psfonts.map</samp> (see <a href="#psfonts_002emap"><samp>psfonts.map</samp>: PostScript font catalog</a>): <div class="example"> <pre class="example">rptmr Times-Roman <ptmr8a.pfa </pre></div> @@ -4179,7 +4136,7 @@ like this: </pre></div> <p>This reads the file <samp>Times-Roman.afm</samp>, and produces two files as -output, namely the virtual property list’file <samp>ptmr.vpl</samp>, and the +output, namely the virtual property list file <samp>ptmr.vpl</samp>, and the “raw” font metric file <samp>rptmr.tfm</samp>. To use the font in TeX, you first run </p> @@ -4234,7 +4191,7 @@ separately). See <a href="#Reencoding-with-Afm2tfm">Reencoding with Afm2tfm</a> </p> <p>As a final step you need to record information about both the virtual font and the original font (if you ever might want to use it) in the -<samp>psfonts.map</samp> file (see <a href="#psfonts_002emap">psfonts.map</a>). For our example, you’d +<samp>psfonts.map</samp> file (see <a href="#psfonts_002emap"><samp>psfonts.map</samp>: PostScript font catalog</a>). For our example, you’d insert the following into <samp>psfonts.map</samp>: </p><div class="example"> <pre class="example">rptmr Times-Roman <ptmr8a.pfa @@ -4255,9 +4212,11 @@ the built-in PostScript fonts. </p> <hr> -<span id="Invoking-afm2tfm"></span><div class="header"> +</div> +<div class="section" id="Invoking-afm2tfm"> +<div class="header"> <p> -Next: <a href="#psfonts_002emap" accesskey="n" rel="next">psfonts.map</a>, Previous: <a href="#Making-a-font-available" accesskey="p" rel="prev">Making a font available</a>, Up: <a href="#PostScript-fonts" accesskey="u" rel="up">PostScript fonts</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> +Next: <a href="#psfonts_002emap" accesskey="n" rel="next"><samp>psfonts.map</samp>: PostScript font catalog</a>, Previous: <a href="#Making-a-font-available" accesskey="p" rel="prev">Making a PostScript font available</a>, Up: <a href="#PostScript-fonts" accesskey="u" rel="up">PostScript fonts</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> </div> <span id="Invoking-Afm2tfm"></span><h3 class="section">6.3 Invoking Afm2tfm</h3> @@ -4279,20 +4238,18 @@ can also obtain special effects such as an oblique font. (<a href="https://ctan.org/pkg/lcdf-typetools">https://ctan.org/pkg/lcdf-typetools</a>), and <code>afm2pl</code> (<a href="http://tex.aanhet.net/afm2pl/">http://tex.aanhet.net/afm2pl/</a>), among others. </p> -<table class="menu" border="0" cellspacing="0"> -<tr><td align="left" valign="top">• <a href="#Changing-font-encodings" accesskey="1">Changing font encodings</a></td><td> </td><td align="left" valign="top">Reencoding with -t, -p, -T. -</td></tr> -<tr><td align="left" valign="top">• <a href="#Special-font-effects" accesskey="2">Special font effects</a></td><td> </td><td align="left" valign="top">Oblique fonts, small caps, and such. -</td></tr> -<tr><td align="left" valign="top">• <a href="#Afm2tfm-options" accesskey="3">Afm2tfm options</a></td><td> </td><td align="left" valign="top">afm2tfm command-line options. -</td></tr> -</table> +<ul class="section-toc"> +<li><a href="#Changing-font-encodings" accesskey="1">Changing font encodings</a></li> +<li><a href="#Special-font-effects" accesskey="2">Special font effects</a></li> +<li><a href="#Afm2tfm-options" accesskey="3">Afm2tfm options</a></li> +</ul> <hr> -<span id="Changing-font-encodings"></span><div class="header"> +<div class="subsection" id="Changing-font-encodings"> +<div class="header"> <p> -Next: <a href="#Special-font-effects" accesskey="n" rel="next">Special font effects</a>, Up: <a href="#Invoking-afm2tfm" accesskey="u" rel="up">Invoking afm2tfm</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> +Next: <a href="#Special-font-effects" accesskey="n" rel="next">Special font effects</a>, Up: <a href="#Invoking-afm2tfm" accesskey="u" rel="up">Invoking Afm2tfm</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> </div> <span id="Changing-font-encodings-1"></span><h4 class="subsection">6.3.1 Changing font encodings</h4> @@ -4305,24 +4262,20 @@ Next: <a href="#Special-font-effects" accesskey="n" rel="next">Special font effe PostScript encoding, and ‘<samp>-T</samp>’ changes both simultaneously, as detailed in the sections below. </p> -<table class="menu" border="0" cellspacing="0"> -<tr><td align="left" valign="top">• <a href="#Changing-TeX-encodings" accesskey="1">Changing TeX encodings</a></td><td> </td><td align="left" valign="top">Where TeX finds a character. -</td></tr> -<tr><td align="left" valign="top">• <a href="#Changing-PostScript-encodings" accesskey="2">Changing PostScript encodings</a></td><td> </td><td align="left" valign="top">Where PostScript finds a character. -</td></tr> -<tr><td align="left" valign="top">• <a href="#Changing-both-encodings" accesskey="3">Changing both encodings</a></td><td> </td><td align="left" valign="top">One and the same, simultaneously. -</td></tr> -<tr><td align="left" valign="top">• <a href="#Reencoding-with-Afm2tfm" accesskey="4">Reencoding with Afm2tfm</a></td><td> </td><td align="left" valign="top">Problems with the default encoding. -</td></tr> -<tr><td align="left" valign="top">• <a href="#Encoding-file-format" accesskey="5">Encoding file format</a></td><td> </td><td align="left" valign="top">Syntax of an encoding file. -</td></tr> -</table> +<ul class="section-toc"> +<li><a href="#Changing-TeX-encodings" accesskey="1">‘<samp>-t</samp>’: Changing TeX encodings</a></li> +<li><a href="#Changing-PostScript-encodings" accesskey="2">‘<samp>-p</samp>’: Changing PostScript encodings</a></li> +<li><a href="#Changing-both-encodings" accesskey="3">‘<samp>-T</samp>’: Changing both TeX and PostScript encodings</a></li> +<li><a href="#Reencoding-with-Afm2tfm" accesskey="4">Reencoding with Afm2tfm</a></li> +<li><a href="#Encoding-file-format" accesskey="5">Encoding file format</a></li> +</ul> <hr> -<span id="Changing-TeX-encodings"></span><div class="header"> +<div class="subsubsection" id="Changing-TeX-encodings"> +<div class="header"> <p> -Next: <a href="#Changing-PostScript-encodings" accesskey="n" rel="next">Changing PostScript encodings</a>, Up: <a href="#Changing-font-encodings" accesskey="u" rel="up">Changing font encodings</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> +Next: <a href="#Changing-PostScript-encodings" accesskey="n" rel="next">‘<samp>-p</samp>’: Changing PostScript encodings</a>, Up: <a href="#Changing-font-encodings" accesskey="u" rel="up">Changing font encodings</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> </div> <span id="g_t_002dt_003a-Changing-TeX-encodings"></span><h4 class="subsubsection">6.3.1.1 ‘<samp>-t</samp>’: Changing TeX encodings</h4> @@ -4351,9 +4304,11 @@ encoding.) </p> <hr> -<span id="Changing-PostScript-encodings"></span><div class="header"> +</div> +<div class="subsubsection" id="Changing-PostScript-encodings"> +<div class="header"> <p> -Next: <a href="#Changing-both-encodings" accesskey="n" rel="next">Changing both encodings</a>, Previous: <a href="#Changing-TeX-encodings" accesskey="p" rel="prev">Changing TeX encodings</a>, Up: <a href="#Changing-font-encodings" accesskey="u" rel="up">Changing font encodings</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> +Next: <a href="#Changing-both-encodings" accesskey="n" rel="next">‘<samp>-T</samp>’: Changing both TeX and PostScript encodings</a>, Previous: <a href="#Changing-TeX-encodings" accesskey="p" rel="prev">‘<samp>-t</samp>’: Changing TeX encodings</a>, Up: <a href="#Changing-font-encodings" accesskey="u" rel="up">Changing font encodings</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> </div> <span id="g_t_002dp_003a-Changing-PostScript-encodings"></span><h4 class="subsubsection">6.3.1.2 ‘<samp>-p</samp>’: Changing PostScript encodings</h4> @@ -4370,7 +4325,7 @@ ligkern info is always omitted from the raw TFM. </p> <p>If you use this option, you must also arrange to download <var>ps-enc</var> as part of any document that uses this font. You do this by adding a -line like the following one to <samp>psfonts.map</samp> (see <a href="#psfonts_002emap">psfonts.map</a>): +line like the following one to <samp>psfonts.map</samp> (see <a href="#psfonts_002emap"><samp>psfonts.map</samp>: PostScript font catalog</a>): </p><div class="example"> <pre class="example">zpopr Optima "MyEncoding ReEncodeFont" <myenc.enc </pre></div> @@ -4390,9 +4345,11 @@ distribution does do this reencoding, for precisely this reason. </p> <hr> -<span id="Changing-both-encodings"></span><div class="header"> +</div> +<div class="subsubsection" id="Changing-both-encodings"> +<div class="header"> <p> -Next: <a href="#Reencoding-with-Afm2tfm" accesskey="n" rel="next">Reencoding with Afm2tfm</a>, Previous: <a href="#Changing-PostScript-encodings" accesskey="p" rel="prev">Changing PostScript encodings</a>, Up: <a href="#Changing-font-encodings" accesskey="u" rel="up">Changing font encodings</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> +Next: <a href="#Reencoding-with-Afm2tfm" accesskey="n" rel="next">Reencoding with Afm2tfm</a>, Previous: <a href="#Changing-PostScript-encodings" accesskey="p" rel="prev">‘<samp>-p</samp>’: Changing PostScript encodings</a>, Up: <a href="#Changing-font-encodings" accesskey="u" rel="up">Changing font encodings</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> </div> <span id="g_t_002dT_003a-Changing-both-TeX-and-PostScript-encodings"></span><h4 class="subsubsection">6.3.1.3 ‘<samp>-T</samp>’: Changing both TeX and PostScript encodings</h4> @@ -4408,9 +4365,11 @@ particular PostScript font. </p> <hr> -<span id="Reencoding-with-Afm2tfm"></span><div class="header"> +</div> +<div class="subsubsection" id="Reencoding-with-Afm2tfm"> +<div class="header"> <p> -Next: <a href="#Encoding-file-format" accesskey="n" rel="next">Encoding file format</a>, Previous: <a href="#Changing-both-encodings" accesskey="p" rel="prev">Changing both encodings</a>, Up: <a href="#Changing-font-encodings" accesskey="u" rel="up">Changing font encodings</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> +Next: <a href="#Encoding-file-format" accesskey="n" rel="next">Encoding file format</a>, Previous: <a href="#Changing-both-encodings" accesskey="p" rel="prev">‘<samp>-T</samp>’: Changing both TeX and PostScript encodings</a>, Up: <a href="#Changing-font-encodings" accesskey="u" rel="up">Changing font encodings</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> </div> <span id="Reencoding-with-Afm2tfm-1"></span><h4 class="subsubsection">6.3.1.4 Reencoding with Afm2tfm</h4> @@ -4479,25 +4438,25 @@ of the distributed <samp>psfonts.sty</samp> for use with LaTeX. the various possible choices for reencoding. </p> <dl compact="compact"> -<dt>default encoding</dt> +<dt><span>default encoding</span></dt> <dd><div class="example"> <pre class="example">(CODINGSCHEME TeX text + AdobeStandardEncoding) </pre></div> </dd> -<dt>‘<samp>-p dc.enc</samp>’</dt> +<dt><span>‘<samp>-p dc.enc</samp>’</span></dt> <dd><div class="example"> <pre class="example">(CODINGSCHEME TeX text + DCEncoding) </pre></div> </dd> -<dt>‘<samp>-t dc.enc</samp>’</dt> +<dt><span>‘<samp>-t dc.enc</samp>’</span></dt> <dd><div class="example"> <pre class="example">(CODINGSCHEME DCEncoding + AdobeStandardEncoding) </pre></div> </dd> -<dt>‘<samp>-T dc.enc</samp>’</dt> +<dt><span>‘<samp>-T dc.enc</samp>’</span></dt> <dd><div class="example"> <pre class="example">(CODINGSCHEME DCEncoding + DCEncoding) </pre></div> @@ -4510,7 +4469,9 @@ ignored by Dvips. </p> <hr> -<span id="Encoding-file-format"></span><div class="header"> +</div> +<div class="subsubsection" id="Encoding-file-format"> +<div class="header"> <p> Previous: <a href="#Reencoding-with-Afm2tfm" accesskey="p" rel="prev">Reencoding with Afm2tfm</a>, Up: <a href="#Changing-font-encodings" accesskey="u" rel="up">Changing font encodings</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> </div> @@ -4617,9 +4578,12 @@ operation, so there are a total of eight possibilities: <hr> -<span id="Special-font-effects"></span><div class="header"> +</div> +</div> +<div class="subsection" id="Special-font-effects"> +<div class="header"> <p> -Next: <a href="#Afm2tfm-options" accesskey="n" rel="next">Afm2tfm options</a>, Previous: <a href="#Changing-font-encodings" accesskey="p" rel="prev">Changing font encodings</a>, Up: <a href="#Invoking-afm2tfm" accesskey="u" rel="up">Invoking afm2tfm</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> +Next: <a href="#Afm2tfm-options" accesskey="n" rel="next">Afm2tfm options</a>, Previous: <a href="#Changing-font-encodings" accesskey="p" rel="prev">Changing font encodings</a>, Up: <a href="#Invoking-afm2tfm" accesskey="u" rel="up">Invoking Afm2tfm</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> </div> <span id="Special-font-effects-1"></span><h4 class="subsection">6.3.2 Special font effects</h4> @@ -4710,9 +4674,11 @@ different output encodings) may be based on it. </p> <hr> -<span id="Afm2tfm-options"></span><div class="header"> +</div> +<div class="subsection" id="Afm2tfm-options"> +<div class="header"> <p> -Previous: <a href="#Special-font-effects" accesskey="p" rel="prev">Special font effects</a>, Up: <a href="#Invoking-afm2tfm" accesskey="u" rel="up">Invoking afm2tfm</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> +Previous: <a href="#Special-font-effects" accesskey="p" rel="prev">Special font effects</a>, Up: <a href="#Invoking-afm2tfm" accesskey="u" rel="up">Invoking Afm2tfm</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> </div> <span id="Afm2tfm-options-1"></span><h4 class="subsection">6.3.3 Afm2tfm options</h4> @@ -4748,14 +4714,13 @@ expects (see <a href="#Encodings">Encodings</a>). Although the encodings agree printable ASCII characters, other characters such as ligatures and accents vary. Thus, in practice, it’s almost always desirable to create a virtual font as well with the ‘<samp>-v</samp>’ or ‘<samp>-V</samp>’ option. -See <a href="#Making-a-font-available">Making a font available</a>. +See <a href="#Making-a-font-available">Making a PostScript font available</a>. </p> <p>The command line options to Afm2tfm: </p> <dl compact="compact"> -<dt>‘<samp>-a</samp>’</dt> -<dd><span id="index-_002da-1"></span> -<span id="index-accent-height-adjustment_002c-omitting"></span> +<dt id='index-_002da-1'><span>‘<samp>-a</samp>’<a href='#index-_002da-1' class='copiable-anchor'> ¶</a></span></dt> +<dd><span id="index-accent-height-adjustment_002c-omitting"></span> <p>By default, Afm2tfm looks for precomposed accented characters, such as tdieresis, and possibly adjusts the height of the basic letter (t) upward so that the result of using <code>\accent</code> (as in <code>\"t</code>) @@ -4766,74 +4731,64 @@ as they are given in the AFM file. (Until Afm2tfm 8.4, released in the case.) </p> </dd> -<dt>‘<samp>-c <var>ratio</var></samp>’</dt> -<dd><span id="index-_002dc-ratio"></span> -<span id="index-scaling-small-caps"></span> +<dt id='index-_002dc-ratio'><span>‘<samp>-c <var>ratio</var></samp>’<a href='#index-_002dc-ratio' class='copiable-anchor'> ¶</a></span></dt> +<dd><span id="index-scaling-small-caps"></span> <p>See ‘<samp>-V</samp>’; overrides the default ratio of 0.8 for the scaling of small caps. </p> </dd> -<dt>‘<samp>-e <var>ratio</var></samp>’</dt> -<dd><span id="index-_002de-ratio"></span> -<span id="index-expanded-fonts-1"></span> +<dt id='index-_002de-ratio'><span>‘<samp>-e <var>ratio</var></samp>’<a href='#index-_002de-ratio' class='copiable-anchor'> ¶</a></span></dt> +<dd><span id="index-expanded-fonts-1"></span> <span id="index-condensed-fonts"></span> <p>Stretch characters horizontally by <var>ratio</var>; if less than 1.0, you get a condensed font. </p> </dd> -<dt>‘<samp>-O</samp>’</dt> -<dd><span id="index-_002dO"></span> -<span id="index-octal-character-codes"></span> +<dt id='index-_002dO'><span>‘<samp>-O</samp>’<a href='#index-_002dO' class='copiable-anchor'> ¶</a></span></dt> +<dd><span id="index-octal-character-codes"></span> <p>Output all character codes in the ‘<samp>vpl</samp>’ file as octal numbers, not names; this is useful for symbol or other special-purpose fonts where character names such as ‘<samp>A</samp>’ have no meaning. </p> </dd> -<dt>‘<samp>-p <var>ps-enc</var></samp>’</dt> -<dd><span id="index-_002dp-ps_002denc-1"></span> -<p>Use <var>ps-enc</var> for the destination (PostScript) encoding of the font; +<dt id='index-_002dp-ps_002denc-1'><span>‘<samp>-p <var>ps-enc</var></samp>’<a href='#index-_002dp-ps_002denc-1' class='copiable-anchor'> ¶</a></span></dt> +<dd><p>Use <var>ps-enc</var> for the destination (PostScript) encoding of the font; <var>ps-enc</var> must be mentioned as a header file for the font in ‘<samp>psfonts.map</samp>’. -See <a href="#Changing-PostScript-encodings">Changing PostScript encodings</a>. +See <a href="#Changing-PostScript-encodings">‘<samp>-p</samp>’: Changing PostScript encodings</a>. </p> </dd> -<dt>‘<samp>-s <var>slant</var></samp>’</dt> -<dd><span id="index-_002ds-slant"></span> -<span id="index-slanted-fonts_002c-making"></span> +<dt id='index-_002ds-slant'><span>‘<samp>-s <var>slant</var></samp>’<a href='#index-_002ds-slant' class='copiable-anchor'> ¶</a></span></dt> +<dd><span id="index-slanted-fonts_002c-making"></span> <p>Slant characters to the right by <var>slant</var>. If <var>slant</var> is negative, the letters slope to the left (or they might be upright if you start with an italic font). </p> </dd> -<dt>‘<samp>-t <var>tex-enc</var></samp>’</dt> -<dd><span id="index-_002dt-tex_002denc-1"></span> -<p>Use <var>tex-enc</var> for the target (TeX) encoding of the font. +<dt id='index-_002dt-tex_002denc-1'><span>‘<samp>-t <var>tex-enc</var></samp>’<a href='#index-_002dt-tex_002denc-1' class='copiable-anchor'> ¶</a></span></dt> +<dd><p>Use <var>tex-enc</var> for the target (TeX) encoding of the font. Ligature and kern information may also be specified in <var>file</var>. <var>file</var> is not mentioned in <samp>psfonts.map</samp>. </p> </dd> -<dt>‘<samp>-T <var>ps-tex-enc</var></samp>’</dt> -<dd><span id="index-_002dT-ps_002dtex_002denc"></span> -<p>Use <var>ps-tex-enc</var> for both the PostScript and target TeX encodings +<dt id='index-_002dT-ps_002dtex_002denc'><span>‘<samp>-T <var>ps-tex-enc</var></samp>’<a href='#index-_002dT-ps_002dtex_002denc' class='copiable-anchor'> ¶</a></span></dt> +<dd><p>Use <var>ps-tex-enc</var> for both the PostScript and target TeX encodings of the font. Equivalent to ‘<samp>-p <var>file</var> -t <var>file</var></samp>’. </p> </dd> -<dt>‘<samp>-u</samp>’</dt> -<dd><span id="index-_002du"></span> -<p>Use only those characters specified in the TeX encoding, and no +<dt id='index-_002du'><span>‘<samp>-u</samp>’<a href='#index-_002du' class='copiable-anchor'> ¶</a></span></dt> +<dd><p>Use only those characters specified in the TeX encoding, and no others. By default, Afm2tfm tries to include all characters in the input font, even those not present in the TeX encoding (it puts them into otherwise-unused positions, arbitrarily). </p> </dd> -<dt>‘<samp>-v <var>vpl-file</var></samp>’</dt> -<dd><span id="index-_002dv-vpl_002dfile"></span> -<p>Output a VPL (virtual property list) file, as well as a TFM file. +<dt id='index-_002dv-vpl_002dfile'><span>‘<samp>-v <var>vpl-file</var></samp>’<a href='#index-_002dv-vpl_002dfile' class='copiable-anchor'> ¶</a></span></dt> +<dd><p>Output a VPL (virtual property list) file, as well as a TFM file. </p> </dd> -<dt>‘<samp>-V <var>vpl-file</var></samp>’</dt> -<dd><span id="index-_002dV-vpl_002dfile"></span> -<p>Same as ‘<samp>-v</samp>’, but the virtual font generated is a pseudo small caps +<dt id='index-_002dV-vpl_002dfile'><span>‘<samp>-V <var>vpl-file</var></samp>’<a href='#index-_002dV-vpl_002dfile' class='copiable-anchor'> ¶</a></span></dt> +<dd><p>Same as ‘<samp>-v</samp>’, but the virtual font generated is a pseudo small caps font obtained by scaling uppercase letters by 0.8 to typeset lowercase. This font handles accented letters and retains proper kerning. @@ -4842,9 +4797,12 @@ kerning. <hr> -<span id="psfonts_002emap"></span><div class="header"> +</div> +</div> +<div class="section" id="psfonts_002emap"> +<div class="header"> <p> -Previous: <a href="#Invoking-afm2tfm" accesskey="p" rel="prev">Invoking afm2tfm</a>, Up: <a href="#PostScript-fonts" accesskey="u" rel="up">PostScript fonts</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> +Previous: <a href="#Invoking-afm2tfm" accesskey="p" rel="prev">Invoking Afm2tfm</a>, Up: <a href="#PostScript-fonts" accesskey="u" rel="up">PostScript fonts</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> </div> <span id="psfonts_002emap_003a-PostScript-font-catalog"></span><h3 class="section">6.4 <samp>psfonts.map</samp>: PostScript font catalog</h3> @@ -4866,7 +4824,7 @@ files and constructs. Each line has the format: <pre class="example">rpstrn StoneInformal <StoneInformal.pfb </pre></div> <p>causes Dvips to download <samp>StoneInformal.pfb</samp> (just as if it were -a header file, see <a href="#Header-files">Header files</a>) if the DVI file (or a virtual +a header file, see <a href="#Header-files">PostScript header files</a>) if the DVI file (or a virtual font, see <a href="#Virtual-fonts">Virtual fonts</a>) references the TFM file ‘<samp>rpstrn</samp>’. The PostScript <code>/FontName</code> of the font defined inside the ‘<samp>pfb</samp>’ file should be <code>StoneInformal</code>. @@ -4923,7 +4881,7 @@ syntax, or Dvips will not download the font properly. <p>When using PFB files, Dvips is smart enough to unpack the binary PFB format into printable ASCII so there is no need to perform this conversion yourself. In addition, Dvips scans the font to determine its -memory usage, just as it does for other header files (see <a href="#Header-files">Header files</a>). +memory usage, just as it does for other header files (see <a href="#Header-files">PostScript header files</a>). </p> <span id="index-partial-font-downloading"></span> <span id="index-downloading-fonts-partially"></span> @@ -4984,9 +4942,12 @@ name, it is used for both the TeX name and the PostScript name. <hr> -<span id="Color"></span><div class="header"> +</div> +</div> +<div class="chapter" id="Color"> +<div class="header"> <p> -Next: <a href="#Index" accesskey="n" rel="next">Index</a>, Previous: <a href="#PostScript-fonts" accesskey="p" rel="prev">PostScript fonts</a>, Up: <a href="#Top" accesskey="u" rel="up">Top</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> +Next: <a href="#Index" accesskey="n" rel="next">Index</a>, Previous: <a href="#PostScript-fonts" accesskey="p" rel="prev">PostScript fonts</a>, Up: <a href="#Top" accesskey="u" rel="up">Dvips</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> </div> <span id="Color-1"></span><h2 class="chapter">7 Color</h2> @@ -5005,24 +4966,19 @@ LaTeX. preparer’s point of view and then add some instructions on installation for the TeX administrator. </p> -<table class="menu" border="0" cellspacing="0"> -<tr><td align="left" valign="top">• <a href="#Color-macro-files" accesskey="1">Color macro files</a></td><td> </td><td align="left" valign="top">TeX macro definitions. -</td></tr> -<tr><td align="left" valign="top">• <a href="#User_002ddefinable-colors" accesskey="2">User-definable colors</a></td><td> </td><td align="left" valign="top">Adding your own colors. -</td></tr> -<tr><td align="left" valign="top">• <a href="#Color-subtleties" accesskey="3">Color subtleties</a></td><td> </td><td align="left" valign="top">Subtleties in using color. -</td></tr> -<tr><td align="left" valign="top">• <a href="#Ted-Turner" accesskey="4">Ted Turner</a></td><td> </td><td align="left" valign="top">Printing in black/white after colorizing. -</td></tr> -<tr><td align="left" valign="top">• <a href="#Color-device-configuration" accesskey="5">Color device configuration</a></td><td> </td><td align="left" valign="top">Configuring Dvips for color devices. -</td></tr> -<tr><td align="left" valign="top">• <a href="#Color-support-details" accesskey="6">Color support details</a></td><td> </td><td align="left" valign="top">Color support details -</td></tr> -</table> +<ul class="section-toc"> +<li><a href="#Color-macro-files" accesskey="1">Color macro files</a></li> +<li><a href="#User_002ddefinable-colors" accesskey="2">User-definable colors</a></li> +<li><a href="#Color-subtleties" accesskey="3">Color subtleties</a></li> +<li><a href="#Ted-Turner" accesskey="4">Printing in black/white after colorizing</a></li> +<li><a href="#Color-device-configuration" accesskey="5">Color device configuration</a></li> +<li><a href="#Color-support-details" accesskey="6">Color support details</a></li> +</ul> <hr> -<span id="Color-macro-files"></span><div class="header"> +<div class="section" id="Color-macro-files"> +<div class="header"> <p> Next: <a href="#User_002ddefinable-colors" accesskey="n" rel="next">User-definable colors</a>, Up: <a href="#Color" accesskey="u" rel="up">Color</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> </div> @@ -5120,7 +5076,9 @@ and LaTeX use compatible. </p> <hr> -<span id="User_002ddefinable-colors"></span><div class="header"> +</div> +<div class="section" id="User_002ddefinable-colors"> +<div class="header"> <p> Next: <a href="#Color-subtleties" accesskey="n" rel="next">Color subtleties</a>, Previous: <a href="#Color-macro-files" accesskey="p" rel="prev">Color macro files</a>, Up: <a href="#Color" accesskey="u" rel="up">Color</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> </div> @@ -5160,9 +5118,11 @@ and do its best to recover by discarding the current color history. </p> <hr> -<span id="Color-subtleties"></span><div class="header"> +</div> +<div class="section" id="Color-subtleties"> +<div class="header"> <p> -Next: <a href="#Ted-Turner" accesskey="n" rel="next">Ted Turner</a>, Previous: <a href="#User_002ddefinable-colors" accesskey="p" rel="prev">User-definable colors</a>, Up: <a href="#Color" accesskey="u" rel="up">Color</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> +Next: <a href="#Ted-Turner" accesskey="n" rel="next">Printing in black/white after colorizing</a>, Previous: <a href="#User_002ddefinable-colors" accesskey="p" rel="prev">User-definable colors</a>, Up: <a href="#Color" accesskey="u" rel="up">Color</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> </div> <span id="Color-subtleties-1"></span><h3 class="section">7.3 Color subtleties</h3> @@ -5201,7 +5161,9 @@ be done by prefixing the color command with <code>\leavevmode</code>. </p> <hr> -<span id="Ted-Turner"></span><div class="header"> +</div> +<div class="section" id="Ted-Turner"> +<div class="header"> <p> Next: <a href="#Color-device-configuration" accesskey="n" rel="next">Color device configuration</a>, Previous: <a href="#Color-subtleties" accesskey="p" rel="prev">Color subtleties</a>, Up: <a href="#Color" accesskey="u" rel="up">Color</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> </div> @@ -5226,9 +5188,11 @@ compatible with some form of color support. </p> <hr> -<span id="Color-device-configuration"></span><div class="header"> +</div> +<div class="section" id="Color-device-configuration"> +<div class="header"> <p> -Next: <a href="#Color-support-details" accesskey="n" rel="next">Color support details</a>, Previous: <a href="#Ted-Turner" accesskey="p" rel="prev">Ted Turner</a>, Up: <a href="#Color" accesskey="u" rel="up">Color</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> +Next: <a href="#Color-support-details" accesskey="n" rel="next">Color support details</a>, Previous: <a href="#Ted-Turner" accesskey="p" rel="prev">Printing in black/white after colorizing</a>, Up: <a href="#Color" accesskey="u" rel="up">Color</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> </div> <span id="Color-device-configuration-1"></span><h3 class="section">7.5 Color device configuration</h3> @@ -5289,7 +5253,9 @@ predefine other colors for your users. </p> <hr> -<span id="Color-support-details"></span><div class="header"> +</div> +<div class="section" id="Color-support-details"> +<div class="header"> <p> Previous: <a href="#Color-device-configuration" accesskey="p" rel="prev">Color device configuration</a>, Up: <a href="#Color" accesskey="u" rel="up">Color</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> </div> @@ -5299,16 +5265,15 @@ Previous: <a href="#Color-device-configuration" accesskey="p" rel="prev">Color d specials start with the keyword ‘<samp>color</samp>’ or the keyword ‘<samp>background</samp>’, followed by a color specification. </p> -<table class="menu" border="0" cellspacing="0"> -<tr><td align="left" valign="top">• <a href="#Color-specifications" accesskey="1">Color specifications</a></td><td> </td><td align="left" valign="top"> -</td></tr> -<tr><td align="left" valign="top">• <a href="#Color-specials" accesskey="2">Color specials</a></td><td> </td><td align="left" valign="top"> -</td></tr> -</table> +<ul class="section-toc"> +<li><a href="#Color-specifications" accesskey="1">Color specifications</a></li> +<li><a href="#Color-specials" accesskey="2">Color specials</a></li> +</ul> <hr> -<span id="Color-specifications"></span><div class="header"> +<div class="subsection" id="Color-specifications"> +<div class="header"> <p> Next: <a href="#Color-specials" accesskey="n" rel="next">Color specials</a>, Up: <a href="#Color-support-details" accesskey="u" rel="up">Color support details</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> </div> @@ -5342,7 +5307,9 @@ pattern (assuming such exists.) </p> <hr> -<span id="Color-specials"></span><div class="header"> +</div> +<div class="subsection" id="Color-specials"> +<div class="header"> <p> Previous: <a href="#Color-specifications" accesskey="p" rel="prev">Color specifications</a>, Up: <a href="#Color-support-details" accesskey="u" rel="up">Color support details</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> </div> @@ -5388,9 +5355,13 @@ categories of color-like state. </p> <hr> -<span id="Index"></span><div class="header"> +</div> +</div> +</div> +<div class="unnumbered" id="Index"> +<div class="header"> <p> -Previous: <a href="#Color" accesskey="p" rel="prev">Color</a>, Up: <a href="#Top" accesskey="u" rel="up">Top</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> +Previous: <a href="#Color" accesskey="p" rel="prev">Color</a>, Up: <a href="#Top" accesskey="u" rel="up">Dvips</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> </div> <span id="Index-1"></span><h2 class="unnumbered">Index</h2> @@ -5533,7 +5504,8 @@ Previous: <a href="#Color" accesskey="p" rel="prev">Color</a>, Up: <a href="#Top <tr><td></td><td valign="top"><a href="#index-_002dK"><code>-K</code></a>:</td><td> </td><td valign="top"><a href="#Option-details">Option details</a></td></tr> <tr><td></td><td valign="top"><a href="#index-_002dk-for-cropmarks"><code>-k <span class="roman">for cropmarks</span></code></a>:</td><td> </td><td valign="top"><a href="#Option-details">Option details</a></td></tr> <tr><td></td><td valign="top"><a href="#index-_002dL"><code>-L</code></a>:</td><td> </td><td valign="top"><a href="#Option-details">Option details</a></td></tr> -<tr><td></td><td valign="top"><a href="#index-_002dl-_005b_003d_005dnum"><code>-l [=]<var>num</var></code></a>:</td><td> </td><td valign="top"><a href="#Option-details">Option details</a></td></tr> +<tr><td></td><td valign="top"><a href="#index-_002dl-_005b_003d_005dnum_005b_002epageseq_005d"><code>-l [=]<var>num</var>[.<var>pageseq</var>]</code></a>:</td><td> </td><td valign="top"><a href="#Option-details">Option details</a></td></tr> +<tr><td></td><td valign="top"><a href="#index-_002dlandscaperotate"><code>-landscaperotate</code></a>:</td><td> </td><td valign="top"><a href="#Option-details">Option details</a></td></tr> <tr><td></td><td valign="top"><a href="#index-_002dm"><code>-m</code></a>:</td><td> </td><td valign="top"><a href="#Option-details">Option details</a></td></tr> <tr><td></td><td valign="top"><a href="#index-_002dM"><code>-M</code></a>:</td><td> </td><td valign="top"><a href="#Option-details">Option details</a></td></tr> <tr><td></td><td valign="top"><a href="#index-_002dmode-mode"><code>-mode <var>mode</var></code></a>:</td><td> </td><td valign="top"><a href="#Option-details">Option details</a></td></tr> @@ -5547,7 +5519,7 @@ Previous: <a href="#Color" accesskey="p" rel="prev">Color</a>, Up: <a href="#Top <tr><td></td><td valign="top"><a href="#index-_002dP-printer"><code>-P <var>printer</var></code></a>:</td><td> </td><td valign="top"><a href="#Option-details">Option details</a></td></tr> <tr><td></td><td valign="top"><a href="#index-_002dp-ps_002denc"><code>-p <var>ps-enc</var></code></a>:</td><td> </td><td valign="top"><a href="#Changing-PostScript-encodings">Changing PostScript encodings</a></td></tr> <tr><td></td><td valign="top"><a href="#index-_002dp-ps_002denc-1"><code>-p <var>ps-enc</var></code></a>:</td><td> </td><td valign="top"><a href="#Afm2tfm-options">Afm2tfm options</a></td></tr> -<tr><td></td><td valign="top"><a href="#index-_002dp-_005b_003d_005dnum"><code>-p [=]<var>num</var></code></a>:</td><td> </td><td valign="top"><a href="#Option-details">Option details</a></td></tr> +<tr><td></td><td valign="top"><a href="#index-_002dp-_005b_003d_005dnum_005b_002epageseq_005d"><code>-p [=]<var>num</var>[.<var>pageseq</var>]</code></a>:</td><td> </td><td valign="top"><a href="#Option-details">Option details</a></td></tr> <tr><td></td><td valign="top"><a href="#index-_002dpp-first_002dlast"><code>-pp <var>first</var>-<var>last</var></code></a>:</td><td> </td><td valign="top"><a href="#Option-details">Option details</a></td></tr> <tr><td></td><td valign="top"><a href="#index-_002dpp-range"><code>-pp <var>range</var></code></a>:</td><td> </td><td valign="top"><a href="#Option-details">Option details</a></td></tr> <tr><td></td><td valign="top"><a href="#index-_002dPprinter_002c-and-config-file-searching"><code>-P<var>printer</var><span class="roman">, and config file searching</span></code></a>:</td><td> </td><td valign="top"><a href="#Configuration-file-searching">Configuration file searching</a></td></tr> @@ -5889,7 +5861,6 @@ Previous: <a href="#Color" accesskey="p" rel="prev">Color</a>, Up: <a href="#Top <tr><td></td><td valign="top"><a href="#index-hsize-_0028psfile-special-option_0029"><code>hsize <span class="roman">(‘<samp>psfile</samp>’ special option)</span></code></a>:</td><td> </td><td valign="top"><a href="#psfile-special">psfile special</a></td></tr> <tr><td></td><td valign="top"><a href="#index-html-specials"><code>html <span class="roman">specials</span></code></a>:</td><td> </td><td valign="top"><a href="#Hypertext">Hypertext</a></td></tr> <tr><td></td><td valign="top"><a href="#index-html-specials_002c-and-_002dz"><code>html <span class="roman">specials, and ‘<samp>-z</samp>’</span></code></a>:</td><td> </td><td valign="top"><a href="#Option-details">Option details</a></td></tr> -<tr><td></td><td valign="top"><a href="#index-http_003a_002f_002fxxx_002elanl_002egov_002fhypertex"><code><code>http://xxx.lanl.gov/hypertex</code></code></a>:</td><td> </td><td valign="top"><a href="#Hypertext">Hypertext</a></td></tr> <tr><td></td><td valign="top"><a href="#index-Hungarian-umlaut">Hungarian umlaut</a>:</td><td> </td><td valign="top"><a href="#Reencoding-with-Afm2tfm">Reencoding with Afm2tfm</a></td></tr> <tr><td></td><td valign="top"><a href="#index-hyperdvi-extensions_002c-enabling">hyperdvi extensions, enabling</a>:</td><td> </td><td valign="top"><a href="#Option-details">Option details</a></td></tr> <tr><td></td><td valign="top"><a href="#index-hypertext-and-bitmap-fonts">hypertext and bitmap fonts</a>:</td><td> </td><td valign="top"><a href="#Hypertext-caveats">Hypertext caveats</a></td></tr> @@ -5929,6 +5900,10 @@ Previous: <a href="#Color" accesskey="p" rel="prev">Color</a>, Up: <a href="#Top <tr><td></td><td valign="top"><a href="#index-landscape-orientation_002c-defined">landscape orientation, defined</a>:</td><td> </td><td valign="top"><a href="#Paper-size-and-landscape">Paper size and landscape</a></td></tr> <tr><td></td><td valign="top"><a href="#index-landscape-papertype">landscape papertype</a>:</td><td> </td><td valign="top"><a href="#Option-details">Option details</a></td></tr> <tr><td></td><td valign="top"><a href="#index-landscape_002c-as-_005cspecial"><code>landscape<span class="roman">, as <code>\special</code></span></code></a>:</td><td> </td><td valign="top"><a href="#papersize-special">‘<samp>papersize</samp>’ special</a></td></tr> +<tr><td></td><td valign="top"><a href="#index-landscaperotate">landscaperotate</a>:</td><td> </td><td valign="top"><a href="#Option-details">Option details</a></td></tr> +<tr><td></td><td valign="top"><a href="#index-landscaperotate-command-line-option">landscaperotate command line option</a>:</td><td> </td><td valign="top"><a href="#Config-file-paper-sizes">Config file paper sizes</a></td></tr> +<tr><td></td><td valign="top"><a href="#index-landscaperotate-config-command"><code>landscaperotate <span class="roman">config command</span></code></a>:</td><td> </td><td valign="top"><a href="#Configuration-file-commands">Configuration file commands</a></td></tr> +<tr><td></td><td valign="top"><a href="#index-landscaperotate-configuration-file-command">landscaperotate configuration file command</a>:</td><td> </td><td valign="top"><a href="#Config-file-paper-sizes">Config file paper sizes</a></td></tr> <tr><td></td><td valign="top"><a href="#index-last-page-printed">last page printed</a>:</td><td> </td><td valign="top"><a href="#Option-details">Option details</a></td></tr> <tr><td></td><td valign="top"><a href="#index-last_002dresort-font-scaling_002c-with-DVIPSSIZES">last-resort font scaling, with <code>DVIPSSIZES</code></a>:</td><td> </td><td valign="top"><a href="#Environment-variables">Environment variables</a></td></tr> <tr><td></td><td valign="top"><a href="#index-last_002dresort-scaling_002c-with-R">last-resort scaling, with <code>R</code></a>:</td><td> </td><td valign="top"><a href="#Configuration-file-commands">Configuration file commands</a></td></tr> @@ -6026,6 +6001,7 @@ Previous: <a href="#Color" accesskey="p" rel="prev">Color</a>, Up: <a href="#Top <tr><th id="Index_cp_letter-P">P</th><td></td><td></td></tr> <tr><td></td><td valign="top"><a href="#index-p-config-command-_0028font-aliases_0029"><code>p <span class="roman">config command (font aliases)</span></code></a>:</td><td> </td><td valign="top"><a href="#Configuration-file-commands">Configuration file commands</a></td></tr> <tr><td></td><td valign="top"><a href="#index-P-config-command-_0028PK-path_0029"><code>P <span class="roman">config command (PK path)</span></code></a>:</td><td> </td><td valign="top"><a href="#Configuration-file-commands">Configuration file commands</a></td></tr> +<tr><td></td><td valign="top"><a href="#index-page-numbers_002c-multiple-repetitions-of">page numbers, multiple repetitions of</a>:</td><td> </td><td valign="top"><a href="#Option-details">Option details</a></td></tr> <tr><td></td><td valign="top"><a href="#index-page-range">page range</a>:</td><td> </td><td valign="top"><a href="#Option-details">Option details</a></td></tr> <tr><td></td><td valign="top"><a href="#index-page_002c-first-printed">page, first printed</a>:</td><td> </td><td valign="top"><a href="#Option-details">Option details</a></td></tr> <tr><td></td><td valign="top"><a href="#index-page_002c-last-printed">page, last printed</a>:</td><td> </td><td valign="top"><a href="#Option-details">Option details</a></td></tr> @@ -6256,6 +6232,7 @@ Previous: <a href="#Color" accesskey="p" rel="prev">Color</a>, Up: <a href="#Top <tr><th id="Index_cp_letter-Z">Z</th><td></td><td></td></tr> <tr><td></td><td valign="top"><a href="#index-Z-config-command-_0028compress-fonts_0029"><code>Z <span class="roman">config command (compress fonts)</span></code></a>:</td><td> </td><td valign="top"><a href="#Configuration-file-commands">Configuration file commands</a></td></tr> <tr><td></td><td valign="top"><a href="#index-z-config-command-_0028secure-mode_0029"><code>z <span class="roman">config command (secure mode)</span></code></a>:</td><td> </td><td valign="top"><a href="#Configuration-file-commands">Configuration file commands</a></td></tr> +<tr><td></td><td valign="top"><a href="#index-zero-dimensions-and-setting-paper-size">zero dimensions and setting paper size</a>:</td><td> </td><td valign="top"><a href="#Config-file-paper-sizes">Config file paper sizes</a></td></tr> <tr><td colspan="4"> <hr></td></tr> </table> <table><tr><th valign="top">Jump to: </th><td><a class="summary-letter" href="#Index_cp_symbol-1"><b>!</b></a> @@ -6343,7 +6320,8 @@ Previous: <a href="#Color" accesskey="p" rel="prev">Color</a>, Up: <a href="#Top </td></tr></table> -<hr> +</div> +</div> diff --git a/Master/texmf-dist/doc/dvips/dvips.pdf b/Master/texmf-dist/doc/dvips/dvips.pdf Binary files differindex 767f8e378c2..84c433c2148 100644 --- a/Master/texmf-dist/doc/dvips/dvips.pdf +++ b/Master/texmf-dist/doc/dvips/dvips.pdf diff --git a/Master/texmf-dist/doc/info/dvips.info b/Master/texmf-dist/doc/info/dvips.info index 07bdeff39f2..34086bc9dc3 100644 --- a/Master/texmf-dist/doc/info/dvips.info +++ b/Master/texmf-dist/doc/info/dvips.info @@ -1,11 +1,11 @@ -This is dvips.info, produced by makeinfo version 5.1 from dvips.texi. +This is dvips.info, produced by makeinfo version 6.8 from dvips.texi. -This manual documents Dvips version 2021.1 (February 2021), a program to +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. INFO-DIR-SECTION TeX START-INFO-DIR-ENTRY -* DVI-to-Postscript: (dvips). Translating TeX DVI files to PostScript. +* DVI-to-PostScript: (dvips). Translating TeX DVI files to PostScript. * afm2tfm: (dvips)Invoking afm2tfm. Making Type 1 fonts available to TeX. * dvips: (dvips)Invoking Dvips. DVI-to-PostScript translator. END-INFO-DIR-ENTRY @@ -16,7 +16,7 @@ File: dvips.info, Node: Top, Next: Why Dvips, Up: (dir) Dvips ***** -This manual documents Dvips version 2021.1 (February 2021), a program to +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. @@ -213,7 +213,7 @@ format. The latest version is available via <https://ghostscript.com>. 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 '%%Page' comments (no 'N' in +in structured PostScript, specifically with '%%Page' comments (no 'N' in 'config.ps'). The current version is known as GV, and is available from <https://www.gnu.org/software/gv>. @@ -416,9 +416,9 @@ environment variables, and command-line options. * Menu: * Basic usage:: -* Command-line options:: -* Environment variables:: -* Config files:: +* Command-line options:: +* Environment variables:: +* Config files:: File: dvips.info, Node: Basic usage, Next: Command-line options, Up: Invoking Dvips @@ -639,8 +639,10 @@ reversal, use '-r0'. Such options are marked with a trailing '*'. '-h NAME' Prepend NAME as an additional header file, or, if NAME is '-', - suppress all header files. Any definitions in the header file get - added to the PostScript 'userdict'. + suppress inclusion of default header files. If '-h' is given + multiple times, the headers are included in the order given. Any + definitions in the header file get added to the PostScript + 'userdict'. '-i*' Make each section be a separate file; a "section" is a part of the @@ -684,18 +686,35 @@ reversal, use '-r0'. Such options are marked with a trailing '*'. header macros from some software packages read portion the input stream line by line, searching for a particular comment. -'-l [=]NUM' - The last page printed will be the first one numbered NUM. Default - is the last page in the document. If NUM is prefixed by an equals - sign, then it (and the argument to the '-p' option, if specified) - is treated as a physical (absolute) page number, rather than a - value to compare with the TeX '\count0' values stored in the DVI - file. Thus, using '-l =9' will end with the ninth page of the - document, no matter what the pages are actually numbered. +'-l [=]NUM[.PAGESEQ]' + The last page printed will be the first one numbered NUM; the + default is the last page in the document. + + By default, NUM is compared to TeX's idea of the page number (more + precisely, the '\count0' value written in the DVI file). But if + NUM is prefixed by an equals sign, then it (and the argument to the + '-p' option, if specified) is treated as a physical (absolute) page + number, Thus, using '-l =9' will end the output with the ninth page + of the document, no matter what the pages are actually numbered. + + On the other hand, if PAGESEQ is specified, the PAGESEQth + occurrence of the given TeX page number is used. For example, '-l + 99.2' says to end with the second page numbered 99 in the document. + The '=' and LASTSEQ features aren't useful together. '-L*' By default or with '-L1', the last 'papersize' special wins; with - '-L0', the first special wins. *Note 'papersize' special::. + '-L0', the first special wins. *Note papersize special::. + +'-landscaperotate*' + 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 (*note Config file paper sizes::). 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. '-m*' Specify manual feed, if supported by the output device. @@ -771,7 +790,7 @@ reversal, use '-r0'. Such options are marked with a trailing '*'. '-O X-OFFSET,Y-OFFSET' Move the origin by X-OFFSET,Y-OFFSET, a comma-separated pair of - dimensions such as '.1in,-.3cm' (*note 'papersize' special::). The + dimensions such as '.1in,-.3cm' (*note papersize special::). The origin of the page is shifted from the default position (of one inch down, one inch to the right from the upper left corner of the paper) by this amount. This is usually best specified in the @@ -787,14 +806,9 @@ reversal, use '-r0'. Such options are marked with a trailing '*'. every page, your best recourse is to use 'bop-hook' (*note PostScript hooks::). -'-p [=]NUM' - The first page printed will be the first one numbered NUM. Default - is the first page in the document. If NUM is prefixed by an equals - sign, then it (and the argument to the '-l' option, if specified) - is treated as a physical (absolute) page number, rather than a - value to compare with the TeX '\count0' values stored in the DVI - file. Thus, using '-p =3' will start with the third page of the - document, no matter what the pages are actually numbered. +'-p [=]NUM[.PAGESEQ]' + Exactly analogous to '-l' (q.v.), but specifying the first page + number to be printed (processed). '-pp FIRST-LAST' Print pages FIRST through LAST; equivalent to '-p FIRST -l LAST', @@ -875,7 +889,7 @@ reversal, use '-r0'. Such options are marked with a trailing '*'. '-T HSIZE,VSIZE' Set the paper size to (HSIZE,VSIZE), a comma-separated pair of - dimensions such as '.1in,-.3cm' (*note 'papersize' special::). It + dimensions such as '.1in,-.3cm' (*note papersize special::). 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 '-tunknown'. @@ -1153,7 +1167,9 @@ There is no provision for continuation lines. Option details::. 'h HEADER' - Prepend HEADER to output. Same as 'h-', *note Option details::. + Prepend HEADER to output. Same as 'h-'; that is, the config file + 'h' directive suppresses any inclusion of standard headers (*note + Option details::). 'H PATH' Use PATH to search for PostScript header files. The environment @@ -1175,6 +1191,10 @@ There is no provision for continuation lines. If zero, the first paper size specified is effective, else the last. Same as '-L', *note Option details::. +'landscaperotate' + Permit rotation of page content to match page size. Same as + '-landscaperotate', *note Option details::. + 'm NUM' Declare NUM as the memory available for fonts and strings in the printer. The compile-time default is 180000, but this is typically @@ -1207,7 +1227,7 @@ There is no provision for continuation lines. 'N*' Disable structured comments. Beware: This also turns off - displaying page numbers or changing to specific pagenumbers in + displaying page numbers or changing to specific page numbers in PostScript viewers. Same as '-N', *note Option details::. 'o NAME' @@ -1338,12 +1358,12 @@ attempt to override it manually. * Menu: -* 'papersize' special:: Specifying the paper size in TeX. +* papersize special:: Specifying the paper size in TeX. * Config file paper sizes:: Specifying printer- and site-specific sizes. * Paper trays:: Changing paper trays automatically. -File: dvips.info, Node: 'papersize' special, Next: Config file paper sizes, Up: Paper size and landscape +File: dvips.info, Node: papersize special, Next: Config file paper sizes, Up: Paper size and landscape 4.1 'papersize' special ======================= @@ -1365,7 +1385,7 @@ An alternate specification of 'landscape': \special{landscape} This is supported for backward compatibility, but it is hoped that -reventually the 'papersize' comment will dominate. +eventually the 'papersize' comment will dominate. Of course, such a '\special' only informs Dvips of the desired paper size; you must also adjust '\hsize' and '\vsize' in your TeX document @@ -1386,7 +1406,7 @@ the first special wins--this was the behavior of Dvips prior to the 2017 release. -File: dvips.info, Node: Config file paper sizes, Next: Paper trays, Prev: 'papersize' special, Up: Paper size and landscape +File: dvips.info, Node: Config file paper sizes, Next: Paper trays, Prev: papersize special, Up: Paper size and landscape 4.2 Configuration file paper size command ========================================= @@ -1443,7 +1463,21 @@ with zero dimensions is used; this should be the 'unknown' paper size definition mentioned below, resulting in the actual dimensions being used. - Landscape mode for all paper sizes is automatically supported. + 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 '/MediaBox' then ends +up with rotated values, which is not expected by PDF viewers, e.g., when +a document intentionally has a single page rotated.) + + 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 '-landscaperotate' command line +option or 'landscaperotate' configuration file option can be used. +*Note Option details::. If your printer has a command to set a special paper size, then give dimensions of '0in 0in'; the PostScript code that sets the paper size @@ -1730,8 +1764,8 @@ terminal when it processes each figure, give the command: * Menu: -* EPSF scaling:: -* EPSF clipping:: +* EPSF scaling:: +* EPSF clipping:: File: dvips.info, Node: EPSF scaling, Next: EPSF clipping, Up: EPSF macros @@ -2003,8 +2037,8 @@ header files are included. * Menu: -* Including headers from TeX:: -* Including headers from the command line:: +* Including headers from TeX:: +* Including headers from the command line:: * Headers and memory usage:: @@ -2381,11 +2415,6 @@ more, but copies are available elsewhere: <http://www.math.hawaii.edu/~ralph/MathOnWeb/TeXPDF.html> <http://www.utdallas.edu/~cantrell/online/543e.html> - 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: -<http://www.emrg.com/texpdf.htmlhttp://zandtwerk.insead.fr/tex2pdf.html>. - File: dvips.info, Node: Hypertext specials, Prev: Hypertext caveats, Up: Hypertext @@ -2530,7 +2559,7 @@ ff, ffi, and ffl.) Different typesetting systems use different metric file formats: - * Each Postscript font has an "Adobe font metrics" ('.afm') file. + * Each PostScript font has an "Adobe font metrics" ('.afm') file. These files are plain text, so you can inspect them easily. You can get AFM files for Adobe's fonts from <ftp://ftp.adobe.com/pub/adobe/Fonts/AFMs>. @@ -2588,7 +2617,7 @@ appearance of the font at small sizes or low resolutions. Although various kinds of PostScript outline fonts exist, by far the most common, and the only one we will consider, is called "Type 1". The -glyph files for Postscript Type 1 fonts typically have names ending in +glyph files for PostScript Type 1 fonts typically have names ending in '.pfa' ("printer font ASCII") or '.pfb' ("printer font binary"). In contrast, glyph files for Computer Modern and the other standard @@ -2707,7 +2736,7 @@ To dvips, bitmapped fonts do not have any notion of linguistics; they 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. +legible text from PostScript and PDF output. Unlike previous versions, dvips versions 2020 and later add glyph naming information to Type 3 bitmapped fonts (if they can locate such @@ -2862,7 +2891,7 @@ something like this: afm2tfm Times-Roman -v ptmr rptmr This reads the file 'Times-Roman.afm', and produces two files as output, -namely the virtual property list'file 'ptmr.vpl', and the "raw" font +namely the virtual property list file 'ptmr.vpl', and the "raw" font metric file 'rptmr.tfm'. To use the font in TeX, you first run vptovf ptmr.vpl ptmr.vf ptmr.tfm @@ -3774,23 +3803,23 @@ Index * Menu: * ! special (literal PS header): Literal headers. (line 6) -* ! starting output filename: Option details. (line 247) +* ! starting output filename: Option details. (line 266) * " special (literal PostScript): " special. (line 6) * %%BoundingBox: Bounding box. (line 17) * %%Page, and multi-page information: PostScript hooks. (line 37) -* %%Page, not generating: Option details. (line 212) -* %%Page, removing: Option details. (line 165) +* %%Page, not generating: Option details. (line 231) +* %%Page, removing: Option details. (line 167) * %%Page, required by Ghostview: Ghostscript installation. (line 12) -* %%Title: Option details. (line 357) +* %%Title: Option details. (line 371) * %%VMusage: Headers and memory usage. (line 12) * %*Font: Fonts in figures. (line 6) * (atend), bounding box specification: Bounding box. (line 28) * +PSMAPFILE: Configuration file commands. - (line 126) + (line 132) * -: Option details. (line 11) -* - as output filename: Option details. (line 247) +* - as output filename: Option details. (line 266) * --help: Option summary. (line 7) * --help <1>: Option details. (line 15) * --version: Option details. (line 18) @@ -3812,60 +3841,61 @@ Index * -F: Option details. (line 115) * -G: Option details. (line 122) * -h NAME: Option details. (line 127) -* -i: Option details. (line 132) -* -j for partial font downloading: Option details. (line 151) -* -K: Option details. (line 165) -* -k for cropmarks: Option details. (line 157) -* -L: Option details. (line 183) -* -l [=]NUM: Option details. (line 174) -* -m: Option details. (line 187) -* -M: Option details. (line 199) -* -mode MODE: Option details. (line 190) -* -N: Option details. (line 212) -* -n NUM: Option details. (line 209) -* -noomega: Option details. (line 220) -* -noptex: Option details. (line 226) +* -i: Option details. (line 134) +* -j for partial font downloading: Option details. (line 153) +* -K: Option details. (line 167) +* -k for cropmarks: Option details. (line 159) +* -L: Option details. (line 192) +* -l [=]NUM[.PAGESEQ]: Option details. (line 176) +* -landscaperotate: Option details. (line 196) +* -m: Option details. (line 206) +* -M: Option details. (line 218) +* -mode MODE: Option details. (line 209) +* -N: Option details. (line 231) +* -n NUM: Option details. (line 228) +* -noomega: Option details. (line 239) +* -noptex: Option details. (line 245) * -O: Afm2tfm options. (line 51) -* -o NAME: Option details. (line 242) -* -O X-OFFSET,Y-OFFSET: Option details. (line 259) -* -P PRINTER: Option details. (line 291) +* -o NAME: Option details. (line 261) +* -O X-OFFSET,Y-OFFSET: Option details. (line 278) +* -P PRINTER: Option details. (line 305) * -p PS-ENC: Changing PostScript encodings. (line 6) * -p PS-ENC <1>: Afm2tfm options. (line 56) -* -p [=]NUM: Option details. (line 277) -* -pp FIRST-LAST: Option details. (line 286) -* -pp RANGE: Option details. (line 286) +* -p [=]NUM[.PAGESEQ]: Option details. (line 296) +* -pp FIRST-LAST: Option details. (line 300) +* -pp RANGE: Option details. (line 300) * -PPRINTER, and config file searching: Configuration file searching. (line 27) -* -q: Option details. (line 310) -* -r: Option details. (line 314) -* -R: Option details. (line 317) -* -s: Option details. (line 325) -* -S NUM: Option details. (line 332) +* -q: Option details. (line 324) +* -r: Option details. (line 328) +* -R: Option details. (line 331) +* -s: Option details. (line 339) +* -S NUM: Option details. (line 346) * -s SLANT: Afm2tfm options. (line 61) * -T ENC-FILE: Changing both encodings. (line 6) -* -T HSIZE,VSIZE: Option details. (line 363) -* -t PAPERTYPE: Option details. (line 337) +* -T HSIZE,VSIZE: Option details. (line 377) +* -t PAPERTYPE: Option details. (line 351) * -T PS-TEX-ENC: Afm2tfm options. (line 71) * -t TEX-ENC: Changing TeX encodings. (line 6) * -t TEX-ENC <1>: Afm2tfm options. (line 66) -* -title STR: Option details. (line 357) -* -U: Option details. (line 378) +* -title STR: Option details. (line 371) +* -U: Option details. (line 392) * -u: Afm2tfm options. (line 75) -* -u PSMAPFILE: Option details. (line 370) -* -v: Option details. (line 386) -* -V: Option details. (line 389) +* -u PSMAPFILE: Option details. (line 384) +* -v: Option details. (line 400) +* -V: Option details. (line 403) * -v VPL-FILE: Afm2tfm options. (line 81) * -V VPL-FILE: Afm2tfm options. (line 84) -* -x NUM: Option details. (line 398) -* -X NUM: Option details. (line 406) -* -Y NUM: Option details. (line 413) +* -x NUM: Option details. (line 412) +* -X NUM: Option details. (line 420) +* -Y NUM: Option details. (line 427) * -z: Hypertext. (line 6) -* -Z for compressing bitmap fonts: Option details. (line 422) -* -z for recognizing hyperdvi: Option details. (line 416) -* '..'-relative filenames: Option details. (line 317) +* -Z for compressing bitmap fonts: Option details. (line 436) +* -z for recognizing hyperdvi: Option details. (line 430) +* ..-relative filenames: Option details. (line 331) * .afm Adobe metric files: Metric files. (line 26) * .dvipsrc, searched for: Configuration file searching. (line 14) @@ -3917,20 +3947,20 @@ Index * \magnification: EPSF scaling. (line 62) * \rotninety: Literal examples. (line 27) * \textCOLORNAME: Color macro files. (line 46) -* | starting output filename: Option details. (line 247) +* | starting output filename: Option details. (line 266) * a config command (conserve memory): Configuration file commands. (line 21) * A ring, Scandinavian letter: Reencoding with Afm2tfm. (line 32) -* a3 papertype: Option details. (line 337) +* a3 papertype: Option details. (line 351) * a4 paper size: Config file paper sizes. - (line 82) -* a4 papertype: Option details. (line 337) + (line 96) +* a4 papertype: Option details. (line 351) * A4size paper size: Config file paper sizes. - (line 90) -* absolute filenames, disabling: Option details. (line 317) -* absolute page number, and '-l': Option details. (line 174) -* absolute page number, and '-p': Option details. (line 277) + (line 104) +* absolute filenames, disabling: Option details. (line 331) +* absolute page number, and -l: Option details. (line 176) +* absolute page number, and -p: Option details. (line 296) * accent height adjustment, omitting: Afm2tfm options. (line 33) * accents, in wrong position: Reencoding with Afm2tfm. (line 32) @@ -3946,7 +3976,7 @@ Index * Aladdin Ghostscript: Ghostscript installation. (line 6) * Anderson, Laurie: Hypertext specials. (line 42) -* angle ('psfile' special option): psfile special. (line 36) +* angle (psfile special option): psfile special. (line 36) * arcs: Glyph files. (line 17) * ASCII character codes, used by PostScript: PostScript typesetting. (line 31) @@ -3973,7 +4003,7 @@ Index * bop-hook: Paper trays. (line 6) * bop-hook <1>: EPSF scaling. (line 74) * bop-hook <2>: PostScript hooks. (line 11) -* bop-hook, and offset pages: Option details. (line 272) +* bop-hook, and offset pages: Option details. (line 291) * boundary character: Encoding file format. (line 41) * bounding box, comment for: Bounding box. (line 6) @@ -3997,7 +4027,7 @@ Index (line 6) * CharStrings Type 1 dictionary: PostScript typesetting. (line 51) -* clip ('psfile' special option): psfile special. (line 39) +* clip (psfile special option): psfile special. (line 39) * clipping of EPSF: EPSF clipping. (line 6) * CODINGSCHEME: Reencoding with Afm2tfm. (line 51) @@ -4021,21 +4051,21 @@ Index (line 13) * comments, in encoding files: Encoding file format. (line 20) -* comments, removing included: Option details. (line 165) +* comments, removing included: Option details. (line 167) * compilation: Installation. (line 6) * compressed PostScript: Dynamic creation of graphics. (line 6) -* compressing bitmap fonts: Option details. (line 422) +* compressing bitmap fonts: Option details. (line 436) * Computer Modern in PostScript: Hypertext caveats. (line 6) * Computer Modern, encoding of: Encodings. (line 15) * condensed fonts: Afm2tfm options. (line 47) * config.proto: config.ps installation. (line 14) -* config.ps: Option details. (line 291) +* config.ps: Option details. (line 305) * config.ps installation: config.ps installation. (line 6) * config.ps paper sizes: Config file paper sizes. - (line 82) + (line 96) * config.ps, searched for: Configuration file searching. (line 10) * configuration file options: Configuration file commands. @@ -4063,8 +4093,8 @@ Index * copies, duplicated page bodies: Option details. (line 31) * copies, uncollated: Option details. (line 46) * Crayola crayon box: Color macro files. (line 17) -* crop.pro: Option details. (line 157) -* cropmarks: Option details. (line 157) +* crop.pro: Option details. (line 159) +* cropmarks: Option details. (line 159) * current font, in PostScript: PostScript typesetting. (line 35) * D config command (dpi): Configuration file commands. @@ -4076,22 +4106,22 @@ Index * debugging <1>: Option details. (line 57) * debugging options: Debug options. (line 6) * default resolutions: Configuration file commands. - (line 147) + (line 153) * default_texsizes Make variable: Configuration file commands. - (line 163) + (line 169) * Deutsch, Peter: Ghostscript installation. (line 6) * device dependency, and virtual fonts: Configuration file commands. - (line 186) -* dictionary, 'CharStrings': PostScript typesetting. + (line 192) +* dictionary, CharStrings: PostScript typesetting. (line 51) * dictionary, PostScript language: PostScript typesetting. (line 35) -* dictionary, 'SDict': Literal headers. (line 6) -* dictionary, 'userdict': Header files. (line 21) -* distillation, and '-z': Option details. (line 416) +* dictionary, SDict: Literal headers. (line 6) +* dictionary, userdict: Header files. (line 21) +* distillation, and -z: Option details. (line 430) * distiller, for PDF files: Hypertext. (line 11) -* document title, specifying: Option details. (line 357) +* document title, specifying: Option details. (line 371) * dot accent: Reencoding with Afm2tfm. (line 32) * double-sided printing: Option details. (line 37) @@ -4116,7 +4146,7 @@ Index * DVIPSHEADERS: Environment variables. (line 31) * DVIPSHEADERS, overrides H: Configuration file commands. - (line 60) + (line 62) * DVIPSMAKEPK: Environment variables. (line 35) * DVIPSRC: Environment variables. @@ -4124,7 +4154,7 @@ Index * DVIPSSIZES: Environment variables. (line 46) * DVIPSSIZES, overrides R: Configuration file commands. - (line 160) + (line 166) * dynamic creation of graphics: Dynamic creation of graphics. (line 6) * e config command (maxdrift): Configuration file commands. @@ -4184,16 +4214,16 @@ Index (line 6) * failure, to print at all: No output. (line 6) * fallback resolutions: Configuration file commands. - (line 147) + (line 153) * figures and fonts: Fonts in figures. (line 6) * figures, natural size: EPSF macros. (line 38) * figures, scaling: EPSF scaling. (line 6) * filter, running as a: Option details. (line 103) -* first page printed: Option details. (line 277) +* first page printed: Option details. (line 296) * font concepts: Font concepts. (line 6) * font encodings, bitmap: Bitmap font encodings. (line 6) -* font generation, avoiding: Option details. (line 199) +* font generation, avoiding: Option details. (line 218) * fontinst: Invoking afm2tfm. (line 13) * fonts, as header files: Including headers from TeX. (line 13) @@ -4223,11 +4253,11 @@ Index (line 6) * ghostview: Ghostscript installation. (line 12) -* Ghostview, and no 'N': Ghostscript installation. +* Ghostview, and no N: Ghostscript installation. (line 12) * glyph files: Glyph files. (line 6) * GLYPHFONTS, overrides P: Configuration file commands. - (line 135) + (line 141) * gnuplot: Dynamic creation of graphics. (line 25) * graphics inclusion fails: Including graphics fails. @@ -4235,16 +4265,16 @@ Index * gs installation: Ghostscript installation. (line 6) * gsave/grestore, and literal PS: Literal examples. (line 27) -* gsftopk: Option details. (line 390) +* gsftopk: Option details. (line 404) * h config command (download additional header): Configuration file commands. (line 57) * H config command (PostScript header path): Configuration file commands. - (line 60) + (line 62) * Hafner, Jim: Color. (line 6) * header file, downloading: Option details. (line 127) * header files, defined: Header files. (line 6) * header path, defining: Configuration file commands. - (line 60) + (line 62) * header=FILE \special: Including headers from TeX. (line 6) * headers and memory usage: Headers and memory usage. @@ -4255,24 +4285,23 @@ Index (line 6) * hints: PostScript typesetting. (line 55) -* hoffset ('psfile' special option): psfile special. (line 18) +* hoffset (psfile special option): psfile special. (line 18) * HP4Si printer and paper trays: Paper trays. (line 6) * href: Hypertext specials. (line 32) -* hscale ('psfile' special option): psfile special. (line 30) -* hsize ('psfile' special option): psfile special. (line 24) +* hscale (psfile special option): psfile special. (line 30) +* hsize (psfile special option): psfile special. (line 24) * html specials: Hypertext. (line 6) -* html specials, and '-z': Option details. (line 416) -* 'http://xxx.lanl.gov/hypertex': Hypertext. (line 22) +* html specials, and -z: Option details. (line 430) * Hungarian umlaut: Reencoding with Afm2tfm. (line 32) -* hyperdvi extensions, enabling: Option details. (line 416) +* hyperdvi extensions, enabling: Option details. (line 430) * hypertext and bitmap fonts: Hypertext caveats. (line 6) * hypertext caveats: Hypertext caveats. (line 6) * hypertext caveats <1>: Hypertext caveats. (line 6) * hypertext specials: Hypertext specials. (line 6) * hypertext support: Hypertext. (line 6) * i config command (pages/section): Configuration file commands. - (line 64) + (line 66) * Illustrator, workaround for: Including graphics fails. (line 10) * img: Hypertext specials. (line 52) @@ -4282,7 +4311,7 @@ Index (line 6) * including headers in TeX: Including headers from TeX. (line 6) -* installation of 'config.ps': config.ps installation. +* installation of config.ps: config.ps installation. (line 6) * installation of PostScript fonts: PostScript font installation. (line 6) @@ -4294,34 +4323,41 @@ Index * inverted output: Small or inverted. (line 6) * invoking Dvips: Invoking Dvips. (line 6) * j config command (partial font downloading): Configuration file commands. - (line 68) + (line 70) * Japanese font metric file: Virtual fonts. (line 37) * Jeffrey, Alan: Invoking afm2tfm. (line 13) * JFM file, and virtual font fallback: Virtual fonts. (line 37) * K config command (comment removal): Configuration file commands. - (line 72) + (line 74) * kerning, defined: Metric files. (line 15) * KPATHSEA_DEBUG: Environment variables. (line 18) * L config command (last paper size wins): Configuration file commands. - (line 76) + (line 78) * landscape orientation, defined: Paper size and landscape. (line 11) -* landscape papertype: Option details. (line 337) -* landscape, as '\special': 'papersize' special. (line 16) -* last page printed: Option details. (line 174) -* last-resort font scaling, with 'DVIPSSIZES': Environment variables. +* landscape papertype: Option details. (line 351) +* landscape, as \special: papersize special. (line 16) +* landscaperotate: Option details. (line 196) +* landscaperotate command line option: Config file paper sizes. + (line 58) +* landscaperotate config command: Configuration file commands. + (line 82) +* landscaperotate configuration file command: Config file paper sizes. + (line 58) +* last page printed: Option details. (line 176) +* last-resort font scaling, with DVIPSSIZES: Environment variables. (line 47) -* last-resort scaling, with 'R': Configuration file commands. - (line 147) -* ledger papertype: Option details. (line 337) -* legal papertype: Option details. (line 337) +* last-resort scaling, with R: Configuration file commands. + (line 153) +* ledger papertype: Option details. (line 351) +* legal papertype: Option details. (line 351) * letter paper size: Config file paper sizes. - (line 82) -* letter papertype: Option details. (line 337) + (line 96) +* letter papertype: Option details. (line 351) * letterhead tray: Paper trays. (line 10) * letterSize paper size: Config file paper sizes. - (line 90) + (line 104) * ligature operations: Encoding file format. (line 54) * ligature, defined: Metric files. (line 15) @@ -4332,28 +4368,28 @@ Index * literal headers: Literal headers. (line 6) * literal PostScript, examples: Literal examples. (line 6) * literal PostScript, using: Literal PS. (line 6) -* llx ('psfile' special option): psfile special. (line 42) -* lly ('psfile' special option): psfile special. (line 42) +* llx (psfile special option): psfile special. (line 42) +* lly (psfile special option): psfile special. (line 42) * long documents not printing: Long documents fail. (line 6) * low characters, shifting: Option details. (line 122) -* lpr spooler, MS-DOS emulation: Option details. (line 247) +* lpr spooler, MS-DOS emulation: Option details. (line 266) * m config command (available memory): Configuration file commands. - (line 80) + (line 86) * M config command (mf mode): Configuration file commands. - (line 107) + (line 113) * macros for color: Color macro files. (line 6) * macros for epsf inclusion: \includegraphics. (line 6) * macros for epsf inclusion <1>: EPSF macros. (line 6) * magnification, DVI: EPSF scaling. (line 62) -* magnification, overriding DVI: Option details. (line 398) -* magnification, vertical: Option details. (line 409) +* magnification, overriding DVI: Option details. (line 412) +* magnification, vertical: Option details. (line 423) * mailcap and hypertext: Hypertext specials. (line 53) -* manual feed: Option details. (line 187) +* manual feed: Option details. (line 206) * maxdrift: Option details. (line 76) -* maximum pages printed: Option details. (line 209) -* media: Option details. (line 337) +* maximum pages printed: Option details. (line 228) +* media: Option details. (line 351) * memory available: Configuration file commands. - (line 80) + (line 86) * memory of printer exhausted: Printer errors. (line 14) * memory usage, and headers: Headers and memory usage. (line 6) @@ -4362,43 +4398,43 @@ Index (line 104) * Metafont ligature operations: Encoding file format. (line 54) -* Metafont mode, specifying: Option details. (line 190) +* Metafont mode, specifying: Option details. (line 209) * Metafont source files: Glyph files. (line 30) * metric files: Metric files. (line 6) * Minion typeface family: psfonts.map. (line 60) -* missfont.log: Option details. (line 199) -* MISSFONT_LOG: Option details. (line 202) +* missfont.log: Option details. (line 218) +* MISSFONT_LOG: Option details. (line 221) * Mitsubishi Shinko CHC-S446i printer: No output. (line 14) * mkdvipspapers: Config file paper sizes. - (line 79) -* mktexpk, avoiding: Option details. (line 199) + (line 93) +* mktexpk, avoiding: Option details. (line 218) * mktexpk, changing name: Environment variables. (line 36) -* mode name, specifying: Option details. (line 190) -* mtpk: Option details. (line 390) +* mode name, specifying: Option details. (line 209) +* mtpk: Option details. (line 404) * multiple master fonts: psfonts.map. (line 60) -* multiple output files: Option details. (line 132) +* multiple output files: Option details. (line 134) * multiple paper trays: Paper trays. (line 6) * Murphy, Tim: Hypertext specials. (line 20) * N config command (disable EPS): Configuration file commands. - (line 110) + (line 116) * name: Hypertext specials. (line 41) * narrow fonts: psfonts.map. (line 19) * no output at all: No output. (line 6) * non-printing characters, shifting: Option details. (line 122) * non-resident fonts: psfonts.map. (line 6) -* nopaper, paper format for '-t': Config file paper sizes. - (line 74) +* nopaper, paper format for -t: Config file paper sizes. + (line 88) * o config command (output destination): Configuration file commands. - (line 115) + (line 121) * O config command (page offsets): Configuration file commands. - (line 123) + (line 129) * oblique fonts: Special font effects. (line 6) * octal character codes: Afm2tfm options. (line 51) * odd pages only: Option details. (line 27) -* offset pages: Option details. (line 259) -* Omega extensions: Option details. (line 220) +* offset pages: Option details. (line 278) +* Omega extensions: Option details. (line 239) * option, details of: Option details. (line 6) * options, debugging: Debug options. (line 6) * options, Dvips: Invoking Dvips. (line 6) @@ -4411,21 +4447,22 @@ Index * output file, sectioning of: Headers and memory usage. (line 6) * output file, setting: Configuration file commands. - (line 115) -* output files, multiple: Option details. (line 132) -* output title, specifying: Option details. (line 357) + (line 121) +* output files, multiple: Option details. (line 134) +* output title, specifying: Option details. (line 371) * output, inverted: Small or inverted. (line 6) * output, none: No output. (line 6) -* output, redirecting: Option details. (line 242) +* output, redirecting: Option details. (line 261) * output, too small: Small or inverted. (line 6) * p config command (font aliases): Configuration file commands. - (line 126) + (line 132) * P config command (PK path): Configuration file commands. - (line 135) -* page range: Option details. (line 286) -* page, first printed: Option details. (line 277) -* page, last printed: Option details. (line 174) -* pages, maximum printed: Option details. (line 209) + (line 141) +* page numbers, multiple repetitions of: Option details. (line 176) +* page range: Option details. (line 300) +* page, first printed: Option details. (line 296) +* page, last printed: Option details. (line 176) +* pages, maximum printed: Option details. (line 228) * PaintType: Special font effects. (line 50) * Pantone colors: Color macro files. (line 17) @@ -4436,16 +4473,16 @@ Index * paper size, general: Paper size and landscape. (line 6) * paper trays: Paper trays. (line 6) -* paper type: Option details. (line 337) -* papersize special: 'papersize' special. (line 6) -* papersize special, and no '-t': Option details. (line 337) -* 'papersize' special, first vs. last: Option details. (line 183) +* paper type: Option details. (line 351) +* papersize special: papersize special. (line 6) +* papersize special, and no -t: Option details. (line 351) +* papersize special, first vs. last: Option details. (line 192) * partial font downloading: psfonts.map. (line 55) * PDF files, font quality: Hypertext caveats. (line 6) * PDF files, making: Ghostscript installation. (line 6) * PDF files, making <1>: Hypertext. (line 11) -* PDF files, option for: Option details. (line 416) +* PDF files, option for: Option details. (line 430) * pdfmark: Hypertext. (line 6) * pfa files: Glyph files. (line 25) * pfb files: Glyph files. (line 25) @@ -4453,16 +4490,16 @@ Index * pfm files: Metric files. (line 48) * Phaser printer, used for color calibration: Color device configuration. (line 18) -* physical page number, and '-l': Option details. (line 174) -* physical page number, and '-p': Option details. (line 277) -* physical page number, and 'bop-hook': PostScript hooks. (line 26) +* physical page number, and -l: Option details. (line 176) +* physical page number, and -p: Option details. (line 296) +* physical page number, and bop-hook: PostScript hooks. (line 26) * pipes, not readable: Option details. (line 103) * pk files: Glyph files. (line 35) * PKFONTS, overrides P: Configuration file commands. - (line 135) -* plotfile, 'ps' subspecial: ps special. (line 29) + (line 141) +* plotfile, ps subspecial: ps special. (line 29) * pltotf: Metric files. (line 39) -* popen for output: Option details. (line 247) +* popen for output: Option details. (line 266) * portrait orientation, defined: Paper size and landscape. (line 11) * positioning accuracy: Option details. (line 76) @@ -4472,9 +4509,9 @@ Index * PostScript encoding: Encodings. (line 27) * PostScript encoding, changing: Changing PostScript encodings. (line 6) -* PostScript font alias file: Option details. (line 370) +* PostScript font alias file: Option details. (line 384) * PostScript font alias file <1>: Configuration file commands. - (line 126) + (line 132) * PostScript fonts: PostScript fonts. (line 6) * PostScript fonts, installing: PostScript font installation. (line 6) @@ -4500,12 +4537,12 @@ Index (line 14) * printer errors: Printer errors. (line 6) * printer memory: Configuration file commands. - (line 80) + (line 86) * printer memory exhausted: Printer errors. (line 14) -* printer offset: Option details. (line 259) +* printer offset: Option details. (line 278) * PRINTER, and config file searching: Configuration file searching. (line 36) -* PRINTER, avoided with '-f': Option details. (line 103) +* PRINTER, avoided with -f: Option details. (line 103) * printer, driving directly: Option details. (line 115) * problems: Diagnosing problems. (line 6) * property list files: Metric files. (line 39) @@ -4520,19 +4557,19 @@ Index * psfonts.map <2>: psfonts.map. (line 6) * psheaderdir: Header files. (line 12) * psi character missing: Hypertext caveats. (line 53) -* pstopk: Option details. (line 390) -* pTeX extensions: Option details. (line 220) -* pTeX extensions <1>: Option details. (line 226) +* pstopk: Option details. (line 404) +* pTeX extensions: Option details. (line 239) +* pTeX extensions <1>: Option details. (line 245) * ptex JFM: Virtual fonts. (line 37) * q config command (quiet): Configuration file commands. - (line 141) + (line 147) * Q config command (quiet): Configuration file commands. - (line 141) -* quiet operation: Option details. (line 310) -* R config command (fallback resolution): Configuration file commands. (line 147) +* quiet operation: Option details. (line 324) +* R config command (fallback resolution): Configuration file commands. + (line 153) * r config command (page reversal): Configuration file commands. - (line 144) + (line 150) * raw tfm files: Afm2tfm options. (line 17) * reencode/*.enc: Encodings. (line 35) * reencoding: Reencoding with Afm2tfm. @@ -4543,25 +4580,25 @@ Index * remapping: Reencoding with Afm2tfm. (line 6) * resident fonts, different in different printers: Option details. - (line 370) + (line 384) * resident fonts, different in different printers <1>: Configuration file commands. - (line 126) -* resolution: Option details. (line 406) -* resolution <1>: Option details. (line 413) + (line 132) +* resolution: Option details. (line 420) +* resolution <1>: Option details. (line 427) * resolution, setting: Option details. (line 63) -* reverse pagination: Option details. (line 314) -* rhi ('psfile' special option): psfile special. (line 46) +* reverse pagination: Option details. (line 328) +* rhi (psfile special option): psfile special. (line 46) * Rokicki, Tomas: Why Dvips. (line 52) * rotate.tex: ps special. (line 33) -* rwi ('psfile' special option): psfile special. (line 46) +* rwi (psfile special option): psfile special. (line 46) * s config command (global save/restore): Configuration file commands. - (line 169) + (line 175) * S config command (pict path): Configuration file commands. - (line 172) + (line 178) * save/restore, and inverted output: Small or inverted. (line 6) * save/restore, and literal PS: Literal examples. (line 27) * save/restore, and specials: ps special. (line 6) -* save/restore, generating global: Option details. (line 325) +* save/restore, generating global: Option details. (line 339) * scaleunit: psfile special. (line 66) * scaling of figures: EPSF scaling. (line 6) * scaling small caps: Afm2tfm options. (line 43) @@ -4575,15 +4612,15 @@ Index (line 6) * sections of output file, and memory: Headers and memory usage. (line 6) -* sections output, in separate files: Option details. (line 132) -* security: Option details. (line 317) -* shell command execution, disabling: Option details. (line 317) +* sections output, in separate files: Option details. (line 134) +* security: Option details. (line 331) +* shell command execution, disabling: Option details. (line 331) * shell escape, in config file: Configuration file commands. (line 42) * Shinko CHC-S446i printer: No output. (line 14) * show PostScript operator: PostScript typesetting. (line 23) -* silent operation: Option details. (line 310) +* silent operation: Option details. (line 324) * simplex mode on duplex printers: Including headers from the command line. (line 13) * slanted fonts: Special font effects. @@ -4598,21 +4635,21 @@ Index * specials, hypertext: Hypertext specials. (line 6) * splines: Glyph files. (line 17) * spooler, lacking: Option details. (line 115) -* spooling to lpr on MS-DOS: Option details. (line 247) +* spooling to lpr on MS-DOS: Option details. (line 266) * standard I/O: Option details. (line 103) * standard input, reading options from: Option details. (line 11) -* standard output, output to: Option details. (line 242) +* standard output, output to: Option details. (line 261) * standard PostScript, required by Ghostview: Ghostscript installation. (line 12) * start-hook: PostScript hooks. (line 11) -* structured comments: Option details. (line 212) +* structured comments: Option details. (line 231) * system in config file: Configuration file commands. (line 42) * T config command (TFM path): Configuration file commands. - (line 177) + (line 183) * Tektronix Phaser printer, used for color calibration: Color device configuration. (line 18) -* testpage.tex: Option details. (line 266) +* testpage.tex: Option details. (line 285) * TeX encoding, changing: Changing TeX encodings. (line 6) * TeX, including headers in: Including headers from TeX. @@ -4620,13 +4657,13 @@ Index * TEXCONFIG: Environment variables. (line 55) * TEXFONTS, overrides P: Configuration file commands. - (line 135) + (line 141) * TEXFONTS, overrides T: Configuration file commands. - (line 177) + (line 183) * TEXINPUTS, overrides S: Configuration file commands. - (line 172) + (line 178) * texmext.enc: Encodings. (line 35) -* TEXMFOUTPUT: Option details. (line 202) +* TEXMFOUTPUT: Option details. (line 221) * texmital.enc: Encodings. (line 35) * texmsym.enc: Encodings. (line 35) * texmsym.enc <1>: Changing TeX encodings. @@ -4634,164 +4671,171 @@ Index * TEXPICTS: Environment variables. (line 62) * TEXPICTS, overrides S: Configuration file commands. - (line 172) + (line 178) * TEXPKS, overrides P: Configuration file commands. - (line 135) + (line 141) * TEXSIZES, overrides R: Configuration file commands. - (line 160) + (line 166) * text in figures, chopped off: EPSF clipping. (line 6) * tfm files: Metric files. (line 31) * TFMFONTS, overrides T: Configuration file commands. - (line 177) + (line 183) * tftopl: Metric files. (line 39) * Theisen, Tim: Ghostscript installation. (line 12) * tight bounding box, finding: Option details. (line 87) -* title, specifying: Option details. (line 357) +* title, specifying: Option details. (line 371) * too-small output: Small or inverted. (line 6) * trademark character, accessing: Changing PostScript encodings. (line 18) * trailing spaces, dropped: Hypertext caveats. (line 53) -* TranScript: Option details. (line 212) +* TranScript: Option details. (line 231) * transforming downloaded fonts: psfonts.map. (line 19) * trouble: Diagnosing problems. (line 6) * Type 1 fonts: Glyph files. (line 25) * typesetting in PostScript: PostScript typesetting. (line 6) * U config command (Xerox 4045): Configuration file commands. - (line 182) + (line 188) * uncollated copies: Option details. (line 46) * uncompressing PostScript: Dynamic creation of graphics. (line 6) * uniform resource locator: Hypertext specials. (line 20) -* unknown, paper format for '-t': 'papersize' special. (line 29) -* unknown, paper format for '-t' <1>: Config file paper sizes. - (line 69) +* unknown, paper format for -t: papersize special. (line 29) +* unknown, paper format for -t <1>: Config file paper sizes. + (line 83) * uptex JFM: Virtual fonts. (line 37) * URL, definition: Hypertext specials. (line 27) * URL, extended for TeX: Hypertext specials. (line 20) -* urx ('psfile' special option): psfile special. (line 42) -* ury ('psfile' special option): psfile special. (line 42) +* urx (psfile special option): psfile special. (line 42) +* ury (psfile special option): psfile special. (line 42) * usage, basic: Basic usage. (line 6) * user-definable colors: User-definable colors. (line 6) * userdict, and dictionary files: Header files. (line 21) * userdict, used for header files: Option details. (line 127) * V config command (vf path): Configuration file commands. - (line 186) + (line 192) * verbose EPSF processing: EPSF macros. (line 46) * vf files: Virtual fonts. (line 16) * virtual font expansion: Virtual fonts. (line 33) * virtual font path: Configuration file commands. - (line 186) + (line 192) * virtual fonts: Virtual fonts. (line 6) * virtual fonts, creating: Invoking afm2tfm. (line 13) * VM exhausted: Printer errors. (line 14) * VMusage: Headers and memory usage. (line 12) -* voffset ('psfile' special option): psfile special. (line 21) +* voffset (psfile special option): psfile special. (line 21) * vpl files: Virtual fonts. (line 16) * vptovf: Making a font available. (line 52) -* vscale ('psfile' special option): psfile special. (line 33) -* vsize ('psfile' special option): psfile special. (line 27) +* vscale (psfile special option): psfile special. (line 33) +* vsize (psfile special option): psfile special. (line 27) * W config command (emit warning): Configuration file commands. - (line 191) + (line 197) * warning messages, defining: Configuration file commands. - (line 191) -* warnings, suppressing: Option details. (line 310) + (line 197) +* warnings, suppressing: Option details. (line 324) * whole font downloading: psfonts.map. (line 60) * wide fonts: psfonts.map. (line 19) * X config command (horizontal resolution): Configuration file commands. - (line 198) -* Xerox 4045: Option details. (line 378) + (line 204) +* Xerox 4045: Option details. (line 392) * Y config command (vertical resolution): Configuration file commands. - (line 201) + (line 207) * Z config command (compress fonts): Configuration file commands. - (line 204) + (line 210) * z config command (secure mode): Configuration file commands. - (line 207) + (line 213) +* zero dimensions and setting paper size: Config file paper sizes. + (line 74) Tag Table: -Node: Top521 -Node: Why Dvips1271 -Node: Installation3854 -Node: config.ps installation4789 -Node: PostScript font installation7396 -Node: Ghostscript installation8316 -Node: Diagnosing problems9255 -Node: Debug options10346 -Node: No output11350 -Node: Small or inverted12816 -Node: Printer errors13534 -Node: Long documents fail14866 -Node: Including graphics fails15207 -Node: Invoking Dvips16446 -Node: Basic usage17068 -Node: Command-line options18066 -Node: Option summary18514 -Node: Option details20789 -Node: Environment variables41006 -Node: Config files43867 -Node: Configuration file searching44537 -Node: Configuration file commands47734 -Node: Paper size and landscape55708 -Node: 'papersize' special57335 -Node: Config file paper sizes59045 -Node: Paper trays63203 -Node: Interaction with PostScript64537 -Node: PostScript figures65190 -Node: Bounding box65916 -Node: \includegraphics69288 -Node: EPSF macros71580 -Node: EPSF scaling73579 -Node: EPSF clipping76149 -Node: psfile special76791 -Node: Dynamic creation of graphics79183 -Node: Fonts in figures80501 -Node: Header files82151 -Node: Including headers from TeX83361 -Node: Including headers from the command line85399 -Node: Headers and memory usage86498 -Node: Literal PS87709 -Node: " special88291 -Node: ps special89032 -Node: Literal headers90530 -Node: PostScript hooks91239 -Node: Literal examples93335 -Node: Hypertext94789 -Node: Hypertext caveats95963 -Node: Hypertext specials100319 -Node: PostScript fonts102953 -Node: Font concepts104070 -Node: Metric files105300 -Node: Glyph files108080 -Node: Virtual fonts110439 -Node: Encodings112594 -Node: Bitmap font encodings114996 -Node: PostScript typesetting117526 -Node: Making a font available120623 -Node: Invoking afm2tfm125657 -Node: Changing font encodings126677 -Node: Changing TeX encodings127468 -Node: Changing PostScript encodings128570 -Node: Changing both encodings129914 -Node: Reencoding with Afm2tfm130588 -Node: Encoding file format133691 -Node: Special font effects137895 -Node: Afm2tfm options140155 -Node: psfonts.map143680 -Node: Color148410 -Node: Color macro files149454 -Node: User-definable colors152664 -Node: Color subtleties153940 -Node: Ted Turner155592 -Node: Color device configuration156817 -Node: Color support details159261 -Node: Color specifications159639 -Node: Color specials161043 -Node: Index163172 +Node: Top520 +Node: Why Dvips1269 +Node: Installation3852 +Node: config.ps installation4787 +Node: PostScript font installation7394 +Node: Ghostscript installation8314 +Node: Diagnosing problems9253 +Node: Debug options10344 +Node: No output11348 +Node: Small or inverted12814 +Node: Printer errors13532 +Node: Long documents fail14864 +Node: Including graphics fails15205 +Node: Invoking Dvips16444 +Node: Basic usage17035 +Node: Command-line options18033 +Node: Option summary18481 +Node: Option details20756 +Node: Environment variables41579 +Node: Config files44440 +Node: Configuration file searching45110 +Node: Configuration file commands48307 +Node: Paper size and landscape56512 +Node: papersize special58137 +Node: Config file paper sizes59844 +Node: Paper trays64867 +Node: Interaction with PostScript66201 +Node: PostScript figures66854 +Node: Bounding box67580 +Node: \includegraphics70952 +Node: EPSF macros73244 +Node: EPSF scaling75212 +Node: EPSF clipping77782 +Node: psfile special78424 +Node: Dynamic creation of graphics80816 +Node: Fonts in figures82134 +Node: Header files83784 +Node: Including headers from TeX84990 +Node: Including headers from the command line87028 +Node: Headers and memory usage88127 +Node: Literal PS89338 +Node: " special89920 +Node: ps special90661 +Node: Literal headers92159 +Node: PostScript hooks92868 +Node: Literal examples94964 +Node: Hypertext96418 +Node: Hypertext caveats97592 +Node: Hypertext specials101720 +Node: PostScript fonts104354 +Node: Font concepts105471 +Node: Metric files106701 +Node: Glyph files109481 +Node: Virtual fonts111840 +Node: Encodings113995 +Node: Bitmap font encodings116397 +Node: PostScript typesetting118927 +Node: Making a font available122024 +Node: Invoking afm2tfm127058 +Node: Changing font encodings128078 +Node: Changing TeX encodings128869 +Node: Changing PostScript encodings129971 +Node: Changing both encodings131315 +Node: Reencoding with Afm2tfm131989 +Node: Encoding file format135092 +Node: Special font effects139296 +Node: Afm2tfm options141556 +Node: psfonts.map145081 +Node: Color149811 +Node: Color macro files150855 +Node: User-definable colors154065 +Node: Color subtleties155341 +Node: Ted Turner156993 +Node: Color device configuration158218 +Node: Color support details160662 +Node: Color specifications161040 +Node: Color specials162444 +Node: Index164573 End Tag Table + + +Local Variables: +coding: utf-8 +End: diff --git a/Master/texmf-dist/doc/info/kpathsea.info b/Master/texmf-dist/doc/info/kpathsea.info index 66b0a4e2f90..a9c122cad0c 100644 --- a/Master/texmf-dist/doc/info/kpathsea.info +++ b/Master/texmf-dist/doc/info/kpathsea.info @@ -3,7 +3,7 @@ kpathsea.texi. 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 @@ -37,7 +37,7 @@ Kpathsea library **************** This manual documents the Kpathsea library for path searching. It -corresponds to version 6.3.3, released in February 2021. +corresponds to version 6.3.4, released in January 2022. * Menu: @@ -61,8 +61,8 @@ File: kpathsea.info, Node: Introduction, Next: unixtex.ftp, Prev: Top, Up: T 1 Introduction ************** -This manual corresponds to version 6.3.3 of the Kpathsea library, -released in February 2021. +This manual corresponds to version 6.3.4 of the Kpathsea library, +released in January 2022. 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 @@ -293,7 +293,7 @@ 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 <https://gnu.org/prep/standards>. The TDS document is available -from <http://mirror.ctan.org/tds> (*note unixtex.ftp::). +from <https://ctan.org/pkg/tds> (*note unixtex.ftp::). In short, here is a skeleton of the default directory structure, extracted from the TDS document: @@ -526,10 +526,10 @@ character '0' (zero, not oh). helpful to look at the distributed 'texmf.cnf', which uses or at least mentions most features. The format of 'texmf.cnf' files follows: - * Comments start with '%', 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 '%' in the "middle" of a value does - not start a comment. Examples: + * Comments start with '%' or '#', 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: % this is a comment var = a%b % but the value of var will be "a%b" @@ -585,13 +585,6 @@ Here is a configuration file fragment illustrating most of these points: TEXINPUTS.latex2e = $latex2e_inputs TEXINPUTS.latex = $latex2e_inputs - This format has some similarity to Bourne shell scripts--change the -comment character to '#', disallow spaces around the '=', and get rid of -the '.NAME' 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 'sh' -process couldn't affect its parent's environment. - The combination of spaces being ignored before the '.' of a program name qualifer and the optional '=' for the assignment has an unexpected consequence: if the value begins with a literal '.' and the '=' is @@ -1996,7 +1989,7 @@ found are read; earlier definitions override later ones. equivalent, so that it no longer matters what the name of the installed file is; TeX documents will find their favorite name. - The format of fontmap files is straightforward: + The format of fontmap files: * Comments start with the last '%' on a line and continue to the end of the line. (This provides for names that include a %, @@ -3213,7 +3206,7 @@ Index * : may not be :: Searching overview. (line 13) * :: expansion: Default expansion. (line 6) * ; translated to ':' in 'texmf.cnf': Config files. (line 66) -* = omitted in 'texmf.cnf' and misparsing: Config files. (line 93) +* = omitted in 'texmf.cnf' and misparsing: Config files. (line 86) * \, line continuation in 'texmf.cnf': Config files. (line 37) * \openin: Searching overview. (line 31) * \special, suppressing warnings about: Suppressing warnings. @@ -3290,7 +3283,7 @@ Index (line 46) * cmr10, as fallback font: Fallback font. (line 15) * cmr10.vf: Searching overview. (line 31) -* cnf.c: Config files. (line 112) +* cnf.c: Config files. (line 105) * cnf.h: Programming with config files. (line 27) * comments, in fontmap files: Fontmap. (line 27) @@ -3319,7 +3312,6 @@ Index * config.status: Bug checklist. (line 27) * configuration bugs: Bug checklist. (line 27) * configuration file, source for path: Path sources. (line 20) -* configuration files as shell scripts.: Config files. (line 86) * configuration of 'mktex' scripts: mktex configuration. (line 6) * 'configure' options for 'mktex' scripts: mktex configuration. (line 12) @@ -3735,7 +3727,6 @@ Index * setgid scripts: Security. (line 40) * SFDFONTS: Supported file formats. (line 177) -* shell scripts as configuration files: Config files. (line 86) * shell variables: Variable expansion. (line 17) * shell_escape, example for code: Programming with config files. (line 10) @@ -3957,61 +3948,61 @@ Index Tag Table: Node: Top1480 -Node: Introduction2263 -Node: History4333 -Node: unixtex.ftp8929 -Node: Security10399 -Node: TeX directory structure12903 -Node: Path searching16944 -Node: Searching overview17902 -Node: Path sources21721 -Node: Config files22947 -Node: Path expansion28210 -Node: Default expansion29163 -Node: Variable expansion31233 -Node: Tilde expansion32634 -Node: Brace expansion33614 -Node: KPSE_DOT expansion34553 -Node: Subdirectory expansion35066 -Node: Casefolding search37414 -Node: Casefolding rationale38183 -Node: Casefolding examples39529 -Node: Filename database44575 -Node: ls-R45557 -Node: Filename aliases49233 -Node: Database format50411 -Node: Invoking kpsewhich51424 -Node: Path searching options52379 -Node: Specially-recognized files61977 -Node: Auxiliary tasks63332 -Node: Standard options67057 -Node: TeX support67413 -Node: Supported file formats68767 -Node: File lookup76435 -Node: Glyph lookup78184 -Node: Basic glyph lookup79308 -Node: Fontmap80188 -Node: Fallback font82717 -Node: Suppressing warnings83629 -Node: mktex scripts84756 -Node: mktex configuration85971 -Node: mktex script names91774 -Node: mktex script arguments93160 -Node: Programming94039 -Node: Programming overview94612 -Node: Calling sequence97473 -Node: Program-specific files104002 -Node: Programming with config files105025 -Node: Reporting bugs106612 -Node: Bug checklist107290 -Node: Mailing lists110759 -Node: Debugging111436 -Node: Logging116513 -Node: Common problems118380 -Node: Unable to find files118857 -Node: Slow path searching121267 -Node: Unable to generate fonts122642 -Node: TeX or Metafont failing125114 -Node: Index126316 +Node: Introduction2262 +Node: History4331 +Node: unixtex.ftp8927 +Node: Security10397 +Node: TeX directory structure12901 +Node: Path searching16940 +Node: Searching overview17898 +Node: Path sources21717 +Node: Config files22943 +Node: Path expansion27815 +Node: Default expansion28768 +Node: Variable expansion30838 +Node: Tilde expansion32239 +Node: Brace expansion33219 +Node: KPSE_DOT expansion34158 +Node: Subdirectory expansion34671 +Node: Casefolding search37019 +Node: Casefolding rationale37788 +Node: Casefolding examples39134 +Node: Filename database44180 +Node: ls-R45162 +Node: Filename aliases48838 +Node: Database format50016 +Node: Invoking kpsewhich51029 +Node: Path searching options51984 +Node: Specially-recognized files61582 +Node: Auxiliary tasks62937 +Node: Standard options66662 +Node: TeX support67018 +Node: Supported file formats68372 +Node: File lookup76040 +Node: Glyph lookup77789 +Node: Basic glyph lookup78913 +Node: Fontmap79793 +Node: Fallback font82303 +Node: Suppressing warnings83215 +Node: mktex scripts84342 +Node: mktex configuration85557 +Node: mktex script names91360 +Node: mktex script arguments92746 +Node: Programming93625 +Node: Programming overview94198 +Node: Calling sequence97059 +Node: Program-specific files103588 +Node: Programming with config files104611 +Node: Reporting bugs106198 +Node: Bug checklist106876 +Node: Mailing lists110345 +Node: Debugging111022 +Node: Logging116099 +Node: Common problems117966 +Node: Unable to find files118443 +Node: Slow path searching120853 +Node: Unable to generate fonts122228 +Node: TeX or Metafont failing124700 +Node: Index125902 End Tag Table diff --git a/Master/texmf-dist/doc/info/tlbuild.info b/Master/texmf-dist/doc/info/tlbuild.info index 2a386027bc7..2352335e03f 100644 --- a/Master/texmf-dist/doc/info/tlbuild.info +++ b/Master/texmf-dist/doc/info/tlbuild.info @@ -1,9 +1,9 @@ -This is tlbuild.info, produced by makeinfo version 6.7 from +This is tlbuild.info, produced by makeinfo version 6.8 from tlbuild.texi. This file documents the TeX Live build system and more. -Copyright (C) 2016-2021 Karl Berry. +Copyright (C) 2016-2022 Karl Berry. Copyright (C) 2013-2015 Karl Berry & Peter Breitenlohner. Permission is granted to make and distribute verbatim copies of this @@ -33,7 +33,7 @@ END-INFO-DIR-ENTRY File: tlbuild.info, Node: Top, Next: Introduction, Up: (dir) -Building TeX Live (2021) +Building TeX Live (2022) ************************ For an overview of this manual, *note Introduction::. @@ -59,7 +59,7 @@ File: tlbuild.info, Node: Introduction, Next: Overview of build system, Prev: 1 Introduction ************** -This manual (dated February 2021) corresponds to the TeX Live 2021 +This manual (dated February 2022) corresponds to the TeX Live 2022 release. This manual is aimed at system installers and programmers, and @@ -159,32 +159,41 @@ File: tlbuild.info, Node: Prerequisites, Next: Building, Prev: Overview of bu *************** Overall, building the TeX Live programs, when using all libraries from -the TL source tree, requires C and C++11 compilers and GNU 'make'. If -'make' from your 'PATH' is not GNU make, you can set the 'MAKE' -environment variable to whatever is necessary. +the TL source tree, requires C and C++11 compilers, GNU 'make', and +Python. - GNU 'make' is required only because of some third-party libraries, -notably FreeType; all the TL-maintained directories (and -Automake/Autoconf output in general) work with any reasonable 'make'. + * If 'make' from your 'PATH' is not GNU 'make', you can set the + 'MAKE' environment variable to whatever is necessary. - A C++11 compiler is similarly required because of the third-party -library ICU; the program 'dvisvgm' also requires C++11. It is possible -to build everything else with older compilers, but you have to remove -the C++11-dependent sources. *Note Build one package::. + GNU 'make' is required only because of third-party libraries, + notably FreeType. Automake/Autoconf output in general, and the + TL-maintained directories, work with any reasonable 'make'.(1) + + * A C++11 compiler is similarly required because of the third-party + libraries ICU and HarfBuzz (at least); the program 'dvisvgm' also + requires C++11. It is possible to build what remains with older + compilers, but you have to remove the C++11-dependent sources. + *Note Build one package::. + + * Python is required by ICU tests. (If you know how to disable these + tests and thus eliminate the requirement, please write.) A few programs in the tree have additional requirements: 'web2c' - requires 'perl' for some tests run by 'make check'. + requires 'perl' for some tests run by 'make check'. Incidentally, + the TeX Live installer ('install-tl') and manager ('tlmgr') are + also written in Perl, but this does not matter for compiling the + sources. 'xdvik' 'xpdfopen' - require X11 headers and libraries, typically in "development" + require X11 headers and libraries, typically in devel(opment) packages that are not installed by default. 'xetex' requires 'fontconfig' (again both headers and library), or, for - MacOSX only, the 'ApplicationServices' and 'Cocoa' frameworks. + MacOS only, the 'ApplicationServices' and 'Cocoa' frameworks. 'xindy' requires GNU 'clisp', 'libsigsegv', and 'libiconv'; additionally, @@ -213,8 +222,16 @@ expect: If you haven't modified any source files, and infrastructure tools such as 'autoconf' or 'makeinfo' are still being run, check your timestamps--notably, 'use-commit-times' must be set to 'yes' in your -Subversion configuration (*note Build system tools::). Barring buggy -commits, no infrastructure tools are needed to do a normal build. +Subversion configuration (*note Build system tools::). No +infrastructure tools are needed to do a normal build (barring bugs). + + ---------- Footnotes ---------- + + (1) There is one exception in TL: the 'tangle-sh' and related rules +use '$@' to mean the target name, a feature not present in all 'make's. +This could be alleviated by laborious editing, but since there's no way +to avoid GNU 'make' for builds of the entire tree, it does not seem +worth the trouble. File: tlbuild.info, Node: Building, Next: Installing, Prev: Prerequisites, Up: Top @@ -240,7 +257,6 @@ the source directory itself is not supported (sorry). * Menu: * Build iteration:: What 'configure' and 'make' do in TL. -* Build problems:: If the build fails. * Build in parallel:: Simultaneous 'make' processes. * Build distribution:: Making a distribution tarball. * Build one package:: Example of working on just one program. @@ -248,7 +264,7 @@ the source directory itself is not supported (sorry). * Cross compilation:: Building on host X for target Y. -File: tlbuild.info, Node: Build iteration, Next: Build problems, Up: Building +File: tlbuild.info, Node: Build iteration, Next: Build in parallel, Up: Building 4.1 Build iteration =================== @@ -273,21 +289,9 @@ the library and program modules, and finds (should find) nothing to be done. -File: tlbuild.info, Node: Build problems, Next: Build in parallel, Prev: Build iteration, Up: Building - -4.2 Build problems -================== - -If configuring or building a module fails, you should first try to find -and fix the problem. Failing that, a possible workaround is to remove -the subdirectory for that module from the build tree (so 'configure' -won't try to run there, and finally rerun the top level 'make' (or -'./Build' '--no-clean'). +File: tlbuild.info, Node: Build in parallel, Next: Build distribution, Prev: Build iteration, Up: Building - -File: tlbuild.info, Node: Build in parallel, Next: Build distribution, Prev: Build problems, Up: Building - -4.3 Build in parallel +4.2 Build in parallel ===================== The TL build system carefully formulates dependencies as well as 'make' @@ -302,7 +306,7 @@ using a configure cache file, i.e., specifying the 'configure' option File: tlbuild.info, Node: Build distribution, Next: Build one package, Prev: Build in parallel, Up: Building -4.4 Build distribution +4.3 Build distribution ====================== Running 'make dist' at the top level creates a tarball @@ -318,7 +322,7 @@ actually distribute any such tarball, and have no plans to do so. File: tlbuild.info, Node: Build one package, Next: Build one engine, Prev: Build distribution, Up: Building -4.5 Build one package +4.4 Build one package ===================== To build one package, the basic idea is to use the 'configure' option @@ -329,8 +333,8 @@ invoked to build an individual program or library, first building any required libraries. Here is an example from start to finish for working on 'dvipdfm-x'. -(Unfortunately, this does not suffice for building the TeX engines; see -the next section.) +Unfortunately, this does not suffice for building the TeX engines; see +the next section. mkdir mydir && cd mydir # new working directory @@ -348,10 +352,17 @@ the next section.) # Do the make: make >&outm || echo fail - # Test: + # Run the tests: cd texk/dvipdfm-x make check + # Run the new binary in the buil tree, finding support files + # in a separate tree for a TeX Live release YYYY + # (Bourne shell syntax): + TEXMFROOT=/usr/local/texlive/YYYY \ + TEXMFCNF=$TEXMFROOT/texmf-dist/web2c \ + ./xdvipdfmx ... + Then you can modify source files in 'mydir/texk/dvipdfm-x' and rerun 'make' in 'mydir/Work/texk/dvipdfm-x' to rebuild; that build directory is where the binary ends up and where you can run a debugger, etc. @@ -368,10 +379,13 @@ desired; check the output from 'configure --help'. It is also a good idea to run 'make check' after making any changes, to ensure that whatever tests have been written still pass. - Finally, the above retrieves the entire TL source tree (several -hundred megabytes). It is natural to ask if this is really necessary. -Strictly speaking, the answer is no, but it is vastly more convenient to -do so. If you cut down the source tree, you must also give additional +Reducing source download size +............................. + +The above retrieves the entire TL source tree (several hundred +megabytes). It is natural to ask if this is really necessary. Strictly +speaking, the answer is no, but it is vastly more convenient to do so. +If you cut down the source tree, you must also give additional 'configure' flags to individually disable using system versions of libraries, or the intricacies of the dependencies (such as 'teckit' requiring 'zlib') will have undesired side effects. For an example of @@ -379,29 +393,49 @@ this approach, see the 'build-pdftex.sh' script in the 'pdftex' development source (details at <http://pdftex.org>), which is indeed such a cut-down TL source tree. - Some libraries and programs require C++11. If you want to build with -an older compiler lacking such support, you need to (re)move those -source directories; specifying '--disable' for them does not suffice, -unfortunately. Specifically, before running 'configure': +GCC used by default +................... - rm -rf libs/icu libs/graphite2 texk/dvisvgm +By default, the 'gcc' compilers will be used if present; otherwise, +individual packages may use something different. You can explicitly +specify the compilers to be used with the environment variables 'CC', +'CXX', and 'OBJCXX'. + +Removing C+11 dependency +........................ + +Some libraries and programs require C++11; one such is XeTeX. If you +want to build with an older compiler lacking such support, you need to +(re)move those source directories; unfortunately, specifying '--disable' +for them does not suffice. It's also necessary to specify +'--disable-xetex' explicitly. Specifically, before running 'configure +--disable-xetex ...': + + rm -rf libs/icu libs/graphite2 texk/dvisvgm texk/web2c/xetexdir Also, even with '--disable-all-pkgs', dependencies are (currently) -checked. For instance, if a (non-MacOSX) system does not have +checked. One notable case: if a (non-MacOS) system does not have 'fontconfig', XeTeX cannot be built (*note Prerequisites::), and 'configure' will terminate even with '--disable-xetex'. To proceed -without such dependencies, specify '--enable-missing' also. (Patches to -improve this would be most welcome.) +without such dependencies, specify '--enable-missing' also. - By default, the 'gcc' compilers will be used if present; otherwise, -individual packages may use something different. You can explicitly -specify the compilers to be used with the environment variables 'CC', -'CXX', and 'OBJCXX'. + As of 2022, HarfBuzz also requires C++11. Therefore even more would +have to be disabled and removed, notably including 'luahbtex', the +standard engine used for LuaLaTeX. Removing that would not be +acceptable for builds intended for distribution; but perhaps for testing +the above information could still be useful. + + In general, the TL 'configure' will run in all directories. +Therefore a general workaround for build problems is to remove failing +directories from the tree, and also specify the relevant '--disable-...' +option(s). + + Patches to improve all this would be most welcome. File: tlbuild.info, Node: Build one engine, Next: Cross compilation, Prev: Build one package, Up: Building -4.6 Build one engine +4.5 Build one engine ==================== Unfortunately, there is one common case where the steps in the preceding @@ -415,16 +449,20 @@ original TeX: cd Work # top build directory ../configure --without-x --disable-shared --disable-all-pkgs \ - --enable-tex --disable-synctex -C CFLAGS=-g CXXFLAGS=-g + --enable-tex --disable-synctex --disable-xetex \ + --enable-missing -C CFLAGS=-g CXXFLAGS=-g make cd texk/web2c # cd engine build directory make tex # must specify target The first 'make' run will configure everything, and even build the -libraries, even though the packages are disabled. The source tree can -be cut down to just what is needed for the given engine (the separate -pdfTeX and LuaTeX source repositories do this, for example), but see -caveats in previous section. +libraries, even though the packages are disabled. + + The source tree can be cut down to just what is needed for the given +engine (the separate pdfTeX and LuaTeX source repositories do this, for +example), but see caveats in previous section. When the +'--disable-xetex' and '--enable-missing' options are needed is also +explained in the previous section. If you want to debug an X-related program or shared library setup, or other variants, change the 'configure' options accordingly. Either @@ -433,13 +471,34 @@ other variants, change the 'configure' options accordingly. Either Then it is necessary to again specify the target engine ('tex', in the above) in the 'make'. - All this is somewhat unfortunate. We hope to improve the situation -in the future. Patches are welcome. + All these complications are rather unfortunate. Patches are welcome. + +Testing one engine +.................. + +To run only the tests for a given engine, say 'hitex': + + make -C $ww check SUBDIRS=. TESTS='$(hitex_tests)' + +where '$ww' is the web2c build directory, that is, +'ww=/wherever/Build/source/Work/texk/web2c'. + + It's also possible to run individual tests the same way, using the +test name exactly as specified in the '.am' file: + + make -C $ww check SUBDIRS=. TESTS=hitexdir/tests/hello.test + + If you get tired of looking at the 'Entering'/'Leaving directory' +lines, you can add the (GNU) make option '--no-print-dir'. + + You may find it useful to put lengthy incantations like this into a +trivial shell script with a short name (say, 'hitst'). Then you just +run 'hitst' and edit the file when necessary to change things around. File: tlbuild.info, Node: Cross compilation, Prev: Build one engine, Up: Building -4.7 Cross compilation +4.6 Cross compilation ===================== In a cross compilation a "build" system is used to create binaries to be @@ -457,7 +516,7 @@ canonical host name, but note that this should _not_ be '--host=HOST' (*note (autoconf)Hosts and Cross-Compilation::). In order to build, e.g., 32-bit binaries with 'clang' on a 64-bit -MacOSX system one could use: +MacOS system one could use: TL_BUILD_ENV="CC='clang -arch i386' \ CXX='clang++ -arch i386' \ @@ -472,7 +531,7 @@ MacOSX system one could use: File: tlbuild.info, Node: Cross configuring, Next: Cross problems, Up: Cross compilation -4.7.1 Cross configuring +4.6.1 Cross configuring ----------------------- In a standard cross compilation, binaries for the host system cannot @@ -521,7 +580,7 @@ C and C++ programs required for the build process as configure arguments File: tlbuild.info, Node: Cross problems, Prev: Cross configuring, Up: Cross compilation -4.7.2 Cross problems +4.6.2 Cross problems -------------------- The fact that binaries for the host system cannot be executed on the @@ -757,12 +816,12 @@ many extra hassles, so don't do that, tempting as it may be. Currently the versions we use are: - autoconf (GNU Autoconf) 2.69 - automake (GNU automake) 1.16.2 - bison (GNU Bison) 3.7.4 + autoconf (GNU Autoconf) 2.71 + automake (GNU automake) 1.16.5 + bison (GNU Bison) 3.8.2 flex 2.6.0 ltmain.sh (GNU libtool) 2.4.6 - m4 (GNU M4) 1.4.18 + m4 (GNU M4) 1.4.19 makeinfo (GNU texinfo) 6.7 These versions should be used to update the generated files (e.g., @@ -1210,7 +1269,7 @@ modifications documented in 'TLpatches/*', and a wrapper 'configure.ac' and 'Makefile.am' that descends into 'xindy-src'. The 'xindy' build requires a 'make' that supports a 'VPATH' build, -can handle all targets, and do not refer to '${top_srcdir}' or +can handle all targets, and does not refer to '${top_srcdir}' or '${top_builddir}'. The fragment 'xindy/ac/withenable.ac' contains KPSE_ENABLE_PROG([xindy], , [disable]) @@ -1281,11 +1340,12 @@ will need the usual Automake build-related files ('configure.ac', * Menu: * Adding a new program module:: +* Adding a new engine:: * Adding a new generic library module:: * Adding a new TeX-specific library module:: -File: tlbuild.info, Node: Adding a new program module, Next: Adding a new generic library module, Up: Extending TeX Live +File: tlbuild.info, Node: Adding a new program module, Next: Adding a new engine, Up: Extending TeX Live 6.6.1 Adding a new program module --------------------------------- @@ -1388,16 +1448,47 @@ end, also make sure that the whole tree builds from scratch. After final success, don't forget to commit. (Or email the TL maintainers with the patch.) - Caveat: adding a new TeX engine is not completely different, but it's -not all that similar, either. In that case, the work is done inside a -new subdirectory of 'texk/web2c/'. Many things are common to all the -engines, other things need to be copied and possibly modified for each -one, yet others are unique to each. No general recipe is possible. + +File: tlbuild.info, Node: Adding a new engine, Next: Adding a new generic library module, Prev: Adding a new program module, Up: Extending TeX Live + +6.6.2 Adding a new engine +------------------------- + +Adding a new TeX engine is not completely different from adding a +program, but it's not all that similar, either. In this case, the main +work is done by creating a new subdirectory of 'texk/web2c/' for the +engine. The subdirectory is conventionally named ending in 'dir', like +'pdftexdir' and 'xetexdir', to avoid clashes with executable names. + + The source files for the new engine should be put in this +'NEWENGINEdir' subdirectory. Also, a file +'NEWENGINEdir/am/NEWENGINE.am' (e.g., 'pdftexdir/am/pdftex.am' is needed +with the Makefile fragment needed to build it. + + The overall 'web2c/Makefile.am' needs to have an 'include' statement +added to insert that 'NEWENGINE.am' file. + + In 'web2c/ac/web2c.ac', a line needs to be added in the definition of +the 'kpse_tex_progs' variable to include it in the build. That line +specifies whether the new engine is built by default, and the additional +libraries requires. + + For examples of building engines in CWEB, you can check the existing +'hitexdir' and 'mplibdir' directories; these are somewhat simpler than +LuaTeX. Of course, every engine will have its own unique features and +requirements, so existing examples will only take you so far. + + Web2c is built as one "package", with each subdirectory's '.am' +fragment inserted with an Automake 'include'. This means that, for +instance, '$(srcdir)' is '.../web2c', not '.../webdir/enginedir'. It is +a difficult setup to come to terms with, but the alternative is to +recurse into each engine subdirectory, and that would be far worse +(*note (automake)Directories::). -File: tlbuild.info, Node: Adding a new generic library module, Next: Adding a new TeX-specific library module, Prev: Adding a new program module, Up: Extending TeX Live +File: tlbuild.info, Node: Adding a new generic library module, Next: Adding a new TeX-specific library module, Prev: Adding a new engine, Up: Extending TeX Live -6.6.2 Adding a new generic library module +6.6.3 Adding a new generic library module ----------------------------------------- A generic library module in a subdirectory 'libs/LIB' must not depend on @@ -1439,7 +1530,7 @@ line: File: tlbuild.info, Node: Adding a new TeX-specific library module, Prev: Adding a new generic library module, Up: Extending TeX Live -6.6.3 Adding a new TeX-specific library module +6.6.4 Adding a new TeX-specific library module ---------------------------------------------- A TeX-specific library module in a subdirectory 'texk/LIB' may depend on @@ -2237,8 +2328,6 @@ install-tl [_option_]... install-tl-windows.bat [_option_]... - install-tl-advanced.bat [_option_]... - File: tlbuild.info, Node: install-tl DESCRIPTION, Next: install-tl REFERENCES, Prev: install-tl SYNOPSIS, Up: install-tl @@ -2341,7 +2430,7 @@ by either a space or '='. details (<https://tug.org/texlive/doc/tlmgr.html#OPTIONS>). For installation, the default is to pick a mirror automatically, - using <http://mirror.ctan.org/systems/texlive/tlnet>; the chosen + using <https://mirror.ctan.org/systems/texlive/tlnet>; the chosen mirror is used for the entire download. You can use the special argument 'ctan' as an abbreviation for this. (See <https://ctan.org> for more about CTAN and its mirrors.) @@ -2383,6 +2472,12 @@ by either a space or '='. <https://tug.org/texlive/custom-bin.html>. For general information on building TeX Live, see <https://tug.org/texlive/build.html>. +*-debug-fakenet* + + Pretend we're doing a network install, for the sole purpose of + testing broken downloads via moving package files aside in a tlnet + mirror. + *-debug-translation* In the former Perl/Tk GUI modes, this option reported any missing, @@ -2694,8 +2789,6 @@ user installations. 'TEXLIVE_INSTALL_PREFIX' -'TEXLIVE_INSTALL_TEXDIR' - 'TEXLIVE_INSTALL_TEXMFCONFIG' 'TEXLIVE_INSTALL_TEXMFVAR' @@ -2709,11 +2802,13 @@ user installations. 'TEXLIVE_INSTALL_TEXMFSYSVAR' Specify the respective directories. 'TEXLIVE_INSTALL_PREFIX' - defaults to '/usr/local/texlive', while 'TEXLIVE_INSTALL_TEXDIR' - defaults to the release directory within that prefix, e.g., - '/usr/local/texlive/2016'. All the defaults can be seen by running - the installer interactively and then typing 'D' for the directory - menu. + defaults to '/usr/local/texlive'. All the defaults can be seen by + running the installer interactively and then typing 'D' for the + directory menu. + + To override the so-called 'TEXDIR', which defaults to the release + directory within that prefix, e.g., '/usr/local/texlive/2020', use + a profile file (q.v.). 'NOPERLDOC' @@ -2729,7 +2824,7 @@ This script and its documentation were written for the TeX Live distribution (<https://tug.org/texlive>) and both are licensed under the GNU General Public License Version 2 or later. - $Id: install-tl 57970 2021-02-27 14:17:34Z siepo $ + $Id: install-tl 62146 2022-02-22 22:48:10Z karl $ File: tlbuild.info, Node: tlmgr, Next: Index, Prev: install-tl, Up: Top @@ -2806,7 +2901,7 @@ with 'tlmgr': 'tlmgr option repository ctan' -'tlmgr option repository http://mirror.ctan.org/systems/texlive/tlnet' +'tlmgr option repository https://mirror.ctan.org/systems/texlive/tlnet' Tell 'tlmgr' to use a nearby CTAN mirror for future updates; useful if you installed TeX Live from the DVD image and want to have @@ -2888,7 +2983,7 @@ name and its value. 'ctan' - 'http://mirror.ctan.org/systems/texlive/tlnet' + 'https://mirror.ctan.org/systems/texlive/tlnet' Pick a CTAN mirror automatically, trying for one that is both nearby and up-to-date. The chosen mirror is used for the @@ -3518,11 +3613,11 @@ B.6.10 info *-data 'item1,item2,...'* If the option '--data' is given, its argument must be a comma - separated list of field names from: 'name', 'category', - 'localrev', 'remoterev', 'shortdesc', 'longdesc', 'installed', - 'size', 'relocatable', 'depends', 'cat-version', 'cat-date', - 'cat-license', plus various 'cat-contact-*' fields (see - below). + or colon separated list of field names from: 'name', + 'category', 'localrev', 'remoterev', 'shortdesc', 'longdesc', + 'installed', 'size', 'relocatable', 'depends', 'cat-version', + 'cat-date', 'cat-license', plus various 'cat-contact-*' fields + (see below). The 'cat-*' fields all come from the TeX Catalogue (<https://ctan.org/pkg/catalogue>). For each, there are two @@ -3716,7 +3811,7 @@ definitive list): to get further updates from the Internet, after originally installing from DVD. To do this, you can run - tlmgr option repository http://mirror.ctan.org/systems/texlive/tlnet + tlmgr option repository https://mirror.ctan.org/systems/texlive/tlnet The 'install-tl' documentation has more information about the possible values for 'repository'. (For backward compatibility, @@ -4030,10 +4125,10 @@ package, dependencies are never removed. Options: Nothing is actually removed; instead, the actions to be performed are written to the terminal. - This action does not automatically remove symlinks to executables -from system directories; you need to run 'tlmgr path remove' (*note -path: tlmgr path.) yourself if you are using this feature and want stale -symlinks removed. + Except with '--all', this 'remove' action does not automatically +remove symlinks to executables from system directories; you need to run +'tlmgr path remove' (*note path: tlmgr path.) yourself if you remove an +individual package with a symlink in a system directory. File: tlbuild.info, Node: tlmgr repository, Next: tlmgr restore, Prev: tlmgr remove [_option_...] _pkg_..., Up: tlmgr ACTIONS @@ -4509,47 +4604,41 @@ ignored. All other lines must look like: The allowed keys are: -'auto-remove', value 0 or 1 (default 1), same as command-line option. +'auto-remove =' 0 or 1 (default 1), same as command-line option. -'gui-expertmode', value 0 or 1 (default 1). This switches between the full GUI and a simplified GUI with only the most common settings. +'gui-expertmode =' 0 or 1 (default 1). This switches between the full GUI and a simplified GUI with only the most common settings. -'gui-lang' _llcode_, with a language code value as with the command-line option. +'gui-lang =' _llcode_, with a language code value as with the command-line option. -'no-checksums', value 0 or 1 (default 0, see below). +'no-checksums =' 0 or 1 (default 0, see below). -'persistent-downloads', value 0 or 1 (default 1), same as command-line option. +'persistent-downloads =' 0 or 1 (default 1), same as command-line option. -'require-verification', value 0 or 1 (default 0), same as command-line option. +'require-verification =' 0 or 1 (default 0), same as command-line option. -'tkfontscale', value any float. Controls the scaling of fonts in the Tk based frontends. +'tkfontscale =' _floating-point number_ (default 1.0); scaling factor for fonts in the Tk-based frontends. -'update-exclude', value: comma-separated list of packages (no space allowed). Same as the command line option '--exclude' for the action 'update'. +'update-exclude =' _comma-separated list of packages_ (no spaces allowed). Same as the command line option '--exclude' for the 'update' action. -'verify-downloads', value 0 or 1 (default 1), same as command-line option. +'verify-downloads =' 0 or 1 (default 1), same as command-line option. The system-wide config file can contain one additional key: -'allowed-actions' _action1_ [,_action_,...] The value is a comma-separated list of 'tlmgr' actions which are allowed to be executed when 'tlmgr' is invoked in system mode (that is, without '--usermode'). - - This allows distributors to include the 'tlmgr' in their packaging, - but allow only a restricted set of actions that do not interfere - with their distro package manager. For native TeX Live - installations, it doesn't make sense to set this. +'allowed-actions =' _action1_[,_action2_,...] The value is a comma-separated list (no spaces) of 'tlmgr' actions which are allowed to be executed when 'tlmgr' is invoked in system mode (that is, without '--usermode'). This allows distributors to include 'tlmgr' in their packaging, but allow only a restricted set of actions that do not interfere with their distro package manager. For native TeX Live installations, it doesn't make sense to set this. - The 'no-checksums' key needs more explanation. By default, package -checksums computed and stored on the server (in the TLPDB) are compared -to checksums computed locally after downloading. 'no-checksums' -disables this process. - - The checksum algorithm is SHA-512. Your system must have one of -(looked for in this order) the Perl 'Digest::SHA' module, the 'openssl' -program (<https://openssl.org>), the 'sha512sum' program (from GNU -Coreutils, <https://www.gnu.org/software/coreutils>), or finally the -'shasum' program (just to support old Macs). If none of these are -available, a warning is issued and 'tlmgr' proceeds without checking -checksums. (Incidentally, other SHA implementations, such as the pure -Perl and pure Lua modules, are much too slow to be usable in our -context.) 'no-checksums' avoids the warning. + Finally, the 'no-checksums' key needs more explanation. By default, +package checksums computed and stored on the server (in the TLPDB) are +compared to checksums computed locally after downloading. +'no-checksums' disables this process. The checksum algorithm is +SHA-512. Your system must have one of (looked for in this order) the +Perl 'Digest::SHA' module, the 'openssl' program +(<https://openssl.org>), the 'sha512sum' program (from GNU Coreutils, +<https://www.gnu.org/software/coreutils>), or finally the 'shasum' +program (just to support old Macs). If none of these are available, a +warning is issued and 'tlmgr' proceeds without checking checksums. +'no-checksums' avoids the warning. (Incidentally, other SHA +implementations, such as the pure Perl and pure Lua modules, are much +too slow to be usable in our context.) File: tlbuild.info, Node: tlmgr CRYPTOGRAPHIC VERIFICATION, Next: tlmgr USER MODE, Prev: tlmgr CONFIGURATION FILE FOR TLMGR, Up: tlmgr @@ -4717,8 +4806,7 @@ B.9.3 User mode generate, option, paper --------------------------------------- In user mode, these actions operate only on the user tree's -configuration files and/or 'texlive.tlpdb'. creates configuration files -in user tree +configuration files and/or 'texlive.tlpdb'. File: tlbuild.info, Node: tlmgr MULTIPLE REPOSITORIES, Next: tlmgr GUI FOR TLMGR, Prev: tlmgr USER MODE, Up: tlmgr @@ -5339,7 +5427,7 @@ This script and its documentation were written for the TeX Live distribution (<https://tug.org/texlive>) and both are licensed under the GNU General Public License Version 2 or later. - $Id: tlmgr.pl 57970 2021-02-27 14:17:34Z siepo $ + $Id: tlmgr.pl 62273 2022-02-28 08:52:17Z preining $ File: tlbuild.info, Node: Index, Prev: tlmgr, Up: Top @@ -5350,6 +5438,7 @@ Index * Menu: +* $@ target in normal make rules: Prerequisites. (line 13) * --bindir configure option: --prefix --bindir .... (line 6) * --bindir configure option <1>: --enable-multiplatform. @@ -5402,7 +5491,7 @@ Index * --enable-maintainer-mode: Build system tools. (line 28) * --enable-maintainer-mode <1>: --enable-maintainer-mode. (line 6) -* --enable-missing to ignore dependencies: Build one package. (line 71) +* --enable-missing to ignore dependencies: Build one package. (line 94) * --enable-mktextfm-default: kpathsea library. (line 18) * --enable-multiplatform: --enable-multiplatform. (line 6) @@ -5424,7 +5513,7 @@ Index * --host=HOST: Cross configuring. (line 6) * --libdir configure option: --enable-multiplatform. (line 6) -* --no-clean Build option: Build problems. (line 6) +* --no-print-directory GNU make option: Build one engine. (line 56) * --prefix configure option: --prefix --bindir .... (line 6) * --with-banner-add=STR: Configure options for texk/web2c. @@ -5462,6 +5551,7 @@ Index * ac/withenable.ac: Adding a new program module. (line 42) * adapting TeX Live for distros: Distro builds. (line 54) +* adding a new engine: Adding a new engine. (line 6) * adding a new generic library: Adding a new generic library module. (line 6) * adding a new program: Adding a new program module. @@ -5474,7 +5564,7 @@ Index * ANSI C: Declarations and definitions. (line 6) * ApplicationServices Mac framework, required by xetex: Prerequisites. - (line 31) + (line 40) * asymptote: Linked scripts. (line 23) * asymptote <1>: asymptote. (line 6) * Autoconf: Overview of build system. @@ -5497,7 +5587,6 @@ Index * build on demand: Build one package. (line 6) * build one engine: Build one engine. (line 6) * build one package: Build one package. (line 6) -* build problems: Build problems. (line 6) * Build script: Building. (line 6) * build system, design of: Overview of build system. (line 6) @@ -5507,8 +5596,8 @@ Index * building: Building. (line 6) * building a distribution: Build distribution. (line 6) * building in parallel: Build in parallel. (line 6) -* C++11, removing dependent sources: Build one package. (line 64) -* C++11, required: Prerequisites. (line 15) +* C++11, removing dependent sources: Build one package. (line 85) +* C++11, required: Prerequisites. (line 17) * C, ANSI, required: Declarations and definitions. (line 6) * C99, avoided: Declarations and definitions. @@ -5518,7 +5607,7 @@ Index * callexe.c: Macros for Windows. (line 32) * CC: Variables for configure. (line 10) -* CC=C-COMPILER: Build one package. (line 78) +* CC=C-COMPILER: Build one package. (line 77) * CC_BUILD: Cross problems. (line 13) * ChangeLog: Adding a new program module. (line 73) @@ -5530,8 +5619,8 @@ Index (line 17) * CLISP <1>: Configure options for utils/xindy. (line 14) -* clisp, required by xindy: Prerequisites. (line 35) -* Cocoa Mac framework, required by xetex: Prerequisites. (line 31) +* clisp, required by xindy: Prerequisites. (line 44) +* Cocoa Mac framework, required by xetex: Prerequisites. (line 40) * coding conventions: Coding conventions. (line 6) * compilers, C and C++11: Prerequisites. (line 6) * config.guess, config.sub, ...: Top-level directories. @@ -5559,6 +5648,8 @@ Index (line 6) * configure options, program-specific: Program-specific configure options. (line 6) +* configure problems, work around by removing: Build one package. + (line 106) * configure variables: Variables for configure. (line 6) * configure.ac: Adding a new program module. @@ -5577,7 +5668,7 @@ Index * ctangle: Cross problems. (line 26) * CXX: Variables for configure. (line 11) -* CXX=C++-COMPILER: Build one package. (line 78) +* CXX=C++-COMPILER: Build one package. (line 77) * declarations and definitions, in source code: Declarations and definitions. (line 6) * declarations before statements, avoiding: Declarations and definitions. @@ -5599,8 +5690,8 @@ Index (line 6) * dvisvgm: Configure options for texk/dvisvgm. (line 6) -* engine, adding new: Adding a new program module. - (line 104) +* dvisvgm, requires C++11: Prerequisites. (line 17) +* engine, adding new: Adding a new engine. (line 6) * engine, building one: Build one engine. (line 6) * environment variables, for configure: Configure options. (line 16) * exec_prefix: --enable-multiplatform. @@ -5608,19 +5699,18 @@ Index * extending TeX Live: Extending TeX Live. (line 6) * extern functions: Declarations and definitions. (line 41) -* failure to build: Build problems. (line 6) * flags, macros for library and header: Macros for library and header flags. (line 6) -* fontconfig library, required by xetex: Prerequisites. (line 31) -* FreeType: Prerequisites. (line 11) +* fontconfig library, required by xetex: Prerequisites. (line 40) * freetype cross compiling: Cross problems. (line 13) * freetype library: freetype library. (line 6) +* FreeType, requires gmake: Prerequisites. (line 13) * freetype-config: freetype library. (line 13) * freetype-config <1>: Variables for configure. (line 24) * FT2_CONFIG: Variables for configure. (line 21) -* gcc, default compilers: Build one package. (line 78) +* gcc, default compilers: Build one package. (line 77) * general setup macros: General setup macros. (line 6) * generic library module, adding: Adding a new generic library module. @@ -5631,15 +5721,17 @@ Index (line 6) * global configure options: Global configure options. (line 6) -* gmake, required: Prerequisites. (line 11) -* GNU make, required: Prerequisites. (line 11) +* gmake, required: Prerequisites. (line 13) +* GNU make, required: Prerequisites. (line 13) * GNU tools, needed for building: Build system tools. (line 6) * GNU/Linux distro: Distro builds. (line 6) * Gnulib, used for common files: Top-level directories. (line 30) +* HarfBuzz, requires C++11: Prerequisites. (line 17) * ICU cross compiling: Cross problems. (line 20) * ICU libraries: Variables for configure. (line 24) +* ICU, requires C++11: Prerequisites. (line 17) * icu-config: Variables for configure. (line 24) * ICU_CONFIG: Variables for configure. @@ -5658,7 +5750,7 @@ Index (line 6) * kpathsea library: kpathsea library. (line 6) * kpathsea.ac: kpathsea library. (line 18) -* kpse-libpng-flags.m4: png library. (line 46) +* kpse-libpng-flags.m4: png library. (line 45) * kpse-pkgs.m4: Overview of build system. (line 30) * kpse-zlib-flags.m4: zlib library. (line 6) @@ -5700,7 +5792,7 @@ Index (line 8) * KPSE_LIBPNG_FLAGS: Macros for library and header flags. (line 10) -* KPSE_LIBPNG_FLAGS <1>: png library. (line 46) +* KPSE_LIBPNG_FLAGS <1>: png library. (line 45) * kpse_libs_pkgs: Adding a new generic library module. (line 6) * KPSE_LIB_FLAGS: Macros for library and header flags. @@ -5716,10 +5808,10 @@ Index (line 6) * kpse_texlibs_pkgs: Adding a new TeX-specific library module. (line 11) -* KPSE_TRY_LIB: png library. (line 18) +* KPSE_TRY_LIB: png library. (line 17) * KPSE_TRY_LIB <1>: Adding a new generic library module. (line 20) -* KPSE_TRY_LIBXX: png library. (line 31) +* KPSE_TRY_LIBXX: png library. (line 30) * KPSE_TRY_LIBXX <1>: Adding a new generic library module. (line 20) * kpse_utils_pkgs: Adding a new program module. @@ -5750,7 +5842,7 @@ Index * library modules: Library modules. (line 6) * library-specific configure options: Library-specific configure options. (line 6) -* libsigsegv, required by xindy: Prerequisites. (line 35) +* libsigsegv, required by xindy: Prerequisites. (line 44) * libstc++, statically linking: Macros for compilers. (line 29) * Libtool: Overview of build system. @@ -5798,7 +5890,7 @@ Index * native cross compilation: Cross compilation. (line 10) * NEWPROG-SRC, original source subdirectory: Adding a new program module. (line 33) -* OBJCXX=OBJC-COMPILER: Build one package. (line 78) +* OBJCXX=OBJC-COMPILER: Build one package. (line 77) * one engine, building: Build one engine. (line 6) * one package, building: Build one package. (line 6) * OpenGL, required for Asymptote: asymptote. (line 6) @@ -5813,7 +5905,7 @@ Index (line 41) * PERL: Variables for configure. (line 39) -* perl, required by web2c, etc.: Prerequisites. (line 23) +* perl, required by web2c, etc.: Prerequisites. (line 29) * PKG_CONFIG: Variables for configure. (line 23) * plain.tex, not in source tree: Installing. (line 8) @@ -5823,16 +5915,17 @@ Index * preloaded binaries: Configure options for texk/web2c. (line 45) * prerequisites for building: Prerequisites. (line 6) -* problems with build: Build problems. (line 6) * program module, adding: Adding a new program module. (line 6) * program modules: Program modules. (line 6) * program-specific configure options: Program-specific configure options. (line 6) -* proxy build system: png library. (line 36) +* proxy build system: png library. (line 35) +* Python, required by ICU: Prerequisites. (line 23) * reautoconf: Build system tools. (line 28) * reautoconf, for new program: Adding a new program module. (line 89) +* removing build directories: Build one package. (line 106) * requirements for building: Prerequisites. (line 6) * runscript.exe: Macros for Windows. (line 25) * scripts, linked and not maintained: Linked scripts. (line 6) @@ -5844,7 +5937,7 @@ Index (line 6) * shared libraries, using vs. avoiding: Distro builds. (line 11) * size of PDF and PS files: --disable-largefile. (line 11) -* size of source tree: Build one package. (line 53) +* size of source tree: Build one package. (line 63) * source code declarations: Declarations and definitions. (line 6) * source directory building, not supported: Building. (line 17) @@ -5873,6 +5966,8 @@ Index * TeX-specific library module, adding: Adding a new TeX-specific library module. (line 6) * texlive.tlpdb, TeX Live database: Installing. (line 8) +* TEXMFCNF for running standalone: Build one package. (line 44) +* TEXMFROOT for running standalone: Build one package. (line 44) * tie: Cross problems. (line 26) * timestamps, in repository: Build system tools. (line 38) * TLpatches/patch-...: Adding a new program module. @@ -5912,7 +6007,7 @@ Index * wrapper build system: freetype library. (line 6) * X toolkit: Configure options for texk/web2c. (line 22) -* X11 development, required by X clients: Prerequisites. (line 27) +* X11 development, required by X clients: Prerequisites. (line 36) * X11 headers, and const: Const. (line 21) * xasy: asymptote. (line 6) * xaw: Configure options for texk/xdvik. @@ -5941,398 +6036,399 @@ Node: Top1208 Node: Introduction2118 Node: Overview of build system3946 Node: Prerequisites5997 -Node: Building8593 -Node: Build iteration9979 -Node: Build problems11020 -Node: Build in parallel11474 -Node: Build distribution12078 -Node: Build one package12726 -Node: Build one engine16371 -Node: Cross compilation17885 -Node: Cross configuring19165 -Node: Cross problems20842 -Node: Installing22504 -Node: Installation directories23524 -Node: Linked scripts25342 -Node: Distro builds26833 -Node: Layout and infrastructure29209 -Node: Build system tools30040 -Node: Top-level directories32257 -Node: Autoconf macros34493 -Node: General setup macros35255 -Node: Macros for programs36130 -Node: Macros for compilers36931 -Node: Macros for libraries38339 -Node: Macros for library and header flags38765 -Node: Macros for Windows40676 -Node: Library modules42263 -Node: png library42752 -Node: zlib library45100 -Node: freetype library45615 -Node: kpathsea library46311 -Node: Program modules47690 -Node: t1utils package48118 -Node: xindy package48663 -Node: xdvik package49777 -Node: asymptote50836 -Node: Extending TeX Live51332 -Node: Adding a new program module52115 -Node: Adding a new generic library module57248 -Node: Adding a new TeX-specific library module59477 -Node: Configure options60175 -Node: Global configure options61556 -Node: --disable-native-texlive-build62098 -Node: --prefix --bindir ...63060 -Node: --disable-largefile63600 -Node: --disable-missing64142 -Node: --enable-compiler-warnings=LEVEL64543 -Node: --enable-cxx-runtime-hack65199 -Node: --enable-maintainer-mode65619 -Node: --enable-multiplatform66148 -Node: --enable-shared66721 -Node: --enable-silent-rules67092 -Node: --without-ln-s67544 -Node: --without-x67891 -Node: Program-specific configure options68079 -Node: --enable-PROG --disable-PROG68722 -Node: --disable-all-pkgs68995 -Node: Configure options for texk/web2c69778 -Node: Configure options for texk/bibtex-x72316 -Node: Configure options for texk/dvipdfm-x72859 -Node: Configure options for texk/dvisvgm73635 -Node: Configure options for texk/texlive74516 -Node: Configure options for texk/xdvik74937 -Node: Configure options for utils/xindy75558 -Node: Library-specific configure options76448 -Node: Configure options for kpathsea77409 -Node: Variables for configure78113 -Node: Coding conventions79539 -Node: Declarations and definitions80254 -Node: Const82428 -Node: Continuous integration84292 -Node: Transfer from Subversion to Github84956 -Node: Automatic update of the Git mirror87118 -Node: CI testing on Travis-CI87700 -Node: Releases on Github88409 -Node: install-tl88849 -Node: install-tl NAME89218 -Node: install-tl SYNOPSIS89376 -Node: install-tl DESCRIPTION89634 -Node: install-tl REFERENCES90694 -Node: install-tl OPTIONS91218 -Ref: install-tl *-gui* [[=]_module_]91559 -Ref: install-tl text91767 -Ref: install-tl tcl (or "perltk" or "wizard" or "expert" or nothing)91952 -Ref: install-tl *-no-gui*92584 -Ref: install-tl *-lang* _llcode_92674 -Ref: install-tl *-repository* _url|path_93298 -Ref: install-tl *-select-repository*94186 -Ref: install-tl *-all-options*94604 -Ref: install-tl *-custom-bin* _path_94859 -Ref: install-tl *-debug-translation*95693 -Ref: install-tl *-force-platform* _platform_95969 -Ref: install-tl *-help*, *--help*, *-?*96213 -Ref: install-tl *-in-place*96626 -Ref: install-tl *-init-from-profile* _profile_file_97171 -Ref: install-tl *-logfile* _file_97440 -Ref: install-tl *-no-cls*97791 -Ref: install-tl *-no-persistent-downloads*97939 -Ref: install-tl *-persistent-downloads*97964 -Ref: install-tl *-no-verify-downloads*98582 -Ref: install-tl *-non-admin*98945 -Ref: install-tl *-portable*99038 -Ref: install-tl *-print-platform*99177 -Ref: install-tl *-profile* _profile_file_99375 -Ref: install-tl *-q*99596 -Ref: install-tl *-scheme* _scheme_99658 -Ref: install-tl *-v*100132 -Ref: install-tl *-version*, *--version*100287 -Node: install-tl PROFILES100421 -Ref: install-tl instopt_adjustpath (default 0 on Unix, 1 on Windows)103287 -Ref: install-tl instopt_adjustrepo (default 1)103363 -Ref: install-tl instopt_letter (default 0)103500 -Ref: install-tl instopt_portable (default 0)103591 -Ref: install-tl instopt_write18_restricted (default 1)103687 -Node: install-tl ENVIRONMENT VARIABLES105026 -Ref: install-tl TEXLIVE_DOWNLOADER105404 -Ref: install-tl TL_DOWNLOAD_PROGRAM105427 -Ref: install-tl TL_DOWNLOAD_ARGS105447 -Ref: install-tl TEXLIVE_INSTALL_ENV_NOCHECK105651 -Ref: install-tl TEXLIVE_INSTALL_NO_CONTEXT_CACHE105853 -Ref: install-tl TEXLIVE_INSTALL_NO_RESUME105962 -Ref: install-tl TEXLIVE_INSTALL_NO_WELCOME106114 -Ref: install-tl TEXLIVE_INSTALL_PAPER106235 -Ref: install-tl TEXLIVE_INSTALL_PREFIX106381 -Ref: install-tl TEXLIVE_INSTALL_TEXDIR106407 -Ref: install-tl TEXLIVE_INSTALL_TEXMFCONFIG106438 -Ref: install-tl TEXLIVE_INSTALL_TEXMFVAR106466 -Ref: install-tl TEXLIVE_INSTALL_TEXMFHOME106495 -Ref: install-tl TEXLIVE_INSTALL_TEXMFLOCAL106525 -Ref: install-tl TEXLIVE_INSTALL_TEXMFSYSCONFIG106559 -Ref: install-tl TEXLIVE_INSTALL_TEXMFSYSVAR106590 -Ref: install-tl NOPERLDOC106961 -Node: install-tl AUTHORS AND COPYRIGHT107025 -Node: tlmgr107439 -Node: tlmgr NAME107924 -Node: tlmgr SYNOPSIS108056 -Node: tlmgr DESCRIPTION108246 -Node: tlmgr EXAMPLES109345 -Ref: tlmgr tlmgr option repository ctan109596 -Ref: tlmgr tlmgr option repository http://mirror.ctan.org/systems/texlive/tlnet109668 -Ref: tlmgr tlmgr update --list110273 -Ref: tlmgr tlmgr update --all110366 -Ref: tlmgr tlmgr info _what_110523 -Node: tlmgr OPTIONS110785 -Ref: tlmgr *--repository* _url|path_111305 -Ref: tlmgr /some/local/dir112491 -Ref: tlmgr file:/some/local/dir112520 -Ref: tlmgr ctan112593 -Ref: tlmgr http://mirror.ctan.org/systems/texlive/tlnet112646 -Ref: tlmgr http://server/path/to/tlnet112987 -Ref: tlmgr https://server/path/to/tlnet113368 -Ref: tlmgr ftp://server/path/to/tlnet113836 -Ref: tlmgr user@machine:/path/to/tlnet113968 -Ref: tlmgr scp://user@machine/path/to/tlnet114009 -Ref: tlmgr ssh://user@machine/path/to/tlnet114050 -Ref: tlmgr *--gui* [_action_]114443 -Ref: tlmgr *--gui-lang* _llcode_115256 -Ref: tlmgr *--command-logfile* _file_115997 -Ref: tlmgr *--debug-translation*116263 -Ref: tlmgr *--machine-readable*116466 -Ref: tlmgr *--no-execute-actions*116734 -Ref: tlmgr *--package-logfile* _file_116927 -Ref: tlmgr *--pause*117181 -Ref: tlmgr *--persistent-downloads*117336 -Ref: tlmgr *--no-persistent-downloads*117364 -Ref: tlmgr *--pin-file*117858 -Ref: tlmgr *--usermode*118076 -Ref: tlmgr *--usertree* _dir_118196 -Ref: tlmgr *--verify-repo=[none|main|all]*118322 -Node: tlmgr ACTIONS119221 -Node: tlmgr help120082 -Node: tlmgr version120559 -Node: tlmgr backup120822 -Ref: tlmgr *backup [_option_...] --all*120993 -Ref: tlmgr *backup [_option_...] _pkg_...*121026 -Ref: tlmgr *--backupdir* _directory_122092 -Ref: tlmgr *--all*122309 -Ref: tlmgr *--clean*[=_N_]122561 -Ref: tlmgr *--dry-run*122888 -Node: tlmgr candidates _pkg_123018 -Node: tlmgr check [_option_...] [depends|executes|files|runfiles|texmfdbs|all]123373 -Ref: tlmgr *depends*123887 -Ref: tlmgr *executes*124229 -Ref: tlmgr *files*124344 -Ref: tlmgr *runfiles*124480 -Ref: tlmgr *texmfdbs*124617 -Ref: tlmgr - all items in TEXMFDBS have the !! prefix.124847 -Ref: tlmgr - all items in TEXMFBDS have an ls-R file (if they exist at all).124923 -Ref: tlmgr - all items in TEXMF with !! are listed in TEXMFDBS.124988 -Ref: tlmgr - all items in TEXMF with an ls-R file are listed in TEXMFDBS.125063 -Ref: tlmgr *--use-svn*125088 -Node: tlmgr conf125229 -Ref: tlmgr *conf [texmf|tlmgr|updmap [--conffile _file_] [--delete] [_key_ [_value_]]]*125517 -Ref: tlmgr *conf auxtrees [--conffile _file_] [show|add|remove] [_value_]*125581 -Node: tlmgr dump-tlpdb [_option_...] [--json]127996 -Ref: tlmgr *--local*128429 -Ref: tlmgr *--remote*128468 -Ref: tlmgr *--json*128506 -Node: tlmgr generate129077 -Ref: tlmgr *generate [_option_...] language*129273 -Ref: tlmgr *generate [_option_...] language.dat*129312 -Ref: tlmgr *generate [_option_...] language.def*129351 -Ref: tlmgr *generate [_option_...] language.dat.lua*129394 -Ref: tlmgr *--dest* _output_file_131721 -Ref: tlmgr *--localcfg* _local_conf_file_132297 -Ref: tlmgr *--rebuild-sys*132420 -Node: tlmgr gui133235 -Node: tlmgr info133413 -Ref: tlmgr *info [_option_...] _pkg_...*133575 -Ref: tlmgr *info [_option_...] collections*133609 -Ref: tlmgr *info [_option_...] schemes*133639 -Ref: tlmgr *--list*135169 -Ref: tlmgr *--only-installed*135483 -Ref: tlmgr *--only-remote*135671 -Ref: tlmgr *--data item1,item2,...*135975 -Ref: tlmgr *--json* 1137338 -Node: tlmgr init-usertree137721 -Node: tlmgr install [_option_...] _pkg_...138102 -Ref: tlmgr *--dry-run* 1138610 -Ref: tlmgr *--file*138727 -Ref: tlmgr *--force*138949 -Ref: tlmgr *--no-depends*139169 -Ref: tlmgr *--no-depends-at-all*139328 -Ref: tlmgr *--reinstall*139728 -Ref: tlmgr *--with-doc*140106 -Ref: tlmgr *--with-src*140119 -Node: tlmgr key140847 -Ref: tlmgr *key list*141005 -Ref: tlmgr *key add _file_*141023 -Ref: tlmgr *key remove _keyid_*141045 -Node: tlmgr list141639 -Node: tlmgr option141801 -Ref: tlmgr *option [--json] [show]*141956 -Ref: tlmgr *option [--json] showall|help*141987 -Ref: tlmgr *option _key_ [_value_]*142013 -Node: tlmgr paper146591 -Ref: tlmgr *paper [a4|letter]*146740 -Ref: tlmgr *<[xdvi|pdftex|dvips|dvipdfmx|context|psutils] paper [_papersize_|--list]*>146816 -Ref: tlmgr *paper --json*146831 -Node: tlmgr path148046 -Ref: tlmgr *path [--w32mode=user|admin] add*148207 -Ref: tlmgr *path [--w32mode=user|admin] remove*148244 -Node: tlmgr pinning149729 -Ref: tlmgr pinning show149970 -Ref: tlmgr pinning add _repo_ _pkgglob_...150043 -Ref: tlmgr pinning remove _repo_ _pkgglob_...150162 -Ref: tlmgr pinning remove _repo_ --all150315 -Node: tlmgr platform150369 -Ref: tlmgr *platform list|add|remove _platform_...*150555 -Ref: tlmgr *platform set _platform_*150582 -Ref: tlmgr *platform set auto*150603 -Ref: tlmgr *--dry-run* 2151480 -Node: tlmgr postaction151599 -Ref: tlmgr *postaction [_option_...] install [shortcut|fileassoc|script] [_pkg_...]*151829 -Ref: tlmgr *postaction [_option_...] remove [shortcut|fileassoc|script] [_pkg_...]*151903 -Ref: tlmgr *--w32mode=[user|admin]*152218 -Ref: tlmgr *--fileassocmode=[1|2]*152634 -Ref: tlmgr *--all* 1152919 -Node: tlmgr print-platform152974 -Node: tlmgr print-platform-info153305 -Node: tlmgr remove [_option_...] _pkg_...153605 -Ref: tlmgr *--all* 2154089 -Ref: tlmgr *--backup*154199 -Ref: tlmgr *--backupdir* _directory_ 1154225 -Ref: tlmgr *--no-depends* 1154630 -Ref: tlmgr *--no-depends-at-all* 1154692 -Ref: tlmgr *--force* 1154795 -Ref: tlmgr *--dry-run* 3155268 -Node: tlmgr repository155604 -Ref: tlmgr *repository list*155792 -Ref: tlmgr *repository list _path|url|tag_*155826 -Ref: tlmgr *repository add _path_ [_tag_]*155859 -Ref: tlmgr *repository remove _path|tag_*155891 -Ref: tlmgr *repository set _path_[#_tag_] [_path_[#_tag_] ...]*155945 -Ref: tlmgr *repository status*155966 -Ref: tlmgr The tag (which can be the same as the url);157193 -Node: tlmgr restore157671 -Ref: tlmgr *restore [_option_...] _pkg_ [_rev_]*157850 -Ref: tlmgr *restore [_option_...] --all*157880 -Ref: tlmgr *--all* 3158580 -Ref: tlmgr *--backupdir* _directory_ 2158794 -Ref: tlmgr *--dry-run* 4158975 -Ref: tlmgr *--force* 2159107 -Ref: tlmgr *--json* 2159153 -Node: tlmgr search159480 -Ref: tlmgr *search [_option_...] _what_*159644 -Ref: tlmgr *search [_option_...] --file _what_*159681 -Ref: tlmgr *search [_option_...] --all _what_*159717 -Ref: tlmgr *--file* 1159937 -Ref: tlmgr *--all* 4159999 -Ref: tlmgr *--global*160088 -Ref: tlmgr *--word*160215 -Node: tlmgr shell160530 -Ref: tlmgr protocol161265 -Ref: tlmgr help 1161329 -Ref: tlmgr version 1161382 -Ref: tlmgr quit, end, bye, byebye, EOF161450 -Ref: tlmgr restart161471 -Ref: tlmgr load [local|remote]161594 -Ref: tlmgr save161664 -Ref: tlmgr get [_var_] =item set [_var_ [_val_]]161787 -Node: tlmgr show162388 -Node: tlmgr uninstall162555 -Node: tlmgr update [_option_...] [_pkg_...]162785 -Ref: tlmgr *--all* 5163156 -Ref: tlmgr *--self*165335 -Ref: tlmgr *--dry-run* 5166099 -Ref: tlmgr *--list* [_pkg_]166276 -Ref: tlmgr *--exclude* _pkg_166965 -Ref: tlmgr *--no-auto-remove* [_pkg_...]167765 -Ref: tlmgr *--no-auto-install* [_pkg_...]168249 -Ref: tlmgr *--reinstall-forcibly-removed*169011 -Ref: tlmgr *--backup* 1169546 -Ref: tlmgr *--backupdir* _directory_ 3169572 -Ref: tlmgr *--no-depends* 2170738 -Ref: tlmgr *--no-depends-at-all* 2170941 -Ref: tlmgr *--force* 3171044 -Node: tlmgr CONFIGURATION FILE FOR TLMGR172035 -Ref: tlmgr auto-remove, value 0 or 1 (default 1), same as command-line option.173042 -Ref: tlmgr gui-expertmode, value 0 or 1 (default 1). This switches between the full GUI and a simplified GUI with only the most common settings.173179 -Ref: tlmgr gui-lang _llcode_, with a language code value as with the command-line option.173261 -Ref: tlmgr no-checksums, value 0 or 1 (default 0, see below).173315 -Ref: tlmgr persistent-downloads, value 0 or 1 (default 1), same as command-line option.173395 -Ref: tlmgr require-verification, value 0 or 1 (default 0), same as command-line option.173475 -Ref: tlmgr tkfontscale, value any float. Controls the scaling of fonts in the Tk based frontends.173565 -Ref: tlmgr update-exclude, value: comma-separated list of packages (no space allowed). Same as the command line option --exclude for the action update.173713 -Ref: tlmgr verify-downloads, value 0 or 1 (default 1), same as command-line option.173789 -Ref: tlmgr allowed-actions _action1_ [,_action_,...] The value is a comma-separated list of tlmgr actions which are allowed to be executed when tlmgr is invoked in system mode (that is, without --usermode).174058 -Node: tlmgr CRYPTOGRAPHIC VERIFICATION175146 -Node: tlmgr Configuration of GnuPG invocation177319 -Node: tlmgr USER MODE177957 -Node: tlmgr User mode install180803 -Node: tlmgr User mode backup, restore, remove, update181947 -Node: tlmgr User mode generate, option, paper182389 -Node: tlmgr MULTIPLE REPOSITORIES182765 -Node: tlmgr Pinning184494 -Node: tlmgr GUI FOR TLMGR186417 -Node: tlmgr Main display188066 -Node: tlmgr Display configuration area188318 -Ref: tlmgr Status188679 -Ref: tlmgr Category188843 -Ref: tlmgr Match189029 -Ref: tlmgr Selection189210 -Ref: tlmgr Display configuration buttons189414 -Node: tlmgr Package list area189597 -Ref: tlmgr a checkbox190181 -Ref: tlmgr package name190317 -Ref: tlmgr local revision (and version)190416 -Ref: tlmgr remote revision (and version)190791 -Ref: tlmgr short description191088 -Node: tlmgr Main display action buttons191133 -Ref: tlmgr Update all installed191399 -Ref: tlmgr Update191771 -Ref: tlmgr Install191821 -Ref: tlmgr Remove192007 -Ref: tlmgr Backup192185 -Node: tlmgr Menu bar192342 -Ref: tlmgr tlmgr menu192565 -Ref: tlmgr Options menu192873 -Ref: tlmgr Actions menu193956 -Ref: tlmgr Help menu194384 -Node: tlmgr GUI options194518 -Ref: tlmgr -background _color_194764 -Ref: tlmgr -font " _fontname_ _fontsize_ "194829 -Ref: tlmgr -foreground _color_194987 -Ref: tlmgr -geometry _geomspec_195039 -Ref: tlmgr -xrm _xresource_195231 -Node: tlmgr MACHINE-READABLE OUTPUT195500 -Node: tlmgr Machine-readable update and install output196310 -Ref: tlmgr location-url _location_197586 -Ref: tlmgr total-bytes _count_197802 -Ref: tlmgr _pkgname_198212 -Ref: tlmgr _status_198422 -Ref: tlmgr d198500 -Ref: tlmgr f198560 -Ref: tlmgr u198739 -Ref: tlmgr r198785 -Ref: tlmgr a198908 -Ref: tlmgr i199086 -Ref: tlmgr I199205 -Ref: tlmgr _localrev_199307 -Ref: tlmgr _serverrev_199414 -Ref: tlmgr _size_199526 -Ref: tlmgr _runtime_199695 -Ref: tlmgr _esttot_199765 -Node: tlmgr Machine-readable option output199798 -Node: tlmgr ENVIRONMENT VARIABLES200310 -Ref: tlmgr TEXLIVE_COMPRESSOR200821 -Ref: tlmgr TEXLIVE_DOWNLOADER201669 -Ref: tlmgr TL_DOWNLOAD_PROGRAM201692 -Ref: tlmgr TL_DOWNLOAD_ARGS201712 -Ref: tlmgr TEXLIVE_PREFER_OWN202738 -Node: tlmgr AUTHORS AND COPYRIGHT203562 -Node: Index203961 +Ref: Prerequisites-Footnote-18996 +Node: Building9299 +Node: Build iteration10641 +Node: Build in parallel11685 +Node: Build distribution12290 +Node: Build one package12938 +Node: Build one engine17650 +Node: Cross compilation20075 +Node: Cross configuring21354 +Node: Cross problems23031 +Node: Installing24693 +Node: Installation directories25713 +Node: Linked scripts27531 +Node: Distro builds29022 +Node: Layout and infrastructure31398 +Node: Build system tools32229 +Node: Top-level directories34446 +Node: Autoconf macros36682 +Node: General setup macros37444 +Node: Macros for programs38319 +Node: Macros for compilers39120 +Node: Macros for libraries40528 +Node: Macros for library and header flags40954 +Node: Macros for Windows42865 +Node: Library modules44452 +Node: png library44941 +Node: zlib library47289 +Node: freetype library47804 +Node: kpathsea library48500 +Node: Program modules49879 +Node: t1utils package50307 +Node: xindy package50852 +Node: xdvik package51968 +Node: asymptote53027 +Node: Extending TeX Live53523 +Node: Adding a new program module54330 +Node: Adding a new engine59093 +Node: Adding a new generic library module60878 +Node: Adding a new TeX-specific library module63099 +Node: Configure options63797 +Node: Global configure options65178 +Node: --disable-native-texlive-build65720 +Node: --prefix --bindir ...66682 +Node: --disable-largefile67222 +Node: --disable-missing67764 +Node: --enable-compiler-warnings=LEVEL68165 +Node: --enable-cxx-runtime-hack68821 +Node: --enable-maintainer-mode69241 +Node: --enable-multiplatform69770 +Node: --enable-shared70343 +Node: --enable-silent-rules70714 +Node: --without-ln-s71166 +Node: --without-x71513 +Node: Program-specific configure options71701 +Node: --enable-PROG --disable-PROG72344 +Node: --disable-all-pkgs72617 +Node: Configure options for texk/web2c73400 +Node: Configure options for texk/bibtex-x75938 +Node: Configure options for texk/dvipdfm-x76481 +Node: Configure options for texk/dvisvgm77257 +Node: Configure options for texk/texlive78138 +Node: Configure options for texk/xdvik78559 +Node: Configure options for utils/xindy79180 +Node: Library-specific configure options80070 +Node: Configure options for kpathsea81031 +Node: Variables for configure81735 +Node: Coding conventions83161 +Node: Declarations and definitions83876 +Node: Const86050 +Node: Continuous integration87914 +Node: Transfer from Subversion to Github88578 +Node: Automatic update of the Git mirror90740 +Node: CI testing on Travis-CI91322 +Node: Releases on Github92031 +Node: install-tl92471 +Node: install-tl NAME92840 +Node: install-tl SYNOPSIS92998 +Node: install-tl DESCRIPTION93214 +Node: install-tl REFERENCES94274 +Node: install-tl OPTIONS94798 +Ref: install-tl *-gui* [[=]_module_]95139 +Ref: install-tl text95347 +Ref: install-tl tcl (or "perltk" or "wizard" or "expert" or nothing)95532 +Ref: install-tl *-no-gui*96164 +Ref: install-tl *-lang* _llcode_96254 +Ref: install-tl *-repository* _url|path_96878 +Ref: install-tl *-select-repository*97767 +Ref: install-tl *-all-options*98185 +Ref: install-tl *-custom-bin* _path_98440 +Ref: install-tl *-debug-fakenet*99270 +Ref: install-tl *-debug-translation*99446 +Ref: install-tl *-force-platform* _platform_99722 +Ref: install-tl *-help*, *--help*, *-?*99966 +Ref: install-tl *-in-place*100379 +Ref: install-tl *-init-from-profile* _profile_file_100924 +Ref: install-tl *-logfile* _file_101193 +Ref: install-tl *-no-cls*101544 +Ref: install-tl *-no-persistent-downloads*101692 +Ref: install-tl *-persistent-downloads*101717 +Ref: install-tl *-no-verify-downloads*102335 +Ref: install-tl *-non-admin*102698 +Ref: install-tl *-portable*102791 +Ref: install-tl *-print-platform*102930 +Ref: install-tl *-profile* _profile_file_103128 +Ref: install-tl *-q*103349 +Ref: install-tl *-scheme* _scheme_103411 +Ref: install-tl *-v*103885 +Ref: install-tl *-version*, *--version*104040 +Node: install-tl PROFILES104174 +Ref: install-tl instopt_adjustpath (default 0 on Unix, 1 on Windows)107040 +Ref: install-tl instopt_adjustrepo (default 1)107116 +Ref: install-tl instopt_letter (default 0)107253 +Ref: install-tl instopt_portable (default 0)107344 +Ref: install-tl instopt_write18_restricted (default 1)107440 +Node: install-tl ENVIRONMENT VARIABLES108779 +Ref: install-tl TEXLIVE_DOWNLOADER109157 +Ref: install-tl TL_DOWNLOAD_PROGRAM109180 +Ref: install-tl TL_DOWNLOAD_ARGS109200 +Ref: install-tl TEXLIVE_INSTALL_ENV_NOCHECK109404 +Ref: install-tl TEXLIVE_INSTALL_NO_CONTEXT_CACHE109606 +Ref: install-tl TEXLIVE_INSTALL_NO_RESUME109715 +Ref: install-tl TEXLIVE_INSTALL_NO_WELCOME109867 +Ref: install-tl TEXLIVE_INSTALL_PAPER109988 +Ref: install-tl TEXLIVE_INSTALL_PREFIX110134 +Ref: install-tl TEXLIVE_INSTALL_TEXMFCONFIG110165 +Ref: install-tl TEXLIVE_INSTALL_TEXMFVAR110193 +Ref: install-tl TEXLIVE_INSTALL_TEXMFHOME110222 +Ref: install-tl TEXLIVE_INSTALL_TEXMFLOCAL110252 +Ref: install-tl TEXLIVE_INSTALL_TEXMFSYSCONFIG110286 +Ref: install-tl TEXLIVE_INSTALL_TEXMFSYSVAR110317 +Ref: install-tl NOPERLDOC110732 +Node: install-tl AUTHORS AND COPYRIGHT110796 +Node: tlmgr111209 +Node: tlmgr NAME111694 +Node: tlmgr SYNOPSIS111826 +Node: tlmgr DESCRIPTION112016 +Node: tlmgr EXAMPLES113115 +Ref: tlmgr tlmgr option repository ctan113366 +Ref: tlmgr tlmgr option repository https://mirror.ctan.org/systems/texlive/tlnet113439 +Ref: tlmgr tlmgr update --list114044 +Ref: tlmgr tlmgr update --all114137 +Ref: tlmgr tlmgr info _what_114294 +Node: tlmgr OPTIONS114556 +Ref: tlmgr *--repository* _url|path_115076 +Ref: tlmgr /some/local/dir116262 +Ref: tlmgr file:/some/local/dir116291 +Ref: tlmgr ctan116364 +Ref: tlmgr https://mirror.ctan.org/systems/texlive/tlnet116418 +Ref: tlmgr http://server/path/to/tlnet116759 +Ref: tlmgr https://server/path/to/tlnet117140 +Ref: tlmgr ftp://server/path/to/tlnet117608 +Ref: tlmgr user@machine:/path/to/tlnet117740 +Ref: tlmgr scp://user@machine/path/to/tlnet117781 +Ref: tlmgr ssh://user@machine/path/to/tlnet117822 +Ref: tlmgr *--gui* [_action_]118215 +Ref: tlmgr *--gui-lang* _llcode_119028 +Ref: tlmgr *--command-logfile* _file_119769 +Ref: tlmgr *--debug-translation*120035 +Ref: tlmgr *--machine-readable*120238 +Ref: tlmgr *--no-execute-actions*120506 +Ref: tlmgr *--package-logfile* _file_120699 +Ref: tlmgr *--pause*120953 +Ref: tlmgr *--persistent-downloads*121108 +Ref: tlmgr *--no-persistent-downloads*121136 +Ref: tlmgr *--pin-file*121630 +Ref: tlmgr *--usermode*121848 +Ref: tlmgr *--usertree* _dir_121968 +Ref: tlmgr *--verify-repo=[none|main|all]*122094 +Node: tlmgr ACTIONS122993 +Node: tlmgr help123854 +Node: tlmgr version124331 +Node: tlmgr backup124594 +Ref: tlmgr *backup [_option_...] --all*124765 +Ref: tlmgr *backup [_option_...] _pkg_...*124798 +Ref: tlmgr *--backupdir* _directory_125864 +Ref: tlmgr *--all*126081 +Ref: tlmgr *--clean*[=_N_]126333 +Ref: tlmgr *--dry-run*126660 +Node: tlmgr candidates _pkg_126790 +Node: tlmgr check [_option_...] [depends|executes|files|runfiles|texmfdbs|all]127145 +Ref: tlmgr *depends*127659 +Ref: tlmgr *executes*128001 +Ref: tlmgr *files*128116 +Ref: tlmgr *runfiles*128252 +Ref: tlmgr *texmfdbs*128389 +Ref: tlmgr - all items in TEXMFDBS have the !! prefix.128619 +Ref: tlmgr - all items in TEXMFBDS have an ls-R file (if they exist at all).128695 +Ref: tlmgr - all items in TEXMF with !! are listed in TEXMFDBS.128760 +Ref: tlmgr - all items in TEXMF with an ls-R file are listed in TEXMFDBS.128835 +Ref: tlmgr *--use-svn*128860 +Node: tlmgr conf129001 +Ref: tlmgr *conf [texmf|tlmgr|updmap [--conffile _file_] [--delete] [_key_ [_value_]]]*129289 +Ref: tlmgr *conf auxtrees [--conffile _file_] [show|add|remove] [_value_]*129353 +Node: tlmgr dump-tlpdb [_option_...] [--json]131768 +Ref: tlmgr *--local*132201 +Ref: tlmgr *--remote*132240 +Ref: tlmgr *--json*132278 +Node: tlmgr generate132849 +Ref: tlmgr *generate [_option_...] language*133045 +Ref: tlmgr *generate [_option_...] language.dat*133084 +Ref: tlmgr *generate [_option_...] language.def*133123 +Ref: tlmgr *generate [_option_...] language.dat.lua*133166 +Ref: tlmgr *--dest* _output_file_135493 +Ref: tlmgr *--localcfg* _local_conf_file_136069 +Ref: tlmgr *--rebuild-sys*136192 +Node: tlmgr gui137007 +Node: tlmgr info137185 +Ref: tlmgr *info [_option_...] _pkg_...*137347 +Ref: tlmgr *info [_option_...] collections*137381 +Ref: tlmgr *info [_option_...] schemes*137411 +Ref: tlmgr *--list*138941 +Ref: tlmgr *--only-installed*139255 +Ref: tlmgr *--only-remote*139443 +Ref: tlmgr *--data item1,item2,...*139747 +Ref: tlmgr *--json* 1141119 +Node: tlmgr init-usertree141502 +Node: tlmgr install [_option_...] _pkg_...141883 +Ref: tlmgr *--dry-run* 1142391 +Ref: tlmgr *--file*142508 +Ref: tlmgr *--force*142730 +Ref: tlmgr *--no-depends*142950 +Ref: tlmgr *--no-depends-at-all*143109 +Ref: tlmgr *--reinstall*143509 +Ref: tlmgr *--with-doc*143887 +Ref: tlmgr *--with-src*143900 +Node: tlmgr key144628 +Ref: tlmgr *key list*144786 +Ref: tlmgr *key add _file_*144804 +Ref: tlmgr *key remove _keyid_*144826 +Node: tlmgr list145420 +Node: tlmgr option145582 +Ref: tlmgr *option [--json] [show]*145737 +Ref: tlmgr *option [--json] showall|help*145768 +Ref: tlmgr *option _key_ [_value_]*145794 +Node: tlmgr paper150373 +Ref: tlmgr *paper [a4|letter]*150522 +Ref: tlmgr *<[xdvi|pdftex|dvips|dvipdfmx|context|psutils] paper [_papersize_|--list]*>150598 +Ref: tlmgr *paper --json*150613 +Node: tlmgr path151828 +Ref: tlmgr *path [--w32mode=user|admin] add*151989 +Ref: tlmgr *path [--w32mode=user|admin] remove*152026 +Node: tlmgr pinning153511 +Ref: tlmgr pinning show153752 +Ref: tlmgr pinning add _repo_ _pkgglob_...153825 +Ref: tlmgr pinning remove _repo_ _pkgglob_...153944 +Ref: tlmgr pinning remove _repo_ --all154097 +Node: tlmgr platform154151 +Ref: tlmgr *platform list|add|remove _platform_...*154337 +Ref: tlmgr *platform set _platform_*154364 +Ref: tlmgr *platform set auto*154385 +Ref: tlmgr *--dry-run* 2155262 +Node: tlmgr postaction155381 +Ref: tlmgr *postaction [_option_...] install [shortcut|fileassoc|script] [_pkg_...]*155611 +Ref: tlmgr *postaction [_option_...] remove [shortcut|fileassoc|script] [_pkg_...]*155685 +Ref: tlmgr *--w32mode=[user|admin]*156000 +Ref: tlmgr *--fileassocmode=[1|2]*156416 +Ref: tlmgr *--all* 1156701 +Node: tlmgr print-platform156756 +Node: tlmgr print-platform-info157087 +Node: tlmgr remove [_option_...] _pkg_...157387 +Ref: tlmgr *--all* 2157871 +Ref: tlmgr *--backup*157981 +Ref: tlmgr *--backupdir* _directory_ 1158007 +Ref: tlmgr *--no-depends* 1158412 +Ref: tlmgr *--no-depends-at-all* 1158474 +Ref: tlmgr *--force* 1158577 +Ref: tlmgr *--dry-run* 3159050 +Node: tlmgr repository159427 +Ref: tlmgr *repository list*159615 +Ref: tlmgr *repository list _path|url|tag_*159649 +Ref: tlmgr *repository add _path_ [_tag_]*159682 +Ref: tlmgr *repository remove _path|tag_*159714 +Ref: tlmgr *repository set _path_[#_tag_] [_path_[#_tag_] ...]*159768 +Ref: tlmgr *repository status*159789 +Ref: tlmgr The tag (which can be the same as the url);161016 +Node: tlmgr restore161494 +Ref: tlmgr *restore [_option_...] _pkg_ [_rev_]*161673 +Ref: tlmgr *restore [_option_...] --all*161703 +Ref: tlmgr *--all* 3162403 +Ref: tlmgr *--backupdir* _directory_ 2162617 +Ref: tlmgr *--dry-run* 4162798 +Ref: tlmgr *--force* 2162930 +Ref: tlmgr *--json* 2162976 +Node: tlmgr search163303 +Ref: tlmgr *search [_option_...] _what_*163467 +Ref: tlmgr *search [_option_...] --file _what_*163504 +Ref: tlmgr *search [_option_...] --all _what_*163540 +Ref: tlmgr *--file* 1163760 +Ref: tlmgr *--all* 4163822 +Ref: tlmgr *--global*163911 +Ref: tlmgr *--word*164038 +Node: tlmgr shell164353 +Ref: tlmgr protocol165088 +Ref: tlmgr help 1165152 +Ref: tlmgr version 1165205 +Ref: tlmgr quit, end, bye, byebye, EOF165273 +Ref: tlmgr restart165294 +Ref: tlmgr load [local|remote]165417 +Ref: tlmgr save165487 +Ref: tlmgr get [_var_] =item set [_var_ [_val_]]165610 +Node: tlmgr show166211 +Node: tlmgr uninstall166378 +Node: tlmgr update [_option_...] [_pkg_...]166608 +Ref: tlmgr *--all* 5166979 +Ref: tlmgr *--self*169158 +Ref: tlmgr *--dry-run* 5169922 +Ref: tlmgr *--list* [_pkg_]170099 +Ref: tlmgr *--exclude* _pkg_170788 +Ref: tlmgr *--no-auto-remove* [_pkg_...]171588 +Ref: tlmgr *--no-auto-install* [_pkg_...]172072 +Ref: tlmgr *--reinstall-forcibly-removed*172834 +Ref: tlmgr *--backup* 1173369 +Ref: tlmgr *--backupdir* _directory_ 3173395 +Ref: tlmgr *--no-depends* 2174561 +Ref: tlmgr *--no-depends-at-all* 2174764 +Ref: tlmgr *--force* 3174867 +Node: tlmgr CONFIGURATION FILE FOR TLMGR175858 +Ref: tlmgr auto-remove = 0 or 1 (default 1), same as command-line option.176860 +Ref: tlmgr gui-expertmode = 0 or 1 (default 1). This switches between the full GUI and a simplified GUI with only the most common settings.176992 +Ref: tlmgr gui-lang = _llcode_, with a language code value as with the command-line option.177076 +Ref: tlmgr no-checksums = 0 or 1 (default 0, see below).177125 +Ref: tlmgr persistent-downloads = 0 or 1 (default 1), same as command-line option.177200 +Ref: tlmgr require-verification = 0 or 1 (default 0), same as command-line option.177275 +Ref: tlmgr tkfontscale = _floating-point number_ (default 1.0); scaling factor for fonts in the Tk-based frontends.177383 +Ref: tlmgr update-exclude = _comma-separated list of packages_ (no spaces allowed). Same as the command line option --exclude for the update action.177528 +Ref: tlmgr verify-downloads = 0 or 1 (default 1), same as command-line option.177599 +Ref: tlmgr allowed-actions = _action1_[,_action2_,...] The value is a comma-separated list (no spaces) of tlmgr actions which are allowed to be executed when tlmgr is invoked in system mode (that is, without --usermode). This allows distributors to include tlmgr in their packaging, but allow only a restricted set of actions that do not interfere with their distro package manager. For native TeX Live installations, it doesn't make sense to set this.178116 +Node: tlmgr CRYPTOGRAPHIC VERIFICATION178948 +Node: tlmgr Configuration of GnuPG invocation181121 +Node: tlmgr USER MODE181759 +Node: tlmgr User mode install184605 +Node: tlmgr User mode backup, restore, remove, update185749 +Node: tlmgr User mode generate, option, paper186191 +Node: tlmgr MULTIPLE REPOSITORIES186525 +Node: tlmgr Pinning188254 +Node: tlmgr GUI FOR TLMGR190177 +Node: tlmgr Main display191826 +Node: tlmgr Display configuration area192078 +Ref: tlmgr Status192439 +Ref: tlmgr Category192603 +Ref: tlmgr Match192789 +Ref: tlmgr Selection192970 +Ref: tlmgr Display configuration buttons193174 +Node: tlmgr Package list area193357 +Ref: tlmgr a checkbox193941 +Ref: tlmgr package name194077 +Ref: tlmgr local revision (and version)194176 +Ref: tlmgr remote revision (and version)194551 +Ref: tlmgr short description194848 +Node: tlmgr Main display action buttons194893 +Ref: tlmgr Update all installed195159 +Ref: tlmgr Update195531 +Ref: tlmgr Install195581 +Ref: tlmgr Remove195767 +Ref: tlmgr Backup195945 +Node: tlmgr Menu bar196102 +Ref: tlmgr tlmgr menu196325 +Ref: tlmgr Options menu196633 +Ref: tlmgr Actions menu197716 +Ref: tlmgr Help menu198144 +Node: tlmgr GUI options198278 +Ref: tlmgr -background _color_198524 +Ref: tlmgr -font " _fontname_ _fontsize_ "198589 +Ref: tlmgr -foreground _color_198747 +Ref: tlmgr -geometry _geomspec_198799 +Ref: tlmgr -xrm _xresource_198991 +Node: tlmgr MACHINE-READABLE OUTPUT199260 +Node: tlmgr Machine-readable update and install output200070 +Ref: tlmgr location-url _location_201346 +Ref: tlmgr total-bytes _count_201562 +Ref: tlmgr _pkgname_201972 +Ref: tlmgr _status_202182 +Ref: tlmgr d202260 +Ref: tlmgr f202320 +Ref: tlmgr u202499 +Ref: tlmgr r202545 +Ref: tlmgr a202668 +Ref: tlmgr i202846 +Ref: tlmgr I202965 +Ref: tlmgr _localrev_203067 +Ref: tlmgr _serverrev_203174 +Ref: tlmgr _size_203286 +Ref: tlmgr _runtime_203455 +Ref: tlmgr _esttot_203525 +Node: tlmgr Machine-readable option output203558 +Node: tlmgr ENVIRONMENT VARIABLES204070 +Ref: tlmgr TEXLIVE_COMPRESSOR204581 +Ref: tlmgr TEXLIVE_DOWNLOADER205429 +Ref: tlmgr TL_DOWNLOAD_PROGRAM205452 +Ref: tlmgr TL_DOWNLOAD_ARGS205472 +Ref: tlmgr TEXLIVE_PREFER_OWN206498 +Node: tlmgr AUTHORS AND COPYRIGHT207322 +Node: Index207724 End Tag Table diff --git a/Master/texmf-dist/doc/info/web2c.info b/Master/texmf-dist/doc/info/web2c.info index f287a96a42c..de5ce04906e 100644 --- a/Master/texmf-dist/doc/info/web2c.info +++ b/Master/texmf-dist/doc/info/web2c.info @@ -1,10 +1,10 @@ -This is web2c.info, produced by makeinfo version 6.7 from web2c.texi. +This is web2c.info, produced by makeinfo version 6.8 from web2c.texi. This file documents the installation and use of the programs in Web2c, an implementation of Donald Knuth's TeX system. Copyright (C) 1996, 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, -2005, 2007, 2008, 2009, 2010-2021 Karl Berry & Olaf Weber. +2005, 2007, 2008, 2009, 2010-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 @@ -58,7 +58,7 @@ Web2c This document describes how to install and use the programs in the Web2c implementation of the TeX system, especially for Unix systems. It -corresponds to Web2c version 2021, released in February 2021. +corresponds to Web2c version 2022, released in January 2022. * Menu: @@ -83,16 +83,17 @@ File: web2c.info, Node: Introduction, Next: Installation, Prev: Top, Up: Top 1 Introduction ************** -This manual corresponds to version 2021 of Web2c, released in February -2021. +This manual corresponds to version 2022 of Web2c, released in January +2022. - "Web2c" is the name of a TeX implementation, originally for Unix, but -now also running under various operating systems. By "TeX -implementation", we mean all of the standard programs developed by the -Stanford TeX project directed by Donald E. Knuth: Metafont, DVItype, -GFtoDVI, BibTeX, Tangle, etc., as well as TeX itself. Other programs -are also included: DVIcopy, written by Peter Breitenlohner, MetaPost and -its utilities (derived from Metafont), by John Hobby, etc. + "Web2c" (also spelled Web2C) is the name of a TeX implementation, +originally for Unix, but now also running under Windows and other +operating systems. By "TeX implementation", we mean all of the standard +programs developed by the Stanford TeX project led by Donald E. Knuth: +Metafont, DVItype, GFtoDVI, BibTeX, Tangle, etc., as well as TeX itself. +Other programs are also included: DVIcopy, written by Peter +Breitenlohner, MetaPost and its utilities (derived from Metafont), by +John Hobby, and many more. General strategy: Web2c works, as its name implies, by translating the WEB source in which TeX is written into C source code. Its output @@ -113,8 +114,8 @@ practical implication for redistributors of Web2c is that most of the executables are covered by the GNU General Public License or GNU Lesser General Public License, and therefore anyone who gets a binary distribution must also be able to get the sources, as explained by the -terms of the GPL (<https://gnu.org/licenses/>. The GPL covers the Web2c -executables, including 'tex', because the Free Software Foundation +terms of the GPL (<https://gnu.org/licenses/>). The GPL covers the +Web2c executables, including 'tex', because the Free Software Foundation sponsored the initial development of the Kpathsea library that Web2c uses. The basic source files from Stanford, however, have their own copyright terms or are in the public domain, and are not covered by the @@ -128,8 +129,16 @@ Web-to-C somewhere in there. In 1990, Karl Berry became the maintainer. He made many changes to the original sources, and started using the shorter name Web2c. In 1997, Olaf Weber took over, and then in 2006, Karl started taking care of it again. No significant development or -changes have been needed for many years. Dozens of other people have -contributed; their names are listed in the 'ChangeLog' files. +changes have been needed for many years, though dozens of other people +have contributed in many ways; their names are listed in the 'ChangeLog' +files. + + Originally, Web2c was distributed as its own package, alongside the +original web programs from Stanford and other components. It was also +the basis for the teTeX distribution (now discontinued). Around 2004, +the packaging focus shifted entirely to the TeX Live distribution +(<https://tug.org/texlive/>), though the same Web2c is at the heart of +the release. Other acknowledgements by Karl: The University of Massachusetts at Boston (particularly Rick Martin and Bob Morris) provided computers and @@ -374,6 +383,9 @@ File: web2c.info, Node: Commonalities, Next: Three programs, Prev: Installati Many aspects of the TeX system are the same among more than one program, so we describe those pieces together, here. + Another kind of commonality is the extensions to TeX that are +available across all the engines; *note TeX extensions::. + * Menu: * Option conventions:: - or -, = or ' ' for values. @@ -775,33 +787,38 @@ File: web2c.info, Node: Hardware and memory dumps, Prev: Determining the memor 4.3.3 Hardware and memory dumps ------------------------------- -By default, memory dump files are generally sharable between -architectures of different types; specifically, on machines of different -endianness (*note (libc)Byte order::). (This is a feature of the Web2c -implementation, and is not true of all TeX implementations.) If you -specify '--disable-dump-share' to 'configure', however, memory dumps -will be endian-dependent. - - The reason to do this is speed. To achieve endian-independence, the -reading of memory dumps on LittleEndian architectures, such as PC's and -DEC architectures, is somewhat slowed (all the multibyte values have to -be swapped). Usually, this is not noticeable, and the advantage of -being able to share memory dumps across all platforms at a site far -outweighs the speed loss. But if you're installing Web2c for use on -LittleEndian machines only, perhaps on a PC being used only by you, you -may wish to get maximum speed. +By default, memory dump files are sharable between architectures of +different types; specifically, on machines of different endianness +(*note (libc)Byte order::) and with different word sizes (4-byte 'long' +vs. 8-byte 'long'). This is a feature of the Web2c implementation, and +is not true of all TeX implementations. + + The script 'tl-check-fmtshare' in the TeX Live source tree +('Master/tlpkg/bin') provides a relatively easy way to test that a +'.fmt' built on the local host can be loaded by a TeX engine built on +some remote host. + + If you specify '--disable-dump-share' to 'configure', however, memory +dumps will be endian-dependent. The reason to do this is speed. To +achieve endian-independence, the reading of memory dumps on LittleEndian +architectures, such as PC's and DEC architectures, is somewhat slowed +(all the multibyte values have to be swapped). Usually, this is not +noticeable, and the advantage of being able to share memory dumps across +all platforms at a site far outweighs the speed loss. But if you're +trying to squeeze out every possible bit of performance, you may wish to +do this. TeXnically, even without '--disable-dump-share', sharing of '.fmt' files cannot be guaranteed to work. Floating-point values are always written in native format, and hence will generally not be readable across platforms. Fortunately, TeX uses floating point only to -represent glue ratios, and all common formats (plain, LaTeX, AMSTeX, -...) do not do any glue setting at '.fmt'-creation time. Metafont does +represent glue ratios, and none of the common formats (plain, LaTeX, +AMSTeX, ...) do any glue setting at '.fmt'-creation time. Metafont does not use floating point in any dumped value at all. Incidentally, different memory dump files will never compare equal -byte-for-byte, because the program always dumps the current date and -time. So don't be alarmed by just a few bytes difference. +byte-for-byte, because the programs dump the current date and time. So +don't be alarmed by a few bytes difference. If you don't know what endianness your machine is, and you're curious, here is a little C program to tell you. (The 'configure' @@ -828,6 +845,9 @@ References::). exit (u.c[sizeof (long) - 1] == 1); } + You can add 'printf("long %d\n", sizeof(long));' to see the size of +the 'long' data type. + File: web2c.info, Node: Editor invocation, Next: \input filenames, Prev: Memory dumps, Up: Three programs @@ -865,8 +885,8 @@ notation; here we are concerned only with the primitive operation.) As (allowed) extensions to standard TeX, Web2c also supports specifying the filename in double quotes ('"some name"') and in braces -('{"some name"}'), which is convenient for filenames containing spaces -or other special characters, as described in the sections below. +('{some name}'), which is convenient for filenames containing spaces or +other special characters, as described in the sections below. In all cases, space tokens are ignored after the filename is read. @@ -1044,7 +1064,7 @@ a security hole vulnerable to Trojan horse attack: an unwitting user could run a TeX program that overwrites, say, '~/.rhosts'. (MetaPost has a 'write' primitive with similar implications). To alleviate this and similar problems the functions 'kpathsea_out_name_ok' and -'kpathsea_in_name_ok' from the Kpathse library (*note (kpathsea)Calling +'kpathsea_in_name_ok' from the Kpathsea library (*note (kpathsea)Calling sequence::) are used to determine if a given filename is acceptable to be opened for output or input, depending on the setting of the configuration variables 'openout_any' and 'openin_any': 'a' (for "any", @@ -1501,8 +1521,8 @@ is written to the file OUTPUT. In addition, Patgen prompts interactively for other values. - For more information, see 'Word hy-phen-a-tion by com-puter' by Frank -Liang (*note References::), and also the 'patgen.web' source file. + For more information, see 'Word hy-phen-a-tion by com-put-er' by +Frank Liang (*note References::), and also the 'patgen.web' source file. The only options are '-help' and '-version' (*note Common options::). @@ -1606,8 +1626,18 @@ File: web2c.info, Node: TeX extensions, Prev: IPC and TeX, Up: TeX 5.7 Extended TeX engines ======================== -The base TeX program has been extended in many ways. Here's a partial -list. +The base TeX program has been extended in many ways. + + There has been a substantial effort to make a set of extended +functionality available across all actively-updated engines, so that +formats, notably LaTeX, can rely on it. A list of this common extended +functionality is in a 'LaTeX News' article, +<https://www.latex-project.org/news/latex2e-news/ltnews31.pdf>. For +engines in TeX Live, the detailed documentation for these primitives is +mostly in the pdfTeX manual (<http://pdftex.org>). + + In addition, each engine (naturally) has its own particular features, +described in its own manual. Here's a partial list of the engines. e-TeX Adds many new primitives, including right-to-left typesetting and @@ -1615,11 +1645,11 @@ e-TeX <https://ctan.org/pkg/etex>. Aleph - This adds Unicode support, right-to-left typesetting, and more. - Omega was the original program. Aleph is an updated version with a - variety of bug fixes, and includes e-TeX. Aleph is not actively - maintained. More info: <https://ctan.org/pkg/aleph>, - <https://ctan.org/pkg/omega>. + This adds Unicode support, right-to-left typesetting, and more, + based on the Omega engine, with the e-TeX and other extensions. + Aleph is maintained only for serious bug fixes and does not include + the common functionality mentioned above. More info: + <https://ctan.org/pkg/aleph>, <https://ctan.org/pkg/omega>. pdfTeX Can produce PDF as well as DVI files. It also incorporates the @@ -1642,6 +1672,11 @@ XeTeX with the exception of the font expansion part of micro-typography. Home page: <https://tug.org/xetex>. +hiTeX + Outputs its own HINT format, which is designed for reading + technical documents on mobile devices. More info: + <https://ctan.org/pkg/hitex>. + pTeX upTeX With additional support for Japanese; pTeX was the original engine, @@ -2168,7 +2203,7 @@ generates a MetaPost picture expression corresponding to TEX-INPUT. simply passes the TEX-INPUT through to TeX. For example, if you are using LaTeX, your MetaPost input file must start with a 'verbatimtex' block that gives the necessary '\documentclass' (or '\documentstyle') -'\begin{document}' command. You will also need to set the enviroment +'\begin{document}' command. You will also need to set the environment variable 'TEX' to 'latex'. TEX-INPUT need not be specifically TeX input; it could also be Troff. @@ -2197,11 +2232,11 @@ standard PostScript fonts. MetaPost reads the same 'psfonts.map' file as Dvips, to determine PostScript fonts that need to be downloaded (*note (dvips)psfonts.map::). - It is posible for pdfTeX to read MetaPost output directly; this is in -contrast to general EPSF files, which have to be converted for use with -PDF output. The easiest way is to name the MetaPost output files with -the '.mps' extension. Then the LaTeX '\includegraphics' command, for -example, will be able to read them, even when outputting PDF. + It is possible for pdfTeX to read MetaPost output directly; this is +in contrast to general EPSF files, which have to be converted for use +with PDF output. The easiest way is to name the MetaPost output files +with the '.mps' extension. Then the LaTeX '\includegraphics' command, +for example, will be able to read them, even when outputting PDF. MetaPost can write output files, via the 'write' primitive; this opens a security hole. *Note tex invocation::. @@ -2460,7 +2495,7 @@ semicolons when this can be done conveniently. '-uppercase' These options specify the case of identifiers in the output of tangle. If '-uppercase' ('-lowercase') is specified, tangle will - convert all identfiers to uppercase (lowercase). The default is + convert all identifiers to uppercase (lowercase). The default is '-mixedcase', which specifies that the case will not be changed. '-underline' @@ -2774,7 +2809,7 @@ File: web2c.info, Node: Font file formats, Next: gftopk invocation, Up: Font 11.1 Font file formats ====================== -(For another perspective on this, *note (dvips)Font concepts::). +For another perspective on this, *note (dvips)Font concepts::. Font files come in several varieties, with suffixes like: .tfm .*pk .*gf .*pxl (obsolete) .pl .mf .vf .vpl @@ -3002,7 +3037,7 @@ not an extension; no '.' precedes it: for instance, 'cmr10.600gf'. '-mnemonics' Translate all commands in the GF file. - As an example of the output, here is the (abrdiged) translation of + As an example of the output, here is the (abridged) translation of the letter 'K' in 'cmr10', as rendered at 600dpi with the mode 'ljfour' from 'modes.mf' (available from <ftp://ftp.tug.org/tex/modes.mf>), with both '-mnemonics' and '-images' enabled. @@ -3370,7 +3405,7 @@ development request rather than a legal requirement. MLTeX, pdfTeX, LuaTeX, XeTeX, and all the other derived engines have used various license terms for their additions to the base code, often -the GPL (see <https://www.gnu.org/licenses/#GPL> or (for example) the +the GPL (see <https://www.gnu.org/licenses/#GPL>) or (for example) the file 'web2c/pdftexdir/COPYINGv2'. They also mostly make use of additional libraries with their own (compatible) terms. Please see each program's sources. @@ -3472,7 +3507,7 @@ Appendix B References User's Guide and Reference Manual'. Addison-Wesley, Reading, MA, USA, second edition, 1994. Reprinted with corrections, 1996. - 24. [Lia83] Franklin Mark Liang. Word hy-phen-a-tion by com-pu-ter. + 24. [Lia83] Franklin Mark Liang. Word hy-phen-a-tion by com-put-er. Technical Report STAN-CS-83-977, Stanford University, August 1983. <https://tug.org/docs/liang/liang-thesis.pdf>. @@ -3503,7 +3538,7 @@ Index * - starts option names: Option conventions. (line 11) * -- starts option names: Option conventions. (line 11) * --disable-dump-share configure option: Hardware and memory dumps. - (line 6) + (line 17) * --disable-mf-nowin: Online Metafont graphics. (line 65) * --enable-epsfwin: Online Metafont graphics. @@ -3535,7 +3570,7 @@ Index * -base=BASE: Determining the memory dump to use. (line 15) * -base=DUMPNAME: Common options. (line 39) -* -change=CHFILE: mft invocation. (line 63) +* -change=CHFILE: mft invocation. (line 62) * -charcode-format=TYPE: tftopl invocation. (line 27) * -charcode-format=TYPE <1>: vftovp invocation. (line 30) * -cnf-line: Common options. (line 25) @@ -3597,7 +3632,7 @@ Index * -shell-restricted: tex invocation. (line 122) * -show-opcodes: dvitype invocation. (line 52) * -strict: tangle invocation. (line 46) -* -style=MFTFILE: mft invocation. (line 67) +* -style=MFTFILE: mft invocation. (line 66) * -T: mpost invocation. (line 111) * -terse: bibtex invocation. (line 28) * -tex=TEXPROGRAM: mpost invocation. (line 114) @@ -3630,6 +3665,10 @@ Index * .Xresources: Online Metafont graphics. (line 69) * 2602gf: mf invocation. (line 48) +* 32-bit architecture: Hardware and memory dumps. + (line 6) +* 64-bit architecture: Hardware and memory dumps. + (line 6) * 8 bit clean: Common options. (line 110) * 8 bit clean output, specifying: Common options. (line 110) * 8-bit characters: TCX files. (line 6) @@ -3668,7 +3707,7 @@ Index (line 16) * accented character: TCX files. (line 6) * accents, hyphenating words with: MLTeX. (line 6) -* acknowledgements: Introduction. (line 54) +* acknowledgements: Introduction. (line 63) * acm.bst: Basic BibTeX style files. (line 19) * Ada, WEB for: WEB. (line 12) @@ -3679,7 +3718,7 @@ Index (line 12) * afmtopl: Font utilities available elsewhere. (line 12) -* Aleph: TeX extensions. (line 15) +* Aleph: TeX extensions. (line 25) * aliases for fonts: Path searching. (line 14) * alpha.bst: Basic BibTeX style files. (line 22) @@ -3712,7 +3751,7 @@ Index (line 15) * beamer, package: Formats. (line 57) * beginfig: mpost invocation. (line 31) -* Berry, Karl: Introduction. (line 43) +* Berry, Karl: Introduction. (line 44) * BIBINPUTS, search path for bib files: bibtex invocation. (line 18) * bibliographies, creating: BibTeX. (line 6) * bibliography: References. (line 6) @@ -3739,11 +3778,11 @@ Index * byte position: pktype invocation. (line 40) * byte position <1>: gftype invocation. (line 76) * byte swapping: Hardware and memory dumps. - (line 13) + (line 17) * c-sources Makefile target: Additional targets. (line 12) * caveats for \input filenames: \input filename caveats. (line 6) -* change files, and MFT: mft invocation. (line 63) +* change files, and MFT: mft invocation. (line 62) * change files, and Tangle: tangle invocation. (line 11) * change files, and Weave: weave invocation. (line 14) * changing error messages style: Common options. (line 31) @@ -3763,7 +3802,7 @@ Index (line 69) * cm.base: Initial Metafont. (line 26) * cmbase.mf: Initial Metafont. (line 26) -* cmbase.mft: mft invocation. (line 73) +* cmbase.mft: mft invocation. (line 72) * cmmf.base not recommended: Initial Metafont. (line 26) * color, in DVItoMP: dvitomp invocation. (line 15) * comments, in TCX files: TCX files. (line 70) @@ -3776,7 +3815,7 @@ Index (line 6) * Computer Modern fonts, and Troff: mpost invocation. (line 61) * Computer Modern macros: Initial Metafont. (line 26) -* Computer Modern Typefaces, production of: mft invocation. (line 73) +* Computer Modern Typefaces, production of: mft invocation. (line 72) * configuration: Installation. (line 6) * configuration file reading: Path searching. (line 6) * configuration file values: Runtime options. (line 6) @@ -3798,15 +3837,16 @@ Index * Cork encoding and ISO input: TCX files. (line 48) * creating memory dumps: Creating memory dumps. (line 6) +* cross-engine functionality: TeX extensions. (line 8) * cross-referenced bibliography items: bibtex invocation. (line 31) * cross-references, omitting: weave invocation. (line 22) * current directory, used for output: Output file location. (line 6) -* Curtis, Pavel: Introduction. (line 43) +* Curtis, Pavel: Introduction. (line 44) * Cweb: WEB. (line 12) * CWEB: WEB. (line 12) * date and time, in memory dumps: Hardware and memory dumps. - (line 30) + (line 35) * debugging DVI utilities: dvitype invocation. (line 52) * debugging flags, specifying: Common options. (line 64) * decimal character codes, in TCX files: TCX files. (line 77) @@ -3847,8 +3887,8 @@ Index * dynamic packing variable: pktype invocation. (line 44) * e response at error prompt: Editor invocation. (line 6) * e-circumflex: \charsubdef. (line 20) -* e-TeX: TeX extensions. (line 10) -* e.mft: mft invocation. (line 73) +* e-TeX: TeX extensions. (line 20) +* e.mft: mft invocation. (line 72) * EC fonts: tex invocation. (line 41) * EC fonts <1>: mf invocation. (line 24) * editing of bitmap fonts: Font utilities available elsewhere. @@ -3863,14 +3903,14 @@ Index * Eplain: Formats. (line 50) * epsf: Online Metafont graphics. (line 19) -* epTeX: TeX extensions. (line 51) +* epTeX: TeX extensions. (line 66) * errors, editor invoked at: Editor invocation. (line 6) * escapement, horizontal: pktype invocation. (line 57) * escapement, horizontal <1>: gftype invocation. (line 106) * escapement, vertical: gftype invocation. (line 106) * etex for MetaPost labels: mpost invocation. (line 44) -* etex is pdfTeX: TeX extensions. (line 22) -* eupTeX: TeX extensions. (line 51) +* etex is pdfTeX: TeX extensions. (line 32) +* eupTeX: TeX extensions. (line 66) * executables, shared initial and virgin: Initial and virgin. (line 6) * exit status, of shell escape: Shell escapes. (line 34) * expanded plain format: Formats. (line 50) @@ -3897,7 +3937,7 @@ Index * floating-point arithmetic: Compile-time options. (line 21) * floating-point values: Hardware and memory dumps. - (line 22) + (line 27) * fmt file, determining: Determining the memory dump to use. (line 6) * fmt files: Initial TeX. (line 6) @@ -3924,7 +3964,7 @@ Index * fraction routines: Compile-time options. (line 21) * Free Software Foundation documentation system: Formats. (line 43) -* freedom of Web2c: Introduction. (line 23) +* freedom of Web2c: Introduction. (line 24) * ftp.math.utah.edu: bibtex invocation. (line 58) * generating source specials: tex invocation. (line 134) * geometric designs: Metafont. (line 6) @@ -3945,7 +3985,7 @@ Index * gftype GF validation: gftype invocation. (line 6) * gftype.web: Font utilities. (line 11) * glue ratio representations: Hardware and memory dumps. - (line 22) + (line 27) * glue, memory for: Runtime options. (line 20) * glyph substitutions: MLTeX. (line 6) * gray font: gftodvi invocation. (line 29) @@ -3955,7 +3995,7 @@ Index * gsftopk: Font utilities available elsewhere. (line 35) * Harbison, Samuel P.: Hardware and memory dumps. - (line 34) + (line 39) * hardware and memory dumps: Hardware and memory dumps. (line 6) * headerbyte information: tftopl invocation. (line 95) @@ -3964,7 +4004,9 @@ Index * Herberts, Mathias: Online Metafont graphics. (line 20) * hex character codes, in TCX files: TCX files. (line 77) -* history: Introduction. (line 43) +* HINT (Hint Is Not TeX): TeX extensions. (line 53) +* history: Introduction. (line 44) +* hiTeX: TeX extensions. (line 53) * Hobby, John: Introduction. (line 9) * horizontal escapement: pktype invocation. (line 57) * horizontal escapement <1>: gftype invocation. (line 106) @@ -3977,11 +4019,11 @@ Index * human-readable text, converting PK to: pktype invocation. (line 6) * human-readable text, converting TFM to: tftopl invocation. (line 6) * human-readable text, converting VF to: vftovp invocation. (line 6) -* hypertext: TeX extensions. (line 22) +* hypertext: TeX extensions. (line 32) * hyphenation and languages: Languages and hyphenation. (line 6) * hyphenation patterns, creating: patgen invocation. (line 6) -* ice cream: Introduction. (line 23) +* ice cream: Introduction. (line 24) * identifier case: tangle invocation. (line 35) * identifier collisions: tangle invocation. (line 46) * identifier length: tangle invocation. (line 27) @@ -4030,7 +4072,7 @@ Index * left side bearing <1>: gftype invocation. (line 82) * legalisms: Legalisms. (line 6) * libsigsegv library: Runtime options. (line 33) -* licensing terms: Introduction. (line 23) +* licensing terms: Introduction. (line 24) * LIG property: tftopl invocation. (line 101) * ligature table, in TFM files: tftopl invocation. (line 101) * LIGTABLE property: tftopl invocation. (line 101) @@ -4042,8 +4084,10 @@ Index (line 6) * location of texmf.cnf in TeX Live: Runtime options. (line 56) * log file, BibTeX: bibtex invocation. (line 14) -* Lua: TeX extensions. (line 30) -* LuaTeX: TeX extensions. (line 30) +* long data type, size of: Hardware and memory dumps. + (line 6) +* Lua: TeX extensions. (line 40) +* LuaTeX: TeX extensions. (line 40) * machine dependencies: Hardware and memory dumps. (line 6) * machine-readable, converting property lists to: pltotf invocation. @@ -4058,7 +4102,7 @@ Index * magnification <1>: dvitype invocation. (line 28) * main_memory: Runtime options. (line 15) * Make targets, additional: Additional targets. (line 6) -* Martin, Rick: Introduction. (line 54) +* Martin, Rick: Introduction. (line 63) * Mathematical Reviews: Formats. (line 35) * mathematical typesetting: TeX. (line 6) * mem file, determining: Determining the memory dump to use. @@ -4071,7 +4115,7 @@ Index * memory dumps and hardware: Hardware and memory dumps. (line 6) * memory dumps, contain date and time: Hardware and memory dumps. - (line 30) + (line 35) * memory dumps, creating: Creating memory dumps. (line 6) * mems Make target: Additional targets. (line 34) @@ -4096,7 +4140,7 @@ Index (line 15) * MetaPost input files: mpost invocation. (line 26) * MetaPost invocation: mpost invocation. (line 6) -* MetaPost source, prettyprinting: mft invocation. (line 79) +* MetaPost source, prettyprinting: mft invocation. (line 77) * MetaPost, initial: Initial MetaPost. (line 6) * MetaPost, TeX, and Metafont: Three programs. (line 6) * metatype1: Font utilities available elsewhere. @@ -4112,7 +4156,7 @@ Index * MFTERM: Online Metafont graphics. (line 11) * mftmac.tex: mft invocation. (line 6) -* micro-typography: TeX extensions. (line 22) +* micro-typography: TeX extensions. (line 32) * mktexmf, disabling: mf invocation. (line 24) * mktextfM, disabling: tex invocation. (line 41) * mltex: MLTeX. (line 6) @@ -4123,8 +4167,8 @@ Index * mode_def: Modes. (line 15) * mode_setup: Modes. (line 15) * modifying texmf.cnf in TeX Live: Runtime options. (line 56) -* Morgan, Tim: Introduction. (line 43) -* Morris, Bob: Introduction. (line 54) +* Morgan, Tim: Introduction. (line 44) +* Morris, Bob: Introduction. (line 63) * MPEDIT: Editor invocation. (line 10) * mpgraph.pdf: mpost invocation. (line 14) * mpman.pdf: mpost invocation. (line 6) @@ -4154,11 +4198,11 @@ Index (line 12) * octal character codes, in TCX files: TCX files. (line 77) * offset for overflow labels: gftodvi invocation. (line 59) -* Omega: TeX extensions. (line 15) +* Omega: TeX extensions. (line 25) * online Metafont graphics: Online Metafont graphics. (line 6) * opcodes, showing DVI: dvitype invocation. (line 52) -* OpenType support: TeX extensions. (line 30) +* OpenType support: TeX extensions. (line 40) * optical font scaling: Font file formats. (line 21) * option conventions: Option conventions. (line 6) * origin: pktype invocation. (line 66) @@ -4179,9 +4223,9 @@ Index * patgen: patgen invocation. (line 6) * path searching: Path searching. (line 6) * path searching debugging: Common options. (line 64) -* PDF: TeX extensions. (line 22) +* PDF: TeX extensions. (line 32) * PDF, and .mps files: mpost invocation. (line 82) -* pdfTeX: TeX extensions. (line 22) +* pdfTeX: TeX extensions. (line 32) * permissions, legal: Legalisms. (line 6) * PFA and PFB conversion: Font utilities available elsewhere. (line 39) @@ -4213,7 +4257,7 @@ Index * plain.bst: Basic BibTeX style files. (line 11) * plain.fmt: Initial TeX. (line 13) -* plain.mft: mft invocation. (line 67) +* plain.mft: mft invocation. (line 66) * pltotf: pltotf invocation. (line 6) * pool file, writing: tangle invocation. (line 16) * Poole, Simon: Online Metafont graphics. @@ -4233,7 +4277,7 @@ Index * predefined macros and memory dumps: Memory dumps. (line 6) * prettyprinting Metafont source: mft invocation. (line 6) * prettyprinting WEB programs: weave invocation. (line 6) -* primitives, new: TeX extensions. (line 10) +* primitives, new: TeX extensions. (line 20) * printable characters, specifying: TCX files. (line 87) * printer characteristics, for Metafont: Modes. (line 6) * production use: Initial and virgin. (line 15) @@ -4252,14 +4296,14 @@ Index * ps2pk: Font utilities available elsewhere. (line 35) * psfonts.map, read by MetaPost: mpost invocation. (line 76) -* pTeX: TeX extensions. (line 44) +* pTeX: TeX extensions. (line 59) * PXL files, explained: Font file formats. (line 39) * pxtoch: Font utilities available elsewhere. (line 23) * quoted filename for \input: \input quoted filename. (line 6) * Raichle, Bernd: MLTeX. (line 6) -* reading, additional: Introduction. (line 62) +* reading, additional: Introduction. (line 71) * readonly directory, running TeX in: Output file location. (line 15) * readonly directory, running TeX in <1>: Output file location. @@ -4279,7 +4323,7 @@ Index * restricted shell escapes: Shell escapes. (line 6) * right side bearing: pktype invocation. (line 66) * right side bearing <1>: gftype invocation. (line 82) -* Rokicki, Tomas: Introduction. (line 43) +* Rokicki, Tomas: Introduction. (line 44) * run length encoded bitmaps: pktype invocation. (line 76) * run length encoded bitmaps <1>: gftype invocation. (line 89) * runtime options: Runtime options. (line 6) @@ -4311,18 +4355,18 @@ Index * sockets: IPC and TeX. (line 6) * space-terminated filenames: \input filenames. (line 10) * Spiderweb: WEB. (line 12) -* Stallman, Richard: Introduction. (line 54) +* Stallman, Richard: Introduction. (line 63) * starting page: dvicopy invocation. (line 28) * starting page <1>: dvitype invocation. (line 46) * Steele Jr., Guy L.: Hardware and memory dumps. - (line 34) + (line 39) * stopping at the first error: Common options. (line 46) -* strategy, overall: Introduction. (line 17) +* strategy, overall: Introduction. (line 18) * string numbers, displaying: pooltype invocation. (line 6) * string pool, writing: tangle invocation. (line 16) * string representation: pooltype invocation. (line 30) * style design, for BibTeX: bibtex invocation. (line 49) -* style files: mft invocation. (line 67) +* style files: mft invocation. (line 66) * substitutions of font glyphs: MLTeX. (line 6) * sun: Online Metafont graphics. (line 42) @@ -4334,11 +4378,11 @@ Index (line 43) * swap space, as array limit: Runtime options. (line 45) * swapping bytes: Hardware and memory dumps. - (line 13) + (line 17) * syntax of TCX files: TCX files. (line 65) * system C library function: Shell escapes. (line 6) * system command: Shell escapes. (line 6) -* system fonts, using: TeX extensions. (line 30) +* system fonts, using: TeX extensions. (line 40) * T1 encoding and ISO input: TCX files. (line 48) * tabs, and \input filenames: \input filename caveats. (line 6) @@ -4357,6 +4401,7 @@ Index (line 11) * terminator for filenames: \input filenames. (line 10) * terse output: bibtex invocation. (line 28) +* teTeX distribution: Introduction. (line 56) * tex: tex invocation. (line 6) * TeX, bibliographies for: bibtex invocation. (line 58) * TeX, creating from Metafont: mft invocation. (line 6) @@ -4395,19 +4440,21 @@ Index * tftopl: tftopl invocation. (line 6) * three programs: Three programs. (line 6) * time and date, in memory dumps: Hardware and memory dumps. - (line 30) + (line 35) * title font: gftodvi invocation. (line 33) +* tl-check-fmtshare: Hardware and memory dumps. + (line 12) * tokenization, and \input filenames: \input filename caveats. (line 6) * toolkits, X: Online Metafont graphics. (line 59) * torture tests: Triptrap. (line 6) * translation file for TeX, specifying: Common options. (line 103) -* translation from WEB to C: Introduction. (line 17) +* translation from WEB to C: Introduction. (line 18) * trap Make target: Additional targets. (line 41) * trap test: Triptrap. (line 6) * trapman.tex: Triptrap. (line 6) -* Trickey, Howard: Introduction. (line 43) +* Trickey, Howard: Introduction. (line 44) * trip Make target: Additional targets. (line 41) * trip test: Triptrap. (line 6) * tripman.tex: Triptrap. (line 6) @@ -4416,7 +4463,7 @@ Index * troff, supported in MetaPost: MetaPost. (line 12) * Troff, WEB for: WEB. (line 12) * Trojan horses and TeX programs: tex invocation. (line 48) -* TrueType support: TeX extensions. (line 30) +* TrueType support: TeX extensions. (line 40) * TUGboat bibliography: bibtex invocation. (line 58) * Type 1 conversion: Font utilities available elsewhere. (line 39) @@ -4427,16 +4474,16 @@ Index * type programs, pool: pooltype invocation. (line 6) * typeface families: Metafont. (line 6) * typesetting: TeX. (line 6) -* Unicode: TeX extensions. (line 15) +* Unicode: TeX extensions. (line 25) * Unicode input: tex invocation. (line 86) -* Unicode input, native: TeX extensions. (line 37) +* Unicode input, native: TeX extensions. (line 47) * uniterm: Online Metafont graphics. (line 50) * unsrt.bst: Basic BibTeX style files. (line 39) -* upTeX: TeX extensions. (line 44) +* upTeX: TeX extensions. (line 59) * UTF-8 input: tex invocation. (line 86) -* UTF-8 input, native: TeX extensions. (line 30) +* UTF-8 input, native: TeX extensions. (line 40) * validation, of DVI files: dvitype invocation. (line 6) * validation, of GF files: gftype invocation. (line 6) * validation, of PK files: pktype invocation. (line 6) @@ -4462,7 +4509,7 @@ Index * WEB programs, compiling: tangle invocation. (line 6) * WEB programs, typesetting: weave invocation. (line 6) * WEB2C, search path for TCX files: TCX files. (line 35) -* Weber, Olaf: Introduction. (line 43) +* Weber, Olaf: Introduction. (line 44) * webmac.tex: weave invocation. (line 22) * webman.tex: WEB. (line 12) * whitespace, in TCX files: TCX files. (line 68) @@ -4485,7 +4532,7 @@ Index * xampl.bib: bibtex invocation. (line 55) * xbfe, bitmap font editor: Font utilities available elsewhere. (line 23) -* XeTeX: TeX extensions. (line 37) +* XeTeX: TeX extensions. (line 47) * xfed, bitmap font editor: Font utilities available elsewhere. (line 23) * xfedor, bitmap font editor: Font utilities available elsewhere. @@ -4506,78 +4553,78 @@ Index Tag Table: Node: Top2759 -Node: Introduction3834 -Node: Installation7174 -Node: configure options9218 -Node: Compile-time options11240 -Node: Additional targets12342 -Node: Triptrap13619 -Node: Commonalities15122 -Node: Option conventions15655 -Node: Common options16878 -Node: Path searching21496 -Node: Output file location22468 -Node: Three programs23770 -Node: Runtime options24477 -Node: Initial and virgin27618 -Node: Memory dumps28567 -Node: Creating memory dumps29019 -Node: Determining the memory dump to use30226 -Node: Hardware and memory dumps31803 -Node: Editor invocation34249 -Node: \input filenames35112 -Node: \input quoted filename36665 -Node: \input braced filename37442 -Node: \input filename caveats38372 -Node: TeX39886 -Node: tex invocation41054 -Node: Initial TeX48039 -Node: Formats49403 -Node: Languages and hyphenation52220 -Node: MLTeX52650 -Node: \charsubdef54278 -Node: \tracingcharsubdef56601 -Node: TCX files57176 -Node: patgen invocation62616 -Node: Shell escapes63322 -Node: IPC and TeX66902 -Node: TeX extensions67472 -Node: Metafont69501 -Node: mf invocation70789 -Node: Initial Metafont74626 -Node: Modes76256 -Node: Online Metafont graphics78506 -Node: gftodvi invocation81931 -Node: mft invocation84751 -Node: MetaPost88749 -Node: mpost invocation89585 -Node: Initial MetaPost94619 -Node: dvitomp invocation95541 -Node: BibTeX96206 -Node: bibtex invocation96567 -Node: Basic BibTeX style files99041 -Node: WEB100371 -Node: tangle invocation101580 -Node: weave invocation103703 -Node: pooltype invocation105110 -Node: DVI utilities106240 -Node: dvicopy invocation107174 -Node: dvitype invocation108459 -Node: dvitype output example110790 -Node: Font utilities113843 -Node: Font file formats115023 -Node: gftopk invocation118292 -Node: pktogf invocation119483 -Node: pktype invocation120649 -Node: gftype invocation123472 -Node: tftopl invocation127975 -Node: pltotf invocation132568 -Node: vftovp invocation133619 -Node: vptovf invocation135854 -Node: Font utilities available elsewhere136881 -Node: Legalisms139086 -Node: References140532 -Node: Index144665 +Node: Introduction3833 +Node: Installation7591 +Node: configure options9635 +Node: Compile-time options11657 +Node: Additional targets12759 +Node: Triptrap14036 +Node: Commonalities15539 +Node: Option conventions16196 +Node: Common options17419 +Node: Path searching22037 +Node: Output file location23009 +Node: Three programs24311 +Node: Runtime options25018 +Node: Initial and virgin28159 +Node: Memory dumps29108 +Node: Creating memory dumps29560 +Node: Determining the memory dump to use30767 +Node: Hardware and memory dumps32344 +Node: Editor invocation35094 +Node: \input filenames35957 +Node: \input quoted filename37508 +Node: \input braced filename38285 +Node: \input filename caveats39215 +Node: TeX40729 +Node: tex invocation41897 +Node: Initial TeX48883 +Node: Formats50247 +Node: Languages and hyphenation53064 +Node: MLTeX53494 +Node: \charsubdef55122 +Node: \tracingcharsubdef57445 +Node: TCX files58020 +Node: patgen invocation63460 +Node: Shell escapes64167 +Node: IPC and TeX67747 +Node: TeX extensions68317 +Node: Metafont71098 +Node: mf invocation72386 +Node: Initial Metafont76223 +Node: Modes77853 +Node: Online Metafont graphics80103 +Node: gftodvi invocation83528 +Node: mft invocation86348 +Node: MetaPost90346 +Node: mpost invocation91182 +Node: Initial MetaPost96218 +Node: dvitomp invocation97140 +Node: BibTeX97805 +Node: bibtex invocation98166 +Node: Basic BibTeX style files100640 +Node: WEB101970 +Node: tangle invocation103179 +Node: weave invocation105303 +Node: pooltype invocation106710 +Node: DVI utilities107840 +Node: dvicopy invocation108774 +Node: dvitype invocation110059 +Node: dvitype output example112390 +Node: Font utilities115443 +Node: Font file formats116623 +Node: gftopk invocation119890 +Node: pktogf invocation121081 +Node: pktype invocation122247 +Node: gftype invocation125070 +Node: tftopl invocation129573 +Node: pltotf invocation134166 +Node: vftovp invocation135217 +Node: vptovf invocation137452 +Node: Font utilities available elsewhere138479 +Node: Legalisms140684 +Node: References142131 +Node: Index146264 End Tag Table diff --git a/Master/texmf-dist/doc/kpathsea/kpathsea.html b/Master/texmf-dist/doc/kpathsea/kpathsea.html index 883cc129293..807fa6091a9 100644 --- a/Master/texmf-dist/doc/kpathsea/kpathsea.html +++ b/Master/texmf-dist/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/Master/texmf-dist/doc/kpathsea/kpathsea.pdf b/Master/texmf-dist/doc/kpathsea/kpathsea.pdf Binary files differindex 1ff6d90fb8c..a189490124a 100644 --- a/Master/texmf-dist/doc/kpathsea/kpathsea.pdf +++ b/Master/texmf-dist/doc/kpathsea/kpathsea.pdf diff --git a/Master/texmf-dist/doc/man/man1/aleph.1 b/Master/texmf-dist/doc/man/man1/aleph.1 index 4cf85a75ac7..9716cadf37d 100644 --- a/Master/texmf-dist/doc/man/man1/aleph.1 +++ b/Master/texmf-dist/doc/man/man1/aleph.1 @@ -1,4 +1,4 @@ -.TH ALEPH 1 "6 August 2019" "Web2C 2021" +.TH ALEPH 1 "6 August 2019" "Web2C 2022" .\"===================================================================== .if n .ds MF Metafont .if t .ds MF Metafont diff --git a/Master/texmf-dist/doc/man/man1/aleph.man1.pdf b/Master/texmf-dist/doc/man/man1/aleph.man1.pdf Binary files differindex b6ed550bb87..1e1a79a7906 100644 --- a/Master/texmf-dist/doc/man/man1/aleph.man1.pdf +++ b/Master/texmf-dist/doc/man/man1/aleph.man1.pdf diff --git a/Master/texmf-dist/doc/man/man1/amstex.1 b/Master/texmf-dist/doc/man/man1/amstex.1 index ce0d9df4bc5..5c819f2e5ce 100644 --- a/Master/texmf-dist/doc/man/man1/amstex.1 +++ b/Master/texmf-dist/doc/man/man1/amstex.1 @@ -1,4 +1,4 @@ -.TH AMSTEX 1 "16 June 2015" "Web2C 2021" +.TH AMSTEX 1 "16 June 2015" "Web2C 2022" .\"===================================================================== .if t .ds TX \fRT\\h'-0.1667m'\\v'0.20v'E\\v'-0.20v'\\h'-0.125m'X\fP .if n .ds TX TeX diff --git a/Master/texmf-dist/doc/man/man1/amstex.man1.pdf b/Master/texmf-dist/doc/man/man1/amstex.man1.pdf Binary files differindex 1caea37b8eb..2a9cb009fa3 100644 --- a/Master/texmf-dist/doc/man/man1/amstex.man1.pdf +++ b/Master/texmf-dist/doc/man/man1/amstex.man1.pdf diff --git a/Master/texmf-dist/doc/man/man1/bbox.1 b/Master/texmf-dist/doc/man/man1/bbox.1 index 64696f32645..f2454a833d7 100644 --- a/Master/texmf-dist/doc/man/man1/bbox.1 +++ b/Master/texmf-dist/doc/man/man1/bbox.1 @@ -3,7 +3,7 @@ .\" <http://shell.ipoline.com/~elmert/comp/docbook2X/> .\" Please send any bug reports, improvements, comments, patches, .\" etc. to Steve Cheng <steve@ggi-project.org>. -.TH "BBOX" "1" "31 August 2010" "" "" +.TH "BBOX" "1" "January 22, 2004" "" "" .SH NAME bbox \- prints out the bounding box of a rawppm or rawpbm image diff --git a/Master/texmf-dist/doc/man/man1/bbox.man1.pdf b/Master/texmf-dist/doc/man/man1/bbox.man1.pdf Binary files differindex f594d61af50..f2f9d8e521b 100644 --- a/Master/texmf-dist/doc/man/man1/bbox.man1.pdf +++ b/Master/texmf-dist/doc/man/man1/bbox.man1.pdf diff --git a/Master/texmf-dist/doc/man/man1/bibtex.1 b/Master/texmf-dist/doc/man/man1/bibtex.1 index baf5de63830..881685ba7c6 100644 --- a/Master/texmf-dist/doc/man/man1/bibtex.1 +++ b/Master/texmf-dist/doc/man/man1/bibtex.1 @@ -1,4 +1,4 @@ -.TH BIBTEX 1 "23 February 2018" "bibtex 0.99d" "Web2C 2021" +.TH BIBTEX 1 "23 February 2018" "bibtex 0.99d" "Web2C 2022" .\"===================================================================== .if t .ds TX \fRT\\h'-0.1667m'\\v'0.20v'E\\v'-0.20v'\\h'-0.125m'X\fP .if n .ds TX TeX diff --git a/Master/texmf-dist/doc/man/man1/bibtex.man1.pdf b/Master/texmf-dist/doc/man/man1/bibtex.man1.pdf Binary files differindex 8e193872f3b..cbaa1fb6cce 100644 --- a/Master/texmf-dist/doc/man/man1/bibtex.man1.pdf +++ b/Master/texmf-dist/doc/man/man1/bibtex.man1.pdf diff --git a/Master/texmf-dist/doc/man/man1/cslatex.man1.pdf b/Master/texmf-dist/doc/man/man1/cslatex.man1.pdf Binary files differindex 9586537ee44..6a1db2ab41d 100644 --- a/Master/texmf-dist/doc/man/man1/cslatex.man1.pdf +++ b/Master/texmf-dist/doc/man/man1/cslatex.man1.pdf diff --git a/Master/texmf-dist/doc/man/man1/ctangle.man1.pdf b/Master/texmf-dist/doc/man/man1/ctangle.man1.pdf Binary files differindex ba90161f78b..7be36f14ebb 100644 --- a/Master/texmf-dist/doc/man/man1/ctangle.man1.pdf +++ b/Master/texmf-dist/doc/man/man1/ctangle.man1.pdf diff --git a/Master/texmf-dist/doc/man/man1/ctie.1 b/Master/texmf-dist/doc/man/man1/ctie.1 index fc79432bc57..4c785af8954 100644 --- a/Master/texmf-dist/doc/man/man1/ctie.1 +++ b/Master/texmf-dist/doc/man/man1/ctie.1 @@ -1,4 +1,4 @@ -.TH CTIE 1 "8 June 2020" "Web2C 2021" +.TH CTIE 1 "8 June 2020" "Web2C 2022" .\"===================================================================== .SH NAME ctie \- merge or apply CWEB change files diff --git a/Master/texmf-dist/doc/man/man1/ctie.man1.pdf b/Master/texmf-dist/doc/man/man1/ctie.man1.pdf Binary files differindex 85dbb228833..d06428a0b31 100644 --- a/Master/texmf-dist/doc/man/man1/ctie.man1.pdf +++ b/Master/texmf-dist/doc/man/man1/ctie.man1.pdf diff --git a/Master/texmf-dist/doc/man/man1/ctwill-refsort.man1.pdf b/Master/texmf-dist/doc/man/man1/ctwill-refsort.man1.pdf Binary files differindex 2a72e80d56a..6b3d412737e 100644 --- a/Master/texmf-dist/doc/man/man1/ctwill-refsort.man1.pdf +++ b/Master/texmf-dist/doc/man/man1/ctwill-refsort.man1.pdf diff --git a/Master/texmf-dist/doc/man/man1/ctwill-twinx.man1.pdf b/Master/texmf-dist/doc/man/man1/ctwill-twinx.man1.pdf Binary files differindex 7d204866356..107956b505d 100644 --- a/Master/texmf-dist/doc/man/man1/ctwill-twinx.man1.pdf +++ b/Master/texmf-dist/doc/man/man1/ctwill-twinx.man1.pdf diff --git a/Master/texmf-dist/doc/man/man1/ctwill.1 b/Master/texmf-dist/doc/man/man1/ctwill.1 index cfac2030f35..069733e6c8b 100644 --- a/Master/texmf-dist/doc/man/man1/ctwill.1 +++ b/Master/texmf-dist/doc/man/man1/ctwill.1 @@ -1,6 +1,20 @@ -.\" Automatically generated by Pandoc 2.11.4 +.\" Automatically generated by Pandoc .\" -.TH "CTWILL" "1" "February 6, 2021" "Web2c 2021" "General Commands Manual" +.\" Define V font for inline verbatim, using C font in formats +.\" that render this, and otherwise B font. +.ie "\f[CB]x\f[]"x" \{\ +. ftr V B +. ftr VI BI +. ftr VB B +. ftr VBI BI +.\} +.el \{\ +. ftr V CR +. ftr VI CI +. ftr VB CB +. ftr VBI CBI +.\} +.TH "CTWILL" "1" "February 5, 2022" "Web2c 2022" "General Commands Manual" .hy .SH NAME .PP @@ -16,8 +30,8 @@ ctwill, ctwill-refsort, ctwill-twinx - translate CWEB to TeX with mini-indexes .PD 0 .P .PD -\f[B]ctwill-twinx\f[R] \f[I]outfile\f[R].tex [\f[I]outfile\f[R].tex \&...] > -index.tex +\f[B]ctwill-twinx\f[R] \f[I]outfile\f[R].tex [\f[I]outfile\f[R].tex \&...] +> index.tex .SH DESCRIPTION .PP The \f[B]ctwill\f[R] program converts a CWEB source document into a @@ -48,7 +62,7 @@ If you just want to change the output file name, but don\[cq]t have a change file to apply, you can use `\f[B]-\f[R]' as the second argument. .PP \f[B]ctwill\f[R] is exactly like \f[B]cweave\f[R] except that it -produces much better documentation, for which you must work harder. +produces much better documentation, for which you must work much harder. You should run \f[B]ctwill\f[R] twice, once to prime the pump and once to get decent answers. Moreover, you must run the output twice through TeX. @@ -60,9 +74,14 @@ Say \f[B]ctwill-refsort < foo.ref > foo.sref\f[R] and then another \f[B]tex foo\f[R] will produce alphabetized output. .PP The \f[B]ctwill-twinx\f[R] program compiles a master index for a set of related -programs that have been processed by \f[B]ctwill\f[R]. +programs that have been processed by \f[B]ctwill\f[R] (\f[I]not\f[R] by +\f[B]cweave\f[R], mind you!). The individual programs should define their names with a line of the form \f[B]\[rs]def\[rs]title{NAME}\f[R]. +For your convenience, \f[B]ctwill-twinx\f[R] grabs the first \[lq]word\[rq] in +\f[B]\[rs]title\f[R] and turns it into uppercase form. +You should adapt file \f[B]twinx-startup.tex\f[R] for the first page of +the master index. .PP The mini-indexes list identifiers that are used but not defined on each two-page spread. @@ -106,13 +125,13 @@ The present incarnation of \f[B]ctwill\f[R] and its utilities tries hard to be a drop-in replacement for the original package. There are, however, a few differences worth noting: .IP \[bu] 2 -This version is based on the most recent version of CWEB (4.2). +This version is based on the most recent version of CWEB (4.7). .IP \[bu] 2 In TeX\ Live the utility programs are prefixed with \f[B]ctwill-\f[R] and the macro files with \f[B]ct\f[R] for technical reasons. .IP \[bu] 2 Options \f[B]--help\f[R], \f[B]--quiet\f[R], \f[B]--verbose\f[R], -\f[B]--version\f[R], and flags \f[B]-i\f[R], \f[B]-o\f[R], \f[B]-t\f[R], +\f[B]--version\f[R], and flags \f[B]+c\f[R], \f[B]-i\f[R], \f[B]-o\f[R], and \f[B]+lX\f[R] are new in CWEBbin and TeX\ Live. .IP \[bu] 2 Option \f[B]+lX\f[R] is accompanied by example wrapper files for @@ -153,6 +172,8 @@ leave out the \f[B]happy message\f[R] (\f[B]-h\f[R]). \f[B]+v\f[R]/\f[B]-v\f[R]: shortcut for \f[B]+bhp\f[R]; also \f[B]--verbose\f[R] .IP \[bu] 2 +\f[B]+c\f[R]: check temporary output for changes +.IP \[bu] 2 \f[B]-e\f[R]: do not enclose C/C++\ material in \f[B]\[rs]PB{\&...}\f[R] .IP \[bu] 2 \f[B]-f\f[R]: do not force a newline after every C/C++\ statement in @@ -162,8 +183,6 @@ output .IP \[bu] 2 \f[B]-o\f[R]: suppress separation of declarations and statements .IP \[bu] 2 -\f[B]-t\f[R]: ignore temporary output irrespective of changes -.IP \[bu] 2 \f[B]-x\f[R]: omit indices, section names, table of contents .IP \[bu] 2 \f[B]+P\f[R]: \f[B]\[rs]input ctproofmac.tex\f[R] instead of @@ -174,6 +193,9 @@ output .IP \[bu] 2 \f[B]+s\f[R]: print usage statistics .IP \[bu] 2 +\f[B]+t\f[R]: treat \f[B]typename\f[R] in a template like +\f[B]typedef\f[R] +.IP \[bu] 2 \f[B]--help\f[R]: display help message and exit .IP \[bu] 2 \f[B]--version\f[R]: output version information and exit @@ -246,7 +268,4 @@ Levy and Knuth. .PD 0 .P .PD -\f[B]ctwill\f[R] and its utilities \f[B]ctwill-refsort\f[R] and \f[B]ctwill-twinx\f[R] -have been fully integrated with the CWEBbin extension that serves as the -basis for CWEB in TeX\ Live; see the project -page (https://github.com/ascherer/cwebbin). +Contemporary development on https://github.com/ascherer/cwebbin. diff --git a/Master/texmf-dist/doc/man/man1/ctwill.man1.pdf b/Master/texmf-dist/doc/man/man1/ctwill.man1.pdf Binary files differindex bde7c827f5c..c840f198676 100644 --- a/Master/texmf-dist/doc/man/man1/ctwill.man1.pdf +++ b/Master/texmf-dist/doc/man/man1/ctwill.man1.pdf diff --git a/Master/texmf-dist/doc/man/man1/cweave.man1.pdf b/Master/texmf-dist/doc/man/man1/cweave.man1.pdf Binary files differindex c762ec19e84..effa9d5569a 100644 --- a/Master/texmf-dist/doc/man/man1/cweave.man1.pdf +++ b/Master/texmf-dist/doc/man/man1/cweave.man1.pdf diff --git a/Master/texmf-dist/doc/man/man1/cweb.1 b/Master/texmf-dist/doc/man/man1/cweb.1 index cf7273f0219..84e17026ac0 100644 --- a/Master/texmf-dist/doc/man/man1/cweb.1 +++ b/Master/texmf-dist/doc/man/man1/cweb.1 @@ -1,6 +1,20 @@ -.\" Automatically generated by Pandoc 2.11.4 +.\" Automatically generated by Pandoc .\" -.TH "CWEB" "1" "September 23, 2020" "Web2c 2021" "General Commands Manual" +.\" Define V font for inline verbatim, using C font in formats +.\" that render this, and otherwise B font. +.ie "\f[CB]x\f[]"x" \{\ +. ftr V B +. ftr VI BI +. ftr VB B +. ftr VBI BI +.\} +.el \{\ +. ftr V CR +. ftr VI CI +. ftr VB CB +. ftr VBI CBI +.\} +.TH "CWEB" "1" "July 27, 2021" "Web2c 2022" "General Commands Manual" .hy .SH NAME .PP @@ -55,7 +69,7 @@ the resulting output. There are, however, a few differences worth noting: .IP \[bu] 2 Options \f[B]--help\f[R], \f[B]--quiet\f[R], \f[B]--verbose\f[R], -\f[B]--version\f[R], and flags \f[B]-i\f[R], \f[B]-o\f[R], \f[B]-t\f[R], +\f[B]--version\f[R], and flags \f[B]+c\f[R], \f[B]-i\f[R], \f[B]-o\f[R], and \f[B]+lX\f[R] are new in CWEBbin and TeX\ Live. .IP \[bu] 2 Option \f[B]+lX\f[R] is accompanied by several wrapper files for @@ -95,15 +109,19 @@ The first batch of options are common to both \f[B]ctangle\f[R] and \f[B]+v\f[R]/\f[B]-v\f[R]: shortcut for \f[B]+bhp\f[R]; also \f[B]--verbose\f[R] .IP \[bu] 2 -\f[B]+s\f[R]: print usage statistics +\f[B]+c\f[R]: check temporary output for changes .IP \[bu] 2 -\f[B]-t\f[R]: ignore temporary output irrespective of changes +\f[B]+s\f[R]: print usage statistics .IP \[bu] 2 \f[B]--help\f[R]: display help message and exit .IP \[bu] 2 \f[B]--version\f[R]: output version information and exit .PP -There are six other options applicable to \f[B]cweave\f[R] only: +There is one other option applicable to \f[B]ctangle\f[R] only: +.IP \[bu] 2 +\f[B]+k\f[R]: keep separators in numeric literals in the output +.PP +There are seven other options applicable to \f[B]cweave\f[R] only: .IP \[bu] 2 \f[B]-e\f[R]: do not enclose C/C++\ material in \f[B]\[rs]PB{\&...}\f[R] .IP \[bu] 2 @@ -118,6 +136,9 @@ output .IP \[bu] 2 \f[B]+lX\f[R]/\f[B]-lX\f[R]: use macros for language \f[I]X\f[R] as of \f[I]X\f[R]\f[B]cwebmac.tex\f[R] +.IP \[bu] 2 +\f[B]+t\f[R]: treat \f[B]typename\f[R] in a template like +\f[B]typedef\f[R] .SH ENVIRONMENT .PP The environment variable CWEBINPUTS is used to search for the input @@ -165,9 +186,11 @@ Don Knuth wrote WEB for TeX and Pascal. Silvio Levy designed and developed CWEB by adapting the WEB conventions to C and by recoding everything in CWEB. Knuth began using CWEB and made further refinements. +.PD 0 +.P +.PD Many other helpers are acknowledged in the CWEB manual. .PD 0 .P .PD -CWEB in TeX\ Live is based on the CWEBbin extension; see the project -page (https://github.com/ascherer/cwebbin). +Contemporary development on https://github.com/ascherer/cweb. diff --git a/Master/texmf-dist/doc/man/man1/cweb.man1.pdf b/Master/texmf-dist/doc/man/man1/cweb.man1.pdf Binary files differindex b025575b8e0..bc7fcf4a041 100644 --- a/Master/texmf-dist/doc/man/man1/cweb.man1.pdf +++ b/Master/texmf-dist/doc/man/man1/cweb.man1.pdf diff --git a/Master/texmf-dist/doc/man/man1/detex.1 b/Master/texmf-dist/doc/man/man1/detex.1 index e152f12f940..d98b5aa3e94 100644 --- a/Master/texmf-dist/doc/man/man1/detex.1 +++ b/Master/texmf-dist/doc/man/man1/detex.1 @@ -1,4 +1,4 @@ -.TH DETEX 1 "12 August 1993" "Purdue University" +.TH DETEX 1 "4 March 2021" "Purdue University" .SH NAME detex \- a filter to strip \fITeX\fP commands from a .tex file. .SH SYNOPSIS @@ -72,7 +72,7 @@ environments. .PP The .B \-r -option tries to naively replace $..$, $$..$$, \(..\) and \[..\] +option tries to naively replace $..$, $$..$$, \\(..\\) and \\[..\\] with nouns and verbs (in particular, "noun" and "verbs") in a way that keeps sentences readable. .PP diff --git a/Master/texmf-dist/doc/man/man1/detex.man1.pdf b/Master/texmf-dist/doc/man/man1/detex.man1.pdf Binary files differindex f037b19ac1e..40c7ff8076a 100644 --- a/Master/texmf-dist/doc/man/man1/detex.man1.pdf +++ b/Master/texmf-dist/doc/man/man1/detex.man1.pdf diff --git a/Master/texmf-dist/doc/man/man1/dt2dv.1 b/Master/texmf-dist/doc/man/man1/dt2dv.1 index 26783c9ecc8..f8556bc882f 100644 --- a/Master/texmf-dist/doc/man/man1/dt2dv.1 +++ b/Master/texmf-dist/doc/man/man1/dt2dv.1 @@ -1,7 +1,10 @@ .\" This file is public domain. .\" Originally written 1995, Geoffrey Tobin. -.\" The author has expressed the hope that any modification will retain enough content to remain useful. He would also appreciate being acknowledged as the original author in the documentation. -.\" This declaration added 2008/11/14 by Clea F. Rees with the permission of Geoffrey Tobin. +.\" The author has expressed the hope that any modification will +.\" retain enough content to remain useful. He would also appreciate being +.\" acknowledged as the original author in the documentation. +.\" This declaration added 2008/11/14 by Clea F. Rees with the +.\" permission of Geoffrey Tobin. .\" ==================================================================== .\" @Troff-man-file{ .\" author = "Nelson H. F. Beebe and Geoffrey R. D. Tobin", @@ -48,8 +51,8 @@ dt2dv \- convert a DTL text representation of a TeX DVI file to a binary DVI fil .RB [ \-group ] .RB [ \-si ] .RB [ \-so ] -.I [input-DTL-file] -.I [output-DVI-file] +.RI [ input-DTL-file ] +.RI [ output-DVI-file ] .PP In the absence of the .B \-si @@ -57,9 +60,9 @@ and .B \-so options, both file arguments are -.IR required +.I required in the order -.B input-DTL-file output-DVI-file . +.BR "input-DTL-file output-DVI-file" . But also see the OPTIONS section below. No default file extensions are supplied. .\"====================================================================== @@ -68,7 +71,8 @@ No default file extensions are supplied. converts a text representation of a \*(Te\& DVI file, usually produced by the companion .BR dv2dt (1) -utility, back to a binary DVI file. DTL +utility, back to a binary DVI file. +DTL .RI ( "DVI Text Language" ) files can be edited, with care, and then restored to DVI form for processing by any \*(Te\& DVI @@ -84,7 +88,7 @@ not well-suited for conversion back to a DVI file. .PP The format of \*(Te\& DVI files is fully described in -Donald E. Knuth, +Donald E.\& Knuth, .IR "\*(Te\&: The Program" , Addison-Wesley (1986), ISBN 0-201-13437-3, as well as in the @@ -147,7 +151,7 @@ Email: <G.Tobin@ee.latrobe.edu.au> These manual pages were written primarily by .RS .nf -Nelson H. F. Beebe, Ph.D. +Nelson H.\& F.\& Beebe, Ph.D. Center for Scientific Computing Department of Mathematics University of Utah diff --git a/Master/texmf-dist/doc/man/man1/dt2dv.man1.pdf b/Master/texmf-dist/doc/man/man1/dt2dv.man1.pdf Binary files differindex c56e86fc383..0482e83d082 100644 --- a/Master/texmf-dist/doc/man/man1/dt2dv.man1.pdf +++ b/Master/texmf-dist/doc/man/man1/dt2dv.man1.pdf diff --git a/Master/texmf-dist/doc/man/man1/dvi2tty.1 b/Master/texmf-dist/doc/man/man1/dvi2tty.1 index 0c3a7da6177..f6c8b1f8f26 100644 --- a/Master/texmf-dist/doc/man/man1/dvi2tty.1 +++ b/Master/texmf-dist/doc/man/man1/dvi2tty.1 @@ -1,12 +1,12 @@ -.TH DVI2TTY 1 "13 November 1990" +.TH DVI2TTY 1 "4 March 2021" .SH NAME -dvi2tty \- preview a TeX DVI\-file on an ordinary ascii terminal +dvi2tty \- preview a TeX DVI file on an ordinary ASCII terminal .SH SYNOPSIS .B dvi2tty -[ options ] dvi\-file +[ options ] dvifile .SH DESCRIPTION .I dvi2tty -converts a TeX DVI\-file to a format that is appropriate for terminals +converts a TeX DVI file to a format that is appropriate for terminals and line printers. The program is intended to be used for preliminary proofreading of TeX-ed documents. By default the output is directed to the terminal, @@ -22,22 +22,22 @@ Since .I dvi2tty produces output for terminals and line printers the representation of documents is naturally quite primitive. -In principle Font Changes are totally ignored, but +In principle font changes are totally ignored, but .I dvi2tty recognizes -a few mathematical and special symbols that can be be displayed on an -ordinary ascii terminal, such as the '+' and '-' symbol. +a few mathematical and special symbols that can be displayed on an +ordinary ASCII terminal, such as the '+' and '-' symbol. .PP If the width of the output text requires more columns than fits -in one line (c.f. the \-w option) it is broken into several lines by +in one line (cf.\& the -w option) it is broken into several lines by .I dvi2tty although they will be printed as one line on regular TeX output -devices (e.g. laser printers). To show that a broken line is really +devices (e.g., laser printers). To show that a broken line is really just one logical line an asterisk (``*'') in the last position means that the logical line is continued on the next physical line output by .I dvi2tty. -Such a continuation line is started with a a space and an asterisk +Such a continuation line is started with a space and an asterisk in the first two columns. .PP Options may be specified in the environment variable DVI2TTY. @@ -47,126 +47,123 @@ environment, will override the one from the environment. .B Options: .PP .TP -.B \-o file +.B -o file Write output to file ``file''. .TP -.B \-p list +.B -p list Print the pages chosen by list. -Numbers refer to TeX\-page numbers (known as \\count0). +Numbers refer to TeX page numbers (known as \ecount0). An example of format for list is ``1,3:6,8'' to choose pages 1, 3 through 6 and 8. Negative numbers can be used exactly as in TeX, -e g \-1 comes before \-4 as in ``\-p\-1:\-4,17''. +e.g., \-1 comes before \-4 as in ``-p-1:-4,17''. .TP -.B \-P list -Like \-p except that page numbers refer to -the sequential ordering of the pages in the dvi\-file. +.B -P list +Like -p except that page numbers refer to +the sequential ordering of the pages in the dvi-file. Negative numbers don't make a lot of sense here... .TP -.B \-w n +.B -w n Specify terminal width .I n. -Legal range 16\-132. +Valid range 16\(en132. Default is 80. If your terminal has the ability to display in 132 columns it might -be a good idea to use \-w132 and toggle the +be a good idea to use -w132 and toggle the terminal into this mode as output will probably look somewhat better. .TP -.B \-v -Specify height of lines. Default value 450000. Allows to adjust linespacing. +.B -v +Specify height of lines. Default value 450000. Allows one to adjust linespacing. .TP -.B \-q +.B -q Don't pipe the output through a pager. This may be the default on some systems (depending on the whims of the person installing the program). .TP -.B \-e n +.B -e n This option can be used to influence the spacing between words. -With a negative value the number of spaces +With a negative value the number of spaces between words becomes less, with a positive value it becomes more. -\-e\-11 seems to worked well. +-e-11 seems to worked well. .TP -.B \-f +.B -f Pipe through a pager, $PAGER if defined, or whatever the installer of the program compiled in (often ``more''). This may be the default, but it is still okay to redirect output with ``>'', the pager will not be used if output is not going to a terminal. .TP -.B \-F +.B -F Specify the pager program to be used. -This overrides the $PAGER and the default pager. +This overrides the $PAGER environment variable and the default pager. .TP -.B \-Fprog +.B -Fprog Use ``prog'' as program to pipe output into. Can be used to choose an -alternate pager (e g ``-Fless''). +alternate pager (e.g., ``-Fless''). .TP -.B \-t -\\tt fonts were used (instead of cm) to produce dvi file. (screen.sty -is a powerfull mean to do that with LaTeX). +.B -t +\\tt fonts were used (instead of cm) to produce the dvi file. .TP -.B \-a +.B -a Dvi2tty normally tries to output accented characters. With the -a option, accented characters are output without the accent sign. .TP -.B \-l +.B -l Mark page breaks with the two-character sequence ``^L''. The default is to mark them with a form-feed character. .TP -.B \-c -Do not attempt to translate any characters (like the Scandinavion/latin1 mode) +.B -c +Do not attempt to translate any characters (like the Scandinavian/latin1 mode) except when running in tt-font. .TP -.B \-u +.B -u Toggle option to process certain latin1 characters. Use this if your output -devices supports latin1 cahracters. +devices supports latin1 characters. Note this may interfere with -s. Best not to use -u and -s together. .TP -.B \-s +.B -s Toggle option to process the special Scandinavian characters that on most (?) -terminals in Scandinavia are mapped to ``{|}[\\]''. +terminals in Scandinavia are mapped to ``{|}[\e]''. Note this may interfere with -u. Best not to use -u and -s together. .TP -.B \-J +.B -J Auto detect NTT JTeX, ASCII pTeX, and upTeX dvi format. .TP -.B \-N +.B -N Display NTT JTeX dvi. .TP -.B \-A +.B -A Display ASCII pTeX dvi. .TP -.B \-U +.B -U Display upTeX dvi. .TP -.B \-Eenc +.B -Eenc Set output Japanese encoding. The enc argument 'e', 's', 'j', and 'u' denotes EUC-JP, Shift_JIS, ISO-2022-JP, and UTF-8, respectively. .TP -.B \-bdelim +.B -bdelim Print the name of fonts when switching to it (and ending it). The delim argument is used to delimit the fontname. .SH FILES -/bin/more \ \ \ \ -probably the default pager. +.nr L1 \w'/bin/more \ \ \ \ ' +/bin/more\h'|\n(L1u'probably the default pager. .SH ENVIRONMENT -PAGER \ \ \ \ \ \ \ \ \ \ \ \ -the pager to use. +.\".nr L1 \w'DVI2TTY ' +PAGER\h'|\n(L1u'the pager to use. .br -DVI2TTY \ \ \ \ \ \ \ \ \ \ \ -can be set to hold command-line options. +DVI2TTY\h'|\n(L1u'can be set to hold command-line options. .SH "SEE ALSO" TeX, dvi2ps .SH AUTHOR -Original Pascal verion: Svante Lindahl, Royal Institute of Technology, Stockholm +Original Pascal version: Svante Lindahl, Royal Institute of Technology, Stockholm .br -Improved C version: Marcel Mol +Improved C version: Marcel Mol, MESA Consulting .br -marcel@mesa.nl, MESA Consulting +Now maintained at https://github.com/t-tk/dvi2tty/releases. .SH BUGS -Blanks between words get lost quite easy. This is less +Blanks between words get lost quite easily. This is less likely if you are using a wider output than the default 80. .PP Only one file may be specified on the command line. - diff --git a/Master/texmf-dist/doc/man/man1/dvi2tty.man1.pdf b/Master/texmf-dist/doc/man/man1/dvi2tty.man1.pdf Binary files differindex 97959c4d3a5..30d562fc486 100644 --- a/Master/texmf-dist/doc/man/man1/dvi2tty.man1.pdf +++ b/Master/texmf-dist/doc/man/man1/dvi2tty.man1.pdf diff --git a/Master/texmf-dist/doc/man/man1/dvicopy.1 b/Master/texmf-dist/doc/man/man1/dvicopy.1 index c419717f4bf..7533d94566d 100644 --- a/Master/texmf-dist/doc/man/man1/dvicopy.1 +++ b/Master/texmf-dist/doc/man/man1/dvicopy.1 @@ -1,4 +1,4 @@ -.TH DVICOPY 1 TeX "24 January 1999" "Web2C 2021" +.TH DVICOPY 1 TeX "24 January 1999" "Web2C 2022" .\"===================================================================== .if t .ds TX \fRT\\h'-0.1667m'\\v'0.20v'E\\v'-0.20v'\\h'-0.125m'X\fP .if n .ds TX TeX diff --git a/Master/texmf-dist/doc/man/man1/dvicopy.man1.pdf b/Master/texmf-dist/doc/man/man1/dvicopy.man1.pdf Binary files differindex 7117f0387fb..40135501436 100644 --- a/Master/texmf-dist/doc/man/man1/dvicopy.man1.pdf +++ b/Master/texmf-dist/doc/man/man1/dvicopy.man1.pdf diff --git a/Master/texmf-dist/doc/man/man1/dvigif.man1.pdf b/Master/texmf-dist/doc/man/man1/dvigif.man1.pdf Binary files differindex 22f8f716744..0122106b13a 100644 --- a/Master/texmf-dist/doc/man/man1/dvigif.man1.pdf +++ b/Master/texmf-dist/doc/man/man1/dvigif.man1.pdf diff --git a/Master/texmf-dist/doc/man/man1/dvilualatex-dev.man1.pdf b/Master/texmf-dist/doc/man/man1/dvilualatex-dev.man1.pdf Binary files differindex 9ab47dd0e86..0aeedab3057 100644 --- a/Master/texmf-dist/doc/man/man1/dvilualatex-dev.man1.pdf +++ b/Master/texmf-dist/doc/man/man1/dvilualatex-dev.man1.pdf diff --git a/Master/texmf-dist/doc/man/man1/dvilualatex.man1.pdf b/Master/texmf-dist/doc/man/man1/dvilualatex.man1.pdf Binary files differindex 6cabaec2e50..efdbc36a31b 100644 --- a/Master/texmf-dist/doc/man/man1/dvilualatex.man1.pdf +++ b/Master/texmf-dist/doc/man/man1/dvilualatex.man1.pdf diff --git a/Master/texmf-dist/doc/man/man1/dviluatex.man1.pdf b/Master/texmf-dist/doc/man/man1/dviluatex.man1.pdf Binary files differindex 245496cdaf9..1b179511444 100644 --- a/Master/texmf-dist/doc/man/man1/dviluatex.man1.pdf +++ b/Master/texmf-dist/doc/man/man1/dviluatex.man1.pdf diff --git a/Master/texmf-dist/doc/man/man1/dvipng.1 b/Master/texmf-dist/doc/man/man1/dvipng.1 index 94be5bd05c5..68dfc1bd0dd 100644 --- a/Master/texmf-dist/doc/man/man1/dvipng.1 +++ b/Master/texmf-dist/doc/man/man1/dvipng.1 @@ -133,7 +133,7 @@ .\" ======================================================================== .\" .IX Title "DVIPNG 1" -.TH DVIPNG 1 "2021-02-26" "dvipng (TeX Live) 1.17" "User commands" +.TH DVIPNG 1 "2022-02-27" "dvipng (TeX Live) 1.17" "User commands" .\" For nroff, turn off justification. Always turn off hyphenation; it makes .\" way too many mistakes in technical documents. .if n .ad l diff --git a/Master/texmf-dist/doc/man/man1/dvipng.man1.pdf b/Master/texmf-dist/doc/man/man1/dvipng.man1.pdf Binary files differindex 92f1a1641ea..42fae1ebbb7 100644 --- a/Master/texmf-dist/doc/man/man1/dvipng.man1.pdf +++ b/Master/texmf-dist/doc/man/man1/dvipng.man1.pdf diff --git a/Master/texmf-dist/doc/man/man1/dvips.1 b/Master/texmf-dist/doc/man/man1/dvips.1 index 9825e2f1a56..e7cac8e2edb 100644 --- a/Master/texmf-dist/doc/man/man1/dvips.1 +++ b/Master/texmf-dist/doc/man/man1/dvips.1 @@ -1,4 +1,4 @@ -.TH DVIPS 1 "1 February 2016" +.TH DVIPS 1 "24 October 2021" .SH NAME dvips \- convert a TeX DVI file to PostScript .SH SYNOPSIS @@ -10,8 +10,7 @@ THIS MAN PAGE IS OBSOLETE! See the Texinfo documentation instead. You can read it either in Emacs or with the standalone .B info -program which comes with the GNU texinfo distribution as -ftp.gnu.org:pub/gnu/texinfo/texinfo*.tar.gz. +program. .PP The program .B dvips @@ -211,7 +210,13 @@ with values. Thus, using .I -l =9 will end with the ninth page of the document, no matter what the pages -are actually numbered. +are actually numbered. On the other hand, if +.I num +is suffixed by `.SEQ', the SEQth occurrence of +.I num +is used; for example, +.I -l 99.2 +says to end processing with the second page numbered 99 in the document. .TP .B -m Specify manual feed for printer. @@ -312,19 +317,9 @@ default position (of one inch down, one inch to the right from the upper left corner of the paper) by this amount. .TP .B -p num -The first page printed will be the first one numbered -.IR num . -Default is the first page in the document. If the -.I num -is prefixed by an equals sign, then it (and any argument to the +Just like .I -l -option) is treated as a sequence number, rather than a value to compare -with -.I \ecount0 -values. Thus, using -.I -p =3 -will start with the third page of the document, no matter what the pages -are actually numbered. +but for the first page in the document. .TP .B -pp pagelist A comma-separated list of pages and ranges (a-b) may be given, which @@ -512,9 +507,9 @@ information. Especially useful at high resolutions or when very large fonts are used. Will slow down printing somewhat, especially on early 68000-based PostScript printers. .SH "SEE ALSO" -mf(1), afm2tfm(1), tex(1), latex(1), lpr(1), +afm2tfm(1), tex(1), mf(1), dvitype(1), lpr(1), .IR dvips.texi , -http://tug.org/dvips. +https://tug.org/dvips. .SH ENVIRONMENT Dvipsk uses the same environment variables and algorithms for finding font files as TeX and its friends do. See the documentation for the @@ -531,4 +526,4 @@ by Don Knuth. Path searching and configuration modifications by Karl Berry. .PP Maintained in TeX Live; please send bug reports or other correspondence -to tex-k@tug.org (http://lists.tug.org/tex-k). +to tex-k@tug.org (https://lists.tug.org/tex-k). diff --git a/Master/texmf-dist/doc/man/man1/dvips.man1.pdf b/Master/texmf-dist/doc/man/man1/dvips.man1.pdf Binary files differindex d7bdd13216e..4edbb5cb54a 100644 --- a/Master/texmf-dist/doc/man/man1/dvips.man1.pdf +++ b/Master/texmf-dist/doc/man/man1/dvips.man1.pdf diff --git a/Master/texmf-dist/doc/man/man1/dvisvgm.1 b/Master/texmf-dist/doc/man/man1/dvisvgm.1 index ba8b102cc9c..8d9274bfd7c 100644 --- a/Master/texmf-dist/doc/man/man1/dvisvgm.1 +++ b/Master/texmf-dist/doc/man/man1/dvisvgm.1 @@ -2,12 +2,12 @@ .\" Title: dvisvgm .\" Author: Martin Gieseking <martin.gieseking@uos.de> .\" Generator: DocBook XSL Stylesheets vsnapshot <http://docbook.sf.net/> -.\" Date: 2021-01-03 +.\" Date: 2022-01-18 .\" Manual: dvisvgm Manual -.\" Source: dvisvgm 2.11.1 +.\" Source: dvisvgm 2.13.2 .\" Language: English .\" -.TH "DVISVGM" "1" "2021\-01\-03" "dvisvgm 2\&.11\&.1" "dvisvgm Manual" +.TH "DVISVGM" "1" "2022\-01\-18" "dvisvgm 2\&.13\&.2" "dvisvgm Manual" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -31,11 +31,11 @@ dvisvgm \- converts DVI and EPS files to the XML\-based SVG format .SH "SYNOPSIS" .sp -\fBdvisvgm\fR [ \fIoptions\fR ] \fIfile\fR [\&.dvi] +\fBdvisvgm\fR [\fIoptions\fR] \fIfile\fR[\&.dvi] .sp -\fBdvisvgm\fR \-\-eps [ \fIoptions\fR ] \fIfile\fR [\&.eps] +\fBdvisvgm\fR \-\-eps [\fIoptions\fR] \fIfile1\fR[\&.eps] \fIfile2\fR[\&.eps] \&... .sp -\fBdvisvgm\fR \-\-pdf [ \fIoptions\fR ] \fIfile\fR [\&.pdf] +\fBdvisvgm\fR \-\-pdf [\fIoptions\fR] \fIfile\fR[\&.pdf] .SH "DESCRIPTION" .sp The command\-line utility \fBdvisvgm\fR converts DVI files, as generated by TeX/LaTeX, to the XML\-based scalable vector graphics format SVG\&. It supports the classic DVI version 2 as well as version 3 (created by pTeX in vertical mode), and the XeTeX versions 5 to 7 which are also known as XDV\&. Besides the basic DVI commands, dvisvgm also evaluates many so\-called \fIspecials\fR which heavily extend the capabilities of the plain DVI format\&. For a more detailed overview, see section \fBSupported Specials\fR below\&. @@ -46,7 +46,7 @@ SVG is a vector\-based graphics format and therefore dvisvgm tries to convert th .sp However, TeX\(cqs main source for font descriptions is Metafont, which produces bitmap output (GF files)\&. That\(cqs why not all obtainable TeX fonts are available in a scalable format\&. In these cases, dvisvgm tries to vectorize Metafont\(cqs output by tracing the glyph bitmaps\&. The results are not as perfect as most (manually optimized) PFB or OTF counterparts, but are nonetheless really nice in most cases\&. .sp -When running dvisvgm without option \fB\-\-no\-fonts\fR, it creates \fIfont\fR elements (\fB<font>\fR\&...\fB</font>\fR) to embed the font data into the SVG files\&. Unfortunately, only few SVG renderers support these elements yet\&. Most web browsers and vector graphics applications don\(cqt evaluate them properly so that the text components of the resulting graphics might look strange\&. In order to create more compatible SVG files, command\-line option \fB\-\-no\-fonts\fR can be given to replace the font elements by plain graphics paths\&. Most web browsers (but only few external SVG renderers) also suppport WOFF and WOFF2 fonts that can be used instead of the default SVG fonts\&. Option \fB\-\-font\-format\fR offers the functionality to change the format applied to the fonts being embedded\&. This, however, only works when converting DVI files\&. Text present in PDF and PostScript files is always converted to path elements\&. +When running dvisvgm without option \fB\-\-no\-fonts\fR, it creates \fIfont\fR elements (\fB<font>\fR\&...\fB</font>\fR) to embed the font data into the SVG files\&. Unfortunately, only few SVG renderers support these elements yet\&. Most web browsers and vector graphics applications don\(cqt evaluate them properly so that the text components of the resulting graphics might look strange\&. In order to create more compatible SVG files, command\-line option \fB\-\-no\-fonts\fR can be given to replace the font elements by plain graphics paths\&. Most web browsers (but only few external SVG renderers) also support WOFF and WOFF2 fonts that can be used instead of the default SVG fonts\&. Option \fB\-\-font\-format\fR offers the functionality to change the format applied to the fonts being embedded\&. This, however, only works when converting DVI files\&. Text present in PDF and PostScript files is always converted to path elements\&. .SH "OPTIONS" .sp dvisvgm provides a POSIX\-compliant command\-line interface with short and long option names\&. They may be given before and/or after the name of the file to be converted\&. Also, the order of specifying the options is not significant, i\&.e\&. you can add them in any order without changing dvisvgm\(cqs behavior\&. Certain options accept or require additional parameters which are directly appended to or separated by whitespace from a short option (e\&.g\&. \fB\-v0\fR or \fB\-v 0\fR)\&. Long options require an additional equals sign (\fB=\fR) between option name and argument but without any surrounding whitespace (e\&.g\&. \fB\-\-verbosity=0\fR)\&. Multiple short options that don\(cqt expect a further parameter can be combined after a single dash (e\&.g\&. \fB\-ejs\fR rather than \fB\-e \-j \-s\fR)\&. @@ -301,7 +301,7 @@ Adds comments with further information about selected data to the SVG file\&. Cu .PP \fB\-E, \-\-eps\fR .RS 4 -If this option is given, dvisvgm does not expect a DVI but an EPS input file, and tries to convert it to SVG\&. In order to do so, a single +If this option is given, dvisvgm does not expect a DVI but a single or multiple EPS input files, and tries to convert them to SVG\&. In order to do so, a single \fIpsfile\fR special command is created and forwarded to the PostScript special handler\&. This option is only available if dvisvgm was built with PostScript support enabled, and requires Ghostscript to be available\&. See option \fB\-\-libgs\fR @@ -506,10 +506,10 @@ creates yellow filled rectangles with blue frames\&. .PP \fB\-l, \-\-list\-specials\fR .RS 4 -Prints a list of registered special handlers and exits\&. Each handler processes a set of special statements belonging to the same category\&. In most cases, the categories are identified by the prefix of the special statements\&. It\(cqs usually a leading string followed by a colon or a blank, e\&.g\&. +Prints a list of registered special handlers and exits\&. Each handler processes a set of special statements belonging to the same category\&. In most cases, these categories are identified by the prefix of the special statements which is usually a leading string followed by a colon or a blank, e\&.g\&. \fIcolor\fR or -\fIps\fR\&. The listed handler names, however, don\(cqt need to match these prefixes, e\&.g\&. if there is no common prefix or if functionality is split into separate handlers in order to allow to disable them separately with option +\fIps\fR\&. The listed handler names, however, don\(cqt need to match these prefixes, e\&.g\&. if there is no common prefix or if functionality is split into separate handlers in order to allow them to be disabled separately using option \fB\-\-no\-specials\fR\&. All special statements not covered by one of the special handlers are silently ignored\&. .RE .PP @@ -662,21 +662,30 @@ expression, it\(cqs assigned to the attribute\&. Otherwise, the matrix expressio .PP \fB\-o, \-\-output\fR=\fIpattern\fR .RS 4 -Sets the pattern specifying the names of the generated SVG files\&. Parameter +Sets the pattern that determines the names of the generated SVG files\&. The required parameter \fIpattern\fR -is a string that may contain static character sequences as well as the variables +may consist of an arbitrary sequence of characters which make up the filenames\&. With the exception of the following mentioned variables and expressions, all characters are treated as static parts of the filenames and are therefore identical for all pages processed during a run of dvisvgm\&. The strings \fB%f\fR, \fB%p\fR, \fB%P\fR, +\fB%n\fR, +\fB%N\fR, \fB%hd\fR, \fB%ho\fR, and -\fB%hc\fR\&. +\fB%hc\fR +are variables that can be used as part of the pattern\&. \fB%f\fR expands to the base name of the DVI file, i\&.e\&. the filename without suffix, \fB%p\fR is the current page number, and \fB%P\fR -the total number of pages in the DVI file\&. An optional number (0\-9) given directly after the percent sign specifies the minimal number of digits to be written\&. If a particular value consists of less digits, the number is padded with leading zeros\&. Example: +the total number of pages in the DVI file\&. The variables +\fB%n\fR +and +\fB%N\fR +expand to the number of the current file being converted (starting at 1) and the total number of files given, respectively\&. +.sp +An optional number (0\-9) specified directly after the percent sign of a variable holding a numeric value denotes the minimal number of digits to be created\&. If a particular value consists of less digits, the number is padded with leading zeros\&. Example: \fB%3p\fR enforces 3 digits for the current page number (001, 002, etc\&.)\&. Without an explicit width specifier, \fB%p\fR @@ -703,7 +712,7 @@ and \fB%hc\fR are only set if option \fB\-\-page\-hashes\fR -is present\&. Otherwise, it\(cqs empty\&. For further information, see the description of option +is present\&. Otherwise, they are empty\&. For further information, see the description of option \fB\-\-page\-hashes\fR below\&. .sp @@ -839,7 +848,7 @@ degrees around the page center\&. This option is equivalent to .PP \fB\-R, \-\-relative\fR .RS 4 -SVG allows to define graphics paths by a sequence of absolute and/or relative path commands, i\&.e\&. each command expects either absolute coordinates or coordinates relative to the current drawing position\&. By default, dvisvgm creates paths made up of absolute commands\&. If option +SVG allows you to define graphics paths by a sequence of absolute and/or relative path commands, i\&.e\&. each command expects either absolute coordinates or coordinates relative to the current drawing position\&. By default, dvisvgm creates paths made up of absolute commands\&. If option \fB\-\-relative\fR is given, relative commands are created instead\&. This slightly reduces the size of the SVG files in most cases\&. .RE @@ -867,7 +876,7 @@ In some cases, dvisvgm needs to create temporary files to work properly\&. These \fB/tmp\fR on Linux systems\&. Option \fB\-\-tmpdir\fR -allows to specify a different location if necessary for some reason\&. Please note that dvisvgm does not create this folder, so you must ensure that it actually exists before running dvisvgm\&. +can be used to specify a different location\&. Please note that dvisvgm does not create this folder if it doesn\(cqt exist\&. Therefore, you must ensure that it\(cqs actually present before running dvisvgm\&. .sp If the optional parameter \fIpath\fR @@ -1162,11 +1171,16 @@ attributes are omitted\&. .RE .SH "SUPPORTED SPECIALS" .sp -dvisvgm supports several sets of \fIspecial commands\fR that can be used to enrich DVI files with additional features, like color, graphics, and hyperlinks\&. The evaluation of special commands is delegated to dedicated handlers provided by dvisvgm\&. Each handler is responsible for all special statements of the same command set, i\&.e\&. commands beginning with the same prefix\&. To get a list of the actually provided special handlers, use option \fB\-\-list\-specials\fR (see above)\&. This section gives an overview of the special commands currently supported\&. +dvisvgm supports several \fIspecial commands\fR that enrich the DVI command set with additional instructions for features, like color, graphics, and hyperlinks\&. The term \fIspecial command\fR, or just \fIspecial\fR, originates from the TeX command \fB\especial{\&...}\fR which does almost nothing\&. TeX only forwards the whole command to the DVI file and delegates its execution to the DVI driver\&. The DVI driver can then decide to either process or ignore it, depending on the supported statements\&. The parameter of TeX\(cqs \fB\especial\fR command is given in curly braces and may consist of an arbitrary character sequence representing the actual instruction, for example \fBcolor Red\fR\&. +.sp ++ dvisvgm delegates the evaluation of special commands to dedicated handlers\&. Each handler is responsible for all special statements of the same command set, i\&.e\&. commands usually \(en but not necessarily \(en beginning with a common prefix\&. For example, all PDF specials start with the prefix \fBpdf:\fR, while the TPIC special set consists of 13 different commands without common identifier\&. The PDF specials are processed by dvisvgm\(cqs \fIpdf\fR handler, the TPIC ones by the \fItpic\fR handler\&. To get a list of the actually provided special handlers, use option \fB\-\-list\-specials\fR (see above)\&. The following list gives an overview of the special sets currently supported\&. The names of the handlers can also be used to disable the processing of individual sets of specials\&. For further information on this, see option \fB\-\-no\-specials\fR\&. .PP \fBbgcolor\fR .RS 4 -Special statement for changing the background/page color\&. Since SVG 1\&.1 doesn\(cqt support background colors, dvisvgm inserts a rectangle of the chosen color into the generated SVG document\&. This rectangle always gets the same size as the selected or computed bounding box\&. This background color command is part of the color special set but is handled separately in order to let the user turn it off\&. For an overview of the command syntax, see the documentation of dvips, for instance\&. +Special statements for changing the background/page color\&. Currently, dvisvgm only supports the +\fBbackground\fR +statement as specified in the +dvips manual (\m[blue]https://tug.org/texinfohtml/dvips.html#Color-specifications\m[])\&. Since SVG 1\&.1 doesn\(cqt support background colors, dvisvgm inserts a rectangle of the chosen color into the generated SVG document\&. This rectangle always gets the same size as the selected or computed bounding box\&. This background color command is part of the color special set but is handled separately in order to let the user turn it off\&. .RE .PP \fBcolor\fR @@ -1364,7 +1378,7 @@ emTeX (\m[blue]https://ctan.org/pkg/emtex\m[])\&. The hyperref specification defines several variants on how to mark hyperlinked areas in a DVI file\&. dvisvgm supports the plain HyperTeX special constructs as created with hyperref package option \fIhypertex\fR\&. By default, all linked areas of the document are marked by a rectangle\&. Option \fB\-\-linkmark\fR -allows to change this behavior\&. See above for further details\&. Information on syntax and semantics of the HyperTeX specials can be found in the +allows you to change this behavior\&. See above for further details\&. Information on syntax and semantics of the HyperTeX specials can be found in the hyperref manual (\m[blue]https://ctan.org/pkg/hyperref\m[])\&. .RE .PP @@ -1692,4 +1706,4 @@ Please report bugs using the bug tracker at GitHub (\m[blue]https://github.com/m Written by Martin Gieseking <\m[blue]\fBmartin\&.gieseking@uos\&.de\fR\m[]> .SH "COPYING" .sp -Copyright \(co 2005\-2021 Martin Gieseking\&. Free use of this software is granted under the terms of the GNU General Public License (GPL) version 3 or, (at your option) any later version\&. +Copyright \(co 2005\-2022 Martin Gieseking\&. Free use of this software is granted under the terms of the GNU General Public License (GPL) version 3 or, (at your option) any later version\&. diff --git a/Master/texmf-dist/doc/man/man1/dvisvgm.man1.pdf b/Master/texmf-dist/doc/man/man1/dvisvgm.man1.pdf Binary files differindex 63812c8281c..9a5e79991d8 100644 --- a/Master/texmf-dist/doc/man/man1/dvisvgm.man1.pdf +++ b/Master/texmf-dist/doc/man/man1/dvisvgm.man1.pdf diff --git a/Master/texmf-dist/doc/man/man1/dvitomp.1 b/Master/texmf-dist/doc/man/man1/dvitomp.1 index 715908134ea..ed5a423ebc9 100644 --- a/Master/texmf-dist/doc/man/man1/dvitomp.1 +++ b/Master/texmf-dist/doc/man/man1/dvitomp.1 @@ -1,4 +1,4 @@ -.TH DVITOMP 1 "16 June 2015" "Web2C 2021" +.TH DVITOMP 1 "16 June 2015" "Web2C 2022" .\" man page by Jim Van Zandt <jrv@vanzandt.mv.com> .SH NAME dvitomp \- convert a TeX DVI file to a MetaPost MPXFILE diff --git a/Master/texmf-dist/doc/man/man1/dvitomp.man1.pdf b/Master/texmf-dist/doc/man/man1/dvitomp.man1.pdf Binary files differindex d5f91f8076e..3442cfa0a16 100644 --- a/Master/texmf-dist/doc/man/man1/dvitomp.man1.pdf +++ b/Master/texmf-dist/doc/man/man1/dvitomp.man1.pdf diff --git a/Master/texmf-dist/doc/man/man1/dvitype.1 b/Master/texmf-dist/doc/man/man1/dvitype.1 index f79761f7c71..1932f29d5c3 100644 --- a/Master/texmf-dist/doc/man/man1/dvitype.1 +++ b/Master/texmf-dist/doc/man/man1/dvitype.1 @@ -1,4 +1,4 @@ -.TH DVITYPE 1 "16 June 2015" "Web2C 2021" +.TH DVITYPE 1 "16 June 2015" "Web2C 2022" .\"===================================================================== .if t .ds TX \fRT\\h'-0.1667m'\\v'0.20v'E\\v'-0.20v'\\h'-0.125m'X\fP .if n .ds TX TeX diff --git a/Master/texmf-dist/doc/man/man1/dvitype.man1.pdf b/Master/texmf-dist/doc/man/man1/dvitype.man1.pdf Binary files differindex 7f5782a97ac..9c581f6a098 100644 --- a/Master/texmf-dist/doc/man/man1/dvitype.man1.pdf +++ b/Master/texmf-dist/doc/man/man1/dvitype.man1.pdf diff --git a/Master/texmf-dist/doc/man/man1/eptex.man1.pdf b/Master/texmf-dist/doc/man/man1/eptex.man1.pdf Binary files differindex cc665255744..1ec881d5a1c 100644 --- a/Master/texmf-dist/doc/man/man1/eptex.man1.pdf +++ b/Master/texmf-dist/doc/man/man1/eptex.man1.pdf diff --git a/Master/texmf-dist/doc/man/man1/euptex.man1.pdf b/Master/texmf-dist/doc/man/man1/euptex.man1.pdf Binary files differindex eac45ea7bbc..7547ef7bcbe 100644 --- a/Master/texmf-dist/doc/man/man1/euptex.man1.pdf +++ b/Master/texmf-dist/doc/man/man1/euptex.man1.pdf diff --git a/Master/texmf-dist/doc/man/man1/fmtutil-sys.man1.pdf b/Master/texmf-dist/doc/man/man1/fmtutil-sys.man1.pdf Binary files differindex 7de56168927..1c63dda8539 100644 --- a/Master/texmf-dist/doc/man/man1/fmtutil-sys.man1.pdf +++ b/Master/texmf-dist/doc/man/man1/fmtutil-sys.man1.pdf diff --git a/Master/texmf-dist/doc/man/man1/fmtutil-user.man1.pdf b/Master/texmf-dist/doc/man/man1/fmtutil-user.man1.pdf Binary files differindex ba49bb098e2..764878a4ed5 100644 --- a/Master/texmf-dist/doc/man/man1/fmtutil-user.man1.pdf +++ b/Master/texmf-dist/doc/man/man1/fmtutil-user.man1.pdf diff --git a/Master/texmf-dist/doc/man/man1/fmtutil.1 b/Master/texmf-dist/doc/man/man1/fmtutil.1 index 56f6f4eeac4..1b4357cdfa9 100644 --- a/Master/texmf-dist/doc/man/man1/fmtutil.1 +++ b/Master/texmf-dist/doc/man/man1/fmtutil.1 @@ -1,60 +1,42 @@ -.\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.48.2. -.TH FMTUTIL "1" "May 2021" "TeX Live" "User Commands" +.\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.46.5. +.TH FMTUTIL "1" "April 2015" "TeX Live" "User Commands" .SH NAME -fmtutil \- manage TeX formats and Metafont bases, per-user +fmtutil \- manage TeX formats, Metafont bases and Metapost mems, per-user .br -fmtutil-sys \- manage TeX formats and Metafont bases, system-wide +fmtutil-sys \- manage TeX formats, Metafont bases and Metapost mems, system-wide .br -mktexfmt \- create a TeX format or Metafont base +mktexfmt \- create a TeX format, Metafont base, or Metapost mem .SH SYNOPSIS .B fmtutil -[\fI\,-user|-sys\/\fR] [\fI\,OPTION\/\fR] ... [\fI\,COMMAND\/\fR] -.br -.B fmtutil-sys [\fI\,OPTION\/\fR] ... [\fI\,COMMAND\/\fR] .br -.B fmtutil-user +.B fmtutil-sys [\fI\,OPTION\/\fR] ... [\fI\,COMMAND\/\fR] .br .B mktexfmt -\fI\,FORMAT.fmt|BASE.base|FMTNAME\/\fR +\fI\,FORMAT.fmt|BASE.base|MEM.mem|FMTNAME.EXT\/\fR .SH DESCRIPTION -fmtutil version r59143 (2021\-05\-09 04:23:44 +0200) +fmtutil version svn36788 (2015\-04\-13 00:53:26 +0900) .PP -Rebuild and manage TeX fmts and Metafont bases, collectively called -"formats" here. (MetaPost no longer uses the past\-equivalent "mems".) -.PP -If not operating in mktexfmt mode, exactly one command must be given, -filename suffixes should generally not be specified, no non\-option -arguments are allowed, and multiple formats can be generated. +Rebuild and manage TeX formats, Metafont bases and MetaPost mems. .PP If the command name ends in mktexfmt, only one format can be created. The only options supported are \fB\-\-help\fR and \fB\-\-version\fR, and the command -line must be either a format name, with extension, or a plain name that -is passed as the argument to \fB\-\-byfmt\fR (see below). The full name of the -generated file (if any) is written to stdout, and nothing else. The -system directories are used if they are writable, else the user directories. +line must consist of either a format name, with its extension, or a +plain name that is passed as the argument to \fB\-\-byfmt\fR (see below). The +full name of the generated file (if any) is written to stdout, and +nothing else. .PP -By default, the return status is zero if all formats requested are -successfully built, else nonzero. +If not operating in mktexfmt mode, the command line can be more general, +and multiple formats can be generated, as follows. .SH OPTIONS .TP -\fB\-\-sys\fR -use TEXMFSYS{VAR,CONFIG} -.TP -\fB\-\-user\fR -use TEXMF{VAR,CONFIG} -.TP \fB\-\-cnffile\fR FILE read FILE instead of fmtutil.cnf (can be given multiple times, in which case all the files are used) -.TP -\fB\-\-dry\-run\fR, \fB\-n\fR -don't actually build formts -.TP -\fB\-\-fmtdir\fR DIR -write formats under DIR instead of TEXMF[SYS]VAR +.HP +\fB\-\-fmtdir\fR DIRECTORY .TP \fB\-\-no\-engine\-subdir\fR don't use engine\-specific subdir of the fmtdir @@ -63,39 +45,21 @@ don't use engine\-specific subdir of the fmtdir exit successfully if no format is selected .TP \fB\-\-no\-error\-if\-no\-engine\fR=\fI\,ENGINE1\/\fR,ENGINE2,... -exit successfully even if a required ENGINE +exit successfully even if the required engine .IP is missing, if it is included in the list. .TP -\fB\-\-no\-strict\fR -exit successfully even if a format fails to build -.TP -\fB\-\-nohash\fR -don't update ls\-R files -.TP -\fB\-\-recorder\fR -pass the \fB\-recorder\fR option and save .fls files -.TP -\fB\-\-refresh\fR -recreate only existing format files -.TP -\fB\-\-status\-file\fR FILE -append status information about built formats to FILE -.TP \fB\-\-quiet\fR be silent .TP -\fB\-\-catcfg\fR -(does nothing, exists for compatibility) +\fB\-\-test\fR +(not implemented, just for compatibility) .TP \fB\-\-dolinks\fR -(does nothing, exists for compatibility) +(not implemented, just for compatibility) .TP \fB\-\-force\fR -(does nothing, exists for compatibility) -.TP -\fB\-\-test\fR -(does nothing, exists for compatibility) +(not implemented, just for compatibility) .SS "Commands:" .TP \fB\-\-all\fR @@ -104,30 +68,33 @@ recreate all format files \fB\-\-missing\fR create all missing format files .TP -\fB\-\-byengine\fR ENGINE -(re)create formats built with ENGINE +\fB\-\-refresh\fR +recreate only existing format files +.TP +\fB\-\-byengine\fR ENGINENAME +(re)create formats using ENGINENAME .TP -\fB\-\-byfmt\fR FORMAT -(re)create format FORMAT +\fB\-\-byfmt\fR FORMATNAME +(re)create format for FORMATNAME .TP \fB\-\-byhyphen\fR HYPHENFILE (re)create formats that depend on HYPHENFILE .TP -\fB\-\-enablefmt\fR -FORMAT[/ENGINE] enable FORMAT, as built with ENGINE +\fB\-\-enablefmt\fR FORMATNAME +enable formatname in config file .TP -\fB\-\-disablefmt\fR FORMAT[/ENGINE] -disable FORMAT, as built with ENGINE -If multiple formats have the same name and -.IP -different engines, \fI\,/ENGINE\/\fP specifier is required. +\fB\-\-disablefmt\fR FORMATNAME +disable formatname in config file .TP \fB\-\-listcfg\fR list (enabled and disabled) configurations, filtered to available formats .TP -\fB\-\-showhyphen\fR FORMAT -print name of hyphen file for FORMAT +\fB\-\-catcfg\fR +output the content of the config file +.TP +\fB\-\-showhyphen\fR FORMATNAME +print name of hyphenfile for format FORMATNAME .TP \fB\-\-version\fR show version information and exit @@ -140,10 +107,8 @@ Explanation of trees and files normally used: .IP If \fB\-\-cnffile\fR is specified on the command line (possibly multiple times), its value(s) are used. Otherwise, fmtutil reads all the -fmtutil.cnf files found by running "kpsewhich \fB\-all\fR fmtutil.cnf", in the -order returned by kpsewhich. Files specified via \fB\-\-cnffile\fR are -first tried to be loaded directly, and if not found and the file names -don't contain directory parts, are searched via kpsewhich. +fmtutil.cnf files found by running `kpsewhich \fB\-all\fR fmtutil.cnf', in the +order returned by kpsewhich. .IP In any case, if multiple fmtutil.cnf files are found, all the format definitions found in all the fmtutil.cnf files are merged. @@ -159,7 +124,7 @@ TEXMFSYSVAR \fI\,$TEXLIVE/YYYY/texmf\-var/web2c/fmtutil.cnf\/\fP TEXMFLOCAL \fI\,$TEXLIVE/texmf\-local/web2c/fmtutil.cnf\/\fP TEXMFDIST \fI\,$TEXLIVE/YYYY/texmf\-dist/web2c/fmtutil.cnf\/\fP .IP -For fmtutil\-user: +For fmtutil: TEXMFCONFIG $HOME/.texliveYYYY/texmf\-config/web2c/fmtutil.cnf TEXMFVAR $HOME/.texliveYYYY/texmf\-var/web2c/fmtutil.cnf TEXMFHOME \fI\,$HOME/texmf/web2c/fmtutil.cnf\/\fP @@ -171,43 +136,28 @@ TEXMFDIST \fI\,$TEXLIVE/YYYY/texmf\-dist/web2c/fmtutil.cnf\/\fP (where YYYY is the TeX Live release version). .fi .IP -According to the actions, fmtutil might update one of the existing cnf -files or create a new fmtutil.cnf, as described below. +According to the actions, fmtutil might write to one of the given files +or create a new fmtutil.cnf, described further below. .PP -Where format files are written: -.IP -By default, format files are (re)written in \fI\,$TEXMFSYSVAR/ENGINE\/\fP by -fmtutil\-sys, and \fI\,$TEXMFVAR/ENGINE\/\fP by fmtutil\-user, where \fI\,/ENGINE\/\fP is -a subdirectory named for the engine used, such as "pdftex". -.IP -For mktexfmt, TEXMFSYSVAR is used if it is writable, else TEXMFVAR. -.IP -If the \fB\-\-fmtdir\fR=\fI\,DIR\/\fR option is specified, DIR is used instead of -TEXMF[SYS]VAR, but the \fI\,/ENGINE\/\fP subdir is still used by default. -.IP -In all cases, if the \fB\-\-no\-engine\-subdir\fR option is specified, the -\fI\,/ENGINE\/\fP subdir is omitted. -.PP -Where configuration changes are saved: +Where changes are saved: .IP If config files are given on the command line, then the first one given will be used to save any changes from \fB\-\-enable\fR or \fB\-\-disable\fR. -.IP If the config files are taken from kpsewhich output, then the -algorithm is more complicated: +algorithm is more complex: .IP -1) If \fI\,$TEXMFCONFIG/web2c/fmtutil.cnf\/\fP or -\fI\,$TEXMFHOME/web2c/fmtutil.cnf\/\fP appears in the list of used files, -then the one listed first by kpsewhich \fB\-\-all\fR (equivalently, the one -returned by "kpsewhich fmtutil.cnf"), is used. +1) If \fI\,$TEXMFCONFIG/web2c/fmtutil.cnf\/\fP or \fI\,$TEXMFHOME/web2c/fmtutil.cnf\/\fP +appears in the list of used files, then the one listed first by +kpsewhich \fB\-\-all\fR (equivalently, the one returned by kpsewhich +fmtutil.cnf), is used. .IP 2) If neither of the above two are present and changes are made, a new config file is created in \fI\,$TEXMFCONFIG/web2c/fmtutil.cnf\/\fP. .IP In general, the idea is that if a given config file is not writable, a higher\-level one can be used. That way, the distribution's settings -can be overridden system\-wide using TEXMFLOCAL, and system settings -can be overridden again in a particular user's TEXMFHOME or TEXMFCONF. +can be overridden for system\-wide using TEXMFLOCAL, and then system +settings can be overridden again for a particular using using TEXMFHOME. .PP Resolving multiple definitions of a format: .IP @@ -217,43 +167,30 @@ coming from the first\-listed fmtutil.cnf is used. Disabling formats: .IP fmtutil.cnf files with higher priority (listed earlier) can disable -formats in lower priority (listed later) fmtutil.cnf files by -writing a line like this in the higher\-priority fmtutil.cnf file: +formats mentioned in lower priority (listed later) fmtutil.cnf files by +writing, e.g., .IP #! <fmtname> <enginename> <hyphen> <args> .IP -The #! must be at the beginning of the line, with at least one space -or tab afterward, and there must be whitespace between each word on -the list. +in the higher\-priority fmtutil.cnf file. .IP -For example, you can disable the luajitlatex format by creating -the file \fI\,$TEXMFCONFIG/web2c/fmtutil.cnf\/\fP with the line +As an example, suppose you have want to disable the luajitlatex format. +You can create the file \fI\,$TEXMFCONFIG/web2c/fmtutil.cnf\/\fP with the content .IP #! luajitlatex luajittex language.dat,language.dat.lua lualatex.ini .IP -(As it happens, the luajittex\-related formats are precisely why the -\fB\-\-no\-error\-if\-no\-engine\fR option exists, since luajittex cannot be -compiled on all platforms. So this is not needed.) +and call fmtutil. .PP -fmtutil\-user (fmtutil \fB\-user\fR) vs. fmtutil\-sys (fmtutil \fB\-sys\fR): +fmtutil vs. fmtutil\-sys (fmtutil \fB\-\-sys\fR): .IP -When fmtutil\-sys is run or the command line option \fB\-sys\fR is used, +When fmtutil\-sys is run or the command line option \fB\-\-sys\fR is used, TEXMFSYSCONFIG and TEXMFSYSVAR are used instead of TEXMFCONFIG and -TEXMFVAR, respectively. This is the primary difference between -fmtutil\-sys and fmtutil\-user. -.IP -See https://tug.org/texlive/scripts\-sys\-user.html for details. +TEXMFVAR, respectively. This is the primary difference between +fmtutil\-sys and fmtutil. .IP Other locations may be used if you give them on the command line, or these trees don't exist, or you are not using the original TeX Live. -.PP -Supporting development binaries: -.IP -If an engine name ends with "\-dev", formats are created in -the respective directory with the \fB\-dev\fR stripped. This allows for -easily running development binaries in parallel with the released -binaries. .SH "REPORTING BUGS" -Report bugs to: tex\-live@tug.org +Report bugs to: tex\-k@tug.org .br -TeX Live home page: <https://tug.org/texlive/> +TeX Live home page: <http://tug.org/texlive/> diff --git a/Master/texmf-dist/doc/man/man1/fmtutil.man1.pdf b/Master/texmf-dist/doc/man/man1/fmtutil.man1.pdf Binary files differindex 90da5b040a5..075bd22f1ed 100644 --- a/Master/texmf-dist/doc/man/man1/fmtutil.man1.pdf +++ b/Master/texmf-dist/doc/man/man1/fmtutil.man1.pdf diff --git a/Master/texmf-dist/doc/man/man1/gftodvi.1 b/Master/texmf-dist/doc/man/man1/gftodvi.1 index 4d7f5e6a3bc..4a6fca21ec7 100644 --- a/Master/texmf-dist/doc/man/man1/gftodvi.1 +++ b/Master/texmf-dist/doc/man/man1/gftodvi.1 @@ -1,4 +1,4 @@ -.TH GFTODVI 1 "25 March 2019" "Web2C 2021" +.TH GFTODVI 1 "4 March 2021" "Web2C 2022" .\"===================================================================== .if n .ds MF Metafont .if t .ds MF Metafont @@ -6,23 +6,17 @@ .if n .ds TX TeX .ie t .ds OX \fIT\v'+0.25m'E\v'-0.25m'X\fP .el .ds OX TeX -.\" BX definition must follow TX so BX can use TX -.if t .ds BX \fRB\s-2IB\s0\fP\*(TX -.if n .ds BX BibTeX -.\" LX definition must follow TX so LX can use TX -.if t .ds LX \fRL\\h'-0.36m'\\v'-0.15v'\s-2A\s0\\h'-0.15m'\\v'0.15v'\fP\*(TX -.if n .ds LX LaTeX .\"===================================================================== .SH NAME gftodvi \- make proof sheets from generic font files .SH SYNOPSIS .B gftodvi -.RB [ \-overflow-label-offset=\fIreal\fP ] +.RB [ \-overflow-label-offset=\fI\,real\/\fP ] .RB [ \-verbose ] .I gf_file_name .\"===================================================================== .SH DESCRIPTION -This manual page is not meant to be exhaustive. The complete +This manual page is not meant to be exhaustive. The complete documentation for this version of \*(TX can be found in the info file or manual .IR "Web2C: A TeX implementation" . @@ -91,7 +85,7 @@ a font for lines with slope 1/6 at the resolution of an Imagen printer). .PP The .I gf_file_name -on the command line must be complete. Because +on the command line must be complete. Because the resolution is part of the extension, it would not make sense to append a default extension as is done with \*(TX or DVI-reading software. The output file name uses the same @@ -109,14 +103,14 @@ The argument to .B \-overflow-label-offset specifies the distance from the right edge of the character bounding box at which the overflow equations (if any) are typeset. -The value is given in \*(TX points. The default is a little over two +The value is given in \*(TX points. The default is a little over two inches. .PP Without the .B \-verbose option, .B gftodvi -operates silently. With it, a banner and progress report are printed on +operates silently. With it, a banner and progress report are printed on .IR stdout . .\"===================================================================== .SH ENVIRONMENT @@ -124,7 +118,7 @@ operates silently. With it, a banner and progress report are printed on looks for .I gf_file_name using the -environment variable GFFONTS. If that is not set, it uses the variable +environment variable GFFONTS. If that is not set, it uses the variable TEXFONTS. If that is not set, it uses the system default. .PP See @@ -143,17 +137,18 @@ The \*(MF sources. .BR tex (1), .BR mf (1). .br -Donald E. Knuth, +Donald E.\& Knuth, .I "The \*(MFbook" (Volume C of .IR "Computers and Typesetting" ), Addison-Wesley, 1986, ISBN 0-201-13445-4. .br -Donald E. Knuth et al., +Donald E.\& Knuth et al., .IR \*(MFware . .\"===================================================================== .SH AUTHORS -Donald E. Knuth wrote the program. It was published as part of the +Donald E.\& Knuth wrote and still maintains the program. It was +published as part of the .I \*(MFware -technical report, available from the \*(TX Users Group. -Paul Richards ported it to Unix. +technical report. Paul Richards originally ported it to Unix. +Bug reports should go to tex-k@tug.org (https://lists.tug.org/tex-k). diff --git a/Master/texmf-dist/doc/man/man1/gftodvi.man1.pdf b/Master/texmf-dist/doc/man/man1/gftodvi.man1.pdf Binary files differindex 381104800e1..16f9e539e71 100644 --- a/Master/texmf-dist/doc/man/man1/gftodvi.man1.pdf +++ b/Master/texmf-dist/doc/man/man1/gftodvi.man1.pdf diff --git a/Master/texmf-dist/doc/man/man1/gftopk.1 b/Master/texmf-dist/doc/man/man1/gftopk.1 index 754324d65f2..a8d9d007cf2 100644 --- a/Master/texmf-dist/doc/man/man1/gftopk.1 +++ b/Master/texmf-dist/doc/man/man1/gftopk.1 @@ -1,4 +1,4 @@ -.TH GFTOPK 1 "16 June 2015" "Web2C 2021" +.TH GFTOPK 1 "16 June 2015" "Web2C 2022" .\"===================================================================== .if n .ds MF Metafont .if t .ds MF Metafont diff --git a/Master/texmf-dist/doc/man/man1/gftopk.man1.pdf b/Master/texmf-dist/doc/man/man1/gftopk.man1.pdf Binary files differindex edfb70d06cd..b03bef35660 100644 --- a/Master/texmf-dist/doc/man/man1/gftopk.man1.pdf +++ b/Master/texmf-dist/doc/man/man1/gftopk.man1.pdf diff --git a/Master/texmf-dist/doc/man/man1/gftype.1 b/Master/texmf-dist/doc/man/man1/gftype.1 index 4dac7ac9b50..2b13bd02252 100644 --- a/Master/texmf-dist/doc/man/man1/gftype.1 +++ b/Master/texmf-dist/doc/man/man1/gftype.1 @@ -1,4 +1,4 @@ -.TH GFTYPE 1 "16 June 2015" "Web2C 2021" +.TH GFTYPE 1 "16 June 2015" "Web2C 2022" .\"===================================================================== .if n .ds MF Metafont .if t .ds MF Metafont diff --git a/Master/texmf-dist/doc/man/man1/gftype.man1.pdf b/Master/texmf-dist/doc/man/man1/gftype.man1.pdf Binary files differindex 56bc556b17e..5404300b564 100644 --- a/Master/texmf-dist/doc/man/man1/gftype.man1.pdf +++ b/Master/texmf-dist/doc/man/man1/gftype.man1.pdf diff --git a/Master/texmf-dist/doc/man/man1/inimf.man1.pdf b/Master/texmf-dist/doc/man/man1/inimf.man1.pdf Binary files differindex fafb0839053..92194891f90 100644 --- a/Master/texmf-dist/doc/man/man1/inimf.man1.pdf +++ b/Master/texmf-dist/doc/man/man1/inimf.man1.pdf diff --git a/Master/texmf-dist/doc/man/man1/initex.man1.pdf b/Master/texmf-dist/doc/man/man1/initex.man1.pdf Binary files differindex 02ff9d4c5ca..e18563dc826 100644 --- a/Master/texmf-dist/doc/man/man1/initex.man1.pdf +++ b/Master/texmf-dist/doc/man/man1/initex.man1.pdf diff --git a/Master/texmf-dist/doc/man/man1/kpseaccess.1 b/Master/texmf-dist/doc/man/man1/kpseaccess.1 index 05f59db49e8..a566c3aa578 100644 --- a/Master/texmf-dist/doc/man/man1/kpseaccess.1 +++ b/Master/texmf-dist/doc/man/man1/kpseaccess.1 @@ -1,4 +1,4 @@ -.TH KPSEACCESS 1 "1 March 2011" "Kpathsea 6.3.3" +.TH KPSEACCESS 1 "1 March 2011" "Kpathsea 6.3.4" .\"===================================================================== .if n .ds MP MetaPost .if t .ds MP MetaPost diff --git a/Master/texmf-dist/doc/man/man1/kpseaccess.man1.pdf b/Master/texmf-dist/doc/man/man1/kpseaccess.man1.pdf Binary files differindex ff6e22dfaae..461e9256eb0 100644 --- a/Master/texmf-dist/doc/man/man1/kpseaccess.man1.pdf +++ b/Master/texmf-dist/doc/man/man1/kpseaccess.man1.pdf diff --git a/Master/texmf-dist/doc/man/man1/kpsereadlink.1 b/Master/texmf-dist/doc/man/man1/kpsereadlink.1 index eb080e9f7da..2ccdc90dcb2 100644 --- a/Master/texmf-dist/doc/man/man1/kpsereadlink.1 +++ b/Master/texmf-dist/doc/man/man1/kpsereadlink.1 @@ -1,4 +1,4 @@ -.TH KPSEREADLINK 1 "1 March 2011" "Kpathsea 6.3.3" +.TH KPSEREADLINK 1 "1 March 2011" "Kpathsea 6.3.4" .\"===================================================================== .SH NAME kpsereadlink \- print contents of symbolic link diff --git a/Master/texmf-dist/doc/man/man1/kpsereadlink.man1.pdf b/Master/texmf-dist/doc/man/man1/kpsereadlink.man1.pdf Binary files differindex 6a6b873f9a2..3c0c35d6bed 100644 --- a/Master/texmf-dist/doc/man/man1/kpsereadlink.man1.pdf +++ b/Master/texmf-dist/doc/man/man1/kpsereadlink.man1.pdf diff --git a/Master/texmf-dist/doc/man/man1/kpsestat.1 b/Master/texmf-dist/doc/man/man1/kpsestat.1 index 1814d9be09b..580a8135b82 100644 --- a/Master/texmf-dist/doc/man/man1/kpsestat.1 +++ b/Master/texmf-dist/doc/man/man1/kpsestat.1 @@ -1,4 +1,4 @@ -.TH KPSESTAT 1 "1 March 2011" "Kpathsea 6.3.3" +.TH KPSESTAT 1 "1 March 2011" "Kpathsea 6.3.4" .\"===================================================================== .if n .ds MP MetaPost .if t .ds MP MetaPost diff --git a/Master/texmf-dist/doc/man/man1/kpsestat.man1.pdf b/Master/texmf-dist/doc/man/man1/kpsestat.man1.pdf Binary files differindex 1ca4495ac65..3ca2bcc519a 100644 --- a/Master/texmf-dist/doc/man/man1/kpsestat.man1.pdf +++ b/Master/texmf-dist/doc/man/man1/kpsestat.man1.pdf diff --git a/Master/texmf-dist/doc/man/man1/kpsewhich.1 b/Master/texmf-dist/doc/man/man1/kpsewhich.1 index d184c7c5f8e..8787591dc1c 100644 --- a/Master/texmf-dist/doc/man/man1/kpsewhich.1 +++ b/Master/texmf-dist/doc/man/man1/kpsewhich.1 @@ -1,4 +1,4 @@ -.TH KPSEWHICH 1 "1 March 2011" "Kpathsea 6.3.3" +.TH KPSEWHICH 1 "1 March 2011" "Kpathsea 6.3.4" .\"===================================================================== .if n .ds MP MetaPost .if t .ds MP MetaPost diff --git a/Master/texmf-dist/doc/man/man1/kpsewhich.man1.pdf b/Master/texmf-dist/doc/man/man1/kpsewhich.man1.pdf Binary files differindex 80a17126fc2..7d4d225e399 100644 --- a/Master/texmf-dist/doc/man/man1/kpsewhich.man1.pdf +++ b/Master/texmf-dist/doc/man/man1/kpsewhich.man1.pdf diff --git a/Master/texmf-dist/doc/man/man1/latex-dev.1 b/Master/texmf-dist/doc/man/man1/latex-dev.1 index 17f5cb1dc9e..7d27334722c 100644 --- a/Master/texmf-dist/doc/man/man1/latex-dev.1 +++ b/Master/texmf-dist/doc/man/man1/latex-dev.1 @@ -1,4 +1,4 @@ -.TH LATEX-DEV 1 "17 November 2019" "Web2C 2021" +.TH LATEX-DEV 1 "17 November 2019" "Web2C 2022" .SH NAME latex-dev, pdflatex-dev, xelatex-dev, lualatex-dev, dvilualatex-dev, platex-dev, uplatex-dev \- release candidate LaTeX testing .SH SYNOPSIS diff --git a/Master/texmf-dist/doc/man/man1/latex-dev.man1.pdf b/Master/texmf-dist/doc/man/man1/latex-dev.man1.pdf Binary files differindex 30301386298..53c0aba0e34 100644 --- a/Master/texmf-dist/doc/man/man1/latex-dev.man1.pdf +++ b/Master/texmf-dist/doc/man/man1/latex-dev.man1.pdf diff --git a/Master/texmf-dist/doc/man/man1/latex.1 b/Master/texmf-dist/doc/man/man1/latex.1 index 158cada1c0e..e91cfffd899 100644 --- a/Master/texmf-dist/doc/man/man1/latex.1 +++ b/Master/texmf-dist/doc/man/man1/latex.1 @@ -1,4 +1,4 @@ -.TH LATEX 1 "30 April 2018" "Web2C 2021" +.TH LATEX 1 "30 April 2018" "Web2C 2022" .\"===================================================================== .if t .ds TX \fRT\\h'-0.1667m'\\v'0.20v'E\\v'-0.20v'\\h'-0.125m'X\fP .if n .ds TX TeX diff --git a/Master/texmf-dist/doc/man/man1/latex.man1.pdf b/Master/texmf-dist/doc/man/man1/latex.man1.pdf Binary files differindex 41286a25c56..1dd857e6cd4 100644 --- a/Master/texmf-dist/doc/man/man1/latex.man1.pdf +++ b/Master/texmf-dist/doc/man/man1/latex.man1.pdf diff --git a/Master/texmf-dist/doc/man/man1/luahbtex.man1.pdf b/Master/texmf-dist/doc/man/man1/luahbtex.man1.pdf Binary files differindex 62cc6be1e1e..889e7219563 100644 --- a/Master/texmf-dist/doc/man/man1/luahbtex.man1.pdf +++ b/Master/texmf-dist/doc/man/man1/luahbtex.man1.pdf diff --git a/Master/texmf-dist/doc/man/man1/luajithbtex.man1.pdf b/Master/texmf-dist/doc/man/man1/luajithbtex.man1.pdf Binary files differindex f601829017f..0599a00fe27 100644 --- a/Master/texmf-dist/doc/man/man1/luajithbtex.man1.pdf +++ b/Master/texmf-dist/doc/man/man1/luajithbtex.man1.pdf diff --git a/Master/texmf-dist/doc/man/man1/luajittex.man1.pdf b/Master/texmf-dist/doc/man/man1/luajittex.man1.pdf Binary files differindex 77e81a243ae..17cf0a0a00d 100644 --- a/Master/texmf-dist/doc/man/man1/luajittex.man1.pdf +++ b/Master/texmf-dist/doc/man/man1/luajittex.man1.pdf diff --git a/Master/texmf-dist/doc/man/man1/lualatex-dev.man1.pdf b/Master/texmf-dist/doc/man/man1/lualatex-dev.man1.pdf Binary files differindex 5f16fb4bdfc..31edf919729 100644 --- a/Master/texmf-dist/doc/man/man1/lualatex-dev.man1.pdf +++ b/Master/texmf-dist/doc/man/man1/lualatex-dev.man1.pdf diff --git a/Master/texmf-dist/doc/man/man1/lualatex.man1.pdf b/Master/texmf-dist/doc/man/man1/lualatex.man1.pdf Binary files differindex ddd0ff8be16..c7701176db0 100644 --- a/Master/texmf-dist/doc/man/man1/lualatex.man1.pdf +++ b/Master/texmf-dist/doc/man/man1/lualatex.man1.pdf diff --git a/Master/texmf-dist/doc/man/man1/luatex.1 b/Master/texmf-dist/doc/man/man1/luatex.1 index 80857fe39b6..e1e077da7c2 100644 --- a/Master/texmf-dist/doc/man/man1/luatex.1 +++ b/Master/texmf-dist/doc/man/man1/luatex.1 @@ -1,4 +1,4 @@ -.TH LUATEX 1 "17 November 2019" "Web2C 2021" +.TH LUATEX 1 "17 November 2019" "Web2C 2022" .\"===================================================================== .if n .ds MF Metafont .if t .ds MF Metafont diff --git a/Master/texmf-dist/doc/man/man1/luatex.man1.pdf b/Master/texmf-dist/doc/man/man1/luatex.man1.pdf Binary files differindex eaf1c0df256..00cf468ed04 100644 --- a/Master/texmf-dist/doc/man/man1/luatex.man1.pdf +++ b/Master/texmf-dist/doc/man/man1/luatex.man1.pdf diff --git a/Master/texmf-dist/doc/man/man1/makejvf.1 b/Master/texmf-dist/doc/man/man1/makejvf.1 index 0d1818375c1..b2c5ebff1fa 100644 --- a/Master/texmf-dist/doc/man/man1/makejvf.1 +++ b/Master/texmf-dist/doc/man/man1/makejvf.1 @@ -93,6 +93,10 @@ enabled, since the characterization in min10.tfm is non-standard. \fB-t\fR <\fICNFfile\fR> Use <\fICNFfile\fR> as a configuration file. .TP 10 +\fB-O\fR +Omit entries in VF for characters with default metric. \ +This option is not allowed to be used with the option \fB-t\fR. +.TP 10 \fB-u\fR <\fICharset\fR> UCS mode. Available charsets are: gb (GB = Simplified Chinese), cns (CNS = Traditional Chinese), ks (KS = Korean), diff --git a/Master/texmf-dist/doc/man/man1/makejvf.man1.pdf b/Master/texmf-dist/doc/man/man1/makejvf.man1.pdf Binary files differindex acb0027c499..f0318a4a8d2 100644 --- a/Master/texmf-dist/doc/man/man1/makejvf.man1.pdf +++ b/Master/texmf-dist/doc/man/man1/makejvf.man1.pdf diff --git a/Master/texmf-dist/doc/man/man1/mf-nowin.man1.pdf b/Master/texmf-dist/doc/man/man1/mf-nowin.man1.pdf Binary files differindex 238fb476efc..0f5349bc333 100644 --- a/Master/texmf-dist/doc/man/man1/mf-nowin.man1.pdf +++ b/Master/texmf-dist/doc/man/man1/mf-nowin.man1.pdf diff --git a/Master/texmf-dist/doc/man/man1/mf.1 b/Master/texmf-dist/doc/man/man1/mf.1 index 09722a51490..de72ad23119 100644 --- a/Master/texmf-dist/doc/man/man1/mf.1 +++ b/Master/texmf-dist/doc/man/man1/mf.1 @@ -1,4 +1,4 @@ -.TH MF 1 "6 August 2019" "Web2C 2021" +.TH MF 1 "6 August 2019" "Web2C 2022" .\"===================================================================== .if n .ds MF Metafont .if t .ds MF Metafont diff --git a/Master/texmf-dist/doc/man/man1/mf.man1.pdf b/Master/texmf-dist/doc/man/man1/mf.man1.pdf Binary files differindex f6809773b8c..4403a69b464 100644 --- a/Master/texmf-dist/doc/man/man1/mf.man1.pdf +++ b/Master/texmf-dist/doc/man/man1/mf.man1.pdf diff --git a/Master/texmf-dist/doc/man/man1/mft.1 b/Master/texmf-dist/doc/man/man1/mft.1 index bfbefa4b19d..168f01b78d2 100644 --- a/Master/texmf-dist/doc/man/man1/mft.1 +++ b/Master/texmf-dist/doc/man/man1/mft.1 @@ -1,4 +1,4 @@ -.TH MFT 1 "27 May 2018" "Web2C 2021" +.TH MFT 1 "27 May 2018" "Web2C 2022" .\"===================================================================== .if n .ds MP MetaPost .if t .ds MP MetaPost diff --git a/Master/texmf-dist/doc/man/man1/mft.man1.pdf b/Master/texmf-dist/doc/man/man1/mft.man1.pdf Binary files differindex b2a03c4dd4b..4dc82eff56d 100644 --- a/Master/texmf-dist/doc/man/man1/mft.man1.pdf +++ b/Master/texmf-dist/doc/man/man1/mft.man1.pdf diff --git a/Master/texmf-dist/doc/man/man1/mktexfmt.man1.pdf b/Master/texmf-dist/doc/man/man1/mktexfmt.man1.pdf Binary files differindex bcc3d393ca6..8b128ab6c11 100644 --- a/Master/texmf-dist/doc/man/man1/mktexfmt.man1.pdf +++ b/Master/texmf-dist/doc/man/man1/mktexfmt.man1.pdf diff --git a/Master/texmf-dist/doc/man/man1/mpost.1 b/Master/texmf-dist/doc/man/man1/mpost.1 index fc66630751d..56574f2924f 100644 --- a/Master/texmf-dist/doc/man/man1/mpost.1 +++ b/Master/texmf-dist/doc/man/man1/mpost.1 @@ -1,4 +1,4 @@ -.TH MPOST 1 "31 December 2018" "Web2C 2021" +.TH MPOST 1 "31 December 2018" "Web2C 2022" .\"===================================================================== .de URL \\$2 \(laURL: \\$1 \(ra\\$3 diff --git a/Master/texmf-dist/doc/man/man1/mpost.man1.pdf b/Master/texmf-dist/doc/man/man1/mpost.man1.pdf Binary files differindex 9b0443d6800..70f238a015f 100644 --- a/Master/texmf-dist/doc/man/man1/mpost.man1.pdf +++ b/Master/texmf-dist/doc/man/man1/mpost.man1.pdf diff --git a/Master/texmf-dist/doc/man/man1/odvicopy.man1.pdf b/Master/texmf-dist/doc/man/man1/odvicopy.man1.pdf Binary files differindex 05e61aeeaaf..220da8134b7 100644 --- a/Master/texmf-dist/doc/man/man1/odvicopy.man1.pdf +++ b/Master/texmf-dist/doc/man/man1/odvicopy.man1.pdf diff --git a/Master/texmf-dist/doc/man/man1/odvitype.man1.pdf b/Master/texmf-dist/doc/man/man1/odvitype.man1.pdf Binary files differindex 0b56335ccba..46b27d4eb84 100644 --- a/Master/texmf-dist/doc/man/man1/odvitype.man1.pdf +++ b/Master/texmf-dist/doc/man/man1/odvitype.man1.pdf diff --git a/Master/texmf-dist/doc/man/man1/ofm2opl.1 b/Master/texmf-dist/doc/man/man1/ofm2opl.1 index fd549cded10..81c4116f2ea 100644 --- a/Master/texmf-dist/doc/man/man1/ofm2opl.1 +++ b/Master/texmf-dist/doc/man/man1/ofm2opl.1 @@ -1,4 +1,4 @@ -.TH OFM2OPL 1 "14 April 2016" "Web2C 2021" +.TH OFM2OPL 1 "14 April 2016" "Web2C 2022" .PP .SH "NAME" ofm2opl \- convert Omega and TeX font-metric files to property-list files diff --git a/Master/texmf-dist/doc/man/man1/ofm2opl.man1.pdf b/Master/texmf-dist/doc/man/man1/ofm2opl.man1.pdf Binary files differindex d244192a7df..b9f76f87277 100644 --- a/Master/texmf-dist/doc/man/man1/ofm2opl.man1.pdf +++ b/Master/texmf-dist/doc/man/man1/ofm2opl.man1.pdf diff --git a/Master/texmf-dist/doc/man/man1/opl2ofm.1 b/Master/texmf-dist/doc/man/man1/opl2ofm.1 index 19f86472f17..7be366d9c87 100644 --- a/Master/texmf-dist/doc/man/man1/opl2ofm.1 +++ b/Master/texmf-dist/doc/man/man1/opl2ofm.1 @@ -1,4 +1,4 @@ -.TH OPL2OFM 1 "16 June 2015" "Web2C 2021" +.TH OPL2OFM 1 "16 June 2015" "Web2C 2022" .PP .SH "NAME" opl2ofm \- convert Omega and TeX property-list files to font-metric files diff --git a/Master/texmf-dist/doc/man/man1/opl2ofm.man1.pdf b/Master/texmf-dist/doc/man/man1/opl2ofm.man1.pdf Binary files differindex 807766d2980..dfb95bb5d9e 100644 --- a/Master/texmf-dist/doc/man/man1/opl2ofm.man1.pdf +++ b/Master/texmf-dist/doc/man/man1/opl2ofm.man1.pdf diff --git a/Master/texmf-dist/doc/man/man1/otangle.man1.pdf b/Master/texmf-dist/doc/man/man1/otangle.man1.pdf Binary files differindex c936e5b3b2b..af0d3ead7b1 100644 --- a/Master/texmf-dist/doc/man/man1/otangle.man1.pdf +++ b/Master/texmf-dist/doc/man/man1/otangle.man1.pdf diff --git a/Master/texmf-dist/doc/man/man1/ovf2ovp.1 b/Master/texmf-dist/doc/man/man1/ovf2ovp.1 index 0c9999b2a5d..0ff9ca1c867 100644 --- a/Master/texmf-dist/doc/man/man1/ovf2ovp.1 +++ b/Master/texmf-dist/doc/man/man1/ovf2ovp.1 @@ -1,4 +1,4 @@ -.TH OVF2OVP 1 "14 April 2016" "Web2C 2021" +.TH OVF2OVP 1 "14 April 2016" "Web2C 2022" .PP .SH "NAME" ovf2ovp \- convert virtual font file and associated font metrics to property-list format diff --git a/Master/texmf-dist/doc/man/man1/ovf2ovp.man1.pdf b/Master/texmf-dist/doc/man/man1/ovf2ovp.man1.pdf Binary files differindex cdd6a1407dd..55cdbbaad6f 100644 --- a/Master/texmf-dist/doc/man/man1/ovf2ovp.man1.pdf +++ b/Master/texmf-dist/doc/man/man1/ovf2ovp.man1.pdf diff --git a/Master/texmf-dist/doc/man/man1/ovp2ovf.1 b/Master/texmf-dist/doc/man/man1/ovp2ovf.1 index 1d7fe4f0f1c..e9d6d6e746f 100644 --- a/Master/texmf-dist/doc/man/man1/ovp2ovf.1 +++ b/Master/texmf-dist/doc/man/man1/ovp2ovf.1 @@ -1,4 +1,4 @@ -.TH OVP2OVF 1 "16 June 2015" "Web2C 2021" +.TH OVP2OVF 1 "16 June 2015" "Web2C 2022" .PP .SH "NAME" ovp2ovf \- convert a virtual property-list file into a virtual font file and its associated font metric file diff --git a/Master/texmf-dist/doc/man/man1/ovp2ovf.man1.pdf b/Master/texmf-dist/doc/man/man1/ovp2ovf.man1.pdf Binary files differindex 5b9600cf39d..d172c9cf7ec 100644 --- a/Master/texmf-dist/doc/man/man1/ovp2ovf.man1.pdf +++ b/Master/texmf-dist/doc/man/man1/ovp2ovf.man1.pdf diff --git a/Master/texmf-dist/doc/man/man1/patgen.1 b/Master/texmf-dist/doc/man/man1/patgen.1 index d9be7d3dd8d..a44306d8e19 100644 --- a/Master/texmf-dist/doc/man/man1/patgen.1 +++ b/Master/texmf-dist/doc/man/man1/patgen.1 @@ -1,4 +1,4 @@ -.TH PATGEN 1 "16 June 2015" "Web2C 2021" +.TH PATGEN 1 "16 June 2015" "Web2C 2022" .\"===================================================================== .if t .ds TX \fRT\\h'-0.1667m'\\v'0.20v'E\\v'-0.20v'\\h'-0.125m'X\fP .if n .ds TX TeX diff --git a/Master/texmf-dist/doc/man/man1/patgen.man1.pdf b/Master/texmf-dist/doc/man/man1/patgen.man1.pdf Binary files differindex 6b75b5c944d..daf220a1730 100644 --- a/Master/texmf-dist/doc/man/man1/patgen.man1.pdf +++ b/Master/texmf-dist/doc/man/man1/patgen.man1.pdf diff --git a/Master/texmf-dist/doc/man/man1/pbibtex.1 b/Master/texmf-dist/doc/man/man1/pbibtex.1 new file mode 100644 index 00000000000..eab161fd41e --- /dev/null +++ b/Master/texmf-dist/doc/man/man1/pbibtex.1 @@ -0,0 +1,87 @@ +.TH PBIBTEX 1 "24 July 2021" "Web2C 2022" +.\"===================================================================== +.if t .ds TX \fRT\\h'-0.1667m'\\v'0.20v'E\\v'-0.20v'\\h'-0.125m'X\fP +.if n .ds TX TeX +.ie t .ds OX \fIT\v'+0.25m'E\v'-0.25m'X\fP\" +.el .ds OX TeX\" +.\" BX definition must follow TX so BX can use TX +.if t .ds BX \fRB\s-2IB\s0\fP\*(TX +.if n .ds BX BibTeX +.\" LX definition must follow TX so LX can use TX +.if t .ds LX \fRL\\h'-0.36m'\\v'-0.15v'\s-2A\s0\\h'-0.15m'\\v'0.15v'\fP\*(TX +.if n .ds LX LaTeX +.\"===================================================================== +.SH NAME +pbibtex, upbibtex \- make a (Japanese) bibliography for (La)TeX +.SH SYNOPSIS +.B pbibtex +.RI [ options ] +.IR auxname [ \fB.aux\fP ] +.SH DESCRIPTION +p\*(BX (\fBpbibtex\fR) +is a modified version of \*(BX for Japanese handling. +It sorts entries according to code points in EUC-JP. +Also, a new built-in function +.B is.kanji.str$ +which determines whether an entry is outside ASCII is introduced. +.PP +up\*(BX (\fBupbibtex\fR) +is a modified version of p\*(BX, +which sorts entries according to code points in Unicode. +.SH Extensions to Bibliography Style Functions +A new built-in function is available, and some other functions +are modified to simplify Japanese handling. +.PP +.TP 5 +.B is.kanji.str$ +[New feature] +Pops the top (string) literal to see if it contains any non-ASCII +characters. Pushes 1 if it contains at least one, 0 if not. +.PP +.TP 5 +.B substring$ +Modified to avoid dividing a character string in the middle of +a multibyte character. +.PP +.TP 5 +.B text.prefix$ +Similar modification to +.B substring$ +described above. +.PP +.TP 5 +.B add.period$ +Modified to prevent appending "." after Japanese punctuations +corresponding to "!", "?" and "." +(e.g. U+FF01, U+FF1F, U+3002 and U+FF0E). +.PP +.TP 5 +.B format.name$ +Modified to accept Japanese \fIzenkaku\fR ideographic space +(U+3000) for names displayed in Japanese. +Also modified to recognize Japanese commas (U+3001 and U+FF0C) +similar to "and" between names. +.\"===================================================================== +.SH "SEE ALSO" +.BR bibtex (1), +.BR ptex (1). +.\"===================================================================== +.SH AUTHORS +.PP +Japanese version of \*(BX was originally developed by Shouichi Matsui +as J\*(BX until 1991. +It was developed to behave consistently with NTT J\*(TX in handling +legacy Japanese encodings. +The old documentations jbibtex.pdf, jbtxdoc.tex, jbtxhak.tex +(all available in \*(TX Live) +describe Japanese handling capability and some additional notes +of J\*(BX. +.PP +Current (u)p\*(BX is a forked version of J\*(BX, +and has replaced the encoding conversion routine with one that is +compatible with (u)p\*(TX community edition using the ptexenc library. +Note that descriptions of encodings in the old documentations +j*.pdf (especially Section 3.3 of jbibtex.pdf, such as BIBTERMCODE +and BIBFILECODE) are incorrect anymore. +.PP +This manual page was written by Hironobu Yamashita. diff --git a/Master/texmf-dist/doc/man/man1/pbibtex.man1.pdf b/Master/texmf-dist/doc/man/man1/pbibtex.man1.pdf Binary files differnew file mode 100644 index 00000000000..32971538a27 --- /dev/null +++ b/Master/texmf-dist/doc/man/man1/pbibtex.man1.pdf diff --git a/Master/texmf-dist/doc/man/man1/pdfcslatex.man1.pdf b/Master/texmf-dist/doc/man/man1/pdfcslatex.man1.pdf Binary files differindex 485b3d4604c..e133320fd1d 100644 --- a/Master/texmf-dist/doc/man/man1/pdfcslatex.man1.pdf +++ b/Master/texmf-dist/doc/man/man1/pdfcslatex.man1.pdf diff --git a/Master/texmf-dist/doc/man/man1/pdfetex.1 b/Master/texmf-dist/doc/man/man1/pdfetex.1 index 212e8e888c3..7117527a249 100644 --- a/Master/texmf-dist/doc/man/man1/pdfetex.1 +++ b/Master/texmf-dist/doc/man/man1/pdfetex.1 @@ -1,4 +1,4 @@ -.TH PDFETEX 1 "16 June 2015" "Web2C 2021" +.TH PDFETEX 1 "16 June 2015" "Web2C 2022" .\"===================================================================== .if n .ds MF Metafont .if t .ds MF Metafont diff --git a/Master/texmf-dist/doc/man/man1/pdfetex.man1.pdf b/Master/texmf-dist/doc/man/man1/pdfetex.man1.pdf Binary files differindex 6cfb218a55b..4226b20ad56 100644 --- a/Master/texmf-dist/doc/man/man1/pdfetex.man1.pdf +++ b/Master/texmf-dist/doc/man/man1/pdfetex.man1.pdf diff --git a/Master/texmf-dist/doc/man/man1/pdflatex-dev.man1.pdf b/Master/texmf-dist/doc/man/man1/pdflatex-dev.man1.pdf Binary files differindex 473f3301294..9aa27ffee70 100644 --- a/Master/texmf-dist/doc/man/man1/pdflatex-dev.man1.pdf +++ b/Master/texmf-dist/doc/man/man1/pdflatex-dev.man1.pdf diff --git a/Master/texmf-dist/doc/man/man1/pdflatex.man1.pdf b/Master/texmf-dist/doc/man/man1/pdflatex.man1.pdf Binary files differindex 638aa5cb0a4..187c26c517d 100644 --- a/Master/texmf-dist/doc/man/man1/pdflatex.man1.pdf +++ b/Master/texmf-dist/doc/man/man1/pdflatex.man1.pdf diff --git a/Master/texmf-dist/doc/man/man1/pdftex.1 b/Master/texmf-dist/doc/man/man1/pdftex.1 index e723af08d80..5be9a27c33b 100644 --- a/Master/texmf-dist/doc/man/man1/pdftex.1 +++ b/Master/texmf-dist/doc/man/man1/pdftex.1 @@ -1,4 +1,4 @@ -.TH PDFTEX 1 "6 August 2019" "Web2C 2021" +.TH PDFTEX 1 "6 August 2019" "Web2C 2022" .\"===================================================================== .if n .ds MF Metafont .if t .ds MF Metafont diff --git a/Master/texmf-dist/doc/man/man1/pdftex.man1.pdf b/Master/texmf-dist/doc/man/man1/pdftex.man1.pdf Binary files differindex 62c8660fc28..d0fd575f46b 100644 --- a/Master/texmf-dist/doc/man/man1/pdftex.man1.pdf +++ b/Master/texmf-dist/doc/man/man1/pdftex.man1.pdf diff --git a/Master/texmf-dist/doc/man/man1/pdftosrc.1 b/Master/texmf-dist/doc/man/man1/pdftosrc.1 index e031108e249..f0fb5d43fde 100644 --- a/Master/texmf-dist/doc/man/man1/pdftosrc.1 +++ b/Master/texmf-dist/doc/man/man1/pdftosrc.1 @@ -1,4 +1,4 @@ -.TH pdftosrc 1 "16 June 2015" "Web2C 2021" +.TH pdftosrc 1 "16 June 2015" "Web2C 2022" .SH NAME pdftosrc \- extract source file or stream from PDF file .SH SYNOPSIS diff --git a/Master/texmf-dist/doc/man/man1/pdftosrc.man1.pdf b/Master/texmf-dist/doc/man/man1/pdftosrc.man1.pdf Binary files differindex 9d8cd10dfa1..8295c9cc2fd 100644 --- a/Master/texmf-dist/doc/man/man1/pdftosrc.man1.pdf +++ b/Master/texmf-dist/doc/man/man1/pdftosrc.man1.pdf diff --git a/Master/texmf-dist/doc/man/man1/pktogf.1 b/Master/texmf-dist/doc/man/man1/pktogf.1 index a89c61d49a3..42745f55482 100644 --- a/Master/texmf-dist/doc/man/man1/pktogf.1 +++ b/Master/texmf-dist/doc/man/man1/pktogf.1 @@ -1,4 +1,4 @@ -.TH PKTOGF 1 "16 June 2015" "Web2C 2021" +.TH PKTOGF 1 "16 June 2015" "Web2C 2022" .\"===================================================================== .if n .ds MF Metafont .if t .ds MF Metafont diff --git a/Master/texmf-dist/doc/man/man1/pktogf.man1.pdf b/Master/texmf-dist/doc/man/man1/pktogf.man1.pdf Binary files differindex 541b0e35ad0..2554cb7259b 100644 --- a/Master/texmf-dist/doc/man/man1/pktogf.man1.pdf +++ b/Master/texmf-dist/doc/man/man1/pktogf.man1.pdf diff --git a/Master/texmf-dist/doc/man/man1/pktype.1 b/Master/texmf-dist/doc/man/man1/pktype.1 index 93faf8ef118..abd9ce05100 100644 --- a/Master/texmf-dist/doc/man/man1/pktype.1 +++ b/Master/texmf-dist/doc/man/man1/pktype.1 @@ -1,4 +1,4 @@ -.TH PKTYPE 1 "16 June 2015" "Web2C 2021" +.TH PKTYPE 1 "16 June 2015" "Web2C 2022" .\"===================================================================== .if n .ds MF Metafont .if t .ds MF Metafont diff --git a/Master/texmf-dist/doc/man/man1/pktype.man1.pdf b/Master/texmf-dist/doc/man/man1/pktype.man1.pdf Binary files differindex 93cf29cda8d..23bc0ca0ffb 100644 --- a/Master/texmf-dist/doc/man/man1/pktype.man1.pdf +++ b/Master/texmf-dist/doc/man/man1/pktype.man1.pdf diff --git a/Master/texmf-dist/doc/man/man1/platex-dev.man1.pdf b/Master/texmf-dist/doc/man/man1/platex-dev.man1.pdf Binary files differindex 1b50a640b70..8694c408954 100644 --- a/Master/texmf-dist/doc/man/man1/platex-dev.man1.pdf +++ b/Master/texmf-dist/doc/man/man1/platex-dev.man1.pdf diff --git a/Master/texmf-dist/doc/man/man1/platex.man1.pdf b/Master/texmf-dist/doc/man/man1/platex.man1.pdf Binary files differindex a58a2b80114..e518cd7f69b 100644 --- a/Master/texmf-dist/doc/man/man1/platex.man1.pdf +++ b/Master/texmf-dist/doc/man/man1/platex.man1.pdf diff --git a/Master/texmf-dist/doc/man/man1/pltotf.1 b/Master/texmf-dist/doc/man/man1/pltotf.1 index 15105775050..aa1e6819848 100644 --- a/Master/texmf-dist/doc/man/man1/pltotf.1 +++ b/Master/texmf-dist/doc/man/man1/pltotf.1 @@ -1,4 +1,4 @@ -.TH PLTOTF 1 "16 June 2015" "Web2C 2021" +.TH PLTOTF 1 "16 June 2015" "Web2C 2022" .\"===================================================================== .if n .ds MF Metafont .if t .ds MF Metafont diff --git a/Master/texmf-dist/doc/man/man1/pltotf.man1.pdf b/Master/texmf-dist/doc/man/man1/pltotf.man1.pdf Binary files differindex 058f569f330..d58c0b7521d 100644 --- a/Master/texmf-dist/doc/man/man1/pltotf.man1.pdf +++ b/Master/texmf-dist/doc/man/man1/pltotf.man1.pdf diff --git a/Master/texmf-dist/doc/man/man1/pooltype.1 b/Master/texmf-dist/doc/man/man1/pooltype.1 index f574bf1934b..5cbdd846fd4 100644 --- a/Master/texmf-dist/doc/man/man1/pooltype.1 +++ b/Master/texmf-dist/doc/man/man1/pooltype.1 @@ -1,4 +1,4 @@ -.TH POOLTYPE 1 "16 June 2015" "Web2C 2021" +.TH POOLTYPE 1 "16 June 2015" "Web2C 2022" .\"===================================================================== .if t .ds TX \fRT\\h'-0.1667m'\\v'0.20v'E\\v'-0.20v'\\h'-0.125m'X\fP .if n .ds TX TeX diff --git a/Master/texmf-dist/doc/man/man1/pooltype.man1.pdf b/Master/texmf-dist/doc/man/man1/pooltype.man1.pdf Binary files differindex e89f4001dca..601df89a536 100644 --- a/Master/texmf-dist/doc/man/man1/pooltype.man1.pdf +++ b/Master/texmf-dist/doc/man/man1/pooltype.man1.pdf diff --git a/Master/texmf-dist/doc/man/man1/ppltotf.1 b/Master/texmf-dist/doc/man/man1/ppltotf.1 index 9456111b6a6..f0df5b64501 100644 --- a/Master/texmf-dist/doc/man/man1/ppltotf.1 +++ b/Master/texmf-dist/doc/man/man1/ppltotf.1 @@ -1,4 +1,4 @@ -.TH PPLTOTF 1 "15 March 2019" "Web2C 2021" +.TH PPLTOTF 1 "15 March 2019" "Web2C 2022" .\"===================================================================== .if t .ds TX \fRT\\h'-0.1667m'\\v'0.20v'E\\v'-0.20v'\\h'-0.125m'X\fP .if n .ds TX TeX diff --git a/Master/texmf-dist/doc/man/man1/ppltotf.man1.pdf b/Master/texmf-dist/doc/man/man1/ppltotf.man1.pdf Binary files differindex 93cd87c3bb3..e5052f907cf 100644 --- a/Master/texmf-dist/doc/man/man1/ppltotf.man1.pdf +++ b/Master/texmf-dist/doc/man/man1/ppltotf.man1.pdf diff --git a/Master/texmf-dist/doc/man/man1/ps2eps.1 b/Master/texmf-dist/doc/man/man1/ps2eps.1 index d74e88ca34f..ee7fb829a74 100644 --- a/Master/texmf-dist/doc/man/man1/ps2eps.1 +++ b/Master/texmf-dist/doc/man/man1/ps2eps.1 @@ -3,17 +3,17 @@ .\" <http://shell.ipoline.com/~elmert/comp/docbook2X/> .\" Please send any bug reports, improvements, comments, patches, .\" etc. to Steve Cheng <steve@ggi-project.org>. -.TH "PS2EPS" "1" "31 August 2010" "" "" +.TH "PS2EPS" "1" "September 1st, 2018" "" "" .SH NAME ps2eps \- convert PostScript to EPS (Encapsulated PostScript) files .SH SYNOPSIS -\fBps2eps\fR [ \fB-f\fR ] [ \fB-q\fR ] [ \fB-N\fR ] [ \fB-O\fR ] [ \fB-n\fR ] [ \fB-P\fR ] [ \fB-c\fR ] [ \fB-C\fR ] [ \fB-m\fR ] [ \fB-B\fR ] [ \fB-E\fR ] [ \fB-s \fIpagedim\fB\fR ] [ \fB-t \fIoffset\fB\fR ] [ \fB-r \fIresolution\fB\fR ] [ \fB-R \fI+|-|^\fB\fR ] [ \fB-l\fR ] [ \fB-g\fR ] [ \fB-H\fR ] [ \fB-d\fR ] [ \fB-h|--help\fR ] [ \fB-a\fR ] [ \fB-W\fR ] [ \fB-L\fR ] [ \fB-V|--version\fR ] [ \fB--\fR ] [ \fB\fIpsfile1\fB\fR ] [ \fB\fIpsfile2\fB\fR ] [ \fB\fI\&...\fB\fR ] +\fBps2eps\fR [ \fB-f\fR ] [ \fB-q\fR ] [ \fB-N\fR ] [ \fB-O\fR ] [ \fB-X\fR ] [ \fB-n\fR ] [ \fB-P\fR ] [ \fB-c\fR ] [ \fB-C\fR ] [ \fB-m\fR ] [ \fB-B\fR ] [ \fB-E\fR ] [ \fB-s \fIpagedim\fB\fR ] [ \fB-t \fIoffset\fB\fR ] [ \fB-r \fIresolution\fB\fR ] [ \fB-R \fI+|-|^\fB\fR ] [ \fB-l\fR ] [ \fB-g\fR ] [ \fB-H\fR ] [ \fB-d\fR ] [ \fB-h|--help\fR ] [ \fB-a\fR ] [ \fB-W\fR ] [ \fB-L\fR ] [ \fB-V|--version\fR ] [ \fB--\fR ] [ \fB\fIpsfile1\fB\fR ] [ \fB\fIpsfile2\fB\fR ] [ \fB\fI\&...\fB\fR ] .SH "DESCRIPTION" .PP -This manual page documents \fBps2eps\fR version 1.68. +This manual page documents \fBps2eps\fR version 1.70. .PP \fBps2eps\fR is a tool (written in Perl) to produce Encapsulated PostScript Files (EPS/EPSF) from usual one-paged Postscript @@ -21,6 +21,9 @@ documents. It calculates correct Bounding Boxes for those EPS files and filters some special postscript command sequences that can produce erroneous results on printers. EPS files are often needed for including (scalable) graphics of high quality into TeX/LaTeX (or even Word) documents. +It can also be used to calculate correct BoundingBoxes for PDF files by +using the option \fB--BBonly\fR\&. However, it cannot produce +a PDF file, but it can be used together with \fBpdfcrop\fR\&. .PP Without any argument, ps2eps reads from standard input and writes to standard output. @@ -64,6 +67,16 @@ instructions are added around the original postscript code by \fB-O, --preserveorientation \fR do not filter %%Orientation: header comment. .TP +\fB-X, --BBonly \fR +Just print the resulting bounding box(es) to standard error, no output file is written. +\fBps2eps\fR will perform a read-only operation. This is highly useful to calculate bounding boxes of +PDF files. Can be used with option \fB--quiet\fR to suppress other output and +also with \fB--nohires\fR to suppress output of the HiResBoundingBox. +It can be used with \fBpdfcrop\fR as follows: +\fBpdfcrop --gscmd 'gswrap-ps2eps.sh' file.pdf\fR +where \fBgswrap-ps2eps.sh\fR containts something like +\fBps2eps -l -X -q $BASH_ARGV\fR +.TP \fB-n, --nofix \fR do not try to fix postscript code by filtering some instructions. .TP diff --git a/Master/texmf-dist/doc/man/man1/ps2eps.man1.pdf b/Master/texmf-dist/doc/man/man1/ps2eps.man1.pdf Binary files differindex 6d457872e1e..e87d4d8da6d 100644 --- a/Master/texmf-dist/doc/man/man1/ps2eps.man1.pdf +++ b/Master/texmf-dist/doc/man/man1/ps2eps.man1.pdf diff --git a/Master/texmf-dist/doc/man/man1/ptex.1 b/Master/texmf-dist/doc/man/man1/ptex.1 index baaf2ef275b..874f25194c6 100644 --- a/Master/texmf-dist/doc/man/man1/ptex.1 +++ b/Master/texmf-dist/doc/man/man1/ptex.1 @@ -1,4 +1,4 @@ -.TH PTEX 1 "27 May 2018" "Web2C 2021" +.TH PTEX 1 "08 August 2021" "Web2C 2022" .\"===================================================================== .if t .ds TX \fRT\\h'-0.1667m'\\v'0.20v'E\\v'-0.20v'\\h'-0.125m'X\fP .if n .ds TX TeX @@ -82,6 +82,8 @@ In this version of (e-)(u)p\*(TX, enc\*(TX extensions are .SH "SEE ALSO" .BR tex (1), .BR etex (1). +.br +Reference manual: <https://github.com/texjporg/ptex-manual> .\"===================================================================== .SH AUTHORS This version of (e-)(u)p\*(TX is maintained by diff --git a/Master/texmf-dist/doc/man/man1/ptex.man1.pdf b/Master/texmf-dist/doc/man/man1/ptex.man1.pdf Binary files differindex 01dc3f8205a..1b46d5202b7 100644 --- a/Master/texmf-dist/doc/man/man1/ptex.man1.pdf +++ b/Master/texmf-dist/doc/man/man1/ptex.man1.pdf diff --git a/Master/texmf-dist/doc/man/man1/ptftopl.1 b/Master/texmf-dist/doc/man/man1/ptftopl.1 index bc3457bddcb..6a9d2a534a2 100644 --- a/Master/texmf-dist/doc/man/man1/ptftopl.1 +++ b/Master/texmf-dist/doc/man/man1/ptftopl.1 @@ -1,4 +1,4 @@ -.TH PTFTOPL 1 "15 March 2019" "Web2C 2021" +.TH PTFTOPL 1 "15 March 2019" "Web2C 2022" .\"===================================================================== .if t .ds TX \fRT\\h'-0.1667m'\\v'0.20v'E\\v'-0.20v'\\h'-0.125m'X\fP .if n .ds TX TeX diff --git a/Master/texmf-dist/doc/man/man1/ptftopl.man1.pdf b/Master/texmf-dist/doc/man/man1/ptftopl.man1.pdf Binary files differindex 1f59d992927..9b7d165e565 100644 --- a/Master/texmf-dist/doc/man/man1/ptftopl.man1.pdf +++ b/Master/texmf-dist/doc/man/man1/ptftopl.man1.pdf diff --git a/Master/texmf-dist/doc/man/man1/tangle.1 b/Master/texmf-dist/doc/man/man1/tangle.1 index ee735a0de6d..9c2347e3a1d 100644 --- a/Master/texmf-dist/doc/man/man1/tangle.1 +++ b/Master/texmf-dist/doc/man/man1/tangle.1 @@ -1,4 +1,4 @@ -.TH TANGLE 1 "16 June 2015" "Web2C 2021" +.TH TANGLE 1 "16 June 2015" "Web2C 2022" .\"===================================================================== .if n .ds MF Metafont .if t .ds MF Metafont diff --git a/Master/texmf-dist/doc/man/man1/tangle.man1.pdf b/Master/texmf-dist/doc/man/man1/tangle.man1.pdf Binary files differindex 217f0bf0bae..2d73f8b3d5e 100644 --- a/Master/texmf-dist/doc/man/man1/tangle.man1.pdf +++ b/Master/texmf-dist/doc/man/man1/tangle.man1.pdf diff --git a/Master/texmf-dist/doc/man/man1/tex.1 b/Master/texmf-dist/doc/man/man1/tex.1 index a0c1ed56897..747d18f270e 100644 --- a/Master/texmf-dist/doc/man/man1/tex.1 +++ b/Master/texmf-dist/doc/man/man1/tex.1 @@ -1,4 +1,4 @@ -.TH TEX 1 "6 August 2019" "Web2C 2021" +.TH TEX 1 "6 August 2019" "Web2C 2022" .\"===================================================================== .if n .ds MF Metafont .if t .ds MF Metafont diff --git a/Master/texmf-dist/doc/man/man1/tex.man1.pdf b/Master/texmf-dist/doc/man/man1/tex.man1.pdf Binary files differindex 8cb8adcd202..9947d5c257f 100644 --- a/Master/texmf-dist/doc/man/man1/tex.man1.pdf +++ b/Master/texmf-dist/doc/man/man1/tex.man1.pdf diff --git a/Master/texmf-dist/doc/man/man1/texlua.man1.pdf b/Master/texmf-dist/doc/man/man1/texlua.man1.pdf Binary files differindex bcc237a144b..a860efe2885 100644 --- a/Master/texmf-dist/doc/man/man1/texlua.man1.pdf +++ b/Master/texmf-dist/doc/man/man1/texlua.man1.pdf diff --git a/Master/texmf-dist/doc/man/man1/texluac.man1.pdf b/Master/texmf-dist/doc/man/man1/texluac.man1.pdf Binary files differindex 5939358de9a..076b811e2c3 100644 --- a/Master/texmf-dist/doc/man/man1/texluac.man1.pdf +++ b/Master/texmf-dist/doc/man/man1/texluac.man1.pdf diff --git a/Master/texmf-dist/doc/man/man1/tftopl.1 b/Master/texmf-dist/doc/man/man1/tftopl.1 index 21aaadab930..7c7d84b4dc1 100644 --- a/Master/texmf-dist/doc/man/man1/tftopl.1 +++ b/Master/texmf-dist/doc/man/man1/tftopl.1 @@ -1,4 +1,4 @@ -.TH TFTOPL 1 "16 June 2015" "Web2C 2021" +.TH TFTOPL 1 "16 June 2015" "Web2C 2022" .\"===================================================================== .if n .ds MF Metafont .if t .ds MF Metafont diff --git a/Master/texmf-dist/doc/man/man1/tftopl.man1.pdf b/Master/texmf-dist/doc/man/man1/tftopl.man1.pdf Binary files differindex 5615ad4b2a6..606563abd78 100644 --- a/Master/texmf-dist/doc/man/man1/tftopl.man1.pdf +++ b/Master/texmf-dist/doc/man/man1/tftopl.man1.pdf diff --git a/Master/texmf-dist/doc/man/man1/tie.1 b/Master/texmf-dist/doc/man/man1/tie.1 index c6297e43449..a206ebb46bc 100644 --- a/Master/texmf-dist/doc/man/man1/tie.1 +++ b/Master/texmf-dist/doc/man/man1/tie.1 @@ -1,4 +1,4 @@ -.TH TIE 1 "8 June 2020" "Web2C 2021" +.TH TIE 1 "8 June 2020" "Web2C 2022" .\"===================================================================== .SH NAME tie \- merge or apply WEB change files diff --git a/Master/texmf-dist/doc/man/man1/tie.man1.pdf b/Master/texmf-dist/doc/man/man1/tie.man1.pdf Binary files differindex b2cc1974375..45c021be63e 100644 --- a/Master/texmf-dist/doc/man/man1/tie.man1.pdf +++ b/Master/texmf-dist/doc/man/man1/tie.man1.pdf diff --git a/Master/texmf-dist/doc/man/man1/ttf2afm.1 b/Master/texmf-dist/doc/man/man1/ttf2afm.1 index aada6b2226c..acbedecd5bb 100644 --- a/Master/texmf-dist/doc/man/man1/ttf2afm.1 +++ b/Master/texmf-dist/doc/man/man1/ttf2afm.1 @@ -1,4 +1,4 @@ -.TH TTF2AFM 1 "8 March 2016" "Web2C 2021" +.TH TTF2AFM 1 "8 March 2016" "Web2C 2022" .PP .SH "NAME" ttf2afm \- utility to generate AFM files for TrueType fonts diff --git a/Master/texmf-dist/doc/man/man1/ttf2afm.man1.pdf b/Master/texmf-dist/doc/man/man1/ttf2afm.man1.pdf Binary files differindex b85fe4dc11d..c878a0aa49f 100644 --- a/Master/texmf-dist/doc/man/man1/ttf2afm.man1.pdf +++ b/Master/texmf-dist/doc/man/man1/ttf2afm.man1.pdf diff --git a/Master/texmf-dist/doc/man/man1/upbibtex.1 b/Master/texmf-dist/doc/man/man1/upbibtex.1 new file mode 100644 index 00000000000..f380bd24282 --- /dev/null +++ b/Master/texmf-dist/doc/man/man1/upbibtex.1 @@ -0,0 +1 @@ +.so man1/pbibtex.1 diff --git a/Master/texmf-dist/doc/man/man1/upbibtex.man1.pdf b/Master/texmf-dist/doc/man/man1/upbibtex.man1.pdf Binary files differnew file mode 100644 index 00000000000..717f690fce3 --- /dev/null +++ b/Master/texmf-dist/doc/man/man1/upbibtex.man1.pdf diff --git a/Master/texmf-dist/doc/man/man1/updmap-sys.man1.pdf b/Master/texmf-dist/doc/man/man1/updmap-sys.man1.pdf Binary files differindex 26db31e53bc..bd90cced110 100644 --- a/Master/texmf-dist/doc/man/man1/updmap-sys.man1.pdf +++ b/Master/texmf-dist/doc/man/man1/updmap-sys.man1.pdf diff --git a/Master/texmf-dist/doc/man/man1/updmap-user.man1.pdf b/Master/texmf-dist/doc/man/man1/updmap-user.man1.pdf Binary files differindex 6e4b50e25a4..e1b0496e358 100644 --- a/Master/texmf-dist/doc/man/man1/updmap-user.man1.pdf +++ b/Master/texmf-dist/doc/man/man1/updmap-user.man1.pdf diff --git a/Master/texmf-dist/doc/man/man1/updmap.1 b/Master/texmf-dist/doc/man/man1/updmap.1 index d716d66ac64..c72ae139fec 100644 --- a/Master/texmf-dist/doc/man/man1/updmap.1 +++ b/Master/texmf-dist/doc/man/man1/updmap.1 @@ -1,60 +1,33 @@ -.\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.48.2. -.TH UPDMAP "1" "May 2021" "TeX Live" "User Commands" +.\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.45.1. +.TH UPDMAP "1" "May 2014" "TeX Live" "User Commands" .SH NAME -updmap \- manage TeX font maps +updmap \- manage TeX font maps, per-user .br updmap-sys \- manage TeX font maps, system-wide -.br -updmap-user \- manage TeX font maps, per-user .SH SYNOPSIS .B updmap -[\fI\,-user|-sys\/\fR] [\fI\,OPTION\/\fR] ... [\fI\,COMMAND\/\fR] -.br -.B updmap-user [\fI\,OPTION\/\fR] ... [\fI\,COMMAND\/\fR] .br .B updmap-sys [\fI\,OPTION\/\fR] ... [\fI\,COMMAND\/\fR] .SH DESCRIPTION -updmap version r59152 (2021\-05\-09 23:49:52 +0200) +updmap version svn33988 (2014\-05\-12 15:39:32 +0900) .PP -Update the default font map files used by pdftex and dvipdfm(x) -(pdftex.map), dvips (psfonts.map), and optionally pxdvi, as determined -by all configuration files updmap.cfg (usually the ones returned by -running "kpsewhich \fB\-\-all\fR updmap.cfg", but see below). +Update the default font map files used by pdftex, dvips, and dvipdfm(x), +and optionally pxdvi, as determined by all configuration files updmap.cfg +(the ones returned by running "kpsewhich \fB\-\-all\fR updmap.cfg", but see below). .PP Among other things, these map files are used to determine which fonts should be used as bitmaps and which as outlines, and to determine which -font files are included, typically subsetted, in the PDF or PostScript output. -.PP -updmap\-sys (or updmap \fB\-sys\fR) is intended to affect the system\-wide -configuration, while updmap\-user (or updmap \fB\-user\fR) affects personal -configuration files only, overriding the system files. +font files are included in the PDF or PostScript output. .PP -As a consequence, once updmap\-user has been run, even a single time, -running updmap\-sys no longer has any effect. updmap\-sys issues a -warning about this, since it is rarely desirable. -See https://tug.org/texlive/scripts\-sys\-user.html for details. +updmap\-sys is intended to affect the system\-wide configuration, while +updmap affects personal configuration files only, overriding the system +files. As a consequence, once updmap has been run, even a single time, +running updmap\-sys no longer has any effect. (updmap\-sys issues a +warning in this situation.) .PP By default, the TeX filename database (ls\-R) is also updated. -.PP -The updmap system is regrettably complicated, for both inherent and -historical reasons. A general overview: -.PP -\- updmap.cfg files are mainly about listing other files, namely the -.IP -font\-specific .maps, in which each line gives information about a -different TeX (.tfm) font. -.PP -\- updmap reads the updmap.cfg files and then concatenates the -.IP -contents of those .map files into the main output files: psfonts.map -for dvips and pdftex.map for pdftex and dvipdfmx. -.PP -\- The updmap.cfg files themselves are created and updated at package -.IP -installation time, by the system installer or the package manager or -by hand, and not (by default) by updmap. .SH OPTIONS .TP \fB\-\-cnffile\fR FILE @@ -87,14 +60,11 @@ recreate files even if config hasn't changed do not recreate map files .TP \fB\-\-nohash\fR -do not run mktexlsr (a.k.a. texhash) +do not run texhash .TP \fB\-\-sys\fR affect system\-wide files (equivalent to updmap\-sys) .TP -\fB\-\-user\fR -affect personal files (equivalent to updmap\-user) -.TP \fB\-n\fR, \fB\-\-dry\-run\fR only show the configuration, no output .TP @@ -126,57 +96,29 @@ where MAPTYPE is Map, MixedMap, or KanjiMap .TP \fB\-\-enable\fR Map=MAPFILE add "Map MAPFILE" to updmap.cfg -.TP -\fB\-\-enable\fR MixedMap=MAPFILE -add "MixedMap MAPFILE" to updmap.cfg -.TP -\fB\-\-enable\fR KanjiMap=MAPFILE -add "KanjiMap MAPFILE" to updmap.cfg +.HP +\fB\-\-enable\fR MixedMap=MAPFILE add "MixedMap MAPFILE" to updmap.cfg +.HP +\fB\-\-enable\fR KanjiMap=MAPFILE add "KanjiMap MAPFILE" to updmap.cfg .TP \fB\-\-disable\fR MAPFILE disable MAPFILE, of whatever type .TP \fB\-\-listmaps\fR -list all maps (details below) +list all active and inactive maps .TP \fB\-\-listavailablemaps\fR -list available maps (details below) +same as \fB\-\-listmaps\fR, but without +unavailable map files .TP \fB\-\-syncwithtrees\fR disable unavailable map files in updmap.cfg .PP -The main output: -.IP -The main output of updmap is the files containing the individual font -map lines which the drivers (dvips, pdftex, etc.) read to handle fonts. -.IP -The map files for dvips (psfonts.map) and pdftex and dvipdfmx -(pdftex.map) are written to TEXMFVAR/fonts/map/updmap/{dvips,pdftex}/. -.IP -In addition, information about Kanji fonts is written to -TEXMFVAR/fonts/map/updmap/dvipdfmx/kanjix.map, and optionally to -TEXMFVAR/fonts/map/updmap/pxdvi/xdvi\-ptex.map. These are for Kanji -only and are not like other map files. dvipdfmx reads pdftex.map for -the map entries for non\-Kanji fonts. -.IP -If no option is given, so the invocation is just "updmap\-user" or -"updmap\-sys", these output files are always recreated. -.IP -Otherwise, if an option such as \fB\-\-enable\fR or \fB\-\-disable\fR is given, the -output files are recreated if the list of enabled map files (from -updmap.cfg) has changed. The \fB\-\-force\fR option overrides this, -always recreating the output files. -.PP -Explanation of the map types: -.IP -The normal type is Map. -.IP -The only difference between Map and MixedMap is that MixedMap entries -are not added to psfonts_pk.map. The purpose is to help users with -devices that render Type 1 outline fonts worse than mode\-tuned Type 3 -bitmap fonts. So, MixedMap is used for fonts that are available as -both Type 1 and Metafont. -.IP +Explanation of the map types: the (only) difference between Map and +MixedMap is that MixedMap entries are not added to psfonts_pk.map. +The purpose is to help users with devices that render Type 1 outline +fonts worse than mode\-tuned Type 1 bitmap fonts. So, MixedMap is used +for fonts that are available as both Type 1 and Metafont. KanjiMap entries are added to psfonts_t1.map and kanjix.map. .PP Explanation of the OPTION names for \fB\-\-showoptions\fR, \fB\-\-showoption\fR, \fB\-\-setoption\fR: @@ -201,19 +143,10 @@ true,false (default false) .IP Whether maps for pxdvi (Japanese\-patched xdvi) are under updmap's control. .TP -jaEmbed -(any string) -.TP -jaVariant +kanjiEmbed (any string) .TP -scEmbed -(any string) -.TP -tcEmbed -(any string) -.TP -koEmbed +kanjiVariant (any string) .IP See below. @@ -244,24 +177,21 @@ file which the programs read, so they can be overridden by specifying command\-line options or configuration files to the programs, as explained at the beginning of updmap.cfg. .IP -The options jaEmbed and jaVariant (formerly kanjiEmbed and kanjiVariant) -specify special replacements in the map lines. If a map contains the -string @jaEmbed@, then this will be replaced by the value of that option; -similarly for jaVariant. In this way, users of Japanese TeX can select -different fonts to be included in the final output. The counterpart for -Simplified Chinese, Traditional Chinese and Korean fonts are -scEmbed, tcEmbed and koEmbed respectively. +The options kanjiEmbed and kanjiVariant specify special replacements +in the map lines. If a map contains the string @kanjiEmbed@, then +this will be replaced by the value of that option; similarly for +kanjiVariant. In this way, users of Japanese TeX can select different +fonts to be included in the final output. .SH ENVIRONMENT .PP Explanation of trees and files normally used: .IP -If \fB\-\-cnffile\fR is specified on the command line (can be given multiple -times), its value(s) is(are) used. Otherwise, updmap reads all the -updmap.cfg files found by running `kpsewhich \fB\-all\fR updmap.cfg', -in the order returned by kpsewhich (which is the order of trees -defined in texmf.cnf). +If \fB\-\-cnffile\fR is specified on the command line (possibly multiple +times), its value(s) are used. Otherwise, updmap reads all the +updmap.cfg files found by running `kpsewhich \fB\-all\fR updmap.cfg', in the +order returned by kpsewhich. .IP -In either case, if multiple updmap.cfg files are found, all the maps +In any case, if multiple updmap.cfg files are found, all the maps mentioned in all the updmap.cfg files are merged. .IP Thus, if updmap.cfg files are present in all trees, and the default @@ -275,7 +205,7 @@ TEXMFSYSVAR \fI\,$TEXLIVE/YYYY/texmf\-var/web2c/updmap.cfg\/\fP TEXMFLOCAL \fI\,$TEXLIVE/texmf\-local/web2c/updmap.cfg\/\fP TEXMFDIST \fI\,$TEXLIVE/YYYY/texmf\-dist/web2c/updmap.cfg\/\fP .IP -For updmap\-user: +For updmap: TEXMFCONFIG $HOME/.texliveYYYY/texmf\-config/web2c/updmap.cfg TEXMFVAR $HOME/.texliveYYYY/texmf\-var/web2c/updmap.cfg TEXMFHOME \fI\,$HOME/texmf/web2c/updmap.cfg\/\fP @@ -290,31 +220,25 @@ TEXMFDIST \fI\,$TEXLIVE/YYYY/texmf\-dist/web2c/updmap.cfg\/\fP According to the actions, updmap might write to one of the given files or create a new updmap.cfg, described further below. .PP -Where and which updmap.cfg changes are saved: -.IP -When no options are given, the updmap.cfg file(s) are only read, not -written. It's when an option \fB\-\-setoption\fR, \fB\-\-enable\fR or \fB\-\-disable\fR is -specified that an updmap.cfg needs to be updated. In this case: -.IP -1) If config files are given on the command line, then the first one -given is used to save any such changes. +Where changes are saved: .IP -2) If the config files are taken from kpsewhich output, then the -algorithm is more complex: +If config files are given on the command line, then the first one +given will be used to save any changes from \fB\-\-setoption\fR, \fB\-\-enable\fR +or \fB\-\-disable\fR. If the config files are taken from kpsewhich output, +then the algorithm is more complex: .IP -2a) If \fI\,$TEXMFCONFIG/web2c/updmap.cfg\/\fP or \fI\,$TEXMFHOME/web2c/updmap.cfg\/\fP +1) If \fI\,$TEXMFCONFIG/web2c/updmap.cfg\/\fP or \fI\,$TEXMFHOME/web2c/updmap.cfg\/\fP appears in the list of used files, then the one listed first by kpsewhich \fB\-\-all\fR (equivalently, the one returned by kpsewhich updmap.cfg), is used. .IP -2b) If neither of the above two are present and changes are made, a +2) If neither of the above two are present and changes are made, a new config file is created in \fI\,$TEXMFCONFIG/web2c/updmap.cfg\/\fP. .IP -In general, the idea is that if the user cannot write to a given -config file, a higher\-level one can be used. That way, the -distribution's settings can be overridden system\-wide using -TEXMFLOCAL, and system settings can be overridden again in a -particular user's TEXMFHOME or TEXMFCONFIG. +In general, the idea is that if a given config file is not writable, a +higher\-level one can be used. That way, the distribution's settings +can be overridden for system\-wide using TEXMFLOCAL, and then system +settings can be overridden again for a particular using using TEXMFHOME. .PP Resolving multiple definitions of a font: .IP @@ -334,12 +258,8 @@ writing, e.g., or .IP #! MixedMap mapname.map -.TP -in the higher\-priority updmap.cfg file. -(The #! must be at the .IP -beginning of the line, with at least one space or tab afterward, and -whitespace between each word on the list.) +in the higher\-priority updmap.cfg file. .IP As an example, suppose you have a copy of MathTime Pro fonts and want to disable the Belleek version of the fonts; that is, @@ -352,26 +272,16 @@ Map mt\-yy.map .IP and call updmap. .PP -Listing of maps: -.IP -The two options \fB\-\-listmaps\fR and \fB\-\-listavailablemaps\fR list all maps -defined in any of the updmap.cfg files (for \fB\-\-listmaps\fR), and -only those actually found on the system (for \fB\-\-listavailablemaps\fR). -The output format is one line per font map, with the following -fields separated by tabs: map, type (Map, MixedMap, KanjiMap), -status (enabled, disabled), origin (the updmap.cfg file where -it is mentioned, or 'builtin' for the three basic maps). -.IP -In the case of \fB\-\-listmaps\fR there can be one additional fields -(again separated by tab) containing '(not available)' for those -map files that cannot be found. +updmap writes the map files for dvips (psfonts.map) and pdftex +(pdftex.map) to the TEXMFVAR/fonts/map/updmap/{dvips,pdftex}/ +directories. +.PP +The log file is written to TEXMFVAR/web2c/updmap.log. .PP -updmap\-user vs. updmap\-sys: -.IP When updmap\-sys is run, TEXMFSYSCONFIG and TEXMFSYSVAR are used -instead of TEXMFCONFIG and TEXMFVAR, respectively. This is the -primary difference between updmap\-sys and updmap\-user. -.IP +instead of TEXMFCONFIG and TEXMFVAR, respectively. This is the only +difference between updmap\-sys and updmap. +.PP Other locations may be used if you give them on the command line, or these trees don't exist, or you are not using the original TeX Live. .PP @@ -379,11 +289,9 @@ To see the precise locations of the various files that will be read and written, give the \fB\-n\fR option (or read the source). .SH EXAMPLES .PP -The log file is written to TEXMFVAR/web2c/updmap.log. -.PP For step\-by\-step instructions on making new fonts known to TeX, read -https://tug.org/fonts/fontinstall.html. For even more terse -instructions, read the beginning of the main updmap.cfg file. +http://tug.org/fonts/fontinstall.html. For even more terse +instructions, read the beginning of the main updmap.cfg. .SH FILES Configuration and input files: .IP "\fIupdmap\&.cfg\fP" @@ -449,7 +357,7 @@ Loads \fIpsfonts_t1\&.map\fP instead of \fIpsfonts\&.map\fP\&. .IP "\fIconfig\&.pdf\fP" Loads \fIpsfonts_t1\&.map\fP instead -of \fIpsfonts\&.map\fP and has additional settings for PDF generation\&. +of \fIpsfonts\&.map\fP and has additional optimizations for PDF generation\&. .IP "\fIconfig\&.pk\fP" Loads \fIpsfonts_pk\&.map\fP instead of \fIpsfonts\&.map\fP\&. @@ -461,6 +369,6 @@ of \fIpsfonts\&.map\fP\&. Loads \fIpsfonts_t1\&.map\fP instead of \fIpsfonts\&.map\fP\&. .SH "REPORTING BUGS" -Report bugs to: tex\-live@tug.org +Report bugs to: tex\-k@tug.org .br -TeX Live home page: <https://tug.org/texlive/> +TeX Live home page: <http://tug.org/texlive/> diff --git a/Master/texmf-dist/doc/man/man1/updmap.man1.pdf b/Master/texmf-dist/doc/man/man1/updmap.man1.pdf Binary files differindex abd78b636d1..1f6d378daca 100644 --- a/Master/texmf-dist/doc/man/man1/updmap.man1.pdf +++ b/Master/texmf-dist/doc/man/man1/updmap.man1.pdf diff --git a/Master/texmf-dist/doc/man/man1/uplatex-dev.man1.pdf b/Master/texmf-dist/doc/man/man1/uplatex-dev.man1.pdf Binary files differindex fe46575443b..ec9336589bc 100644 --- a/Master/texmf-dist/doc/man/man1/uplatex-dev.man1.pdf +++ b/Master/texmf-dist/doc/man/man1/uplatex-dev.man1.pdf diff --git a/Master/texmf-dist/doc/man/man1/uplatex.man1.pdf b/Master/texmf-dist/doc/man/man1/uplatex.man1.pdf Binary files differindex 492e7b0c3b0..bb8f4e1a871 100644 --- a/Master/texmf-dist/doc/man/man1/uplatex.man1.pdf +++ b/Master/texmf-dist/doc/man/man1/uplatex.man1.pdf diff --git a/Master/texmf-dist/doc/man/man1/uppltotf.man1.pdf b/Master/texmf-dist/doc/man/man1/uppltotf.man1.pdf Binary files differindex b33672c2ee6..8cfb6dbab57 100644 --- a/Master/texmf-dist/doc/man/man1/uppltotf.man1.pdf +++ b/Master/texmf-dist/doc/man/man1/uppltotf.man1.pdf diff --git a/Master/texmf-dist/doc/man/man1/uptex.man1.pdf b/Master/texmf-dist/doc/man/man1/uptex.man1.pdf Binary files differindex eb499bb9323..f31e3a58096 100644 --- a/Master/texmf-dist/doc/man/man1/uptex.man1.pdf +++ b/Master/texmf-dist/doc/man/man1/uptex.man1.pdf diff --git a/Master/texmf-dist/doc/man/man1/uptftopl.man1.pdf b/Master/texmf-dist/doc/man/man1/uptftopl.man1.pdf Binary files differindex 7ff98aea02d..9c6a79f130a 100644 --- a/Master/texmf-dist/doc/man/man1/uptftopl.man1.pdf +++ b/Master/texmf-dist/doc/man/man1/uptftopl.man1.pdf diff --git a/Master/texmf-dist/doc/man/man1/vftovp.1 b/Master/texmf-dist/doc/man/man1/vftovp.1 index f6564ccd998..28dfce27e44 100644 --- a/Master/texmf-dist/doc/man/man1/vftovp.1 +++ b/Master/texmf-dist/doc/man/man1/vftovp.1 @@ -1,4 +1,4 @@ -.TH VFTOVP 1 "16 June 2015" "Web2C 2021" +.TH VFTOVP 1 "16 June 2015" "Web2C 2022" .\"===================================================================== .if t .ds TX \fRT\\h'-0.1667m'\\v'0.20v'E\\v'-0.20v'\\h'-0.125m'X\fP .if n .ds TX TeX diff --git a/Master/texmf-dist/doc/man/man1/vftovp.man1.pdf b/Master/texmf-dist/doc/man/man1/vftovp.man1.pdf Binary files differindex d0056565474..dca69436196 100644 --- a/Master/texmf-dist/doc/man/man1/vftovp.man1.pdf +++ b/Master/texmf-dist/doc/man/man1/vftovp.man1.pdf diff --git a/Master/texmf-dist/doc/man/man1/vptovf.1 b/Master/texmf-dist/doc/man/man1/vptovf.1 index 94a6c89ec53..04df85332c9 100644 --- a/Master/texmf-dist/doc/man/man1/vptovf.1 +++ b/Master/texmf-dist/doc/man/man1/vptovf.1 @@ -1,4 +1,4 @@ -.TH VPTOVF 1 "16 June 2015" "Web2C 2021" +.TH VPTOVF 1 "16 June 2015" "Web2C 2022" .\"===================================================================== .if t .ds TX \fRT\\h'-0.1667m'\\v'0.20v'E\\v'-0.20v'\\h'-0.125m'X\fP .if n .ds TX TeX diff --git a/Master/texmf-dist/doc/man/man1/vptovf.man1.pdf b/Master/texmf-dist/doc/man/man1/vptovf.man1.pdf Binary files differindex 8899c4e6ce2..fd9ea158f3d 100644 --- a/Master/texmf-dist/doc/man/man1/vptovf.man1.pdf +++ b/Master/texmf-dist/doc/man/man1/vptovf.man1.pdf diff --git a/Master/texmf-dist/doc/man/man1/weave.1 b/Master/texmf-dist/doc/man/man1/weave.1 index 0ede4674606..c4de5889e14 100644 --- a/Master/texmf-dist/doc/man/man1/weave.1 +++ b/Master/texmf-dist/doc/man/man1/weave.1 @@ -1,4 +1,4 @@ -.TH WEAVE 1 "16 June 2015" "Web2C 2021" +.TH WEAVE 1 "09 January 2022" "Web2C 2022" .\"===================================================================== .if n .ds MF Metafont .if t .ds MF Metafont @@ -68,7 +68,7 @@ for the details of the searching. .\"===================================================================== .SH FILES .TP \w'@@'u+2n -.I $TEXMFMAIN/tex/plain/base/webmac.tex +.I $TEXMFMAIN/tex/plain/knuth-lib/webmac.tex \*(TX macros used by .B weave output. diff --git a/Master/texmf-dist/doc/man/man1/weave.man1.pdf b/Master/texmf-dist/doc/man/man1/weave.man1.pdf Binary files differindex a765d8e3359..82e3c848c3b 100644 --- a/Master/texmf-dist/doc/man/man1/weave.man1.pdf +++ b/Master/texmf-dist/doc/man/man1/weave.man1.pdf diff --git a/Master/texmf-dist/doc/man/man1/xdvi.1 b/Master/texmf-dist/doc/man/man1/xdvi.1 index 5a15e85eb5d..6e1cf6bcb61 100644 --- a/Master/texmf-dist/doc/man/man1/xdvi.1 +++ b/Master/texmf-dist/doc/man/man1/xdvi.1 @@ -1,4 +1,4 @@ -.\" Copyright 1990-2019 Paul Vojta and others +.\" Copyright 1990-2022 Paul Vojta and others .\" .\" This is Paul's license, included here only for reference, it does not apply .\" to all parts of the k version. @@ -52,7 +52,7 @@ .de SB \&\fB\s-1\&\\$1 \\$2\s0\fR .. -.TH XDVI 1 "2020-02-29" "Xdvik 22.87.04" +.TH XDVI 1 "2022-02-17" "Xdvik 22.87.06" .\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" .\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" .SH NAME @@ -381,6 +381,8 @@ The individual numbers and strings have the following meanings: 32768 ft FreeType library messages (Type 1 fonts) 65536 ft_verbose Verbose FreeType library messages (currently unused) 131072 gui GUI elements + 262144 find Searching for strings in the DVI file + 524288 files File history and opening DVI files .sp 1n .fi Some of the Kpathsea debugging options are actually provided by Kpathsea; @@ -4133,7 +4135,7 @@ directives). the .B Kpathsea documentation, -.BR https://ctan.org/pkg/xdvi/ . +.BR https://ctan.org/pkg/xdvi/ , and the Xdvik home page at .BR http://xdvi.sourceforge.net/ . .SH AUTHORS diff --git a/Master/texmf-dist/doc/man/man1/xdvi.man1.pdf b/Master/texmf-dist/doc/man/man1/xdvi.man1.pdf Binary files differindex 258ef4c4e92..37184c2325b 100644 --- a/Master/texmf-dist/doc/man/man1/xdvi.man1.pdf +++ b/Master/texmf-dist/doc/man/man1/xdvi.man1.pdf diff --git a/Master/texmf-dist/doc/man/man1/xelatex-dev.man1.pdf b/Master/texmf-dist/doc/man/man1/xelatex-dev.man1.pdf Binary files differindex f84c2171935..daebc2d0b50 100644 --- a/Master/texmf-dist/doc/man/man1/xelatex-dev.man1.pdf +++ b/Master/texmf-dist/doc/man/man1/xelatex-dev.man1.pdf diff --git a/Master/texmf-dist/doc/man/man1/xelatex.man1.pdf b/Master/texmf-dist/doc/man/man1/xelatex.man1.pdf Binary files differindex 58e9ef15c4f..36527b1735b 100644 --- a/Master/texmf-dist/doc/man/man1/xelatex.man1.pdf +++ b/Master/texmf-dist/doc/man/man1/xelatex.man1.pdf diff --git a/Master/texmf-dist/doc/man/man1/xetex.1 b/Master/texmf-dist/doc/man/man1/xetex.1 index 3df7cd56ef2..009b61d16a8 100644 --- a/Master/texmf-dist/doc/man/man1/xetex.1 +++ b/Master/texmf-dist/doc/man/man1/xetex.1 @@ -1,4 +1,4 @@ -.TH XETEX 1 "10 July 2018" "Web2C 2021" +.TH XETEX 1 "10 July 2018" "Web2C 2022" .\"===================================================================== .if t .ds TX \fRT\\h'-0.1667m'\\v'0.20v'E\\v'-0.20v'\\h'-0.125m'X\fP .if n .ds TX TeX diff --git a/Master/texmf-dist/doc/man/man1/xetex.man1.pdf b/Master/texmf-dist/doc/man/man1/xetex.man1.pdf Binary files differindex 6e6f1c2fcc1..53b8398ce6b 100644 --- a/Master/texmf-dist/doc/man/man1/xetex.man1.pdf +++ b/Master/texmf-dist/doc/man/man1/xetex.man1.pdf diff --git a/Master/texmf-dist/doc/texlive/texlive-en/texlive-en.pdf b/Master/texmf-dist/doc/texlive/texlive-en/texlive-en.pdf Binary files differindex 2d28d6a8b98..3c0dc5eeda7 100644 --- a/Master/texmf-dist/doc/texlive/texlive-en/texlive-en.pdf +++ b/Master/texmf-dist/doc/texlive/texlive-en/texlive-en.pdf diff --git a/Master/texmf-dist/doc/texlive/tlbuild/tlbuild.html b/Master/texmf-dist/doc/texlive/tlbuild/tlbuild.html index 0b09fb47b17..e25893ed60a 100644 --- a/Master/texmf-dist/doc/texlive/tlbuild/tlbuild.html +++ b/Master/texmf-dist/doc/texlive/tlbuild/tlbuild.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 TeX Live build system and more. -Copyright (C) 2016-2021 Karl Berry. +Copyright (C) 2016-2022 Karl Berry. Copyright (C) 2013-2015 Karl Berry & Peter Breitenlohner. @@ -20,27 +23,27 @@ 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>Building TeX Live (2021)</title> +<title>Building TeX Live (2022)</title> -<meta name="description" content="Building TeX Live (2021)"> -<meta name="keywords" content="Building TeX Live (2021)"> +<meta name="description" content="Building TeX Live (2022)"> +<meta name="keywords" content="Building TeX Live (2022)"> <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} @@ -49,6 +52,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> @@ -57,7 +61,7 @@ ul.no-bullet {list-style: none} </head> <body lang="en"> -<h1 class="settitle" align="center">Building TeX Live (2021)</h1> +<h1 class="settitle" align="center">Building TeX Live (2022)</h1> @@ -67,27 +71,18 @@ 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-Introduction-1" href="#toc-Introduction-1">1 Introduction</a></li> -<li><a id="stoc-Overview-of-build-system-1" href="#toc-Overview-of-build-system-1">2 Overview of build system</a></li> -<li><a id="stoc-Prerequisites-1" href="#toc-Prerequisites-1">3 Prerequisites</a></li> -<li><a id="stoc-Building-1" href="#toc-Building-1">4 Building</a></li> -<li><a id="stoc-Installing-1" href="#toc-Installing-1">5 Installing</a></li> -<li><a id="stoc-Layout-and-infrastructure-1" href="#toc-Layout-and-infrastructure-1">6 Layout and infrastructure</a></li> -<li><a id="stoc-Configure-options-1" href="#toc-Configure-options-1">7 Configure options</a></li> -<li><a id="stoc-Coding-conventions-1" href="#toc-Coding-conventions-1">8 Coding conventions</a></li> -<li><a id="stoc-Continuous-integration-1" href="#toc-Continuous-integration-1">9 Continuous integration</a></li> -<li><a id="stoc-install_002dtl-1" href="#toc-install_002dtl-1">Appendix A install-tl</a></li> -<li><a id="stoc-tlmgr-1" href="#toc-tlmgr-1">Appendix B tlmgr</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="#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="Building-TeX-Live-_00282022_0029"></span><h1 class="top">Building TeX Live (2022)</h1> + +<p>For an overview of this manual, see <a href="#Introduction">Introduction</a>. +</p> -<span id="SEC_Contents"></span> +<div class="Contents_element" id="SEC_Contents"> <h2 class="contents-heading">Table of Contents</h2> <div class="contents"> @@ -99,15 +94,14 @@ ul.no-bullet {list-style: none} <li><a id="toc-Building-1" href="#Building">4 Building</a> <ul class="no-bullet"> <li><a id="toc-Build-iteration-1" href="#Build-iteration">4.1 Build iteration</a></li> - <li><a id="toc-Build-problems-1" href="#Build-problems">4.2 Build problems</a></li> - <li><a id="toc-Build-in-parallel-1" href="#Build-in-parallel">4.3 Build in parallel</a></li> - <li><a id="toc-Build-distribution-1" href="#Build-distribution">4.4 Build distribution</a></li> - <li><a id="toc-Build-one-package-1" href="#Build-one-package">4.5 Build one package</a></li> - <li><a id="toc-Build-one-engine-1" href="#Build-one-engine">4.6 Build one engine</a></li> - <li><a id="toc-Cross-compilation-1" href="#Cross-compilation">4.7 Cross compilation</a> + <li><a id="toc-Build-in-parallel-1" href="#Build-in-parallel">4.2 Build in parallel</a></li> + <li><a id="toc-Build-distribution-1" href="#Build-distribution">4.3 Build distribution</a></li> + <li><a id="toc-Build-one-package-1" href="#Build-one-package">4.4 Build one package</a></li> + <li><a id="toc-Build-one-engine-1" href="#Build-one-engine">4.5 Build one engine</a></li> + <li><a id="toc-Cross-compilation-1" href="#Cross-compilation">4.6 Cross compilation</a> <ul class="no-bullet"> - <li><a id="toc-Cross-configuring-1" href="#Cross-configuring">4.7.1 Cross configuring</a></li> - <li><a id="toc-Cross-problems-1" href="#Cross-problems">4.7.2 Cross problems</a></li> + <li><a id="toc-Cross-configuring-1" href="#Cross-configuring">4.6.1 Cross configuring</a></li> + <li><a id="toc-Cross-problems-1" href="#Cross-problems">4.6.2 Cross problems</a></li> </ul></li> </ul></li> <li><a id="toc-Installing-1" href="#Installing">5 Installing</a> @@ -146,8 +140,9 @@ ul.no-bullet {list-style: none} <li><a id="toc-Extending-TeX-Live-1" href="#Extending-TeX-Live">6.6 Extending TeX Live</a> <ul class="no-bullet"> <li><a id="toc-Adding-a-new-program-module-1" href="#Adding-a-new-program-module">6.6.1 Adding a new program module</a></li> - <li><a id="toc-Adding-a-new-generic-library-module-1" href="#Adding-a-new-generic-library-module">6.6.2 Adding a new generic library module</a></li> - <li><a id="toc-Adding-a-new-TeX_002dspecific-library-module-1" href="#Adding-a-new-TeX_002dspecific-library-module">6.6.3 Adding a new TeX-specific library module</a></li> + <li><a id="toc-Adding-a-new-engine-1" href="#Adding-a-new-engine">6.6.2 Adding a new engine</a></li> + <li><a id="toc-Adding-a-new-generic-library-module-1" href="#Adding-a-new-generic-library-module">6.6.3 Adding a new generic library module</a></li> + <li><a id="toc-Adding-a-new-TeX_002dspecific-library-module-1" href="#Adding-a-new-TeX_002dspecific-library-module">6.6.4 Adding a new TeX-specific library module</a></li> </ul></li> </ul></li> <li><a id="toc-Configure-options-1" href="#Configure-options">7 Configure options</a> @@ -285,55 +280,39 @@ 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="Building-TeX-Live-_00282021_0029"></span><h1 class="top">Building TeX Live (2021)</h1> - -<p>For an overview of this manual, see <a href="#Introduction">Introduction</a>. -</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">About this manual. -</td></tr> -<tr><td align="left" valign="top">• <a href="#Overview-of-build-system" accesskey="2">Overview of build system</a></td><td> </td><td align="left" valign="top">The TeX Live build system. -</td></tr> -<tr><td align="left" valign="top">• <a href="#Prerequisites" accesskey="3">Prerequisites</a></td><td> </td><td align="left" valign="top">Requirements for building TeX Live. -</td></tr> -<tr><td align="left" valign="top">• <a href="#Building" accesskey="4">Building</a></td><td> </td><td align="left" valign="top">The overall build process. -</td></tr> -<tr><td align="left" valign="top">• <a href="#Installing" accesskey="5">Installing</a></td><td> </td><td align="left" valign="top">How and where installation happens (or not). -</td></tr> -<tr><td align="left" valign="top">• <a href="#Layout-and-infrastructure" accesskey="6">Layout and infrastructure</a></td><td> </td><td align="left" valign="top">Autoconf macros, etc., in detail. -</td></tr> -<tr><td align="left" valign="top">• <a href="#Configure-options" accesskey="7">Configure options</a></td><td> </td><td align="left" valign="top">List of all configure options. -</td></tr> -<tr><td align="left" valign="top">• <a href="#Coding-conventions" accesskey="8">Coding conventions</a></td><td> </td><td align="left" valign="top">Conventions to follow. -</td></tr> -<tr><td align="left" valign="top">• <a href="#Continuous-integration" accesskey="9">Continuous integration</a></td><td> </td><td align="left" valign="top">Automated build testing. -</td></tr> -<tr><td align="left" valign="top">• <a href="#install_002dtl">install-tl</a></td><td> </td><td align="left" valign="top">The TeX Live installer. -</td></tr> -<tr><td align="left" valign="top">• <a href="#tlmgr">tlmgr</a></td><td> </td><td align="left" valign="top">The native TeX Live package manager. -</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> - +<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-Introduction-1" href="#toc-Introduction-1">1 Introduction</a></li> +<li><a id="stoc-Overview-of-build-system-1" href="#toc-Overview-of-build-system-1">2 Overview of build system</a></li> +<li><a id="stoc-Prerequisites-1" href="#toc-Prerequisites-1">3 Prerequisites</a></li> +<li><a id="stoc-Building-1" href="#toc-Building-1">4 Building</a></li> +<li><a id="stoc-Installing-1" href="#toc-Installing-1">5 Installing</a></li> +<li><a id="stoc-Layout-and-infrastructure-1" href="#toc-Layout-and-infrastructure-1">6 Layout and infrastructure</a></li> +<li><a id="stoc-Configure-options-1" href="#toc-Configure-options-1">7 Configure options</a></li> +<li><a id="stoc-Coding-conventions-1" href="#toc-Coding-conventions-1">8 Coding conventions</a></li> +<li><a id="stoc-Continuous-integration-1" href="#toc-Continuous-integration-1">9 Continuous integration</a></li> +<li><a id="stoc-install_002dtl-1" href="#toc-install_002dtl-1">Appendix A install-tl</a></li> +<li><a id="stoc-tlmgr-1" href="#toc-tlmgr-1">Appendix B tlmgr</a></li> +<li><a id="stoc-Index-1" href="#toc-Index-1" rel="index">Index</a></li> +</ul> +</div> +</div> <hr> -<span id="Introduction"></span><div class="header"> +<div class="chapter" id="Introduction"> +<div class="header"> <p> -Next: <a href="#Overview-of-build-system" accesskey="n" rel="next">Overview of build system</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="#Overview-of-build-system" accesskey="n" rel="next">Overview of build system</a>, Previous: <a href="#Top" accesskey="p" rel="prev">Building TeX Live (2022)</a>, Up: <a href="#Top" accesskey="u" rel="up">Building TeX Live (2022)</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> -<p>This manual (dated February 2021) corresponds to the TeX Live -2021 release. +<p>This manual (dated February 2022) corresponds to the TeX Live +2022 release. </p> <p>This manual is aimed at system installers and programmers, and focuses on how to configure, build, and develop the TeX Live (TL) sources. It is @@ -361,8 +340,8 @@ are distributed with TeX Live: <a href="https://tug.org/texlive/build.html" </li><li> The TeX Live user manual: <a href="https://tug.org/texlive/doc.html">https://tug.org/texlive/doc.html</a>, or run <code>texdoc texlive</code>. -</li><li> Other TeX-related Texinfo manuals (see <cite><a href="https://tug.org/texinfohtml/web2c.html#Top">Web2c</a></cite>, -<cite><a href="https://tug.org/texinfohtml/kpathsea.html#Top">Kpathsea</a></cite>, etc.): +</li><li> Other TeX-related Texinfo manuals (see <cite><a data-manual="web2c" href="https://tug.org/texinfohtml/web2c.html#Top">Web2c</a></cite>, +<cite><a data-manual="kpathsea" href="https://tug.org/texinfohtml/kpathsea.html#Top">Kpathsea</a></cite>, etc.): <a href="https://tug.org/texinfohtml/">https://tug.org/texinfohtml/</a>, or check the ‘<samp>TeX</samp>’ category in the GNU Info system. @@ -379,11 +358,12 @@ to do so. The same text is available online (linked from with ‘<samp>--help</samp>’ (or look at the end of the source). </p> - <hr> -<span id="Overview-of-build-system"></span><div class="header"> +</div> +<div class="chapter" id="Overview-of-build-system"> +<div class="header"> <p> -Next: <a href="#Prerequisites" accesskey="n" rel="next">Prerequisites</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="#Prerequisites" accesskey="n" rel="next">Prerequisites</a>, Previous: <a href="#Introduction" accesskey="p" rel="prev">Introduction</a>, Up: <a href="#Top" accesskey="u" rel="up">Building TeX Live (2022)</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="Overview-of-build-system-1"></span><h2 class="chapter">2 Overview of build system</h2> @@ -405,20 +385,20 @@ all <code>configure</code> options. <p>The main components of the TL build system are: </p> <dl compact="compact"> -<dt><samp>libs/<var>lib</var></samp></dt> +<dt><span><samp>libs/<var>lib</var></samp></span></dt> <dd><p>Generic libraries. </p> </dd> -<dt><samp>texk/<var>lib</var></samp></dt> +<dt><span><samp>texk/<var>lib</var></samp></span></dt> <dd><p>TeX-specific libraries in subdirectories, notably <var>lib</var>=<code>kpathsea</code>. (The other one is <samp>texk/ptexenc</samp>.) </p> </dd> -<dt><samp>texk/<var>prog</var></samp></dt> +<dt><span><samp>texk/<var>prog</var></samp></span></dt> <dd><p>TeX-specific programs (that use Kpathsea). </p> </dd> -<dt><samp>utils/<var>prog</var></samp></dt> +<dt><span><samp>utils/<var>prog</var></samp></span></dt> <dd><p>Other programs (that don’t use Kpathsea). </p> </dd> @@ -446,11 +426,12 @@ distributed source tree and document any modifications of that source. integrating new modules into the TL build system. (Despite all efforts, neither task is easy.) </p> - <hr> -<span id="Prerequisites"></span><div class="header"> +</div> +<div class="chapter" id="Prerequisites"> +<div class="header"> <p> -Next: <a href="#Building" accesskey="n" rel="next">Building</a>, Previous: <a href="#Overview-of-build-system" accesskey="p" rel="prev">Overview of build system</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="#Building" accesskey="n" rel="next">Building</a>, Previous: <a href="#Overview-of-build-system" accesskey="p" rel="prev">Overview of build system</a>, Up: <a href="#Top" accesskey="u" rel="up">Building TeX Live (2022)</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="Prerequisites-1"></span><h2 class="chapter">3 Prerequisites</h2> @@ -459,51 +440,64 @@ Next: <a href="#Building" accesskey="n" rel="next">Building</a>, Previous: <a hr <span id="index-compilers_002c-C-and-C_002b_002b11"></span> <p>Overall, building the TeX Live programs, when using all libraries from -the TL source tree, requires C and C++11 compilers and GNU -<code>make</code>. If <code>make</code> from your <code>PATH</code> is not GNU make, -you can set the <code>MAKE</code> environment variable to whatever is necessary. +the TL source tree, requires C and C++11 compilers, GNU <code>make</code>, +and Python. </p> +<ul> +<li> If <code>make</code> from your <code>PATH</code> is not GNU <code>make</code>, you can +set the <code>MAKE</code> environment variable to whatever is necessary. + <span id="index-GNU-make_002c-required"></span> <span id="index-gmake_002c-required"></span> -<span id="index-FreeType"></span> -<p>GNU <code>make</code> is required only because of some third-party -libraries, notably FreeType; all the TL-maintained directories (and -Automake/Autoconf output in general) work with any reasonable -<code>make</code>. -</p> -<span id="index-C_002b_002b11_002c-required"></span> -<p>A C++11 compiler is similarly required because of the third-party -library ICU; the program <code>dvisvgm</code> also requires C++11. It is -possible to build everything else with older compilers, but you have -to remove the C++11-dependent sources. See <a href="#Build-one-package">Build one package</a>. -</p> +<span id="index-FreeType_002c-requires-gmake"></span> +<span id="index-_0024_0040-target-in-normal-make-rules"></span> +<p>GNU <code>make</code> is required only because of third-party libraries, +notably FreeType. Automake/Autoconf output in general, and the +TL-maintained directories, work with any reasonable +<code>make</code>.<a id="DOCF1" href="#FOOT1"><sup>1</sup></a> +</p> +</li><li> <span id="index-C_002b_002b11_002c-required"></span> +<span id="index-dvisvgm_002c-requires-C_002b_002b11"></span> +<span id="index-HarfBuzz_002c-requires-C_002b_002b11"></span> +<span id="index-ICU_002c-requires-C_002b_002b11"></span> +A C++11 compiler is similarly required because of the third-party +libraries ICU and HarfBuzz (at least); the program <code>dvisvgm</code> also +requires C++11. It is possible to build what remains with older +compilers, but you have to remove the C++11-dependent sources. +See <a href="#Build-one-package">Build one package</a>. + +</li><li> <span id="index-Python_002c-required-by-ICU"></span> +Python is required by ICU tests. (If you know how to disable these +tests and thus eliminate the requirement, please write.) + +</li></ul> + <p>A few programs in the tree have additional requirements: </p> <dl compact="compact"> -<dt><samp>web2c</samp></dt> -<dd><span id="index-perl_002c-required-by-web2c_002c-etc_002e"></span> -<p>requires <code>perl</code> for some tests run by <code>make check</code>. +<dt id='index-perl_002c-required-by-web2c_002c-etc_002e'><span><samp>web2c</samp><a href='#index-perl_002c-required-by-web2c_002c-etc_002e' class='copiable-anchor'> ¶</a></span></dt> +<dd><p>requires <code>perl</code> for some tests run by <code>make check</code>. +Incidentally, the TeX Live installer (<code>install-tl</code>) and +manager (<code>tlmgr</code>) are also written in Perl, but this does not +matter for compiling the sources. </p> </dd> -<dt><samp>xdvik</samp></dt> -<dt><samp>xpdfopen</samp></dt> -<dd><span id="index-X11-development_002c-required-by-X-clients"></span> -<p>require X11 headers and libraries, typically in “development” packages +<dt id='index-X11-development_002c-required-by-X-clients'><span><samp>xdvik</samp><a href='#index-X11-development_002c-required-by-X-clients' class='copiable-anchor'> ¶</a></span></dt> +<dt><span><samp>xpdfopen</samp></span></dt> +<dd><p>require X11 headers and libraries, typically in devel(opment) packages that are not installed by default. </p> </dd> -<dt><samp>xetex</samp></dt> -<dd><span id="index-fontconfig-library_002c-required-by-xetex"></span> -<span id="index-ApplicationServices-Mac-framework_002c-required-by-xetex"></span> +<dt id='index-fontconfig-library_002c-required-by-xetex'><span><samp>xetex</samp><a href='#index-fontconfig-library_002c-required-by-xetex' class='copiable-anchor'> ¶</a></span></dt> +<dd><span id="index-ApplicationServices-Mac-framework_002c-required-by-xetex"></span> <span id="index-Cocoa-Mac-framework_002c-required-by-xetex"></span> <p>requires <samp>fontconfig</samp> (again both headers and library), or, for -MacOSX only, the <code>ApplicationServices</code> and <code>Cocoa</code> +MacOS only, the <code>ApplicationServices</code> and <code>Cocoa</code> frameworks. </p> </dd> -<dt><samp>xindy</samp></dt> -<dd><span id="index-clisp_002c-required-by-xindy"></span> -<span id="index-libsigsegv_002c-required-by-xindy"></span> +<dt id='index-clisp_002c-required-by-xindy'><span><samp>xindy</samp><a href='#index-clisp_002c-required-by-xindy' class='copiable-anchor'> ¶</a></span></dt> +<dd><span id="index-libsigsegv_002c-required-by-xindy"></span> <p>requires GNU <code>clisp</code>, <code>libsigsegv</code>, and <code>libiconv</code>; additionally, to build the rules and/or documentation: <code>perl</code>, <code>latex</code>, <code>pdflatex</code>. @@ -536,14 +530,15 @@ packaging of them. See <a href="#Build-system-tools">Build system tools</a>, fo <p>If you haven’t modified any source files, and infrastructure tools such as <code>autoconf</code> or <code>makeinfo</code> are still being run, check your timestamps—notably, <code>use-commit-times</code> must be set to -<code>yes</code> in your Subversion configuration (see <a href="#Build-system-tools">Build system tools</a>). Barring buggy commits, no infrastructure tools are needed to -do a normal build. +<code>yes</code> in your Subversion configuration (see <a href="#Build-system-tools">Build system tools</a>). No infrastructure tools are needed to do a normal build +(barring bugs). </p> - <hr> -<span id="Building"></span><div class="header"> +</div> +<div class="chapter" id="Building"> +<div class="header"> <p> -Next: <a href="#Installing" accesskey="n" rel="next">Installing</a>, Previous: <a href="#Prerequisites" accesskey="p" rel="prev">Prerequisites</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="#Installing" accesskey="n" rel="next">Installing</a>, Previous: <a href="#Prerequisites" accesskey="p" rel="prev">Prerequisites</a>, Up: <a href="#Top" accesskey="u" rel="up">Building TeX Live (2022)</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="Building-1"></span><h2 class="chapter">4 Building</h2> @@ -569,28 +564,20 @@ straightforward shell script. <code>configure</code> and <code>make</code> in a suitable empty subdirectory. Building in the source directory itself is not supported (sorry). </p> -<table class="menu" border="0" cellspacing="0"> -<tr><td align="left" valign="top">• <a href="#Build-iteration" accesskey="1">Build iteration</a></td><td> </td><td align="left" valign="top">What <code>configure</code> and <code>make</code> do in TL. -</td></tr> -<tr><td align="left" valign="top">• <a href="#Build-problems" accesskey="2">Build problems</a></td><td> </td><td align="left" valign="top">If the build fails. -</td></tr> -<tr><td align="left" valign="top">• <a href="#Build-in-parallel" accesskey="3">Build in parallel</a></td><td> </td><td align="left" valign="top">Simultaneous <code>make</code> processes. -</td></tr> -<tr><td align="left" valign="top">• <a href="#Build-distribution" accesskey="4">Build distribution</a></td><td> </td><td align="left" valign="top">Making a distribution tarball. -</td></tr> -<tr><td align="left" valign="top">• <a href="#Build-one-package" accesskey="5">Build one package</a></td><td> </td><td align="left" valign="top">Example of working on just one program. -</td></tr> -<tr><td align="left" valign="top">• <a href="#Build-one-engine" accesskey="6">Build one engine</a></td><td> </td><td align="left" valign="top">Example of building just one TeX engine. -</td></tr> -<tr><td align="left" valign="top">• <a href="#Cross-compilation" accesskey="7">Cross compilation</a></td><td> </td><td align="left" valign="top">Building on host X for target Y. -</td></tr> -</table> - +<ul class="section-toc"> +<li><a href="#Build-iteration" accesskey="1">Build iteration</a></li> +<li><a href="#Build-in-parallel" accesskey="2">Build in parallel</a></li> +<li><a href="#Build-distribution" accesskey="3">Build distribution</a></li> +<li><a href="#Build-one-package" accesskey="4">Build one package</a></li> +<li><a href="#Build-one-engine" accesskey="5">Build one engine</a></li> +<li><a href="#Cross-compilation" accesskey="6">Cross compilation</a></li> +</ul> <hr> -<span id="Build-iteration"></span><div class="header"> +<div class="section" id="Build-iteration"> +<div class="header"> <p> -Next: <a href="#Build-problems" accesskey="n" rel="next">Build problems</a>, Up: <a href="#Building" accesskey="u" rel="up">Building</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="#Build-in-parallel" accesskey="n" rel="next">Build in parallel</a>, Up: <a href="#Building" accesskey="u" rel="up">Building</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="Build-iteration-1"></span><h3 class="section">4.1 Build iteration</h3> @@ -621,31 +608,14 @@ etc. all the library and program modules, and finds (should find) nothing to be done. </p> - <hr> -<span id="Build-problems"></span><div class="header"> -<p> -Next: <a href="#Build-in-parallel" accesskey="n" rel="next">Build in parallel</a>, Previous: <a href="#Build-iteration" accesskey="p" rel="prev">Build iteration</a>, Up: <a href="#Building" accesskey="u" rel="up">Building</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="Build-problems-1"></span><h3 class="section">4.2 Build problems</h3> - -<span id="index-build-problems"></span> -<span id="index-problems-with-build"></span> -<span id="index-failure-to-build"></span> -<span id="index-_002d_002dno_002dclean-Build-option"></span> -<p>If configuring or building a module fails, you should first try to -find and fix the problem. Failing that, a possible workaround is to -remove the subdirectory for that module from the build tree (so -<code>configure</code> won’t try to run there, and finally rerun the top -level <code>make</code> (or <samp>./Build</samp> <code>--no-clean</code>). -</p> - -<hr> -<span id="Build-in-parallel"></span><div class="header"> +<div class="section" id="Build-in-parallel"> +<div class="header"> <p> -Next: <a href="#Build-distribution" accesskey="n" rel="next">Build distribution</a>, Previous: <a href="#Build-problems" accesskey="p" rel="prev">Build problems</a>, Up: <a href="#Building" accesskey="u" rel="up">Building</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="#Build-distribution" accesskey="n" rel="next">Build distribution</a>, Previous: <a href="#Build-iteration" accesskey="p" rel="prev">Build iteration</a>, Up: <a href="#Building" accesskey="u" rel="up">Building</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="Build-in-parallel-1"></span><h3 class="section">4.3 Build in parallel</h3> +<span id="Build-in-parallel-1"></span><h3 class="section">4.2 Build in parallel</h3> <span id="index-building-in-parallel"></span> <span id="index-parallel-build"></span> @@ -656,7 +626,7 @@ Next: <a href="#Build-distribution" accesskey="n" rel="next">Build distribution< <p>The TL build system carefully formulates dependencies as well as <code>make</code> rules when a tool (such as <code>tangle</code>, <code>ctangle</code>, and <code>convert</code>) creates several output files. This allows for -parallel builds (<code>make -j <var>n</var></code> with <em><var>n</var>>1</em> or even +parallel builds (<code>make -j <var>n</var></code> with <em class='math'><var>n</var>>1</em> or even <code>make -j</code>) that can considerably speed up the TL build. </p> <span id="index-cache-file_002c-for-configure"></span> @@ -665,13 +635,14 @@ parallel builds (<code>make -j <var>n</var></code> with <em><var>n</var>>1</e using a configure cache file, i.e., specifying the <code>configure</code> option <code>-C</code> (recommended). </p> - <hr> -<span id="Build-distribution"></span><div class="header"> +</div> +<div class="section" id="Build-distribution"> +<div class="header"> <p> Next: <a href="#Build-one-package" accesskey="n" rel="next">Build one package</a>, Previous: <a href="#Build-in-parallel" accesskey="p" rel="prev">Build in parallel</a>, Up: <a href="#Building" accesskey="u" rel="up">Building</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="Build-distribution-1"></span><h3 class="section">4.4 Build distribution</h3> +<span id="Build-distribution-1"></span><h3 class="section">4.3 Build distribution</h3> <span id="index-building-a-distribution"></span> <span id="index-distribution-tarball_002c-making"></span> @@ -688,13 +659,14 @@ system, since all the support files are lacking; see <a href="#Installing">Insta We do not actually distribute any such tarball, and have no plans to do so. </p> - <hr> -<span id="Build-one-package"></span><div class="header"> +</div> +<div class="section" id="Build-one-package"> +<div class="header"> <p> Next: <a href="#Build-one-engine" accesskey="n" rel="next">Build one engine</a>, Previous: <a href="#Build-distribution" accesskey="p" rel="prev">Build distribution</a>, Up: <a href="#Building" accesskey="u" rel="up">Building</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="Build-one-package-1"></span><h3 class="section">4.5 Build one package</h3> +<span id="Build-one-package-1"></span><h3 class="section">4.4 Build one package</h3> <span id="index-build-one-package"></span> <span id="index-one-package_002c-building"></span> @@ -709,8 +681,8 @@ dependencies and can be invoked to build an individual program or library, first building any required libraries. </p> <p>Here is an example from start to finish for working on -<code>dvipdfm-x</code>. (Unfortunately, this does not suffice for building -the TeX engines; see the next section.) +<code>dvipdfm-x</code>. Unfortunately, this does not suffice for building +the TeX engines; see the next section. </p> <div class="example"> <pre class="example">mkdir mydir && cd mydir # new working directory @@ -729,11 +701,21 @@ mkdir Work && cd Work # Do the make: make >&outm || echo fail -# Test: +# Run the tests: cd texk/dvipdfm-x make check + +# Run the new binary in the buil tree, finding support files +# in a separate tree for a TeX Live release YYYY +# (Bourne shell syntax): +TEXMFROOT=/usr/local/texlive/YYYY \ +TEXMFCNF=$TEXMFROOT/texmf-dist/web2c \ +./xdvipdfmx ... </pre></div> +<span id="index-TEXMFROOT-for-running-standalone"></span> +<span id="index-TEXMFCNF-for-running-standalone"></span> + <p>Then you can modify source files in <samp>mydir/texk/dvipdfm-x</samp> and rerun <code>make</code> in <samp>mydir/Work/texk/dvipdfm-x</samp> to rebuild; that build directory is where the binary ends up and where you can run a @@ -752,8 +734,10 @@ tweak as desired; check the output from <code>configure --help</code>. It is also a good idea to run <code>make check</code> after making any changes, to ensure that whatever tests have been written still pass. </p> +<span id="Reducing-source-download-size"></span><h4 class="subsubheading">Reducing source download size</h4> + <span id="index-size-of-source-tree"></span> -<p>Finally, the above retrieves the entire TL source tree (several +<p>The above retrieves the entire TL source tree (several hundred megabytes). It is natural to ask if this is really necessary. Strictly speaking, the answer is no, but it is vastly more convenient to do so. If you cut down the source tree, you must also give @@ -765,40 +749,62 @@ in the <code>pdftex</code> development source (details at <a href="http://pdftex.org">http://pdftex.org</a>), which is indeed such a cut-down TL source tree. </p> +<span id="GCC-used-by-default"></span><h4 class="subsubheading">GCC used by default</h4> + +<span id="index-CC_003dc_002dcompiler"></span> +<span id="index-CXX_003dc_002b_002b_002dcompiler"></span> +<span id="index-OBJCXX_003dobjc_002dcompiler"></span> +<span id="index-gcc_002c-default-compilers"></span> +<p>By default, the <code>gcc</code> compilers will be used if present; +otherwise, individual packages may use something different. You can +explicitly specify the compilers to be used with the environment +variables <code>CC</code>, <code>CXX</code>, and <code>OBJCXX</code>. +</p> +<span id="Removing-C_002b11-dependency"></span><h4 class="subsubheading">Removing C+11 dependency</h4> + <span id="index-C_002b_002b11_002c-removing-dependent-sources"></span> -<p>Some libraries and programs require C++11. If you want to build with -an older compiler lacking such support, you need to (re)move those -source directories; specifying <code>--disable</code> for them does not -suffice, unfortunately. Specifically, before running <code>configure</code>: +<p>Some libraries and programs require C++11; one such is XeTeX. If you +want to build with an older compiler lacking such support, you need to +(re)move those source directories; unfortunately, specifying +<code>--disable</code> for them does not suffice. It’s also necessary to +specify <code>--disable-xetex</code> explicitly. Specifically, before +running <code>configure --disable-xetex ...</code>: </p> <div class="example"> -<pre class="example">rm -rf libs/icu libs/graphite2 texk/dvisvgm +<pre class="example">rm -rf libs/icu libs/graphite2 texk/dvisvgm texk/web2c/xetexdir </pre></div> <span id="index-_002d_002denable_002dmissing-to-ignore-dependencies"></span> <p>Also, even with <code>--disable-all-pkgs</code>, dependencies are (currently) -checked. For instance, if a (non-MacOSX) system does not have +checked. One notable case: if a (non-MacOS) system does not have <code>fontconfig</code>, XeTeX cannot be built (see <a href="#Prerequisites">Prerequisites</a>), and <code>configure</code> will terminate even with <code>--disable-xetex</code>. To proceed without such dependencies, specify <code>--enable-missing</code> -also. (Patches to improve this would be most welcome.) +also. </p> -<span id="index-CC_003dc_002dcompiler"></span> -<span id="index-CXX_003dc_002b_002b_002dcompiler"></span> -<span id="index-OBJCXX_003dobjc_002dcompiler"></span> -<span id="index-gcc_002c-default-compilers"></span> -<p>By default, the <code>gcc</code> compilers will be used if present; -otherwise, individual packages may use something different. You can -explicitly specify the compilers to be used with the environment -variables <code>CC</code>, <code>CXX</code>, and <code>OBJCXX</code>. +<p>As of 2022, HarfBuzz also requires C++11. Therefore even more would +have to be disabled and removed, notably including <code>luahbtex</code>, +the standard engine used for LuaLaTeX. Removing that would not +be acceptable for builds intended for distribution; but perhaps for +testing the above information could still be useful. +</p> +<span id="index-removing-build-directories"></span> +<span id="index-configure-problems_002c-work-around-by-removing"></span> +<p>In general, the TL <code>configure</code> will run in all directories. +Therefore a general workaround for build problems is to remove failing +directories from the tree, and also specify the relevant +<code>--disable-...</code> option(s). +</p> +<p>Patches to improve all this would be most welcome. </p> - <hr> -<span id="Build-one-engine"></span><div class="header"> +</div> +<div class="section" id="Build-one-engine"> +<div class="header"> <p> Next: <a href="#Cross-compilation" accesskey="n" rel="next">Cross compilation</a>, Previous: <a href="#Build-one-package" accesskey="p" rel="prev">Build one package</a>, Up: <a href="#Building" accesskey="u" rel="up">Building</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="Build-one-engine-1"></span><h3 class="section">4.6 Build one engine</h3> +<span id="Build-one-engine-1"></span><h3 class="section">4.5 Build one engine</h3> <span id="index-build-one-engine"></span> <span id="index-one-engine_002c-building"></span> @@ -816,7 +822,8 @@ original TeX: <div class="example"> <pre class="example">cd Work # top build directory ../configure --without-x --disable-shared --disable-all-pkgs \ - --enable-tex --disable-synctex -C CFLAGS=-g CXXFLAGS=-g + --enable-tex --disable-synctex --disable-xetex \ + --enable-missing -C CFLAGS=-g CXXFLAGS=-g make cd texk/web2c # cd engine build directory make tex # must specify target @@ -824,9 +831,12 @@ make tex # must specify target <p>The first <code>make</code> run will configure everything, and even build the libraries, even though the packages are disabled. -The source tree can be cut down to just what is needed for the given +</p> +<p>The source tree can be cut down to just what is needed for the given engine (the separate pdfTeX and LuaTeX source repositories do -this, for example), but see caveats in previous section. +this, for example), but see caveats in previous section. When the +<code>--disable-xetex</code> and <code>--enable-missing</code> options are needed +is also explained in the previous section. </p> <p>If you want to debug an X-related program or shared library setup, or other variants, change the <code>configure</code> options @@ -835,15 +845,44 @@ accordingly. Either <code>../Build</code> or <code>../configure</code> can be ru <p>Then it is necessary to again specify the target engine (<code>tex</code>, in the above) in the <code>make</code>. </p> -<p>All this is somewhat unfortunate. We hope to improve the situation in -the future. Patches are welcome. +<p>All these complications are rather unfortunate. Patches are welcome. +</p> +<span id="Testing-one-engine"></span><h4 class="subsubheading">Testing one engine</h4> + +<p>To run only the tests for a given engine, say <code>hitex</code>: +</p> +<div class="example"> +<pre class="example">make -C $ww check SUBDIRS=. TESTS='$(hitex_tests)' +</pre></div> + +<p>where <code>$ww</code> is the web2c build directory, that is, +<samp>ww=/wherever/Build/source/Work/texk/web2c</samp>. +</p> +<p>It’s also possible to run individual tests the same way, using the test +name exactly as specified in the <samp>.am</samp> file: +</p> +<div class="example"> +<pre class="example">make -C $ww check SUBDIRS=. TESTS=hitexdir/tests/hello.test +</pre></div> + +<span id="index-_002d_002dno_002dprint_002ddirectory-GNU-make-option"></span> +<p>If you get tired of looking at the ‘<samp>Entering</samp>’/‘<samp>Leaving +directory</samp>’ lines, you can add the (GNU) make option +<code>--no-print-dir</code>. +</p> +<p>You may find it useful to put lengthy incantations like this into a +trivial shell script with a short name (say, <code>hitst</code>). Then you +just run <code>hitst</code> and edit the file when necessary to change +things around. </p> <hr> -<span id="Cross-compilation"></span><div class="header"> +</div> +<div class="section" id="Cross-compilation"> +<div class="header"> <p> Previous: <a href="#Build-one-engine" accesskey="p" rel="prev">Build one engine</a>, Up: <a href="#Building" accesskey="u" rel="up">Building</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="Cross-compilation-1"></span><h3 class="section">4.7 Cross compilation</h3> +<span id="Cross-compilation-1"></span><h3 class="section">4.6 Cross compilation</h3> <span id="index-cross-compilation"></span> <p>In a cross compilation a <em>build</em> system is used to create @@ -860,10 +899,10 @@ compilation at all. In most such cases it suffices to specify suitable compiler flags. It might be useful to add the configure option <code>--build=<var>host</var></code> to get the correct canonical host name, but note that this should <em>not</em> be <code>--host=<var>host</var></code> -(see <a href="https://www.gnu.org/software/autoconf/manual/autoconf.html#Hosts-and-Cross_002dCompilation">Hosts and Cross-Compilation</a> in <cite>GNU Autoconf</cite>). +(see <a data-manual="autoconf" href="https://www.gnu.org/software/autoconf/manual/autoconf.html#Hosts-and-Cross_002dCompilation">Hosts and Cross-Compilation</a> in <cite>GNU Autoconf</cite>). </p> <p>In order to build, e.g., 32-bit binaries with <code>clang</code> on a 64-bit -MacOSX system one could use: +MacOS system one could use: </p> <div class="example"> <pre class="example">TL_BUILD_ENV="CC='clang -arch i386' \ @@ -872,19 +911,18 @@ MacOSX system one could use: ./Build --build=i386-apple-darwin </pre></div> -<table class="menu" border="0" cellspacing="0"> -<tr><td align="left" valign="top">• <a href="#Cross-configuring" accesskey="1">Cross configuring</a></td><td> </td><td align="left" valign="top">Configuring for cross compilation. -</td></tr> -<tr><td align="left" valign="top">• <a href="#Cross-problems" accesskey="2">Cross problems</a></td><td> </td><td align="left" valign="top">Cross compilation problems. -</td></tr> -</table> +<ul class="section-toc"> +<li><a href="#Cross-configuring" accesskey="1">Cross configuring</a></li> +<li><a href="#Cross-problems" accesskey="2">Cross problems</a></li> +</ul> <hr> -<span id="Cross-configuring"></span><div class="header"> +<div class="subsection" id="Cross-configuring"> +<div class="header"> <p> Next: <a href="#Cross-problems" accesskey="n" rel="next">Cross problems</a>, Up: <a href="#Cross-compilation" accesskey="u" rel="up">Cross compilation</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="Cross-configuring-1"></span><h4 class="subsection">4.7.1 Cross configuring</h4> +<span id="Cross-configuring-1"></span><h4 class="subsection">4.6.1 Cross configuring</h4> <span id="index-cross-compilation-configuring"></span> <span id="index-configuring_002c-for-cross-compilation"></span> @@ -949,11 +987,13 @@ BUILDLDFLAGS=… </pre></div> <hr> -<span id="Cross-problems"></span><div class="header"> +</div> +<div class="subsection" id="Cross-problems"> +<div class="header"> <p> Previous: <a href="#Cross-configuring" accesskey="p" rel="prev">Cross configuring</a>, Up: <a href="#Cross-compilation" accesskey="u" rel="up">Cross compilation</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="Cross-problems-1"></span><h4 class="subsection">4.7.2 Cross problems</h4> +<span id="Cross-problems-1"></span><h4 class="subsection">4.6.2 Cross problems</h4> <span id="index-cross-compilation-problems"></span> @@ -1000,11 +1040,14 @@ and <samp>tie</samp>. <p>Building <code>xindy</code> requires running the host system <code>clisp</code> binary, thus cross compilation is painful, but possible. </p> - <hr> -<span id="Installing"></span><div class="header"> +</div> +</div> +</div> +<div class="chapter" id="Installing"> +<div class="header"> <p> -Next: <a href="#Layout-and-infrastructure" accesskey="n" rel="next">Layout and infrastructure</a>, Previous: <a href="#Building" accesskey="p" rel="prev">Building</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="#Layout-and-infrastructure" accesskey="n" rel="next">Layout and infrastructure</a>, Previous: <a href="#Building" accesskey="p" rel="prev">Building</a>, Up: <a href="#Top" accesskey="u" rel="up">Building TeX Live (2022)</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="Installing-1"></span><h2 class="chapter">5 Installing</h2> @@ -1028,18 +1071,15 @@ is the TeX Live (plain text) database in <code>install-tl</code>. More information is under <samp>Master/tlpkg</samp> and at <a href="https://tug.org/texlive/distro.html">https://tug.org/texlive/distro.html</a>. </p> -<table class="menu" border="0" cellspacing="0"> -<tr><td align="left" valign="top">• <a href="#Installation-directories" accesskey="1">Installation directories</a></td><td> </td><td align="left" valign="top">The prefix, <code>bindir</code>, etc., directories. -</td></tr> -<tr><td align="left" valign="top">• <a href="#Linked-scripts" accesskey="2">Linked scripts</a></td><td> </td><td align="left" valign="top">Scripts not maintained in the sources. -</td></tr> -<tr><td align="left" valign="top">• <a href="#Distro-builds" accesskey="3">Distro builds</a></td><td> </td><td align="left" valign="top">Configuring and building for OS distributions. -</td></tr> -</table> - +<ul class="section-toc"> +<li><a href="#Installation-directories" accesskey="1">Installation directories</a></li> +<li><a href="#Linked-scripts" accesskey="2">Linked scripts</a></li> +<li><a href="#Distro-builds" accesskey="3">Distro builds</a></li> +</ul> <hr> -<span id="Installation-directories"></span><div class="header"> +<div class="section" id="Installation-directories"> +<div class="header"> <p> Next: <a href="#Linked-scripts" accesskey="n" rel="next">Linked scripts</a>, Up: <a href="#Installing" accesskey="u" rel="up">Installing</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> </div> @@ -1097,9 +1137,10 @@ not directly usable from that location; they need to be copied to <samp>Master/bin/<var>tl-platform</var></samp>. The other files and directories that end up in <samp>./inst/</samp> are ignored. </p> - <hr> -<span id="Linked-scripts"></span><div class="header"> +</div> +<div class="section" id="Linked-scripts"> +<div class="header"> <p> Next: <a href="#Distro-builds" accesskey="n" rel="next">Distro builds</a>, Previous: <a href="#Installation-directories" accesskey="p" rel="prev">Installation directories</a>, Up: <a href="#Installing" accesskey="u" rel="up">Installing</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> </div> @@ -1142,9 +1183,10 @@ want to add more. (See <a href="https://tug.org/texlive/build.html">https://tug information about building those exceptions, as well as the <code>xz</code> and <code>wget</code> programs that are used in the TL infrastructure.) </p> - <hr> -<span id="Distro-builds"></span><div class="header"> +</div> +<div class="section" id="Distro-builds"> +<div class="header"> <p> Previous: <a href="#Linked-scripts" accesskey="p" rel="prev">Linked scripts</a>, Up: <a href="#Installing" accesskey="u" rel="up">Installing</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> </div> @@ -1175,43 +1217,43 @@ completely different. find most relevant: </p> <dl compact="compact"> -<dt><code>--disable-native-texlive-build</code></dt> +<dt><span><code>--disable-native-texlive-build</code></span></dt> <dd><p>This must be specified to avoid interference from the many tweaks we do for the native TL build. </p> </dd> -<dt><code>--with-banner-add=/<var>SomeDistro</var></code></dt> +<dt><span><code>--with-banner-add=/<var>SomeDistro</var></code></span></dt> <dd><p>This isn’t technically required, but is strongly recommended, so your build and your distro can be distinguished from others. </p> </dd> -<dt><code>--enable-shared</code></dt> +<dt><span><code>--enable-shared</code></span></dt> <dd><p>Build shared versions of the TeX-specific libraries (uses <code>libtool</code>). </p> </dd> -<dt><code>--disable-static</code></dt> +<dt><span><code>--disable-static</code></span></dt> <dd><p>Do not build the static versions of the TeX-specific libraries. </p> </dd> -<dt><code>--with-system-<var>lib</var></code></dt> +<dt><span><code>--with-system-<var>lib</var></code></span></dt> <dd><p>Look for and use a system version of the library <var>lib</var>. <code>configure --help</code> will give you the list of possibilities. </p> </dd> -<dt><code>--with-<var>lib</var>-includes=<var>dir</var></code></dt> -<dt><code>--with-<var>lib</var>-libdir=<var>dir</var></code></dt> +<dt><span><code>--with-<var>lib</var>-includes=<var>dir</var></code></span></dt> +<dt><span><code>--with-<var>lib</var>-libdir=<var>dir</var></code></span></dt> <dd><p>If needed, allows you to specify where the headers/code are for the given library <var>lib</var>. </p> </dd> -<dt><code>--prefix=/usr</code></dt> -<dt><code>--prefix=/opt/TeXLive</code></dt> +<dt><span><code>--prefix=/usr</code></span></dt> +<dt><span><code>--prefix=/opt/TeXLive</code></span></dt> <dd><p>Or whatever your convention is. The default is <samp>/usr/local</samp> and you shouldn’t install there for a distro. </p> </dd> -<dt><code>--libdir=\${exec_prefix}/lib64</code></dt> +<dt><span><code>--libdir=\${exec_prefix}/lib64</code></span></dt> <dd><p>May be needed for 64-bit bi-architecture (GNU/Linux) systems. </p> </dd> @@ -1227,11 +1269,13 @@ has written a detailed article on adapting TL for distros: article needs updating in the future, perhaps we will merge it into this document.) </p> - <hr> -<span id="Layout-and-infrastructure"></span><div class="header"> +</div> +</div> +<div class="chapter" id="Layout-and-infrastructure"> +<div class="header"> <p> -Next: <a href="#Configure-options" accesskey="n" rel="next">Configure options</a>, Previous: <a href="#Installing" accesskey="p" rel="prev">Installing</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="#Configure-options" accesskey="n" rel="next">Configure options</a>, Previous: <a href="#Installing" accesskey="p" rel="prev">Installing</a>, Up: <a href="#Top" accesskey="u" rel="up">Building TeX Live (2022)</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="Layout-and-infrastructure-1"></span><h2 class="chapter">6 Layout and infrastructure</h2> @@ -1244,24 +1288,18 @@ distributed by TL, as well as <code>configure</code> scripts and <code>make</cod rules to build and install them together with some of their support files. </p> -<table class="menu" border="0" cellspacing="0"> -<tr><td align="left" valign="top">• <a href="#Build-system-tools" accesskey="1">Build system tools</a></td><td> </td><td align="left" valign="top">Modifying infrastructure files. -</td></tr> -<tr><td align="left" valign="top">• <a href="#Top_002dlevel-directories" accesskey="2">Top-level directories</a></td><td> </td><td align="left" valign="top">libs texk utils; am auxdir build-aux m4; doc extra. -</td></tr> -<tr><td align="left" valign="top">• <a href="#Autoconf-macros" accesskey="3">Autoconf macros</a></td><td> </td><td align="left" valign="top">TL-specific Autoconf macros. -</td></tr> -<tr><td align="left" valign="top">• <a href="#Library-modules" accesskey="4">Library modules</a></td><td> </td><td align="left" valign="top">Handling libraries, with examples. -</td></tr> -<tr><td align="left" valign="top">• <a href="#Program-modules" accesskey="5">Program modules</a></td><td> </td><td align="left" valign="top">Handling programs, with examples. -</td></tr> -<tr><td align="left" valign="top">• <a href="#Extending-TeX-Live" accesskey="6">Extending TeX Live</a></td><td> </td><td align="left" valign="top">Adding a new module. -</td></tr> -</table> - +<ul class="section-toc"> +<li><a href="#Build-system-tools" accesskey="1">Build system tools</a></li> +<li><a href="#Top_002dlevel-directories" accesskey="2">Top-level directories</a></li> +<li><a href="#Autoconf-macros" accesskey="3">Autoconf macros</a></li> +<li><a href="#Library-modules" accesskey="4">Library modules</a></li> +<li><a href="#Program-modules" accesskey="5">Program modules</a></li> +<li><a href="#Extending-TeX-Live" accesskey="6">Extending TeX Live</a></li> +</ul> <hr> -<span id="Build-system-tools"></span><div class="header"> +<div class="section" id="Build-system-tools"> +<div class="header"> <p> Next: <a href="#Top_002dlevel-directories" accesskey="n" rel="next">Top-level directories</a>, Up: <a href="#Layout-and-infrastructure" accesskey="u" rel="up">Layout and infrastructure</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> </div> @@ -1288,12 +1326,12 @@ may be. <p>Currently the versions we use are: </p> <div class="display"> -<pre class="display">autoconf (GNU Autoconf) 2.69 -automake (GNU automake) 1.16.2 -bison (GNU Bison) 3.7.4 +<pre class="display">autoconf (GNU Autoconf) 2.71 +automake (GNU automake) 1.16.5 +bison (GNU Bison) 3.8.2 flex 2.6.0 ltmain.sh (GNU libtool) 2.4.6 -m4 (GNU M4) 1.4.18 +m4 (GNU M4) 1.4.19 makeinfo (GNU texinfo) 6.7 </pre></div> @@ -1328,9 +1366,10 @@ to <code>touch</code> first <samp>aclocal.m4</samp>, then <samp>configure</samp> <samp>config.h.in</samp> (or <samp>c-auto.in</samp>), and finally all <samp>Makefile.in</samp> files. </p> - <hr> -<span id="Top_002dlevel-directories"></span><div class="header"> +</div> +<div class="section" id="Top_002dlevel-directories"> +<div class="header"> <p> Next: <a href="#Autoconf-macros" accesskey="n" rel="next">Autoconf macros</a>, Previous: <a href="#Build-system-tools" accesskey="p" rel="prev">Build system tools</a>, Up: <a href="#Layout-and-infrastructure" accesskey="u" rel="up">Layout and infrastructure</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> </div> @@ -1387,9 +1426,10 @@ These names (and everything else about <samp>Build</samp>’s operation) can be changed by setting environment variables before running it; see the script source. </p> - <hr> -<span id="Autoconf-macros"></span><div class="header"> +</div> +<div class="section" id="Autoconf-macros"> +<div class="header"> <p> Next: <a href="#Library-modules" accesskey="n" rel="next">Library modules</a>, Previous: <a href="#Top_002dlevel-directories" accesskey="p" rel="prev">Top-level directories</a>, Up: <a href="#Layout-and-infrastructure" accesskey="u" rel="up">Layout and infrastructure</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> </div> @@ -1405,23 +1445,18 @@ modules—many more are defined in the sources; see the top-level module-specific macros in directories such as <samp>texk/dvipng/m4/</samp>; some of those are described in following sections (see <a href="#Library-modules">Library modules</a> and <a href="#Program-modules">Program modules</a>). </p> -<table class="menu" border="0" cellspacing="0"> -<tr><td align="left" valign="top">• <a href="#General-setup-macros" accesskey="1">Setup</a></td><td> </td><td align="left" valign="top"> -</td></tr> -<tr><td align="left" valign="top">• <a href="#Macros-for-programs" accesskey="2">Programs</a></td><td> </td><td align="left" valign="top"> -</td></tr> -<tr><td align="left" valign="top">• <a href="#Macros-for-compilers" accesskey="3">Compilers</a></td><td> </td><td align="left" valign="top"> -</td></tr> -<tr><td align="left" valign="top">• <a href="#Macros-for-libraries" accesskey="4">Libraries</a></td><td> </td><td align="left" valign="top"> -</td></tr> -<tr><td align="left" valign="top">• <a href="#Macros-for-library-and-header-flags" accesskey="5">Flags</a></td><td> </td><td align="left" valign="top"> -</td></tr> -<tr><td align="left" valign="top">• <a href="#Macros-for-Windows" accesskey="6">Windows</a></td><td> </td><td align="left" valign="top"> -</td></tr> -</table> +<ul class="section-toc"> +<li><a href="#General-setup-macros" accesskey="1">General setup macros</a></li> +<li><a href="#Macros-for-programs" accesskey="2">Macros for programs</a></li> +<li><a href="#Macros-for-compilers" accesskey="3">Macros for compilers</a></li> +<li><a href="#Macros-for-libraries" accesskey="4">Macros for libraries</a></li> +<li><a href="#Macros-for-library-and-header-flags" accesskey="5">Macros for library and header flags</a></li> +<li><a href="#Macros-for-Windows" accesskey="6">Macros for Windows</a></li> +</ul> <hr> -<span id="General-setup-macros"></span><div class="header"> +<div class="subsection" id="General-setup-macros"> +<div class="header"> <p> Next: <a href="#Macros-for-programs" accesskey="n" rel="next">Macros for programs</a>, Up: <a href="#Autoconf-macros" accesskey="u" rel="up">Autoconf 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> @@ -1432,23 +1467,24 @@ Next: <a href="#Macros-for-programs" accesskey="n" rel="next">Macros for program <span id="index-macros_002c-general-setup"></span> <p>The TL sources use two general setup macros: </p> -<dl> -<dt id="index-KPSE_005fBASIC">Macro: <strong>KPSE_BASIC</strong> <em>(<var>name</var>, [<var>more-options</var>])</em></dt> +<dl class="def"> +<dt id="index-KPSE_005fBASIC"><span class="category">Macro: </span><span><strong>KPSE_BASIC</strong> <em>(<var>name</var>, [<var>more-options</var>])</em><a href='#index-KPSE_005fBASIC' class='copiable-anchor'> ¶</a></span></dt> <dd><p>Initialize the basic TL infrastructure for module <var>name</var>:<br> <code>AM_INIT_AUTOMAKE([foreign <var>more-options</var>])</code><br> <code>AM_MAINTAINER_MODE</code><br> <code>KPSE_COMPILER_WARNINGS</code><br> and make sure the C compiler understands function prototypes. This is used for all generic library and program modules. </p></dd></dl> -<dl> -<dt id="index-KPSE_005fCOMMON">Macro: <strong>KPSE_COMMON</strong> <em>(<var>name</var>, [<var>more-options</var>])</em></dt> +<dl class="def"> +<dt id="index-KPSE_005fCOMMON"><span class="category">Macro: </span><span><strong>KPSE_COMMON</strong> <em>(<var>name</var>, [<var>more-options</var>])</em><a href='#index-KPSE_005fCOMMON' class='copiable-anchor'> ¶</a></span></dt> <dd><p>Like <code>KPSE_BASIC</code> but add:<br> <code>LT_PREREQ([2.2.6])</code><br> <code>LT_INIT([win32-dll])</code><br> <code>AC_SYS_LARGEFILE</code><br> <code>AC_FUNC_FSEEKO</code><br>along with checks for frequently used functions, headers, types, and structures. This is used for TeX-specific modules. </p></dd></dl> - <hr> -<span id="Macros-for-programs"></span><div class="header"> +</div> +<div class="subsection" id="Macros-for-programs"> +<div class="header"> <p> Next: <a href="#Macros-for-compilers" accesskey="n" rel="next">Macros for compilers</a>, Previous: <a href="#General-setup-macros" accesskey="p" rel="prev">General setup macros</a>, Up: <a href="#Autoconf-macros" accesskey="u" rel="up">Autoconf 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> @@ -1457,8 +1493,8 @@ Next: <a href="#Macros-for-compilers" accesskey="n" rel="next">Macros for compil <span id="index-macros_002c-for-programs"></span> <p>Macros for program checks: </p> -<dl> -<dt id="index-KPSE_005fCHECK_005fLATEX">Macro: <strong>KPSE_CHECK_LATEX</strong></dt> +<dl class="def"> +<dt id="index-KPSE_005fCHECK_005fLATEX"><span class="category">Macro: </span><span><strong>KPSE_CHECK_LATEX</strong><a href='#index-KPSE_005fCHECK_005fLATEX' class='copiable-anchor'> ¶</a></span></dt> <dd><p>Set <code>LATEX</code> to the first of <code>latex</code>, <code>elatex</code>, or <code>lambda</code> which exists in <code>PATH</code>, or to <code>no</code> if none of them exists. Call <code>AC_SUBST</code> for <code>LATEX</code>. The result of @@ -1466,25 +1502,26 @@ this test can be overridden by setting the <code>LATEX</code> environment variable or the cache variable <code>ac_cv_prog_LATEX</code>. </p></dd></dl> -<dl> -<dt id="index-KPSE_005fCHECK_005fPDFLATEX">Macro: <strong>KPSE_CHECK_PDFLATEX</strong></dt> +<dl class="def"> +<dt id="index-KPSE_005fCHECK_005fPDFLATEX"><span class="category">Macro: </span><span><strong>KPSE_CHECK_PDFLATEX</strong><a href='#index-KPSE_005fCHECK_005fPDFLATEX' class='copiable-anchor'> ¶</a></span></dt> <dd><p>Check for <code>pdflatex</code> in <code>PATH</code> and set <code>PDFLATEX</code>. </p></dd></dl> -<dl> -<dt id="index-KPSE_005fCHECK_005fPERL">Macro: <strong>KPSE_CHECK_PERL</strong></dt> +<dl class="def"> +<dt id="index-KPSE_005fCHECK_005fPERL"><span class="category">Macro: </span><span><strong>KPSE_CHECK_PERL</strong><a href='#index-KPSE_005fCHECK_005fPERL' class='copiable-anchor'> ¶</a></span></dt> <dd><p>Check for <code>perl</code> or <code>perl5</code> in <code>PATH</code> and set <code>PERL</code>. </p></dd></dl> -<dl> -<dt id="index-KPSE_005fPROG_005fLEX">Macro: <strong>KPSE_PROG_LEX</strong></dt> +<dl class="def"> +<dt id="index-KPSE_005fPROG_005fLEX"><span class="category">Macro: </span><span><strong>KPSE_PROG_LEX</strong><a href='#index-KPSE_005fPROG_005fLEX' class='copiable-anchor'> ¶</a></span></dt> <dd><p>Call <code>AC_PROG_LEX</code> and add the flag <code>-l</code> for <code>flex</code>. </p></dd></dl> - <hr> -<span id="Macros-for-compilers"></span><div class="header"> +</div> +<div class="subsection" id="Macros-for-compilers"> +<div class="header"> <p> Next: <a href="#Macros-for-libraries" accesskey="n" rel="next">Macros for libraries</a>, Previous: <a href="#Macros-for-programs" accesskey="p" rel="prev">Macros for programs</a>, Up: <a href="#Autoconf-macros" accesskey="u" rel="up">Autoconf 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> @@ -1494,8 +1531,8 @@ Next: <a href="#Macros-for-libraries" accesskey="n" rel="next">Macros for librar <p>Macros for compiler-related checks: </p> -<dl> -<dt id="index-KPSE_005fCOMPILER_005fWARNINGS">Macro: <strong>KPSE_COMPILER_WARNINGS</strong></dt> +<dl class="def"> +<dt id="index-KPSE_005fCOMPILER_005fWARNINGS"><span class="category">Macro: </span><span><strong>KPSE_COMPILER_WARNINGS</strong><a href='#index-KPSE_005fCOMPILER_005fWARNINGS' class='copiable-anchor'> ¶</a></span></dt> <dd><span id="index-WARNING_005fC_005bXX_005dFLAGS"></span> <p>When using the (Objective) C/C++ compiler, set <code>WARNING_[OBJ]C[XX]FLAGS</code> to suitable warning flags (depending on @@ -1508,8 +1545,8 @@ warning options, but could be extended to others if necessary. … variables. </p></dd></dl> -<dl> -<dt id="index-KPSE_005fCOMPILER_005fVISIBILITY">Macro: <strong>KPSE_COMPILER_VISIBILITY</strong></dt> +<dl class="def"> +<dt id="index-KPSE_005fCOMPILER_005fVISIBILITY"><span class="category">Macro: </span><span><strong>KPSE_COMPILER_VISIBILITY</strong><a href='#index-KPSE_005fCOMPILER_005fVISIBILITY' class='copiable-anchor'> ¶</a></span></dt> <dd><p>When using the C or C++ compiler, try to set <code>VISIBILITY_C[XX]FLAGS</code> to flags to hide external symbols. Call <code>AC_SUBST</code> for this variable. At present this only tests for @@ -1521,8 +1558,8 @@ extended if necessary. or <code>kpse_cv_visibility_cxxflags</code> variable. </p></dd></dl> -<dl> -<dt id="index-KPSE_005fCXX_005fHACK">Macro: <strong>KPSE_CXX_HACK</strong></dt> +<dl class="def"> +<dt id="index-KPSE_005fCXX_005fHACK"><span class="category">Macro: </span><span><strong>KPSE_CXX_HACK</strong><a href='#index-KPSE_005fCXX_005fHACK' class='copiable-anchor'> ¶</a></span></dt> <dd><span id="index-static-linking-for-C_002b_002b"></span> <span id="index-linking-C_002b_002b-libraries-statically"></span> <span id="index-_002d_002denable_002dcxx_002druntime_002dhack"></span> @@ -1536,9 +1573,10 @@ binary. <p>This macro caches its result in the <code>kpse_cv_cxx_hack</code> variable. </p></dd></dl> - <hr> -<span id="Macros-for-libraries"></span><div class="header"> +</div> +<div class="subsection" id="Macros-for-libraries"> +<div class="header"> <p> Next: <a href="#Macros-for-library-and-header-flags" accesskey="n" rel="next">Macros for library and header flags</a>, Previous: <a href="#Macros-for-compilers" accesskey="p" rel="prev">Macros for compilers</a>, Up: <a href="#Autoconf-macros" accesskey="u" rel="up">Autoconf 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> @@ -1547,16 +1585,17 @@ Next: <a href="#Macros-for-library-and-header-flags" accesskey="n" rel="next">Ma <span id="index-macros_002c-for-libraries"></span> <p>One macro for a library check: </p> -<dl> -<dt id="index-KPSE_005fLARGEFILE">Macro: <strong>KPSE_LARGEFILE</strong> <em>(<var>variable</var>, [<var>extra-define</var>])</em></dt> +<dl class="def"> +<dt id="index-KPSE_005fLARGEFILE"><span class="category">Macro: </span><span><strong>KPSE_LARGEFILE</strong> <em>(<var>variable</var>, [<var>extra-define</var>])</em><a href='#index-KPSE_005fLARGEFILE' class='copiable-anchor'> ¶</a></span></dt> <dd><p>Call <code>AC_SYS_LARGEFILE</code> and <code>AC_FUNC_FSEEKO</code> and append suitable <code>-D</code> flags (optionally including <code>-D<var>extra-define</var></code>) to <var>variable</var>. </p></dd></dl> - <hr> -<span id="Macros-for-library-and-header-flags"></span><div class="header"> +</div> +<div class="subsection" id="Macros-for-library-and-header-flags"> +<div class="header"> <p> Next: <a href="#Macros-for-Windows" accesskey="n" rel="next">Macros for Windows</a>, Previous: <a href="#Macros-for-libraries" accesskey="p" rel="prev">Macros for libraries</a>, Up: <a href="#Autoconf-macros" accesskey="u" rel="up">Autoconf 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> @@ -1570,8 +1609,8 @@ supplemented by a macro <code>KPSE_<var>LIB</var>_FLAGS</code> (all uppercase) that provides make variables for that library. E.g., for <samp>libs/libpng</samp>: </p> -<dl> -<dt id="index-KPSE_005fLIBPNG_005fFLAGS">Macro: <strong>KPSE_LIBPNG_FLAGS</strong></dt> +<dl class="def"> +<dt id="index-KPSE_005fLIBPNG_005fFLAGS"><span class="category">Macro: </span><span><strong>KPSE_LIBPNG_FLAGS</strong><a href='#index-KPSE_005fLIBPNG_005fFLAGS' class='copiable-anchor'> ¶</a></span></dt> <dd><p>Provide the configure option <code>--with-system-libpng</code>. Set and <code>AC_SUBST</code> <code>make</code> variables for modules using this library (either an installed version or from the TeX Live tree): @@ -1584,14 +1623,14 @@ an installed version or from the TeX Live tree): </table> </dd></dl> -<dl> -<dt id="index-KPSE_005fADD_005fFLAGS">Macro: <strong>KPSE_ADD_FLAGS</strong> <em>(<var>name</var>)</em></dt> +<dl class="def"> +<dt id="index-KPSE_005fADD_005fFLAGS"><span class="category">Macro: </span><span><strong>KPSE_ADD_FLAGS</strong> <em>(<var>name</var>)</em><a href='#index-KPSE_005fADD_005fFLAGS' class='copiable-anchor'> ¶</a></span></dt> <dd><p>Temporarily extend <code>CPPFLAGS</code> and <code>LIBS</code> with the values required for the library module <code><var>name</var></code>. </p></dd></dl> -<dl> -<dt id="index-KPSE_005fRESTORE_005fFLAGS">Macro: <strong>KPSE_RESTORE_FLAGS</strong></dt> +<dl class="def"> +<dt id="index-KPSE_005fRESTORE_005fFLAGS"><span class="category">Macro: </span><span><strong>KPSE_RESTORE_FLAGS</strong><a href='#index-KPSE_005fRESTORE_005fFLAGS' class='copiable-anchor'> ¶</a></span></dt> <dd><p>Restore <code>CPPFLAGS</code> and <code>LIBS</code> to their original values. </p></dd></dl> @@ -1626,9 +1665,10 @@ KPSE_ADD_FLAGS([libpng]) KPSE_RESTORE_FLAGS # <span class="roman">restore <code>CPPFLAGS</code> and <code>LIBS</code></span> </pre></div> - <hr> -<span id="Macros-for-Windows"></span><div class="header"> +</div> +<div class="subsection" id="Macros-for-Windows"> +<div class="header"> <p> Previous: <a href="#Macros-for-library-and-header-flags" accesskey="p" rel="prev">Macros for library and header flags</a>, Up: <a href="#Autoconf-macros" accesskey="u" rel="up">Autoconf 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> @@ -1639,8 +1679,8 @@ Previous: <a href="#Macros-for-library-and-header-flags" accesskey="p" rel="prev <p>Windows differs in several aspects from Unix-like systems, many of them due to the lack of symbolic links. </p> -<dl> -<dt id="index-KPSE_005fCHECK_005fWIN32">Macro: <strong>KPSE_CHECK_WIN32</strong></dt> +<dl class="def"> +<dt id="index-KPSE_005fCHECK_005fWIN32"><span class="category">Macro: </span><span><strong>KPSE_CHECK_WIN32</strong><a href='#index-KPSE_005fCHECK_005fWIN32' class='copiable-anchor'> ¶</a></span></dt> <dd><span id="index-kpse_005fcv_005fhave_005fwin32"></span> <p>Check if compiling for a Windows system. The result is either <code>no</code> for Unix-like systems (including Cygwin), <code>mingw32</code> for @@ -1648,24 +1688,24 @@ Windows with GCC, or <code>native</code> for Windows with MSVC. The result is cached in the <code>kpse_cv_have_win32</code> variable. </p></dd></dl> -<dl> -<dt id="index-KPSE_005fCOND_005fWIN32">Macro: <strong>KPSE_COND_WIN32</strong></dt> +<dl class="def"> +<dt id="index-KPSE_005fCOND_005fWIN32"><span class="category">Macro: </span><span><strong>KPSE_COND_WIN32</strong><a href='#index-KPSE_005fCOND_005fWIN32' class='copiable-anchor'> ¶</a></span></dt> <dd><span id="index-WIN32_002c-Automake-conditional"></span> <p>Call <code>KPSE_CHECK_WIN32</code> and define the Automake conditional <code>WIN32</code> (<code>true</code> if the value of <code>kpse_cv_have_win32</code> is not <code>no</code>). </p></dd></dl> -<dl> -<dt id="index-KPSE_005fCOND_005fMINGW32">Macro: <strong>KPSE_COND_MINGW32</strong></dt> +<dl class="def"> +<dt id="index-KPSE_005fCOND_005fMINGW32"><span class="category">Macro: </span><span><strong>KPSE_COND_MINGW32</strong><a href='#index-KPSE_005fCOND_005fMINGW32' class='copiable-anchor'> ¶</a></span></dt> <dd><span id="index-MINGW32_002c-Automake-conditional"></span> <p>Call <code>KPSE_COND_WIN32</code> and define the Automake conditional <code>MINGW32</code> (<code>true</code> if the value of <code>kpse_cv_have_win32</code> is <code>mingw32</code>). </p></dd></dl> -<dl> -<dt id="index-KPSE_005fCOND_005fWIN32_005fWRAP">Macro: <strong>KPSE_COND_WIN32_WRAP</strong></dt> +<dl class="def"> +<dt id="index-KPSE_005fCOND_005fWIN32_005fWRAP"><span class="category">Macro: </span><span><strong>KPSE_COND_WIN32_WRAP</strong><a href='#index-KPSE_005fCOND_005fWIN32_005fWRAP' class='copiable-anchor'> ¶</a></span></dt> <dd><span id="index-WIN32_005fWRAP_002c-Automake-conditional"></span> <span id="index-runscript_002eexe"></span> <p>Call <code>KPSE_COND_WIN32</code> and define the Automake conditional @@ -1675,8 +1715,8 @@ is used on Windows instead of symlinks for the “linked scripts” (see <a href="#Linked-scripts">Linked scripts</a>). </p></dd></dl> -<dl> -<dt id="index-KPSE_005fWIN32_005fCALL">Macro: <strong>KPSE_WIN32_CALL</strong></dt> +<dl class="def"> +<dt id="index-KPSE_005fWIN32_005fCALL"><span class="category">Macro: </span><span><strong>KPSE_WIN32_CALL</strong><a href='#index-KPSE_005fWIN32_005fCALL' class='copiable-anchor'> ¶</a></span></dt> <dd><span id="index-callexe_002ec"></span> <p>Call <code>KPSE_COND_WIN32</code> and check if the file <samp>texk/texlive/w32_wrapper/callexe.c</samp> exists; if it does, create a @@ -1686,9 +1726,11 @@ as <code><var>bar</var>.exe</code> is used on Windows instead of a symlink <code><var>bar</var>-><var>foo</var></code> for Unix-like systems. </p></dd></dl> - <hr> -<span id="Library-modules"></span><div class="header"> +</div> +</div> +<div class="section" id="Library-modules"> +<div class="header"> <p> Next: <a href="#Program-modules" accesskey="n" rel="next">Program modules</a>, Previous: <a href="#Autoconf-macros" accesskey="p" rel="prev">Autoconf macros</a>, Up: <a href="#Layout-and-infrastructure" accesskey="u" rel="up">Layout and infrastructure</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> </div> @@ -1700,21 +1742,18 @@ Next: <a href="#Program-modules" accesskey="n" rel="next">Program modules</a>, P for the details themselves, and as a way of illuminating the general structure and variation. </p> -<table class="menu" border="0" cellspacing="0"> -<tr><td align="left" valign="top">• <a href="#png-library" accesskey="1"><code>png</code> library</a></td><td> </td><td align="left" valign="top"><samp>libs/libpng</samp> -</td></tr> -<tr><td align="left" valign="top">• <a href="#zlib-library" accesskey="2"><code>zlib</code> library</a></td><td> </td><td align="left" valign="top"><samp>libs/zlib</samp> -</td></tr> -<tr><td align="left" valign="top">• <a href="#freetype-library" accesskey="3"><code>freetype</code> library</a></td><td> </td><td align="left" valign="top"><samp>libs/freetype2</samp> -</td></tr> -<tr><td align="left" valign="top">• <a href="#kpathsea-library" accesskey="4"><code>kpathsea</code> library</a></td><td> </td><td align="left" valign="top"><samp>texk/kpathsea</samp> -</td></tr> -</table> +<ul class="section-toc"> +<li><a href="#png-library" accesskey="1">The <code>png</code> library in <samp>libs/libpng</samp></a></li> +<li><a href="#zlib-library" accesskey="2">The <code>zlib</code> library in <samp>libs/zlib</samp></a></li> +<li><a href="#freetype-library" accesskey="3">The <code>freetype</code> library in <samp>libs/freetype2</samp></a></li> +<li><a href="#kpathsea-library" accesskey="4">The <code>kpathsea</code> library in <samp>texk/kpathsea</samp></a></li> +</ul> <hr> -<span id="png-library"></span><div class="header"> +<div class="subsection" id="png-library"> +<div class="header"> <p> -Next: <a href="#zlib-library" accesskey="n" rel="next"><code>zlib</code> library</a>, Up: <a href="#Library-modules" accesskey="u" rel="up">Library modules</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="#zlib-library" accesskey="n" rel="next">The <code>zlib</code> library in <samp>libs/zlib</samp></a>, Up: <a href="#Library-modules" accesskey="u" rel="up">Library modules</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-png-library-in-libs_002flibpng"></span><h4 class="subsection">6.4.1 The <code>png</code> library in <samp>libs/libpng</samp></h4> @@ -1786,11 +1825,12 @@ for the <code>make</code> rules to rebuild the library. <code>--with-system-libpng</code>, which then uses <code>pkg-config</code> to determine the flags required for the system library. </p> - <hr> -<span id="zlib-library"></span><div class="header"> +</div> +<div class="subsection" id="zlib-library"> +<div class="header"> <p> -Next: <a href="#freetype-library" accesskey="n" rel="next"><code>freetype</code> library</a>, Previous: <a href="#png-library" accesskey="p" rel="prev"><code>png</code> library</a>, Up: <a href="#Library-modules" accesskey="u" rel="up">Library modules</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="#freetype-library" accesskey="n" rel="next">The <code>freetype</code> library in <samp>libs/freetype2</samp></a>, Previous: <a href="#png-library" accesskey="p" rel="prev">The <code>png</code> library in <samp>libs/libpng</samp></a>, Up: <a href="#Library-modules" accesskey="u" rel="up">Library modules</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-zlib-library-in-libs_002fzlib"></span><h4 class="subsection">6.4.2 The <code>zlib</code> library in <samp>libs/zlib</samp></h4> @@ -1804,11 +1844,12 @@ without the dependency on any other library. The file <code>--with-zlib-libdir</code> to specify non-standard locations of the <code>zlib</code> headers and/or library. </p> - <hr> -<span id="freetype-library"></span><div class="header"> +</div> +<div class="subsection" id="freetype-library"> +<div class="header"> <p> -Next: <a href="#kpathsea-library" accesskey="n" rel="next"><code>kpathsea</code> library</a>, Previous: <a href="#zlib-library" accesskey="p" rel="prev"><code>zlib</code> library</a>, Up: <a href="#Library-modules" accesskey="u" rel="up">Library modules</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="#kpathsea-library" accesskey="n" rel="next">The <code>kpathsea</code> library in <samp>texk/kpathsea</samp></a>, Previous: <a href="#zlib-library" accesskey="p" rel="prev">The <code>zlib</code> library in <samp>libs/zlib</samp></a>, Up: <a href="#Library-modules" accesskey="u" rel="up">Library modules</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-freetype-library-in-libs_002ffreetype2"></span><h4 class="subsection">6.4.3 The <code>freetype</code> library in <samp>libs/freetype2</samp></h4> @@ -1827,18 +1868,19 @@ other words, this actually uses the build system provided by upstream <p>The flags required for the system library are obtained through <code>freetype-config</code>. </p> - <hr> -<span id="kpathsea-library"></span><div class="header"> +</div> +<div class="subsection" id="kpathsea-library"> +<div class="header"> <p> -Previous: <a href="#freetype-library" accesskey="p" rel="prev"><code>freetype</code> library</a>, Up: <a href="#Library-modules" accesskey="u" rel="up">Library modules</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="#freetype-library" accesskey="p" rel="prev">The <code>freetype</code> library in <samp>libs/freetype2</samp></a>, Up: <a href="#Library-modules" accesskey="u" rel="up">Library modules</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-kpathsea-library-in-texk_002fkpathsea"></span><h4 class="subsection">6.4.4 The <code>kpathsea</code> library in <samp>texk/kpathsea</samp></h4> <span id="index-kpathsea-library"></span> <p>This is one of the TeX-specific libraries that are maintained as -part of TeX Live (see <cite><a href="https://tug.org/texinfohtml/kpathsea.html#Top">Kpathsea +part of TeX Live (see <cite><a data-manual="kpathsea" href="https://tug.org/texinfohtml/kpathsea.html#Top">Kpathsea <span class="roman">(<a href="tug.org/kpathsea">tug.org/kpathsea</a>)</span></a></cite>); the other is <code>ptexenc</code>. These TeX libraries are Libtool libraries (static and/or shared) and are installed by <code>make install</code> together with the programs. They @@ -1866,9 +1908,11 @@ however, the command line options <code>-mktex=tfm</code> or <code>-no-mktex=tfm</code> for the TeX-like engines override this default. </p> - <hr> -<span id="Program-modules"></span><div class="header"> +</div> +</div> +<div class="section" id="Program-modules"> +<div class="header"> <p> Next: <a href="#Extending-TeX-Live" accesskey="n" rel="next">Extending TeX Live</a>, Previous: <a href="#Library-modules" accesskey="p" rel="prev">Library modules</a>, Up: <a href="#Layout-and-infrastructure" accesskey="u" rel="up">Layout and infrastructure</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> </div> @@ -1879,22 +1923,18 @@ Next: <a href="#Extending-TeX-Live" accesskey="n" rel="next">Extending TeX <p>As with libraries (see <a href="#Library-modules">Library modules</a>), here we discuss the details for a few of the programs in TL. </p> -<table class="menu" border="0" cellspacing="0"> -<tr><td align="left" valign="top">• <a href="#t1utils-package" accesskey="1"><code>t1utils</code> package</a></td><td> </td><td align="left" valign="top"><samp>utils/t1utils</samp> -</td></tr> -<tr><td align="left" valign="top">• <a href="#xindy-package" accesskey="2"><code>xindy</code> package</a></td><td> </td><td align="left" valign="top"><samp>utils/xindy</samp> -</td></tr> -<tr><td align="left" valign="top">• <a href="#xdvik-package" accesskey="3"><code>xdvik</code> package</a></td><td> </td><td align="left" valign="top"><samp>texk/xdvik</samp> -</td></tr> -<tr><td align="left" valign="top">• <a href="#asymptote" accesskey="4"><code>asymptote</code></a></td><td> </td><td align="left" valign="top"><samp>utils/asymptote</samp> -</td></tr> -</table> - +<ul class="section-toc"> +<li><a href="#t1utils-package" accesskey="1">The <code>t1utils</code> package in <samp>utils/t1utils</samp></a></li> +<li><a href="#xindy-package" accesskey="2">The <code>xindy</code> package in <samp>utils/xindy</samp></a></li> +<li><a href="#xdvik-package" accesskey="3">The <code>xdvik</code> package in <samp>texk/xdvik</samp></a></li> +<li><a href="#asymptote" accesskey="4">The subdirectory <samp>utils/asymptote</samp></a></li> +</ul> <hr> -<span id="t1utils-package"></span><div class="header"> +<div class="subsection" id="t1utils-package"> +<div class="header"> <p> -Next: <a href="#xindy-package" accesskey="n" rel="next"><code>xindy</code> package</a>, Up: <a href="#Program-modules" accesskey="u" rel="up">Program modules</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="#xindy-package" accesskey="n" rel="next">The <code>xindy</code> package in <samp>utils/xindy</samp></a>, Up: <a href="#Program-modules" accesskey="u" rel="up">Program modules</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-t1utils-package-in-utils_002ft1utils"></span><h4 class="subsection">6.5.1 The <code>t1utils</code> package in <samp>utils/t1utils</samp></h4> @@ -1912,11 +1952,12 @@ fragment <samp>ac/withenable.ac</samp> contains <p>specifying the module name without any dependencies, and supplies the configure option <code>--disable-t1utils</code>. </p> - <hr> -<span id="xindy-package"></span><div class="header"> +</div> +<div class="subsection" id="xindy-package"> +<div class="header"> <p> -Next: <a href="#xdvik-package" accesskey="n" rel="next"><code>xdvik</code> package</a>, Previous: <a href="#t1utils-package" accesskey="p" rel="prev"><code>t1utils</code> package</a>, Up: <a href="#Program-modules" accesskey="u" rel="up">Program modules</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="#xdvik-package" accesskey="n" rel="next">The <code>xdvik</code> package in <samp>texk/xdvik</samp></a>, Previous: <a href="#t1utils-package" accesskey="p" rel="prev">The <code>t1utils</code> package in <samp>utils/t1utils</samp></a>, Up: <a href="#Program-modules" accesskey="u" rel="up">Program modules</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-xindy-package-in-utils_002fxindy"></span><h4 class="subsection">6.5.2 The <code>xindy</code> package in <samp>utils/xindy</samp></h4> @@ -1928,7 +1969,7 @@ modifications documented in <samp>TLpatches/*</samp>, and a wrapper <samp>xindy-src</samp>. </p> <p>The <code>xindy</code> build requires a <samp>make</samp> that supports a -<code>VPATH</code> build, can handle all targets, and do not refer to +<code>VPATH</code> build, can handle all targets, and does not refer to <code>${top_srcdir}</code> or <code>${top_builddir}</code>. The fragment <code>xindy/ac/withenable.ac</code> contains </p> @@ -1947,11 +1988,12 @@ too painful to enable by default). specify more <code>configure</code> options to be seen at the top level, with <samp>ac/xindy.ac</samp> also included by <samp>configure.ac</samp>. </p> - <hr> -<span id="xdvik-package"></span><div class="header"> +</div> +<div class="subsection" id="xdvik-package"> +<div class="header"> <p> -Next: <a href="#asymptote" accesskey="n" rel="next"><code>asymptote</code></a>, Previous: <a href="#xindy-package" accesskey="p" rel="prev"><code>xindy</code> package</a>, Up: <a href="#Program-modules" accesskey="u" rel="up">Program modules</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="#asymptote" accesskey="n" rel="next">The subdirectory <samp>utils/asymptote</samp></a>, Previous: <a href="#xindy-package" accesskey="p" rel="prev">The <code>xindy</code> package in <samp>utils/xindy</samp></a>, Up: <a href="#Program-modules" accesskey="u" rel="up">Program modules</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-xdvik-package-in-texk_002fxdvik"></span><h4 class="subsection">6.5.3 The <code>xdvik</code> package in <samp>texk/xdvik</samp></h4> @@ -1982,11 +2024,12 @@ auxiliary program <samp>squeeze/squeeze</samp> has to run on the <samp>configure.ac</samp> and supplies the configure option <code>--with-xdvi-x-toolkit</code> also seen at the top level. </p> - <hr> -<span id="asymptote"></span><div class="header"> +</div> +<div class="subsection" id="asymptote"> +<div class="header"> <p> -Previous: <a href="#xdvik-package" accesskey="p" rel="prev"><code>xdvik</code> package</a>, Up: <a href="#Program-modules" accesskey="u" rel="up">Program modules</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="#xdvik-package" accesskey="p" rel="prev">The <code>xdvik</code> package in <samp>texk/xdvik</samp></a>, Up: <a href="#Program-modules" accesskey="u" rel="up">Program modules</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-subdirectory-utils_002fasymptote"></span><h4 class="subsection">6.5.4 The subdirectory <samp>utils/asymptote</samp></h4> @@ -2000,9 +2043,11 @@ not part of the TL build system. These programs must be built and installed independently, but are included on the TL DVD together with their support files. See <a href="https://tug.org/build.html#asymptote">https://tug.org/build.html#asymptote</a>. </p> - <hr> -<span id="Extending-TeX-Live"></span><div class="header"> +</div> +</div> +<div class="section" id="Extending-TeX-Live"> +<div class="header"> <p> Previous: <a href="#Program-modules" accesskey="p" rel="prev">Program modules</a>, Up: <a href="#Layout-and-infrastructure" accesskey="u" rel="up">Layout and infrastructure</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> </div> @@ -2022,20 +2067,18 @@ reasonable. In addition, <samp>foo/</samp> will need the usual Automake build-related files (<samp>configure.ac</samp>, <samp>Makefile.am</samp>, etc. Please maintain <samp>foo/ChangeLog</samp> for all TL changes. </p> -<table class="menu" border="0" cellspacing="0"> -<tr><td align="left" valign="top">• <a href="#Adding-a-new-program-module" accesskey="1">Adding a new program module</a></td><td> </td><td align="left" valign="top"> -</td></tr> -<tr><td align="left" valign="top">• <a href="#Adding-a-new-generic-library-module" accesskey="2">Adding a new generic library module</a></td><td> </td><td align="left" valign="top"> -</td></tr> -<tr><td align="left" valign="top">• <a href="#Adding-a-new-TeX_002dspecific-library-module" accesskey="3">Adding a new TeX-specific library module</a></td><td> </td><td align="left" valign="top"> -</td></tr> -</table> - +<ul class="section-toc"> +<li><a href="#Adding-a-new-program-module" accesskey="1">Adding a new program module</a></li> +<li><a href="#Adding-a-new-engine" accesskey="2">Adding a new engine</a></li> +<li><a href="#Adding-a-new-generic-library-module" accesskey="3">Adding a new generic library module</a></li> +<li><a href="#Adding-a-new-TeX_002dspecific-library-module" accesskey="4">Adding a new TeX-specific library module</a></li> +</ul> <hr> -<span id="Adding-a-new-program-module"></span><div class="header"> +<div class="subsection" id="Adding-a-new-program-module"> +<div class="header"> <p> -Next: <a href="#Adding-a-new-generic-library-module" accesskey="n" rel="next">Adding a new generic library module</a>, Up: <a href="#Extending-TeX-Live" accesskey="u" rel="up">Extending TeX Live</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="#Adding-a-new-engine" accesskey="n" rel="next">Adding a new engine</a>, Up: <a href="#Extending-TeX-Live" accesskey="u" rel="up">Extending TeX Live</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="Adding-a-new-program-module-1"></span><h4 class="subsection">6.6.1 Adding a new program module</h4> @@ -2092,18 +2135,12 @@ source files in <code>...-src</code>. TL source directory (<samp>texk/newprog</samp> or <samp>utils/newprog</samp>): </p> <dl compact="compact"> -<dt><samp>ac/withenable.ac</samp> -<span id="index-ac_002fwithenable_002eac"></span> -</dt> +<dt id='index-ac_002fwithenable_002eac'><span><samp>ac/withenable.ac</samp><a href='#index-ac_002fwithenable_002eac' class='copiable-anchor'> ¶</a></span></dt> <dd><p>The <code>KPSE_ENABLE_PROG</code> call just explained. </p> </dd> -<dt><samp>configure.ac</samp> -<span id="index-configure_002eac"></span> -</dt> -<dt><samp>Makefile.am</samp> -<span id="index-Makefile_002eam"></span> -</dt> +<dt id='index-configure_002eac'><span><samp>configure.ac</samp><a href='#index-configure_002eac' class='copiable-anchor'> ¶</a></span></dt> +<dt id='index-Makefile_002eam'><span><samp>Makefile.am</samp><a href='#index-Makefile_002eam' class='copiable-anchor'> ¶</a></span></dt> <dd><p>By merging the contents of the original <samp>configure.ac</samp> (if provided) and a comparable program already in TL. In the above example, one line that will be needed in <samp>configure.ac</samp> (can be @@ -2125,24 +2162,18 @@ investigate how something is done. Most of the TL-specific macros are defined in <samp>Build/source/m4/*</samp>. </p> </dd> -<dt><samp>TLpatches/TL-Changes</samp> -<span id="index-TLpatches_002fTL_002dChanges"></span> -</dt> +<dt id='index-TLpatches_002fTL_002dChanges'><span><samp>TLpatches/TL-Changes</samp><a href='#index-TLpatches_002fTL_002dChanges' class='copiable-anchor'> ¶</a></span></dt> <dd><p>First actions taken after getting the original source tree; typically removal of derived or unused common files. </p> </dd> -<dt><samp>TLpatches/patch-...</samp> -<span id="index-TLpatches_002fpatch_002d_002e_002e_002e"></span> -</dt> +<dt id='index-TLpatches_002fpatch_002d_002e_002e_002e'><span><samp>TLpatches/patch-...</samp><a href='#index-TLpatches_002fpatch_002d_002e_002e_002e' class='copiable-anchor'> ¶</a></span></dt> <dd><p>If any changes are needed to the original sources, record the patches here so they can be applied next time. Also, send them upstream so that we don’t have to maintain them forever. </p> </dd> -<dt><samp>ChangeLog</samp> -<span id="index-ChangeLog"></span> -</dt> +<dt id='index-ChangeLog'><span><samp>ChangeLog</samp><a href='#index-ChangeLog' class='copiable-anchor'> ¶</a></span></dt> <dd><p>Record all TL-specific changes, now and in the future. </p> </dd> @@ -2179,21 +2210,61 @@ builds from scratch. <p>After final success, don’t forget to commit. (Or email the TL maintainers with the patch.) </p> +<hr> +</div> +<div class="subsection" id="Adding-a-new-engine"> +<div class="header"> +<p> +Next: <a href="#Adding-a-new-generic-library-module" accesskey="n" rel="next">Adding a new generic library module</a>, Previous: <a href="#Adding-a-new-program-module" accesskey="p" rel="prev">Adding a new program module</a>, Up: <a href="#Extending-TeX-Live" accesskey="u" rel="up">Extending TeX Live</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="Adding-a-new-engine-1"></span><h4 class="subsection">6.6.2 Adding a new engine</h4> + +<span id="index-adding-a-new-engine"></span> <span id="index-engine_002c-adding-new"></span> -<p>Caveat: adding a new TeX engine is not completely different, but -it’s not all that similar, either. In that case, the work is done -inside a new subdirectory of <samp>texk/web2c/</samp>. Many things are -common to all the engines, other things need to be copied and possibly -modified for each one, yet others are unique to each. No general -recipe is possible. -</p> +<p>Adding a new TeX engine is not completely different from adding a +program, but it’s not all that similar, either. In this case, the main +work is done by creating a new subdirectory of <samp>texk/web2c/</samp> for +the engine. The subdirectory is conventionally named ending in +<samp>dir</samp>, like <samp>pdftexdir</samp> and <samp>xetexdir</samp>, to avoid +clashes with executable names. +</p> +<p>The source files for the new engine should be put in this +<samp><var>newengine</var>dir</samp> subdirectory. Also, a file +<samp><var>newengine</var>dir/am/<var>newengine</var>.am</samp> (e.g., +<samp>pdftexdir/am/pdftex.am</samp> is needed with the Makefile fragment +needed to build it. +</p> +<p>The overall <samp>web2c/Makefile.am</samp> needs to have an <samp>include</samp> +statement added to insert that <samp><var>newengine</var>.am</samp> file. +</p> +<p>In <samp>web2c/ac/web2c.ac</samp>, a line needs to be added in the +definition of the <code>kpse_tex_progs</code> variable to include it in the +build. That line specifies whether the new engine is built by default, +and the additional libraries requires. +</p> +<p>For examples of building engines in CWEB, you can check the existing +<samp>hitexdir</samp> and <samp>mplibdir</samp> directories; these are somewhat +simpler than LuaTeX. Of course, every engine will have its own +unique features and requirements, so existing examples will only take +you so far. +</p> +<p>Web2c is built as one “package”, with each subdirectory’s <samp>.am</samp> +fragment inserted with an Automake <code>include</code>. This means that, +for instance, <code>$(srcdir)</code> is <samp>.../web2c</samp>, not +<samp>.../webdir/enginedir</samp>. It is a difficult setup to come to terms +with, but the alternative is to recurse into each engine subdirectory, +and that would be far worse (see <a data-manual="automake" href="https://www.gnu.org/software/automake/manual/automake.html#Directories">Directories</a> in <cite>GNU +Automake</cite>). +</p> <hr> -<span id="Adding-a-new-generic-library-module"></span><div class="header"> +</div> +<div class="subsection" id="Adding-a-new-generic-library-module"> +<div class="header"> <p> -Next: <a href="#Adding-a-new-TeX_002dspecific-library-module" accesskey="n" rel="next">Adding a new TeX-specific library module</a>, Previous: <a href="#Adding-a-new-program-module" accesskey="p" rel="prev">Adding a new program module</a>, Up: <a href="#Extending-TeX-Live" accesskey="u" rel="up">Extending TeX Live</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="#Adding-a-new-TeX_002dspecific-library-module" accesskey="n" rel="next">Adding a new TeX-specific library module</a>, Previous: <a href="#Adding-a-new-engine" accesskey="p" rel="prev">Adding a new engine</a>, Up: <a href="#Extending-TeX-Live" accesskey="u" rel="up">Extending TeX Live</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="Adding-a-new-generic-library-module-1"></span><h4 class="subsection">6.6.2 Adding a new generic library module</h4> +<span id="Adding-a-new-generic-library-module-1"></span><h4 class="subsection">6.6.3 Adding a new generic library module</h4> <span id="index-adding-a-new-generic-library"></span> <span id="index-generic-library-module_002c-adding"></span> @@ -2246,13 +2317,14 @@ the <code>make</code> variables for a system library. In addition, the definition of the M4 macro <code>KPSE_ALL_SYSTEM_FLAGS</code> in <samp>m4/kpse-pkgs.m4</samp> must be extended by the line:<br> <code>AC_REQUIRE([KPSE_<var>LIB</var>_SYSTEM_FLAGS])</code> </p> - <hr> -<span id="Adding-a-new-TeX_002dspecific-library-module"></span><div class="header"> +</div> +<div class="subsection" id="Adding-a-new-TeX_002dspecific-library-module"> +<div class="header"> <p> Previous: <a href="#Adding-a-new-generic-library-module" accesskey="p" rel="prev">Adding a new generic library module</a>, Up: <a href="#Extending-TeX-Live" accesskey="u" rel="up">Extending TeX Live</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="Adding-a-new-TeX_002dspecific-library-module-1"></span><h4 class="subsection">6.6.3 Adding a new TeX-specific library module</h4> +<span id="Adding-a-new-TeX_002dspecific-library-module-1"></span><h4 class="subsection">6.6.4 Adding a new TeX-specific library module</h4> <span id="index-adding-a-new-TeX_002dspecific-library"></span> <span id="index-TeX_002dspecific-library-module_002c-adding"></span> @@ -2273,11 +2345,14 @@ The library name <code><var>lib</var></code> is added to the M4 macro The fragment <code>ac/withenable.ac</code> must use <code>KPSE_WITH_TEXLIB</code>. </li></ul> - <hr> -<span id="Configure-options"></span><div class="header"> +</div> +</div> +</div> +<div class="chapter" id="Configure-options"> +<div class="header"> <p> -Next: <a href="#Coding-conventions" accesskey="n" rel="next">Coding conventions</a>, Previous: <a href="#Layout-and-infrastructure" accesskey="p" rel="prev">Layout and infrastructure</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="#Coding-conventions" accesskey="n" rel="next">Coding conventions</a>, Previous: <a href="#Layout-and-infrastructure" accesskey="p" rel="prev">Layout and infrastructure</a>, Up: <a href="#Top" accesskey="u" rel="up">Building TeX Live (2022)</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="Configure-options-1"></span><h2 class="chapter">7 Configure options</h2> @@ -2306,20 +2381,16 @@ actual <code>configure</code> script; invoking <code>configure</code> via explicitly to all subdirectories. Options specified on the command line are checked for consistency but never modified. </p> -<table class="menu" border="0" cellspacing="0"> -<tr><td align="left" valign="top">• <a href="#Global-configure-options" accesskey="1">Global configure options</a></td><td> </td><td align="left" valign="top"> -</td></tr> -<tr><td align="left" valign="top">• <a href="#Program_002dspecific-configure-options" accesskey="2">Program-specific configure options</a></td><td> </td><td align="left" valign="top"> -</td></tr> -<tr><td align="left" valign="top">• <a href="#Library_002dspecific-configure-options" accesskey="3">Library-specific configure options</a></td><td> </td><td align="left" valign="top"> -</td></tr> -<tr><td align="left" valign="top">• <a href="#Variables-for-configure" accesskey="4">Variables for configure</a></td><td> </td><td align="left" valign="top"> -</td></tr> -</table> - +<ul class="section-toc"> +<li><a href="#Global-configure-options" accesskey="1">Global configure options</a></li> +<li><a href="#Program_002dspecific-configure-options" accesskey="2">Program-specific configure options</a></li> +<li><a href="#Library_002dspecific-configure-options" accesskey="3">Library-specific configure options</a></li> +<li><a href="#Variables-for-configure" accesskey="4">Variables for configure</a></li> +</ul> <hr> -<span id="Global-configure-options"></span><div class="header"> +<div class="section" id="Global-configure-options"> +<div class="header"> <p> Next: <a href="#Program_002dspecific-configure-options" accesskey="n" rel="next">Program-specific configure options</a>, Up: <a href="#Configure-options" accesskey="u" rel="up">Configure 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> @@ -2329,38 +2400,26 @@ Next: <a href="#Program_002dspecific-configure-options" accesskey="n" rel="next" <span id="index-configure-options_002c-global"></span> <p>Here are the global configure options. </p> -<table class="menu" border="0" cellspacing="0"> -<tr><td align="left" valign="top">• <a href="#g_t_002d_002ddisable_002dnative_002dtexlive_002dbuild" accesskey="1"><code>--disable-native-texlive-build</code></a></td><td> </td><td align="left" valign="top"> -</td></tr> -<tr><td align="left" valign="top">• <a href="#g_t_002d_002dprefix-_002d_002dbindir-_2026" accesskey="2"><code>--prefix</code> <code>--bindir</code> …</a></td><td> </td><td align="left" valign="top"> -</td></tr> -<tr><td align="left" valign="top">• <a href="#g_t_002d_002ddisable_002dlargefile" accesskey="3"><code>--disable-largefile</code></a></td><td> </td><td align="left" valign="top"> -</td></tr> -<tr><td align="left" valign="top">• <a href="#g_t_002d_002ddisable_002dmissing" accesskey="4"><code>--disable-missing</code></a></td><td> </td><td align="left" valign="top"> -</td></tr> -<tr><td align="left" valign="top">• <a href="#g_t_002d_002denable_002dcompiler_002dwarnings_003dlevel" accesskey="5"><code>--enable-compiler-warnings=</code><var>level</var></a></td><td> </td><td align="left" valign="top"> -</td></tr> -<tr><td align="left" valign="top">• <a href="#g_t_002d_002denable_002dcxx_002druntime_002dhack" accesskey="6"><code>--enable-cxx-runtime-hack</code></a></td><td> </td><td align="left" valign="top"> -</td></tr> -<tr><td align="left" valign="top">• <a href="#g_t_002d_002denable_002dmaintainer_002dmode" accesskey="7"><code>--enable-maintainer-mode</code></a></td><td> </td><td align="left" valign="top"> -</td></tr> -<tr><td align="left" valign="top">• <a href="#g_t_002d_002denable_002dmultiplatform" accesskey="8"><code>--enable-multiplatform</code></a></td><td> </td><td align="left" valign="top"> -</td></tr> -<tr><td align="left" valign="top">• <a href="#g_t_002d_002denable_002dshared" accesskey="9"><code>--enable-shared</code></a></td><td> </td><td align="left" valign="top"> -</td></tr> -<tr><td align="left" valign="top">• <a href="#g_t_002d_002denable_002dsilent_002drules"><code>--enable-silent-rules</code></a></td><td> </td><td align="left" valign="top"> -</td></tr> -<tr><td align="left" valign="top">• <a href="#g_t_002d_002dwithout_002dln_002ds"><code>--without-ln-s</code></a></td><td> </td><td align="left" valign="top"> -</td></tr> -<tr><td align="left" valign="top">• <a href="#g_t_002d_002dwithout_002dx"><code>--without-x</code></a></td><td> </td><td align="left" valign="top"> -</td></tr> -</table> - +<ul class="section-toc"> +<li><a href="#g_t_002d_002ddisable_002dnative_002dtexlive_002dbuild" accesskey="1"><code>--disable-native-texlive-build</code></a></li> +<li><a href="#g_t_002d_002dprefix-_002d_002dbindir-_2026" accesskey="2"><code>--prefix</code>, <code>--bindir</code>, …</a></li> +<li><a href="#g_t_002d_002ddisable_002dlargefile" accesskey="3"><code>--disable-largefile</code></a></li> +<li><a href="#g_t_002d_002ddisable_002dmissing" accesskey="4"><code>--disable-missing</code></a></li> +<li><a href="#g_t_002d_002denable_002dcompiler_002dwarnings_003dlevel" accesskey="5"><code>--enable-compiler-warnings=</code><var>level</var></a></li> +<li><a href="#g_t_002d_002denable_002dcxx_002druntime_002dhack" accesskey="6"><code>--enable-cxx-runtime-hack</code></a></li> +<li><a href="#g_t_002d_002denable_002dmaintainer_002dmode" accesskey="7"><code>--enable-maintainer-mode</code></a></li> +<li><a href="#g_t_002d_002denable_002dmultiplatform" accesskey="8"><code>--enable-multiplatform</code></a></li> +<li><a href="#g_t_002d_002denable_002dshared" accesskey="9"><code>--enable-shared</code></a></li> +<li><a href="#g_t_002d_002denable_002dsilent_002drules"><code>--enable-silent-rules</code></a></li> +<li><a href="#g_t_002d_002dwithout_002dln_002ds"><code>--without-ln-s</code></a></li> +<li><a href="#g_t_002d_002dwithout_002dx"><code>--without-x</code></a></li> +</ul> <hr> -<span id="g_t_002d_002ddisable_002dnative_002dtexlive_002dbuild"></span><div class="header"> +<div class="subsection" id="g_t_002d_002ddisable_002dnative_002dtexlive_002dbuild"> +<div class="header"> <p> -Next: <a href="#g_t_002d_002dprefix-_002d_002dbindir-_2026" accesskey="n" rel="next"><code>--prefix</code> <code>--bindir</code> …</a>, Up: <a href="#Global-configure-options" accesskey="u" rel="up">Global configure options</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_002d_002dprefix-_002d_002dbindir-_2026" accesskey="n" rel="next"><code>--prefix</code>, <code>--bindir</code>, …</a>, Up: <a href="#Global-configure-options" accesskey="u" rel="up">Global configure 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> <span id="g_t_002d_002ddisable_002dnative_002dtexlive_002dbuild-1"></span><h4 class="subsection">7.1.1 <code>--disable-native-texlive-build</code></h4> @@ -2383,9 +2442,10 @@ that can also be built independently from the TL tree (such as use this option to enable TL-specific adaptations, such as installation paths. </p> - <hr> -<span id="g_t_002d_002dprefix-_002d_002dbindir-_2026"></span><div class="header"> +</div> +<div class="subsection" id="g_t_002d_002dprefix-_002d_002dbindir-_2026"> +<div class="header"> <p> Next: <a href="#g_t_002d_002ddisable_002dlargefile" accesskey="n" rel="next"><code>--disable-largefile</code></a>, Previous: <a href="#g_t_002d_002ddisable_002dnative_002dtexlive_002dbuild" accesskey="p" rel="prev"><code>--disable-native-texlive-build</code></a>, Up: <a href="#Global-configure-options" accesskey="u" rel="up">Global configure 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> @@ -2398,13 +2458,14 @@ directories as usual. For the complete list, see <a href="#Installation-directo </p> <span id="index-DESTDIR"></span> <p>Also as usual, all values are prefixed by the value of <code>DESTDIR</code>, -if set, on the <code>make</code> command line (see <a href="https://www.gnu.org/software/automake/manual/automake.html#Staged-Installs">Installation in a temporary location</a> in <cite>GNU Automake</cite>). +if set, on the <code>make</code> command line (see <a data-manual="automake" href="https://www.gnu.org/software/automake/manual/automake.html#Staged-Installs">Installation in a temporary location</a> in <cite>GNU Automake</cite>). </p> - <hr> -<span id="g_t_002d_002ddisable_002dlargefile"></span><div class="header"> +</div> +<div class="subsection" id="g_t_002d_002ddisable_002dlargefile"> +<div class="header"> <p> -Next: <a href="#g_t_002d_002ddisable_002dmissing" accesskey="n" rel="next"><code>--disable-missing</code></a>, Previous: <a href="#g_t_002d_002dprefix-_002d_002dbindir-_2026" accesskey="p" rel="prev"><code>--prefix</code> <code>--bindir</code> …</a>, Up: <a href="#Global-configure-options" accesskey="u" rel="up">Global configure options</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_002d_002ddisable_002dmissing" accesskey="n" rel="next"><code>--disable-missing</code></a>, Previous: <a href="#g_t_002d_002dprefix-_002d_002dbindir-_2026" accesskey="p" rel="prev"><code>--prefix</code>, <code>--bindir</code>, …</a>, Up: <a href="#Global-configure-options" accesskey="u" rel="up">Global configure 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> <span id="g_t_002d_002ddisable_002dlargefile-1"></span><h4 class="subsection">7.1.3 <code>--disable-largefile</code></h4> @@ -2413,7 +2474,7 @@ Next: <a href="#g_t_002d_002ddisable_002dmissing" accesskey="n" rel="next"><code <span id="index-LFS-_0028large-file-support_0029"></span> <p>Omit large file support (LFS), which is needed on most 32-bit Unix systems for files with 2GB or more. Regardless of this option, the -size of <code>DVI</code> and <code>GF</code> files must always be <em><2</em>GB, due +size of <code>DVI</code> and <code>GF</code> files must always be <em class='math'><2</em>GB, due to the file format specifications. </p> <span id="index-size-of-PDF-and-PS-files"></span> @@ -2422,9 +2483,10 @@ to the file format specifications. <p>With LFS, there is no fixed limit on the size of PDF files created by <samp>pdftex</samp> or PostScript files created by <samp>dvips</samp>. </p> - <hr> -<span id="g_t_002d_002ddisable_002dmissing"></span><div class="header"> +</div> +<div class="subsection" id="g_t_002d_002ddisable_002dmissing"> +<div class="header"> <p> Next: <a href="#g_t_002d_002denable_002dcompiler_002dwarnings_003dlevel" accesskey="n" rel="next"><code>--enable-compiler-warnings=</code><var>level</var></a>, Previous: <a href="#g_t_002d_002ddisable_002dlargefile" accesskey="p" rel="prev"><code>--disable-largefile</code></a>, Up: <a href="#Global-configure-options" accesskey="u" rel="up">Global configure 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> @@ -2435,9 +2497,10 @@ Next: <a href="#g_t_002d_002denable_002dcompiler_002dwarnings_003dlevel" accessk must be disabled, e.g., due to missing libraries. This can help when figuring out a specific (sub)set of modules to enable. </p> - <hr> -<span id="g_t_002d_002denable_002dcompiler_002dwarnings_003dlevel"></span><div class="header"> +</div> +<div class="subsection" id="g_t_002d_002denable_002dcompiler_002dwarnings_003dlevel"> +<div class="header"> <p> Next: <a href="#g_t_002d_002denable_002dcxx_002druntime_002dhack" accesskey="n" rel="next"><code>--enable-cxx-runtime-hack</code></a>, Previous: <a href="#g_t_002d_002ddisable_002dmissing" accesskey="p" rel="prev"><code>--disable-missing</code></a>, Up: <a href="#Global-configure-options" accesskey="u" rel="up">Global configure 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> @@ -2452,9 +2515,10 @@ variables <code>WARNING_[OBJ]C[XX]FLAGS</code>, but these variables are not consistently used in all library and program modules. At present, these warning flags assume options from the GNU compilers. </p> - <hr> -<span id="g_t_002d_002denable_002dcxx_002druntime_002dhack"></span><div class="header"> +</div> +<div class="subsection" id="g_t_002d_002denable_002dcxx_002druntime_002dhack"> +<div class="header"> <p> Next: <a href="#g_t_002d_002denable_002dmaintainer_002dmode" accesskey="n" rel="next"><code>--enable-maintainer-mode</code></a>, Previous: <a href="#g_t_002d_002denable_002dcompiler_002dwarnings_003dlevel" accesskey="p" rel="prev"><code>--enable-compiler-warnings=</code><var>level</var></a>, Up: <a href="#Global-configure-options" accesskey="u" rel="up">Global configure 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> @@ -2464,9 +2528,10 @@ Next: <a href="#g_t_002d_002denable_002dmaintainer_002dmode" accesskey="n" rel=" try to statically link with <code>libstdc++</code>, thus improving portability of the resulting binary. See <a href="#Macros-for-compilers">Macros for compilers</a>. </p> - <hr> -<span id="g_t_002d_002denable_002dmaintainer_002dmode"></span><div class="header"> +</div> +<div class="subsection" id="g_t_002d_002denable_002dmaintainer_002dmode"> +<div class="header"> <p> Next: <a href="#g_t_002d_002denable_002dmultiplatform" accesskey="n" rel="next"><code>--enable-multiplatform</code></a>, Previous: <a href="#g_t_002d_002denable_002dcxx_002druntime_002dhack" accesskey="p" rel="prev"><code>--enable-cxx-runtime-hack</code></a>, Up: <a href="#Global-configure-options" accesskey="u" rel="up">Global configure 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> @@ -2476,11 +2541,12 @@ Next: <a href="#g_t_002d_002denable_002dmultiplatform" accesskey="n" rel="next"> <p>Enable <samp>make</samp> rules and dependencies not useful (and sometimes confusing) to the casual user. This requires current versions of the GNU build tools (see <a href="#Build-system-tools">Build system tools</a>), as it automatically -rebuilds infrastructure files as needed. See <a href="https://www.gnu.org/software/automake/manual/automake.html#maintainer_002dmode"><code>missing</code> and <code>AM_MAINTAINER_MODE</code></a> in <cite>GNU Automake</cite>. +rebuilds infrastructure files as needed. See <a data-manual="automake" href="https://www.gnu.org/software/automake/manual/automake.html#maintainer_002dmode"><code>missing</code> and <code>AM_MAINTAINER_MODE</code></a> in <cite>GNU Automake</cite>. </p> - <hr> -<span id="g_t_002d_002denable_002dmultiplatform"></span><div class="header"> +</div> +<div class="subsection" id="g_t_002d_002denable_002dmultiplatform"> +<div class="header"> <p> Next: <a href="#g_t_002d_002denable_002dshared" accesskey="n" rel="next"><code>--enable-shared</code></a>, Previous: <a href="#g_t_002d_002denable_002dmaintainer_002dmode" accesskey="p" rel="prev"><code>--enable-maintainer-mode</code></a>, Up: <a href="#Global-configure-options" accesskey="u" rel="up">Global configure 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> @@ -2499,9 +2565,10 @@ implied for <code>exec_prefix</code>. In any case, the values for <code>bindir</code> and <code>libdir</code> are automatically propagated to all subdirectories. </p> - <hr> -<span id="g_t_002d_002denable_002dshared"></span><div class="header"> +</div> +<div class="subsection" id="g_t_002d_002denable_002dshared"> +<div class="header"> <p> Next: <a href="#g_t_002d_002denable_002dsilent_002drules" accesskey="n" rel="next"><code>--enable-silent-rules</code></a>, Previous: <a href="#g_t_002d_002denable_002dmultiplatform" accesskey="p" rel="prev"><code>--enable-multiplatform</code></a>, Up: <a href="#Global-configure-options" accesskey="u" rel="up">Global configure 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> @@ -2512,9 +2579,10 @@ Next: <a href="#g_t_002d_002denable_002dsilent_002drules" accesskey="n" rel="nex <samp>libkpathsea</samp>. This is not allowed for a native TL build (i.e., <code>--disable-native-texlive-build</code> must also be specified). </p> - <hr> -<span id="g_t_002d_002denable_002dsilent_002drules"></span><div class="header"> +</div> +<div class="subsection" id="g_t_002d_002denable_002dsilent_002drules"> +<div class="header"> <p> Next: <a href="#g_t_002d_002dwithout_002dln_002ds" accesskey="n" rel="next"><code>--without-ln-s</code></a>, Previous: <a href="#g_t_002d_002denable_002dshared" accesskey="p" rel="prev"><code>--enable-shared</code></a>, Up: <a href="#Global-configure-options" accesskey="u" rel="up">Global configure 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> @@ -2528,9 +2596,10 @@ variable expansions), you can specify <code>V=1</code> on the <code>make</code> command line to get more verbosity, or <code>V=0</code> to get less, regardless of this option. </p> - <hr> -<span id="g_t_002d_002dwithout_002dln_002ds"></span><div class="header"> +</div> +<div class="subsection" id="g_t_002d_002dwithout_002dln_002ds"> +<div class="header"> <p> Next: <a href="#g_t_002d_002dwithout_002dx" accesskey="n" rel="next"><code>--without-x</code></a>, Previous: <a href="#g_t_002d_002denable_002dsilent_002drules" accesskey="p" rel="prev"><code>--enable-silent-rules</code></a>, Up: <a href="#Global-configure-options" accesskey="u" rel="up">Global configure 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> @@ -2541,9 +2610,10 @@ Next: <a href="#g_t_002d_002dwithout_002dx" accesskey="n" rel="next"><code>--wit binaries for a Unix-like system. However, <code>make install</code> will not create anything useful, and might fail. </p> - <hr> -<span id="g_t_002d_002dwithout_002dx"></span><div class="header"> +</div> +<div class="subsection" id="g_t_002d_002dwithout_002dx"> +<div class="header"> <p> Previous: <a href="#g_t_002d_002dwithout_002dln_002ds" accesskey="p" rel="prev"><code>--without-ln-s</code></a>, Up: <a href="#Global-configure-options" accesskey="u" rel="up">Global configure 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> @@ -2552,9 +2622,11 @@ Previous: <a href="#g_t_002d_002dwithout_002dln_002ds" accesskey="p" rel="prev"> <span id="index-_002d_002dwithout_002dx"></span> <p>Disable all programs using the X Window System. </p> - <hr> -<span id="Program_002dspecific-configure-options"></span><div class="header"> +</div> +</div> +<div class="section" id="Program_002dspecific-configure-options"> +<div class="header"> <p> Next: <a href="#Library_002dspecific-configure-options" accesskey="n" rel="next">Library-specific configure options</a>, Previous: <a href="#Global-configure-options" accesskey="p" rel="prev">Global configure options</a>, Up: <a href="#Configure-options" accesskey="u" rel="up">Configure 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> @@ -2564,30 +2636,21 @@ Next: <a href="#Library_002dspecific-configure-options" accesskey="n" rel="next" <span id="index-configure-options_002c-program_002dspecific"></span> <p>Here are (some of) the program-specific <code>configure</code> options. </p> -<table class="menu" border="0" cellspacing="0"> -<tr><td align="left" valign="top">• <a href="#g_t_002d_002denable_002dprog-_002d_002ddisable_002dprog" accesskey="1"><code>--enable-<var>prog</var></code> <code>--disable-<var>prog</var></code></a></td><td> </td><td align="left" valign="top"> -</td></tr> -<tr><td align="left" valign="top">• <a href="#g_t_002d_002ddisable_002dall_002dpkgs" accesskey="2"><code>--disable-all-pkgs</code></a></td><td> </td><td align="left" valign="top"> -</td></tr> -<tr><td align="left" valign="top">• <a href="#Configure-options-for-texk_002fweb2c" accesskey="3">Configure options for <samp>texk/web2c</samp></a></td><td> </td><td align="left" valign="top"> -</td></tr> -<tr><td align="left" valign="top">• <a href="#Configure-options-for-texk_002fbibtex_002dx" accesskey="4">Configure options for <samp>texk/bibtex-x</samp></a></td><td> </td><td align="left" valign="top"> -</td></tr> -<tr><td align="left" valign="top">• <a href="#Configure-options-for-texk_002fdvipdfm_002dx" accesskey="5">Configure options for <samp>texk/dvipdfm-x</samp></a></td><td> </td><td align="left" valign="top"> -</td></tr> -<tr><td align="left" valign="top">• <a href="#Configure-options-for-texk_002fdvisvgm" accesskey="6">Configure options for <samp>texk/dvisvgm</samp></a></td><td> </td><td align="left" valign="top"> -</td></tr> -<tr><td align="left" valign="top">• <a href="#Configure-options-for-texk_002ftexlive" accesskey="7">Configure options for <samp>texk/texlive</samp></a></td><td> </td><td align="left" valign="top"> -</td></tr> -<tr><td align="left" valign="top">• <a href="#Configure-options-for-texk_002fxdvik" accesskey="8">Configure options for <samp>texk/xdvik</samp></a></td><td> </td><td align="left" valign="top"> -</td></tr> -<tr><td align="left" valign="top">• <a href="#Configure-options-for-utils_002fxindy" accesskey="9">Configure options for <samp>utils/xindy</samp></a></td><td> </td><td align="left" valign="top"> -</td></tr> -</table> - +<ul class="section-toc"> +<li><a href="#g_t_002d_002denable_002dprog-_002d_002ddisable_002dprog" accesskey="1"><code>--enable-<var>prog</var></code>, <code>--disable-<var>prog</var></code></a></li> +<li><a href="#g_t_002d_002ddisable_002dall_002dpkgs" accesskey="2"><code>--disable-all-pkgs</code></a></li> +<li><a href="#Configure-options-for-texk_002fweb2c" accesskey="3">Configure options for <samp>texk/web2c</samp></a></li> +<li><a href="#Configure-options-for-texk_002fbibtex_002dx" accesskey="4">Configure options for <samp>texk/bibtex-x</samp></a></li> +<li><a href="#Configure-options-for-texk_002fdvipdfm_002dx" accesskey="5">Configure options for <samp>texk/dvipdfm-x</samp></a></li> +<li><a href="#Configure-options-for-texk_002fdvisvgm" accesskey="6">Configure options for <samp>texk/dvisvgm</samp></a></li> +<li><a href="#Configure-options-for-texk_002ftexlive" accesskey="7">Configure options for <samp>texk/texlive</samp></a></li> +<li><a href="#Configure-options-for-texk_002fxdvik" accesskey="8">Configure options for <samp>texk/xdvik</samp></a></li> +<li><a href="#Configure-options-for-utils_002fxindy" accesskey="9">Configure options for <samp>utils/xindy</samp></a></li> +</ul> <hr> -<span id="g_t_002d_002denable_002dprog-_002d_002ddisable_002dprog"></span><div class="header"> +<div class="subsection" id="g_t_002d_002denable_002dprog-_002d_002ddisable_002dprog"> +<div class="header"> <p> Next: <a href="#g_t_002d_002ddisable_002dall_002dpkgs" accesskey="n" rel="next"><code>--disable-all-pkgs</code></a>, Up: <a href="#Program_002dspecific-configure-options" accesskey="u" rel="up">Program-specific configure 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> @@ -2597,11 +2660,12 @@ Next: <a href="#g_t_002d_002ddisable_002dall_002dpkgs" accesskey="n" rel="next"> <span id="index-_002d_002ddisable_002dprog"></span> <p>Do or do not build and install the program(s) of module <code><var>prog</var></code>. </p> - <hr> -<span id="g_t_002d_002ddisable_002dall_002dpkgs"></span><div class="header"> +</div> +<div class="subsection" id="g_t_002d_002ddisable_002dall_002dpkgs"> +<div class="header"> <p> -Next: <a href="#Configure-options-for-texk_002fweb2c" accesskey="n" rel="next">Configure options for <samp>texk/web2c</samp></a>, Previous: <a href="#g_t_002d_002denable_002dprog-_002d_002ddisable_002dprog" accesskey="p" rel="prev"><code>--enable-<var>prog</var></code> <code>--disable-<var>prog</var></code></a>, Up: <a href="#Program_002dspecific-configure-options" accesskey="u" rel="up">Program-specific configure options</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="#Configure-options-for-texk_002fweb2c" accesskey="n" rel="next">Configure options for <samp>texk/web2c</samp></a>, Previous: <a href="#g_t_002d_002denable_002dprog-_002d_002ddisable_002dprog" accesskey="p" rel="prev"><code>--enable-<var>prog</var></code>, <code>--disable-<var>prog</var></code></a>, Up: <a href="#Program_002dspecific-configure-options" accesskey="u" rel="up">Program-specific configure 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> <span id="g_t_002d_002ddisable_002dall_002dpkgs-1"></span><h4 class="subsection">7.2.2 <code>--disable-all-pkgs</code></h4> @@ -2617,9 +2681,10 @@ interested in, and its dependencies, are built. See <a href="#Build-one-package explicitly disabled or specify <code>disable</code> in their <samp>ac/withenable.ac</samp> fragment. </p> - <hr> -<span id="Configure-options-for-texk_002fweb2c"></span><div class="header"> +</div> +<div class="subsection" id="Configure-options-for-texk_002fweb2c"> +<div class="header"> <p> Next: <a href="#Configure-options-for-texk_002fbibtex_002dx" accesskey="n" rel="next">Configure options for <samp>texk/bibtex-x</samp></a>, Previous: <a href="#g_t_002d_002ddisable_002dall_002dpkgs" accesskey="p" rel="prev"><code>--disable-all-pkgs</code></a>, Up: <a href="#Program_002dspecific-configure-options" accesskey="u" rel="up">Program-specific configure 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> @@ -2718,9 +2783,10 @@ support; ignored for a native TeX Live build. Defaults are defined in <p><code>--disable-synctex</code> <br>Do not build the <code>SyncTeX</code> library and tool. </p> - <hr> -<span id="Configure-options-for-texk_002fbibtex_002dx"></span><div class="header"> +</div> +<div class="subsection" id="Configure-options-for-texk_002fbibtex_002dx"> +<div class="header"> <p> Next: <a href="#Configure-options-for-texk_002fdvipdfm_002dx" accesskey="n" rel="next">Configure options for <samp>texk/dvipdfm-x</samp></a>, Previous: <a href="#Configure-options-for-texk_002fweb2c" accesskey="p" rel="prev">Configure options for <samp>texk/web2c</samp></a>, Up: <a href="#Program_002dspecific-configure-options" accesskey="u" rel="up">Program-specific configure 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> @@ -2740,9 +2806,10 @@ module <code>bibtex-x</code> (extended BibTeX). <p><code>--disable-bibtexu</code><br>Do not build the <samp>bibtexu</samp> program (building <samp>bibtexu</samp> requires <code>ICU</code> libraries). </p> - <hr> -<span id="Configure-options-for-texk_002fdvipdfm_002dx"></span><div class="header"> +</div> +<div class="subsection" id="Configure-options-for-texk_002fdvipdfm_002dx"> +<div class="header"> <p> Next: <a href="#Configure-options-for-texk_002fdvisvgm" accesskey="n" rel="next">Configure options for <samp>texk/dvisvgm</samp></a>, Previous: <a href="#Configure-options-for-texk_002fbibtex_002dx" accesskey="p" rel="prev">Configure options for <samp>texk/bibtex-x</samp></a>, Up: <a href="#Program_002dspecific-configure-options" accesskey="u" rel="up">Program-specific configure 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> @@ -2768,9 +2835,10 @@ program or make the <samp>dvipdfm</samp> symlink. <p><code>--disable-xdvipdfmx</code><br>Do not build the <samp>xdvipdfmx</samp> program. </p> - <hr> -<span id="Configure-options-for-texk_002fdvisvgm"></span><div class="header"> +</div> +<div class="subsection" id="Configure-options-for-texk_002fdvisvgm"> +<div class="header"> <p> Next: <a href="#Configure-options-for-texk_002ftexlive" accesskey="n" rel="next">Configure options for <samp>texk/texlive</samp></a>, Previous: <a href="#Configure-options-for-texk_002fdvipdfm_002dx" accesskey="p" rel="prev">Configure options for <samp>texk/dvipdfm-x</samp></a>, Up: <a href="#Program_002dspecific-configure-options" accesskey="u" rel="up">Program-specific configure 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> @@ -2796,9 +2864,10 @@ incompatibilities, e.g., on CentOS 5. <code>--with-libgs-libdir=<var>dir</var></code><br>Specify non-standard locations of the Ghostscript headers and library. </p> - <hr> -<span id="Configure-options-for-texk_002ftexlive"></span><div class="header"> +</div> +<div class="subsection" id="Configure-options-for-texk_002ftexlive"> +<div class="header"> <p> Next: <a href="#Configure-options-for-texk_002fxdvik" accesskey="n" rel="next">Configure options for <samp>texk/xdvik</samp></a>, Previous: <a href="#Configure-options-for-texk_002fdvisvgm" accesskey="p" rel="prev">Configure options for <samp>texk/dvisvgm</samp></a>, Up: <a href="#Program_002dspecific-configure-options" accesskey="u" rel="up">Program-specific configure 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> @@ -2810,9 +2879,10 @@ Next: <a href="#Configure-options-for-texk_002fxdvik" accesskey="n" rel="next">C scripts” (see <a href="#Linked-scripts">Linked scripts</a>), except for the TL scripts required to run <code>texlinks</code>. </p> - <hr> -<span id="Configure-options-for-texk_002fxdvik"></span><div class="header"> +</div> +<div class="subsection" id="Configure-options-for-texk_002fxdvik"> +<div class="header"> <p> Next: <a href="#Configure-options-for-utils_002fxindy" accesskey="n" rel="next">Configure options for <samp>utils/xindy</samp></a>, Previous: <a href="#Configure-options-for-texk_002ftexlive" accesskey="p" rel="prev">Configure options for <samp>texk/texlive</samp></a>, Up: <a href="#Program_002dspecific-configure-options" accesskey="u" rel="up">Program-specific configure 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> @@ -2839,9 +2909,10 @@ neXtaw</code>. The default is <code>motif</code> if available, else <code>xaw</ <p><code>--enable-xi2-scrolling</code><br>Use XInput 2.1 “smooth scrolling” if available (default: yes, except for a native TL build). </p> - <hr> -<span id="Configure-options-for-utils_002fxindy"></span><div class="header"> +</div> +<div class="subsection" id="Configure-options-for-utils_002fxindy"> +<div class="header"> <p> Previous: <a href="#Configure-options-for-texk_002fxdvik" accesskey="p" rel="prev">Configure options for <samp>texk/xdvik</samp></a>, Up: <a href="#Program_002dspecific-configure-options" accesskey="u" rel="up">Program-specific configure 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> @@ -2870,9 +2941,11 @@ build, but the default otherwise) indicates that <samp>xindy</samp> will use the installed version of <samp>clisp</samp> (which must be identical to the one used to build <samp>xindy</samp>). </p> - <hr> -<span id="Library_002dspecific-configure-options"></span><div class="header"> +</div> +</div> +<div class="section" id="Library_002dspecific-configure-options"> +<div class="header"> <p> Next: <a href="#Variables-for-configure" accesskey="n" rel="next">Variables for configure</a>, Previous: <a href="#Program_002dspecific-configure-options" accesskey="p" rel="prev">Program-specific configure options</a>, Up: <a href="#Configure-options" accesskey="u" rel="up">Configure 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> @@ -2900,13 +2973,13 @@ the required flags. <p>The top-level <samp>configure</samp> script performs a consistency check for all required system libraries and bails out if tests fail. </p> -<table class="menu" border="0" cellspacing="0"> -<tr><td align="left" valign="top">• <a href="#Configure-options-for-kpathsea" accesskey="1">Configure options for <code>kpathsea</code></a></td><td> </td><td align="left" valign="top"> -</td></tr> -</table> +<ul class="section-toc"> +<li><a href="#Configure-options-for-kpathsea" accesskey="1">Configure options for <code>kpathsea</code></a></li> +</ul> <hr> -<span id="Configure-options-for-kpathsea"></span><div class="header"> +<div class="subsection" id="Configure-options-for-kpathsea"> +<div class="header"> <p> Up: <a href="#Library_002dspecific-configure-options" accesskey="u" rel="up">Library-specific configure 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> @@ -2918,35 +2991,38 @@ Up: <a href="#Library_002dspecific-configure-options" accesskey="u" rel="up">Lib <code>--disable-<var>cmd</var>-default</code><br>Determine the compile time default for whether or not to run <var>cmd</var>, which is one of: </p><dl compact="compact"> -<dt><code>mkocp</code></dt> +<dt><span><code>mkocp</code></span></dt> <dd><p>(Omega compiled translation process file) </p></dd> -<dt><code>mkofm</code></dt> +<dt><span><code>mkofm</code></span></dt> <dd><p>(Omega font metrics file) </p></dd> -<dt><code>mktexfmt</code></dt> +<dt><span><code>mktexfmt</code></span></dt> <dd><p>(format/base dump file) </p></dd> -<dt><code>mktexmf</code></dt> +<dt><span><code>mktexmf</code></span></dt> <dd><p>(Metafont source) </p></dd> -<dt><code>mktexpk</code></dt> +<dt><span><code>mktexpk</code></span></dt> <dd><p>(PK bitmap font) </p></dd> -<dt><code>mktextex</code></dt> +<dt><span><code>mktextex</code></span></dt> <dd><p>(TeX source) </p></dd> -<dt><code>mktextfm</code></dt> +<dt><span><code>mktextfm</code></span></dt> <dd><p>(TFM file) </p></dd> </dl> <p>to generate the specified type of file dynamically. The default can be overridden by the user in any case -(see <a href="#kpathsea-library"><code>kpathsea</code> library</a>). +(see <a href="#kpathsea-library">The <code>kpathsea</code> library in <samp>texk/kpathsea</samp></a>). </p> <hr> -<span id="Variables-for-configure"></span><div class="header"> +</div> +</div> +<div class="section" id="Variables-for-configure"> +<div class="header"> <p> Previous: <a href="#Library_002dspecific-configure-options" accesskey="p" rel="prev">Library-specific configure options</a>, Up: <a href="#Configure-options" accesskey="u" rel="up">Configure 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> @@ -2961,37 +3037,23 @@ defined in the environment, but that might not work for cross compilations. </p> <dl compact="compact"> -<dt><code>CC</code> -<span id="index-CC"></span> -</dt> -<dt><code>CXX</code> -<span id="index-CXX"></span> -</dt> -<dt><code>CPPFLAGS</code> -<span id="index-CPPFLAGS"></span> -</dt> +<dt id='index-CC'><span><code>CC</code><a href='#index-CC' class='copiable-anchor'> ¶</a></span></dt> +<dt id='index-CXX'><span><code>CXX</code><a href='#index-CXX' class='copiable-anchor'> ¶</a></span></dt> +<dt id='index-CPPFLAGS'><span><code>CPPFLAGS</code><a href='#index-CPPFLAGS' class='copiable-anchor'> ¶</a></span></dt> <dd><p>And plenty more. As usual with Autoconf, these variables specify the name (or full path) of compilers, preprocessor flags, and similar. -See <a href="https://www.gnu.org/software/autoconf/manual/autoconf.html#Preset-Output-Variables">Preset Output Variables</a> in <cite>GNU Autoconf</cite>. +See <a data-manual="autoconf" href="https://www.gnu.org/software/autoconf/manual/autoconf.html#Preset-Output-Variables">Preset Output Variables</a> in <cite>GNU Autoconf</cite>. </p> </dd> -<dt><code>CLISP</code> -<span id="index-CLISP-1"></span> -</dt> +<dt id='index-CLISP-1'><span><code>CLISP</code><a href='#index-CLISP-1' class='copiable-anchor'> ¶</a></span></dt> <dd><span id="index-clisp"></span> <p>Name (or full path) of the <samp>clisp</samp> executable, used to build <code>xindy</code>. </p> </dd> -<dt><code>FT2_CONFIG</code> -<span id="index-FT2_005fCONFIG"></span> -</dt> -<dt><code>ICU_CONFIG</code> -<span id="index-ICU_005fCONFIG"></span> -</dt> -<dt><code>PKG_CONFIG</code> -<span id="index-PKG_005fCONFIG"></span> -</dt> +<dt id='index-FT2_005fCONFIG'><span><code>FT2_CONFIG</code><a href='#index-FT2_005fCONFIG' class='copiable-anchor'> ¶</a></span></dt> +<dt id='index-ICU_005fCONFIG'><span><code>ICU_CONFIG</code><a href='#index-ICU_005fCONFIG' class='copiable-anchor'> ¶</a></span></dt> +<dt id='index-PKG_005fCONFIG'><span><code>PKG_CONFIG</code><a href='#index-PKG_005fCONFIG' class='copiable-anchor'> ¶</a></span></dt> <dd><span id="index-freetype_002dconfig-1"></span> <span id="index-icu_002dconfig"></span> <span id="index-libfreetype"></span> @@ -3002,45 +3064,35 @@ flags required for system versions of <samp>libfreetype</samp>, the ICU libraries, and other libraries, respectively. </p> </dd> -<dt><code>KPSEWHICH</code> -<span id="index-KPSEWHICH"></span> -</dt> +<dt id='index-KPSEWHICH'><span><code>KPSEWHICH</code><a href='#index-KPSEWHICH' class='copiable-anchor'> ¶</a></span></dt> <dd><span id="index-kpsewhich"></span> <p>Name (or path) of an installed <samp>kpsewhich</samp> binary, used by <code>make check</code> to determine the location of, e.g., <samp>cmbx10.tfm</samp>. </p> </dd> -<dt><code>MAKE</code> -<span id="index-MAKE"></span> -</dt> -<dt><code>SED</code> -<span id="index-SED"></span> -</dt> +<dt id='index-MAKE'><span><code>MAKE</code><a href='#index-MAKE' class='copiable-anchor'> ¶</a></span></dt> +<dt id='index-SED'><span><code>SED</code><a href='#index-SED' class='copiable-anchor'> ¶</a></span></dt> <dd><p>And more. Name (or path) of the <code>make</code>, <code>sed</code>, and similar programs; used at the top level and propagated to all subdirectories. </p> </dd> -<dt><code>PERL</code> -<span id="index-PERL"></span> -</dt> -<dt><code>LATEX</code> -<span id="index-LATEX"></span> -</dt> -<dt><code>PDFLATEX</code> -<span id="index-PDFLATEX"></span> -</dt> +<dt id='index-PERL'><span><code>PERL</code><a href='#index-PERL' class='copiable-anchor'> ¶</a></span></dt> +<dt id='index-LATEX'><span><code>LATEX</code><a href='#index-LATEX' class='copiable-anchor'> ¶</a></span></dt> +<dt id='index-PDFLATEX'><span><code>PDFLATEX</code><a href='#index-PDFLATEX' class='copiable-anchor'> ¶</a></span></dt> <dd><p>Name (or full path) for the <samp>perl</samp>, <samp>latex</samp>, and <samp>pdflatex</samp> commands used, e.g., to build the <code>xindy</code> documentation. </p> </dd> </dl> - <hr> -<span id="Coding-conventions"></span><div class="header"> +</div> +</div> +<div class="chapter" id="Coding-conventions"> +<div class="header"> <p> -Next: <a href="#Continuous-integration" accesskey="n" rel="next">Continuous integration</a>, Previous: <a href="#Configure-options" accesskey="p" rel="prev">Configure 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="#Continuous-integration" accesskey="n" rel="next">Continuous integration</a>, Previous: <a href="#Configure-options" accesskey="p" rel="prev">Configure options</a>, Up: <a href="#Top" accesskey="u" rel="up">Building TeX Live (2022)</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="Coding-conventions-1"></span><h2 class="chapter">8 Coding conventions</h2> @@ -3056,16 +3108,14 @@ functions or variables and the use of <code>const</code>. These rules should be applied to the code maintained in the TeX Live tree and for other packages whose maintainers are willing to accept patches. </p> -<table class="menu" border="0" cellspacing="0"> -<tr><td align="left" valign="top">• <a href="#Declarations-and-definitions" accesskey="1">Declarations and definitions</a></td><td> </td><td align="left" valign="top"> -</td></tr> -<tr><td align="left" valign="top">• <a href="#Const" accesskey="2">Const</a></td><td> </td><td align="left" valign="top"> -</td></tr> -</table> - +<ul class="section-toc"> +<li><a href="#Declarations-and-definitions" accesskey="1">Declarations and definitions</a></li> +<li><a href="#Const" accesskey="2">Const</a></li> +</ul> <hr> -<span id="Declarations-and-definitions"></span><div class="header"> +<div class="section" id="Declarations-and-definitions"> +<div class="header"> <p> Next: <a href="#Const" accesskey="n" rel="next">Const</a>, Up: <a href="#Coding-conventions" accesskey="u" rel="up">Coding conventions</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> </div> @@ -3134,7 +3184,9 @@ either declared <code>static</code> if used in only one file or declared file. </p> <hr> -<span id="Const"></span><div class="header"> +</div> +<div class="section" id="Const"> +<div class="header"> <p> Previous: <a href="#Declarations-and-definitions" accesskey="p" rel="prev">Declarations and definitions</a>, Up: <a href="#Coding-conventions" accesskey="u" rel="up">Coding conventions</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> </div> @@ -3184,11 +3236,13 @@ them. Therefore such casts should be avoided whenever possible and otherwise must be carefully analyzed to make sure that they cannot cause the modification of quantities supposed to be constant. </p> - <hr> -<span id="Continuous-integration"></span><div class="header"> +</div> +</div> +<div class="chapter" id="Continuous-integration"> +<div class="header"> <p> -Next: <a href="#install_002dtl" accesskey="n" rel="next">install-tl</a>, Previous: <a href="#Coding-conventions" accesskey="p" rel="prev">Coding conventions</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="#install_002dtl" accesskey="n" rel="next">install-tl</a>, Previous: <a href="#Coding-conventions" accesskey="p" rel="prev">Coding conventions</a>, Up: <a href="#Top" accesskey="u" rel="up">Building TeX Live (2022)</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="Continuous-integration-1"></span><h2 class="chapter">9 Continuous integration</h2> @@ -3202,20 +3256,16 @@ git-svn mirror of the sources that is pushed to Github is updated (currently) at 30 minute intervals, and only the last commit pushed is tested on Travis-CI. </p> -<table class="menu" border="0" cellspacing="0"> -<tr><td align="left" valign="top">• <a href="#Transfer-from-Subversion-to-Github" accesskey="1">Transfer from Subversion to Github</a></td><td> </td><td align="left" valign="top"> -</td></tr> -<tr><td align="left" valign="top">• <a href="#Automatic-update-of-the-Git-mirror" accesskey="2">Automatic update of the Git mirror</a></td><td> </td><td align="left" valign="top"> -</td></tr> -<tr><td align="left" valign="top">• <a href="#CI-testing-on-Travis_002dCI" accesskey="3">CI testing on Travis-CI</a></td><td> </td><td align="left" valign="top"> -</td></tr> -<tr><td align="left" valign="top">• <a href="#Releases-on-Github" accesskey="4">Releases on Github</a></td><td> </td><td align="left" valign="top"> -</td></tr> -</table> - +<ul class="section-toc"> +<li><a href="#Transfer-from-Subversion-to-Github" accesskey="1">Transfer from Subversion to Github</a></li> +<li><a href="#Automatic-update-of-the-Git-mirror" accesskey="2">Automatic update of the Git mirror</a></li> +<li><a href="#CI-testing-on-Travis_002dCI" accesskey="3">CI testing on Travis-CI</a></li> +<li><a href="#Releases-on-Github" accesskey="4">Releases on Github</a></li> +</ul> <hr> -<span id="Transfer-from-Subversion-to-Github"></span><div class="header"> +<div class="section" id="Transfer-from-Subversion-to-Github"> +<div class="header"> <p> Next: <a href="#Automatic-update-of-the-Git-mirror" accesskey="n" rel="next">Automatic update of the Git mirror</a>, Up: <a href="#Continuous-integration" accesskey="u" rel="up">Continuous integration</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> </div> @@ -3271,7 +3321,9 @@ Subversion, back to <code>master</code> on <code>texlive.info</code>, and from there to Github. </p> <hr> -<span id="Automatic-update-of-the-Git-mirror"></span><div class="header"> +</div> +<div class="section" id="Automatic-update-of-the-Git-mirror"> +<div class="header"> <p> Next: <a href="#CI-testing-on-Travis_002dCI" accesskey="n" rel="next">CI testing on Travis-CI</a>, Previous: <a href="#Transfer-from-Subversion-to-Github" accesskey="p" rel="prev">Transfer from Subversion to Github</a>, Up: <a href="#Continuous-integration" accesskey="u" rel="up">Continuous integration</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> </div> @@ -3285,7 +3337,9 @@ the <code>master</code> branch with them, and the second pushes changes (if any) to Github. </p> <hr> -<span id="CI-testing-on-Travis_002dCI"></span><div class="header"> +</div> +<div class="section" id="CI-testing-on-Travis_002dCI"> +<div class="header"> <p> Next: <a href="#Releases-on-Github" accesskey="n" rel="next">Releases on Github</a>, Previous: <a href="#Automatic-update-of-the-Git-mirror" accesskey="p" rel="prev">Automatic update of the Git mirror</a>, Up: <a href="#Continuous-integration" accesskey="u" rel="up">Continuous integration</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> </div> @@ -3304,7 +3358,9 @@ Travis-CI. automatically checkout the last pushed commit and try building it. </p> <hr> -<span id="Releases-on-Github"></span><div class="header"> +</div> +<div class="section" id="Releases-on-Github"> +<div class="header"> <p> Previous: <a href="#CI-testing-on-Travis_002dCI" accesskey="p" rel="prev">CI testing on Travis-CI</a>, Up: <a href="#Continuous-integration" accesskey="u" rel="up">Continuous integration</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> </div> @@ -3324,44 +3380,42 @@ Releases can also be made manually from that web page (see <code>tl-update-bindir</code> for hints). </p> <hr> -<span id="install_002dtl"></span><div class="header"> +</div> +</div> +<div class="appendix" id="install_002dtl"> +<div class="header"> <p> -Next: <a href="#tlmgr" accesskey="n" rel="next">tlmgr</a>, Previous: <a href="#Continuous-integration" accesskey="p" rel="prev">Continuous integration</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="#tlmgr" accesskey="n" rel="next">tlmgr</a>, Previous: <a href="#Continuous-integration" accesskey="p" rel="prev">Continuous integration</a>, Up: <a href="#Top" accesskey="u" rel="up">Building TeX Live (2022)</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="install_002dtl-1"></span><h2 class="appendix">Appendix A install-tl</h2> -<table class="menu" border="0" cellspacing="0"> -<tr><td align="left" valign="top">• <a href="#install_002dtl-NAME" accesskey="1">install-tl NAME</a></td><td> </td><td align="left" valign="top"> -</td></tr> -<tr><td align="left" valign="top">• <a href="#install_002dtl-SYNOPSIS" accesskey="2">install-tl SYNOPSIS</a></td><td> </td><td align="left" valign="top"> -</td></tr> -<tr><td align="left" valign="top">• <a href="#install_002dtl-DESCRIPTION" accesskey="3">install-tl DESCRIPTION</a></td><td> </td><td align="left" valign="top"> -</td></tr> -<tr><td align="left" valign="top">• <a href="#install_002dtl-REFERENCES" accesskey="4">install-tl REFERENCES</a></td><td> </td><td align="left" valign="top"> -</td></tr> -<tr><td align="left" valign="top">• <a href="#install_002dtl-OPTIONS" accesskey="5">install-tl OPTIONS</a></td><td> </td><td align="left" valign="top"> -</td></tr> -<tr><td align="left" valign="top">• <a href="#install_002dtl-PROFILES" accesskey="6">install-tl PROFILES</a></td><td> </td><td align="left" valign="top"> -</td></tr> -<tr><td align="left" valign="top">• <a href="#install_002dtl-ENVIRONMENT-VARIABLES" accesskey="7">install-tl ENVIRONMENT VARIABLES</a></td><td> </td><td align="left" valign="top"> -</td></tr> -<tr><td align="left" valign="top">• <a href="#install_002dtl-AUTHORS-AND-COPYRIGHT" accesskey="8">install-tl AUTHORS AND COPYRIGHT</a></td><td> </td><td align="left" valign="top"> -</td></tr> -</table> +<ul class="section-toc"> +<li><a href="#install_002dtl-NAME" accesskey="1">NAME</a></li> +<li><a href="#install_002dtl-SYNOPSIS" accesskey="2">SYNOPSIS</a></li> +<li><a href="#install_002dtl-DESCRIPTION" accesskey="3">DESCRIPTION</a></li> +<li><a href="#install_002dtl-REFERENCES" accesskey="4">REFERENCES</a></li> +<li><a href="#install_002dtl-OPTIONS" accesskey="5">OPTIONS</a></li> +<li><a href="#install_002dtl-PROFILES" accesskey="6">PROFILES</a></li> +<li><a href="#install_002dtl-ENVIRONMENT-VARIABLES" accesskey="7">ENVIRONMENT VARIABLES</a></li> +<li><a href="#install_002dtl-AUTHORS-AND-COPYRIGHT" accesskey="8">AUTHORS AND COPYRIGHT</a></li> +</ul> <hr> -<span id="install_002dtl-NAME"></span><div class="header"> +<div class="appendixsec" id="install_002dtl-NAME"> +<div class="header"> <p> -Next: <a href="#install_002dtl-SYNOPSIS" accesskey="n" rel="next">install-tl SYNOPSIS</a>, Up: <a href="#install_002dtl" accesskey="u" rel="up">install-tl</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="#install_002dtl-SYNOPSIS" accesskey="n" rel="next">SYNOPSIS</a>, Up: <a href="#install_002dtl" accesskey="u" rel="up">install-tl</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="NAME"></span><h3 class="appendixsec">A.1 NAME</h3> <p>install-tl - TeX Live cross-platform installer </p> <hr> -<span id="install_002dtl-SYNOPSIS"></span><div class="header"> +</div> +<div class="appendixsec" id="install_002dtl-SYNOPSIS"> +<div class="header"> <p> -Next: <a href="#install_002dtl-DESCRIPTION" accesskey="n" rel="next">install-tl DESCRIPTION</a>, Previous: <a href="#install_002dtl-NAME" accesskey="p" rel="prev">install-tl NAME</a>, Up: <a href="#install_002dtl" accesskey="u" rel="up">install-tl</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="#install_002dtl-DESCRIPTION" accesskey="n" rel="next">DESCRIPTION</a>, Previous: <a href="#install_002dtl-NAME" accesskey="p" rel="prev">NAME</a>, Up: <a href="#install_002dtl" accesskey="u" rel="up">install-tl</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="SYNOPSIS"></span><h3 class="appendixsec">A.2 SYNOPSIS</h3> @@ -3369,12 +3423,12 @@ Next: <a href="#install_002dtl-DESCRIPTION" accesskey="n" rel="next">install-tl </p> <p>install-tl-windows.bat [<em>option</em>]... </p> -<p>install-tl-advanced.bat [<em>option</em>]... -</p> <hr> -<span id="install_002dtl-DESCRIPTION"></span><div class="header"> +</div> +<div class="appendixsec" id="install_002dtl-DESCRIPTION"> +<div class="header"> <p> -Next: <a href="#install_002dtl-REFERENCES" accesskey="n" rel="next">install-tl REFERENCES</a>, Previous: <a href="#install_002dtl-SYNOPSIS" accesskey="p" rel="prev">install-tl SYNOPSIS</a>, Up: <a href="#install_002dtl" accesskey="u" rel="up">install-tl</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="#install_002dtl-REFERENCES" accesskey="n" rel="next">REFERENCES</a>, Previous: <a href="#install_002dtl-SYNOPSIS" accesskey="p" rel="prev">SYNOPSIS</a>, Up: <a href="#install_002dtl" accesskey="u" rel="up">install-tl</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="DESCRIPTION"></span><h3 class="appendixsec">A.3 DESCRIPTION</h3> @@ -3398,9 +3452,11 @@ initial installation is complete. highly recommended. </p> <hr> -<span id="install_002dtl-REFERENCES"></span><div class="header"> +</div> +<div class="appendixsec" id="install_002dtl-REFERENCES"> +<div class="header"> <p> -Next: <a href="#install_002dtl-OPTIONS" accesskey="n" rel="next">install-tl OPTIONS</a>, Previous: <a href="#install_002dtl-DESCRIPTION" accesskey="p" rel="prev">install-tl DESCRIPTION</a>, Up: <a href="#install_002dtl" accesskey="u" rel="up">install-tl</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="#install_002dtl-OPTIONS" accesskey="n" rel="next">OPTIONS</a>, Previous: <a href="#install_002dtl-DESCRIPTION" accesskey="p" rel="prev">DESCRIPTION</a>, Up: <a href="#install_002dtl" accesskey="u" rel="up">install-tl</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="REFERENCES"></span><h3 class="appendixsec">A.4 REFERENCES</h3> @@ -3415,9 +3471,11 @@ Internet at <a href="https://tug.org/texlive/doc/install-tl.html">https://tug.or <a href="https://tug.org/texlive/doc">https://tug.org/texlive/doc</a>. </p> <hr> -<span id="install_002dtl-OPTIONS"></span><div class="header"> +</div> +<div class="appendixsec" id="install_002dtl-OPTIONS"> +<div class="header"> <p> -Next: <a href="#install_002dtl-PROFILES" accesskey="n" rel="next">install-tl PROFILES</a>, Previous: <a href="#install_002dtl-REFERENCES" accesskey="p" rel="prev">install-tl REFERENCES</a>, Up: <a href="#install_002dtl" accesskey="u" rel="up">install-tl</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="#install_002dtl-PROFILES" accesskey="n" rel="next">PROFILES</a>, Previous: <a href="#install_002dtl-REFERENCES" accesskey="p" rel="prev">REFERENCES</a>, Up: <a href="#install_002dtl" accesskey="u" rel="up">install-tl</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="OPTIONS"></span><h3 class="appendixsec">A.5 OPTIONS</h3> @@ -3426,7 +3484,7 @@ leading <code>-</code> or <code>--</code>. An argument value can be separated f option by either a space or <code>=</code>. </p> <dl compact="compact"> -<dt><strong>-gui</strong> [[=]<em>module</em>]</dt> +<dt><span><strong>-gui</strong> [[=]<em>module</em>]</span></dt> <dd><span id="install_002dtl-_002dgui-_005b_005b_003d_005dmodule_005d"></span> <p>If no <em>module</em> is given, starts the Tcl/Tk (see below) GUI installer. </p> @@ -3434,13 +3492,13 @@ option by either a space or <code>=</code>. following modules are supported: </p> <dl compact="compact"> -<dt><code>text</code></dt> +<dt><span><code>text</code></span></dt> <dd><span id="install_002dtl-text"></span> <p>The text mode user interface (default on Unix systems, including Macs). Same as the <code>-no-gui</code> option. </p> </dd> -<dt><code>tcl</code> (or "perltk" or "wizard" or "expert" or nothing)</dt> +<dt><span><code>tcl</code> (or "perltk" or "wizard" or "expert" or nothing)</span></dt> <dd><span id="install_002dtl-tcl-_0028or-_0022perltk_0022-or-_0022wizard_0022-or-_0022expert_0022-or-nothing_0029"></span> <p>The Tcl/Tk user interface (default on Windows). It starts with a small number of configuration options, roughly equivalent @@ -3457,12 +3515,12 @@ on GNU/Linux, or can be easily installed through a distro package manager. For Windows, TeX Live provides a Tcl/Tk runtime. </p> </dd> -<dt><strong>-no-gui</strong></dt> +<dt><span><strong>-no-gui</strong></span></dt> <dd><span id="install_002dtl-_002dno_002dgui"></span> <p>Use the text mode installer (default except on Windows and Macs). </p> </dd> -<dt><strong>-lang</strong> <em>llcode</em></dt> +<dt><span><strong>-lang</strong> <em>llcode</em></span></dt> <dd><span id="install_002dtl-_002dlang-llcode"></span> <p>By default, the Tcl GUI uses the language detection built into Tcl/Tk. If that fails you can select a different language by @@ -3475,7 +3533,7 @@ Ukrainian (uk), Vietnamese (vi), simplified Chinese (zh_CN), and traditional Chinese (zh_TW). </p> </dd> -<dt><strong>-repository</strong> <em>url|path</em></dt> +<dt><span><strong>-repository</strong> <em>url|path</em></span></dt> <dd><span id="install_002dtl-_002drepository-url_007cpath"></span> <p>Specify the package repository to be used as the source of the installation. In short, this can be a directory name or a url using @@ -3483,7 +3541,7 @@ http(s), ftp, or scp. The documentation for <code>tlmgr</code> has the details (<a href="https://tug.org/texlive/doc/tlmgr.html#OPTIONS">https://tug.org/texlive/doc/tlmgr.html#OPTIONS</a>). </p> <p>For installation, the default is to pick a mirror automatically, using -<a href="http://mirror.ctan.org/systems/texlive/tlnet">http://mirror.ctan.org/systems/texlive/tlnet</a>; the chosen mirror is +<a href="https://mirror.ctan.org/systems/texlive/tlnet">https://mirror.ctan.org/systems/texlive/tlnet</a>; the chosen mirror is used for the entire download. You can use the special argument <code>ctan</code> as an abbreviation for this. (See <a href="https://ctan.org">https://ctan.org</a> for more about CTAN and its mirrors.) @@ -3494,7 +3552,7 @@ the full scheme containing all packages, the list of available schemes will be adjusted accordingly. </p> </dd> -<dt><strong>-select-repository</strong></dt> +<dt><span><strong>-select-repository</strong></span></dt> <dd><span id="install_002dtl-_002dselect_002drepository"></span> <p>This option allows you to choose a particular mirror from the current list of active CTAN mirrors. This option is supported in the <code>text</code> @@ -3504,7 +3562,7 @@ command line. It’s useful when the (default) automatic redirection does not choose a good host for you. </p> </dd> -<dt><strong>-all-options</strong></dt> +<dt><span><strong>-all-options</strong></span></dt> <dd><span id="install_002dtl-_002dall_002doptions"></span> <p>Normally options not relevant to the current platform are not shown (e.g., when running on Unix, Windows-specific options are omitted). @@ -3512,7 +3570,7 @@ Giving this command line option allows configuring such "foreign" settings. </p> </dd> -<dt><strong>-custom-bin</strong> <em>path</em></dt> +<dt><span><strong>-custom-bin</strong> <em>path</em></span></dt> <dd><span id="install_002dtl-_002dcustom_002dbin-path"></span> <p>If you have built your own set of TeX Live binaries (perhaps because your platform was not supported by TeX Live out of the box), this option @@ -3529,7 +3587,13 @@ actions. To install multiple custom binary sets, manually rename building TeX Live, see <a href="https://tug.org/texlive/build.html">https://tug.org/texlive/build.html</a>. </p> </dd> -<dt><strong>-debug-translation</strong></dt> +<dt><span><strong>-debug-fakenet</strong></span></dt> +<dd><span id="install_002dtl-_002ddebug_002dfakenet"></span> +<p>Pretend we’re doing a network install, for the sole purpose of testing +broken downloads via moving package files aside in a tlnet mirror. +</p> +</dd> +<dt><span><strong>-debug-translation</strong></span></dt> <dd><span id="install_002dtl-_002ddebug_002dtranslation"></span> <p>In the former Perl/Tk GUI modes, this option reported any missing, or more likely untranslated, messages to standard error. Not yet @@ -3537,14 +3601,14 @@ implemented for the Tcl interface. Helpful for translators to see what remains to be done. </p> </dd> -<dt><strong>-force-platform</strong> <em>platform</em></dt> +<dt><span><strong>-force-platform</strong> <em>platform</em></span></dt> <dd><span id="install_002dtl-_002dforce_002dplatform-platform"></span> <p>Instead of auto-detecting the current platform, use <em>platform</em>. Binaries for this platform must be present and they must actually be runnable, or installation will fail. <code>-force-arch</code> is a synonym. </p> </dd> -<dt><strong>-help</strong>, <strong>–help</strong>, <strong>-?</strong></dt> +<dt><span><strong>-help</strong>, <strong>–help</strong>, <strong>-?</strong></span></dt> <dd><span id="install_002dtl-_002dhelp_002c-_002d_002dhelp_002c-_002d_003f"></span> <p>Display this help and exit. (This help is also on the web at <a href="https://tug.org/texlive/doc/install-tl.html">https://tug.org/texlive/doc/install-tl.html</a>). Sometimes the <code>perldoc</code> @@ -3554,7 +3618,7 @@ detected, but you can set the <code>NOPERLDOC</code> environment variable and <code>perldoc</code> will not be used. </p> </dd> -<dt><strong>-in-place</strong></dt> +<dt><span><strong>-in-place</strong></span></dt> <dd><span id="install_002dtl-_002din_002dplace"></span> <p>This is a quick-and-dirty installation option in case you already have an rsync or svn checkout of TeX Live. It will use the checkout as-is @@ -3565,14 +3629,14 @@ is to redo it from time to time. This option is not available via the installer interfaces. USE AT YOUR OWN RISK. </p> </dd> -<dt><strong>-init-from-profile</strong> <em>profile_file</em></dt> +<dt><span><strong>-init-from-profile</strong> <em>profile_file</em></span></dt> <dd><span id="install_002dtl-_002dinit_002dfrom_002dprofile-profile_005ffile"></span> <p>Similar to <strong>-profile</strong> (see <a href="#install_002dtl-PROFILES">PROFILES</a> below), but only initializes the installation configuration from <em>profile_file</em> and then starts a normal interactive session. Environment variables are not ignored. </p> </dd> -<dt><strong>-logfile</strong> <em>file</em></dt> +<dt><span><strong>-logfile</strong> <em>file</em></span></dt> <dd><span id="install_002dtl-_002dlogfile-file"></span> <p>Write both all messages (informational, debugging, warnings) to <em>file</em>, in addition to standard output or standard error. @@ -3583,16 +3647,16 @@ for example, <code>/usr/local/texlive/YYYY/install-tl.log</code> for the <em>YYY release. </p> </dd> -<dt><strong>-no-cls</strong></dt> +<dt><span><strong>-no-cls</strong></span></dt> <dd><span id="install_002dtl-_002dno_002dcls"></span> <p>For the text mode installer only: do not clear the screen when entering a new menu (for debugging purposes). </p> </dd> -<dt><strong>-no-persistent-downloads</strong></dt> +<dt><span><strong>-no-persistent-downloads</strong></span></dt> <dd><span id="install_002dtl-_002dno_002dpersistent_002ddownloads"></span> </dd> -<dt><strong>-persistent-downloads</strong></dt> +<dt><span><strong>-persistent-downloads</strong></span></dt> <dd><span id="install_002dtl-_002dpersistent_002ddownloads"></span> <p>For network installs, activating this option makes the installer try to set up a persistent connection using the <code>Net::LWP</code> Perl module. This @@ -3605,7 +3669,7 @@ fall back to using <code>wget</code> if this is not possible. To disable usage LWP and persistent connections, use <code>-no-persistent-downloads</code>. </p> </dd> -<dt><strong>-no-verify-downloads</strong></dt> +<dt><span><strong>-no-verify-downloads</strong></span></dt> <dd><span id="install_002dtl-_002dno_002dverify_002ddownloads"></span> <p>By default, if a GnuPG <code>gpg</code> binary is found in PATH, downloads are verified against a cryptographic signature. This option disables such @@ -3614,37 +3678,37 @@ section of the <code>tlmgr</code> documentation, e.g., <a href="https://tug.org/texlive/doc/tlmgr.html#CRYPTOGRAPHIC-VERIFICATION">https://tug.org/texlive/doc/tlmgr.html#CRYPTOGRAPHIC-VERIFICATION</a> </p> </dd> -<dt><strong>-non-admin</strong></dt> +<dt><span><strong>-non-admin</strong></span></dt> <dd><span id="install_002dtl-_002dnon_002dadmin"></span> <p>For Windows only: configure for the current user, not for all users. </p> </dd> -<dt><strong>-portable</strong></dt> +<dt><span><strong>-portable</strong></span></dt> <dd><span id="install_002dtl-_002dportable"></span> <p>Install for portable use, e.g., on a USB stick. Also selectable from within the perltk and text installers. </p> </dd> -<dt><strong>-print-platform</strong></dt> +<dt><span><strong>-print-platform</strong></span></dt> <dd><span id="install_002dtl-_002dprint_002dplatform"></span> <p>Print the TeX Live identifier for the detected platform (hardware/operating system) combination to standard output, and exit. <code>-print-arch</code> is a synonym. </p> </dd> -<dt><strong>-profile</strong> <em>profile_file</em></dt> +<dt><span><strong>-profile</strong> <em>profile_file</em></span></dt> <dd><span id="install_002dtl-_002dprofile-profile_005ffile"></span> <p>Load <em>profile_file</em> and do the installation with no user interaction, that is, a batch (unattended) install. Environment variables are ignored. See <a href="#install_002dtl-PROFILES">PROFILES</a> below. </p> </dd> -<dt><strong>-q</strong></dt> +<dt><span><strong>-q</strong></span></dt> <dd><span id="install_002dtl-_002dq"></span> <p>Omit normal informational messages. </p> </dd> -<dt><strong>-scheme</strong> <em>scheme</em></dt> +<dt><span><strong>-scheme</strong> <em>scheme</em></span></dt> <dd><span id="install_002dtl-_002dscheme-scheme"></span> <p>Schemes are the highest level of package grouping in TeX Live; the default is to use the <code>full</code> scheme, which includes everything. This @@ -3655,13 +3719,13 @@ depends on what your package repository provides; see the interactive menu list. </p> </dd> -<dt><strong>-v</strong></dt> +<dt><span><strong>-v</strong></span></dt> <dd><span id="install_002dtl-_002dv"></span> <p>Include verbose debugging messages; repeat for maximum debugging: <code>-v -v</code>. (Further repeats are accepted but ignored.) </p> </dd> -<dt><strong>-version</strong>, <strong>–version</strong></dt> +<dt><span><strong>-version</strong>, <strong>–version</strong></span></dt> <dd><span id="install_002dtl-_002dversion_002c-_002d_002dversion"></span> <p>Output version information and exit. If <code>-v</code> is also given, the versions of the TeX Live modules used are also reported. @@ -3670,9 +3734,11 @@ versions of the TeX Live modules used are also reported. </dl> <hr> -<span id="install_002dtl-PROFILES"></span><div class="header"> +</div> +<div class="appendixsec" id="install_002dtl-PROFILES"> +<div class="header"> <p> -Next: <a href="#install_002dtl-ENVIRONMENT-VARIABLES" accesskey="n" rel="next">install-tl ENVIRONMENT VARIABLES</a>, Previous: <a href="#install_002dtl-OPTIONS" accesskey="p" rel="prev">install-tl OPTIONS</a>, Up: <a href="#install_002dtl" accesskey="u" rel="up">install-tl</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="#install_002dtl-ENVIRONMENT-VARIABLES" accesskey="n" rel="next">ENVIRONMENT VARIABLES</a>, Previous: <a href="#install_002dtl-OPTIONS" accesskey="p" rel="prev">OPTIONS</a>, Up: <a href="#install_002dtl" accesskey="u" rel="up">install-tl</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="PROFILES"></span><h3 class="appendixsec">A.6 PROFILES</h3> @@ -3747,28 +3813,28 @@ that could cause problems later. <p><strong>installer options</strong> (prefix <code>instopt_</code>) </p> <dl compact="compact"> -<dt><code>instopt_adjustpath</code> (default 0 on Unix, 1 on Windows)</dt> +<dt><span><code>instopt_adjustpath</code> (default 0 on Unix, 1 on Windows)</span></dt> <dd><span id="install_002dtl-instopt_005fadjustpath-_0028default-0-on-Unix_002c-1-on-Windows_0029"></span> <p>Adjust <code>PATH</code> environment variable. </p> </dd> -<dt><code>instopt_adjustrepo</code> (default 1)</dt> +<dt><span><code>instopt_adjustrepo</code> (default 1)</span></dt> <dd><span id="install_002dtl-instopt_005fadjustrepo-_0028default-1_0029"></span> <p>Set remote repository to a multiplexed CTAN mirror after installation; see <code>-repository</code> above. </p> </dd> -<dt><code>instopt_letter</code> (default 0)</dt> +<dt><span><code>instopt_letter</code> (default 0)</span></dt> <dd><span id="install_002dtl-instopt_005fletter-_0028default-0_0029"></span> <p>Set letter size paper as the default, instead of a4. </p> </dd> -<dt><code>instopt_portable</code> (default 0)</dt> +<dt><span><code>instopt_portable</code> (default 0)</span></dt> <dd><span id="install_002dtl-instopt_005fportable-_0028default-0_0029"></span> <p>Install for portable use, e.g., on a USB stick. </p> </dd> -<dt><code>instopt_write18_restricted</code> (default 1)</dt> +<dt><span><code>instopt_write18_restricted</code> (default 1)</span></dt> <dd><span id="install_002dtl-instopt_005fwrite18_005frestricted-_0028default-1_0029"></span> <p>Enable <code>\write18</code> for a restricted set of programs. </p> @@ -3815,9 +3881,11 @@ written, the names above are always used. installation manual, linked from <a href="https://tug.org/texlive/doc">https://tug.org/texlive/doc</a>. </p> <hr> -<span id="install_002dtl-ENVIRONMENT-VARIABLES"></span><div class="header"> +</div> +<div class="appendixsec" id="install_002dtl-ENVIRONMENT-VARIABLES"> +<div class="header"> <p> -Next: <a href="#install_002dtl-AUTHORS-AND-COPYRIGHT" accesskey="n" rel="next">install-tl AUTHORS AND COPYRIGHT</a>, Previous: <a href="#install_002dtl-PROFILES" accesskey="p" rel="prev">install-tl PROFILES</a>, Up: <a href="#install_002dtl" accesskey="u" rel="up">install-tl</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="#install_002dtl-AUTHORS-AND-COPYRIGHT" accesskey="n" rel="next">AUTHORS AND COPYRIGHT</a>, Previous: <a href="#install_002dtl-PROFILES" accesskey="p" rel="prev">PROFILES</a>, Up: <a href="#install_002dtl" accesskey="u" rel="up">install-tl</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"></span><h3 class="appendixsec">A.7 ENVIRONMENT VARIABLES</h3> @@ -3826,80 +3894,79 @@ following environment variables. They are not of interest for normal user installations. </p> <dl compact="compact"> -<dt><code>TEXLIVE_DOWNLOADER</code></dt> +<dt><span><code>TEXLIVE_DOWNLOADER</code></span></dt> <dd><span id="install_002dtl-TEXLIVE_005fDOWNLOADER"></span> </dd> -<dt><code>TL_DOWNLOAD_PROGRAM</code></dt> +<dt><span><code>TL_DOWNLOAD_PROGRAM</code></span></dt> <dd><span id="install_002dtl-TL_005fDOWNLOAD_005fPROGRAM"></span> </dd> -<dt><code>TL_DOWNLOAD_ARGS</code></dt> +<dt><span><code>TL_DOWNLOAD_ARGS</code></span></dt> <dd><span id="install_002dtl-TL_005fDOWNLOAD_005fARGS"></span> <p>These override the normal choice of a download program; see the <code>tlmgr</code> documentation, e.g., <a href="https://tug.org/texlive/doc/tlmgr.html#ENVIRONMENT-VARIABLES">https://tug.org/texlive/doc/tlmgr.html#ENVIRONMENT-VARIABLES</a>. </p> </dd> -<dt><code>TEXLIVE_INSTALL_ENV_NOCHECK</code></dt> +<dt><span><code>TEXLIVE_INSTALL_ENV_NOCHECK</code></span></dt> <dd><span id="install_002dtl-TEXLIVE_005fINSTALL_005fENV_005fNOCHECK"></span> <p>Omit the check for environment variables containing the string <code>tex</code>. People developing TeX-related software are likely to have many such variables. </p> </dd> -<dt><code>TEXLIVE_INSTALL_NO_CONTEXT_CACHE</code></dt> +<dt><span><code>TEXLIVE_INSTALL_NO_CONTEXT_CACHE</code></span></dt> <dd><span id="install_002dtl-TEXLIVE_005fINSTALL_005fNO_005fCONTEXT_005fCACHE"></span> <p>Omit creating the ConTeXt cache. This is useful for redistributors. </p> </dd> -<dt><code>TEXLIVE_INSTALL_NO_RESUME</code></dt> +<dt><span><code>TEXLIVE_INSTALL_NO_RESUME</code></span></dt> <dd><span id="install_002dtl-TEXLIVE_005fINSTALL_005fNO_005fRESUME"></span> <p>Omit check for installing on top of a previous installation and then asking about importing previous settings. </p> </dd> -<dt><code>TEXLIVE_INSTALL_NO_WELCOME</code></dt> +<dt><span><code>TEXLIVE_INSTALL_NO_WELCOME</code></span></dt> <dd><span id="install_002dtl-TEXLIVE_005fINSTALL_005fNO_005fWELCOME"></span> <p>Omit printing the welcome message after successful installation, e.g., when testing. </p> </dd> -<dt><code>TEXLIVE_INSTALL_PAPER</code></dt> +<dt><span><code>TEXLIVE_INSTALL_PAPER</code></span></dt> <dd><span id="install_002dtl-TEXLIVE_005fINSTALL_005fPAPER"></span> <p>Set the default paper size for all relevant programs; must be either <code>letter</code> or <code>a4</code>. The default is <code>a4</code>. </p> </dd> -<dt><code>TEXLIVE_INSTALL_PREFIX</code></dt> +<dt><span><code>TEXLIVE_INSTALL_PREFIX</code></span></dt> <dd><span id="install_002dtl-TEXLIVE_005fINSTALL_005fPREFIX"></span> </dd> -<dt><code>TEXLIVE_INSTALL_TEXDIR</code></dt> -<dd><span id="install_002dtl-TEXLIVE_005fINSTALL_005fTEXDIR"></span> -</dd> -<dt><code>TEXLIVE_INSTALL_TEXMFCONFIG</code></dt> +<dt><span><code>TEXLIVE_INSTALL_TEXMFCONFIG</code></span></dt> <dd><span id="install_002dtl-TEXLIVE_005fINSTALL_005fTEXMFCONFIG"></span> </dd> -<dt><code>TEXLIVE_INSTALL_TEXMFVAR</code></dt> +<dt><span><code>TEXLIVE_INSTALL_TEXMFVAR</code></span></dt> <dd><span id="install_002dtl-TEXLIVE_005fINSTALL_005fTEXMFVAR"></span> </dd> -<dt><code>TEXLIVE_INSTALL_TEXMFHOME</code></dt> +<dt><span><code>TEXLIVE_INSTALL_TEXMFHOME</code></span></dt> <dd><span id="install_002dtl-TEXLIVE_005fINSTALL_005fTEXMFHOME"></span> </dd> -<dt><code>TEXLIVE_INSTALL_TEXMFLOCAL</code></dt> +<dt><span><code>TEXLIVE_INSTALL_TEXMFLOCAL</code></span></dt> <dd><span id="install_002dtl-TEXLIVE_005fINSTALL_005fTEXMFLOCAL"></span> </dd> -<dt><code>TEXLIVE_INSTALL_TEXMFSYSCONFIG</code></dt> +<dt><span><code>TEXLIVE_INSTALL_TEXMFSYSCONFIG</code></span></dt> <dd><span id="install_002dtl-TEXLIVE_005fINSTALL_005fTEXMFSYSCONFIG"></span> </dd> -<dt><code>TEXLIVE_INSTALL_TEXMFSYSVAR</code></dt> +<dt><span><code>TEXLIVE_INSTALL_TEXMFSYSVAR</code></span></dt> <dd><span id="install_002dtl-TEXLIVE_005fINSTALL_005fTEXMFSYSVAR"></span> -<p>Specify the respective directories. <code>TEXLIVE_INSTALL_PREFIX</code> defaults -to <code>/usr/local/texlive</code>, while <code>TEXLIVE_INSTALL_TEXDIR</code> defaults to -the release directory within that prefix, e.g., -<code>/usr/local/texlive/2016</code>. All the defaults can be seen by running the +<p>Specify the respective directories. <code>TEXLIVE_INSTALL_PREFIX</code> defaults +to <code>/usr/local/texlive</code>. All the defaults can be seen by running the installer interactively and then typing <code>D</code> for the directory menu. </p> +<p>To override the so-called <code>TEXDIR</code>, which defaults to the release +directory within that prefix, e.g., <code>/usr/local/texlive/2020</code>, use a +profile file (q.v.). +</p> </dd> -<dt><code>NOPERLDOC</code></dt> +<dt><span><code>NOPERLDOC</code></span></dt> <dd><span id="install_002dtl-NOPERLDOC"></span> <p>Don’t try to run the <code>--help</code> message through <code>perldoc</code>. </p> @@ -3907,9 +3974,11 @@ installer interactively and then typing <code>D</code> for the directory menu. </dl> <hr> -<span id="install_002dtl-AUTHORS-AND-COPYRIGHT"></span><div class="header"> +</div> +<div class="appendixsec" id="install_002dtl-AUTHORS-AND-COPYRIGHT"> +<div class="header"> <p> -Previous: <a href="#install_002dtl-ENVIRONMENT-VARIABLES" accesskey="p" rel="prev">install-tl ENVIRONMENT VARIABLES</a>, Up: <a href="#install_002dtl" accesskey="u" rel="up">install-tl</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="#install_002dtl-ENVIRONMENT-VARIABLES" accesskey="p" rel="prev">ENVIRONMENT VARIABLES</a>, Up: <a href="#install_002dtl" accesskey="u" rel="up">install-tl</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="AUTHORS-AND-COPYRIGHT"></span><h3 class="appendixsec">A.8 AUTHORS AND COPYRIGHT</h3> @@ -3917,68 +3986,62 @@ Previous: <a href="#install_002dtl-ENVIRONMENT-VARIABLES" accesskey="p" rel="pre distribution (<a href="https://tug.org/texlive">https://tug.org/texlive</a>) and both are licensed under the GNU General Public License Version 2 or later. </p> -<p>$Id: install-tl 57970 2021-02-27 14:17:34Z siepo $ +<p>$Id: install-tl 62146 2022-02-22 22:48:10Z karl $ </p> <hr> -<span id="tlmgr"></span><div class="header"> +</div> +</div> +<div class="appendix" id="tlmgr"> +<div class="header"> <p> -Next: <a href="#Index" accesskey="n" rel="next">Index</a>, Previous: <a href="#install_002dtl" accesskey="p" rel="prev">install-tl</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="#install_002dtl" accesskey="p" rel="prev">install-tl</a>, Up: <a href="#Top" accesskey="u" rel="up">Building TeX Live (2022)</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="tlmgr-1"></span><h2 class="appendix">Appendix B tlmgr</h2> -<table class="menu" border="0" cellspacing="0"> -<tr><td align="left" valign="top">• <a href="#tlmgr-NAME" accesskey="1">tlmgr NAME</a></td><td> </td><td align="left" valign="top"> -</td></tr> -<tr><td align="left" valign="top">• <a href="#tlmgr-SYNOPSIS" accesskey="2">tlmgr SYNOPSIS</a></td><td> </td><td align="left" valign="top"> -</td></tr> -<tr><td align="left" valign="top">• <a href="#tlmgr-DESCRIPTION" accesskey="3">tlmgr DESCRIPTION</a></td><td> </td><td align="left" valign="top"> -</td></tr> -<tr><td align="left" valign="top">• <a href="#tlmgr-EXAMPLES" accesskey="4">tlmgr EXAMPLES</a></td><td> </td><td align="left" valign="top"> -</td></tr> -<tr><td align="left" valign="top">• <a href="#tlmgr-OPTIONS" accesskey="5">tlmgr OPTIONS</a></td><td> </td><td align="left" valign="top"> -</td></tr> -<tr><td align="left" valign="top">• <a href="#tlmgr-ACTIONS" accesskey="6">tlmgr ACTIONS</a></td><td> </td><td align="left" valign="top"> -</td></tr> -<tr><td align="left" valign="top">• <a href="#tlmgr-CONFIGURATION-FILE-FOR-TLMGR" accesskey="7">tlmgr CONFIGURATION FILE FOR TLMGR</a></td><td> </td><td align="left" valign="top"> -</td></tr> -<tr><td align="left" valign="top">• <a href="#tlmgr-CRYPTOGRAPHIC-VERIFICATION" accesskey="8">tlmgr CRYPTOGRAPHIC VERIFICATION</a></td><td> </td><td align="left" valign="top"> -</td></tr> -<tr><td align="left" valign="top">• <a href="#tlmgr-USER-MODE" accesskey="9">tlmgr USER MODE</a></td><td> </td><td align="left" valign="top"> -</td></tr> -<tr><td align="left" valign="top">• <a href="#tlmgr-MULTIPLE-REPOSITORIES">tlmgr MULTIPLE REPOSITORIES</a></td><td> </td><td align="left" valign="top"> -</td></tr> -<tr><td align="left" valign="top">• <a href="#tlmgr-GUI-FOR-TLMGR">tlmgr GUI FOR TLMGR</a></td><td> </td><td align="left" valign="top"> -</td></tr> -<tr><td align="left" valign="top">• <a href="#tlmgr-MACHINE_002dREADABLE-OUTPUT">tlmgr MACHINE-READABLE OUTPUT</a></td><td> </td><td align="left" valign="top"> -</td></tr> -<tr><td align="left" valign="top">• <a href="#tlmgr-ENVIRONMENT-VARIABLES">tlmgr ENVIRONMENT VARIABLES</a></td><td> </td><td align="left" valign="top"> -</td></tr> -<tr><td align="left" valign="top">• <a href="#tlmgr-AUTHORS-AND-COPYRIGHT">tlmgr AUTHORS AND COPYRIGHT</a></td><td> </td><td align="left" valign="top"> -</td></tr> -</table> +<ul class="section-toc"> +<li><a href="#tlmgr-NAME" accesskey="1">NAME</a></li> +<li><a href="#tlmgr-SYNOPSIS" accesskey="2">SYNOPSIS</a></li> +<li><a href="#tlmgr-DESCRIPTION" accesskey="3">DESCRIPTION</a></li> +<li><a href="#tlmgr-EXAMPLES" accesskey="4">EXAMPLES</a></li> +<li><a href="#tlmgr-OPTIONS" accesskey="5">OPTIONS</a></li> +<li><a href="#tlmgr-ACTIONS" accesskey="6">ACTIONS</a></li> +<li><a href="#tlmgr-CONFIGURATION-FILE-FOR-TLMGR" accesskey="7">CONFIGURATION FILE FOR TLMGR</a></li> +<li><a href="#tlmgr-CRYPTOGRAPHIC-VERIFICATION" accesskey="8">CRYPTOGRAPHIC VERIFICATION</a></li> +<li><a href="#tlmgr-USER-MODE" accesskey="9">USER MODE</a></li> +<li><a href="#tlmgr-MULTIPLE-REPOSITORIES">MULTIPLE REPOSITORIES</a></li> +<li><a href="#tlmgr-GUI-FOR-TLMGR">GUI FOR TLMGR</a></li> +<li><a href="#tlmgr-MACHINE_002dREADABLE-OUTPUT">MACHINE-READABLE OUTPUT</a></li> +<li><a href="#tlmgr-ENVIRONMENT-VARIABLES">ENVIRONMENT VARIABLES</a></li> +<li><a href="#tlmgr-AUTHORS-AND-COPYRIGHT">AUTHORS AND COPYRIGHT</a></li> +</ul> <hr> -<span id="tlmgr-NAME"></span><div class="header"> +<div class="appendixsec" id="tlmgr-NAME"> +<div class="header"> <p> -Next: <a href="#tlmgr-SYNOPSIS" accesskey="n" rel="next">tlmgr SYNOPSIS</a>, Up: <a href="#tlmgr" accesskey="u" rel="up">tlmgr</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="#tlmgr-SYNOPSIS" accesskey="n" rel="next">SYNOPSIS</a>, Up: <a href="#tlmgr" accesskey="u" rel="up">tlmgr</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="NAME-1"></span><h3 class="appendixsec">B.1 NAME</h3> <p>tlmgr - the native TeX Live Manager </p> <hr> -<span id="tlmgr-SYNOPSIS"></span><div class="header"> +</div> +<div class="appendixsec" id="tlmgr-SYNOPSIS"> +<div class="header"> <p> -Next: <a href="#tlmgr-DESCRIPTION" accesskey="n" rel="next">tlmgr DESCRIPTION</a>, Previous: <a href="#tlmgr-NAME" accesskey="p" rel="prev">tlmgr NAME</a>, Up: <a href="#tlmgr" accesskey="u" rel="up">tlmgr</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="#tlmgr-DESCRIPTION" accesskey="n" rel="next">DESCRIPTION</a>, Previous: <a href="#tlmgr-NAME" accesskey="p" rel="prev">NAME</a>, Up: <a href="#tlmgr" accesskey="u" rel="up">tlmgr</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="SYNOPSIS-1"></span><h3 class="appendixsec">B.2 SYNOPSIS</h3> <p>tlmgr [<em>option</em>...] <em>action</em> [<em>option</em>...] [<em>operand</em>...] </p> <hr> -<span id="tlmgr-DESCRIPTION"></span><div class="header"> +</div> +<div class="appendixsec" id="tlmgr-DESCRIPTION"> +<div class="header"> <p> -Next: <a href="#tlmgr-EXAMPLES" accesskey="n" rel="next">tlmgr EXAMPLES</a>, Previous: <a href="#tlmgr-SYNOPSIS" accesskey="p" rel="prev">tlmgr SYNOPSIS</a>, Up: <a href="#tlmgr" accesskey="u" rel="up">tlmgr</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="#tlmgr-EXAMPLES" accesskey="n" rel="next">EXAMPLES</a>, Previous: <a href="#tlmgr-SYNOPSIS" accesskey="p" rel="prev">SYNOPSIS</a>, Up: <a href="#tlmgr" accesskey="u" rel="up">tlmgr</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="DESCRIPTION-1"></span><h3 class="appendixsec">B.3 DESCRIPTION</h3> @@ -4002,9 +4065,11 @@ A TeX Live installation can be customized and managed at any level. available. </p> <hr> -<span id="tlmgr-EXAMPLES"></span><div class="header"> +</div> +<div class="appendixsec" id="tlmgr-EXAMPLES"> +<div class="header"> <p> -Next: <a href="#tlmgr-OPTIONS" accesskey="n" rel="next">tlmgr OPTIONS</a>, Previous: <a href="#tlmgr-DESCRIPTION" accesskey="p" rel="prev">tlmgr DESCRIPTION</a>, Up: <a href="#tlmgr" accesskey="u" rel="up">tlmgr</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="#tlmgr-OPTIONS" accesskey="n" rel="next">OPTIONS</a>, Previous: <a href="#tlmgr-DESCRIPTION" accesskey="p" rel="prev">DESCRIPTION</a>, Up: <a href="#tlmgr" accesskey="u" rel="up">tlmgr</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="EXAMPLES"></span><h3 class="appendixsec">B.4 EXAMPLES</h3> @@ -4012,11 +4077,11 @@ Next: <a href="#tlmgr-OPTIONS" accesskey="n" rel="next">tlmgr OPTIONS</a>, Previ with <code>tlmgr</code>: </p> <dl compact="compact"> -<dt><code>tlmgr option repository ctan</code></dt> +<dt><span><code>tlmgr option repository ctan</code></span></dt> <dd><span id="tlmgr-tlmgr-option-repository-ctan"></span> </dd> -<dt><code>tlmgr option repository http://mirror.ctan.org/systems/texlive/tlnet</code></dt> -<dd><span id="tlmgr-tlmgr-option-repository-http_003a_002f_002fmirror_002ectan_002eorg_002fsystems_002ftexlive_002ftlnet"></span> +<dt><span><code>tlmgr option repository https://mirror.ctan.org/systems/texlive/tlnet</code></span></dt> +<dd><span id="tlmgr-tlmgr-option-repository-https_003a_002f_002fmirror_002ectan_002eorg_002fsystems_002ftexlive_002ftlnet"></span> <p>Tell <code>tlmgr</code> to use a nearby CTAN mirror for future updates; useful if you installed TeX Live from the DVD image and want to have continuing updates. The two commands are equivalent; <code>ctan</code> is just an alias for @@ -4029,18 +4094,18 @@ problems; the list of all CTAN mirrors with the status of each is at <a href="https://ctan.org/mirrors/mirmon">https://ctan.org/mirrors/mirmon</a>. </p> </dd> -<dt><code>tlmgr update --list</code></dt> +<dt><span><code>tlmgr update --list</code></span></dt> <dd><span id="tlmgr-tlmgr-update-_002d_002dlist"></span> <p>Report what would be updated without actually updating anything. </p> </dd> -<dt><code>tlmgr update --all</code></dt> +<dt><span><code>tlmgr update --all</code></span></dt> <dd><span id="tlmgr-tlmgr-update-_002d_002dall"></span> <p>Make your local TeX installation correspond to what is in the package repository (typically useful when updating from CTAN). </p> </dd> -<dt><code>tlmgr info</code> <em>what</em></dt> +<dt><span><code>tlmgr info</code> <em>what</em></span></dt> <dd><span id="tlmgr-tlmgr-info-what"></span> <p>Display detailed information about a package <em>what</em>, such as the installation status and description, of searches for <em>what</em> in all packages. @@ -4052,9 +4117,11 @@ status and description, of searches for <em>what</em> in all packages. following voluminous information. </p> <hr> -<span id="tlmgr-OPTIONS"></span><div class="header"> +</div> +<div class="appendixsec" id="tlmgr-OPTIONS"> +<div class="header"> <p> -Next: <a href="#tlmgr-ACTIONS" accesskey="n" rel="next">tlmgr ACTIONS</a>, Previous: <a href="#tlmgr-EXAMPLES" accesskey="p" rel="prev">tlmgr EXAMPLES</a>, Up: <a href="#tlmgr" accesskey="u" rel="up">tlmgr</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="#tlmgr-ACTIONS" accesskey="n" rel="next">ACTIONS</a>, Previous: <a href="#tlmgr-EXAMPLES" accesskey="p" rel="prev">EXAMPLES</a>, Up: <a href="#tlmgr" accesskey="u" rel="up">tlmgr</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="OPTIONS-1"></span><h3 class="appendixsec">B.5 OPTIONS</h3> @@ -4066,7 +4133,7 @@ non-option argument will be the main action. In all cases, between an option name and its value. </p> <dl compact="compact"> -<dt><strong>–repository</strong> <em>url|path</em></dt> +<dt><span><strong>–repository</strong> <em>url|path</em></span></dt> <dd><span id="tlmgr-_002d_002drepository-url_007cpath"></span> <p>Specify the package repository from which packages should be installed or updated, either a local directory or network location, as below. This @@ -4097,26 +4164,26 @@ are accepted as aliases for this option. <p>Locations can be specified as any of the following: </p> <dl compact="compact"> -<dt><code>/some/local/dir</code></dt> +<dt><span><code>/some/local/dir</code></span></dt> <dd><span id="tlmgr-_002fsome_002flocal_002fdir"></span> </dd> -<dt><code>file:/some/local/dir</code></dt> +<dt><span><code>file:/some/local/dir</code></span></dt> <dd><span id="tlmgr-file_003a_002fsome_002flocal_002fdir"></span> <p>Equivalent ways of specifying a local directory. </p> </dd> -<dt><code>ctan</code></dt> +<dt><span><code>ctan</code></span></dt> <dd><span id="tlmgr-ctan"></span> </dd> -<dt><code>http://mirror.ctan.org/systems/texlive/tlnet</code></dt> -<dd><span id="tlmgr-http_003a_002f_002fmirror_002ectan_002eorg_002fsystems_002ftexlive_002ftlnet"></span> +<dt><span><code>https://mirror.ctan.org/systems/texlive/tlnet</code></span></dt> +<dd><span id="tlmgr-https_003a_002f_002fmirror_002ectan_002eorg_002fsystems_002ftexlive_002ftlnet"></span> <p>Pick a CTAN mirror automatically, trying for one that is both nearby and up-to-date. The chosen mirror is used for the entire download. The bare <code>ctan</code> is merely an alias for the full url. (See <a href="https://ctan.org">https://ctan.org</a> for more about CTAN and its mirrors.) </p> </dd> -<dt><code>http://server/path/to/tlnet</code></dt> +<dt><span><code>http://server/path/to/tlnet</code></span></dt> <dd><span id="tlmgr-http_003a_002f_002fserver_002fpath_002fto_002ftlnet"></span> <p>Standard HTTP. If the (default) LWP method is used, persistent connections are supported. TL can also use <code>curl</code> or <code>wget</code> to do the @@ -4125,7 +4192,7 @@ downloads, or an arbitrary user-specified program, as described in the (<a href="https://tug.org/texlive/doc/tlmgr.html#ENVIRONMENT-VARIABLES">https://tug.org/texlive/doc/tlmgr.html#ENVIRONMENT-VARIABLES</a>). </p> </dd> -<dt><code>https://server/path/to/tlnet</code></dt> +<dt><span><code>https://server/path/to/tlnet</code></span></dt> <dd><span id="tlmgr-https_003a_002f_002fserver_002fpath_002fto_002ftlnet"></span> <p>Again, if the (default) LWP method is used, this supports persistent connections. Unfortunately, some versions of <code>wget</code> and <code>curl</code> do not @@ -4135,19 +4202,19 @@ certificate roots. The simplest workaround for this problem is to use http or ftp. </p> </dd> -<dt><code>ftp://server/path/to/tlnet</code></dt> +<dt><span><code>ftp://server/path/to/tlnet</code></span></dt> <dd><span id="tlmgr-ftp_003a_002f_002fserver_002fpath_002fto_002ftlnet"></span> <p>If the (default) LWP method is used, persistent connections are supported. </p> </dd> -<dt><code>user@machine:/path/to/tlnet</code></dt> +<dt><span><code>user@machine:/path/to/tlnet</code></span></dt> <dd><span id="tlmgr-user_0040machine_003a_002fpath_002fto_002ftlnet"></span> </dd> -<dt><code>scp://user@machine/path/to/tlnet</code></dt> +<dt><span><code>scp://user@machine/path/to/tlnet</code></span></dt> <dd><span id="tlmgr-scp_003a_002f_002fuser_0040machine_002fpath_002fto_002ftlnet"></span> </dd> -<dt><code>ssh://user@machine/path/to/tlnet</code></dt> +<dt><span><code>ssh://user@machine/path/to/tlnet</code></span></dt> <dd><span id="tlmgr-ssh_003a_002f_002fuser_0040machine_002fpath_002fto_002ftlnet"></span> <p>These forms are equivalent; they all use <code>scp</code> to transfer files. Using <code>ssh-agent</code> is recommended. (Info: @@ -4161,7 +4228,7 @@ supported. trailing <code>/tlpkg</code> and/or <code>/archive</code> components are ignored. </p> </dd> -<dt><strong>–gui</strong> [<em>action</em>]</dt> +<dt><span><strong>–gui</strong> [<em>action</em>]</span></dt> <dd><span id="tlmgr-_002d_002dgui-_005baction_005d"></span> <p>Two notable GUI front-ends for <code>tlmgr</code>, <code>tlshell</code> and <code>tlcockpit</code>, are started up as separate programs; see their own documentation. @@ -4181,7 +4248,7 @@ TeX Live’s Perl distribution for Windows. You may find <code>tlshell</code <code>tlcockpit</code> easier to work with. </p> </dd> -<dt><strong>–gui-lang</strong> <em>llcode</em></dt> +<dt><span><strong>–gui-lang</strong> <em>llcode</em></span></dt> <dd><span id="tlmgr-_002d_002dgui_002dlang-llcode"></span> <p>By default, the GUI tries to deduce your language from the environment (on Windows via the registry, on Unix via <code>LC_MESSAGES</code>). If that fails @@ -4194,7 +4261,7 @@ Japanese (ja)<!-- /@w -->, Dutch (nl)<!-- /@w -->, Polish (pl)<!- <p>tlshell shares its message catalog with tlmgr. </p> </dd> -<dt><strong>–command-logfile</strong> <em>file</em></dt> +<dt><span><strong>–command-logfile</strong> <em>file</em></span></dt> <dd><span id="tlmgr-_002d_002dcommand_002dlogfile-file"></span> <p><code>tlmgr</code> logs the output of all programs invoked (mktexlr, mtxrun, fmtutil, updmap) to a separate log file, by default @@ -4202,28 +4269,28 @@ updmap) to a separate log file, by default different file for the log. </p> </dd> -<dt><strong>–debug-translation</strong></dt> +<dt><span><strong>–debug-translation</strong></span></dt> <dd><span id="tlmgr-_002d_002ddebug_002dtranslation"></span> <p>In GUI mode, this switch tells <code>tlmgr</code> to report any untranslated (or missing) messages to standard error. This can help translators to see what remains to be done. </p> </dd> -<dt><strong>–machine-readable</strong></dt> +<dt><span><strong>–machine-readable</strong></span></dt> <dd><span id="tlmgr-_002d_002dmachine_002dreadable"></span> <p>Instead of the normal output intended for human consumption, write (to standard output) a fixed format more suitable for machine parsing. See the <a href="#tlmgr-MACHINE_002dREADABLE-OUTPUT">MACHINE-READABLE OUTPUT</a> section below. </p> </dd> -<dt><strong>–no-execute-actions</strong></dt> +<dt><span><strong>–no-execute-actions</strong></span></dt> <dd><span id="tlmgr-_002d_002dno_002dexecute_002dactions"></span> <p>Suppress the execution of the execute actions as defined in the tlpsrc files. Documented only for completeness, as this is only useful in debugging. </p> </dd> -<dt><strong>–package-logfile</strong> <em>file</em></dt> +<dt><span><strong>–package-logfile</strong> <em>file</em></span></dt> <dd><span id="tlmgr-_002d_002dpackage_002dlogfile-file"></span> <p><code>tlmgr</code> logs all package actions (install, remove, update, failed updates, failed restores) to a separate log file, by default @@ -4231,16 +4298,16 @@ updates, failed restores) to a separate log file, by default different file for the log. </p> </dd> -<dt><strong>–pause</strong></dt> +<dt><span><strong>–pause</strong></span></dt> <dd><span id="tlmgr-_002d_002dpause"></span> <p>This option makes <code>tlmgr</code> wait for user input before exiting. Useful on Windows to avoid disappearing command windows. </p> </dd> -<dt><strong>–persistent-downloads</strong></dt> +<dt><span><strong>–persistent-downloads</strong></span></dt> <dd><span id="tlmgr-_002d_002dpersistent_002ddownloads"></span> </dd> -<dt><strong>–no-persistent-downloads</strong></dt> +<dt><span><strong>–no-persistent-downloads</strong></span></dt> <dd><span id="tlmgr-_002d_002dno_002dpersistent_002ddownloads"></span> <p>For network-based installations, this option (on by default) makes <code>tlmgr</code> try to set up a persistent connection (using the <code>LWP</code> Perl @@ -4252,24 +4319,24 @@ download for each package. disable these persistent connections, use <code>--no-persistent-downloads</code>. </p> </dd> -<dt><strong>–pin-file</strong></dt> +<dt><span><strong>–pin-file</strong></span></dt> <dd><span id="tlmgr-_002d_002dpin_002dfile"></span> <p>Change the pinning file location from <code>TEXMFLOCAL/tlpkg/pinning.txt</code> (see <a href="#tlmgr-Pinning">Pinning</a> below). Documented only for completeness, as this is only useful in debugging. </p> </dd> -<dt><strong>–usermode</strong></dt> +<dt><span><strong>–usermode</strong></span></dt> <dd><span id="tlmgr-_002d_002dusermode"></span> <p>Activates user mode for this run of <code>tlmgr</code>; see <a href="#tlmgr-USER-MODE">USER MODE</a> below. </p> </dd> -<dt><strong>–usertree</strong> <em>dir</em></dt> +<dt><span><strong>–usertree</strong> <em>dir</em></span></dt> <dd><span id="tlmgr-_002d_002dusertree-dir"></span> <p>Uses <em>dir</em> for the tree in user mode; see <a href="#tlmgr-USER-MODE">USER MODE</a> below. </p> </dd> -<dt><strong>–verify-repo=[none|main|all]</strong></dt> +<dt><span><strong>–verify-repo=[none|main|all]</strong></span></dt> <dd><span id="tlmgr-_002d_002dverify_002drepo_003d_005bnone_007cmain_007call_005d"></span> <p>Defines the level of verification done: If <code>none</code> is specified, no verification whatsoever is done. If <code>main</code> is given and a working GnuPG @@ -4291,79 +4358,52 @@ release and about the <code>tlmgr</code> script itself. If <code>-v</code> is a revision number for the loaded TeX Live Perl modules are shown, too. </p> <hr> -<span id="tlmgr-ACTIONS"></span><div class="header"> +</div> +<div class="appendixsec" id="tlmgr-ACTIONS"> +<div class="header"> <p> -Next: <a href="#tlmgr-CONFIGURATION-FILE-FOR-TLMGR" accesskey="n" rel="next">tlmgr CONFIGURATION FILE FOR TLMGR</a>, Previous: <a href="#tlmgr-OPTIONS" accesskey="p" rel="prev">tlmgr OPTIONS</a>, Up: <a href="#tlmgr" accesskey="u" rel="up">tlmgr</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="#tlmgr-CONFIGURATION-FILE-FOR-TLMGR" accesskey="n" rel="next">CONFIGURATION FILE FOR TLMGR</a>, Previous: <a href="#tlmgr-OPTIONS" accesskey="p" rel="prev">OPTIONS</a>, Up: <a href="#tlmgr" accesskey="u" rel="up">tlmgr</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="ACTIONS"></span><h3 class="appendixsec">B.6 ACTIONS</h3> -<table class="menu" border="0" cellspacing="0"> -<tr><td align="left" valign="top">• <a href="#tlmgr-help" accesskey="1">tlmgr help</a></td><td> </td><td align="left" valign="top"> -</td></tr> -<tr><td align="left" valign="top">• <a href="#tlmgr-version" accesskey="2">tlmgr version</a></td><td> </td><td align="left" valign="top"> -</td></tr> -<tr><td align="left" valign="top">• <a href="#tlmgr-backup" accesskey="3">tlmgr backup</a></td><td> </td><td align="left" valign="top"> -</td></tr> -<tr><td align="left" valign="top">• <a href="#tlmgr-candidates-pkg" accesskey="4">tlmgr candidates <em>pkg</em></a></td><td> </td><td align="left" valign="top"> -</td></tr> -<tr><td align="left" valign="top">• <a href="#tlmgr-check-_005boption_002e_002e_002e_005d-_005bdepends_007cexecutes_007cfiles_007crunfiles_007ctexmfdbs_007call_005d" accesskey="5">tlmgr check [<em>option</em>...] [depends|executes|files|runfiles|texmfdbs|all]</a></td><td> </td><td align="left" valign="top"> -</td></tr> -<tr><td align="left" valign="top">• <a href="#tlmgr-conf" accesskey="6">tlmgr conf</a></td><td> </td><td align="left" valign="top"> -</td></tr> -<tr><td align="left" valign="top">• <a href="#tlmgr-dump_002dtlpdb-_005boption_002e_002e_002e_005d-_005b_002d_002djson_005d" accesskey="7">tlmgr dump-tlpdb [<em>option</em>...] [--json]</a></td><td> </td><td align="left" valign="top"> -</td></tr> -<tr><td align="left" valign="top">• <a href="#tlmgr-generate" accesskey="8">tlmgr generate</a></td><td> </td><td align="left" valign="top"> -</td></tr> -<tr><td align="left" valign="top">• <a href="#tlmgr-gui" accesskey="9">tlmgr gui</a></td><td> </td><td align="left" valign="top"> -</td></tr> -<tr><td align="left" valign="top">• <a href="#tlmgr-info">tlmgr info</a></td><td> </td><td align="left" valign="top"> -</td></tr> -<tr><td align="left" valign="top">• <a href="#tlmgr-init_002dusertree">tlmgr init-usertree</a></td><td> </td><td align="left" valign="top"> -</td></tr> -<tr><td align="left" valign="top">• <a href="#tlmgr-install-_005boption_002e_002e_002e_005d-pkg_002e_002e_002e">tlmgr install [<em>option</em>...] <em>pkg</em>...</a></td><td> </td><td align="left" valign="top"> -</td></tr> -<tr><td align="left" valign="top">• <a href="#tlmgr-key">tlmgr key</a></td><td> </td><td align="left" valign="top"> -</td></tr> -<tr><td align="left" valign="top">• <a href="#tlmgr-list">tlmgr list</a></td><td> </td><td align="left" valign="top"> -</td></tr> -<tr><td align="left" valign="top">• <a href="#tlmgr-option">tlmgr option</a></td><td> </td><td align="left" valign="top"> -</td></tr> -<tr><td align="left" valign="top">• <a href="#tlmgr-paper">tlmgr paper</a></td><td> </td><td align="left" valign="top"> -</td></tr> -<tr><td align="left" valign="top">• <a href="#tlmgr-path">tlmgr path</a></td><td> </td><td align="left" valign="top"> -</td></tr> -<tr><td align="left" valign="top">• <a href="#tlmgr-pinning">tlmgr pinning</a></td><td> </td><td align="left" valign="top"> -</td></tr> -<tr><td align="left" valign="top">• <a href="#tlmgr-platform">tlmgr platform</a></td><td> </td><td align="left" valign="top"> -</td></tr> -<tr><td align="left" valign="top">• <a href="#tlmgr-postaction">tlmgr postaction</a></td><td> </td><td align="left" valign="top"> -</td></tr> -<tr><td align="left" valign="top">• <a href="#tlmgr-print_002dplatform">tlmgr print-platform</a></td><td> </td><td align="left" valign="top"> -</td></tr> -<tr><td align="left" valign="top">• <a href="#tlmgr-print_002dplatform_002dinfo">tlmgr print-platform-info</a></td><td> </td><td align="left" valign="top"> -</td></tr> -<tr><td align="left" valign="top">• <a href="#tlmgr-remove-_005boption_002e_002e_002e_005d-pkg_002e_002e_002e">tlmgr remove [<em>option</em>...] <em>pkg</em>...</a></td><td> </td><td align="left" valign="top"> -</td></tr> -<tr><td align="left" valign="top">• <a href="#tlmgr-repository">tlmgr repository</a></td><td> </td><td align="left" valign="top"> -</td></tr> -<tr><td align="left" valign="top">• <a href="#tlmgr-restore">tlmgr restore</a></td><td> </td><td align="left" valign="top"> -</td></tr> -<tr><td align="left" valign="top">• <a href="#tlmgr-search">tlmgr search</a></td><td> </td><td align="left" valign="top"> -</td></tr> -<tr><td align="left" valign="top">• <a href="#tlmgr-shell">tlmgr shell</a></td><td> </td><td align="left" valign="top"> -</td></tr> -<tr><td align="left" valign="top">• <a href="#tlmgr-show">tlmgr show</a></td><td> </td><td align="left" valign="top"> -</td></tr> -<tr><td align="left" valign="top">• <a href="#tlmgr-uninstall">tlmgr uninstall</a></td><td> </td><td align="left" valign="top"> -</td></tr> -<tr><td align="left" valign="top">• <a href="#tlmgr-update-_005boption_002e_002e_002e_005d-_005bpkg_002e_002e_002e_005d">tlmgr update [<em>option</em>...] [<em>pkg</em>...]</a></td><td> </td><td align="left" valign="top"> -</td></tr> -</table> +<ul class="section-toc"> +<li><a href="#tlmgr-help" accesskey="1">help</a></li> +<li><a href="#tlmgr-version" accesskey="2">version</a></li> +<li><a href="#tlmgr-backup" accesskey="3">backup</a></li> +<li><a href="#tlmgr-candidates-pkg" accesskey="4">candidates <em>pkg</em></a></li> +<li><a href="#tlmgr-check-_005boption_002e_002e_002e_005d-_005bdepends_007cexecutes_007cfiles_007crunfiles_007ctexmfdbs_007call_005d" accesskey="5">check [<em>option</em>...] [depends|executes|files|runfiles|texmfdbs|all]</a></li> +<li><a href="#tlmgr-conf" accesskey="6">conf</a></li> +<li><a href="#tlmgr-dump_002dtlpdb-_005boption_002e_002e_002e_005d-_005b_002d_002djson_005d" accesskey="7">dump-tlpdb [<em>option</em>...] [–json]</a></li> +<li><a href="#tlmgr-generate" accesskey="8">generate</a></li> +<li><a href="#tlmgr-gui" accesskey="9">gui</a></li> +<li><a href="#tlmgr-info">info</a></li> +<li><a href="#tlmgr-init_002dusertree">init-usertree</a></li> +<li><a href="#tlmgr-install-_005boption_002e_002e_002e_005d-pkg_002e_002e_002e">install [<em>option</em>...] <em>pkg</em>...</a></li> +<li><a href="#tlmgr-key">key</a></li> +<li><a href="#tlmgr-list">list</a></li> +<li><a href="#tlmgr-option">option</a></li> +<li><a href="#tlmgr-paper">paper</a></li> +<li><a href="#tlmgr-path">path</a></li> +<li><a href="#tlmgr-pinning">pinning</a></li> +<li><a href="#tlmgr-platform">platform</a></li> +<li><a href="#tlmgr-postaction">postaction</a></li> +<li><a href="#tlmgr-print_002dplatform">print-platform</a></li> +<li><a href="#tlmgr-print_002dplatform_002dinfo">print-platform-info</a></li> +<li><a href="#tlmgr-remove-_005boption_002e_002e_002e_005d-pkg_002e_002e_002e">remove [<em>option</em>...] <em>pkg</em>...</a></li> +<li><a href="#tlmgr-repository">repository</a></li> +<li><a href="#tlmgr-restore">restore</a></li> +<li><a href="#tlmgr-search">search</a></li> +<li><a href="#tlmgr-shell">shell</a></li> +<li><a href="#tlmgr-show">show</a></li> +<li><a href="#tlmgr-uninstall">uninstall</a></li> +<li><a href="#tlmgr-update-_005boption_002e_002e_002e_005d-_005bpkg_002e_002e_002e_005d">update [<em>option</em>...] [<em>pkg</em>...]</a></li> +</ul> <hr> -<span id="tlmgr-help"></span><div class="header"> +<div class="appendixsubsec" id="tlmgr-help"> +<div class="header"> <p> -Next: <a href="#tlmgr-version" accesskey="n" rel="next">tlmgr version</a>, Up: <a href="#tlmgr-ACTIONS" accesskey="u" rel="up">tlmgr ACTIONS</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="#tlmgr-version" accesskey="n" rel="next">version</a>, Up: <a href="#tlmgr-ACTIONS" accesskey="u" rel="up">ACTIONS</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="help"></span><h4 class="appendixsubsec">B.6.1 help</h4> @@ -4375,9 +4415,11 @@ always be detected, but you can set the <code>NOPERLDOC</code> environment variable and <code>perldoc</code> will not be used. </p> <hr> -<span id="tlmgr-version"></span><div class="header"> +</div> +<div class="appendixsubsec" id="tlmgr-version"> +<div class="header"> <p> -Next: <a href="#tlmgr-backup" accesskey="n" rel="next">tlmgr backup</a>, Previous: <a href="#tlmgr-help" accesskey="p" rel="prev">tlmgr help</a>, Up: <a href="#tlmgr-ACTIONS" accesskey="u" rel="up">tlmgr ACTIONS</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="#tlmgr-backup" accesskey="n" rel="next">backup</a>, Previous: <a href="#tlmgr-help" accesskey="p" rel="prev">help</a>, Up: <a href="#tlmgr-ACTIONS" accesskey="u" rel="up">ACTIONS</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="version"></span><h4 class="appendixsubsec">B.6.2 version</h4> @@ -4386,17 +4428,19 @@ Next: <a href="#tlmgr-backup" accesskey="n" rel="next">tlmgr backup</a>, Previou <p>If <code>-v</code> has been given the revisions of the used modules are reported, too. </p> <hr> -<span id="tlmgr-backup"></span><div class="header"> +</div> +<div class="appendixsubsec" id="tlmgr-backup"> +<div class="header"> <p> -Next: <a href="#tlmgr-candidates-pkg" accesskey="n" rel="next">tlmgr candidates <em>pkg</em></a>, Previous: <a href="#tlmgr-version" accesskey="p" rel="prev">tlmgr version</a>, Up: <a href="#tlmgr-ACTIONS" accesskey="u" rel="up">tlmgr ACTIONS</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="#tlmgr-candidates-pkg" accesskey="n" rel="next">candidates <em>pkg</em></a>, Previous: <a href="#tlmgr-version" accesskey="p" rel="prev">version</a>, Up: <a href="#tlmgr-ACTIONS" accesskey="u" rel="up">ACTIONS</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="backup"></span><h4 class="appendixsubsec">B.6.3 backup</h4> <dl compact="compact"> -<dt><strong>backup [<em>option</em>...] –all</strong></dt> +<dt><span><strong>backup [<em>option</em>...] –all</strong></span></dt> <dd><span id="tlmgr-backup-_005boption_002e_002e_002e_005d-_002d_002dall"></span> </dd> -<dt><strong>backup [<em>option</em>...] <em>pkg</em>...</strong></dt> +<dt><span><strong>backup [<em>option</em>...] <em>pkg</em>...</strong></span></dt> <dd><span id="tlmgr-backup-_005boption_002e_002e_002e_005d-pkg_002e_002e_002e"></span> <p>If the <code>--clean</code> option is not specified, this action makes a backup of the given packages, or all packages given <code>--all</code>. These backups are @@ -4417,21 +4461,21 @@ the <code>option</code> action. <p>Options: </p> <dl compact="compact"> -<dt><strong>–backupdir</strong> <em>directory</em></dt> +<dt><span><strong>–backupdir</strong> <em>directory</em></span></dt> <dd><span id="tlmgr-_002d_002dbackupdir-directory"></span> <p>Overrides the <code>backupdir</code> option setting in the TLPDB. The <em>directory</em> argument is required and must specify an existing, writable directory where backups are to be placed. </p> </dd> -<dt><strong>–all</strong></dt> +<dt><span><strong>–all</strong></span></dt> <dd><span id="tlmgr-_002d_002dall"></span> <p>If <code>--clean</code> is not specified, make a backup of all packages in the TeX Live installation; this will take quite a lot of space and time. If <code>--clean</code> is specified, all packages are pruned. </p> </dd> -<dt><strong>–clean</strong>[=<em>N</em>]</dt> +<dt><span><strong>–clean</strong>[=<em>N</em>]</span></dt> <dd><span id="tlmgr-_002d_002dclean_005b_003dN_005d"></span> <p>Instead of making backups, prune the backup directory of old backups, as explained above. The optional integer argument <em>N</em> overrides the @@ -4439,7 +4483,7 @@ explained above. The optional integer argument <em>N</em> overrides the of packages together with this option, as desired. </p> </dd> -<dt><strong>–dry-run</strong></dt> +<dt><span><strong>–dry-run</strong></span></dt> <dd><span id="tlmgr-_002d_002ddry_002drun"></span> <p>Nothing is actually backed up or removed; instead, the actions to be performed are written to the terminal. @@ -4451,9 +4495,11 @@ performed are written to the terminal. </dl> <hr> -<span id="tlmgr-candidates-pkg"></span><div class="header"> +</div> +<div class="appendixsubsec" id="tlmgr-candidates-pkg"> +<div class="header"> <p> -Next: <a href="#tlmgr-check-_005boption_002e_002e_002e_005d-_005bdepends_007cexecutes_007cfiles_007crunfiles_007ctexmfdbs_007call_005d" accesskey="n" rel="next">tlmgr check [<em>option</em>...] [depends|executes|files|runfiles|texmfdbs|all]</a>, Previous: <a href="#tlmgr-backup" accesskey="p" rel="prev">tlmgr backup</a>, Up: <a href="#tlmgr-ACTIONS" accesskey="u" rel="up">tlmgr ACTIONS</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="#tlmgr-check-_005boption_002e_002e_002e_005d-_005bdepends_007cexecutes_007cfiles_007crunfiles_007ctexmfdbs_007call_005d" accesskey="n" rel="next">check [<em>option</em>...] [depends|executes|files|runfiles|texmfdbs|all]</a>, Previous: <a href="#tlmgr-backup" accesskey="p" rel="prev">backup</a>, Up: <a href="#tlmgr-ACTIONS" accesskey="u" rel="up">ACTIONS</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="candidates-pkg"></span><h4 class="appendixsubsec">B.6.4 candidates <em>pkg</em></h4> @@ -4461,9 +4507,11 @@ Next: <a href="#tlmgr-check-_005boption_002e_002e_002e_005d-_005bdepends_007cexe See <a href="#tlmgr-MULTIPLE-REPOSITORIES">MULTIPLE REPOSITORIES</a> below. </p> <hr> -<span id="tlmgr-check-_005boption_002e_002e_002e_005d-_005bdepends_007cexecutes_007cfiles_007crunfiles_007ctexmfdbs_007call_005d"></span><div class="header"> +</div> +<div class="appendixsubsec" id="tlmgr-check-_005boption_002e_002e_002e_005d-_005bdepends_007cexecutes_007cfiles_007crunfiles_007ctexmfdbs_007call_005d"> +<div class="header"> <p> -Next: <a href="#tlmgr-conf" accesskey="n" rel="next">tlmgr conf</a>, Previous: <a href="#tlmgr-candidates-pkg" accesskey="p" rel="prev">tlmgr candidates <em>pkg</em></a>, Up: <a href="#tlmgr-ACTIONS" accesskey="u" rel="up">tlmgr ACTIONS</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="#tlmgr-conf" accesskey="n" rel="next">conf</a>, Previous: <a href="#tlmgr-candidates-pkg" accesskey="p" rel="prev">candidates <em>pkg</em></a>, Up: <a href="#tlmgr-ACTIONS" accesskey="u" rel="up">ACTIONS</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="check-_005boption_002e_002e_002e_005d-_005bdepends_007cexecutes_007cfiles_007crunfiles_007ctexmfdbs_007call_005d"></span><h4 class="appendixsubsec">B.6.5 check [<em>option</em>...] [depends|executes|files|runfiles|texmfdbs|all]</h4> @@ -4472,7 +4520,7 @@ If no problems are found, there will be no output. (To get a view of what is being done, run <code>tlmgr -v check</code>.) </p> <dl compact="compact"> -<dt><strong>depends</strong></dt> +<dt><span><strong>depends</strong></span></dt> <dd><span id="tlmgr-depends"></span> <p>Lists those packages which occur as dependencies in an installed collection, but are themselves not installed, and those packages which are not @@ -4482,41 +4530,41 @@ contained in any collection. instead since former versions for <code>tlmgr</code> called it that way. </p> </dd> -<dt><strong>executes</strong></dt> +<dt><span><strong>executes</strong></span></dt> <dd><span id="tlmgr-executes"></span> <p>Check that the files referred to by <code>execute</code> directives in the TeX Live Database are present. </p> </dd> -<dt><strong>files</strong></dt> +<dt><span><strong>files</strong></span></dt> <dd><span id="tlmgr-files"></span> <p>Checks that all files listed in the local TLPDB (<code>texlive.tlpdb</code>) are actually present, and lists those missing. </p> </dd> -<dt><strong>runfiles</strong></dt> +<dt><span><strong>runfiles</strong></span></dt> <dd><span id="tlmgr-runfiles"></span> <p>List those filenames that are occurring more than one time in the runfiles sections, except for known duplicates. </p> </dd> -<dt><strong>texmfdbs</strong></dt> +<dt><span><strong>texmfdbs</strong></span></dt> <dd><span id="tlmgr-texmfdbs"></span> <p>Checks related to the <code>ls-R</code> files. If you have defined new trees, or changed the <code>TEXMF</code> or <code>TEXMFDBS</code> variables, it can’t hurt to run this. It checks that: </p> <dl compact="compact"> -<dt>- all items in <code>TEXMFDBS</code> have the <code>!!</code> prefix.</dt> +<dt><span>- all items in <code>TEXMFDBS</code> have the <code>!!</code> prefix.</span></dt> <dd><span id="tlmgr-_002d-all-items-in-TEXMFDBS-have-the-_0021_0021-prefix_002e"></span> </dd> -<dt>- all items in <code>TEXMFBDS</code> have an <code>ls-R</code> file (if they exist at all).</dt> +<dt><span>- all items in <code>TEXMFBDS</code> have an <code>ls-R</code> file (if they exist at all).</span></dt> <dd><span id="tlmgr-_002d-all-items-in-TEXMFBDS-have-an-ls_002dR-file-_0028if-they-exist-at-all_0029_002e"></span> </dd> -<dt>- all items in <code>TEXMF</code> with <code>!!</code> are listed in <code>TEXMFDBS</code>.</dt> +<dt><span>- all items in <code>TEXMF</code> with <code>!!</code> are listed in <code>TEXMFDBS</code>.</span></dt> <dd><span id="tlmgr-_002d-all-items-in-TEXMF-with-_0021_0021-are-listed-in-TEXMFDBS_002e"></span> </dd> -<dt>- all items in <code>TEXMF</code> with an <code>ls-R</code> file are listed in <code>TEXMFDBS</code>.</dt> +<dt><span>- all items in <code>TEXMF</code> with an <code>ls-R</code> file are listed in <code>TEXMFDBS</code>.</span></dt> <dd><span id="tlmgr-_002d-all-items-in-TEXMF-with-an-ls_002dR-file-are-listed-in-TEXMFDBS_002e"></span> </dd> </dl> @@ -4527,7 +4575,7 @@ this. It checks that: <p>Options: </p> <dl compact="compact"> -<dt><strong>–use-svn</strong></dt> +<dt><span><strong>–use-svn</strong></span></dt> <dd><span id="tlmgr-_002d_002duse_002dsvn"></span> <p>Use the output of <code>svn status</code> instead of listing the files; for checking the TL development repository. (This is run nightly.) @@ -4536,17 +4584,19 @@ checking the TL development repository. (This is run nightly.) </dl> <hr> -<span id="tlmgr-conf"></span><div class="header"> +</div> +<div class="appendixsubsec" id="tlmgr-conf"> +<div class="header"> <p> -Next: <a href="#tlmgr-dump_002dtlpdb-_005boption_002e_002e_002e_005d-_005b_002d_002djson_005d" accesskey="n" rel="next">tlmgr dump-tlpdb [<em>option</em>...] [--json]</a>, Previous: <a href="#tlmgr-check-_005boption_002e_002e_002e_005d-_005bdepends_007cexecutes_007cfiles_007crunfiles_007ctexmfdbs_007call_005d" accesskey="p" rel="prev">tlmgr check [<em>option</em>...] [depends|executes|files|runfiles|texmfdbs|all]</a>, Up: <a href="#tlmgr-ACTIONS" accesskey="u" rel="up">tlmgr ACTIONS</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="#tlmgr-dump_002dtlpdb-_005boption_002e_002e_002e_005d-_005b_002d_002djson_005d" accesskey="n" rel="next">dump-tlpdb [<em>option</em>...] [–json]</a>, Previous: <a href="#tlmgr-check-_005boption_002e_002e_002e_005d-_005bdepends_007cexecutes_007cfiles_007crunfiles_007ctexmfdbs_007call_005d" accesskey="p" rel="prev">check [<em>option</em>...] [depends|executes|files|runfiles|texmfdbs|all]</a>, Up: <a href="#tlmgr-ACTIONS" accesskey="u" rel="up">ACTIONS</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="conf"></span><h4 class="appendixsubsec">B.6.6 conf</h4> <dl compact="compact"> -<dt><strong>conf [texmf|tlmgr|updmap [–conffile <em>file</em>] [–delete] [<em>key</em> [<em>value</em>]]]</strong></dt> +<dt><span><strong>conf [texmf|tlmgr|updmap [–conffile <em>file</em>] [–delete] [<em>key</em> [<em>value</em>]]]</strong></span></dt> <dd><span id="tlmgr-conf-_005btexmf_007ctlmgr_007cupdmap-_005b_002d_002dconffile-file_005d-_005b_002d_002ddelete_005d-_005bkey-_005bvalue_005d_005d_005d"></span> </dd> -<dt><strong>conf auxtrees [–conffile <em>file</em>] [show|add|remove] [<em>value</em>]</strong></dt> +<dt><span><strong>conf auxtrees [–conffile <em>file</em>] [show|add|remove] [<em>value</em>]</strong></span></dt> <dd><span id="tlmgr-conf-auxtrees-_005b_002d_002dconffile-file_005d-_005bshow_007cadd_007cremove_005d-_005bvalue_005d"></span> <p>With only <code>conf</code>, show general configuration information for TeX Live, including active configuration files, path settings, and more. This is @@ -4600,9 +4650,11 @@ breakage is possible. </dl> <hr> -<span id="tlmgr-dump_002dtlpdb-_005boption_002e_002e_002e_005d-_005b_002d_002djson_005d"></span><div class="header"> +</div> +<div class="appendixsubsec" id="tlmgr-dump_002dtlpdb-_005boption_002e_002e_002e_005d-_005b_002d_002djson_005d"> +<div class="header"> <p> -Next: <a href="#tlmgr-generate" accesskey="n" rel="next">tlmgr generate</a>, Previous: <a href="#tlmgr-conf" accesskey="p" rel="prev">tlmgr conf</a>, Up: <a href="#tlmgr-ACTIONS" accesskey="u" rel="up">tlmgr ACTIONS</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="#tlmgr-generate" accesskey="n" rel="next">generate</a>, Previous: <a href="#tlmgr-conf" accesskey="p" rel="prev">conf</a>, Up: <a href="#tlmgr-ACTIONS" accesskey="u" rel="up">ACTIONS</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="dump_002dtlpdb-_005boption_002e_002e_002e_005d-_005b_002d_002djson_005d"></span><h4 class="appendixsubsec">B.6.7 dump-tlpdb [<em>option</em>...] [–json]</h4> @@ -4613,17 +4665,17 @@ output is analogous to the <code>--machine-readable</code> output; see <p>Options: </p> <dl compact="compact"> -<dt><strong>–local</strong></dt> +<dt><span><strong>–local</strong></span></dt> <dd><span id="tlmgr-_002d_002dlocal"></span> <p>Dump the local TLPDB. </p> </dd> -<dt><strong>–remote</strong></dt> +<dt><span><strong>–remote</strong></span></dt> <dd><span id="tlmgr-_002d_002dremote"></span> <p>Dump the remote TLPDB. </p> </dd> -<dt><strong>–json</strong></dt> +<dt><span><strong>–json</strong></span></dt> <dd><span id="tlmgr-_002d_002djson"></span> <p>Instead of dumping the actual content, the database is dumped as JSON. For the format of JSON output see <code>tlpkg/doc/JSON-formats.txt</code>, @@ -4645,23 +4697,25 @@ location, in this format: <p>Line endings may be either LF or CRLF depending on the current platform. </p> <hr> -<span id="tlmgr-generate"></span><div class="header"> +</div> +<div class="appendixsubsec" id="tlmgr-generate"> +<div class="header"> <p> -Next: <a href="#tlmgr-gui" accesskey="n" rel="next">tlmgr gui</a>, Previous: <a href="#tlmgr-dump_002dtlpdb-_005boption_002e_002e_002e_005d-_005b_002d_002djson_005d" accesskey="p" rel="prev">tlmgr dump-tlpdb [<em>option</em>...] [--json]</a>, Up: <a href="#tlmgr-ACTIONS" accesskey="u" rel="up">tlmgr ACTIONS</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="#tlmgr-gui" accesskey="n" rel="next">gui</a>, Previous: <a href="#tlmgr-dump_002dtlpdb-_005boption_002e_002e_002e_005d-_005b_002d_002djson_005d" accesskey="p" rel="prev">dump-tlpdb [<em>option</em>...] [–json]</a>, Up: <a href="#tlmgr-ACTIONS" accesskey="u" rel="up">ACTIONS</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="generate"></span><h4 class="appendixsubsec">B.6.8 generate</h4> <dl compact="compact"> -<dt><strong>generate [<em>option</em>...] language</strong></dt> +<dt><span><strong>generate [<em>option</em>...] language</strong></span></dt> <dd><span id="tlmgr-generate-_005boption_002e_002e_002e_005d-language"></span> </dd> -<dt><strong>generate [<em>option</em>...] language.dat</strong></dt> +<dt><span><strong>generate [<em>option</em>...] language.dat</strong></span></dt> <dd><span id="tlmgr-generate-_005boption_002e_002e_002e_005d-language_002edat"></span> </dd> -<dt><strong>generate [<em>option</em>...] language.def</strong></dt> +<dt><span><strong>generate [<em>option</em>...] language.def</strong></span></dt> <dd><span id="tlmgr-generate-_005boption_002e_002e_002e_005d-language_002edef"></span> </dd> -<dt><strong>generate [<em>option</em>...] language.dat.lua</strong></dt> +<dt><span><strong>generate [<em>option</em>...] language.dat.lua</strong></span></dt> <dd><span id="tlmgr-generate-_005boption_002e_002e_002e_005d-language_002edat_002elua"></span> </dd> </dl> @@ -4726,7 +4780,7 @@ extension recreates only that given language file. <p>Options: </p> <dl compact="compact"> -<dt><strong>–dest</strong> <em>output_file</em></dt> +<dt><span><strong>–dest</strong> <em>output_file</em></span></dt> <dd><span id="tlmgr-_002d_002ddest-output_005ffile"></span> <p>specifies the output file (defaults to the respective location in <code>TEXMFSYSVAR</code>). If <code>--dest</code> is given to <code>generate language</code>, it @@ -4738,13 +4792,13 @@ overwriting; if you want a specific name for each output file, we recommend invoking <code>tlmgr</code> twice.) </p> </dd> -<dt><strong>–localcfg</strong> <em>local_conf_file</em></dt> +<dt><span><strong>–localcfg</strong> <em>local_conf_file</em></span></dt> <dd><span id="tlmgr-_002d_002dlocalcfg-local_005fconf_005ffile"></span> <p>specifies the (optional) local additions (defaults to the respective location in <code>TEXMFLOCAL</code>). </p> </dd> -<dt><strong>–rebuild-sys</strong></dt> +<dt><span><strong>–rebuild-sys</strong></span></dt> <dd><span id="tlmgr-_002d_002drebuild_002dsys"></span> <p>tells <code>tlmgr</code> to run necessary programs after config files have been regenerated. These are: @@ -4768,29 +4822,33 @@ succession before invoking these programs. tex/generic/config/language.dat.lua (and language-local.dat.lua) </pre> <hr> -<span id="tlmgr-gui"></span><div class="header"> +</div> +<div class="appendixsubsec" id="tlmgr-gui"> +<div class="header"> <p> -Next: <a href="#tlmgr-info" accesskey="n" rel="next">tlmgr info</a>, Previous: <a href="#tlmgr-generate" accesskey="p" rel="prev">tlmgr generate</a>, Up: <a href="#tlmgr-ACTIONS" accesskey="u" rel="up">tlmgr ACTIONS</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="#tlmgr-info" accesskey="n" rel="next">info</a>, Previous: <a href="#tlmgr-generate" accesskey="p" rel="prev">generate</a>, Up: <a href="#tlmgr-ACTIONS" accesskey="u" rel="up">ACTIONS</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="gui"></span><h4 class="appendixsubsec">B.6.9 gui</h4> <p>Start the graphical user interface. See <strong>GUI</strong> below. </p> <hr> -<span id="tlmgr-info"></span><div class="header"> +</div> +<div class="appendixsubsec" id="tlmgr-info"> +<div class="header"> <p> -Next: <a href="#tlmgr-init_002dusertree" accesskey="n" rel="next">tlmgr init-usertree</a>, Previous: <a href="#tlmgr-gui" accesskey="p" rel="prev">tlmgr gui</a>, Up: <a href="#tlmgr-ACTIONS" accesskey="u" rel="up">tlmgr ACTIONS</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="#tlmgr-init_002dusertree" accesskey="n" rel="next">init-usertree</a>, Previous: <a href="#tlmgr-gui" accesskey="p" rel="prev">gui</a>, Up: <a href="#tlmgr-ACTIONS" accesskey="u" rel="up">ACTIONS</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="info"></span><h4 class="appendixsubsec">B.6.10 info</h4> <dl compact="compact"> -<dt><strong>info [<em>option</em>...] <em>pkg</em>...</strong></dt> +<dt><span><strong>info [<em>option</em>...] <em>pkg</em>...</strong></span></dt> <dd><span id="tlmgr-info-_005boption_002e_002e_002e_005d-pkg_002e_002e_002e"></span> </dd> -<dt><strong>info [<em>option</em>...] collections</strong></dt> +<dt><span><strong>info [<em>option</em>...] collections</strong></span></dt> <dd><span id="tlmgr-info-_005boption_002e_002e_002e_005d-collections"></span> </dd> -<dt><strong>info [<em>option</em>...] schemes</strong></dt> +<dt><span><strong>info [<em>option</em>...] schemes</strong></span></dt> <dd><span id="tlmgr-info-_005boption_002e_002e_002e_005d-schemes"></span> <p>With no argument, lists all packages available at the package repository, prefixing those already installed with <code>i</code>. @@ -4825,7 +4883,7 @@ but are still supported for backward compatibility. <p>Options: </p> <dl compact="compact"> -<dt><strong>–list</strong></dt> +<dt><span><strong>–list</strong></span></dt> <dd><span id="tlmgr-_002d_002dlist"></span> <p>If the option <code>--list</code> is given with a package, the list of contained files is also shown, including those for platform-specific dependencies. @@ -4833,13 +4891,13 @@ When given with schemes and collections, <code>--list</code> outputs their dependencies in a similar way. </p> </dd> -<dt><strong>–only-installed</strong></dt> +<dt><span><strong>–only-installed</strong></span></dt> <dd><span id="tlmgr-_002d_002donly_002dinstalled"></span> <p>If this option is given, the installation source will not be used; only locally installed packages, collections, or schemes are listed. </p> </dd> -<dt><strong>–only-remote</strong></dt> +<dt><span><strong>–only-remote</strong></span></dt> <dd><span id="tlmgr-_002d_002donly_002dremote"></span> <p>Only list packages from the remote repository. Useful when checking what is available in a remote repository using @@ -4847,10 +4905,10 @@ is available in a remote repository using <code>--only-installed</code> and <code>--only-remote</code> cannot both be specified. </p> </dd> -<dt><strong>–data <code>item1,item2,...</code></strong></dt> +<dt><span><strong>–data <code>item1,item2,...</code></strong></span></dt> <dd><span id="tlmgr-_002d_002ddata-item1_002citem2_002c_002e_002e_002e"></span> -<p>If the option <code>--data</code> is given, its argument must be a comma separated -list of field names from: <code>name</code>, <code>category</code>, <code>localrev</code>, +<p>If the option <code>--data</code> is given, its argument must be a comma or colon +separated list of field names from: <code>name</code>, <code>category</code>, <code>localrev</code>, <code>remoterev</code>, <code>shortdesc</code>, <code>longdesc</code>, <code>installed</code>, <code>size</code>, <code>relocatable</code>, <code>depends</code>, <code>cat-version</code>, <code>cat-date</code>, <code>cat-license</code>, plus various <code>cat-contact-*</code> fields (see below). @@ -4873,7 +4931,7 @@ may be empty or a url value. A brief description is on the CTAN upload page for new packages: <a href="https://ctan.org/upload">https://ctan.org/upload</a>. </p> </dd> -<dt><strong>–json</strong></dt> +<dt><span><strong>–json</strong></span></dt> <dd><span id="tlmgr-_002d_002djson-1"></span> <p>In case <code>--json</code> is specified, the output is a JSON encoded array where each array element is the JSON representation of a single <code>TLPOBJ</code> but @@ -4888,9 +4946,11 @@ with additional information. For details see </dl> <hr> -<span id="tlmgr-init_002dusertree"></span><div class="header"> +</div> +<div class="appendixsubsec" id="tlmgr-init_002dusertree"> +<div class="header"> <p> -Next: <a href="#tlmgr-install-_005boption_002e_002e_002e_005d-pkg_002e_002e_002e" accesskey="n" rel="next">tlmgr install [<em>option</em>...] <em>pkg</em>...</a>, Previous: <a href="#tlmgr-info" accesskey="p" rel="prev">tlmgr info</a>, Up: <a href="#tlmgr-ACTIONS" accesskey="u" rel="up">tlmgr ACTIONS</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="#tlmgr-install-_005boption_002e_002e_002e_005d-pkg_002e_002e_002e" accesskey="n" rel="next">install [<em>option</em>...] <em>pkg</em>...</a>, Previous: <a href="#tlmgr-info" accesskey="p" rel="prev">info</a>, Up: <a href="#tlmgr-ACTIONS" accesskey="u" rel="up">ACTIONS</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="init_002dusertree"></span><h4 class="appendixsubsec">B.6.11 init-usertree</h4> @@ -4899,9 +4959,11 @@ default user tree (<code>TEXMFHOME</code>), or one specified on the command line with <code>--usertree</code>. See <a href="#tlmgr-USER-MODE">USER MODE</a> below. </p> <hr> -<span id="tlmgr-install-_005boption_002e_002e_002e_005d-pkg_002e_002e_002e"></span><div class="header"> +</div> +<div class="appendixsubsec" id="tlmgr-install-_005boption_002e_002e_002e_005d-pkg_002e_002e_002e"> +<div class="header"> <p> -Next: <a href="#tlmgr-key" accesskey="n" rel="next">tlmgr key</a>, Previous: <a href="#tlmgr-init_002dusertree" accesskey="p" rel="prev">tlmgr init-usertree</a>, Up: <a href="#tlmgr-ACTIONS" accesskey="u" rel="up">tlmgr ACTIONS</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="#tlmgr-key" accesskey="n" rel="next">key</a>, Previous: <a href="#tlmgr-init_002dusertree" accesskey="p" rel="prev">init-usertree</a>, Up: <a href="#tlmgr-ACTIONS" accesskey="u" rel="up">ACTIONS</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="install-_005boption_002e_002e_002e_005d-pkg_002e_002e_002e"></span><h4 class="appendixsubsec">B.6.12 install [<em>option</em>...] <em>pkg</em>...</h4> @@ -4913,33 +4975,33 @@ action for how to get the latest version of a package. dependent. Options: </p> <dl compact="compact"> -<dt><strong>–dry-run</strong></dt> +<dt><span><strong>–dry-run</strong></span></dt> <dd><span id="tlmgr-_002d_002ddry_002drun-1"></span> <p>Nothing is actually installed; instead, the actions to be performed are written to the terminal. </p> </dd> -<dt><strong>–file</strong></dt> +<dt><span><strong>–file</strong></span></dt> <dd><span id="tlmgr-_002d_002dfile"></span> <p>Instead of fetching a package from the installation repository, use the package files given on the command line. These files must be standard TeX Live package files (with contained tlpobj file). </p> </dd> -<dt><strong>–force</strong></dt> +<dt><span><strong>–force</strong></span></dt> <dd><span id="tlmgr-_002d_002dforce"></span> <p>If updates to <code>tlmgr</code> itself (or other parts of the basic infrastructure) are present, <code>tlmgr</code> will bail out and not perform the installation unless this option is given. Not recommended. </p> </dd> -<dt><strong>–no-depends</strong></dt> +<dt><span><strong>–no-depends</strong></span></dt> <dd><span id="tlmgr-_002d_002dno_002ddepends"></span> <p>Do not install dependencies. (By default, installing a package ensures that all dependencies of this package are fulfilled.) </p> </dd> -<dt><strong>–no-depends-at-all</strong></dt> +<dt><span><strong>–no-depends-at-all</strong></span></dt> <dd><span id="tlmgr-_002d_002dno_002ddepends_002dat_002dall"></span> <p>Normally, when you install a package which ships binary files the respective binary package will also be installed. That is, for a @@ -4949,7 +5011,7 @@ implies <code>--no-depends</code>. Don’t use it unless you are sure of wh are doing. </p> </dd> -<dt><strong>–reinstall</strong></dt> +<dt><span><strong>–reinstall</strong></span></dt> <dd><span id="tlmgr-_002d_002dreinstall"></span> <p>Reinstall a package (including dependencies for collections) even if it already seems to be installed (i.e, is present in the TLPDB). This is @@ -4959,10 +5021,10 @@ useful to recover from accidental removal of files in the hierarchy. (i.e., not those of category Scheme or Collection). </p> </dd> -<dt><strong>–with-doc</strong></dt> +<dt><span><strong>–with-doc</strong></span></dt> <dd><span id="tlmgr-_002d_002dwith_002ddoc"></span> </dd> -<dt><strong>–with-src</strong></dt> +<dt><span><strong>–with-src</strong></span></dt> <dd><span id="tlmgr-_002d_002dwith_002dsrc"></span> <p>While not recommended, the <code>install-tl</code> program provides an option to omit installation of all documentation and/or source files. (By @@ -4981,20 +5043,22 @@ directories; you need to run <code>tlmgr path add</code> (<a href="#tlmgr-path"> you are using this feature and want new symlinks added. </p> <hr> -<span id="tlmgr-key"></span><div class="header"> +</div> +<div class="appendixsubsec" id="tlmgr-key"> +<div class="header"> <p> -Next: <a href="#tlmgr-list" accesskey="n" rel="next">tlmgr list</a>, Previous: <a href="#tlmgr-install-_005boption_002e_002e_002e_005d-pkg_002e_002e_002e" accesskey="p" rel="prev">tlmgr install [<em>option</em>...] <em>pkg</em>...</a>, Up: <a href="#tlmgr-ACTIONS" accesskey="u" rel="up">tlmgr ACTIONS</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="#tlmgr-list" accesskey="n" rel="next">list</a>, Previous: <a href="#tlmgr-install-_005boption_002e_002e_002e_005d-pkg_002e_002e_002e" accesskey="p" rel="prev">install [<em>option</em>...] <em>pkg</em>...</a>, Up: <a href="#tlmgr-ACTIONS" accesskey="u" rel="up">ACTIONS</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="key"></span><h4 class="appendixsubsec">B.6.13 key</h4> <dl compact="compact"> -<dt><strong>key list</strong></dt> +<dt><span><strong>key list</strong></span></dt> <dd><span id="tlmgr-key-list"></span> </dd> -<dt><strong>key add <em>file</em></strong></dt> +<dt><span><strong>key add <em>file</em></strong></span></dt> <dd><span id="tlmgr-key-add-file"></span> </dd> -<dt><strong>key remove <em>keyid</em></strong></dt> +<dt><span><strong>key remove <em>keyid</em></strong></span></dt> <dd><span id="tlmgr-key-remove-keyid"></span> <p>The action <code>key</code> allows listing, adding and removing additional GPG keys to the set of trusted keys, that is, those that are used to verify @@ -5014,29 +5078,33 @@ from the local keyring. </dl> <hr> -<span id="tlmgr-list"></span><div class="header"> +</div> +<div class="appendixsubsec" id="tlmgr-list"> +<div class="header"> <p> -Next: <a href="#tlmgr-option" accesskey="n" rel="next">tlmgr option</a>, Previous: <a href="#tlmgr-key" accesskey="p" rel="prev">tlmgr key</a>, Up: <a href="#tlmgr-ACTIONS" accesskey="u" rel="up">tlmgr ACTIONS</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="#tlmgr-option" accesskey="n" rel="next">option</a>, Previous: <a href="#tlmgr-key" accesskey="p" rel="prev">key</a>, Up: <a href="#tlmgr-ACTIONS" accesskey="u" rel="up">ACTIONS</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="list"></span><h4 class="appendixsubsec">B.6.14 list</h4> <p>Synonym for <a href="#tlmgr-info">info</a>. </p> <hr> -<span id="tlmgr-option"></span><div class="header"> +</div> +<div class="appendixsubsec" id="tlmgr-option"> +<div class="header"> <p> -Next: <a href="#tlmgr-paper" accesskey="n" rel="next">tlmgr paper</a>, Previous: <a href="#tlmgr-list" accesskey="p" rel="prev">tlmgr list</a>, Up: <a href="#tlmgr-ACTIONS" accesskey="u" rel="up">tlmgr ACTIONS</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="#tlmgr-paper" accesskey="n" rel="next">paper</a>, Previous: <a href="#tlmgr-list" accesskey="p" rel="prev">list</a>, Up: <a href="#tlmgr-ACTIONS" accesskey="u" rel="up">ACTIONS</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="option"></span><h4 class="appendixsubsec">B.6.15 option</h4> <dl compact="compact"> -<dt><strong>option [–json] [show]</strong></dt> +<dt><span><strong>option [–json] [show]</strong></span></dt> <dd><span id="tlmgr-option-_005b_002d_002djson_005d-_005bshow_005d"></span> </dd> -<dt><strong>option [–json] showall|help</strong></dt> +<dt><span><strong>option [–json] showall|help</strong></span></dt> <dd><span id="tlmgr-option-_005b_002d_002djson_005d-showall_007chelp"></span> </dd> -<dt><strong>option <em>key</em> [<em>value</em>]</strong></dt> +<dt><span><strong>option <em>key</em> [<em>value</em>]</strong></span></dt> <dd><span id="tlmgr-option-key-_005bvalue_005d"></span> </dd> </dl> @@ -5079,7 +5147,7 @@ the definitive list): get further updates from the Internet, after originally installing from DVD. To do this, you can run </p> -<pre class="verbatim"> tlmgr option repository http://mirror.ctan.org/systems/texlive/tlnet +<pre class="verbatim"> tlmgr option repository https://mirror.ctan.org/systems/texlive/tlnet </pre> <p>The <code>install-tl</code> documentation has more information about the possible values for <code>repository</code>. (For backward compatibility, <code>location</code> can @@ -5137,20 +5205,22 @@ to the registry and the menus are done for all users on the system instead of only the current user. All three options are on by default. </p> <hr> -<span id="tlmgr-paper"></span><div class="header"> +</div> +<div class="appendixsubsec" id="tlmgr-paper"> +<div class="header"> <p> -Next: <a href="#tlmgr-path" accesskey="n" rel="next">tlmgr path</a>, Previous: <a href="#tlmgr-option" accesskey="p" rel="prev">tlmgr option</a>, Up: <a href="#tlmgr-ACTIONS" accesskey="u" rel="up">tlmgr ACTIONS</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="#tlmgr-path" accesskey="n" rel="next">path</a>, Previous: <a href="#tlmgr-option" accesskey="p" rel="prev">option</a>, Up: <a href="#tlmgr-ACTIONS" accesskey="u" rel="up">ACTIONS</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"></span><h4 class="appendixsubsec">B.6.16 paper</h4> <dl compact="compact"> -<dt><strong>paper [a4|letter]</strong></dt> +<dt><span><strong>paper [a4|letter]</strong></span></dt> <dd><span id="tlmgr-paper-_005ba4_007cletter_005d"></span> </dd> -<dt><strong><[xdvi|pdftex|dvips|dvipdfmx|context|psutils] paper [<em>papersize</em>|–list]</strong>></dt> +<dt><span><strong><[xdvi|pdftex|dvips|dvipdfmx|context|psutils] paper [<em>papersize</em>|–list]</strong>></span></dt> <dd><span id="tlmgr-_003c_005bxdvi_007cpdftex_007cdvips_007cdvipdfmx_007ccontext_007cpsutils_005d-paper-_005bpapersize_007c_002d_002dlist_005d_003e"></span> </dd> -<dt><strong>paper –json</strong></dt> +<dt><span><strong>paper –json</strong></span></dt> <dd><span id="tlmgr-paper-_002d_002djson"></span> </dd> </dl> @@ -5184,17 +5254,19 @@ some programs, notably <code>dvips</code>. <code>tlmgr</code> does not support settings. </p> <hr> -<span id="tlmgr-path"></span><div class="header"> +</div> +<div class="appendixsubsec" id="tlmgr-path"> +<div class="header"> <p> -Next: <a href="#tlmgr-pinning" accesskey="n" rel="next">tlmgr pinning</a>, Previous: <a href="#tlmgr-paper" accesskey="p" rel="prev">tlmgr paper</a>, Up: <a href="#tlmgr-ACTIONS" accesskey="u" rel="up">tlmgr ACTIONS</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="#tlmgr-pinning" accesskey="n" rel="next">pinning</a>, Previous: <a href="#tlmgr-paper" accesskey="p" rel="prev">paper</a>, Up: <a href="#tlmgr-ACTIONS" accesskey="u" rel="up">ACTIONS</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"></span><h4 class="appendixsubsec">B.6.17 path</h4> <dl compact="compact"> -<dt><strong>path [–w32mode=user|admin] add</strong></dt> +<dt><span><strong>path [–w32mode=user|admin] add</strong></span></dt> <dd><span id="tlmgr-path-_005b_002d_002dw32mode_003duser_007cadmin_005d-add"></span> </dd> -<dt><strong>path [–w32mode=user|admin] remove</strong></dt> +<dt><span><strong>path [–w32mode=user|admin] remove</strong></span></dt> <dd><span id="tlmgr-path-_005b_002d_002dw32mode_003duser_007cadmin_005d-remove"></span> <p>On Unix, adds or removes symlinks for executables, man pages, and info pages in the system directories specified by the respective options (see @@ -5227,33 +5299,35 @@ is issued that the caller does not have enough privileges. </dl> <hr> -<span id="tlmgr-pinning"></span><div class="header"> +</div> +<div class="appendixsubsec" id="tlmgr-pinning"> +<div class="header"> <p> -Next: <a href="#tlmgr-platform" accesskey="n" rel="next">tlmgr platform</a>, Previous: <a href="#tlmgr-path" accesskey="p" rel="prev">tlmgr path</a>, Up: <a href="#tlmgr-ACTIONS" accesskey="u" rel="up">tlmgr ACTIONS</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="#tlmgr-platform" accesskey="n" rel="next">platform</a>, Previous: <a href="#tlmgr-path" accesskey="p" rel="prev">path</a>, Up: <a href="#tlmgr-ACTIONS" accesskey="u" rel="up">ACTIONS</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="pinning"></span><h4 class="appendixsubsec">B.6.18 pinning</h4> <p>The <code>pinning</code> action manages the pinning file, see <a href="#tlmgr-Pinning">Pinning</a> below. </p> <dl compact="compact"> -<dt><code>pinning show</code></dt> +<dt><span><code>pinning show</code></span></dt> <dd><span id="tlmgr-pinning-show"></span> <p>Shows the current pinning data. </p> </dd> -<dt><code>pinning add</code> <em>repo</em> <em>pkgglob</em>...</dt> +<dt><span><code>pinning add</code> <em>repo</em> <em>pkgglob</em>...</span></dt> <dd><span id="tlmgr-pinning-add-repo-pkgglob_002e_002e_002e"></span> <p>Pins the packages matching the <em>pkgglob</em>(s) to the repository <em>repo</em>. </p> </dd> -<dt><code>pinning remove</code> <em>repo</em> <em>pkgglob</em>...</dt> +<dt><span><code>pinning remove</code> <em>repo</em> <em>pkgglob</em>...</span></dt> <dd><span id="tlmgr-pinning-remove-repo-pkgglob_002e_002e_002e"></span> <p>Any packages recorded in the pinning file matching the <pkgglob>s for the given repository <em>repo</em> are removed. </p> </dd> -<dt><code>pinning remove <em>repo</em> --all</code></dt> +<dt><span><code>pinning remove <em>repo</em> --all</code></span></dt> <dd><span id="tlmgr-pinning-remove-repo-_002d_002dall"></span> <p>Remove all pinning data for repository <em>repo</em>. </p> @@ -5261,20 +5335,22 @@ the given repository <em>repo</em> are removed. </dl> <hr> -<span id="tlmgr-platform"></span><div class="header"> +</div> +<div class="appendixsubsec" id="tlmgr-platform"> +<div class="header"> <p> -Next: <a href="#tlmgr-postaction" accesskey="n" rel="next">tlmgr postaction</a>, Previous: <a href="#tlmgr-pinning" accesskey="p" rel="prev">tlmgr pinning</a>, Up: <a href="#tlmgr-ACTIONS" accesskey="u" rel="up">tlmgr ACTIONS</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="#tlmgr-postaction" accesskey="n" rel="next">postaction</a>, Previous: <a href="#tlmgr-pinning" accesskey="p" rel="prev">pinning</a>, Up: <a href="#tlmgr-ACTIONS" accesskey="u" rel="up">ACTIONS</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="platform"></span><h4 class="appendixsubsec">B.6.19 platform</h4> <dl compact="compact"> -<dt><strong>platform list|add|remove <em>platform</em>...</strong></dt> +<dt><span><strong>platform list|add|remove <em>platform</em>...</strong></span></dt> <dd><span id="tlmgr-platform-list_007cadd_007cremove-platform_002e_002e_002e"></span> </dd> -<dt><strong>platform set <em>platform</em></strong></dt> +<dt><span><strong>platform set <em>platform</em></strong></span></dt> <dd><span id="tlmgr-platform-set-platform"></span> </dd> -<dt><strong>platform set auto</strong></dt> +<dt><span><strong>platform set auto</strong></span></dt> <dd><span id="tlmgr-platform-set-auto"></span> <p><code>platform list</code> lists the TeX Live names of all the platforms (a.k.a. architectures), (<code>i386-linux</code>, ...) available at the package @@ -5300,7 +5376,7 @@ platform instead of auto detection. <p>Options: </p> <dl compact="compact"> -<dt><strong>–dry-run</strong></dt> +<dt><span><strong>–dry-run</strong></span></dt> <dd><span id="tlmgr-_002d_002ddry_002drun-2"></span> <p>Nothing is actually installed; instead, the actions to be performed are written to the terminal. @@ -5312,17 +5388,19 @@ written to the terminal. </dl> <hr> -<span id="tlmgr-postaction"></span><div class="header"> +</div> +<div class="appendixsubsec" id="tlmgr-postaction"> +<div class="header"> <p> -Next: <a href="#tlmgr-print_002dplatform" accesskey="n" rel="next">tlmgr print-platform</a>, Previous: <a href="#tlmgr-platform" accesskey="p" rel="prev">tlmgr platform</a>, Up: <a href="#tlmgr-ACTIONS" accesskey="u" rel="up">tlmgr ACTIONS</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="#tlmgr-print_002dplatform" accesskey="n" rel="next">print-platform</a>, Previous: <a href="#tlmgr-platform" accesskey="p" rel="prev">platform</a>, Up: <a href="#tlmgr-ACTIONS" accesskey="u" rel="up">ACTIONS</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="postaction"></span><h4 class="appendixsubsec">B.6.20 postaction</h4> <dl compact="compact"> -<dt><strong>postaction [<em>option</em>...] install [shortcut|fileassoc|script] [<em>pkg</em>...]</strong></dt> +<dt><span><strong>postaction [<em>option</em>...] install [shortcut|fileassoc|script] [<em>pkg</em>...]</strong></span></dt> <dd><span id="tlmgr-postaction-_005boption_002e_002e_002e_005d-install-_005bshortcut_007cfileassoc_007cscript_005d-_005bpkg_002e_002e_002e_005d"></span> </dd> -<dt><strong>postaction [<em>option</em>...] remove [shortcut|fileassoc|script] [<em>pkg</em>...]</strong></dt> +<dt><span><strong>postaction [<em>option</em>...] remove [shortcut|fileassoc|script] [<em>pkg</em>...]</strong></span></dt> <dd><span id="tlmgr-postaction-_005boption_002e_002e_002e_005d-remove-_005bshortcut_007cfileassoc_007cscript_005d-_005bpkg_002e_002e_002e_005d"></span> <p>Carry out the postaction <code>shortcut</code>, <code>fileassoc</code>, or <code>script</code> given as the second required argument in install or remove mode (which is the @@ -5332,7 +5410,7 @@ line, or for all if <code>--all</code> is given. <p>Options: </p> <dl compact="compact"> -<dt><strong>–w32mode=[user|admin]</strong></dt> +<dt><span><strong>–w32mode=[user|admin]</strong></span></dt> <dd><span id="tlmgr-_002d_002dw32mode_003d_005buser_007cadmin_005d"></span> <p>If the option <code>--w32mode</code> is given the value <code>user</code>, all actions will only be carried out in the user-accessible parts of the @@ -5341,7 +5419,7 @@ parts of the registry for the file associations. If you do not have enough permissions, using <code>--w32mode=admin</code> will not succeed. </p> </dd> -<dt><strong>–fileassocmode=[1|2]</strong></dt> +<dt><span><strong>–fileassocmode=[1|2]</strong></span></dt> <dd><span id="tlmgr-_002d_002dfileassocmode_003d_005b1_007c2_005d"></span> <p><code>--fileassocmode</code> specifies the action for file associations. If it is set to 1 (the default), only new associations are added; if it is set to @@ -5349,7 +5427,7 @@ set to 1 (the default), only new associations are added; if it is set to <code>option fileassocs</code>.) </p> </dd> -<dt><strong>–all</strong></dt> +<dt><span><strong>–all</strong></span></dt> <dd><span id="tlmgr-_002d_002dall-1"></span> <p>Carry out the postactions for all packages </p> @@ -5360,9 +5438,11 @@ set to 1 (the default), only new associations are added; if it is set to </dl> <hr> -<span id="tlmgr-print_002dplatform"></span><div class="header"> +</div> +<div class="appendixsubsec" id="tlmgr-print_002dplatform"> +<div class="header"> <p> -Next: <a href="#tlmgr-print_002dplatform_002dinfo" accesskey="n" rel="next">tlmgr print-platform-info</a>, Previous: <a href="#tlmgr-postaction" accesskey="p" rel="prev">tlmgr postaction</a>, Up: <a href="#tlmgr-ACTIONS" accesskey="u" rel="up">tlmgr ACTIONS</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="#tlmgr-print_002dplatform_002dinfo" accesskey="n" rel="next">print-platform-info</a>, Previous: <a href="#tlmgr-postaction" accesskey="p" rel="prev">postaction</a>, Up: <a href="#tlmgr-ACTIONS" accesskey="u" rel="up">ACTIONS</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="print_002dplatform"></span><h4 class="appendixsubsec">B.6.21 print-platform</h4> @@ -5371,9 +5451,11 @@ Next: <a href="#tlmgr-print_002dplatform_002dinfo" accesskey="n" rel="next">tlmg <code>--print-arch</code> is a synonym. </p> <hr> -<span id="tlmgr-print_002dplatform_002dinfo"></span><div class="header"> +</div> +<div class="appendixsubsec" id="tlmgr-print_002dplatform_002dinfo"> +<div class="header"> <p> -Next: <a href="#tlmgr-remove-_005boption_002e_002e_002e_005d-pkg_002e_002e_002e" accesskey="n" rel="next">tlmgr remove [<em>option</em>...] <em>pkg</em>...</a>, Previous: <a href="#tlmgr-print_002dplatform" accesskey="p" rel="prev">tlmgr print-platform</a>, Up: <a href="#tlmgr-ACTIONS" accesskey="u" rel="up">tlmgr ACTIONS</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="#tlmgr-remove-_005boption_002e_002e_002e_005d-pkg_002e_002e_002e" accesskey="n" rel="next">remove [<em>option</em>...] <em>pkg</em>...</a>, Previous: <a href="#tlmgr-print_002dplatform" accesskey="p" rel="prev">print-platform</a>, Up: <a href="#tlmgr-ACTIONS" accesskey="u" rel="up">ACTIONS</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="print_002dplatform_002dinfo"></span><h4 class="appendixsubsec">B.6.22 print-platform-info</h4> @@ -5381,9 +5463,11 @@ Next: <a href="#tlmgr-remove-_005boption_002e_002e_002e_005d-pkg_002e_002e_002e" original output from guess. </p> <hr> -<span id="tlmgr-remove-_005boption_002e_002e_002e_005d-pkg_002e_002e_002e"></span><div class="header"> +</div> +<div class="appendixsubsec" id="tlmgr-remove-_005boption_002e_002e_002e_005d-pkg_002e_002e_002e"> +<div class="header"> <p> -Next: <a href="#tlmgr-repository" accesskey="n" rel="next">tlmgr repository</a>, Previous: <a href="#tlmgr-print_002dplatform_002dinfo" accesskey="p" rel="prev">tlmgr print-platform-info</a>, Up: <a href="#tlmgr-ACTIONS" accesskey="u" rel="up">tlmgr ACTIONS</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="#tlmgr-repository" accesskey="n" rel="next">repository</a>, Previous: <a href="#tlmgr-print_002dplatform_002dinfo" accesskey="p" rel="prev">print-platform-info</a>, Up: <a href="#tlmgr-ACTIONS" accesskey="u" rel="up">ACTIONS</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="remove-_005boption_002e_002e_002e_005d-pkg_002e_002e_002e"></span><h4 class="appendixsubsec">B.6.23 remove [<em>option</em>...] <em>pkg</em>...</h4> @@ -5393,35 +5477,35 @@ collection dependencies of that collection. However, when removing a package, dependencies are never removed. Options: </p> <dl compact="compact"> -<dt><strong>–all</strong></dt> +<dt><span><strong>–all</strong></span></dt> <dd><span id="tlmgr-_002d_002dall-2"></span> <p>Uninstalls all of TeX Live, asking for confirmation unless <code>--force</code> is also specified. </p> </dd> -<dt><strong>–backup</strong></dt> +<dt><span><strong>–backup</strong></span></dt> <dd><span id="tlmgr-_002d_002dbackup"></span> </dd> -<dt><strong>–backupdir</strong> <em>directory</em></dt> +<dt><span><strong>–backupdir</strong> <em>directory</em></span></dt> <dd><span id="tlmgr-_002d_002dbackupdir-directory-1"></span> -<p>These options behave just as with the <a href="update.html#tlmgr-update-_005boption_002e_002e_002e_005d-_005b_002e_002e_002e_005d">(update)update</a> action (q.v.), except they apply to making +<p>These options behave just as with the <a data-manual="update" href="update.html#tlmgr-update-_005boption_002e_002e_002e_005d-_005b_002e_002e_002e_005d">(update)update</a> action (q.v.), except they apply to making backups of packages before they are removed. The default is to make such a backup, that is, to save a copy of packages before removal. </p> <p>The <a href="#tlmgr-restore">restore</a> action explains how to restore from a backup. </p> </dd> -<dt><strong>–no-depends</strong></dt> +<dt><span><strong>–no-depends</strong></span></dt> <dd><span id="tlmgr-_002d_002dno_002ddepends-1"></span> <p>Do not remove dependent packages. </p> </dd> -<dt><strong>–no-depends-at-all</strong></dt> +<dt><span><strong>–no-depends-at-all</strong></span></dt> <dd><span id="tlmgr-_002d_002dno_002ddepends_002dat_002dall-1"></span> <p>See above under <a href="#tlmgr-install-_005boption_002e_002e_002e_005d-pkg_002e_002e_002e">install</a> (and beware). </p> </dd> -<dt><strong>–force</strong></dt> +<dt><span><strong>–force</strong></span></dt> <dd><span id="tlmgr-_002d_002dforce-1"></span> <p>By default, removal of a package or collection that is a dependency of another collection or scheme is not allowed. With this option, the @@ -5433,7 +5517,7 @@ updated, and will be mentioned as <code>forcibly removed</code> in the output of <code>tlmgr update --list</code>. </p> </dd> -<dt><strong>–dry-run</strong></dt> +<dt><span><strong>–dry-run</strong></span></dt> <dd><span id="tlmgr-_002d_002ddry_002drun-3"></span> <p>Nothing is actually removed; instead, the actions to be performed are written to the terminal. @@ -5441,36 +5525,39 @@ written to the terminal. </dd> </dl> -<p>This action does not automatically remove symlinks to executables from -system directories; you need to run <code>tlmgr path remove</code> (<a href="#tlmgr-path">path</a>) -yourself if you are using this feature and want stale symlinks removed. +<p>Except with <code>--all</code>, this <code>remove</code> action does not automatically +remove symlinks to executables from system directories; you need to run +<code>tlmgr path remove</code> (<a href="#tlmgr-path">path</a>) yourself if you remove an individual +package with a symlink in a system directory. </p> <hr> -<span id="tlmgr-repository"></span><div class="header"> +</div> +<div class="appendixsubsec" id="tlmgr-repository"> +<div class="header"> <p> -Next: <a href="#tlmgr-restore" accesskey="n" rel="next">tlmgr restore</a>, Previous: <a href="#tlmgr-remove-_005boption_002e_002e_002e_005d-pkg_002e_002e_002e" accesskey="p" rel="prev">tlmgr remove [<em>option</em>...] <em>pkg</em>...</a>, Up: <a href="#tlmgr-ACTIONS" accesskey="u" rel="up">tlmgr ACTIONS</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="#tlmgr-restore" accesskey="n" rel="next">restore</a>, Previous: <a href="#tlmgr-remove-_005boption_002e_002e_002e_005d-pkg_002e_002e_002e" accesskey="p" rel="prev">remove [<em>option</em>...] <em>pkg</em>...</a>, Up: <a href="#tlmgr-ACTIONS" accesskey="u" rel="up">ACTIONS</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="repository"></span><h4 class="appendixsubsec">B.6.24 repository</h4> <dl compact="compact"> -<dt><strong>repository list</strong></dt> +<dt><span><strong>repository list</strong></span></dt> <dd><span id="tlmgr-repository-list"></span> </dd> -<dt><strong>repository list <em>path|url|tag</em></strong></dt> +<dt><span><strong>repository list <em>path|url|tag</em></strong></span></dt> <dd><span id="tlmgr-repository-list-path_007curl_007ctag"></span> </dd> -<dt><strong>repository add <em>path</em> [<em>tag</em>]</strong></dt> +<dt><span><strong>repository add <em>path</em> [<em>tag</em>]</strong></span></dt> <dd><span id="tlmgr-repository-add-path-_005btag_005d"></span> </dd> -<dt><strong>repository remove <em>path|tag</em></strong></dt> +<dt><span><strong>repository remove <em>path|tag</em></strong></span></dt> <dd><span id="tlmgr-repository-remove-path_007ctag"></span> </dd> -<dt><strong>repository set <em>path</em>[#<em>tag</em>] [<em>path</em>[#<em>tag</em>] ...]</strong></dt> +<dt><span><strong>repository set <em>path</em>[#<em>tag</em>] [<em>path</em>[#<em>tag</em>] ...]</strong></span></dt> <dd><span id="tlmgr-repository-set-path_005b_0023tag_005d-_005bpath_005b_0023tag_005d-_002e_002e_002e_005d"></span> </dd> -<dt><strong>repository status</strong></dt> +<dt><span><strong>repository status</strong></span></dt> <dd><span id="tlmgr-repository-status"></span> -<p>This action manages the list of repositories. See <a href="MULTIPLE_REPOSITORIES.html#Top">(MULTIPLE_REPOSITORIES)</a> below for detailed explanations. +<p>This action manages the list of repositories. See <a data-manual="MULTIPLE_REPOSITORIES" href="MULTIPLE_REPOSITORIES.html#Top">(MULTIPLE_REPOSITORIES)</a> below for detailed explanations. </p> <p>The first form, <code>repository list</code>, lists all configured repositories and the respective tags if set. If a path, url, or tag is given after @@ -5492,7 +5579,7 @@ loaded repositories with the format of one repository per line with fields separated by a single space: </p> <dl compact="compact"> -<dt>The tag (which can be the same as the url);</dt> +<dt><span>The tag (which can be the same as the url);</span></dt> <dd><span id="tlmgr-The-tag-_0028which-can-be-the-same-as-the-url_0029_003b"></span> <p>= the url; </p> @@ -5515,17 +5602,19 @@ otherwise, all operations will fail! </dl> <hr> -<span id="tlmgr-restore"></span><div class="header"> +</div> +<div class="appendixsubsec" id="tlmgr-restore"> +<div class="header"> <p> -Next: <a href="#tlmgr-search" accesskey="n" rel="next">tlmgr search</a>, Previous: <a href="#tlmgr-repository" accesskey="p" rel="prev">tlmgr repository</a>, Up: <a href="#tlmgr-ACTIONS" accesskey="u" rel="up">tlmgr ACTIONS</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="#tlmgr-search" accesskey="n" rel="next">search</a>, Previous: <a href="#tlmgr-repository" accesskey="p" rel="prev">repository</a>, Up: <a href="#tlmgr-ACTIONS" accesskey="u" rel="up">ACTIONS</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="restore"></span><h4 class="appendixsubsec">B.6.25 restore</h4> <dl compact="compact"> -<dt><strong>restore [<em>option</em>...] <em>pkg</em> [<em>rev</em>]</strong></dt> +<dt><span><strong>restore [<em>option</em>...] <em>pkg</em> [<em>rev</em>]</strong></span></dt> <dd><span id="tlmgr-restore-_005boption_002e_002e_002e_005d-pkg-_005brev_005d"></span> </dd> -<dt><strong>restore [<em>option</em>...] –all</strong></dt> +<dt><span><strong>restore [<em>option</em>...] –all</strong></span></dt> <dd><span id="tlmgr-restore-_005boption_002e_002e_002e_005d-_002d_002dall"></span> <p>Restore a package from a previously-made backup. </p> @@ -5545,31 +5634,31 @@ specified, try to restore the package from the specified backup. <p>Options: </p> <dl compact="compact"> -<dt><strong>–all</strong></dt> +<dt><span><strong>–all</strong></span></dt> <dd><span id="tlmgr-_002d_002dall-3"></span> <p>Try to restore the latest revision of all package backups found in the backup directory. Additional non-option arguments (like <em>pkg</em>) are not allowed. </p> </dd> -<dt><strong>–backupdir</strong> <em>directory</em></dt> +<dt><span><strong>–backupdir</strong> <em>directory</em></span></dt> <dd><span id="tlmgr-_002d_002dbackupdir-directory-2"></span> <p>Specify the directory where the backups are to be found. If not given it will be taken from the configuration setting in the TLPDB. </p> </dd> -<dt><strong>–dry-run</strong></dt> +<dt><span><strong>–dry-run</strong></span></dt> <dd><span id="tlmgr-_002d_002ddry_002drun-4"></span> <p>Nothing is actually restored; instead, the actions to be performed are written to the terminal. </p> </dd> -<dt><strong>–force</strong></dt> +<dt><span><strong>–force</strong></span></dt> <dd><span id="tlmgr-_002d_002dforce-2"></span> <p>Don’t ask questions. </p> </dd> -<dt><strong>–json</strong></dt> +<dt><span><strong>–json</strong></span></dt> <dd><span id="tlmgr-_002d_002djson-2"></span> <p>When listing backups, the option <code>--json</code> turn on JSON output. The format is an array of JSON objects (<code>name</code>, <code>rev</code>, <code>date</code>). @@ -5583,20 +5672,22 @@ If both <code>--json</code> and <code>--data</code> are given, <code>--json</cod </dl> <hr> -<span id="tlmgr-search"></span><div class="header"> +</div> +<div class="appendixsubsec" id="tlmgr-search"> +<div class="header"> <p> -Next: <a href="#tlmgr-shell" accesskey="n" rel="next">tlmgr shell</a>, Previous: <a href="#tlmgr-restore" accesskey="p" rel="prev">tlmgr restore</a>, Up: <a href="#tlmgr-ACTIONS" accesskey="u" rel="up">tlmgr ACTIONS</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="#tlmgr-shell" accesskey="n" rel="next">shell</a>, Previous: <a href="#tlmgr-restore" accesskey="p" rel="prev">restore</a>, Up: <a href="#tlmgr-ACTIONS" accesskey="u" rel="up">ACTIONS</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="search"></span><h4 class="appendixsubsec">B.6.26 search</h4> <dl compact="compact"> -<dt><strong>search [<em>option</em>...] <em>what</em></strong></dt> +<dt><span><strong>search [<em>option</em>...] <em>what</em></strong></span></dt> <dd><span id="tlmgr-search-_005boption_002e_002e_002e_005d-what"></span> </dd> -<dt><strong>search [<em>option</em>...] –file <em>what</em></strong></dt> +<dt><span><strong>search [<em>option</em>...] –file <em>what</em></strong></span></dt> <dd><span id="tlmgr-search-_005boption_002e_002e_002e_005d-_002d_002dfile-what"></span> </dd> -<dt><strong>search [<em>option</em>...] –all <em>what</em></strong></dt> +<dt><span><strong>search [<em>option</em>...] –all <em>what</em></strong></span></dt> <dd><span id="tlmgr-search-_005boption_002e_002e_002e_005d-_002d_002dall-what"></span> <p>By default, search the names, short descriptions, and long descriptions of all locally installed packages for the argument <em>what</em>, interpreted @@ -5605,23 +5696,23 @@ as a (Perl) regular expression. <p>Options: </p> <dl compact="compact"> -<dt><strong>–file</strong></dt> +<dt><span><strong>–file</strong></span></dt> <dd><span id="tlmgr-_002d_002dfile-1"></span> <p>List all filenames containing <em>what</em>. </p> </dd> -<dt><strong>–all</strong></dt> +<dt><span><strong>–all</strong></span></dt> <dd><span id="tlmgr-_002d_002dall-4"></span> <p>Search everything: package names, descriptions and filenames. </p> </dd> -<dt><strong>–global</strong></dt> +<dt><span><strong>–global</strong></span></dt> <dd><span id="tlmgr-_002d_002dglobal"></span> <p>Search the TeX Live Database of the installation medium, instead of the local installation. </p> </dd> -<dt><strong>–word</strong></dt> +<dt><span><strong>–word</strong></span></dt> <dd><span id="tlmgr-_002d_002dword"></span> <p>Restrict the search of package names and descriptions (but not filenames) to match only full words. For example, searching for @@ -5635,9 +5726,11 @@ filenames) to match only full words. For example, searching for </dl> <hr> -<span id="tlmgr-shell"></span><div class="header"> +</div> +<div class="appendixsubsec" id="tlmgr-shell"> +<div class="header"> <p> -Next: <a href="#tlmgr-show" accesskey="n" rel="next">tlmgr show</a>, Previous: <a href="#tlmgr-search" accesskey="p" rel="prev">tlmgr search</a>, Up: <a href="#tlmgr-ACTIONS" accesskey="u" rel="up">tlmgr ACTIONS</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="#tlmgr-show" accesskey="n" rel="next">show</a>, Previous: <a href="#tlmgr-search" accesskey="p" rel="prev">search</a>, Up: <a href="#tlmgr-ACTIONS" accesskey="u" rel="up">ACTIONS</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="shell"></span><h4 class="appendixsubsec">B.6.27 shell</h4> @@ -5655,43 +5748,43 @@ the session. <p>Besides these actions, a few commands are specific to shell mode: </p> <dl compact="compact"> -<dt>protocol</dt> +<dt><span>protocol</span></dt> <dd><span id="tlmgr-protocol"></span> <p>Print <code>protocol <em>n</em></code>, the current protocol version. </p> </dd> -<dt>help</dt> +<dt><span>help</span></dt> <dd><span id="tlmgr-help-1"></span> <p>Print pointers to this documentation. </p> </dd> -<dt>version</dt> +<dt><span>version</span></dt> <dd><span id="tlmgr-version-1"></span> <p>Print tlmgr version information. </p> </dd> -<dt>quit, end, bye, byebye, EOF</dt> +<dt><span>quit, end, bye, byebye, EOF</span></dt> <dd><span id="tlmgr-quit_002c-end_002c-bye_002c-byebye_002c-EOF"></span> <p>Exit. </p> </dd> -<dt>restart</dt> +<dt><span>restart</span></dt> <dd><span id="tlmgr-restart"></span> <p>Restart <code>tlmgr shell</code> with the original command line; most useful when developing <code>tlmgr</code>. </p> </dd> -<dt>load [local|remote]</dt> +<dt><span>load [local|remote]</span></dt> <dd><span id="tlmgr-load-_005blocal_007cremote_005d"></span> <p>Explicitly load the local or remote, respectively, TLPDB. </p> </dd> -<dt>save</dt> +<dt><span>save</span></dt> <dd><span id="tlmgr-save"></span> <p>Save the local TLPDB, presumably after other operations have changed it. </p> </dd> -<dt>get [<em>var</em>] =item set [<em>var</em> [<em>val</em>]]</dt> +<dt><span>get [<em>var</em>] =item set [<em>var</em> [<em>val</em>]]</span></dt> <dd><span id="tlmgr-get-_005bvar_005d-_003ditem-set-_005bvar-_005bval_005d_005d"></span> <p>Get the value of <em>var</em>, or set it to <em>val</em>. Possible <em>var</em> names: <code>debug-translation</code>, <code>machine-readable</code>, <code>no-execute-actions</code>, @@ -5708,27 +5801,33 @@ current default prompt. </dl> <hr> -<span id="tlmgr-show"></span><div class="header"> +</div> +<div class="appendixsubsec" id="tlmgr-show"> +<div class="header"> <p> -Next: <a href="#tlmgr-uninstall" accesskey="n" rel="next">tlmgr uninstall</a>, Previous: <a href="#tlmgr-shell" accesskey="p" rel="prev">tlmgr shell</a>, Up: <a href="#tlmgr-ACTIONS" accesskey="u" rel="up">tlmgr ACTIONS</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="#tlmgr-uninstall" accesskey="n" rel="next">uninstall</a>, Previous: <a href="#tlmgr-shell" accesskey="p" rel="prev">shell</a>, Up: <a href="#tlmgr-ACTIONS" accesskey="u" rel="up">ACTIONS</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="show"></span><h4 class="appendixsubsec">B.6.28 show</h4> <p>Synonym for <a href="#tlmgr-info">info</a>. </p> <hr> -<span id="tlmgr-uninstall"></span><div class="header"> +</div> +<div class="appendixsubsec" id="tlmgr-uninstall"> +<div class="header"> <p> -Next: <a href="#tlmgr-update-_005boption_002e_002e_002e_005d-_005bpkg_002e_002e_002e_005d" accesskey="n" rel="next">tlmgr update [<em>option</em>...] [<em>pkg</em>...]</a>, Previous: <a href="#tlmgr-show" accesskey="p" rel="prev">tlmgr show</a>, Up: <a href="#tlmgr-ACTIONS" accesskey="u" rel="up">tlmgr ACTIONS</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="#tlmgr-update-_005boption_002e_002e_002e_005d-_005bpkg_002e_002e_002e_005d" accesskey="n" rel="next">update [<em>option</em>...] [<em>pkg</em>...]</a>, Previous: <a href="#tlmgr-show" accesskey="p" rel="prev">show</a>, Up: <a href="#tlmgr-ACTIONS" accesskey="u" rel="up">ACTIONS</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="uninstall"></span><h4 class="appendixsubsec">B.6.29 uninstall</h4> <p>Synonym for <a href="#tlmgr-remove-_005boption_002e_002e_002e_005d-pkg_002e_002e_002e">remove</a>. </p> <hr> -<span id="tlmgr-update-_005boption_002e_002e_002e_005d-_005bpkg_002e_002e_002e_005d"></span><div class="header"> +</div> +<div class="appendixsubsec" id="tlmgr-update-_005boption_002e_002e_002e_005d-_005bpkg_002e_002e_002e_005d"> +<div class="header"> <p> -Previous: <a href="#tlmgr-uninstall" accesskey="p" rel="prev">tlmgr uninstall</a>, Up: <a href="#tlmgr-ACTIONS" accesskey="u" rel="up">tlmgr ACTIONS</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="#tlmgr-uninstall" accesskey="p" rel="prev">uninstall</a>, Up: <a href="#tlmgr-ACTIONS" accesskey="u" rel="up">ACTIONS</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="update-_005boption_002e_002e_002e_005d-_005bpkg_002e_002e_002e_005d"></span><h4 class="appendixsubsec">B.6.30 update [<em>option</em>...] [<em>pkg</em>...]</h4> @@ -5737,7 +5836,7 @@ at the installation source. Either <code>--all</code> or at least one <em>pkg</ must be specified. Options: </p> <dl compact="compact"> -<dt><strong>–all</strong></dt> +<dt><span><strong>–all</strong></span></dt> <dd><span id="tlmgr-_002d_002dall-5"></span> <p>Update all installed packages except for <code>tlmgr</code> itself. If updates to <code>tlmgr</code> itself are present, this gives an error, unless also the option @@ -5777,7 +5876,7 @@ record the repository from which packages come from.) due to a slow link), see the <code>--exclude</code> option below. </p> </dd> -<dt><strong>–self</strong></dt> +<dt><span><strong>–self</strong></span></dt> <dd><span id="tlmgr-_002d_002dself"></span> <p>Update <code>tlmgr</code> itself (that is, the infrastructure packages) if updates to it are present. On Windows this includes updates to the private Perl @@ -5796,13 +5895,13 @@ updates. # ... this last at your own risk, not recommended! </pre> </dd> -<dt><strong>–dry-run</strong></dt> +<dt><span><strong>–dry-run</strong></span></dt> <dd><span id="tlmgr-_002d_002ddry_002drun-5"></span> <p>Nothing is actually installed; instead, the actions to be performed are written to the terminal. This is a more detailed report than <code>--list</code>. </p> </dd> -<dt><strong>–list</strong> [<em>pkg</em>]</dt> +<dt><span><strong>–list</strong> [<em>pkg</em>]</span></dt> <dd><span id="tlmgr-_002d_002dlist-_005bpkg_005d"></span> <p>Concisely list the packages which would be updated, newly installed, or removed, without actually changing anything. @@ -5817,7 +5916,7 @@ If neither <code>--all</code> nor <code>--self</code> is given, but specific pac given, those packages are checked for updates. </p> </dd> -<dt><strong>–exclude</strong> <em>pkg</em></dt> +<dt><span><strong>–exclude</strong> <em>pkg</em></span></dt> <dd><span id="tlmgr-_002d_002dexclude-pkg"></span> <p>Exclude <em>pkg</em> from the update process. If this option is given more than once, its arguments accumulate. @@ -5839,7 +5938,7 @@ supported in these circumstances. the key <code>update-exclude</code>. </p> </dd> -<dt><strong>–no-auto-remove</strong> [<em>pkg</em>...]</dt> +<dt><span><strong>–no-auto-remove</strong> [<em>pkg</em>...]</span></dt> <dd><span id="tlmgr-_002d_002dno_002dauto_002dremove-_005bpkg_002e_002e_002e_005d"></span> <p>By default, <code>tlmgr</code> tries to remove packages in an existing collection which have disappeared on the server, as described above under <code>--all</code>. @@ -5849,7 +5948,7 @@ inconsistent TeX installation, since packages are not infrequently renamed or replaced by their authors. Therefore this is not recommended. </p> </dd> -<dt><strong>–no-auto-install</strong> [<em>pkg</em>...]</dt> +<dt><span><strong>–no-auto-install</strong> [<em>pkg</em>...]</span></dt> <dd><span id="tlmgr-_002d_002dno_002dauto_002dinstall-_005bpkg_002e_002e_002e_005d"></span> <p>Under normal circumstances <code>tlmgr</code> will install packages which are new on the server, as described above under <code>--all</code>. This option prevents @@ -5872,7 +5971,7 @@ server, then option is not recommended. </p> </dd> -<dt><strong>–reinstall-forcibly-removed</strong></dt> +<dt><span><strong>–reinstall-forcibly-removed</strong></span></dt> <dd><span id="tlmgr-_002d_002dreinstall_002dforcibly_002dremoved"></span> <p>Under normal circumstances <code>tlmgr</code> will not install packages that have been forcibly removed by the user; that is, removed with <code>remove @@ -5886,10 +5985,10 @@ installation with the server’s idea of what is available: <pre class="verbatim"> tlmgr update --reinstall-forcibly-removed --all </pre> </dd> -<dt><strong>–backup</strong></dt> +<dt><span><strong>–backup</strong></span></dt> <dd><span id="tlmgr-_002d_002dbackup-1"></span> </dd> -<dt><strong>–backupdir</strong> <em>directory</em></dt> +<dt><span><strong>–backupdir</strong> <em>directory</em></span></dt> <dd><span id="tlmgr-_002d_002dbackupdir-directory-3"></span> <p>These two options control the creation of backups of packages <em>before</em> updating; that is, backing up packages as currently installed. If @@ -5912,19 +6011,19 @@ incompatibility. <p>The <a href="#tlmgr-restore">restore</a> action explains how to restore from a backup. </p> </dd> -<dt><strong>–no-depends</strong></dt> +<dt><span><strong>–no-depends</strong></span></dt> <dd><span id="tlmgr-_002d_002dno_002ddepends-2"></span> <p>If you call for updating a package normally all depending packages will also be checked for updates and updated if necessary. This switch suppresses this behavior. </p> </dd> -<dt><strong>–no-depends-at-all</strong></dt> +<dt><span><strong>–no-depends-at-all</strong></span></dt> <dd><span id="tlmgr-_002d_002dno_002ddepends_002dat_002dall-2"></span> <p>See above under <a href="#tlmgr-install-_005boption_002e_002e_002e_005d-pkg_002e_002e_002e">install</a> (and beware). </p> </dd> -<dt><strong>–force</strong></dt> +<dt><span><strong>–force</strong></span></dt> <dd><span id="tlmgr-_002d_002dforce-3"></span> <p>Force update of normal packages, without updating <code>tlmgr</code> itself (unless the <code>--self</code> option is also given). Not recommended. @@ -5950,9 +6049,12 @@ directories; you need to run <code>tlmgr</code> <a href="#tlmgr-path">path</a> y this feature and want new symlinks added. </p> <hr> -<span id="tlmgr-CONFIGURATION-FILE-FOR-TLMGR"></span><div class="header"> +</div> +</div> +<div class="appendixsec" id="tlmgr-CONFIGURATION-FILE-FOR-TLMGR"> +<div class="header"> <p> -Next: <a href="#tlmgr-CRYPTOGRAPHIC-VERIFICATION" accesskey="n" rel="next">tlmgr CRYPTOGRAPHIC VERIFICATION</a>, Previous: <a href="#tlmgr-ACTIONS" accesskey="p" rel="prev">tlmgr ACTIONS</a>, Up: <a href="#tlmgr" accesskey="u" rel="up">tlmgr</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="#tlmgr-CRYPTOGRAPHIC-VERIFICATION" accesskey="n" rel="next">CRYPTOGRAPHIC VERIFICATION</a>, Previous: <a href="#tlmgr-ACTIONS" accesskey="p" rel="prev">ACTIONS</a>, Up: <a href="#tlmgr" accesskey="u" rel="up">tlmgr</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-FOR-TLMGR"></span><h3 class="appendixsec">B.7 CONFIGURATION FILE FOR TLMGR</h3> @@ -5977,67 +6079,63 @@ ignored. All other lines must look like: <p>The allowed keys are: </p> <dl compact="compact"> -<dt><code>auto-remove</code>, value 0 or 1 (default 1), same as command-line option.</dt> -<dd><span id="tlmgr-auto_002dremove_002c-value-0-or-1-_0028default-1_0029_002c-same-as-command_002dline-option_002e"></span> +<dt><span><code>auto-remove =</code> 0 or 1 (default 1), same as command-line option.</span></dt> +<dd><span id="tlmgr-auto_002dremove-_003d-0-or-1-_0028default-1_0029_002c-same-as-command_002dline-option_002e"></span> </dd> -<dt><code>gui-expertmode</code>, value 0 or 1 (default 1). This switches between the full GUI and a simplified GUI with only the most common settings.</dt> -<dd><span id="tlmgr-gui_002dexpertmode_002c-value-0-or-1-_0028default-1_0029_002e-This-switches-between-the-full-GUI-and-a-simplified-GUI-with-only-the-most-common-settings_002e"></span> +<dt><span><code>gui-expertmode =</code> 0 or 1 (default 1). This switches between the full GUI and a simplified GUI with only the most common settings.</span></dt> +<dd><span id="tlmgr-gui_002dexpertmode-_003d-0-or-1-_0028default-1_0029_002e-This-switches-between-the-full-GUI-and-a-simplified-GUI-with-only-the-most-common-settings_002e"></span> </dd> -<dt><code>gui-lang</code> <em>llcode</em>, with a language code value as with the command-line option.</dt> -<dd><span id="tlmgr-gui_002dlang-llcode_002c-with-a-language-code-value-as-with-the-command_002dline-option_002e"></span> +<dt><span><code>gui-lang =</code> <em>llcode</em>, with a language code value as with the command-line option.</span></dt> +<dd><span id="tlmgr-gui_002dlang-_003d-llcode_002c-with-a-language-code-value-as-with-the-command_002dline-option_002e"></span> </dd> -<dt><code>no-checksums</code>, value 0 or 1 (default 0, see below).</dt> -<dd><span id="tlmgr-no_002dchecksums_002c-value-0-or-1-_0028default-0_002c-see-below_0029_002e"></span> +<dt><span><code>no-checksums =</code> 0 or 1 (default 0, see below).</span></dt> +<dd><span id="tlmgr-no_002dchecksums-_003d-0-or-1-_0028default-0_002c-see-below_0029_002e"></span> </dd> -<dt><code>persistent-downloads</code>, value 0 or 1 (default 1), same as command-line option.</dt> -<dd><span id="tlmgr-persistent_002ddownloads_002c-value-0-or-1-_0028default-1_0029_002c-same-as-command_002dline-option_002e"></span> +<dt><span><code>persistent-downloads =</code> 0 or 1 (default 1), same as command-line option.</span></dt> +<dd><span id="tlmgr-persistent_002ddownloads-_003d-0-or-1-_0028default-1_0029_002c-same-as-command_002dline-option_002e"></span> </dd> -<dt><code>require-verification</code>, value 0 or 1 (default 0), same as command-line option.</dt> -<dd><span id="tlmgr-require_002dverification_002c-value-0-or-1-_0028default-0_0029_002c-same-as-command_002dline-option_002e"></span> +<dt><span><code>require-verification =</code> 0 or 1 (default 0), same as command-line option.</span></dt> +<dd><span id="tlmgr-require_002dverification-_003d-0-or-1-_0028default-0_0029_002c-same-as-command_002dline-option_002e"></span> </dd> -<dt><code>tkfontscale</code>, value any float. Controls the scaling of fonts in the Tk based frontends.</dt> -<dd><span id="tlmgr-tkfontscale_002c-value-any-float_002e-Controls-the-scaling-of-fonts-in-the-Tk-based-frontends_002e"></span> +<dt><span><code>tkfontscale =</code> <em>floating-point number</em> (default 1.0); scaling factor for fonts in the Tk-based frontends.</span></dt> +<dd><span id="tlmgr-tkfontscale-_003d-floating_002dpoint-number-_0028default-1_002e0_0029_003b-scaling-factor-for-fonts-in-the-Tk_002dbased-frontends_002e"></span> </dd> -<dt><code>update-exclude</code>, value: comma-separated list of packages (no space allowed). Same as the command line option <code>--exclude</code> for the action <code>update</code>.</dt> -<dd><span id="tlmgr-update_002dexclude_002c-value_003a-comma_002dseparated-list-of-packages-_0028no-space-allowed_0029_002e-Same-as-the-command-line-option-_002d_002dexclude-for-the-action-update_002e"></span> +<dt><span><code>update-exclude =</code> <em>comma-separated list of packages</em> (no spaces allowed). Same as the command line option <code>--exclude</code> for the <code>update</code> action.</span></dt> +<dd><span id="tlmgr-update_002dexclude-_003d-comma_002dseparated-list-of-packages-_0028no-spaces-allowed_0029_002e-Same-as-the-command-line-option-_002d_002dexclude-for-the-update-action_002e"></span> </dd> -<dt><code>verify-downloads</code>, value 0 or 1 (default 1), same as command-line option.</dt> -<dd><span id="tlmgr-verify_002ddownloads_002c-value-0-or-1-_0028default-1_0029_002c-same-as-command_002dline-option_002e"></span> +<dt><span><code>verify-downloads =</code> 0 or 1 (default 1), same as command-line option.</span></dt> +<dd><span id="tlmgr-verify_002ddownloads-_003d-0-or-1-_0028default-1_0029_002c-same-as-command_002dline-option_002e"></span> </dd> </dl> <p>The system-wide config file can contain one additional key: </p> <dl compact="compact"> -<dt><code>allowed-actions</code> <em>action1</em> [,<em>action</em>,...] The value is a comma-separated list of <code>tlmgr</code> actions which are allowed to be executed when <code>tlmgr</code> is invoked in system mode (that is, without <code>--usermode</code>).</dt> -<dd><span id="tlmgr-allowed_002dactions-action1-_005b_002caction_002c_002e_002e_002e_005d-The-value-is-a-comma_002dseparated-list-of-tlmgr-actions-which-are-allowed-to-be-executed-when-tlmgr-is-invoked-in-system-mode-_0028that-is_002c-without-_002d_002dusermode_0029_002e"></span> -<p>This allows distributors to include the <code>tlmgr</code> in their packaging, but -allow only a restricted set of actions that do not interfere with their -distro package manager. For native TeX Live installations, it doesn’t -make sense to set this. -</p> +<dt><span><code>allowed-actions =</code> <em>action1</em>[,<em>action2</em>,...] The value is a comma-separated list (no spaces) of <code>tlmgr</code> actions which are allowed to be executed when <code>tlmgr</code> is invoked in system mode (that is, without <code>--usermode</code>). This allows distributors to include <code>tlmgr</code> in their packaging, but allow only a restricted set of actions that do not interfere with their distro package manager. For native TeX Live installations, it doesn’t make sense to set this.</span></dt> +<dd><span id="tlmgr-allowed_002dactions-_003d-action1_005b_002caction2_002c_002e_002e_002e_005d-The-value-is-a-comma_002dseparated-list-_0028no-spaces_0029-of-tlmgr-actions-which-are-allowed-to-be-executed-when-tlmgr-is-invoked-in-system-mode-_0028that-is_002c-without-_002d_002dusermode_0029_002e-This-allows-distributors-to-include-tlmgr-in-their-packaging_002c-but-allow-only-a-restricted-set-of-actions-that-do-not-interfere-with-their-distro-package-manager_002e-For-native-TeX-Live-installations_002c-it-doesn_0027t-make-sense-to-set-this_002e"></span> </dd> </dl> -<p>The <code>no-checksums</code> key needs more explanation. By default, package -checksums computed and stored on the server (in the TLPDB) are compared -to checksums computed locally after downloading. <code>no-checksums</code> -disables this process. -</p> -<p>The checksum algorithm is SHA-512. Your system must have one of (looked -for in this order) the Perl <code>Digest::SHA</code> module, the <code>openssl</code> -program (<a href="https://openssl.org">https://openssl.org</a>), the <code>sha512sum</code> program (from GNU -Coreutils, <a href="https://www.gnu.org/software/coreutils">https://www.gnu.org/software/coreutils</a>), or finally the -<code>shasum</code> program (just to support old Macs). If none of these are -available, a warning is issued and <code>tlmgr</code> proceeds without checking -checksums. (Incidentally, other SHA implementations, such as the pure -Perl and pure Lua modules, are much too slow to be usable in our -context.) <code>no-checksums</code> avoids the warning. +<p>Finally, the <code>no-checksums</code> key needs more explanation. By default, +package checksums computed and stored on the server (in the TLPDB) are +compared to checksums computed locally after downloading. +<code>no-checksums</code> disables this process. The checksum algorithm is +SHA-512. Your system must have one of (looked for in this order) the +Perl <code>Digest::SHA</code> module, the <code>openssl</code> program +(<a href="https://openssl.org">https://openssl.org</a>), the <code>sha512sum</code> program (from GNU Coreutils, +<a href="https://www.gnu.org/software/coreutils">https://www.gnu.org/software/coreutils</a>), or finally the <code>shasum</code> +program (just to support old Macs). If none of these are available, a +warning is issued and <code>tlmgr</code> proceeds without checking checksums. +<code>no-checksums</code> avoids the warning. (Incidentally, other SHA +implementations, such as the pure Perl and pure Lua modules, are much +too slow to be usable in our context.) </p> <hr> -<span id="tlmgr-CRYPTOGRAPHIC-VERIFICATION"></span><div class="header"> +</div> +<div class="appendixsec" id="tlmgr-CRYPTOGRAPHIC-VERIFICATION"> +<div class="header"> <p> -Next: <a href="#tlmgr-USER-MODE" accesskey="n" rel="next">tlmgr USER MODE</a>, Previous: <a href="#tlmgr-CONFIGURATION-FILE-FOR-TLMGR" accesskey="p" rel="prev">tlmgr CONFIGURATION FILE FOR TLMGR</a>, Up: <a href="#tlmgr" accesskey="u" rel="up">tlmgr</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="#tlmgr-USER-MODE" accesskey="n" rel="next">USER MODE</a>, Previous: <a href="#tlmgr-CONFIGURATION-FILE-FOR-TLMGR" accesskey="p" rel="prev">CONFIGURATION FILE FOR TLMGR</a>, Up: <a href="#tlmgr" accesskey="u" rel="up">tlmgr</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="CRYPTOGRAPHIC-VERIFICATION"></span><h3 class="appendixsec">B.8 CRYPTOGRAPHIC VERIFICATION</h3> @@ -6077,15 +6175,15 @@ of these keys are obtainable from the standard key servers. </p> <p>Additional trusted keys can be added using the <code>key</code> action. </p> -<table class="menu" border="0" cellspacing="0"> -<tr><td align="left" valign="top">• <a href="#tlmgr-Configuration-of-GnuPG-invocation" accesskey="1">tlmgr Configuration of GnuPG invocation</a></td><td> </td><td align="left" valign="top"> -</td></tr> -</table> +<ul class="section-toc"> +<li><a href="#tlmgr-Configuration-of-GnuPG-invocation" accesskey="1">Configuration of GnuPG invocation</a></li> +</ul> <hr> -<span id="tlmgr-Configuration-of-GnuPG-invocation"></span><div class="header"> +<div class="appendixsubsec" id="tlmgr-Configuration-of-GnuPG-invocation"> +<div class="header"> <p> -Up: <a href="#tlmgr-CRYPTOGRAPHIC-VERIFICATION" accesskey="u" rel="up">tlmgr CRYPTOGRAPHIC VERIFICATION</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> +Up: <a href="#tlmgr-CRYPTOGRAPHIC-VERIFICATION" accesskey="u" rel="up">CRYPTOGRAPHIC VERIFICATION</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-of-GnuPG-invocation"></span><h4 class="appendixsubsec">B.8.1 Configuration of GnuPG invocation</h4> @@ -6099,9 +6197,12 @@ value for <code>--homedir</code>, and <code>TL_GNUPGARGS</code>, which replaces options <code>--no-secmem-warning --no-permission-warning</code>. </p> <hr> -<span id="tlmgr-USER-MODE"></span><div class="header"> +</div> +</div> +<div class="appendixsec" id="tlmgr-USER-MODE"> +<div class="header"> <p> -Next: <a href="#tlmgr-MULTIPLE-REPOSITORIES" accesskey="n" rel="next">tlmgr MULTIPLE REPOSITORIES</a>, Previous: <a href="#tlmgr-CRYPTOGRAPHIC-VERIFICATION" accesskey="p" rel="prev">tlmgr CRYPTOGRAPHIC VERIFICATION</a>, Up: <a href="#tlmgr" accesskey="u" rel="up">tlmgr</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="#tlmgr-MULTIPLE-REPOSITORIES" accesskey="n" rel="next">MULTIPLE REPOSITORIES</a>, Previous: <a href="#tlmgr-CRYPTOGRAPHIC-VERIFICATION" accesskey="p" rel="prev">CRYPTOGRAPHIC VERIFICATION</a>, Up: <a href="#tlmgr" accesskey="u" rel="up">tlmgr</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="USER-MODE"></span><h3 class="appendixsec">B.9 USER MODE</h3> @@ -6157,19 +6258,17 @@ installed into a user tree. </p> <p>Description of changes of actions in user mode: </p> -<table class="menu" border="0" cellspacing="0"> -<tr><td align="left" valign="top">• <a href="#tlmgr-User-mode-install" accesskey="1">tlmgr User mode install</a></td><td> </td><td align="left" valign="top"> -</td></tr> -<tr><td align="left" valign="top">• <a href="#tlmgr-User-mode-backup_002c-restore_002c-remove_002c-update" accesskey="2">tlmgr User mode backup, restore, remove, update</a></td><td> </td><td align="left" valign="top"> -</td></tr> -<tr><td align="left" valign="top">• <a href="#tlmgr-User-mode-generate_002c-option_002c-paper" accesskey="3">tlmgr User mode generate, option, paper</a></td><td> </td><td align="left" valign="top"> -</td></tr> -</table> +<ul class="section-toc"> +<li><a href="#tlmgr-User-mode-install" accesskey="1">User mode install</a></li> +<li><a href="#tlmgr-User-mode-backup_002c-restore_002c-remove_002c-update" accesskey="2">User mode backup, restore, remove, update</a></li> +<li><a href="#tlmgr-User-mode-generate_002c-option_002c-paper" accesskey="3">User mode generate, option, paper</a></li> +</ul> <hr> -<span id="tlmgr-User-mode-install"></span><div class="header"> +<div class="appendixsubsec" id="tlmgr-User-mode-install"> +<div class="header"> <p> -Next: <a href="#tlmgr-User-mode-backup_002c-restore_002c-remove_002c-update" accesskey="n" rel="next">tlmgr User mode backup, restore, remove, update</a>, Up: <a href="#tlmgr-USER-MODE" accesskey="u" rel="up">tlmgr USER MODE</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="#tlmgr-User-mode-backup_002c-restore_002c-remove_002c-update" accesskey="n" rel="next">User mode backup, restore, remove, update</a>, Up: <a href="#tlmgr-USER-MODE" accesskey="u" rel="up">USER MODE</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="User-mode-install"></span><h4 class="appendixsubsec">B.9.1 User mode install</h4> @@ -6192,9 +6291,11 @@ the user’s <code>updmap.cfg</code> in <code>USERTREE/web2c/</code> is made regenerated from the list of installed packages. </p> <hr> -<span id="tlmgr-User-mode-backup_002c-restore_002c-remove_002c-update"></span><div class="header"> +</div> +<div class="appendixsubsec" id="tlmgr-User-mode-backup_002c-restore_002c-remove_002c-update"> +<div class="header"> <p> -Next: <a href="#tlmgr-User-mode-generate_002c-option_002c-paper" accesskey="n" rel="next">tlmgr User mode generate, option, paper</a>, Previous: <a href="#tlmgr-User-mode-install" accesskey="p" rel="prev">tlmgr User mode install</a>, Up: <a href="#tlmgr-USER-MODE" accesskey="u" rel="up">tlmgr USER MODE</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="#tlmgr-User-mode-generate_002c-option_002c-paper" accesskey="n" rel="next">User mode generate, option, paper</a>, Previous: <a href="#tlmgr-User-mode-install" accesskey="p" rel="prev">User mode install</a>, Up: <a href="#tlmgr-USER-MODE" accesskey="u" rel="up">USER MODE</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="User-mode-backup_002c-restore_002c-remove_002c-update"></span><h4 class="appendixsubsec">B.9.2 User mode backup, restore, remove, update</h4> @@ -6203,20 +6304,24 @@ installed in the user tree before proceeding; otherwise, they behave just as in normal mode. </p> <hr> -<span id="tlmgr-User-mode-generate_002c-option_002c-paper"></span><div class="header"> +</div> +<div class="appendixsubsec" id="tlmgr-User-mode-generate_002c-option_002c-paper"> +<div class="header"> <p> -Previous: <a href="#tlmgr-User-mode-backup_002c-restore_002c-remove_002c-update" accesskey="p" rel="prev">tlmgr User mode backup, restore, remove, update</a>, Up: <a href="#tlmgr-USER-MODE" accesskey="u" rel="up">tlmgr USER MODE</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="#tlmgr-User-mode-backup_002c-restore_002c-remove_002c-update" accesskey="p" rel="prev">User mode backup, restore, remove, update</a>, Up: <a href="#tlmgr-USER-MODE" accesskey="u" rel="up">USER MODE</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="User-mode-generate_002c-option_002c-paper"></span><h4 class="appendixsubsec">B.9.3 User mode generate, option, paper</h4> <p>In user mode, these actions operate only on the user tree’s configuration files and/or <code>texlive.tlpdb</code>. -creates configuration files in user tree </p> <hr> -<span id="tlmgr-MULTIPLE-REPOSITORIES"></span><div class="header"> +</div> +</div> +<div class="appendixsec" id="tlmgr-MULTIPLE-REPOSITORIES"> +<div class="header"> <p> -Next: <a href="#tlmgr-GUI-FOR-TLMGR" accesskey="n" rel="next">tlmgr GUI FOR TLMGR</a>, Previous: <a href="#tlmgr-USER-MODE" accesskey="p" rel="prev">tlmgr USER MODE</a>, Up: <a href="#tlmgr" accesskey="u" rel="up">tlmgr</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="#tlmgr-GUI-FOR-TLMGR" accesskey="n" rel="next">GUI FOR TLMGR</a>, Previous: <a href="#tlmgr-USER-MODE" accesskey="p" rel="prev">USER MODE</a>, Up: <a href="#tlmgr" accesskey="u" rel="up">tlmgr</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="MULTIPLE-REPOSITORIES"></span><h3 class="appendixsec">B.10 MULTIPLE REPOSITORIES</h3> @@ -6249,15 +6354,15 @@ anything from there. You also have to specify which packages should be taken from the new repository, by specifying so-called “pinning” rules, described next. </p> -<table class="menu" border="0" cellspacing="0"> -<tr><td align="left" valign="top">• <a href="#tlmgr-Pinning" accesskey="1">tlmgr Pinning</a></td><td> </td><td align="left" valign="top"> -</td></tr> -</table> +<ul class="section-toc"> +<li><a href="#tlmgr-Pinning" accesskey="1">Pinning</a></li> +</ul> <hr> -<span id="tlmgr-Pinning"></span><div class="header"> +<div class="appendixsubsec" id="tlmgr-Pinning"> +<div class="header"> <p> -Up: <a href="#tlmgr-MULTIPLE-REPOSITORIES" accesskey="u" rel="up">tlmgr MULTIPLE REPOSITORIES</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> +Up: <a href="#tlmgr-MULTIPLE-REPOSITORIES" accesskey="u" rel="up">MULTIPLE REPOSITORIES</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="Pinning"></span><h4 class="appendixsubsec">B.10.1 Pinning</h4> @@ -6320,9 +6425,12 @@ from a given repository: <p>A summary of <code>tlmgr pinning</code> actions is given above. </p> <hr> -<span id="tlmgr-GUI-FOR-TLMGR"></span><div class="header"> +</div> +</div> +<div class="appendixsec" id="tlmgr-GUI-FOR-TLMGR"> +<div class="header"> <p> -Next: <a href="#tlmgr-MACHINE_002dREADABLE-OUTPUT" accesskey="n" rel="next">tlmgr MACHINE-READABLE OUTPUT</a>, Previous: <a href="#tlmgr-MULTIPLE-REPOSITORIES" accesskey="p" rel="prev">tlmgr MULTIPLE REPOSITORIES</a>, Up: <a href="#tlmgr" accesskey="u" rel="up">tlmgr</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="#tlmgr-MACHINE_002dREADABLE-OUTPUT" accesskey="n" rel="next">MACHINE-READABLE OUTPUT</a>, Previous: <a href="#tlmgr-MULTIPLE-REPOSITORIES" accesskey="p" rel="prev">MULTIPLE REPOSITORIES</a>, Up: <a href="#tlmgr" accesskey="u" rel="up">tlmgr</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="GUI-FOR-TLMGR"></span><h3 class="appendixsec">B.11 GUI FOR TLMGR</h3> @@ -6354,35 +6462,31 @@ repository. To load a different repository, see the <code>tlmgr</code> menu ite <p>Finally, the status area at the bottom of the window gives additional information about what is going on. </p> -<table class="menu" border="0" cellspacing="0"> -<tr><td align="left" valign="top">• <a href="#tlmgr-Main-display" accesskey="1">tlmgr Main display</a></td><td> </td><td align="left" valign="top"> -</td></tr> -<tr><td align="left" valign="top">• <a href="#tlmgr-Menu-bar" accesskey="2">tlmgr Menu bar</a></td><td> </td><td align="left" valign="top"> -</td></tr> -<tr><td align="left" valign="top">• <a href="#tlmgr-GUI-options" accesskey="3">tlmgr GUI options</a></td><td> </td><td align="left" valign="top"> -</td></tr> -</table> +<ul class="section-toc"> +<li><a href="#tlmgr-Main-display" accesskey="1">Main display</a></li> +<li><a href="#tlmgr-Menu-bar" accesskey="2">Menu bar</a></li> +<li><a href="#tlmgr-GUI-options" accesskey="3">GUI options</a></li> +</ul> <hr> -<span id="tlmgr-Main-display"></span><div class="header"> +<div class="appendixsubsec" id="tlmgr-Main-display"> +<div class="header"> <p> -Next: <a href="#tlmgr-Menu-bar" accesskey="n" rel="next">tlmgr Menu bar</a>, Up: <a href="#tlmgr-GUI-FOR-TLMGR" accesskey="u" rel="up">tlmgr GUI FOR TLMGR</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="#tlmgr-Menu-bar" accesskey="n" rel="next">Menu bar</a>, Up: <a href="#tlmgr-GUI-FOR-TLMGR" accesskey="u" rel="up">GUI FOR TLMGR</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="Main-display"></span><h4 class="appendixsubsec">B.11.1 Main display</h4> -<table class="menu" border="0" cellspacing="0"> -<tr><td align="left" valign="top">• <a href="#tlmgr-Display-configuration-area" accesskey="1">tlmgr Display configuration area</a></td><td> </td><td align="left" valign="top"> -</td></tr> -<tr><td align="left" valign="top">• <a href="#tlmgr-Package-list-area" accesskey="2">tlmgr Package list area</a></td><td> </td><td align="left" valign="top"> -</td></tr> -<tr><td align="left" valign="top">• <a href="#tlmgr-Main-display-action-buttons" accesskey="3">tlmgr Main display action buttons</a></td><td> </td><td align="left" valign="top"> -</td></tr> -</table> +<ul class="section-toc"> +<li><a href="#tlmgr-Display-configuration-area" accesskey="1">Display configuration area</a></li> +<li><a href="#tlmgr-Package-list-area" accesskey="2">Package list area</a></li> +<li><a href="#tlmgr-Main-display-action-buttons" accesskey="3">Main display action buttons</a></li> +</ul> <hr> -<span id="tlmgr-Display-configuration-area"></span><div class="header"> +<div class="appendixsubsubsec" id="tlmgr-Display-configuration-area"> +<div class="header"> <p> -Next: <a href="#tlmgr-Package-list-area" accesskey="n" rel="next">tlmgr Package list area</a>, Up: <a href="#tlmgr-Main-display" accesskey="u" rel="up">tlmgr Main display</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="#tlmgr-Package-list-area" accesskey="n" rel="next">Package list area</a>, Up: <a href="#tlmgr-Main-display" accesskey="u" rel="up">Main display</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="Display-configuration-area"></span><h4 class="appendixsubsubsec">B.11.1.1 Display configuration area</h4> @@ -6391,34 +6495,34 @@ packages are shown. By default, all are shown. Changes here are reflected right away. </p> <dl compact="compact"> -<dt>Status</dt> +<dt><span>Status</span></dt> <dd><span id="tlmgr-Status"></span> <p>Select whether to show all packages (the default), only those installed, only those <em>not</em> installed, or only those with update available. </p> </dd> -<dt>Category</dt> +<dt><span>Category</span></dt> <dd><span id="tlmgr-Category"></span> <p>Select which categories are shown: packages, collections, and/or schemes. These are briefly explained in the <a href="#tlmgr-DESCRIPTION">DESCRIPTION</a> section above. </p> </dd> -<dt>Match</dt> +<dt><span>Match</span></dt> <dd><span id="tlmgr-Match"></span> <p>Select packages matching for a specific pattern. By default, this searches both descriptions and filenames. You can also select a subset for searching. </p> </dd> -<dt>Selection</dt> +<dt><span>Selection</span></dt> <dd><span id="tlmgr-Selection"></span> <p>Select packages to those selected, those not selected, or all. Here, “selected” means that the checkbox in the beginning of the line of a package is ticked. </p> </dd> -<dt>Display configuration buttons</dt> +<dt><span>Display configuration buttons</span></dt> <dd><span id="tlmgr-Display-configuration-buttons"></span> <p>To the right there are three buttons: select all packages, select none (a.k.a. deselect all), and reset all these filters to the defaults, @@ -6428,9 +6532,11 @@ i.e., show all available. </dl> <hr> -<span id="tlmgr-Package-list-area"></span><div class="header"> +</div> +<div class="appendixsubsubsec" id="tlmgr-Package-list-area"> +<div class="header"> <p> -Next: <a href="#tlmgr-Main-display-action-buttons" accesskey="n" rel="next">tlmgr Main display action buttons</a>, Previous: <a href="#tlmgr-Display-configuration-area" accesskey="p" rel="prev">tlmgr Display configuration area</a>, Up: <a href="#tlmgr-Main-display" accesskey="u" rel="up">tlmgr Main display</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="#tlmgr-Main-display-action-buttons" accesskey="n" rel="next">Main display action buttons</a>, Previous: <a href="#tlmgr-Display-configuration-area" accesskey="p" rel="prev">Display configuration area</a>, Up: <a href="#tlmgr-Main-display" accesskey="u" rel="up">Main display</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="Package-list-area"></span><h4 class="appendixsubsubsec">B.11.1.2 Package list area</h4> @@ -6444,18 +6550,18 @@ further details: the long description, included files, etc. <p>Each line of the package list consists of the following items: </p> <dl compact="compact"> -<dt>a checkbox</dt> +<dt><span>a checkbox</span></dt> <dd><span id="tlmgr-a-checkbox"></span> <p>Used to select particular packages; some of the action buttons (see below) work only on the selected packages. </p> </dd> -<dt>package name</dt> +<dt><span>package name</span></dt> <dd><span id="tlmgr-package-name"></span> <p>The name (identifier) of the package as given in the database. </p> </dd> -<dt>local revision (and version)</dt> +<dt><span>local revision (and version)</span></dt> <dd><span id="tlmgr-local-revision-_0028and-version_0029"></span> <p>If the package is installed the TeX Live revision number for the installed package will be shown. If there is a catalogue version given @@ -6464,7 +6570,7 @@ However, the catalogue version, unlike the TL revision, is not guaranteed to reflect what is actually installed. </p> </dd> -<dt>remote revision (and version)</dt> +<dt><span>remote revision (and version)</span></dt> <dd><span id="tlmgr-remote-revision-_0028and-version_0029"></span> <p>If a repository has been loaded the revision of the package in the repository (if present) is shown. As with the local column, if a @@ -6472,7 +6578,7 @@ catalogue version is provided it will be displayed. And also as with the local column, the catalogue version may be stale. </p> </dd> -<dt>short description</dt> +<dt><span>short description</span></dt> <dd><span id="tlmgr-short-description"></span> <p>The short description of the package. </p> @@ -6480,16 +6586,18 @@ the local column, the catalogue version may be stale. </dl> <hr> -<span id="tlmgr-Main-display-action-buttons"></span><div class="header"> +</div> +<div class="appendixsubsubsec" id="tlmgr-Main-display-action-buttons"> +<div class="header"> <p> -Previous: <a href="#tlmgr-Package-list-area" accesskey="p" rel="prev">tlmgr Package list area</a>, Up: <a href="#tlmgr-Main-display" accesskey="u" rel="up">tlmgr Main display</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="#tlmgr-Package-list-area" accesskey="p" rel="prev">Package list area</a>, Up: <a href="#tlmgr-Main-display" accesskey="u" rel="up">Main display</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="Main-display-action-buttons"></span><h4 class="appendixsubsubsec">B.11.1.3 Main display action buttons</h4> <p>Below the list of packages are several buttons: </p> <dl compact="compact"> -<dt>Update all installed</dt> +<dt><span>Update all installed</span></dt> <dd><span id="tlmgr-Update-all-installed"></span> <p>This calls <code>tlmgr update --all</code>, i.e., tries to update all available packages. Below this button is a toggle to allow reinstallation of @@ -6499,26 +6607,26 @@ previously removed packages as part of this action. where the checkbox at the beginning of the package line is ticked. </p> </dd> -<dt>Update</dt> +<dt><span>Update</span></dt> <dd><span id="tlmgr-Update"></span> <p>Update only the selected packages. </p> </dd> -<dt>Install</dt> +<dt><span>Install</span></dt> <dd><span id="tlmgr-Install"></span> <p>Install the selected packages; acts like <code>tlmgr install</code>, i.e., also installs dependencies. Thus, installing a collection installs all its constituent packages. </p> </dd> -<dt>Remove</dt> +<dt><span>Remove</span></dt> <dd><span id="tlmgr-Remove"></span> <p>Removes the selected packages; acts like <code>tlmgr remove</code>, i.e., it will also remove dependencies of collections (but not dependencies of normal packages). </p> </dd> -<dt>Backup</dt> +<dt><span>Backup</span></dt> <dd><span id="tlmgr-Backup"></span> <p>Makes a backup of the selected packages; acts like <code>tlmgr backup</code>. This action needs the option <code>backupdir</code> set (see <code>Options -</code> General>). @@ -6527,16 +6635,19 @@ action needs the option <code>backupdir</code> set (see <code>Options -</code> G </dl> <hr> -<span id="tlmgr-Menu-bar"></span><div class="header"> +</div> +</div> +<div class="appendixsubsec" id="tlmgr-Menu-bar"> +<div class="header"> <p> -Next: <a href="#tlmgr-GUI-options" accesskey="n" rel="next">tlmgr GUI options</a>, Previous: <a href="#tlmgr-Main-display" accesskey="p" rel="prev">tlmgr Main display</a>, Up: <a href="#tlmgr-GUI-FOR-TLMGR" accesskey="u" rel="up">tlmgr GUI FOR TLMGR</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="#tlmgr-GUI-options" accesskey="n" rel="next">GUI options</a>, Previous: <a href="#tlmgr-Main-display" accesskey="p" rel="prev">Main display</a>, Up: <a href="#tlmgr-GUI-FOR-TLMGR" accesskey="u" rel="up">GUI FOR TLMGR</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="Menu-bar"></span><h4 class="appendixsubsec">B.11.2 Menu bar</h4> <p>The following entries can be found in the menu bar: </p> <dl compact="compact"> -<dt><code>tlmgr</code> menu</dt> +<dt><span><code>tlmgr</code> menu</span></dt> <dd><span id="tlmgr-tlmgr-menu"></span> <p>The items here load various repositories: the default as specified in the TeX Live database, the default network repository, the repository @@ -6544,7 +6655,7 @@ specified on the command line (if any), and an arbitrarily manually-entered one. Also has the so-necessary <code>quit</code> operation. </p> </dd> -<dt><code>Options menu</code></dt> +<dt><span><code>Options menu</code></span></dt> <dd><span id="tlmgr-Options-menu"></span> <p>Provides access to several groups of options: <code>Paper</code> (configuration of default paper sizes), <code>Platforms</code> (only on Unix, configuration of the @@ -6564,7 +6675,7 @@ choices of what is or isn’t installed may lead to an inconsistent TeX Live installation; e.g., when a package is renamed. </p> </dd> -<dt><code>Actions menu</code></dt> +<dt><span><code>Actions menu</code></span></dt> <dd><span id="tlmgr-Actions-menu"></span> <p>Provides access to several actions: update the filename database (aka <code>ls-R</code>, <code>mktexlsr</code>, <code>texhash</code>), rebuild all formats (<code>fmtutil-sys @@ -6576,7 +6687,7 @@ Windows). on Windows). </p> </dd> -<dt><code>Help menu</code></dt> +<dt><span><code>Help menu</code></span></dt> <dd><span id="tlmgr-Help-menu"></span> <p>Provides access to the TeX Live manual (also on the web at <a href="https://tug.org/texlive/doc.html">https://tug.org/texlive/doc.html</a>) and the usual “About” box. @@ -6585,9 +6696,11 @@ on Windows). </dl> <hr> -<span id="tlmgr-GUI-options"></span><div class="header"> +</div> +<div class="appendixsubsec" id="tlmgr-GUI-options"> +<div class="header"> <p> -Previous: <a href="#tlmgr-Menu-bar" accesskey="p" rel="prev">tlmgr Menu bar</a>, Up: <a href="#tlmgr-GUI-FOR-TLMGR" accesskey="u" rel="up">tlmgr GUI FOR TLMGR</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="#tlmgr-Menu-bar" accesskey="p" rel="prev">Menu bar</a>, Up: <a href="#tlmgr-GUI-FOR-TLMGR" accesskey="u" rel="up">GUI FOR TLMGR</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="GUI-options"></span><h4 class="appendixsubsec">B.11.3 GUI options</h4> @@ -6595,30 +6708,30 @@ Previous: <a href="#tlmgr-Menu-bar" accesskey="p" rel="prev">tlmgr Menu bar</a>, control the display: </p> <dl compact="compact"> -<dt><code>-background</code> <em>color</em></dt> +<dt><span><code>-background</code> <em>color</em></span></dt> <dd><span id="tlmgr-_002dbackground-color"></span> <p>Set background color. </p> </dd> -<dt><code>-font "</code> <em>fontname</em> <em>fontsize</em> <code>"</code></dt> +<dt><span><code>-font "</code> <em>fontname</em> <em>fontsize</em> <code>"</code></span></dt> <dd><span id="tlmgr-_002dfont-_0022-fontname-fontsize-_0022"></span> <p>Set font, e.g., <code>tlmgr gui -font "helvetica 18"</code>. The argument to <code>-font</code> must be quoted, i.e., passed as a single string. </p> </dd> -<dt><code>-foreground</code> <em>color</em></dt> +<dt><span><code>-foreground</code> <em>color</em></span></dt> <dd><span id="tlmgr-_002dforeground-color"></span> <p>Set foreground color. </p> </dd> -<dt><code>-geometry</code> <em>geomspec</em></dt> +<dt><span><code>-geometry</code> <em>geomspec</em></span></dt> <dd><span id="tlmgr-_002dgeometry-geomspec"></span> <p>Set the X geometry, e.g., <code>tlmgr gui -geometry 1024x512-0+0</code> creates the window of (approximately) the given size in the upper-right corner of the display. </p> </dd> -<dt><code>-xrm</code> <em>xresource</em></dt> +<dt><span><code>-xrm</code> <em>xresource</em></span></dt> <dd><span id="tlmgr-_002dxrm-xresource"></span> <p>Pass the arbitrary X resource string <em>xresource</em>. </p> @@ -6630,9 +6743,12 @@ the Perl/Tk documentation (<a href="https://search.cpan.org/perldoc?Tk">https:// complete list, and any X documentation for general information. </p> <hr> -<span id="tlmgr-MACHINE_002dREADABLE-OUTPUT"></span><div class="header"> +</div> +</div> +<div class="appendixsec" id="tlmgr-MACHINE_002dREADABLE-OUTPUT"> +<div class="header"> <p> -Next: <a href="#tlmgr-ENVIRONMENT-VARIABLES" accesskey="n" rel="next">tlmgr ENVIRONMENT VARIABLES</a>, Previous: <a href="#tlmgr-GUI-FOR-TLMGR" accesskey="p" rel="prev">tlmgr GUI FOR TLMGR</a>, Up: <a href="#tlmgr" accesskey="u" rel="up">tlmgr</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="#tlmgr-ENVIRONMENT-VARIABLES" accesskey="n" rel="next">ENVIRONMENT VARIABLES</a>, Previous: <a href="#tlmgr-GUI-FOR-TLMGR" accesskey="p" rel="prev">GUI FOR TLMGR</a>, Up: <a href="#tlmgr" accesskey="u" rel="up">tlmgr</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="MACHINE_002dREADABLE-OUTPUT"></span><h3 class="appendixsec">B.12 MACHINE-READABLE OUTPUT</h3> @@ -6647,17 +6763,16 @@ information it needs by reading stdout. <a href="#tlmgr-install-_005boption_002e_002e_002e_005d-pkg_002e_002e_002e">install</a>, and <a href="#tlmgr-option">option</a> actions. </p> -<table class="menu" border="0" cellspacing="0"> -<tr><td align="left" valign="top">• <a href="#tlmgr-Machine_002dreadable-update-and-install-output" accesskey="1">tlmgr Machine-readable <code>update</code> and <code>install</code> output</a></td><td> </td><td align="left" valign="top"> -</td></tr> -<tr><td align="left" valign="top">• <a href="#tlmgr-Machine_002dreadable-option-output" accesskey="2">tlmgr Machine-readable <code>option</code> output</a></td><td> </td><td align="left" valign="top"> -</td></tr> -</table> +<ul class="section-toc"> +<li><a href="#tlmgr-Machine_002dreadable-update-and-install-output" accesskey="1">Machine-readable <code>update</code> and <code>install</code> output</a></li> +<li><a href="#tlmgr-Machine_002dreadable-option-output" accesskey="2">Machine-readable <code>option</code> output</a></li> +</ul> <hr> -<span id="tlmgr-Machine_002dreadable-update-and-install-output"></span><div class="header"> +<div class="appendixsubsec" id="tlmgr-Machine_002dreadable-update-and-install-output"> +<div class="header"> <p> -Next: <a href="#tlmgr-Machine_002dreadable-option-output" accesskey="n" rel="next">tlmgr Machine-readable <code>option</code> output</a>, Up: <a href="#tlmgr-MACHINE_002dREADABLE-OUTPUT" accesskey="u" rel="up">tlmgr MACHINE-READABLE OUTPUT</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="#tlmgr-Machine_002dreadable-option-output" accesskey="n" rel="next">Machine-readable <code>option</code> output</a>, Up: <a href="#tlmgr-MACHINE_002dREADABLE-OUTPUT" accesskey="u" rel="up">MACHINE-READABLE OUTPUT</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="Machine_002dreadable-update-and-install-output"></span><h4 class="appendixsubsec">B.12.1 Machine-readable <code>update</code> and <code>install</code> output</h4> @@ -6687,14 +6802,14 @@ and the estimated total time. <p>Line endings may be either LF or CRLF depending on the current platform. </p> <dl compact="compact"> -<dt><code>location-url</code> <em>location</em></dt> +<dt><span><code>location-url</code> <em>location</em></span></dt> <dd><span id="tlmgr-location_002durl-location"></span> <p>The <em>location</em> may be a url (including <code>file:///foo/bar/...</code>), or a directory name (<code>/foo/bar</code>). It is the package repository from which the new package information was drawn. </p> </dd> -<dt><code>total-bytes</code> <em>count</em></dt> +<dt><span><code>total-bytes</code> <em>count</em></span></dt> <dd><span id="tlmgr-total_002dbytes-count"></span> <p>The <em>count</em> is simply a decimal number, the sum of the sizes of all the packages that need updating or installing (which are listed subsequently). @@ -6709,54 +6824,54 @@ reports on one package. The fields on each line are separated by a tab. Here are the fields. </p> <dl compact="compact"> -<dt><em>pkgname</em></dt> +<dt><span><em>pkgname</em></span></dt> <dd><span id="tlmgr-pkgname"></span> <p>The TeX Live package identifier, with a possible platform suffix for executables. For instance, <code>pdftex</code> and <code>pdftex.i386-linux</code> are given as two separate packages, one on each line. </p> </dd> -<dt><em>status</em></dt> +<dt><span><em>status</em></span></dt> <dd><span id="tlmgr-status"></span> <p>The status of the package update. One character, as follows: </p> <dl compact="compact"> -<dt><code>d</code></dt> +<dt><span><code>d</code></span></dt> <dd><span id="tlmgr-d"></span> <p>The package was removed on the server. </p> </dd> -<dt><code>f</code></dt> +<dt><span><code>f</code></span></dt> <dd><span id="tlmgr-f"></span> <p>The package was removed in the local installation, even though a collection depended on it. (E.g., the user ran <code>tlmgr remove --force</code>.) </p> </dd> -<dt><code>u</code></dt> +<dt><span><code>u</code></span></dt> <dd><span id="tlmgr-u"></span> <p>Normal update is needed. </p> </dd> -<dt><code>r</code></dt> +<dt><span><code>r</code></span></dt> <dd><span id="tlmgr-r"></span> <p>Reversed non-update: the locally-installed version is newer than the version on the server. </p> </dd> -<dt><code>a</code></dt> +<dt><span><code>a</code></span></dt> <dd><span id="tlmgr-a"></span> <p>Automatically-determined need for installation, the package is new on the server and is (most probably) part of an installed collection. </p> </dd> -<dt><code>i</code></dt> +<dt><span><code>i</code></span></dt> <dd><span id="tlmgr-i"></span> <p>Package will be installed and isn’t present in the local installation (action install). </p> </dd> -<dt><code>I</code></dt> +<dt><span><code>I</code></span></dt> <dd><span id="tlmgr-I"></span> <p>Package is already present but will be reinstalled (action install). </p> @@ -6764,30 +6879,30 @@ the server and is (most probably) part of an installed collection. </dl> </dd> -<dt><em>localrev</em></dt> +<dt><span><em>localrev</em></span></dt> <dd><span id="tlmgr-localrev"></span> <p>The revision number of the installed package, or <code>-</code> if it is not present locally. </p> </dd> -<dt><em>serverrev</em></dt> +<dt><span><em>serverrev</em></span></dt> <dd><span id="tlmgr-serverrev"></span> <p>The revision number of the package on the server, or <code>-</code> if it is not present on the server. </p> </dd> -<dt><em>size</em></dt> +<dt><span><em>size</em></span></dt> <dd><span id="tlmgr-size"></span> <p>The size in bytes of the package on the server. The sum of all the package sizes is given in the <code>total-bytes</code> header field mentioned above. </p> </dd> -<dt><em>runtime</em></dt> +<dt><span><em>runtime</em></span></dt> <dd><span id="tlmgr-runtime"></span> <p>The run time since start of installations or updates. </p> </dd> -<dt><em>esttot</em></dt> +<dt><span><em>esttot</em></span></dt> <dd><span id="tlmgr-esttot"></span> <p>The estimated total time. </p> @@ -6795,9 +6910,11 @@ package sizes is given in the <code>total-bytes</code> header field mentioned ab </dl> <hr> -<span id="tlmgr-Machine_002dreadable-option-output"></span><div class="header"> +</div> +<div class="appendixsubsec" id="tlmgr-Machine_002dreadable-option-output"> +<div class="header"> <p> -Previous: <a href="#tlmgr-Machine_002dreadable-update-and-install-output" accesskey="p" rel="prev">tlmgr Machine-readable <code>update</code> and <code>install</code> output</a>, Up: <a href="#tlmgr-MACHINE_002dREADABLE-OUTPUT" accesskey="u" rel="up">tlmgr MACHINE-READABLE OUTPUT</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="#tlmgr-Machine_002dreadable-update-and-install-output" accesskey="p" rel="prev">Machine-readable <code>update</code> and <code>install</code> output</a>, Up: <a href="#tlmgr-MACHINE_002dREADABLE-OUTPUT" accesskey="u" rel="up">MACHINE-READABLE OUTPUT</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="Machine_002dreadable-option-output"></span><h4 class="appendixsubsec">B.12.2 Machine-readable <code>option</code> output</h4> @@ -6811,9 +6928,12 @@ Previous: <a href="#tlmgr-Machine_002dreadable-update-and-install-output" access changes would be helpful, do not hesitate to write the mailing list. </p> <hr> -<span id="tlmgr-ENVIRONMENT-VARIABLES"></span><div class="header"> +</div> +</div> +<div class="appendixsec" id="tlmgr-ENVIRONMENT-VARIABLES"> +<div class="header"> <p> -Next: <a href="#tlmgr-AUTHORS-AND-COPYRIGHT" accesskey="n" rel="next">tlmgr AUTHORS AND COPYRIGHT</a>, Previous: <a href="#tlmgr-MACHINE_002dREADABLE-OUTPUT" accesskey="p" rel="prev">tlmgr MACHINE-READABLE OUTPUT</a>, Up: <a href="#tlmgr" accesskey="u" rel="up">tlmgr</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="#tlmgr-AUTHORS-AND-COPYRIGHT" accesskey="n" rel="next">AUTHORS AND COPYRIGHT</a>, Previous: <a href="#tlmgr-MACHINE_002dREADABLE-OUTPUT" accesskey="p" rel="prev">MACHINE-READABLE OUTPUT</a>, Up: <a href="#tlmgr" accesskey="u" rel="up">tlmgr</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="appendixsec">B.13 ENVIRONMENT VARIABLES</h3> @@ -6825,7 +6945,7 @@ following environment variables. These are not of interest for normal user installations. </p> <dl compact="compact"> -<dt><code>TEXLIVE_COMPRESSOR</code></dt> +<dt><span><code>TEXLIVE_COMPRESSOR</code></span></dt> <dd><span id="tlmgr-TEXLIVE_005fCOMPRESSOR"></span> <p>This variable allows selecting a different compressor program for backups and intermediate rollback containers. The order of selection is: @@ -6848,13 +6968,13 @@ are preferred. The unconditional use of xz for the tlnet containers is unaffected, to minimize download sizes. </p> </dd> -<dt><code>TEXLIVE_DOWNLOADER</code></dt> +<dt><span><code>TEXLIVE_DOWNLOADER</code></span></dt> <dd><span id="tlmgr-TEXLIVE_005fDOWNLOADER"></span> </dd> -<dt><code>TL_DOWNLOAD_PROGRAM</code></dt> +<dt><span><code>TL_DOWNLOAD_PROGRAM</code></span></dt> <dd><span id="tlmgr-TL_005fDOWNLOAD_005fPROGRAM"></span> </dd> -<dt><code>TL_DOWNLOAD_ARGS</code></dt> +<dt><span><code>TL_DOWNLOAD_ARGS</code></span></dt> <dd><span id="tlmgr-TL_005fDOWNLOAD_005fARGS"></span> <p>These options allow selecting different download programs then the ones automatically selected by the installer. The order of selection is: @@ -6881,7 +7001,7 @@ efficient method, as it supports persistent downloads). download method should always be available. </p> </dd> -<dt><code>TEXLIVE_PREFER_OWN</code></dt> +<dt><span><code>TEXLIVE_PREFER_OWN</code></span></dt> <dd><span id="tlmgr-TEXLIVE_005fPREFER_005fOWN"></span> <p>By default, compression and download programs provided by the system, i.e., found along <code>PATH</code> are preferred over those shipped with TeX @@ -6904,9 +7024,11 @@ regardless of any setting. </dl> <hr> -<span id="tlmgr-AUTHORS-AND-COPYRIGHT"></span><div class="header"> +</div> +<div class="appendixsec" id="tlmgr-AUTHORS-AND-COPYRIGHT"> +<div class="header"> <p> -Previous: <a href="#tlmgr-ENVIRONMENT-VARIABLES" accesskey="p" rel="prev">tlmgr ENVIRONMENT VARIABLES</a>, Up: <a href="#tlmgr" accesskey="u" rel="up">tlmgr</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="#tlmgr-ENVIRONMENT-VARIABLES" accesskey="p" rel="prev">ENVIRONMENT VARIABLES</a>, Up: <a href="#tlmgr" accesskey="u" rel="up">tlmgr</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="AUTHORS-AND-COPYRIGHT-1"></span><h3 class="appendixsec">B.14 AUTHORS AND COPYRIGHT</h3> @@ -6914,17 +7036,22 @@ Previous: <a href="#tlmgr-ENVIRONMENT-VARIABLES" accesskey="p" rel="prev">tlmgr distribution (<a href="https://tug.org/texlive">https://tug.org/texlive</a>) and both are licensed under the GNU General Public License Version 2 or later. </p> -<p>$Id: tlmgr.pl 57970 2021-02-27 14:17:34Z siepo $ +<p>$Id: tlmgr.pl 62273 2022-02-28 08:52:17Z preining $ </p> <hr> -<span id="Index"></span><div class="header"> +</div> +</div> +<div class="unnumbered" id="Index"> +<div class="header"> <p> -Previous: <a href="#tlmgr" accesskey="p" rel="prev">tlmgr</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="#tlmgr" accesskey="p" rel="prev">tlmgr</a>, Up: <a href="#Top" accesskey="u" rel="up">Building TeX Live (2022)</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> -<table><tr><th valign="top">Jump to: </th><td><a class="summary-letter" href="#Index_cp_symbol-1"><b>-</b></a> +<table><tr><th valign="top">Jump to: </th><td><a class="summary-letter" href="#Index_cp_symbol-1"><b>$</b></a> + +<a class="summary-letter" href="#Index_cp_symbol-2"><b>-</b></a> <br> <a class="summary-letter" href="#Index_cp_letter-A"><b>A</b></a> @@ -6941,6 +7068,8 @@ Previous: <a href="#tlmgr" accesskey="p" rel="prev">tlmgr</a>, Up: <a href="#Top <a class="summary-letter" href="#Index_cp_letter-G"><b>G</b></a> +<a class="summary-letter" href="#Index_cp_letter-H"><b>H</b></a> + <a class="summary-letter" href="#Index_cp_letter-I"><b>I</b></a> <a class="summary-letter" href="#Index_cp_letter-K"><b>K</b></a> @@ -6975,7 +7104,10 @@ Previous: <a href="#tlmgr" accesskey="p" rel="prev">tlmgr</a>, Up: <a href="#Top <table class="index-cp" border="0"> <tr><td></td><th align="left">Index Entry</th><td> </td><th align="left"> Section</th></tr> <tr><td colspan="4"> <hr></td></tr> -<tr><th id="Index_cp_symbol-1">-</th><td></td><td></td></tr> +<tr><th id="Index_cp_symbol-1">$</th><td></td><td></td></tr> +<tr><td></td><td valign="top"><a href="#index-_0024_0040-target-in-normal-make-rules"><code>$@</code> target in normal <code>make</code> rules</a>:</td><td> </td><td valign="top"><a href="#Prerequisites">Prerequisites</a></td></tr> +<tr><td colspan="4"> <hr></td></tr> +<tr><th id="Index_cp_symbol-2">-</th><td></td><td></td></tr> <tr><td></td><td valign="top"><a href="#index-_002d_002dbindir-configure-option"><code>--bindir configure <span class="roman">option</span></code></a>:</td><td> </td><td valign="top"><a href="#g_t_002d_002dprefix-_002d_002dbindir-_2026"><code>--prefix</code> <code>--bindir</code> …</a></td></tr> <tr><td></td><td valign="top"><a href="#index-_002d_002dbindir-configure-option-1"><code>--bindir configure <span class="roman">option</span></code></a>:</td><td> </td><td valign="top"><a href="#g_t_002d_002denable_002dmultiplatform"><code>--enable-multiplatform</code></a></td></tr> <tr><td></td><td valign="top"><a href="#index-_002d_002dbuild_003dhost"><code>--build=<var>host</var></code></a>:</td><td> </td><td valign="top"><a href="#Cross-configuring">Cross configuring</a></td></tr> @@ -7018,7 +7150,7 @@ Previous: <a href="#tlmgr" accesskey="p" rel="prev">tlmgr</a>, Up: <a href="#Top <tr><td></td><td valign="top"><a href="#index-_002d_002denable_002dxindy_002drules"><code>--enable-xindy-rules</code></a>:</td><td> </td><td valign="top"><a href="#Configure-options-for-utils_002fxindy">Configure options for <samp>utils/xindy</samp></a></td></tr> <tr><td></td><td valign="top"><a href="#index-_002d_002dhost_003dhost"><code>--host=<var>host</var></code></a>:</td><td> </td><td valign="top"><a href="#Cross-configuring">Cross configuring</a></td></tr> <tr><td></td><td valign="top"><a href="#index-_002d_002dlibdir-configure-option"><code>--libdir configure <span class="roman">option</span></code></a>:</td><td> </td><td valign="top"><a href="#g_t_002d_002denable_002dmultiplatform"><code>--enable-multiplatform</code></a></td></tr> -<tr><td></td><td valign="top"><a href="#index-_002d_002dno_002dclean-Build-option"><code>--no-clean Build <span class="roman">option</span></code></a>:</td><td> </td><td valign="top"><a href="#Build-problems">Build problems</a></td></tr> +<tr><td></td><td valign="top"><a href="#index-_002d_002dno_002dprint_002ddirectory-GNU-make-option"><code>--no-print-directory <span class="roman">GNU make option</span></code></a>:</td><td> </td><td valign="top"><a href="#Build-one-engine">Build one engine</a></td></tr> <tr><td></td><td valign="top"><a href="#index-_002d_002dprefix-configure-option"><code>--prefix configure <span class="roman">option</span></code></a>:</td><td> </td><td valign="top"><a href="#g_t_002d_002dprefix-_002d_002dbindir-_2026"><code>--prefix</code> <code>--bindir</code> …</a></td></tr> <tr><td></td><td valign="top"><a href="#index-_002d_002dwith_002dbanner_002dadd_003dstr"><code>--with-banner-add=<var>str</var></code></a>:</td><td> </td><td valign="top"><a href="#Configure-options-for-texk_002fweb2c">Configure options for <samp>texk/web2c</samp></a></td></tr> <tr><td></td><td valign="top"><a href="#index-_002d_002dwith_002dclisp_002druntime_003dfilename"><code>--with-clisp-runtime=<var>filename</var></code></a>:</td><td> </td><td valign="top"><a href="#Configure-options-for-utils_002fxindy">Configure options for <samp>utils/xindy</samp></a></td></tr> @@ -7043,6 +7175,7 @@ Previous: <a href="#tlmgr" accesskey="p" rel="prev">tlmgr</a>, Up: <a href="#Top <tr><th id="Index_cp_letter-A">A</th><td></td><td></td></tr> <tr><td></td><td valign="top"><a href="#index-ac_002fwithenable_002eac"><code>ac/withenable.ac</code></a>:</td><td> </td><td valign="top"><a href="#Adding-a-new-program-module">Adding a new program module</a></td></tr> <tr><td></td><td valign="top"><a href="#index-adapting-TeX-Live-for-distros">adapting TeX Live for distros</a>:</td><td> </td><td valign="top"><a href="#Distro-builds">Distro builds</a></td></tr> +<tr><td></td><td valign="top"><a href="#index-adding-a-new-engine">adding a new engine</a>:</td><td> </td><td valign="top"><a href="#Adding-a-new-engine">Adding a new engine</a></td></tr> <tr><td></td><td valign="top"><a href="#index-adding-a-new-generic-library">adding a new generic library</a>:</td><td> </td><td valign="top"><a href="#Adding-a-new-generic-library-module">Adding a new generic library module</a></td></tr> <tr><td></td><td valign="top"><a href="#index-adding-a-new-program">adding a new program</a>:</td><td> </td><td valign="top"><a href="#Adding-a-new-program-module">Adding a new program module</a></td></tr> <tr><td></td><td valign="top"><a href="#index-adding-a-new-TeX_002dspecific-library">adding a new TeX-specific library</a>:</td><td> </td><td valign="top"><a href="#Adding-a-new-TeX_002dspecific-library-module">Adding a new TeX-specific library module</a></td></tr> @@ -7068,7 +7201,6 @@ Previous: <a href="#tlmgr" accesskey="p" rel="prev">tlmgr</a>, Up: <a href="#Top <tr><td></td><td valign="top"><a href="#index-build-on-demand">build on demand</a>:</td><td> </td><td valign="top"><a href="#Build-one-package">Build one package</a></td></tr> <tr><td></td><td valign="top"><a href="#index-build-one-engine">build one engine</a>:</td><td> </td><td valign="top"><a href="#Build-one-engine">Build one engine</a></td></tr> <tr><td></td><td valign="top"><a href="#index-build-one-package">build one package</a>:</td><td> </td><td valign="top"><a href="#Build-one-package">Build one package</a></td></tr> -<tr><td></td><td valign="top"><a href="#index-build-problems">build problems</a>:</td><td> </td><td valign="top"><a href="#Build-problems">Build problems</a></td></tr> <tr><td></td><td valign="top"><a href="#index-Build-script"><code>Build <span class="roman">script</span></code></a>:</td><td> </td><td valign="top"><a href="#Building">Building</a></td></tr> <tr><td></td><td valign="top"><a href="#index-build-system_002c-design-of">build system, design of</a>:</td><td> </td><td valign="top"><a href="#Overview-of-build-system">Overview of build system</a></td></tr> <tr><td></td><td valign="top"><a href="#index-build_002daux_002f-top_002dlevel-directory"><samp>build-aux/</samp> top-level directory</a>:</td><td> </td><td valign="top"><a href="#Top_002dlevel-directories">Top-level directories</a></td></tr> @@ -7110,6 +7242,7 @@ Previous: <a href="#tlmgr" accesskey="p" rel="prev">tlmgr</a>, Up: <a href="#Top <tr><td></td><td valign="top"><a href="#index-configure-options_002c-global"><code>configure</code> options, global</a>:</td><td> </td><td valign="top"><a href="#Global-configure-options">Global configure options</a></td></tr> <tr><td></td><td valign="top"><a href="#index-configure-options_002c-library_002dspecific"><code>configure</code> options, library-specific</a>:</td><td> </td><td valign="top"><a href="#Library_002dspecific-configure-options">Library-specific configure options</a></td></tr> <tr><td></td><td valign="top"><a href="#index-configure-options_002c-program_002dspecific"><code>configure</code> options, program-specific</a>:</td><td> </td><td valign="top"><a href="#Program_002dspecific-configure-options">Program-specific configure options</a></td></tr> +<tr><td></td><td valign="top"><a href="#index-configure-problems_002c-work-around-by-removing"><code>configure</code> problems, work around by removing</a>:</td><td> </td><td valign="top"><a href="#Build-one-package">Build one package</a></td></tr> <tr><td></td><td valign="top"><a href="#index-configure-variables"><code>configure</code> variables</a>:</td><td> </td><td valign="top"><a href="#Variables-for-configure">Variables for configure</a></td></tr> <tr><td></td><td valign="top"><a href="#index-configure_002eac"><code>configure.ac</code></a>:</td><td> </td><td valign="top"><a href="#Adding-a-new-program-module">Adding a new program module</a></td></tr> <tr><td></td><td valign="top"><a href="#index-configuring_002c-for-cross-compilation">configuring, for cross compilation</a>:</td><td> </td><td valign="top"><a href="#Cross-configuring">Cross configuring</a></td></tr> @@ -7139,9 +7272,10 @@ Previous: <a href="#tlmgr" accesskey="p" rel="prev">tlmgr</a>, Up: <a href="#Top <tr><td></td><td valign="top"><a href="#index-dvipdfm_002dx"><code>dvipdfm-x</code></a>:</td><td> </td><td valign="top"><a href="#Configure-options-for-texk_002fdvipdfm_002dx">Configure options for <samp>texk/dvipdfm-x</samp></a></td></tr> <tr><td></td><td valign="top"><a href="#index-dvipdfmx"><code>dvipdfmx</code></a>:</td><td> </td><td valign="top"><a href="#Configure-options-for-texk_002fdvipdfm_002dx">Configure options for <samp>texk/dvipdfm-x</samp></a></td></tr> <tr><td></td><td valign="top"><a href="#index-dvisvgm"><code>dvisvgm</code></a>:</td><td> </td><td valign="top"><a href="#Configure-options-for-texk_002fdvisvgm">Configure options for <samp>texk/dvisvgm</samp></a></td></tr> +<tr><td></td><td valign="top"><a href="#index-dvisvgm_002c-requires-C_002b_002b11"><code>dvisvgm</code>, requires C++11</a>:</td><td> </td><td valign="top"><a href="#Prerequisites">Prerequisites</a></td></tr> <tr><td colspan="4"> <hr></td></tr> <tr><th id="Index_cp_letter-E">E</th><td></td><td></td></tr> -<tr><td></td><td valign="top"><a href="#index-engine_002c-adding-new">engine, adding new</a>:</td><td> </td><td valign="top"><a href="#Adding-a-new-program-module">Adding a new program module</a></td></tr> +<tr><td></td><td valign="top"><a href="#index-engine_002c-adding-new">engine, adding new</a>:</td><td> </td><td valign="top"><a href="#Adding-a-new-engine">Adding a new engine</a></td></tr> <tr><td></td><td valign="top"><a href="#index-engine_002c-building-one">engine, building one</a>:</td><td> </td><td valign="top"><a href="#Build-one-engine">Build one engine</a></td></tr> <tr><td></td><td valign="top"><a href="#index-environment-variables_002c-for-configure">environment variables, for <code>configure</code></a>:</td><td> </td><td valign="top"><a href="#Configure-options">Configure options</a></td></tr> <tr><td></td><td valign="top"><a href="#index-exec_005fprefix"><code>exec_prefix</code></a>:</td><td> </td><td valign="top"><a href="#g_t_002d_002denable_002dmultiplatform"><code>--enable-multiplatform</code></a></td></tr> @@ -7149,12 +7283,11 @@ Previous: <a href="#tlmgr" accesskey="p" rel="prev">tlmgr</a>, Up: <a href="#Top <tr><td></td><td valign="top"><a href="#index-extern-functions"><code>extern</code> functions</a>:</td><td> </td><td valign="top"><a href="#Declarations-and-definitions">Declarations and definitions</a></td></tr> <tr><td colspan="4"> <hr></td></tr> <tr><th id="Index_cp_letter-F">F</th><td></td><td></td></tr> -<tr><td></td><td valign="top"><a href="#index-failure-to-build">failure to build</a>:</td><td> </td><td valign="top"><a href="#Build-problems">Build problems</a></td></tr> <tr><td></td><td valign="top"><a href="#index-flags_002c-macros-for-library-and-header">flags, macros for library and header</a>:</td><td> </td><td valign="top"><a href="#Macros-for-library-and-header-flags">Macros for library and header flags</a></td></tr> <tr><td></td><td valign="top"><a href="#index-fontconfig-library_002c-required-by-xetex"><code>fontconfig</code> library, required by <code>xetex</code></a>:</td><td> </td><td valign="top"><a href="#Prerequisites">Prerequisites</a></td></tr> -<tr><td></td><td valign="top"><a href="#index-FreeType">FreeType</a>:</td><td> </td><td valign="top"><a href="#Prerequisites">Prerequisites</a></td></tr> <tr><td></td><td valign="top"><a href="#index-freetype-cross-compiling"><code>freetype</code> cross compiling</a>:</td><td> </td><td valign="top"><a href="#Cross-problems">Cross problems</a></td></tr> <tr><td></td><td valign="top"><a href="#index-freetype-library"><code>freetype <span class="roman">library</span></code></a>:</td><td> </td><td valign="top"><a href="#freetype-library"><code>freetype</code> library</a></td></tr> +<tr><td></td><td valign="top"><a href="#index-FreeType_002c-requires-gmake">FreeType, requires <code>gmake</code></a>:</td><td> </td><td valign="top"><a href="#Prerequisites">Prerequisites</a></td></tr> <tr><td></td><td valign="top"><a href="#index-freetype_002dconfig"><code>freetype-config</code></a>:</td><td> </td><td valign="top"><a href="#freetype-library"><code>freetype</code> library</a></td></tr> <tr><td></td><td valign="top"><a href="#index-freetype_002dconfig-1"><code>freetype-config</code></a>:</td><td> </td><td valign="top"><a href="#Variables-for-configure">Variables for configure</a></td></tr> <tr><td></td><td valign="top"><a href="#index-FT2_005fCONFIG"><code>FT2_CONFIG</code></a>:</td><td> </td><td valign="top"><a href="#Variables-for-configure">Variables for configure</a></td></tr> @@ -7172,9 +7305,13 @@ Previous: <a href="#tlmgr" accesskey="p" rel="prev">tlmgr</a>, Up: <a href="#Top <tr><td></td><td valign="top"><a href="#index-GNU_002fLinux-distro">GNU/Linux distro</a>:</td><td> </td><td valign="top"><a href="#Distro-builds">Distro builds</a></td></tr> <tr><td></td><td valign="top"><a href="#index-Gnulib_002c-used-for-common-files">Gnulib, used for common files</a>:</td><td> </td><td valign="top"><a href="#Top_002dlevel-directories">Top-level directories</a></td></tr> <tr><td colspan="4"> <hr></td></tr> +<tr><th id="Index_cp_letter-H">H</th><td></td><td></td></tr> +<tr><td></td><td valign="top"><a href="#index-HarfBuzz_002c-requires-C_002b_002b11">HarfBuzz, requires C++11</a>:</td><td> </td><td valign="top"><a href="#Prerequisites">Prerequisites</a></td></tr> +<tr><td colspan="4"> <hr></td></tr> <tr><th id="Index_cp_letter-I">I</th><td></td><td></td></tr> <tr><td></td><td valign="top"><a href="#index-ICU-cross-compiling">ICU cross compiling</a>:</td><td> </td><td valign="top"><a href="#Cross-problems">Cross problems</a></td></tr> <tr><td></td><td valign="top"><a href="#index-ICU-libraries">ICU libraries</a>:</td><td> </td><td valign="top"><a href="#Variables-for-configure">Variables for configure</a></td></tr> +<tr><td></td><td valign="top"><a href="#index-ICU_002c-requires-C_002b_002b11">ICU, requires C++11</a>:</td><td> </td><td valign="top"><a href="#Prerequisites">Prerequisites</a></td></tr> <tr><td></td><td valign="top"><a href="#index-icu_002dconfig"><code>icu-config</code></a>:</td><td> </td><td valign="top"><a href="#Variables-for-configure">Variables for configure</a></td></tr> <tr><td></td><td valign="top"><a href="#index-ICU_005fCONFIG"><code>ICU_CONFIG</code></a>:</td><td> </td><td valign="top"><a href="#Variables-for-configure">Variables for configure</a></td></tr> <tr><td></td><td valign="top"><a href="#index-infrastructure_002c-tools-needed-for">infrastructure, tools needed for</a>:</td><td> </td><td valign="top"><a href="#Build-system-tools">Build system tools</a></td></tr> @@ -7305,15 +7442,16 @@ Previous: <a href="#tlmgr" accesskey="p" rel="prev">tlmgr</a>, Up: <a href="#Top <tr><td></td><td valign="top"><a href="#index-Preining_002c-Norbert">Preining, Norbert</a>:</td><td> </td><td valign="top"><a href="#Distro-builds">Distro builds</a></td></tr> <tr><td></td><td valign="top"><a href="#index-preloaded-binaries">preloaded binaries</a>:</td><td> </td><td valign="top"><a href="#Configure-options-for-texk_002fweb2c">Configure options for <samp>texk/web2c</samp></a></td></tr> <tr><td></td><td valign="top"><a href="#index-prerequisites-for-building">prerequisites for building</a>:</td><td> </td><td valign="top"><a href="#Prerequisites">Prerequisites</a></td></tr> -<tr><td></td><td valign="top"><a href="#index-problems-with-build">problems with build</a>:</td><td> </td><td valign="top"><a href="#Build-problems">Build problems</a></td></tr> <tr><td></td><td valign="top"><a href="#index-program-module_002c-adding">program module, adding</a>:</td><td> </td><td valign="top"><a href="#Adding-a-new-program-module">Adding a new program module</a></td></tr> <tr><td></td><td valign="top"><a href="#index-program-modules">program modules</a>:</td><td> </td><td valign="top"><a href="#Program-modules">Program modules</a></td></tr> <tr><td></td><td valign="top"><a href="#index-program_002dspecific-configure-options">program-specific <code>configure</code> options</a>:</td><td> </td><td valign="top"><a href="#Program_002dspecific-configure-options">Program-specific configure options</a></td></tr> <tr><td></td><td valign="top"><a href="#index-proxy-build-system">proxy build system</a>:</td><td> </td><td valign="top"><a href="#png-library"><code>png</code> library</a></td></tr> +<tr><td></td><td valign="top"><a href="#index-Python_002c-required-by-ICU">Python, required by ICU</a>:</td><td> </td><td valign="top"><a href="#Prerequisites">Prerequisites</a></td></tr> <tr><td colspan="4"> <hr></td></tr> <tr><th id="Index_cp_letter-R">R</th><td></td><td></td></tr> <tr><td></td><td valign="top"><a href="#index-reautoconf"><code>reautoconf</code></a>:</td><td> </td><td valign="top"><a href="#Build-system-tools">Build system tools</a></td></tr> <tr><td></td><td valign="top"><a href="#index-reautoconf_002c-for-new-program"><code>reautoconf<span class="roman">, for new program</span></code></a>:</td><td> </td><td valign="top"><a href="#Adding-a-new-program-module">Adding a new program module</a></td></tr> +<tr><td></td><td valign="top"><a href="#index-removing-build-directories">removing build directories</a>:</td><td> </td><td valign="top"><a href="#Build-one-package">Build one package</a></td></tr> <tr><td></td><td valign="top"><a href="#index-requirements-for-building">requirements for building</a>:</td><td> </td><td valign="top"><a href="#Prerequisites">Prerequisites</a></td></tr> <tr><td></td><td valign="top"><a href="#index-runscript_002eexe"><code>runscript.exe</code></a>:</td><td> </td><td valign="top"><a href="#Macros-for-Windows">Macros for Windows</a></td></tr> <tr><td colspan="4"> <hr></td></tr> @@ -7346,6 +7484,8 @@ Previous: <a href="#tlmgr" accesskey="p" rel="prev">tlmgr</a>, Up: <a href="#Top <tr><td></td><td valign="top"><a href="#index-tests_002c-running">tests, running</a>:</td><td> </td><td valign="top"><a href="#Overview-of-build-system">Overview of build system</a></td></tr> <tr><td></td><td valign="top"><a href="#index-TeX_002dspecific-library-module_002c-adding">TeX-specific library module, adding</a>:</td><td> </td><td valign="top"><a href="#Adding-a-new-TeX_002dspecific-library-module">Adding a new TeX-specific library module</a></td></tr> <tr><td></td><td valign="top"><a href="#index-texlive_002etlpdb_002c-TeX-Live-database"><code>texlive.tlpdb<span class="roman">, TeX Live database</span></code></a>:</td><td> </td><td valign="top"><a href="#Installing">Installing</a></td></tr> +<tr><td></td><td valign="top"><a href="#index-TEXMFCNF-for-running-standalone"><code>TEXMFCNF <span class="roman">for running standalone</span></code></a>:</td><td> </td><td valign="top"><a href="#Build-one-package">Build one package</a></td></tr> +<tr><td></td><td valign="top"><a href="#index-TEXMFROOT-for-running-standalone"><code>TEXMFROOT <span class="roman">for running standalone</span></code></a>:</td><td> </td><td valign="top"><a href="#Build-one-package">Build one package</a></td></tr> <tr><td></td><td valign="top"><a href="#index-tie"><code>tie</code></a>:</td><td> </td><td valign="top"><a href="#Cross-problems">Cross problems</a></td></tr> <tr><td></td><td valign="top"><a href="#index-timestamps_002c-in-repository">timestamps, in repository</a>:</td><td> </td><td valign="top"><a href="#Build-system-tools">Build system tools</a></td></tr> <tr><td></td><td valign="top"><a href="#index-TLpatches_002fpatch_002d_002e_002e_002e"><code>TLpatches/patch-...</code></a>:</td><td> </td><td valign="top"><a href="#Adding-a-new-program-module">Adding a new program module</a></td></tr> @@ -7400,7 +7540,9 @@ Previous: <a href="#tlmgr" accesskey="p" rel="prev">tlmgr</a>, Up: <a href="#Top <tr><td></td><td valign="top"><a href="#index-zlib-library"><code>zlib <span class="roman">library</span></code></a>:</td><td> </td><td valign="top"><a href="#zlib-library"><code>zlib</code> library</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> +<table><tr><th valign="top">Jump to: </th><td><a class="summary-letter" href="#Index_cp_symbol-1"><b>$</b></a> + +<a class="summary-letter" href="#Index_cp_symbol-2"><b>-</b></a> <br> <a class="summary-letter" href="#Index_cp_letter-A"><b>A</b></a> @@ -7417,6 +7559,8 @@ Previous: <a href="#tlmgr" accesskey="p" rel="prev">tlmgr</a>, Up: <a href="#Top <a class="summary-letter" href="#Index_cp_letter-G"><b>G</b></a> +<a class="summary-letter" href="#Index_cp_letter-H"><b>H</b></a> + <a class="summary-letter" href="#Index_cp_letter-I"><b>I</b></a> <a class="summary-letter" href="#Index_cp_letter-K"><b>K</b></a> @@ -7449,7 +7593,20 @@ Previous: <a href="#tlmgr" accesskey="p" rel="prev">tlmgr</a>, Up: <a href="#Top </td></tr></table> +</div> +</div> +<div class="footnote"> <hr> +<h4 class="footnotes-heading">Footnotes</h4> + +<h5><a id="FOOT1" href="#DOCF1">(1)</a></h5> +<p>There is one exception in TL: the +<code>tangle-sh</code> and related rules use <code>$@</code> to mean the target +name, a feature not present in all <code>make</code>s. This could be +alleviated by laborious editing, but since there’s no way to avoid GNU +<code>make</code> for builds of the entire tree, it does not seem worth the +trouble.</p> +</div> diff --git a/Master/texmf-dist/doc/texlive/tlbuild/tlbuild.pdf b/Master/texmf-dist/doc/texlive/tlbuild/tlbuild.pdf Binary files differindex 50a540320a5..52293aedf7c 100644 --- a/Master/texmf-dist/doc/texlive/tlbuild/tlbuild.pdf +++ b/Master/texmf-dist/doc/texlive/tlbuild/tlbuild.pdf diff --git a/Master/texmf-dist/doc/texlive/tlmgr.html b/Master/texmf-dist/doc/texlive/tlmgr.html index 1ad74074a08..165f0e11d74 100644 --- a/Master/texmf-dist/doc/texlive/tlmgr.html +++ b/Master/texmf-dist/doc/texlive/tlmgr.html @@ -2121,7 +2121,7 @@ other output from post actions, not in machine readable form</code></pre> <p>This script and its documentation were written for the TeX Live distribution (<a href="https://tug.org/texlive">https://tug.org/texlive</a>) and both are licensed under the GNU General Public License Version 2 or later.</p> -<p>$Id: tlmgr.pl 61236 2021-12-06 22:13:25Z karl $</p> +<p>$Id: tlmgr.pl 62273 2022-02-28 08:52:17Z preining $</p> </body> diff --git a/Master/texmf-dist/doc/web2c/web2c.html b/Master/texmf-dist/doc/web2c/web2c.html index 19a32fb57dc..719e5679d72 100644 --- a/Master/texmf-dist/doc/web2c/web2c.html +++ b/Master/texmf-dist/doc/web2c/web2c.html @@ -1,10 +1,13 @@ <!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 installation and use of the programs in Web2c, an implementation of Donald Knuth's TeX system. Copyright (C) 1996, 1997, 1998, 1999, 2000, 2001, 2002, 2003, -2004, 2005, 2007, 2008, 2009, 2010-2021 Karl Berry & Olaf Weber. +2004, 2005, 2007, 2008, 2009, 2010-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 @@ -19,9 +22,6 @@ permission notice identical to this one. Permission is granted to copy and distribute translations of this manual into another language, under the above conditions for modified versions, except that this permission notice may be stated in a translation --> -<!-- 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>Web2c: A TeX implementation</title> <meta name="description" content="Web2c: A TeX implementation"> @@ -29,17 +29,20 @@ except that this permission notice may be stated in a translation --> <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} @@ -48,6 +51,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> @@ -66,7 +70,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="Web2c"></span><h1 class="top">Web2c</h1> + +<p>This document describes how to install and use the programs in the Web2c +implementation of the TeX system, especially for Unix systems. It +corresponds to Web2c version 2022, released in +January 2022. +</p> + + +<div class="Contents_element" id="SEC_Contents"> <h2 class="contents-heading">Table of Contents</h2> <div class="contents"> @@ -176,75 +195,32 @@ 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="Web2c"></span><h1 class="top">Web2c</h1> - -<p>This document describes how to install and use the programs in the Web2c -implementation of the TeX system, especially for Unix systems. It -corresponds to Web2c version 2021, 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">A brief 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 Web2c. -</td></tr> -<tr><td align="left" valign="top">• <a href="#Commonalities" accesskey="3">Commonalities</a></td><td> </td><td align="left" valign="top">Option syntax, standard options, memory dumps. -</td></tr> -<tr><td align="left" valign="top">• <a href="#Three-programs" accesskey="4">Three programs</a></td><td> </td><td align="left" valign="top">TeX, Metafont, MetaPost have much in common. -</td></tr> -<tr><td align="left" valign="top">• <a href="#TeX" accesskey="5">TeX</a></td><td> </td><td align="left" valign="top">Typesetting. -</td></tr> -<tr><td align="left" valign="top">• <a href="#Metafont" accesskey="6">Metafont</a></td><td> </td><td align="left" valign="top">Typeface design. -</td></tr> -<tr><td align="left" valign="top">• <a href="#MetaPost" accesskey="7">MetaPost</a></td><td> </td><td align="left" valign="top">Technical illustrations. -</td></tr> -<tr><td align="left" valign="top">• <a href="#BibTeX" accesskey="8">BibTeX</a></td><td> </td><td align="left" valign="top">Reusable bibliographies. -</td></tr> -<tr><td align="left" valign="top">• <a href="#WEB" accesskey="9">WEB</a></td><td> </td><td align="left" valign="top">Literate programming. -</td></tr> -<tr><td align="left" valign="top">• <a href="#DVI-utilities">DVI utilities</a></td><td> </td><td align="left" valign="top">DVI expansion. -</td></tr> -<tr><td align="left" valign="top">• <a href="#Font-utilities">Font utilities</a></td><td> </td><td align="left" valign="top">Font format conversion. -</td></tr> -<tr><td align="left" valign="top">• <a href="#Legalisms">Legalisms</a></td><td> </td><td align="left" valign="top">Blah blah blah. -</td></tr> -<tr><td align="left" valign="top">• <a href="#References">References</a></td><td> </td><td align="left" valign="top">Books and such. -</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">Web2c</a>, Up: <a href="#Top" accesskey="u" rel="up">Web2c</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> -<p>This manual corresponds to version 2021 of Web2c, released in -February 2021. +<p>This manual corresponds to version 2022 of Web2c, released in +January 2022. </p> <span id="index-Knuth_002c-Donald-E_002e"></span> <span id="index-TeX_002c-Web2c-implementation-of"></span> <span id="index-Hobby_002c-John"></span> <span id="index-Breitenlohner_002c-Peter"></span> -<p><em>Web2c</em> is the name of a TeX implementation, originally for -Unix, but now also running under various operating systems. By -<em>TeX implementation</em>, we mean all of the standard programs -developed by the Stanford TeX project directed by Donald E. Knuth: -Metafont, DVItype, GFtoDVI, BibTeX, Tangle, etc., as well as TeX -itself. Other programs are also included: DVIcopy, written by Peter -Breitenlohner, MetaPost and its utilities (derived from Metafont), by -John Hobby, etc. +<p><em>Web2c</em> (also spelled Web2C) is the name of a TeX +implementation, originally for Unix, but now also running under +Windows and other operating systems. By <em>TeX implementation</em>, +we mean all of the standard programs developed by the Stanford TeX +project led by Donald E. Knuth: Metafont, DVItype, GFtoDVI, +BibTeX, Tangle, etc., as well as TeX itself. Other programs are +also included: DVIcopy, written by Peter Breitenlohner, MetaPost and +its utilities (derived from Metafont), by John Hobby, and many more. </p> <span id="index-translation-from-WEB-to-C"></span> <span id="index-strategy_002c-overall"></span> @@ -259,7 +235,7 @@ Therefore, it will not work without change on an arbitrary WEB program. <span id="index-ice-cream"></span> <p>Availability: All of Web2c is freely available—“free” both in the sense of no cost (free ice cream) and of having the source code to -modify and/or redistribute (free speech). See <a href="https://tug.org/texinfohtml/kpathsea.html#unixtex_002eftp">unixtex.ftp</a> in <cite>Kpathsea</cite>, for the practical details of how to obtain Web2c. +modify and/or redistribute (free speech). See <a data-manual="kpathsea" href="https://tug.org/texinfohtml/kpathsea.html#unixtex_002eftp">unixtex.ftp</a> in <cite>Kpathsea</cite>, for the practical details of how to obtain Web2c. </p> <p>Different parts of the Web2c distribution have different licensing terms, however, reflecting the different circumstances of their @@ -268,7 +244,7 @@ practical implication for redistributors of Web2c is that most of the executables are covered by the GNU General Public License or GNU Lesser General Public License, and therefore anyone who gets a binary distribution must also be able to get the sources, as explained by the -terms of the GPL (<a href="https://gnu.org/licenses/">https://gnu.org/licenses/</a>. The GPL covers the +terms of the GPL (<a href="https://gnu.org/licenses/">https://gnu.org/licenses/</a>). The GPL covers the Web2c executables, including <code>tex</code>, because the Free Software Foundation sponsored the initial development of the Kpathsea library that Web2c uses. The basic source files from Stanford, however, have @@ -290,9 +266,17 @@ changed to Web-to-C somewhere in there. In 1990, Karl Berry became the maintainer. He made many changes to the original sources, and started using the shorter name Web2c. In 1997, Olaf Weber took over, and then in 2006, Karl started taking care of it again. No -significant development or changes have been needed for many -years. Dozens of other people have contributed; their names are listed -in the <samp>ChangeLog</samp> files. +significant development or changes have been needed for many years, +though dozens of other people have contributed in many ways; their +names are listed in the <samp>ChangeLog</samp> files. +</p> +<span id="index-teTeX-distribution"></span> +<p>Originally, Web2c was distributed as its own package, alongside the +original web programs from Stanford and other components. It was also +the basis for the teTeX distribution (now discontinued). Around +2004, the packaging focus shifted entirely to the TeX Live +distribution (<a href="https://tug.org/texlive/">https://tug.org/texlive/</a>), though the same Web2c +is at the heart of the release. </p> <span id="index-acknowledgements"></span> <span id="index-Martin_002c-Rick"></span> @@ -304,7 +288,7 @@ access to me for many years. Richard Stallman at the Free Software Foundation employed me while I wrote the original path searching library (for the GNU font utilities). (rms also gave us Emacs, GDB, and GCC, without which I cannot imagine developing Web2c.) And, of course, -TeX would not exist in the first place without Donald E. Knuth. +TeX would not exist in the first place without Donald E. Knuth. </p> <span id="index-reading_002c-additional"></span> <p>Further reading: See <a href="#References">References</a>. @@ -312,9 +296,11 @@ TeX would not exist in the first place without Donald E. Knuth. <hr> -<span id="Installation"></span><div class="header"> +</div> +<div class="chapter" id="Installation"> +<div class="header"> <p> -Next: <a href="#Commonalities" accesskey="n" rel="next">Commonalities</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="#Commonalities" accesskey="n" rel="next">Commonalities</a>, Previous: <a href="#Introduction" accesskey="p" rel="prev">Introduction</a>, Up: <a href="#Top" accesskey="u" rel="up">Web2c</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> @@ -326,14 +312,14 @@ Next: <a href="#Commonalities" accesskey="n" rel="next">Commonalities</a>, Previ </p> <p>Installing Web2c is mostly the same as installing any other 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>. (A copy is in the file +see <a data-manual="kpathsea" href="https://tug.org/texinfohtml/kpathsea.html#Installation">Installation</a> in <cite>Kpathsea</cite>. (A copy is in the file <samp>kpathsea/INSTALL</samp>.) </p> <p>One peculiarity to Web2c is that the source distribution comes in two files: <samp>web.tar.gz</samp> and <samp>web2c.tar.gz</samp>. You must retrieve and unpack them both. (We have two because the former archive contains the very large and seldom-changing original WEB source files.) -See <a href="https://tug.org/texinfohtml/kpathsea.html#unixtex_002eftp">unixtex.ftp</a> in <cite>Kpathsea</cite>. +See <a data-manual="kpathsea" href="https://tug.org/texinfohtml/kpathsea.html#unixtex_002eftp">unixtex.ftp</a> in <cite>Kpathsea</cite>. </p> <span id="index-mpost_002c-reason-for-name-change"></span> <p>Another peculiarity is the MetaPost program. Although it has been @@ -345,7 +331,7 @@ available under its shorter name as well, you will have to set up a link or some such yourself. And of course individual users can do the same. </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>). See also the Web2c home page, +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>). See also the Web2c home page, <a href="http://www.tug.org/web2c">http://www.tug.org/web2c</a>. </p> <p>Points worth repeating: @@ -357,9 +343,9 @@ report a bug, see the file <samp>kpathsea/BUGS</samp> (see <a href="https://tug. <span id="index-macros_002c-basic"></span> Before starting the standard compilation and installation you must install the basic fonts, macros, and other library files. -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>. -</li><li> If you do not wish to use the standard file locations, see <a href="https://tug.org/texinfohtml/kpathsea.html#Changing-search-paths">Changing +</li><li> If you do not wish to use the standard file locations, see <a data-manual="kpathsea" href="https://tug.org/texinfohtml/kpathsea.html#Changing-search-paths">Changing search paths</a> in <cite>Kpathsea</cite>. </li><li> Some Web2c features are enabled or disabled at <code>configure</code> time, @@ -367,20 +353,17 @@ as described in the first section below. </li></ul> -<table class="menu" border="0" cellspacing="0"> -<tr><td align="left" valign="top">• <a href="#configure-options" accesskey="1">configure options</a></td><td> </td><td align="left" valign="top">Especially –with and –enable. -</td></tr> -<tr><td align="left" valign="top">• <a href="#Compile_002dtime-options" accesskey="2">Compile-time options</a></td><td> </td><td align="left" valign="top">Unusual -D’s. -</td></tr> -<tr><td align="left" valign="top">• <a href="#Additional-targets" accesskey="3">Additional targets</a></td><td> </td><td align="left" valign="top">Breaking down the task. -</td></tr> -<tr><td align="left" valign="top">• <a href="#Triptrap" accesskey="4">Triptrap</a></td><td> </td><td align="left" valign="top">Running the torture tests. -</td></tr> -</table> +<ul class="section-toc"> +<li><a href="#configure-options" accesskey="1"><code>configure</code> options</a></li> +<li><a href="#Compile_002dtime-options" accesskey="2">Compile-time options</a></li> +<li><a href="#Additional-targets" accesskey="3">Additional targets</a></li> +<li><a href="#Triptrap" accesskey="4">Trip, trap, and mptrap: Torture tests</a></li> +</ul> <hr> -<span id="configure-options"></span><div class="header"> +<div class="section" id="configure-options"> +<div class="header"> <p> Next: <a href="#Compile_002dtime-options" accesskey="n" rel="next">Compile-time options</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> @@ -399,60 +382,62 @@ package-specific options come last. </p> <p>For a description of the generic options (which mainly allow you to specify installation directories) and basic <code>configure</code> usage, -see <a href="https://www.gnu.org/software/autoconf/manual/autoconf.html#Invoking-configure">Running <code>configure</code> scripts</a> in <cite>Autoconf</cite>, a copy is in the file <samp>kpathsea/CONFIGURE</samp>. +see <a data-manual="autoconf" href="https://www.gnu.org/software/autoconf/manual/autoconf.html#Invoking-configure">Running <code>configure</code> scripts</a> in <cite>Autoconf</cite>, a copy is in the file <samp>kpathsea/CONFIGURE</samp>. </p> <dl compact="compact"> -<dt>‘<samp>--disable-dump-share</samp>’</dt> +<dt><span>‘<samp>--disable-dump-share</samp>’</span></dt> <dd><p>Do not make fmt/base/mem files sharable across different endian architectures. See <a href="#Hardware-and-memory-dumps">Hardware and memory dumps</a>. </p> </dd> -<dt>‘<samp>--without-maketexmf-default</samp>’</dt> -<dt>‘<samp>--without-maketexpk-default</samp>’</dt> -<dt>‘<samp>--without-maketextfm-default</samp>’</dt> -<dt>‘<samp>--with-maketextex-default</samp>’</dt> -<dd><p>Enable or disable the dynamic generation programs. See <a href="https://tug.org/texinfohtml/kpathsea.html#mktex-configuration">mktex +<dt><span>‘<samp>--without-maketexmf-default</samp>’</span></dt> +<dt><span>‘<samp>--without-maketexpk-default</samp>’</span></dt> +<dt><span>‘<samp>--without-maketextfm-default</samp>’</span></dt> +<dt><span>‘<samp>--with-maketextex-default</samp>’</span></dt> +<dd><p>Enable or disable the dynamic generation programs. See <a data-manual="kpathsea" href="https://tug.org/texinfohtml/kpathsea.html#mktex-configuration">mktex configuration</a> in <cite>Kpathsea</cite>. The defaults are the inverse of the options, i.e., everything is enabled except <code>mktextex</code>. </p> </dd> -<dt>‘<samp>--enable-shared</samp>’</dt> -<dd><p>Build Kpathsea as a shared library. See <a href="https://tug.org/texinfohtml/kpathsea.html#Shared-library">Shared library</a> in <cite>Kpathsea</cite>. +<dt><span>‘<samp>--enable-shared</samp>’</span></dt> +<dd><p>Build Kpathsea as a shared library. See <a data-manual="kpathsea" href="https://tug.org/texinfohtml/kpathsea.html#Shared-library">Shared library</a> in <cite>Kpathsea</cite>. </p> </dd> -<dt>‘<samp>--with-editor=<var>cmd</var></samp>’</dt> +<dt><span>‘<samp>--with-editor=<var>cmd</var></samp>’</span></dt> <dd><p>Change the default editor invoked by the ‘<samp>e</samp>’ interactive command. See <a href="#Editor-invocation">Editor invocation</a>. </p> </dd> -<dt>‘<samp>--with-epsfwin</samp>’</dt> -<dt>‘<samp>--with-hp2627win</samp>’</dt> -<dt>‘<samp>--with-mftalkwin</samp>’</dt> -<dt>‘<samp>--with-nextwin</samp>’</dt> -<dt>‘<samp>--with-regiswin</samp>’</dt> -<dt>‘<samp>--with-suntoolswin</samp>’</dt> -<dt>‘<samp>--with-tektronixwin</samp>’</dt> -<dt>‘<samp>--with-unitermwin</samp>’</dt> -<dt>‘<samp>--with-x</samp>’</dt> -<dt>‘<samp>--with-x-toolkit=KIT</samp>’</dt> -<dt>‘<samp>--with-x11win</samp>’</dt> -<dt>‘<samp>--with-x11</samp>’</dt> +<dt><span>‘<samp>--with-epsfwin</samp>’</span></dt> +<dt><span>‘<samp>--with-hp2627win</samp>’</span></dt> +<dt><span>‘<samp>--with-mftalkwin</samp>’</span></dt> +<dt><span>‘<samp>--with-nextwin</samp>’</span></dt> +<dt><span>‘<samp>--with-regiswin</samp>’</span></dt> +<dt><span>‘<samp>--with-suntoolswin</samp>’</span></dt> +<dt><span>‘<samp>--with-tektronixwin</samp>’</span></dt> +<dt><span>‘<samp>--with-unitermwin</samp>’</span></dt> +<dt><span>‘<samp>--with-x</samp>’</span></dt> +<dt><span>‘<samp>--with-x-toolkit=KIT</samp>’</span></dt> +<dt><span>‘<samp>--with-x11win</samp>’</span></dt> +<dt><span>‘<samp>--with-x11</samp>’</span></dt> <dd><p>Define Metafont graphics support; by default, no graphics support is enabled. See <a href="#Online-Metafont-graphics">Online Metafont graphics</a>. </p> </dd> -<dt>‘<samp>--x-includes=<var>dir</var></samp>’</dt> -<dt>‘<samp>--x-libraries=<var>dir</var></samp>’</dt> +<dt><span>‘<samp>--x-includes=<var>dir</var></samp>’</span></dt> +<dt><span>‘<samp>--x-libraries=<var>dir</var></samp>’</span></dt> <dd><p>Define the locations of the X11 include files and libraries; by default, -<code>configure</code> does its best to guess). See <a href="https://www.gnu.org/software/autoconf/manual/autoconf.html#Optional-Features">Optional Features</a> in <cite>Autoconf</cite>. A copy is in <samp>kpathsea/CONFIGURE</samp>. +<code>configure</code> does its best to guess). See <a data-manual="autoconf" href="https://www.gnu.org/software/autoconf/manual/autoconf.html#Optional-Features">Optional Features</a> in <cite>Autoconf</cite>. A copy is in <samp>kpathsea/CONFIGURE</samp>. </p></dd> </dl> <hr> -<span id="Compile_002dtime-options"></span><div class="header"> +</div> +<div class="section" id="Compile_002dtime-options"> +<div class="header"> <p> -Next: <a href="#Additional-targets" accesskey="n" rel="next">Additional targets</a>, Previous: <a href="#configure-options" accesskey="p" rel="prev">configure options</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="#Additional-targets" accesskey="n" rel="next">Additional targets</a>, Previous: <a href="#configure-options" accesskey="p" rel="prev"><code>configure</code> options</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="Compile_002dtime-options-1"></span><h3 class="section">2.2 Compile-time options</h3> @@ -470,15 +455,14 @@ simplest thing to do is: <pre class="example">make XCFLAGS="<var>ccoptions</var>" </pre></div> <p>You can also set the <code>CFLAGS</code> environment variable before -running <code>configure</code>. See <a href="https://tug.org/texinfohtml/kpathsea.html#configure-environment">configure environment</a> in <cite>Kpathsea</cite>. +running <code>configure</code>. See <a data-manual="kpathsea" href="https://tug.org/texinfohtml/kpathsea.html#configure-environment">configure environment</a> in <cite>Kpathsea</cite>. </p> <p>Anyway, here are the possibilities: </p> <dl compact="compact"> -<dt>‘<samp>-DFIXPT</samp>’</dt> -<dt>‘<samp>-DNO_MF_ASM</samp>’</dt> -<dd><span id="index-FIXPT"></span> -<span id="index-fixed_002dpoint-arithmetic"></span> +<dt id='index-FIXPT'><span>‘<samp>-DFIXPT</samp>’<a href='#index-FIXPT' class='copiable-anchor'> ¶</a></span></dt> +<dt><span>‘<samp>-DNO_MF_ASM</samp>’</span></dt> +<dd><span id="index-fixed_002dpoint-arithmetic"></span> <span id="index-floating_002dpoint-arithmetic"></span> <span id="index-assembly-language-routines"></span> <span id="index-fraction-routines"></span> @@ -489,17 +473,18 @@ assembly-language routines are used on x86 hardware with GNU C (unless otherwise. </p> </dd> -<dt>‘<samp>-DIPC_DEBUG</samp>’</dt> -<dd><span id="index-IPC_005fDEBUG"></span> -<p>Report on various interprocess communication activities. See <a href="#IPC-and-TeX">IPC and TeX</a>. +<dt id='index-IPC_005fDEBUG'><span>‘<samp>-DIPC_DEBUG</samp>’<a href='#index-IPC_005fDEBUG' class='copiable-anchor'> ¶</a></span></dt> +<dd><p>Report on various interprocess communication activities. See <a href="#IPC-and-TeX">IPC and TeX</a>. </p></dd> </dl> <hr> -<span id="Additional-targets"></span><div class="header"> +</div> +<div class="section" id="Additional-targets"> +<div class="header"> <p> -Next: <a href="#Triptrap" accesskey="n" rel="next">Triptrap</a>, Previous: <a href="#Compile_002dtime-options" accesskey="p" rel="prev">Compile-time options</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="#Triptrap" accesskey="n" rel="next">Trip, trap, and mptrap: Torture tests</a>, Previous: <a href="#Compile_002dtime-options" accesskey="p" rel="prev">Compile-time options</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="Additional-targets-1"></span><h3 class="section">2.3 Additional targets</h3> @@ -513,17 +498,15 @@ one containing <samp>kpathsea/</samp> and <samp>web2c/</samp>), or in the <samp>web2c/</samp> directory. </p> <dl compact="compact"> -<dt>‘<samp>c-sources</samp>’</dt> -<dd><span id="index-c_002dsources-Makefile-target"></span> -<span id="index-non_002dUnix-system_002c-compiling-on"></span> +<dt id='index-c_002dsources-Makefile-target'><span>‘<samp>c-sources</samp>’<a href='#index-c_002dsources-Makefile-target' class='copiable-anchor'> ¶</a></span></dt> +<dd><span id="index-non_002dUnix-system_002c-compiling-on"></span> <p>Make only the C files, translated from the Web sources, presumably because you want to take them to a non-Unix machine. </p> </dd> -<dt>‘<samp>formats</samp>’</dt> -<dt>‘<samp>install-formats</samp>’</dt> -<dd><span id="index-formats-Make-target"></span> -<span id="index-install_002dformats-Make-target"></span> +<dt id='index-formats-Make-target'><span>‘<samp>formats</samp>’<a href='#index-formats-Make-target' class='copiable-anchor'> ¶</a></span></dt> +<dt><span>‘<samp>install-formats</samp>’</span></dt> +<dd><span id="index-install_002dformats-Make-target"></span> <p>Make or install all the memory dumps (see <a href="#Memory-dumps">Memory dumps</a>). By default, the standard plain formats plus <samp>latex.fmt</samp> are made. You can add other formats by redefining the <code>fmts</code>, <code>bases</code>, and @@ -531,34 +514,30 @@ can add other formats by redefining the <code>fmts</code>, <code>bases</code>, a possibilities. </p> </dd> -<dt>‘<samp>fmts</samp>’</dt> -<dt>‘<samp>install-fmts</samp>’</dt> -<dd><span id="index-fmts-Make-target"></span> -<span id="index-install_002dfmts-Make-target"></span> +<dt id='index-fmts-Make-target'><span>‘<samp>fmts</samp>’<a href='#index-fmts-Make-target' class='copiable-anchor'> ¶</a></span></dt> +<dt><span>‘<samp>install-fmts</samp>’</span></dt> +<dd><span id="index-install_002dfmts-Make-target"></span> <p>Make or install the TeX <samp>.fmt</samp> files. See <a href="#Initial-TeX">Initial TeX</a>. </p> </dd> -<dt>‘<samp>bases</samp>’</dt> -<dt>‘<samp>install-bases</samp>’</dt> -<dd><span id="index-bases-Make-target"></span> -<span id="index-install_002dbases-Make-target"></span> +<dt id='index-bases-Make-target'><span>‘<samp>bases</samp>’<a href='#index-bases-Make-target' class='copiable-anchor'> ¶</a></span></dt> +<dt><span>‘<samp>install-bases</samp>’</span></dt> +<dd><span id="index-install_002dbases-Make-target"></span> <p>Make or install the Metafont <samp>.base</samp> files. See <a href="#Initial-Metafont">Initial Metafont</a>. </p> </dd> -<dt>‘<samp>mems</samp>’</dt> -<dt>‘<samp>install-mems</samp>’</dt> -<dd><span id="index-mems-Make-target"></span> -<span id="index-install_002dmems-Make-target"></span> +<dt id='index-mems-Make-target'><span>‘<samp>mems</samp>’<a href='#index-mems-Make-target' class='copiable-anchor'> ¶</a></span></dt> +<dt><span>‘<samp>install-mems</samp>’</span></dt> +<dd><span id="index-install_002dmems-Make-target"></span> <p>Make or install the MetaPost <samp>.mem</samp> files. See <a href="#Initial-MetaPost">Initial MetaPost</a>. </p> </dd> -<dt>‘<samp>triptrap</samp>’</dt> -<dt>‘<samp>trip</samp>’</dt> -<dt>‘<samp>trap</samp>’</dt> -<dt>‘<samp>mptrap</samp>’</dt> -<dd><span id="index-triptrap-Make-target"></span> -<span id="index-trip-Make-target"></span> +<dt id='index-triptrap-Make-target'><span>‘<samp>triptrap</samp>’<a href='#index-triptrap-Make-target' class='copiable-anchor'> ¶</a></span></dt> +<dt><span>‘<samp>trip</samp>’</span></dt> +<dt><span>‘<samp>trap</samp>’</span></dt> +<dt><span>‘<samp>mptrap</samp>’</span></dt> +<dd><span id="index-trip-Make-target"></span> <span id="index-trap-Make-target"></span> <span id="index-mptrap-Make-target"></span> <p>To run the torture tests for TeX, Metafont, and MetaPost @@ -569,7 +548,9 @@ possibilities. <hr> -<span id="Triptrap"></span><div class="header"> +</div> +<div class="section" id="Triptrap"> +<div class="header"> <p> Previous: <a href="#Additional-targets" accesskey="p" rel="prev">Additional targets</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> @@ -603,7 +584,7 @@ all acceptable) are: <p>Any other differences are trouble. The most common culprit in the past has been compiler bugs, especially when optimizing. -See <a href="https://tug.org/texinfohtml/kpathsea.html#TeX-or-Metafont-failing">TeX or Metafont failing</a> in <cite>Kpathsea</cite>. +See <a data-manual="kpathsea" href="https://tug.org/texinfohtml/kpathsea.html#TeX-or-Metafont-failing">TeX or Metafont failing</a> in <cite>Kpathsea</cite>. </p> <p>The files <samp>trip.diffs</samp>, <samp>mftrap.diffs</samp>, and <samp>mptrap.diffs</samp> in the <samp>triptrap</samp> directory show the standard @@ -623,9 +604,12 @@ file <samp>tests/check.log</samp> if you like. </p> <hr> -<span id="Commonalities"></span><div class="header"> +</div> +</div> +<div class="chapter" id="Commonalities"> +<div class="header"> <p> -Next: <a href="#Three-programs" accesskey="n" rel="next">Three programs</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="#Three-programs" accesskey="n" rel="next">Three programs: Metafont, MetaPost, and TeX</a>, Previous: <a href="#Installation" accesskey="p" rel="prev">Installation</a>, Up: <a href="#Top" accesskey="u" rel="up">Web2c</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="Commonalities-1"></span><h2 class="chapter">3 Commonalities</h2> @@ -634,20 +618,20 @@ Next: <a href="#Three-programs" accesskey="n" rel="next">Three programs</a>, Pre <p>Many aspects of the TeX system are the same among more than one program, so we describe those pieces together, here. </p> -<table class="menu" border="0" cellspacing="0"> -<tr><td align="left" valign="top">• <a href="#Option-conventions" accesskey="1">Option conventions</a></td><td> </td><td align="left" valign="top">– or -, = or ‘ ’ for values. -</td></tr> -<tr><td align="left" valign="top">• <a href="#Common-options" accesskey="2">Common options</a></td><td> </td><td align="left" valign="top">–help –version –verbose, and TeX/MF/MP options. -</td></tr> -<tr><td align="left" valign="top">• <a href="#Path-searching" accesskey="3">Path searching</a></td><td> </td><td align="left" valign="top">Features of the common path searching library. -</td></tr> -<tr><td align="left" valign="top">• <a href="#Output-file-location" accesskey="4">Output file location</a></td><td> </td><td align="left" valign="top">TEXMFOUTPUT allows output in places other than ‘.’. -</td></tr> -</table> +<p>Another kind of commonality is the extensions to TeX that are +available across all the engines; see <a href="#TeX-extensions">Extended TeX engines</a>. +</p> +<ul class="section-toc"> +<li><a href="#Option-conventions" accesskey="1">Option conventions</a></li> +<li><a href="#Common-options" accesskey="2">Common options</a></li> +<li><a href="#Path-searching" accesskey="3">Path searching</a></li> +<li><a href="#Output-file-location" accesskey="4">Output file location</a></li> +</ul> <hr> -<span id="Option-conventions"></span><div class="header"> +<div class="section" id="Option-conventions"> +<div class="header"> <p> Next: <a href="#Common-options" accesskey="n" rel="next">Common options</a>, Up: <a href="#Commonalities" accesskey="u" rel="up">Commonalities</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> </div> @@ -696,7 +680,9 @@ option; and specifies the filename <samp>-myfile-</samp>. <hr> -<span id="Common-options"></span><div class="header"> +</div> +<div class="section" id="Common-options"> +<div class="header"> <p> Next: <a href="#Path-searching" accesskey="n" rel="next">Path searching</a>, Previous: <a href="#Option-conventions" accesskey="p" rel="prev">Option conventions</a>, Up: <a href="#Commonalities" accesskey="u" rel="up">Commonalities</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> </div> @@ -709,22 +695,19 @@ Next: <a href="#Path-searching" accesskey="n" rel="next">Path searching</a>, Pre every program, they are described here. </p> <dl compact="compact"> -<dt>‘<samp>--help</samp>’</dt> -<dd><span id="index-_002d_002dhelp-common-option"></span> -<span id="index-help_002c-online"></span> +<dt id='index-_002d_002dhelp-common-option'><span>‘<samp>--help</samp>’<a href='#index-_002d_002dhelp-common-option' class='copiable-anchor'> ¶</a></span></dt> +<dd><span id="index-help_002c-online"></span> <p>Print a usage message listing basic usage and all available options to standard output, then exit successfully. </p> </dd> -<dt>‘<samp>--verbose</samp>’</dt> -<dd><span id="index-_002d_002dverbose-common-option"></span> -<span id="index-verbosity_002c-enabling"></span> +<dt id='index-_002d_002dverbose-common-option'><span>‘<samp>--verbose</samp>’<a href='#index-_002d_002dverbose-common-option' class='copiable-anchor'> ¶</a></span></dt> +<dd><span id="index-verbosity_002c-enabling"></span> <p>Print progress reports to standard output. </p> </dd> -<dt>‘<samp>--version</samp>’</dt> -<dd><span id="index-_002d_002dversion-common-option"></span> -<span id="index-version-number_002c-finding"></span> +<dt id='index-_002d_002dversion-common-option'><span>‘<samp>--version</samp>’<a href='#index-_002d_002dversion-common-option' class='copiable-anchor'> ¶</a></span></dt> +<dd><span id="index-version-number_002c-finding"></span> <p>Print the version number to standard output, then exit successfully. </p></dd> </dl> @@ -733,19 +716,17 @@ standard output, then exit successfully. common: </p> <dl compact="compact"> -<dt>‘<samp>-cnf-line=<var>str</var></samp>’</dt> -<dd><span id="index-_002dcnf_002dline"></span> -<p>Parse <var>str</var> as if it were a line in the <samp>texmf.cnf</samp> -configuration file, overriding all other settings. See <a href="https://tug.org/texinfohtml/kpathsea.html#Path-searching-options">Path +<dt id='index-_002dcnf_002dline'><span>‘<samp>-cnf-line=<var>str</var></samp>’<a href='#index-_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, overriding all other settings. See <a data-manual="kpathsea" href="https://tug.org/texinfohtml/kpathsea.html#Path-searching-options">Path searching options</a> in <cite>Kpathsea</cite>. </p> </dd> -<dt>‘<samp>-file-line-error</samp>’</dt> +<dt id='index-_002dno_002dfile_002dline_002derror'><span>‘<samp>-file-line-error</samp>’<a href='#index-_002dno_002dfile_002dline_002derror' class='copiable-anchor'> ¶</a></span></dt> <dd><span id="index-_002dfile_002dline_002derror"></span> </dd> -<dt>‘<samp>-no-file-line-error</samp>’</dt> -<dd><span id="index-_002dno_002dfile_002dline_002derror"></span> -<span id="index-_002dfile_002dline_002derror_002dstyle"></span> +<dt><span>‘<samp>-no-file-line-error</samp>’</span></dt> +<dd><span id="index-_002dfile_002dline_002derror_002dstyle"></span> <span id="index-changing-error-messages-style"></span> <p>Change (or do not change) the way error messages are printed. The alternate style looks like error messages from many compilers and is @@ -753,11 +734,10 @@ easier to parse for some editors that invoke TeX. This option used to be called ‘<samp>-file-line-error-style</samp>’. </p> </dd> -<dt>‘<samp>-fmt=<var>dumpname</var></samp>’</dt> -<dt>‘<samp>-base=<var>dumpname</var></samp>’</dt> -<dt>‘<samp>-mem=<var>dumpname</var></samp>’</dt> -<dd><span id="index-_002dfmt_003ddumpname"></span> -<span id="index-_002dbase_003ddumpname"></span> +<dt id='index-_002dfmt_003ddumpname'><span>‘<samp>-fmt=<var>dumpname</var></samp>’<a href='#index-_002dfmt_003ddumpname' class='copiable-anchor'> ¶</a></span></dt> +<dt><span>‘<samp>-base=<var>dumpname</var></samp>’</span></dt> +<dt><span>‘<samp>-mem=<var>dumpname</var></samp>’</span></dt> +<dd><span id="index-_002dbase_003ddumpname"></span> <span id="index-_002dmem_003ddumpname"></span> <span id="index-dump-file"></span> <p>Use <var>dumpname</var> instead of the program name or a ‘<samp>%&</samp>’ line to @@ -766,81 +746,72 @@ determine the name of the memory dump file read (‘<samp>fmt</samp>’ ‘<samp>-progname</samp>’ option was given. </p> </dd> -<dt>‘<samp>-halt-on-error</samp>’</dt> -<dd><span id="index-_002dhalt_002don_002derror"></span> -<span id="index-stopping-at-the-first-error"></span> +<dt id='index-_002dhalt_002don_002derror'><span>‘<samp>-halt-on-error</samp>’<a href='#index-_002dhalt_002don_002derror' class='copiable-anchor'> ¶</a></span></dt> +<dd><span id="index-stopping-at-the-first-error"></span> <p>Stop processing and exit when an error occurs, as opposed to the normal process of trying to recover and continue. </p> </dd> -<dt>‘<samp>-ini</samp>’</dt> -<dd><span id="index-_002dini"></span> -<span id="index-program-names_002c-special"></span> +<dt id='index-_002dini'><span>‘<samp>-ini</samp>’<a href='#index-_002dini' class='copiable-anchor'> ¶</a></span></dt> +<dd><span id="index-program-names_002c-special"></span> <span id="index-initial-form_002c-enabling"></span> <p>Enable the “initial” form of the program (see <a href="#Initial-and-virgin">Initial and virgin</a>). This is implicitly set if the program name is <code>initex</code> resp. <code>inimf</code>. </p> </dd> -<dt>‘<samp>-interaction=<var>string</var></samp>’</dt> -<dd><span id="index-_002dinteraction_003dstring"></span> -<span id="index-interaction-mode"></span> +<dt id='index-_002dinteraction_003dstring'><span>‘<samp>-interaction=<var>string</var></samp>’<a href='#index-_002dinteraction_003dstring' class='copiable-anchor'> ¶</a></span></dt> +<dd><span id="index-interaction-mode"></span> <p>Set the interaction mode from the command line. The <var>string</var> must be one of ‘<samp>batchmode</samp>’, ‘<samp>nonstopmode</samp>’, ‘<samp>scrollmode</samp>’, or ‘<samp>errorstopmode</samp>’. </p> </dd> -<dt>‘<samp>-jobname=<var>string</var></samp>’</dt> -<dd><span id="index-_002djobname_003dstring"></span> -<span id="index-job-name"></span> +<dt id='index-_002djobname_003dstring'><span>‘<samp>-jobname=<var>string</var></samp>’<a href='#index-_002djobname_003dstring' class='copiable-anchor'> ¶</a></span></dt> +<dd><span id="index-job-name"></span> <p>Set the job name to <var>string</var>, instead of deriving it from the name of the input file. </p> </dd> -<dt>‘<samp>-kpathsea-debug=<var>number</var></samp>’</dt> -<dd><span id="index-_002dkpathsea_002ddebug_003dnumber"></span> -<span id="index-KPATHSEA_005fDEBUG"></span> +<dt id='index-_002dkpathsea_002ddebug_003dnumber'><span>‘<samp>-kpathsea-debug=<var>number</var></samp>’<a href='#index-_002dkpathsea_002ddebug_003dnumber' class='copiable-anchor'> ¶</a></span></dt> +<dd><span id="index-KPATHSEA_005fDEBUG"></span> <span id="index-debugging-flags_002c-specifying"></span> <span id="index-path-searching-debugging"></span> <p>Set path searching debugging flags according to the bits of <var>number</var> -(see <a href="https://tug.org/texinfohtml/kpathsea.html#Debugging">Debugging</a> in <cite>Kpathsea</cite>). You can also specify this in +(see <a data-manual="kpathsea" href="https://tug.org/texinfohtml/kpathsea.html#Debugging">Debugging</a> in <cite>Kpathsea</cite>). You can also specify this in <code>KPATHSEA_DEBUG</code> environment variable (for all Web2c programs). (The command line value overrides.) The most useful value is ‘<samp>-1</samp>’, to get all available output. </p> </dd> -<dt>‘<samp>-output-directory=<var>dirname</var></samp>’</dt> -<dd><span id="index-_002doutput_002ddirectory"></span> -<span id="index-output-directory_002c-specifying"></span> +<dt id='index-_002doutput_002ddirectory'><span>‘<samp>-output-directory=<var>dirname</var></samp>’<a href='#index-_002doutput_002ddirectory' class='copiable-anchor'> ¶</a></span></dt> +<dd><span id="index-output-directory_002c-specifying"></span> <p>Specify the directory <var>dirname</var> to which output files are written. Also look for input files in <var>dirname</var> first, before looking along the normal search path. See <a href="#Output-file-location">Output file location</a>. </p> </dd> -<dt>‘<samp>-parse-first-line</samp>’</dt> +<dt id='index-_002dno_002dparse_002dfirst_002dline'><span>‘<samp>-parse-first-line</samp>’<a href='#index-_002dno_002dparse_002dfirst_002dline' class='copiable-anchor'> ¶</a></span></dt> <dd><span id="index-_002dparse_002dfirst_002dline"></span> </dd> -<dt>‘<samp>-no-parse-first-line</samp>’</dt> -<dd><span id="index-_002dno_002dparse_002dfirst_002dline"></span> -<span id="index-parsing-the-first-line"></span> +<dt><span>‘<samp>-no-parse-first-line</samp>’</span></dt> +<dd><span id="index-parsing-the-first-line"></span> <p>Check or disable checking whether the first line of the main input file starts with ‘<samp>%&</samp>’, and parse it if it does. This line can be used specify the format and/or a TCX file. </p> </dd> -<dt>‘<samp>-progname=<var>string</var></samp>’</dt> -<dd><span id="index-_002dprogname_003dstring"></span> -<span id="index-binaries_002c-linking"></span> +<dt id='index-_002dprogname_003dstring'><span>‘<samp>-progname=<var>string</var></samp>’<a href='#index-_002dprogname_003dstring' class='copiable-anchor'> ¶</a></span></dt> +<dd><span id="index-binaries_002c-linking"></span> <span id="index-linking-binaries"></span> <span id="index-program-names_002c-special-1"></span> <p>Set program (and memory dump) name to <var>string</var>. This may affect the -search paths and other values used (see <a href="https://tug.org/texinfohtml/kpathsea.html#Config-files">Config files</a> in <cite>Kpathsea</cite>). Using this option is equivalent to making a link named +search paths and other values used (see <a data-manual="kpathsea" href="https://tug.org/texinfohtml/kpathsea.html#Config-files">Config files</a> in <cite>Kpathsea</cite>). Using this option is equivalent to making a link named <var>string</var> to the binary and then invoking the binary under that name. See <a href="#Memory-dumps">Memory dumps</a>. </p> </dd> -<dt>‘<samp>-recorder</samp>’</dt> -<dd><span id="index-_002drecorder"></span> -<span id="index-file-recorder"></span> +<dt id='index-_002drecorder'><span>‘<samp>-recorder</samp>’<a href='#index-_002drecorder' class='copiable-anchor'> ¶</a></span></dt> +<dd><span id="index-file-recorder"></span> <p>Enable the filename recorder. This makes the program save a list of the opened files into a file with (by default) extension ‘<samp>.fls</samp>’. For Aleph, this option is always on, and the file has extension ‘<samp>.ofl</samp>’. @@ -854,9 +825,8 @@ pid), as in <samp>texput1234.fls</samp>. You can use <samp>-jobname</samp> to explicitly set the basename. </p> </dd> -<dt>‘<samp>-translate-file=<var>tcxfile</var></samp>’</dt> -<dd><span id="index-_002dtranslate_002dfile_003dtcxfile"></span> -<span id="index-translation-file-for-TeX_002c-specifying"></span> +<dt id='index-_002dtranslate_002dfile_003dtcxfile'><span>‘<samp>-translate-file=<var>tcxfile</var></samp>’<a href='#index-_002dtranslate_002dfile_003dtcxfile' class='copiable-anchor'> ¶</a></span></dt> +<dd><span id="index-translation-file-for-TeX_002c-specifying"></span> <span id="index-_002etcx-character-translation-files"></span> <span id="index-first-line-of-the-main-input-file"></span> <p>Use <var>tcxfile</var> to define which characters are printable and translations @@ -864,12 +834,11 @@ between the internal and external character sets. Moreover, <var>tcxfile</var> can be explicitly declared in the first line of the main input file ‘<samp>%& -translate-file=<var>tcxfile</var></samp>’. This is the recommended method for portability reasons. -See <a href="#TCX-files">TCX files</a>. +See <a href="#TCX-files">TCX files: Character translations</a>. </p> </dd> -<dt>‘<samp>-8bit</samp>’</dt> -<dd><span id="index-_002d8bit"></span> -<span id="index-8-bit-clean"></span> +<dt id='index-_002d8bit'><span>‘<samp>-8bit</samp>’<a href='#index-_002d8bit' class='copiable-anchor'> ¶</a></span></dt> +<dd><span id="index-8-bit-clean"></span> <span id="index-8-bit-clean-output_002c-specifying"></span> <p>This option specifies that by default all characters should be considered printable. If ‘<samp>-translate-file</samp>’ was given as well, @@ -881,7 +850,9 @@ no-op in engines natively supporting Unicode. <hr> -<span id="Path-searching"></span><div class="header"> +</div> +<div class="section" id="Path-searching"> +<div class="header"> <p> Next: <a href="#Output-file-location" accesskey="n" rel="next">Output file location</a>, Previous: <a href="#Common-options" accesskey="p" rel="prev">Common options</a>, Up: <a href="#Commonalities" accesskey="u" rel="up">Commonalities</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> </div> @@ -895,9 +866,9 @@ Next: <a href="#Output-file-location" accesskey="n" rel="next">Output file locat the Kpathsea routines to do so. The precise names of the environment and configuration file variables which get searched for particular file formatted are therefore documented in the Kpathsea manual -(see <a href="https://tug.org/texinfohtml/kpathsea.html#Supported-file-formats">Supported file formats</a> in <cite>Kpathsea</cite>). Reading -<samp>texmf.cnf</samp> (see <a href="https://tug.org/texinfohtml/kpathsea.html#Config-files">Config files</a> in <cite>Kpathsea</cite>), invoking -<code>mktex…</code> scripts (see <a href="https://tug.org/texinfohtml/kpathsea.html#mktex-scripts">mktex scripts</a> in <cite>Kpathsea</cite>), and so on are all handled by Kpathsea. +(see <a data-manual="kpathsea" href="https://tug.org/texinfohtml/kpathsea.html#Supported-file-formats">Supported file formats</a> in <cite>Kpathsea</cite>). Reading +<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>), invoking +<code>mktex…</code> scripts (see <a data-manual="kpathsea" href="https://tug.org/texinfohtml/kpathsea.html#mktex-scripts">mktex scripts</a> in <cite>Kpathsea</cite>), and so on are all handled by Kpathsea. </p> <span id="index-font-aliases"></span> <span id="index-aliases-for-fonts"></span> @@ -911,7 +882,9 @@ names. </p> <hr> -<span id="Output-file-location"></span><div class="header"> +</div> +<div class="section" id="Output-file-location"> +<div class="header"> <p> Previous: <a href="#Path-searching" accesskey="p" rel="prev">Path searching</a>, Up: <a href="#Commonalities" accesskey="u" rel="up">Commonalities</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> </div> @@ -953,9 +926,12 @@ simply checked as given. </p> <hr> -<span id="Three-programs"></span><div class="header"> +</div> +</div> +<div class="chapter" id="Three-programs"> +<div class="header"> <p> -Next: <a href="#TeX" accesskey="n" rel="next">TeX</a>, Previous: <a href="#Commonalities" accesskey="p" rel="prev">Commonalities</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" accesskey="n" rel="next">TeX: Typesetting</a>, Previous: <a href="#Commonalities" accesskey="p" rel="prev">Commonalities</a>, Up: <a href="#Top" accesskey="u" rel="up">Web2c</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="Three-programs_003a-Metafont_002c-MetaPost_002c-and-TeX"></span><h2 class="chapter">4 Three programs: Metafont, MetaPost, and TeX</h2> @@ -968,24 +944,20 @@ Next: <a href="#TeX" accesskey="n" rel="next">TeX</a>, Previous: <a href="#Commo Besides the ones here, command-line options and other commonalities are described in the previous section. </p> -<table class="menu" border="0" cellspacing="0"> -<tr><td align="left" valign="top">• <a href="#Runtime-options" accesskey="1">Runtime options</a></td><td> </td><td align="left" valign="top">The <samp>texmf.cnf</samp> configuration file. -</td></tr> -<tr><td align="left" valign="top">• <a href="#Initial-and-virgin" accesskey="2">Initial and virgin</a></td><td> </td><td align="left" valign="top">Making memory dumps vs. production runs. -</td></tr> -<tr><td align="left" valign="top">• <a href="#Memory-dumps" accesskey="3">Memory dumps</a></td><td> </td><td align="left" valign="top">.fmt/.base files for fast startup. -</td></tr> -<tr><td align="left" valign="top">• <a href="#Editor-invocation" accesskey="4">Editor invocation</a></td><td> </td><td align="left" valign="top">The ‘e’ response at errors. -</td></tr> -<tr><td align="left" valign="top">• <a href="#g_t_005cinput-filenames" accesskey="5">\input filenames</a></td><td> </td><td align="left" valign="top">Filename delimiters and Kpathsea expansion. -</td></tr> -</table> +<ul class="section-toc"> +<li><a href="#Runtime-options" accesskey="1">Runtime options</a></li> +<li><a href="#Initial-and-virgin" accesskey="2">Initial and virgin</a></li> +<li><a href="#Memory-dumps" accesskey="3">Memory dumps</a></li> +<li><a href="#Editor-invocation" accesskey="4">Editor invocation</a></li> +<li><a href="#g_t_005cinput-filenames" accesskey="5"><code>\input</code> filenames</a></li> +</ul> <hr> -<span id="Runtime-options"></span><div class="header"> +<div class="section" id="Runtime-options"> +<div class="header"> <p> -Next: <a href="#Initial-and-virgin" accesskey="n" rel="next">Initial and virgin</a>, Up: <a href="#Three-programs" accesskey="u" rel="up">Three programs</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="#Initial-and-virgin" accesskey="n" rel="next">Initial and virgin</a>, Up: <a href="#Three-programs" accesskey="u" rel="up">Three programs: Metafont, MetaPost, and TeX</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="Runtime-options-1"></span><h3 class="section">4.1 Runtime options</h3> @@ -997,23 +969,19 @@ Next: <a href="#Initial-and-virgin" accesskey="n" rel="next">Initial and virgin< <p>Besides the configure- and compile-time options described in the installation section (see <a href="#Installation">Installation</a>), you can control a number of parameters in the <samp>texmf.cnf</samp> runtime file read by Kpathsea -(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>The main purpose of <samp>texmf.cnf</samp> is to specify search paths, but array sizes and other options are also set there. Most are rather obscure. Here are a few of the more interesting values: </p> <dl compact="compact"> -<dt>‘<samp>main_memory</samp>’ -<span id="index-main_005fmemory"></span> -</dt> +<dt id='index-main_005fmemory'><span>‘<samp>main_memory</samp>’<a href='#index-main_005fmemory' class='copiable-anchor'> ¶</a></span></dt> <dd><p>Total words of memory available, for TeX, Metafont, and MetaPost. Must remake the format file after changing. </p> </dd> -<dt>‘<samp>extra_mem_bot</samp>’ -<span id="index-extra_005fmem_005fbot"></span> -</dt> +<dt id='index-extra_005fmem_005fbot'><span>‘<samp>extra_mem_bot</samp>’<a href='#index-extra_005fmem_005fbot' class='copiable-anchor'> ¶</a></span></dt> <dd><span id="index-boxes_002c-memory-for"></span> <span id="index-glue_002c-memory-for"></span> <span id="index-breakpoints_002c-memory-for"></span> @@ -1023,9 +991,7 @@ glue, breakpoints, et al. If you use PiCTeX, you may well want to set this. </p> </dd> -<dt>‘<samp>expand_depth</samp>’ -<span id="index-expand_005fdepth"></span> -</dt> +<dt id='index-expand_005fdepth'><span>‘<samp>expand_depth</samp>’<a href='#index-expand_005fdepth' class='copiable-anchor'> ¶</a></span></dt> <dd><span id="index-recursive-expansion-limit"></span> <span id="index-expansion-limit_002c-recursive"></span> <span id="index-runtime-stack-overflow"></span> @@ -1051,10 +1017,8 @@ using the libsigsegv library (<a href="https://gnu.org/s/libsigsegv">https://gnu not seem worth the effort. </p> </dd> -<dt>‘<samp>texmf_casefold_search</samp>’ -<span id="index-texmf_005fcasefold_005fsearch"></span> -</dt> -<dd><p>See <a href="https://tug.org/texinfohtml/kpathsea.html#Casefolding-search">Casefolding search</a> in <cite>Kpathsea</cite>. +<dt id='index-texmf_005fcasefold_005fsearch'><span>‘<samp>texmf_casefold_search</samp>’<a href='#index-texmf_005fcasefold_005fsearch' class='copiable-anchor'> ¶</a></span></dt> +<dd><p>See <a data-manual="kpathsea" href="https://tug.org/texinfohtml/kpathsea.html#Casefolding-search">Casefolding search</a> in <cite>Kpathsea</cite>. </p> </dd> </dl> @@ -1090,9 +1054,11 @@ affecting your local values. </p> <hr> -<span id="Initial-and-virgin"></span><div class="header"> +</div> +<div class="section" id="Initial-and-virgin"> +<div class="header"> <p> -Next: <a href="#Memory-dumps" accesskey="n" rel="next">Memory dumps</a>, Previous: <a href="#Runtime-options" accesskey="p" rel="prev">Runtime options</a>, Up: <a href="#Three-programs" accesskey="u" rel="up">Three programs</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="#Memory-dumps" accesskey="n" rel="next">Memory dumps</a>, Previous: <a href="#Runtime-options" accesskey="p" rel="prev">Runtime options</a>, Up: <a href="#Three-programs" accesskey="u" rel="up">Three programs: Metafont, MetaPost, and TeX</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="Initial-and-virgin-1"></span><h3 class="section">4.2 Initial and virgin</h3> @@ -1124,9 +1090,11 @@ memory dump file. </p> <hr> -<span id="Memory-dumps"></span><div class="header"> +</div> +<div class="section" id="Memory-dumps"> +<div class="header"> <p> -Next: <a href="#Editor-invocation" accesskey="n" rel="next">Editor invocation</a>, Previous: <a href="#Initial-and-virgin" accesskey="p" rel="prev">Initial and virgin</a>, Up: <a href="#Three-programs" accesskey="u" rel="up">Three programs</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="#Editor-invocation" accesskey="n" rel="next">Editor invocation</a>, Previous: <a href="#Initial-and-virgin" accesskey="p" rel="prev">Initial and virgin</a>, Up: <a href="#Three-programs" accesskey="u" rel="up">Three programs: Metafont, MetaPost, and TeX</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="Memory-dumps-1"></span><h3 class="section">4.3 Memory dumps</h3> @@ -1140,18 +1108,16 @@ macros to be predefined; therefore, they support <em>memory dump</em> files, which can be read much more efficiently than ordinary source code. </p> -<table class="menu" border="0" cellspacing="0"> -<tr><td align="left" valign="top">• <a href="#Creating-memory-dumps" accesskey="1">Creating memory dumps</a></td><td> </td><td align="left" valign="top"> -</td></tr> -<tr><td align="left" valign="top">• <a href="#Determining-the-memory-dump-to-use" accesskey="2">Determining the memory dump to use</a></td><td> </td><td align="left" valign="top"> -</td></tr> -<tr><td align="left" valign="top">• <a href="#Hardware-and-memory-dumps" accesskey="3">Hardware and memory dumps</a></td><td> </td><td align="left" valign="top"> -</td></tr> -</table> +<ul class="section-toc"> +<li><a href="#Creating-memory-dumps" accesskey="1">Creating memory dumps</a></li> +<li><a href="#Determining-the-memory-dump-to-use" accesskey="2">Determining the memory dump to use</a></li> +<li><a href="#Hardware-and-memory-dumps" accesskey="3">Hardware and memory dumps</a></li> +</ul> <hr> -<span id="Creating-memory-dumps"></span><div class="header"> +<div class="subsection" id="Creating-memory-dumps"> +<div class="header"> <p> Next: <a href="#Determining-the-memory-dump-to-use" accesskey="n" rel="next">Determining the memory dump to use</a>, Up: <a href="#Memory-dumps" accesskey="u" rel="up">Memory dumps</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> </div> @@ -1176,11 +1142,11 @@ example). creating memory dumps: </p> <dl compact="compact"> -<dt>TeX</dt> +<dt><span>TeX</span></dt> <dd><p>(‘<samp>.fmt</samp>’) See <a href="#Initial-TeX">Initial TeX</a>. </p> </dd> -<dt>Metafont</dt> +<dt><span>Metafont</span></dt> <dd><p>(‘<samp>.base</samp>’) See <a href="#Initial-Metafont">Initial Metafont</a>. </p></dd> </dl> @@ -1193,7 +1159,9 @@ difficulties. </p> <hr> -<span id="Determining-the-memory-dump-to-use"></span><div class="header"> +</div> +<div class="subsection" id="Determining-the-memory-dump-to-use"> +<div class="header"> <p> Next: <a href="#Hardware-and-memory-dumps" accesskey="n" rel="next">Hardware and memory dumps</a>, Previous: <a href="#Creating-memory-dumps" accesskey="p" rel="prev">Creating memory dumps</a>, Up: <a href="#Memory-dumps" accesskey="u" rel="up">Memory dumps</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> </div> @@ -1230,7 +1198,7 @@ command line, not in response to ‘<samp>**</samp>’) is <code>%&< <p>The first line of the main input file can also specify which character translation file is to be used: <code>%&-translate-file=<var>tcxfile</var></code> -(see <a href="#TCX-files">TCX files</a>). +(see <a href="#TCX-files">TCX files: Character translations</a>). </p> <p>These two roles can be combined: <code>%&<var>dump</var> -translate-file=<var>tcxfile</var></code>. If this is done, the name of the dump @@ -1247,7 +1215,9 @@ will be used. <hr> -<span id="Hardware-and-memory-dumps"></span><div class="header"> +</div> +<div class="subsection" id="Hardware-and-memory-dumps"> +<div class="header"> <p> Previous: <a href="#Determining-the-memory-dump-to-use" accesskey="p" rel="prev">Determining the memory dump to use</a>, Up: <a href="#Memory-dumps" accesskey="u" rel="up">Memory dumps</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> </div> @@ -1266,24 +1236,34 @@ Previous: <a href="#Determining-the-memory-dump-to-use" accesskey="p" rel="prev" <span id="index-machine-dependencies"></span> <span id="index-architecture-dependencies"></span> <span id="index-dependencies_002c-hardware"></span> -<span id="index-_002d_002ddisable_002ddump_002dshare-configure-option"></span> -<p>By default, memory dump files are generally sharable between -architectures of different types; specifically, on machines of different -endianness (see <a href="https://www.gnu.org/software/libc/manual/html_mono/libc.html#Byte-order">Byte order</a> in <cite>GNU C Library</cite>). (This is a +<span id="index-32_002dbit-architecture"></span> +<span id="index-64_002dbit-architecture"></span> +<span id="index-long-data-type_002c-size-of"></span> +<p>By default, memory dump files are sharable between architectures of +different types; specifically, on machines of different endianness +(see <a data-manual="libc" href="https://www.gnu.org/software/libc/manual/html_mono/libc.html#Byte-order">Byte order</a> in <cite>GNU C Library</cite>) and with different word +sizes (4-byte <code>long</code> vs. 8-byte <code>long</code>). This is a feature of the Web2c implementation, and is not true of all TeX -implementations.) If you specify ‘<samp>--disable-dump-share</samp>’ to -<code>configure</code>, however, memory dumps will be endian-dependent. +implementations. +</p> +<span id="index-tl_002dcheck_002dfmtshare"></span> +<p>The script <code>tl-check-fmtshare</code> in the TeX Live source tree +(<samp>Master/tlpkg/bin</samp>) provides a relatively easy way to test that +a <samp>.fmt</samp> built on the local host can be loaded by a TeX engine +built on some remote host. </p> <span id="index-byte-swapping"></span> <span id="index-swapping-bytes"></span> -<p>The reason to do this is speed. To achieve endian-independence, the -reading of memory dumps on LittleEndian architectures, such as PC’s and -DEC architectures, is somewhat slowed (all the multibyte values have to -be swapped). Usually, this is not noticeable, and the advantage of -being able to share memory dumps across all platforms at a site far -outweighs the speed loss. But if you’re installing Web2c for use on -LittleEndian machines only, perhaps on a PC being used only by you, you -may wish to get maximum speed. +<span id="index-_002d_002ddisable_002ddump_002dshare-configure-option"></span> +<p>If you specify ‘<samp>--disable-dump-share</samp>’ to <code>configure</code>, +however, memory dumps will be endian-dependent. The reason to do this +is speed. To achieve endian-independence, the reading of memory dumps +on LittleEndian architectures, such as PC’s and DEC architectures, is +somewhat slowed (all the multibyte values have to be swapped). +Usually, this is not noticeable, and the advantage of being able to +share memory dumps across all platforms at a site far outweighs the +speed loss. But if you’re trying to squeeze out every possible bit of +performance, you may wish to do this. </p> <span id="index-floating_002dpoint-values"></span> <span id="index-glue-ratio-representations"></span> @@ -1291,8 +1271,8 @@ may wish to get maximum speed. <samp>.fmt</samp> files cannot be guaranteed to work. Floating-point values are always written in native format, and hence will generally not be readable across platforms. Fortunately, TeX uses floating point -only to represent glue ratios, and all common formats (plain, -LaTeX, AMSTeX, …) do not do any glue setting at +only to represent glue ratios, and none of the common formats (plain, +LaTeX, AMSTeX, …) do any glue setting at <samp>.fmt</samp>-creation time. Metafont does not use floating point in any dumped value at all. </p> @@ -1300,8 +1280,8 @@ any dumped value at all. <span id="index-time-and-date_002c-in-memory-dumps"></span> <span id="index-memory-dumps_002c-contain-date-and-time"></span> <p>Incidentally, different memory dump files will never compare equal -byte-for-byte, because the program always dumps the current date and -time. So don’t be alarmed by just a few bytes difference. +byte-for-byte, because the programs dump the current date and time. So +don’t be alarmed by a few bytes difference. </p> <span id="index-Harbison_002c-Samuel-P_002e"></span> <span id="index-Steele-Jr_002e_002c-Guy-L_002e"></span> @@ -1332,11 +1312,17 @@ Jr. (see <a href="#References">References</a>). } </pre></div> +<p>You can add <code>printf("long %d\n", sizeof(long));</code> to see the size +of the <code>long</code> data type. +</p> <hr> -<span id="Editor-invocation"></span><div class="header"> +</div> +</div> +<div class="section" id="Editor-invocation"> +<div class="header"> <p> -Next: <a href="#g_t_005cinput-filenames" accesskey="n" rel="next">\input filenames</a>, Previous: <a href="#Memory-dumps" accesskey="p" rel="prev">Memory dumps</a>, Up: <a href="#Three-programs" accesskey="u" rel="up">Three programs</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_005cinput-filenames" accesskey="n" rel="next"><code>\input</code> filenames</a>, Previous: <a href="#Memory-dumps" accesskey="p" rel="prev">Memory dumps</a>, Up: <a href="#Three-programs" accesskey="u" rel="up">Three programs: Metafont, MetaPost, and TeX</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="Editor-invocation-1"></span><h3 class="section">4.4 Editor invocation</h3> @@ -1366,9 +1352,11 @@ and ‘<samp>%s</samp>’ is replaced by the name of the current input f </p> <hr> -<span id="g_t_005cinput-filenames"></span><div class="header"> +</div> +<div class="section" id="g_t_005cinput-filenames"> +<div class="header"> <p> -Previous: <a href="#Editor-invocation" accesskey="p" rel="prev">Editor invocation</a>, Up: <a href="#Three-programs" accesskey="u" rel="up">Three programs</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="#Editor-invocation" accesskey="p" rel="prev">Editor invocation</a>, Up: <a href="#Three-programs" accesskey="u" rel="up">Three programs: Metafont, MetaPost, and TeX</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_005cinput-filenames-1"></span><h3 class="section">4.5 <code>\input</code> filenames</h3> @@ -1394,7 +1382,7 @@ with the primitive operation.) </p> <p>As (allowed) extensions to standard TeX, Web2c also supports specifying the filename in double quotes (<code>"some name"</code>) and in -braces (<code>{"some name"}</code>), which is convenient for filenames +braces (<code>{some name}</code>), which is convenient for filenames containing spaces or other special characters, as described in the sections below. </p> @@ -1412,20 +1400,18 @@ most one ‘<samp>.</samp>’. Do not use anything but simple filenames directory separators vary among systems; instead, add the necessary directories to the appropriate search path. </p> -<table class="menu" border="0" cellspacing="0"> -<tr><td align="left" valign="top">• <a href="#g_t_005cinput-quoted-filename" accesskey="1">Quotes</a></td><td> </td><td align="left" valign="top">\input "some name" -</td></tr> -<tr><td align="left" valign="top">• <a href="#g_t_005cinput-braced-filename" accesskey="2">Braces</a></td><td> </td><td align="left" valign="top">\input {some name} -</td></tr> -<tr><td align="left" valign="top">• <a href="#g_t_005cinput-filename-caveats" accesskey="3">Caveats</a></td><td> </td><td align="left" valign="top">Tokenization, nulls, Kpathsea expansion. -</td></tr> -</table> +<ul class="section-toc"> +<li><a href="#g_t_005cinput-quoted-filename" accesskey="1"><code>\input</code> quoted filename: <code>\input "some name"</code></a></li> +<li><a href="#g_t_005cinput-braced-filename" accesskey="2"><code>\input</code> braced filename: <code>\input{some name}</code></a></li> +<li><a href="#g_t_005cinput-filename-caveats" accesskey="3"><code>\input</code> filename caveats</a></li> +</ul> <hr> -<span id="g_t_005cinput-quoted-filename"></span><div class="header"> +<div class="subsection" id="g_t_005cinput-quoted-filename"> +<div class="header"> <p> -Next: <a href="#g_t_005cinput-braced-filename" accesskey="n" rel="next">\input braced filename</a>, Up: <a href="#g_t_005cinput-filenames" accesskey="u" rel="up">\input filenames</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_005cinput-braced-filename" accesskey="n" rel="next"><code>\input</code> braced filename: <code>\input{some name}</code></a>, Up: <a href="#g_t_005cinput-filenames" accesskey="u" rel="up"><code>\input</code> filenames</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_005cinput-quoted-filename_003a-_005cinput-_0022some-name_0022"></span><h4 class="subsection">4.5.1 <code>\input</code> quoted filename: <code>\input "some name"</code></h4> @@ -1456,9 +1442,11 @@ of its <code>\input</code> macro, thus: </p> <hr> -<span id="g_t_005cinput-braced-filename"></span><div class="header"> +</div> +<div class="subsection" id="g_t_005cinput-braced-filename"> +<div class="header"> <p> -Next: <a href="#g_t_005cinput-filename-caveats" accesskey="n" rel="next">\input filename caveats</a>, Previous: <a href="#g_t_005cinput-quoted-filename" accesskey="p" rel="prev">\input quoted filename</a>, Up: <a href="#g_t_005cinput-filenames" accesskey="u" rel="up">\input filenames</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_005cinput-filename-caveats" accesskey="n" rel="next"><code>\input</code> filename caveats</a>, Previous: <a href="#g_t_005cinput-quoted-filename" accesskey="p" rel="prev"><code>\input</code> quoted filename: <code>\input "some name"</code></a>, Up: <a href="#g_t_005cinput-filenames" accesskey="u" rel="up"><code>\input</code> filenames</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_005cinput-braced-filename_003a-_005cinput_007bsome-name_007d"></span><h4 class="subsection">4.5.2 <code>\input</code> braced filename: <code>\input{some name}</code></h4> @@ -1487,9 +1475,11 @@ within the filename. </p> <hr> -<span id="g_t_005cinput-filename-caveats"></span><div class="header"> +</div> +<div class="subsection" id="g_t_005cinput-filename-caveats"> +<div class="header"> <p> -Previous: <a href="#g_t_005cinput-braced-filename" accesskey="p" rel="prev">\input braced filename</a>, Up: <a href="#g_t_005cinput-filenames" accesskey="u" rel="up">\input filenames</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="#g_t_005cinput-braced-filename" accesskey="p" rel="prev"><code>\input</code> braced filename: <code>\input{some name}</code></a>, Up: <a href="#g_t_005cinput-filenames" accesskey="u" rel="up"><code>\input</code> filenames</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_005cinput-filename-caveats-1"></span><h4 class="subsection">4.5.3 <code>\input</code> filename caveats</h4> @@ -1538,9 +1528,13 @@ change their catcodes or use <code>\string</code>. </p> <hr> -<span id="TeX"></span><div class="header"> +</div> +</div> +</div> +<div class="chapter" id="TeX"> +<div class="header"> <p> -Next: <a href="#Metafont" accesskey="n" rel="next">Metafont</a>, Previous: <a href="#Three-programs" accesskey="p" rel="prev">Three programs</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="#Metafont" accesskey="n" rel="next">Metafont: Creating typeface families</a>, Previous: <a href="#Three-programs" accesskey="p" rel="prev">Three programs: Metafont, MetaPost, and TeX</a>, Up: <a href="#Top" accesskey="u" rel="up">Web2c</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_003a-Typesetting"></span><h2 class="chapter">5 TeX: Typesetting</h2> @@ -1562,28 +1556,22 @@ description of the TeX language, see <cite>The TeXbook</cite> (see <a href="#References">References</a>). Many other books on TeX, introductory and otherwise, are available. </p> -<table class="menu" border="0" cellspacing="0"> -<tr><td align="left" valign="top">• <a href="#tex-invocation" accesskey="1">tex invocation</a></td><td> </td><td align="left" valign="top">Invoking TeX. -</td></tr> -<tr><td align="left" valign="top">• <a href="#Initial-TeX" accesskey="2">Initial TeX</a></td><td> </td><td align="left" valign="top">Making format files. -</td></tr> -<tr><td align="left" valign="top">• <a href="#Formats" accesskey="3">Formats</a></td><td> </td><td align="left" valign="top">Major TeX macro packages. -</td></tr> -<tr><td align="left" valign="top">• <a href="#Languages-and-hyphenation" accesskey="4">Languages and hyphenation</a></td><td> </td><td align="left" valign="top">TeX supports many human languages. -</td></tr> -<tr><td align="left" valign="top">• <a href="#Shell-escapes" accesskey="5">Shell escapes</a></td><td> </td><td align="left" valign="top">Running subprograms from TeX. -</td></tr> -<tr><td align="left" valign="top">• <a href="#IPC-and-TeX" accesskey="6">IPC and TeX</a></td><td> </td><td align="left" valign="top">DVI output to a socket. -</td></tr> -<tr><td align="left" valign="top">• <a href="#TeX-extensions" accesskey="7">TeX extensions</a></td><td> </td><td align="left" valign="top">Additional engines with additional features. -</td></tr> -</table> +<ul class="section-toc"> +<li><a href="#tex-invocation" accesskey="1"><code>tex</code> invocation</a></li> +<li><a href="#Initial-TeX" accesskey="2">Initial TeX</a></li> +<li><a href="#Formats" accesskey="3">Formats</a></li> +<li><a href="#Languages-and-hyphenation" accesskey="4">Languages and hyphenation</a></li> +<li><a href="#Shell-escapes" accesskey="5">Shell escapes</a></li> +<li><a href="#IPC-and-TeX" accesskey="6">IPC and TeX</a></li> +<li><a href="#TeX-extensions" accesskey="7">Extended TeX engines</a></li> +</ul> <hr> -<span id="tex-invocation"></span><div class="header"> +<div class="section" id="tex-invocation"> +<div class="header"> <p> -Next: <a href="#Initial-TeX" accesskey="n" rel="next">Initial TeX</a>, Up: <a href="#TeX" accesskey="u" rel="up">TeX</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="#Initial-TeX" accesskey="n" rel="next">Initial TeX</a>, Up: <a href="#TeX" accesskey="u" rel="up">TeX: Typesetting</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-invocation-1"></span><h3 class="section">5.1 <code>tex</code> invocation</h3> @@ -1610,7 +1598,7 @@ tex [<var>option</var>]… &<var>fmt</var> <var>args</var> <span id="index-_002etex"></span> <span id="index-TeX_002c-input-files-found"></span> <p>TeX searches the usual places for the main input file <var>texname</var> -(see <a href="https://tug.org/texinfohtml/kpathsea.html#Supported-file-formats">Supported file formats</a> in <cite>Kpathsea</cite>), extending +(see <a data-manual="kpathsea" href="https://tug.org/texinfohtml/kpathsea.html#Supported-file-formats">Supported file formats</a> in <cite>Kpathsea</cite>), extending <var>texname</var> with <samp>.tex</samp> if necessary. To see all the relevant paths, set the environment variable <code>KPATHSEA_DEBUG</code> to ‘<samp>-1</samp>’ before running the program. @@ -1632,7 +1620,7 @@ file is a device-independent binary representation of your TeX document. The idea is that after running TeX, you translate the DVI file using a separate program to the commands for a particular output device, such as a PostScript printer -(see <a href="https://tug.org/texinfohtml/dvips.html#Top">Introduction</a> in <cite>Dvips</cite>) or an X Window System display +(see <a data-manual="dvips" href="https://tug.org/texinfohtml/dvips.html#Top">Introduction</a> in <cite>Dvips</cite>) or an X Window System display (see xdvi(1)). </p> <span id="index-EC-fonts"></span> @@ -1641,7 +1629,7 @@ device, such as a PostScript printer <p>TeX also reads TFM files for any fonts you load in your document with the <code>\font</code> primitive. By default, it runs an external program named <samp>mktextfm</samp> to create any nonexistent TFM files. You can -disable this at configure-time or runtime (see <a href="https://tug.org/texinfohtml/kpathsea.html#mktex-configuration">mktex +disable this at configure-time or runtime (see <a data-manual="kpathsea" href="https://tug.org/texinfohtml/kpathsea.html#mktex-configuration">mktex configuration</a> in <cite>Kpathsea</cite>). This is enabled mostly for the sake of the EC fonts, which can be generated at any size. </p> @@ -1656,7 +1644,7 @@ a security hole vulnerable to Trojan horse attack: an unwitting user could run a TeX program that overwrites, say, <samp>~/.rhosts</samp>. (MetaPost has a <code>write</code> primitive with similar implications). To alleviate this and similar problems the functions <code>kpathsea_out_name_ok</code> and -<code>kpathsea_in_name_ok</code> from the Kpathse library (see <a href="https://tug.org/texinfohtml/kpathsea.html#Calling-sequence">Calling +<code>kpathsea_in_name_ok</code> from the Kpathsea library (see <a data-manual="kpathsea" href="https://tug.org/texinfohtml/kpathsea.html#Calling-sequence">Calling sequence</a> in <cite>Kpathsea</cite>) are used to determine if a given filename is acceptable to be opened for output or input, depending on the setting of the configuration variables <code>openout_any</code> and <code>openin_any</code>: @@ -1671,29 +1659,28 @@ the log file has not yet been opened. <p>The program accepts the following options, as well as the standard ‘<samp>-help</samp>’ and ‘<samp>-version</samp>’ (see <a href="#Common-options">Common options</a>): </p><dl compact="compact"> -<dt>‘<samp>-enc</samp>’</dt> -<dt>‘<samp>-[no]-file-line-error</samp>’</dt> -<dt>‘<samp>-fmt=<var>fmtname</var></samp>’</dt> -<dt>‘<samp>-halt-on-error</samp>’</dt> -<dt>‘<samp>-ini</samp>’</dt> -<dt>‘<samp>-interaction=<var>string</var></samp>’</dt> -<dt>‘<samp>-ipc</samp>’</dt> -<dt>‘<samp>-ipc-start</samp>’</dt> -<dt>‘<samp>-jobname=<var>string</var></samp>’</dt> -<dt>‘<samp>-kpathsea-debug=<var>number</var></samp>’</dt> -<dt>‘<samp>-[no]parse-first-line</samp>’</dt> -<dt>‘<samp>-output-directory</samp>’</dt> -<dt>‘<samp>-progname=<var>string</var></samp>’</dt> -<dt>‘<samp>-recorder</samp>’</dt> -<dt>‘<samp>-translate-file=<var>tcxfile</var></samp>’</dt> -<dt>‘<samp>-8bit</samp>’</dt> +<dt><span>‘<samp>-enc</samp>’</span></dt> +<dt><span>‘<samp>-[no]-file-line-error</samp>’</span></dt> +<dt><span>‘<samp>-fmt=<var>fmtname</var></samp>’</span></dt> +<dt><span>‘<samp>-halt-on-error</samp>’</span></dt> +<dt><span>‘<samp>-ini</samp>’</span></dt> +<dt><span>‘<samp>-interaction=<var>string</var></samp>’</span></dt> +<dt><span>‘<samp>-ipc</samp>’</span></dt> +<dt><span>‘<samp>-ipc-start</samp>’</span></dt> +<dt><span>‘<samp>-jobname=<var>string</var></samp>’</span></dt> +<dt><span>‘<samp>-kpathsea-debug=<var>number</var></samp>’</span></dt> +<dt><span>‘<samp>-[no]parse-first-line</samp>’</span></dt> +<dt><span>‘<samp>-output-directory</samp>’</span></dt> +<dt><span>‘<samp>-progname=<var>string</var></samp>’</span></dt> +<dt><span>‘<samp>-recorder</samp>’</span></dt> +<dt><span>‘<samp>-translate-file=<var>tcxfile</var></samp>’</span></dt> +<dt><span>‘<samp>-8bit</samp>’</span></dt> <dd><p>These options are common to TeX, Metafont, and MetaPost. See <a href="#Common-options">Common options</a>. </p> </dd> -<dt>‘<samp>-enc</samp>’</dt> -<dd><span id="index-_002denc"></span> -<span id="index-Unicode-input"></span> +<dt id='index-_002denc'><span>‘<samp>-enc</samp>’<a href='#index-_002denc' class='copiable-anchor'> ¶</a></span></dt> +<dd><span id="index-Unicode-input"></span> <span id="index-UTF_002d8-input"></span> <p>Enable encTeX extensions, such as <code>\mubyte</code>. This can be used to support the Unicode UTF-8 input encoding, although using an engine @@ -1701,10 +1688,9 @@ with native Unicode support is more common nowadays. <a href="http://www.olsak.net/enctex.html">http://www.olsak.net/enctex.html</a>. </p> </dd> -<dt>‘<samp>-ipc</samp>’</dt> -<dt>‘<samp>-ipc-start</samp>’</dt> -<dd><span id="index-_002dipc"></span> -<span id="index-_002dipc_002dstart"></span> +<dt id='index-_002dipc'><span>‘<samp>-ipc</samp>’<a href='#index-_002dipc' class='copiable-anchor'> ¶</a></span></dt> +<dt><span>‘<samp>-ipc-start</samp>’</span></dt> +<dd><span id="index-_002dipc_002dstart"></span> <span id="index-_002d_002denable_002dipc-configure-option"></span> <p>With either option, TeX writes its DVI output to a socket as well as to the usual <samp>.dvi</samp> file. With ‘<samp>-ipc-start</samp>’, TeX also @@ -1714,27 +1700,24 @@ opens a server program at the other end to read the output. See <a href="#IPC-a specified to <code>configure</code> during installation of Web2c. </p> </dd> -<dt>‘<samp>-mktex=<var>filetype</var></samp>’</dt> -<dt>‘<samp>-no-mktex=<var>filetype</var></samp>’</dt> -<dd><span id="index-_002dmktex_003dfiletype"></span> -<span id="index-_002dno_002dmktex_003dfiletype"></span> +<dt id='index-_002dmktex_003dfiletype'><span>‘<samp>-mktex=<var>filetype</var></samp>’<a href='#index-_002dmktex_003dfiletype' class='copiable-anchor'> ¶</a></span></dt> +<dt><span>‘<samp>-no-mktex=<var>filetype</var></samp>’</span></dt> +<dd><span id="index-_002dno_002dmktex_003dfiletype"></span> <p>Turn on or off the ‘<samp>mktex</samp>’ script associated with <var>filetype</var>. For TeX proper, <var>filetype</var> can only be ‘<samp>tex</samp>’ and ‘<samp>tfm</samp>’, but for pdfTeX and luaTeX, it can also be ‘<samp>pk</samp>’. </p> </dd> -<dt>‘<samp>-mltex</samp>’</dt> -<dd><span id="index-_002dmltex"></span> -<span id="index-MLTeX_002c-enabling"></span> +<dt id='index-_002dmltex'><span>‘<samp>-mltex</samp>’<a href='#index-_002dmltex' class='copiable-anchor'> ¶</a></span></dt> +<dd><span id="index-MLTeX_002c-enabling"></span> <span id="index-program-names_002c-special-2"></span> <p>If we are <code>INITEX</code> (see <a href="#Initial-and-virgin">Initial and virgin</a>), enable MLTeX extensions such as <code>\charsubdef</code>. Implicitly set if the program name is <code>mltex</code>. See <a href="#MLTeX">MLTeX</a>. </p> </dd> -<dt>‘<samp>-output-comment=<var>string</var></samp>’</dt> -<dd><span id="index-_002doutput_002dcomment_003dstring"></span> -<span id="index-output_005fcomment-for-DVI-files"></span> +<dt id='index-_002doutput_002dcomment_003dstring'><span>‘<samp>-output-comment=<var>string</var></samp>’<a href='#index-_002doutput_002dcomment_003dstring' class='copiable-anchor'> ¶</a></span></dt> +<dd><span id="index-output_005fcomment-for-DVI-files"></span> <span id="index-DVI-comment_002c-specifying"></span> <span id="index-regression-testing"></span> <p>Use <var>string</var> as the DVI file comment. Ordinarily, this comment @@ -1744,33 +1727,30 @@ difference. This is also taken from the environment variable and config file value ‘<samp>output_comment</samp>’. </p> </dd> -<dt>‘<samp>-shell-escape</samp>’</dt> +<dt id='index-_002dshell_002drestricted'><span>‘<samp>-shell-escape</samp>’<a href='#index-_002dshell_002drestricted' class='copiable-anchor'> ¶</a></span></dt> <dd><span id="index-_002dshell_002descape"></span> </dd> -<dt>‘<samp>-no-shell-escape</samp>’</dt> +<dt><span>‘<samp>-no-shell-escape</samp>’</span></dt> <dd><span id="index-_002dno_002dshell_002descape"></span> </dd> -<dt>‘<samp>-shell-restricted</samp>’</dt> -<dd><span id="index-_002dshell_002drestricted"></span> -<p>Enable, or disable, or enable with restrictions the +<dt><span>‘<samp>-shell-restricted</samp>’</span></dt> +<dd><p>Enable, or disable, or enable with restrictions the <code>\write18{<var>shell-command</var>}</code> feature for external executing shell commands. See <a href="#Shell-escapes">Shell escapes</a>. </p> </dd> -<dt>‘<samp>-enable-write18</samp>’</dt> +<dt id='index-_002ddisable_002dwrite18'><span>‘<samp>-enable-write18</samp>’<a href='#index-_002ddisable_002dwrite18' class='copiable-anchor'> ¶</a></span></dt> <dd><span id="index-_002denable_002dwrite18"></span> </dd> -<dt>‘<samp>-disable-write18</samp>’</dt> -<dd><span id="index-_002ddisable_002dwrite18"></span> -<p>Synonyms for <samp>-shell-escape</samp> and <samp>-no-shell-escape</samp>, for +<dt><span>‘<samp>-disable-write18</samp>’</span></dt> +<dd><p>Synonyms for <samp>-shell-escape</samp> and <samp>-no-shell-escape</samp>, for compatibility with MiKTeX. (MiKTeX also accepts both pairs of options.) See <a href="#Shell-escapes">Shell escapes</a>. </p> </dd> -<dt>‘<samp>-src-specials</samp>’</dt> -<dt>‘<samp>-src-specials=<var>string</var></samp>’</dt> -<dd><span id="index-generating-source-specials"></span> -<p>This option makes TeX output specific source information using +<dt id='index-generating-source-specials'><span>‘<samp>-src-specials</samp>’<a href='#index-generating-source-specials' class='copiable-anchor'> ¶</a></span></dt> +<dt><span>‘<samp>-src-specials=<var>string</var></samp>’</span></dt> +<dd><p>This option makes TeX output specific source information using ‘<samp>\special</samp>’ commands in the DVI file. These ‘<samp>\special</samp>’ track the current file name and line number. </p> @@ -1807,9 +1787,11 @@ hard-coded to always use the ‘<samp>\special</samp>’ primitive. <hr> -<span id="Initial-TeX"></span><div class="header"> +</div> +<div class="section" id="Initial-TeX"> +<div class="header"> <p> -Next: <a href="#Formats" accesskey="n" rel="next">Formats</a>, Previous: <a href="#tex-invocation" accesskey="p" rel="prev">tex invocation</a>, Up: <a href="#TeX" accesskey="u" rel="up">TeX</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="#Formats" accesskey="n" rel="next">Formats</a>, Previous: <a href="#tex-invocation" accesskey="p" rel="prev"><code>tex</code> invocation</a>, Up: <a href="#TeX" accesskey="u" rel="up">TeX: Typesetting</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="Initial-TeX-1"></span><h3 class="section">5.2 Initial TeX</h3> @@ -1823,7 +1805,7 @@ does lengthy initializations avoided by the “virgin” (<code>vir</cod form, so as to be capable of dumping ‘<samp>.fmt</samp>’ files (see <a href="#Memory-dumps">Memory dumps</a>). For a detailed comparison of virgin and initial forms, see <a href="#Initial-and-virgin">Initial and virgin</a>. </p> -<p>For a list of options and other information, see <a href="#tex-invocation">tex invocation</a>. +<p>For a list of options and other information, see <a href="#tex-invocation"><code>tex</code> invocation</a>. </p> <span id="index-plain_002efmt"></span> <span id="index-tex_002efmt"></span> @@ -1850,9 +1832,11 @@ more details on TeX formats. </p> <hr> -<span id="Formats"></span><div class="header"> +</div> +<div class="section" id="Formats"> +<div class="header"> <p> -Next: <a href="#Languages-and-hyphenation" accesskey="n" rel="next">Languages and hyphenation</a>, Previous: <a href="#Initial-TeX" accesskey="p" rel="prev">Initial TeX</a>, Up: <a href="#TeX" accesskey="u" rel="up">TeX</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="#Languages-and-hyphenation" accesskey="n" rel="next">Languages and hyphenation</a>, Previous: <a href="#Initial-TeX" accesskey="p" rel="prev">Initial TeX</a>, Up: <a href="#TeX" accesskey="u" rel="up">TeX: Typesetting</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="Formats-1"></span><h3 class="section">5.3 Formats</h3> @@ -1873,9 +1857,8 @@ larger TeX distribution, such as TeX Live (<a href="https://tug.org/texlive">https://tug.org/texlive</a>). </p> <dl compact="compact"> -<dt><tt>latex</tt></dt> -<dd><span id="index-LaTeX"></span> -<p>The most widely used format. The current release is named +<dt id='index-LaTeX'><span><tt>latex</tt><a href='#index-LaTeX' class='copiable-anchor'> ¶</a></span></dt> +<dd><p>The most widely used format. The current release is named ‘LaTeX2e’; new versions are released approximately every six months, with patches issued as needed. The old release was called ‘LaTeX 2.09’, and is no longer maintained or supported. LaTeX @@ -1885,18 +1868,16 @@ attempts to provide generic markup instructions, such as page: <a href="https://www.latex-project.org">https://www.latex-project.org</a>. </p> </dd> -<dt><tt>context</tt></dt> -<dd><span id="index-ConTeXt"></span> -<p>ConTeXt is an independent macro package which has a basic document +<dt id='index-ConTeXt'><span><tt>context</tt><a href='#index-ConTeXt' class='copiable-anchor'> ¶</a></span></dt> +<dd><p>ConTeXt is an independent macro package which has a basic document structuring approach similar to LaTeX. It also supports creating interactive PDF files and has integrated MetaPost support, among many other interesting features. The ConTeXt home page: <a href="http://www.pragma-ade.com">http://www.pragma-ade.com</a>. </p> </dd> -<dt><tt>amstex</tt></dt> -<dd><span id="index-AMSTeX"></span> -<span id="index-American-Mathematical-Society_002c-typesetting-system"></span> +<dt id='index-AMSTeX'><span><tt>amstex</tt><a href='#index-AMSTeX' class='copiable-anchor'> ¶</a></span></dt> +<dd><span id="index-American-Mathematical-Society_002c-typesetting-system"></span> <span id="index-Mathematical-Reviews"></span> <p>The official typesetting system of the American Mathematical Society. Like LaTeX, it encourages generic markup commands. The AMS also @@ -1906,9 +1887,8 @@ together, they are used to produce nearly all AMS publications, e.g., <a href="https://www.ams.org/tex">https://www.ams.org/tex</a>. </p> </dd> -<dt><tt>texinfo</tt></dt> -<dd><span id="index-Texinfo"></span> -<span id="index-Info-format"></span> +<dt id='index-Texinfo'><span><tt>texinfo</tt><a href='#index-Texinfo' class='copiable-anchor'> ¶</a></span></dt> +<dd><span id="index-Info-format"></span> <span id="index-Free-Software-Foundation-documentation-system"></span> <p>The documentation system developed and maintained by the Free Software Foundation for their software manuals. It can be automatically @@ -1917,9 +1897,8 @@ converted into plain text, a machine-readable on-line format called <a href="https://www.gnu.org/software/texinfo">https://www.gnu.org/software/texinfo</a>. </p> </dd> -<dt><tt>eplain</tt></dt> -<dd><span id="index-Eplain"></span> -<span id="index-expanded-plain-format"></span> +<dt id='index-Eplain'><span><tt>eplain</tt><a href='#index-Eplain' class='copiable-anchor'> ¶</a></span></dt> +<dd><span id="index-expanded-plain-format"></span> <p>The “expanded plain” format provides various common features (e.g., symbolic cross-referencing, tables of contents, indexing, citations using BibTeX), for those authors who prefer to handle their own @@ -1927,9 +1906,8 @@ high-level formatting. The Eplain home page: <a href="https://tug.org/eplain">https://tug.org/eplain</a>. </p> </dd> -<dt><tt>slitex</tt></dt> -<dd><span id="index-SliTeX"></span> -<span id="index-slides_002c-producing"></span> +<dt id='index-SliTeX'><span><tt>slitex</tt><a href='#index-SliTeX' class='copiable-anchor'> ¶</a></span></dt> +<dd><span id="index-slides_002c-producing"></span> <span id="index-beamer_002c-package"></span> <p>An obsolete LaTeX 2.09 format for making slides. It is replaced by the ‘<samp>slides</samp>’ document class, although the ‘<samp>beamer</samp>’ package @@ -1941,9 +1919,11 @@ page on CTAN: <a href="https://ctan.org/pkg/beamer">https://ctan.org/pkg/beamer< <hr> -<span id="Languages-and-hyphenation"></span><div class="header"> +</div> +<div class="section" id="Languages-and-hyphenation"> +<div class="header"> <p> -Next: <a href="#Shell-escapes" accesskey="n" rel="next">Shell escapes</a>, Previous: <a href="#Formats" accesskey="p" rel="prev">Formats</a>, Up: <a href="#TeX" accesskey="u" rel="up">TeX</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="#Shell-escapes" accesskey="n" rel="next">Shell escapes</a>, Previous: <a href="#Formats" accesskey="p" rel="prev">Formats</a>, Up: <a href="#TeX" accesskey="u" rel="up">TeX: Typesetting</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="Languages-and-hyphenation-1"></span><h3 class="section">5.4 Languages and hyphenation</h3> @@ -1953,20 +1933,18 @@ Next: <a href="#Shell-escapes" accesskey="n" rel="next">Shell escapes</a>, Previ <p>TeX supports most natural languages. See also <a href="#TeX-extensions">TeX extensions</a>. </p> -<table class="menu" border="0" cellspacing="0"> -<tr><td align="left" valign="top">• <a href="#MLTeX" accesskey="1">MLTeX</a></td><td> </td><td align="left" valign="top">Multi-lingual TeX. -</td></tr> -<tr><td align="left" valign="top">• <a href="#TCX-files" accesskey="2">TCX files</a></td><td> </td><td align="left" valign="top">Support for different character sets & fonts. -</td></tr> -<tr><td align="left" valign="top">• <a href="#patgen-invocation" accesskey="3">patgen invocation</a></td><td> </td><td align="left" valign="top">Creating hyphenation patterns. -</td></tr> -</table> +<ul class="section-toc"> +<li><a href="#MLTeX" accesskey="1">MLTeX: Multi-lingual TeX</a></li> +<li><a href="#TCX-files" accesskey="2">TCX files: Character translations</a></li> +<li><a href="#patgen-invocation" accesskey="3">Patgen: Creating hyphenation patterns</a></li> +</ul> <hr> -<span id="MLTeX"></span><div class="header"> +<div class="subsection" id="MLTeX"> +<div class="header"> <p> -Next: <a href="#TCX-files" accesskey="n" rel="next">TCX files</a>, Up: <a href="#Languages-and-hyphenation" accesskey="u" rel="up">Languages and hyphenation</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="#TCX-files" accesskey="n" rel="next">TCX files: Character translations</a>, Up: <a href="#Languages-and-hyphenation" accesskey="u" rel="up">Languages and hyphenation</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="MLTeX_003a-Multi_002dlingual-TeX"></span><h4 class="subsection">5.4.1 MLTeX: Multi-lingual TeX</h4> @@ -2006,18 +1984,17 @@ file. <p>The sections below describe the two new primitives that MLTeX defines. Aside from these, MLTeX is completely compatible with standard TeX. </p> -<table class="menu" border="0" cellspacing="0"> -<tr><td align="left" valign="top">• <a href="#g_t_005ccharsubdef" accesskey="1">\charsubdef</a></td><td> </td><td align="left" valign="top">Character substitution definitions. -</td></tr> -<tr><td align="left" valign="top">• <a href="#g_t_005ctracingcharsubdef" accesskey="2">\tracingcharsubdef</a></td><td> </td><td align="left" valign="top">Tracing substitutions. -</td></tr> -</table> +<ul class="section-toc"> +<li><a href="#g_t_005ccharsubdef" accesskey="1"><code>\charsubdef</code>: Character substitutions</a></li> +<li><a href="#g_t_005ctracingcharsubdef" accesskey="2"><code>\tracingcharsubdef</code>: Substitution diagnostics</a></li> +</ul> <hr> -<span id="g_t_005ccharsubdef"></span><div class="header"> +<div class="subsubsection" id="g_t_005ccharsubdef"> +<div class="header"> <p> -Next: <a href="#g_t_005ctracingcharsubdef" accesskey="n" rel="next">\tracingcharsubdef</a>, Up: <a href="#MLTeX" accesskey="u" rel="up">MLTeX</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_005ctracingcharsubdef" accesskey="n" rel="next"><code>\tracingcharsubdef</code>: Substitution diagnostics</a>, Up: <a href="#MLTeX" accesskey="u" rel="up">MLTeX: Multi-lingual TeX</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_005ccharsubdef_003a-Character-substitutions"></span><h4 class="subsubsection">5.4.1.1 <code>\charsubdef</code>: Character substitutions</h4> @@ -2079,9 +2056,11 @@ accessed often, so changing it is not desirable, nor generally useful.) </p> <hr> -<span id="g_t_005ctracingcharsubdef"></span><div class="header"> +</div> +<div class="subsubsection" id="g_t_005ctracingcharsubdef"> +<div class="header"> <p> -Previous: <a href="#g_t_005ccharsubdef" accesskey="p" rel="prev">\charsubdef</a>, Up: <a href="#MLTeX" accesskey="u" rel="up">MLTeX</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="#g_t_005ccharsubdef" accesskey="p" rel="prev"><code>\charsubdef</code>: Character substitutions</a>, Up: <a href="#MLTeX" accesskey="u" rel="up">MLTeX: Multi-lingual TeX</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_005ctracingcharsubdef_003a-Substitution-diagnostics"></span><h4 class="subsubsection">5.4.1.2 <code>\tracingcharsubdef</code>: Substitution diagnostics</h4> @@ -2099,9 +2078,12 @@ more, the character substitutions actually performed at </p> <hr> -<span id="TCX-files"></span><div class="header"> +</div> +</div> +<div class="subsection" id="TCX-files"> +<div class="header"> <p> -Next: <a href="#patgen-invocation" accesskey="n" rel="next">patgen invocation</a>, Previous: <a href="#MLTeX" accesskey="p" rel="prev">MLTeX</a>, Up: <a href="#Languages-and-hyphenation" accesskey="u" rel="up">Languages and hyphenation</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="#patgen-invocation" accesskey="n" rel="next">Patgen: Creating hyphenation patterns</a>, Previous: <a href="#MLTeX" accesskey="p" rel="prev">MLTeX: Multi-lingual TeX</a>, Up: <a href="#Languages-and-hyphenation" accesskey="u" rel="up">Languages and hyphenation</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="TCX-files_003a-Character-translations"></span><h4 class="subsection">5.4.2 TCX files: Character translations</h4> @@ -2135,7 +2117,7 @@ the worst case, failure to do so correctly may result in subtle errors in the typeset output. But we feel the benefits outweigh these disadvantages. </p> -<p>This is entirely independent of the MLTeX extension (see <a href="#MLTeX">MLTeX</a>): +<p>This is entirely independent of the MLTeX extension (see <a href="#MLTeX">MLTeX: Multi-lingual TeX</a>): whereas a TCX file defines how an input keyboard character is mapped to TeX’s internal code, MLTeX defines substitutions for a non-existing character glyph in a font with a <code>\accent</code> @@ -2261,9 +2243,11 @@ the dump is ignored and the data from the file used instead. </p> <hr> -<span id="patgen-invocation"></span><div class="header"> +</div> +<div class="subsection" id="patgen-invocation"> +<div class="header"> <p> -Previous: <a href="#TCX-files" accesskey="p" rel="prev">TCX files</a>, Up: <a href="#Languages-and-hyphenation" accesskey="u" rel="up">Languages and hyphenation</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="#TCX-files" accesskey="p" rel="prev">TCX files: Character translations</a>, Up: <a href="#Languages-and-hyphenation" accesskey="u" rel="up">Languages and hyphenation</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="Patgen_003a-Creating-hyphenation-patterns"></span><h4 class="subsection">5.4.3 Patgen: Creating hyphenation patterns</h4> @@ -2284,16 +2268,19 @@ written to the file <var>output</var>. <p>In addition, Patgen prompts interactively for other values. </p> -<p>For more information, see <cite>Word hy-phen-a-tion by com-puter</cite> by +<p>For more information, see <cite>Word hy-phen-a-tion by com-put-er</cite> by Frank Liang (see <a href="#References">References</a>), and also the <samp>patgen.web</samp> source file. </p> <p>The only options are ‘<samp>-help</samp>’ and ‘<samp>-version</samp>’ (see <a href="#Common-options">Common options</a>). </p> <hr> -<span id="Shell-escapes"></span><div class="header"> +</div> +</div> +<div class="section" id="Shell-escapes"> +<div class="header"> <p> -Next: <a href="#IPC-and-TeX" accesskey="n" rel="next">IPC and TeX</a>, Previous: <a href="#Languages-and-hyphenation" accesskey="p" rel="prev">Languages and hyphenation</a>, Up: <a href="#TeX" accesskey="u" rel="up">TeX</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="#IPC-and-TeX" accesskey="n" rel="next">IPC and TeX</a>, Previous: <a href="#Languages-and-hyphenation" accesskey="p" rel="prev">Languages and hyphenation</a>, Up: <a href="#TeX" accesskey="u" rel="up">TeX: Typesetting</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="Shell-escapes-1"></span><h3 class="section">5.5 Shell escapes</h3> @@ -2399,9 +2386,11 @@ considered untrustworthy, shell escapes should be completely disabled. </p> <hr> -<span id="IPC-and-TeX"></span><div class="header"> +</div> +<div class="section" id="IPC-and-TeX"> +<div class="header"> <p> -Next: <a href="#TeX-extensions" accesskey="n" rel="next">TeX extensions</a>, Previous: <a href="#Shell-escapes" accesskey="p" rel="prev">Shell escapes</a>, Up: <a href="#TeX" accesskey="u" rel="up">TeX</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-extensions" accesskey="n" rel="next">Extended TeX engines</a>, Previous: <a href="#Shell-escapes" accesskey="p" rel="prev">Shell escapes</a>, Up: <a href="#TeX" accesskey="u" rel="up">TeX: Typesetting</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="IPC-and-TeX-1"></span><h3 class="section">5.6 IPC and TeX</h3> @@ -2422,39 +2411,51 @@ debugging. </p> <hr> -<span id="TeX-extensions"></span><div class="header"> +</div> +<div class="section" id="TeX-extensions"> +<div class="header"> <p> -Previous: <a href="#IPC-and-TeX" accesskey="p" rel="prev">IPC and TeX</a>, Up: <a href="#TeX" accesskey="u" rel="up">TeX</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="#IPC-and-TeX" accesskey="p" rel="prev">IPC and TeX</a>, Up: <a href="#TeX" accesskey="u" rel="up">TeX: Typesetting</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="Extended-TeX-engines"></span><h3 class="section">5.7 Extended TeX engines</h3> <span id="index-extensions-to-TeX"></span> <span id="index-TeX_002c-extensions-to"></span> -<p>The base TeX program has been extended in many ways. Here’s a -partial list. +<p>The base TeX program has been extended in many ways. +</p> +<span id="index-cross_002dengine-functionality"></span> +<p>There has been a substantial effort to make a set of extended +functionality available across all actively-updated engines, so that +formats, notably LaTeX, can rely on it. A list of this common +extended functionality is in a <cite>LaTeX News</cite> article, +<a href="https://www.latex-project.org/news/latex2e-news/ltnews31.pdf">https://www.latex-project.org/news/latex2e-news/ltnews31.pdf</a>. +For engines in TeX Live, the detailed documentation for these +primitives is mostly in the pdfTeX manual +(<a href="http://pdftex.org">http://pdftex.org</a>). +</p> +<p>In addition, each engine (naturally) has its own particular features, +described in its own manual. Here’s a partial list of the engines. </p> <dl compact="compact"> -<dt>e-TeX</dt> -<dd><span id="index-e_002dTeX"></span> -<span id="index-primitives_002c-new"></span> +<dt id='index-e_002dTeX'><span>e-TeX<a href='#index-e_002dTeX' class='copiable-anchor'> ¶</a></span></dt> +<dd><span id="index-primitives_002c-new"></span> <p>Adds many new primitives, including right-to-left typesetting and more -registers. Now frozen. More info: <a href="https://ctan.org/pkg/etex">https://ctan.org/pkg/etex</a>. +registers. Now frozen. More info: <a href="https://ctan.org/pkg/etex">https://ctan.org/pkg/etex</a>. </p> </dd> -<dt>Aleph</dt> -<dd><span id="index-Aleph"></span> -<span id="index-Omega"></span> +<dt id='index-Aleph'><span>Aleph<a href='#index-Aleph' class='copiable-anchor'> ¶</a></span></dt> +<dd><span id="index-Omega"></span> <span id="index-Unicode"></span> -<p>This adds Unicode support, right-to-left typesetting, and more. Omega -was the original program. Aleph is an updated version with a variety -of bug fixes, and includes e-TeX. Aleph is not actively maintained. -More info: <a href="https://ctan.org/pkg/aleph">https://ctan.org/pkg/aleph</a>, <a href="https://ctan.org/pkg/omega">https://ctan.org/pkg/omega</a>. +<p>This adds Unicode support, right-to-left typesetting, and more, based +on the Omega engine, with the e-TeX and other extensions. Aleph is +maintained only for serious bug fixes and does not include the common +functionality mentioned above. More info: +<a href="https://ctan.org/pkg/aleph">https://ctan.org/pkg/aleph</a>, <a href="https://ctan.org/pkg/omega">https://ctan.org/pkg/omega</a>. </p> </dd> -<dt>pdfTeX</dt> -<dd><span id="index-pdfTeX"></span> -<span id="index-PDF"></span> +<dt id='index-pdfTeX'><span>pdfTeX<a href='#index-pdfTeX' class='copiable-anchor'> ¶</a></span></dt> +<dd><span id="index-PDF"></span> <span id="index-micro_002dtypography"></span> <span id="index-hypertext"></span> <span id="index-etex-is-pdfTeX"></span> @@ -2466,9 +2467,8 @@ these additions available with DVI output. Home page: <a href="http://pdftex.org">http://pdftex.org</a>. </p> </dd> -<dt>LuaTeX</dt> -<dd><span id="index-LuaTeX"></span> -<span id="index-Lua"></span> +<dt id='index-LuaTeX'><span>LuaTeX<a href='#index-LuaTeX' class='copiable-anchor'> ¶</a></span></dt> +<dd><span id="index-Lua"></span> <span id="index-UTF_002d8-input_002c-native"></span> <span id="index-OpenType-support"></span> <span id="index-TrueType-support"></span> @@ -2480,29 +2480,33 @@ input, the OpenType and TrueType font formats, and use of system fonts. Home page: <a href="http://luatex.org">http://luatex.org</a>. </p> </dd> -<dt>XeTeX</dt> -<dd><span id="index-XeTeX"></span> -<span id="index-Unicode-input_002c-native"></span> +<dt id='index-XeTeX'><span>XeTeX<a href='#index-XeTeX' class='copiable-anchor'> ¶</a></span></dt> +<dd><span id="index-Unicode-input_002c-native"></span> <p>Combines support for Unicode input, the OpenType and TrueType font formats, and use of system fonts with the capabilities of pdfTeX, with the exception of the font expansion part of micro-typography. Home page: <a href="https://tug.org/xetex">https://tug.org/xetex</a>. </p> </dd> -<dt>pTeX</dt> -<dt>upTeX</dt> -<dd><span id="index-pTeX"></span> -<span id="index-upTeX"></span> +<dt id='index-hiTeX'><span>hiTeX<a href='#index-hiTeX' class='copiable-anchor'> ¶</a></span></dt> +<dd><span id="index-HINT-_0028Hint-Is-Not-TeX_0029"></span> +<p>Outputs its own HINT format, which is designed for reading +technical documents on mobile devices. More info: +<a href="https://ctan.org/pkg/hitex">https://ctan.org/pkg/hitex</a>. +</p> +</dd> +<dt id='index-pTeX'><span>pTeX<a href='#index-pTeX' class='copiable-anchor'> ¶</a></span></dt> +<dt><span>upTeX</span></dt> +<dd><span id="index-upTeX"></span> <p>With additional support for Japanese; pTeX was the original engine, and upTeX has native Unicode support and thus is more useful for Chinese and Korean. More info: <a href="https://ctan.org/pkg/ptex">https://ctan.org/pkg/ptex</a>, <a href="https://ctan.org/pkg/uptex">https://ctan.org/pkg/uptex</a>. </p> </dd> -<dt>epTeX</dt> -<dt>eupTeX</dt> -<dd><span id="index-epTeX"></span> -<span id="index-eupTeX"></span> +<dt id='index-epTeX'><span>epTeX<a href='#index-epTeX' class='copiable-anchor'> ¶</a></span></dt> +<dt><span>eupTeX</span></dt> +<dd><span id="index-eupTeX"></span> <p>Further extends pTeX and upTeX with the e-TeX extensions. More info: <a href="https://ctan.org/pkg/eptex">https://ctan.org/pkg/eptex</a>, <a href="https://ctan.org/pkg/euptex">https://ctan.org/pkg/euptex</a>. @@ -2512,9 +2516,12 @@ More info: <a href="https://ctan.org/pkg/eptex">https://ctan.org/pkg/eptex</a>, <hr> -<span id="Metafont"></span><div class="header"> +</div> +</div> +<div class="chapter" id="Metafont"> +<div class="header"> <p> -Next: <a href="#MetaPost" accesskey="n" rel="next">MetaPost</a>, Previous: <a href="#TeX" accesskey="p" rel="prev">TeX</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="#MetaPost" accesskey="n" rel="next">MetaPost: Generating PostScript</a>, Previous: <a href="#TeX" accesskey="p" rel="prev">TeX: Typesetting</a>, Up: <a href="#Top" accesskey="u" rel="up">Web2c</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="Metafont_003a-Creating-typeface-families"></span><h2 class="chapter">6 Metafont: Creating typeface families</h2> @@ -2538,26 +2545,21 @@ your design intentions specific and parameterizable). For a complete description of the Metafont language, see <cite>The METAFONTbook</cite> (see <a href="#References">References</a>). </p> -<table class="menu" border="0" cellspacing="0"> -<tr><td align="left" valign="top">• <a href="#mf-invocation" accesskey="1">mf invocation</a></td><td> </td><td align="left" valign="top">Invoking Metafont. -</td></tr> -<tr><td align="left" valign="top">• <a href="#Initial-Metafont" accesskey="2">Initial Metafont</a></td><td> </td><td align="left" valign="top">Making bases. -</td></tr> -<tr><td align="left" valign="top">• <a href="#Modes" accesskey="3">Modes</a></td><td> </td><td align="left" valign="top">Device definitions for Metafont. -</td></tr> -<tr><td align="left" valign="top">• <a href="#Online-Metafont-graphics" accesskey="4">Online Metafont graphics</a></td><td> </td><td align="left" valign="top">Seeing MF output online. -</td></tr> -<tr><td align="left" valign="top">• <a href="#gftodvi-invocation" accesskey="5">gftodvi invocation</a></td><td> </td><td align="left" valign="top">Making proofsheets for fonts. -</td></tr> -<tr><td align="left" valign="top">• <a href="#mft-invocation" accesskey="6">mft invocation</a></td><td> </td><td align="left" valign="top">Prettyprinting Metafont sources. -</td></tr> -</table> +<ul class="section-toc"> +<li><a href="#mf-invocation" accesskey="1"><code>mf</code> invocation</a></li> +<li><a href="#Initial-Metafont" accesskey="2">Initial Metafont</a></li> +<li><a href="#Modes" accesskey="3">Modes: Device definitions for Metafont</a></li> +<li><a href="#Online-Metafont-graphics" accesskey="4">Online Metafont graphics</a></li> +<li><a href="#gftodvi-invocation" accesskey="5">GFtoDVI: Character proofs of fonts</a></li> +<li><a href="#mft-invocation" accesskey="6">MFT: Prettyprinting Metafont source</a></li> +</ul> <hr> -<span id="mf-invocation"></span><div class="header"> +<div class="section" id="mf-invocation"> +<div class="header"> <p> -Next: <a href="#Initial-Metafont" accesskey="n" rel="next">Initial Metafont</a>, Up: <a href="#Metafont" accesskey="u" rel="up">Metafont</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="#Initial-Metafont" accesskey="n" rel="next">Initial Metafont</a>, Up: <a href="#Metafont" accesskey="u" rel="up">Metafont: Creating typeface families</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="mf-invocation-1"></span><h3 class="section">6.1 <code>mf</code> invocation</h3> @@ -2572,7 +2574,7 @@ language, see <cite>The Metafontbook</cite> (see <a href="#References">Reference </p> <p>Metafont processes its command line and determines its memory dump (base) file in a way exactly analogous to MetaPost and TeX -(see <a href="#tex-invocation">tex invocation</a>, and see <a href="#Memory-dumps">Memory dumps</a>). Synopses: +(see <a href="#tex-invocation"><code>tex</code> invocation</a>, and see <a href="#Memory-dumps">Memory dumps</a>). Synopses: </p> <div class="example"> <pre class="example">mf [<var>option</var>]… [<var>mfname</var>[.mf]] [<var>mf-commands</var>] @@ -2591,13 +2593,13 @@ mf [<var>option</var>]… &<var>base</var> <var>args</var> <span id="index-EC-fonts-1"></span> <span id="index-mktexmf_002c-disabling"></span> <p>Metafont searches the usual places for the main input file <var>mfname</var> -(see <a href="https://tug.org/texinfohtml/kpathsea.html#Supported-file-formats">Supported file formats</a> in <cite>Kpathsea</cite>), extending +(see <a data-manual="kpathsea" href="https://tug.org/texinfohtml/kpathsea.html#Supported-file-formats">Supported file formats</a> in <cite>Kpathsea</cite>), extending <var>mfname</var> with <samp>.mf</samp> if necessary. To see all the relevant paths, set the environment variable <code>KPATHSEA_DEBUG</code> to ‘<samp>-1</samp>’ before running the program. By default, Metafont runs an external program named <samp>mktexmf</samp> to create any nonexistent Metafont source files you input. You can disable this at configure-time or runtime -(see <a href="https://tug.org/texinfohtml/kpathsea.html#mktex-configuration">mktex configuration</a> in <cite>Kpathsea</cite>). This is mostly +(see <a data-manual="kpathsea" href="https://tug.org/texinfohtml/kpathsea.html#mktex-configuration">mktex configuration</a> in <cite>Kpathsea</cite>). This is mostly for the sake of the EC fonts, which can be generated at any size. </p> <span id="index-_002ennngf-generic-fonts"></span> @@ -2610,7 +2612,7 @@ for the sake of the EC fonts, which can be generated at any size. resolution in pixels per inch, and <var>basemfname</var> is the basename of <var>mfname</var>, or ‘<samp>mfput</samp>’ if no input file was specified. A GF file contains bitmaps of the actual character shapes. Usually GF files are -converted immediately to PK files with GFtoPK (see <a href="#gftopk-invocation">gftopk invocation</a>), since PK files contain equivalent information, but are +converted immediately to PK files with GFtoPK (see <a href="#gftopk-invocation">GFtoPK: Generic to packed font conversion</a>), since PK files contain equivalent information, but are more compact. (Metafont output in GF format rather than PK for only historical reasons.) </p> @@ -2626,7 +2628,7 @@ kerns, and ligatures, and spacing parameters. TeX reads only this <span id="index-2602gf"></span> <span id="index-_002e2602gf"></span> <p>The <var>mode</var> in the example command above is a name referring to a -device definition (see <a href="#Modes">Modes</a>); for example, <code>localfont</code> or +device definition (see <a href="#Modes">Modes: Device definitions for Metafont</a>); for example, <code>localfont</code> or <code>ljfour</code>. These device definitions must generally be precompiled into the base file. If you leave this out, the default is <code>proof</code> mode, as stated in <cite>The Metafontbook</cite>, in which Metafont outputs at @@ -2651,27 +2653,26 @@ usual. For example: <p>The program accepts the following options, as well as the standard ‘<samp>-help</samp>’ and ‘<samp>-version</samp>’ (see <a href="#Common-options">Common options</a>): </p><dl compact="compact"> -<dt>‘<samp>-[no]-file-line-error</samp>’</dt> -<dt>‘<samp>-fmt=<var>fmtname</var></samp>’</dt> -<dt>‘<samp>-halt-on-error</samp>’</dt> -<dt>‘<samp>-ini</samp>’</dt> -<dt>‘<samp>-interaction=<var>string</var></samp>’</dt> -<dt>‘<samp>-jobname=<var>string</var></samp>’</dt> -<dt>‘<samp>-kpathsea-debug=<var>number</var></samp>’</dt> -<dt>‘<samp>-[no]parse-first-line</samp>’</dt> -<dt>‘<samp>-output-directory</samp>’</dt> -<dt>‘<samp>-progname=<var>string</var></samp>’</dt> -<dt>‘<samp>-recorder</samp>’</dt> -<dt>‘<samp>-translate-file=<var>tcxfile</var></samp>’</dt> -<dt>‘<samp>-8bit</samp>’</dt> +<dt><span>‘<samp>-[no]-file-line-error</samp>’</span></dt> +<dt><span>‘<samp>-fmt=<var>fmtname</var></samp>’</span></dt> +<dt><span>‘<samp>-halt-on-error</samp>’</span></dt> +<dt><span>‘<samp>-ini</samp>’</span></dt> +<dt><span>‘<samp>-interaction=<var>string</var></samp>’</span></dt> +<dt><span>‘<samp>-jobname=<var>string</var></samp>’</span></dt> +<dt><span>‘<samp>-kpathsea-debug=<var>number</var></samp>’</span></dt> +<dt><span>‘<samp>-[no]parse-first-line</samp>’</span></dt> +<dt><span>‘<samp>-output-directory</samp>’</span></dt> +<dt><span>‘<samp>-progname=<var>string</var></samp>’</span></dt> +<dt><span>‘<samp>-recorder</samp>’</span></dt> +<dt><span>‘<samp>-translate-file=<var>tcxfile</var></samp>’</span></dt> +<dt><span>‘<samp>-8bit</samp>’</span></dt> <dd><p>These options are common to TeX, Metafont, and MetaPost. See <a href="#Common-options">Common options</a>. </p> </dd> -<dt>‘<samp>-mktex=<var>filetype</var></samp>’</dt> -<dt>‘<samp>-no-mktex=<var>filetype</var></samp>’</dt> -<dd><span id="index-_002dmktex_003dfiletype-1"></span> -<span id="index-_002dno_002dmktex_003dfiletype-1"></span> +<dt id='index-_002dmktex_003dfiletype-1'><span>‘<samp>-mktex=<var>filetype</var></samp>’<a href='#index-_002dmktex_003dfiletype-1' class='copiable-anchor'> ¶</a></span></dt> +<dt><span>‘<samp>-no-mktex=<var>filetype</var></samp>’</span></dt> +<dd><span id="index-_002dno_002dmktex_003dfiletype-1"></span> <p>Turn on or off the ‘<samp>mktex</samp>’ script associated with <var>filetype</var>. The only value that makes sense for <var>filetype</var> is ‘<samp>mf</samp>’. </p></dd> @@ -2679,9 +2680,11 @@ The only value that makes sense for <var>filetype</var> is ‘<samp>mf</samp <hr> -<span id="Initial-Metafont"></span><div class="header"> +</div> +<div class="section" id="Initial-Metafont"> +<div class="header"> <p> -Next: <a href="#Modes" accesskey="n" rel="next">Modes</a>, Previous: <a href="#mf-invocation" accesskey="p" rel="prev">mf invocation</a>, Up: <a href="#Metafont" accesskey="u" rel="up">Metafont</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="#Modes" accesskey="n" rel="next">Modes: Device definitions for Metafont</a>, Previous: <a href="#mf-invocation" accesskey="p" rel="prev"><code>mf</code> invocation</a>, Up: <a href="#Metafont" accesskey="u" rel="up">Metafont: Creating typeface families</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="Initial-Metafont-1"></span><h3 class="section">6.2 Initial Metafont</h3> @@ -2695,7 +2698,7 @@ initializations avoided by the “virgin” (<code>vir</code>) form, so be capable of dumping ‘<samp>.base</samp>’ files (see <a href="#Memory-dumps">Memory dumps</a>). For a detailed comparison of virgin and initial forms, see <a href="#Initial-and-virgin">Initial and virgin</a>. </p> -<p>For a list of options and other information, see <a href="#mf-invocation">mf invocation</a>. +<p>For a list of options and other information, see <a href="#mf-invocation"><code>mf</code> invocation</a>. </p> <span id="index-plain_002ebase"></span> <span id="index-mf_002ebase"></span> @@ -2711,7 +2714,7 @@ Then install the resulting <samp>plain.base</samp> in ‘<samp>$(basedir)</s <samp>mf.base</samp> to it. </p> <p>For an explanation of the additional <samp>modes.mf</samp> file, -see <a href="#Modes">Modes</a>. This file has no counterpart in TeX or MetaPost. +see <a href="#Modes">Modes: Device definitions for Metafont</a>. This file has no counterpart in TeX or MetaPost. </p> <span id="index-cmmf_002ebase-not-recommended"></span> <span id="index-cm_002ebase"></span> @@ -2730,9 +2733,11 @@ create their own base file, of course. </p> <hr> -<span id="Modes"></span><div class="header"> +</div> +<div class="section" id="Modes"> +<div class="header"> <p> -Next: <a href="#Online-Metafont-graphics" accesskey="n" rel="next">Online Metafont graphics</a>, Previous: <a href="#Initial-Metafont" accesskey="p" rel="prev">Initial Metafont</a>, Up: <a href="#Metafont" accesskey="u" rel="up">Metafont</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="#Online-Metafont-graphics" accesskey="n" rel="next">Online Metafont graphics</a>, Previous: <a href="#Initial-Metafont" accesskey="p" rel="prev">Initial Metafont</a>, Up: <a href="#Metafont" accesskey="u" rel="up">Metafont: Creating typeface families</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="Modes_003a-Device-definitions-for-Metafont"></span><h3 class="section">6.3 Modes: Device definitions for Metafont</h3> @@ -2779,7 +2784,7 @@ characteristics dynamically, by invoking Metafont with an assignment to mode. </p> <p>The <var>magnification</var> and <var>mfname</var> arguments are explained in -<a href="#mf-invocation">mf invocation</a>. In the file <samp>newmode.mf</samp>, you should have the +<a href="#mf-invocation"><code>mf</code> invocation</a>. In the file <samp>newmode.mf</samp>, you should have the following (with no <code>mode_def</code> or <code>enddef</code>), if you are using <samp>modes.mf</samp> conventions: </p><div class="example"> @@ -2797,9 +2802,11 @@ and <var>o</var>.) </p> <hr> -<span id="Online-Metafont-graphics"></span><div class="header"> +</div> +<div class="section" id="Online-Metafont-graphics"> +<div class="header"> <p> -Next: <a href="#gftodvi-invocation" accesskey="n" rel="next">gftodvi invocation</a>, Previous: <a href="#Modes" accesskey="p" rel="prev">Modes</a>, Up: <a href="#Metafont" accesskey="u" rel="up">Metafont</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="#gftodvi-invocation" accesskey="n" rel="next">GFtoDVI: Character proofs of fonts</a>, Previous: <a href="#Modes" accesskey="p" rel="prev">Modes: Device definitions for Metafont</a>, Up: <a href="#Metafont" accesskey="u" rel="up">Metafont: Creating typeface families</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="Online-Metafont-graphics-1"></span><h3 class="section">6.4 Online Metafont graphics</h3> @@ -2823,9 +2830,7 @@ be selected. and the corresponding <code>configure</code> option(s) in parentheses. </p> <dl compact="compact"> -<dt><code>epsf</code> -<span id="index-epsf"></span> -</dt> +<dt id='index-epsf'><span><code>epsf</code><a href='#index-epsf' class='copiable-anchor'> ¶</a></span></dt> <dd><span id="index-Herberts_002c-Mathias"></span> <span id="index-_002d_002denable_002depsfwin"></span> <p>(‘<samp>--enable-epsfwin</samp>’) Pseudo-window server for Encapsulated @@ -2836,24 +2841,18 @@ can be changed by setting the MFEPSF environment variable to the new filename. Contributed by Mathias Herberts. </p> </dd> -<dt><code>hp2627</code> -<span id="index-hp2627"></span> -</dt> +<dt id='index-hp2627'><span><code>hp2627</code><a href='#index-hp2627' class='copiable-anchor'> ¶</a></span></dt> <dd><span id="index-_002d_002denable_002dhp2627win"></span> <p>(‘<samp>--enable-hp2627win</samp>’) HP2627a color graphics terminals. </p> </dd> -<dt><code>mftalk</code> -<span id="index-mftalk"></span> -</dt> +<dt id='index-mftalk'><span><code>mftalk</code><a href='#index-mftalk' class='copiable-anchor'> ¶</a></span></dt> <dd><span id="index-_002d_002denable_002dmftalkwin"></span> <p>(‘<samp>--enable-mftalkwin</samp>’) Generic window server (see <samp>web2c/window/mftalk.c</samp>). </p> </dd> -<dt><code>next</code> -<span id="index-next"></span> -</dt> +<dt id='index-next'><span><code>next</code><a href='#index-next' class='copiable-anchor'> ¶</a></span></dt> <dd><span id="index-DrawingServant"></span> <span id="index-_002d_002denable_002dnext"></span> <p>(‘<samp>--enable-next</samp>’) NeXT window system. This requires a separate @@ -2861,17 +2860,13 @@ program, called <code>DrawingServant</code>, available separately. See the <samp>web2c/window/next.c</samp>. </p> </dd> -<dt><code>regis</code> -<span id="index-regis"></span> -</dt> +<dt id='index-regis'><span><code>regis</code><a href='#index-regis' class='copiable-anchor'> ¶</a></span></dt> <dd><span id="index-_002d_002denable_002dregiswin"></span> <span id="index-Regis-graphics-support"></span> <p>(‘<samp>--enable-regiswin</samp>’) Regis terminals. </p> </dd> -<dt><code>sun</code> -<span id="index-sun"></span> -</dt> +<dt id='index-sun'><span><code>sun</code><a href='#index-sun' class='copiable-anchor'> ¶</a></span></dt> <dd><span id="index-SunView"></span> <span id="index-Suntools"></span> <span id="index-_002d_002denable_002dsuntoolswin"></span> @@ -2881,18 +2876,14 @@ window system. (You can get the even older SunWindows <code>gfx</code> system by using <samp>sun-gfx.c</samp>.) </p> </dd> -<dt><code>tek</code> -<span id="index-tek"></span> -</dt> +<dt id='index-tek'><span><code>tek</code><a href='#index-tek' class='copiable-anchor'> ¶</a></span></dt> <dd><span id="index-Tektronix"></span> <span id="index-_002d_002denable_002dtektronixwin"></span> <p>(‘<samp>--enable-tektronixwin</samp>’) Tektronix terminals. </p> <span id="index-Poole_002c-Simon"></span> </dd> -<dt><code>uniterm</code> -<span id="index-uniterm"></span> -</dt> +<dt id='index-uniterm'><span><code>uniterm</code><a href='#index-uniterm' class='copiable-anchor'> ¶</a></span></dt> <dd><span id="index-Tektronix-4014"></span> <span id="index-_002d_002denable_002dunitermwin"></span> <p>(‘<samp>--enable-unitermwin</samp>’) Uniterm, Simon Poole’s emulator of a smart @@ -2903,9 +2894,7 @@ as well; it’s faster than the driver ‘<samp>--enable-tektronixwin</s <span id="index-Xt"></span> <span id="index-Xlib"></span> </dd> -<dt><code>xterm</code> -<span id="index-xterm"></span> -</dt> +<dt id='index-xterm'><span><code>xterm</code><a href='#index-xterm' class='copiable-anchor'> ¶</a></span></dt> <dd><span id="index-_002d_002dwith_002dx"></span> <p>‘<samp>--with-x</samp>’ The X window system (version 11). </p> @@ -2959,9 +2948,11 @@ use MFtalk (see <samp>web2c/window/mftalk.c</samp>). </p> <hr> -<span id="gftodvi-invocation"></span><div class="header"> +</div> +<div class="section" id="gftodvi-invocation"> +<div class="header"> <p> -Next: <a href="#mft-invocation" accesskey="n" rel="next">mft invocation</a>, Previous: <a href="#Online-Metafont-graphics" accesskey="p" rel="prev">Online Metafont graphics</a>, Up: <a href="#Metafont" accesskey="u" rel="up">Metafont</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="#mft-invocation" accesskey="n" rel="next">MFT: Prettyprinting Metafont source</a>, Previous: <a href="#Online-Metafont-graphics" accesskey="p" rel="prev">Online Metafont graphics</a>, Up: <a href="#Metafont" accesskey="u" rel="up">Metafont: Creating typeface families</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="GFtoDVI_003a-Character-proofs-of-fonts"></span><h3 class="section">6.5 GFtoDVI: Character proofs of fonts</h3> @@ -2971,14 +2962,14 @@ Next: <a href="#mft-invocation" accesskey="n" rel="next">mft invocation</a>, Pre <span id="index-proof-sheets_002c-of-fonts"></span> <p>GFtoDVI makes <em>proof sheets</em> from a GF bitmap file as output by, for -example, Metafont (see <a href="#Metafont">Metafont</a>). This is an indispensable aid for +example, Metafont (see <a href="#Metafont">Metafont: Creating typeface families</a>). This is an indispensable aid for font designers or Metafont hackers. Synopsis: </p> <div class="example"> <pre class="example">gftodvi [<var>option</var>]… <var>gfname</var>[gf] </pre></div> -<p>The font <var>gfname</var> is searched for in the usual places (see <a href="https://tug.org/texinfohtml/kpathsea.html#Glyph-lookup">Glyph +<p>The font <var>gfname</var> is searched for in the usual places (see <a data-manual="kpathsea" href="https://tug.org/texinfohtml/kpathsea.html#Glyph-lookup">Glyph lookup</a> in <cite>Kpathsea</cite>). To see all the relevant paths, set the environment variable <code>KPATHSEA_DEBUG</code> to ‘<samp>-1</samp>’ before running the program. @@ -3033,9 +3024,8 @@ should produce <samp>rtest.dvi</samp>, which you process as usual. ‘<samp>-verbose</samp>’, ‘<samp>-help</samp>’, and ‘<samp>-version</samp>’ (see <a href="#Common-options">Common options</a>): </p> <dl compact="compact"> -<dt>‘<samp>-overflow-label-offset=<var>points</var></samp>’</dt> -<dd><span id="index-_002doverflow_002dlabel_002doffset_003dpoints"></span> -<span id="index-overflow-label-offset"></span> +<dt id='index-_002doverflow_002dlabel_002doffset_003dpoints'><span>‘<samp>-overflow-label-offset=<var>points</var></samp>’<a href='#index-_002doverflow_002dlabel_002doffset_003dpoints' class='copiable-anchor'> ¶</a></span></dt> +<dd><span id="index-overflow-label-offset"></span> <span id="index-offset-for-overflow-labels"></span> <p>Typeset the so-called overflow labels, if any, <var>points</var> TeX points from the right edge of the character bounding box. The default @@ -3047,9 +3037,11 @@ position is too crowded with other information. <hr> -<span id="mft-invocation"></span><div class="header"> +</div> +<div class="section" id="mft-invocation"> +<div class="header"> <p> -Previous: <a href="#gftodvi-invocation" accesskey="p" rel="prev">gftodvi invocation</a>, Up: <a href="#Metafont" accesskey="u" rel="up">Metafont</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="#gftodvi-invocation" accesskey="p" rel="prev">GFtoDVI: Character proofs of fonts</a>, Up: <a href="#Metafont" accesskey="u" rel="up">Metafont: Creating typeface families</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="MFT_003a-Prettyprinting-Metafont-source"></span><h3 class="section">6.6 MFT: Prettyprinting Metafont source</h3> @@ -3067,7 +3059,7 @@ typesetting, with the aid of TeX macros defined in the file <pre class="example">mft [<var>option</var>]… <var>mfname</var>[.mf] </pre></div> -<p>MFT searches the usual places for <var>mfname</var> (see <a href="https://tug.org/texinfohtml/kpathsea.html#Supported-file-formats">Supported file +<p>MFT searches the usual places for <var>mfname</var> (see <a data-manual="kpathsea" href="https://tug.org/texinfohtml/kpathsea.html#Supported-file-formats">Supported file formats</a> in <cite>Kpathsea</cite>). To see all the relevant paths, set the environment variable <code>KPATHSEA_DEBUG</code> to ‘<samp>-1</samp>’ before running the program. The output goes to the basename of <var>mfname</var> extended @@ -3126,22 +3118,20 @@ D.E. Knuth<!-- /@w -->.) <p>The program accepts the following options, as well as the standard ‘<samp>-help</samp>’ and ‘<samp>-version</samp>’ (see <a href="#Common-options">Common options</a>): </p><dl compact="compact"> -<dt>‘<samp>-change=<var>chfile</var>[.ch]</samp>’</dt> -<dd><span id="index-_002dchange_003dchfile"></span> -<span id="index-change-files_002c-and-MFT"></span> +<dt id='index-_002dchange_003dchfile'><span>‘<samp>-change=<var>chfile</var>[.ch]</samp>’<a href='#index-_002dchange_003dchfile' class='copiable-anchor'> ¶</a></span></dt> +<dd><span id="index-change-files_002c-and-MFT"></span> <p>Apply the change file <var>chfile</var> as with Tangle and Weave -(see <a href="#WEB">WEB</a>). +(see <a href="#WEB">WEB: Literate programming</a>). </p> </dd> -<dt>‘<samp>-style=<var>mftfile</var>[.mft]</samp>’</dt> -<dd><span id="index-_002dstyle_003dmftfile"></span> -<span id="index-style-files"></span> +<dt id='index-_002dstyle_003dmftfile'><span>‘<samp>-style=<var>mftfile</var>[.mft]</samp>’<a href='#index-_002dstyle_003dmftfile' class='copiable-anchor'> ¶</a></span></dt> +<dd><span id="index-style-files"></span> <span id="index-plain_002emft"></span> <p>Read <var>mftfile</var> before anything else; a MFT style file typically contains only MFT directives as described above. The default style file is named <samp>plain.mft</samp>, which defines this properly for programs using plain Metafont. The MFT files is searched along the -<code>MFTINPUTS</code> path; see <a href="https://tug.org/texinfohtml/kpathsea.html#Supported-file-formats">Supported file formats</a> in <cite>Kpathsea</cite>. +<code>MFTINPUTS</code> path; see <a data-manual="kpathsea" href="https://tug.org/texinfohtml/kpathsea.html#Supported-file-formats">Supported file formats</a> in <cite>Kpathsea</cite>. </p> <span id="index-cmbase_002emft"></span> <span id="index-e_002emft"></span> @@ -3164,9 +3154,12 @@ configure TeX to print these properly. </p> <hr> -<span id="MetaPost"></span><div class="header"> +</div> +</div> +<div class="chapter" id="MetaPost"> +<div class="header"> <p> -Next: <a href="#BibTeX" accesskey="n" rel="next">BibTeX</a>, Previous: <a href="#Metafont" accesskey="p" rel="prev">Metafont</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="#BibTeX" accesskey="n" rel="next">BibTeX: Bibliographies</a>, Previous: <a href="#Metafont" accesskey="p" rel="prev">Metafont: Creating typeface families</a>, Up: <a href="#Top" accesskey="u" rel="up">Web2c</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="MetaPost_003a-Generating-PostScript"></span><h2 class="chapter">7 MetaPost: Generating PostScript</h2> @@ -3175,7 +3168,7 @@ Next: <a href="#BibTeX" accesskey="n" rel="next">BibTeX</a>, Previous: <a href=" <span id="index-Metafont-meets-PostScript"></span> <span id="index-technical-illustrations_002c-creating"></span> <p>MetaPost is a picture-drawing language similar to Metafont -(see <a href="#Metafont">Metafont</a>), but instead of outputting bitmaps in a “font”, it +(see <a href="#Metafont">Metafont: Creating typeface families</a>), but instead of outputting bitmaps in a “font”, it outputs PostScript commands. It’s primarily intended for creating technical illustrations, but can also be used to create PostScript or OpenType fonts (<a href="https://ctan.org/pkg/metatype1">https://ctan.org/pkg/metatype1</a>). @@ -3185,20 +3178,18 @@ OpenType fonts (<a href="https://ctan.org/pkg/metatype1">https://ctan.org/pkg/me a natural way, using any typesetter (TeX and Troff are both supported) and a number of other subsidiary programs, described below. </p> -<table class="menu" border="0" cellspacing="0"> -<tr><td align="left" valign="top">• <a href="#mpost-invocation" accesskey="1">mpost invocation</a></td><td> </td><td align="left" valign="top">Invoking MetaPost. -</td></tr> -<tr><td align="left" valign="top">• <a href="#Initial-MetaPost" accesskey="2">Initial MetaPost</a></td><td> </td><td align="left" valign="top">Making mems. -</td></tr> -<tr><td align="left" valign="top">• <a href="#dvitomp-invocation" accesskey="3">dvitomp invocation</a></td><td> </td><td align="left" valign="top">DVI-to-MPX translation. -</td></tr> -</table> +<ul class="section-toc"> +<li><a href="#mpost-invocation" accesskey="1"><code>mpost</code> invocation</a></li> +<li><a href="#Initial-MetaPost" accesskey="2">Initial MetaPost</a></li> +<li><a href="#dvitomp-invocation" accesskey="3">DVItoMP: DVI to MPX conversion</a></li> +</ul> <hr> -<span id="mpost-invocation"></span><div class="header"> +<div class="section" id="mpost-invocation"> +<div class="header"> <p> -Next: <a href="#Initial-MetaPost" accesskey="n" rel="next">Initial MetaPost</a>, Up: <a href="#MetaPost" accesskey="u" rel="up">MetaPost</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="#Initial-MetaPost" accesskey="n" rel="next">Initial MetaPost</a>, Up: <a href="#MetaPost" accesskey="u" rel="up">MetaPost: Generating 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="mpost-invocation-1"></span><h3 class="section">7.1 <code>mpost</code> invocation</h3> @@ -3233,7 +3224,7 @@ mpost [<var>option</var>]… &<var>mem</var> <var>args</var> <span id="index-_002emp"></span> <span id="index-MetaPost-input-files"></span> <p>MetaPost searches the usual places for the main input file <var>mpname</var> -(see <a href="https://tug.org/texinfohtml/kpathsea.html#Supported-file-formats">Supported file formats</a> in <cite>Kpathsea</cite>), extending +(see <a data-manual="kpathsea" href="https://tug.org/texinfohtml/kpathsea.html#Supported-file-formats">Supported file formats</a> in <cite>Kpathsea</cite>), extending <var>mpname</var> with <samp>.mp</samp> if necessary. To see all the relevant paths, set the environment variable <code>KPATHSEA_DEBUG</code> to ‘<samp>-1</samp>’ before running the program. @@ -3258,7 +3249,7 @@ with any other PostScript figures. For example, with this TeX command: </p><div class="example"> <pre class="example">\special{psfile="<var>filename</var>"} </pre></div> -<p>or by using <samp>epsf.tex</samp> (see <a href="https://tug.org/texinfohtml/dvips.html#EPSF-macros">EPSF macros</a> in <cite>Dvips</cite>). +<p>or by using <samp>epsf.tex</samp> (see <a data-manual="dvips" href="https://tug.org/texinfohtml/dvips.html#EPSF-macros">EPSF macros</a> in <cite>Dvips</cite>). </p> <span id="index-btex-for-MetaPost-labels"></span> <span id="index-etex-for-MetaPost-labels"></span> @@ -3278,7 +3269,7 @@ TeX. For example, if you are using LaTeX, your MetaPost input file must start with a <code>verbatimtex</code> block that gives the necessary <code>\documentclass</code> (or <code>\documentstyle</code>) <code>\begin{document}</code> command. You will also need to set the -enviroment variable <code>TEX</code> to ‘<samp>latex</samp>’. +environment variable <code>TEX</code> to ‘<samp>latex</samp>’. </p> <p><var>tex-input</var> need not be specifically TeX input; it could also be Troff. In that case, you will need the ‘<samp>-m pictures</samp>’ Troff macro @@ -3300,7 +3291,7 @@ Metafont fonts; you can also use PostScript fonts with TeX, of course. <p>MetaPost-generated PostScript figures which do use Computer Modern fonts for labels cannot be directly previewed or printed. Instead, you must include them in a TeX document and run the resulting DVI file through -Dvips to arrange for the downloading of the required fonts (see <a href="https://tug.org/texinfohtml/dvips.html#Fonts-in-figures">Fonts +Dvips to arrange for the downloading of the required fonts (see <a data-manual="dvips" href="https://tug.org/texinfohtml/dvips.html#Fonts-in-figures">Fonts in figures</a> in <cite>Dvips</cite>). To help with this, the MetaPost distribution provides a small TeX file <samp>mproof.tex</samp> which is typically called as: @@ -3315,11 +3306,11 @@ typically called as: <code>prologues</code> positive. To make the output files self-contained, use only standard PostScript fonts. MetaPost reads the same <samp>psfonts.map</samp> file as Dvips, to determine PostScript fonts that -need to be downloaded (see <a href="https://tug.org/texinfohtml/dvips.html#psfonts_002emap">psfonts.map</a> in <cite>Dvips</cite>). +need to be downloaded (see <a data-manual="dvips" href="https://tug.org/texinfohtml/dvips.html#psfonts_002emap">psfonts.map</a> in <cite>Dvips</cite>). </p> <span id="index-PDF_002c-and-_002emps-files"></span> <span id="index-_002emps-files-and-PDF"></span> -<p>It is posible for pdfTeX to read MetaPost output directly; this is +<p>It is possible for pdfTeX to read MetaPost output directly; this is in contrast to general EPSF files, which have to be converted for use with PDF output. The easiest way is to name the MetaPost output files with the <code>.mps</code> extension. Then the LaTeX @@ -3328,39 +3319,37 @@ them, even when outputting PDF. </p> <span id="index-security_002c-and-write"></span> <p>MetaPost can write output files, via the <code>write</code> primitive; this -opens a security hole. See <a href="#tex-invocation">tex invocation</a>. +opens a security hole. See <a href="#tex-invocation"><code>tex</code> invocation</a>. </p> <p>The program accepts the following options, as well as the standard ‘<samp>-help</samp>’ and ‘<samp>-version</samp>’ (see <a href="#Common-options">Common options</a>): </p><dl compact="compact"> -<dt>‘<samp>-[no]-file-line-error</samp>’</dt> -<dt>‘<samp>-fmt=<var>fmtname</var></samp>’</dt> -<dt>‘<samp>-halt-on-error</samp>’</dt> -<dt>‘<samp>-ini</samp>’</dt> -<dt>‘<samp>-interaction=<var>string</var></samp>’</dt> -<dt>‘<samp>-jobname=<var>string</var></samp>’</dt> -<dt>‘<samp>-kpathsea-debug=<var>number</var></samp>’</dt> -<dt>‘<samp>-[no]parse-first-line</samp>’</dt> -<dt>‘<samp>-output-directory</samp>’</dt> -<dt>‘<samp>-progname=<var>string</var></samp>’</dt> -<dt>‘<samp>-recorder</samp>’</dt> -<dt>‘<samp>-translate-file=<var>tcxfile</var></samp>’</dt> -<dt>‘<samp>-8bit</samp>’</dt> +<dt><span>‘<samp>-[no]-file-line-error</samp>’</span></dt> +<dt><span>‘<samp>-fmt=<var>fmtname</var></samp>’</span></dt> +<dt><span>‘<samp>-halt-on-error</samp>’</span></dt> +<dt><span>‘<samp>-ini</samp>’</span></dt> +<dt><span>‘<samp>-interaction=<var>string</var></samp>’</span></dt> +<dt><span>‘<samp>-jobname=<var>string</var></samp>’</span></dt> +<dt><span>‘<samp>-kpathsea-debug=<var>number</var></samp>’</span></dt> +<dt><span>‘<samp>-[no]parse-first-line</samp>’</span></dt> +<dt><span>‘<samp>-output-directory</samp>’</span></dt> +<dt><span>‘<samp>-progname=<var>string</var></samp>’</span></dt> +<dt><span>‘<samp>-recorder</samp>’</span></dt> +<dt><span>‘<samp>-translate-file=<var>tcxfile</var></samp>’</span></dt> +<dt><span>‘<samp>-8bit</samp>’</span></dt> <dd><p>These options are common to TeX, Metafont, and MetaPost. See <a href="#Common-options">Common options</a>. </p> </dd> -<dt>‘<samp>-T</samp>’</dt> -<dt>‘<samp>-troff</samp>’</dt> -<dd><span id="index-_002dT"></span> -<span id="index-_002dtroff"></span> +<dt id='index-_002dT'><span>‘<samp>-T</samp>’<a href='#index-_002dT' class='copiable-anchor'> ¶</a></span></dt> +<dt><span>‘<samp>-troff</samp>’</span></dt> +<dd><span id="index-_002dtroff"></span> <span id="index-prologues"></span> <p>Set the <code>prologues</code> internal variable to <code>1</code>. </p> </dd> -<dt>‘<samp>-tex=<var>texprogram</var></samp>’</dt> -<dd><span id="index-_002dtex_003dtexprogram"></span> -<p>When this option is given, the program <var>texprogram</var> is used to +<dt id='index-_002dtex_003dtexprogram'><span>‘<samp>-tex=<var>texprogram</var></samp>’<a href='#index-_002dtex_003dtexprogram' class='copiable-anchor'> ¶</a></span></dt> +<dd><p>When this option is given, the program <var>texprogram</var> is used to typeset the labels. </p> </dd> @@ -3368,9 +3357,11 @@ typeset the labels. <hr> -<span id="Initial-MetaPost"></span><div class="header"> +</div> +<div class="section" id="Initial-MetaPost"> +<div class="header"> <p> -Next: <a href="#dvitomp-invocation" accesskey="n" rel="next">dvitomp invocation</a>, Previous: <a href="#mpost-invocation" accesskey="p" rel="prev">mpost invocation</a>, Up: <a href="#MetaPost" accesskey="u" rel="up">MetaPost</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="#dvitomp-invocation" accesskey="n" rel="next">DVItoMP: DVI to MPX conversion</a>, Previous: <a href="#mpost-invocation" accesskey="p" rel="prev"><code>mpost</code> invocation</a>, Up: <a href="#MetaPost" accesskey="u" rel="up">MetaPost: Generating 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="Initial-MetaPost-1"></span><h3 class="section">7.2 Initial MetaPost</h3> @@ -3383,7 +3374,7 @@ virgin and initial forms (see <a href="#Initial-and-virgin">Initial and virgin</ “initial” file name is read in its source form—that is, <samp>mpost.mp</samp> when the program is invoked as <code>mpost</code>. </p> -<p>For a list of options and other information, see <a href="#mpost-invocation">mpost invocation</a>. +<p>For a list of options and other information, see <a href="#mpost-invocation"><code>mpost</code> invocation</a>. </p> <span id="index-Metafont_002c-compatibility-in-MetaPost"></span> <span id="index-plain-Metafont_002c-compatibility-in-MetaPost"></span> @@ -3394,13 +3385,15 @@ called <samp>mfplain</samp>. You can use that in the same way; just run <code>mfplain</code> instead of <code>mpost</code>. This lets you directly process Metafont source files with MetaPost, producing character proofs (one file for each character) similar to those produced with -Metafont in proof mode and GFtoDVI (see <a href="#gftodvi-invocation">gftodvi invocation</a>). +Metafont in proof mode and GFtoDVI (see <a href="#gftodvi-invocation">GFtoDVI: Character proofs of fonts</a>). </p> <hr> -<span id="dvitomp-invocation"></span><div class="header"> +</div> +<div class="section" id="dvitomp-invocation"> +<div class="header"> <p> -Previous: <a href="#Initial-MetaPost" accesskey="p" rel="prev">Initial MetaPost</a>, Up: <a href="#MetaPost" accesskey="u" rel="up">MetaPost</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="#Initial-MetaPost" accesskey="p" rel="prev">Initial MetaPost</a>, Up: <a href="#MetaPost" accesskey="u" rel="up">MetaPost: Generating 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="DVItoMP_003a-DVI-to-MPX-conversion"></span><h3 class="section">7.3 DVItoMP: DVI to MPX conversion</h3> @@ -3428,9 +3421,12 @@ MetaPost commands. </p> <hr> -<span id="BibTeX"></span><div class="header"> +</div> +</div> +<div class="chapter" id="BibTeX"> +<div class="header"> <p> -Next: <a href="#WEB" accesskey="n" rel="next">WEB</a>, Previous: <a href="#MetaPost" accesskey="p" rel="prev">MetaPost</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="#WEB" accesskey="n" rel="next">WEB: Literate programming</a>, Previous: <a href="#MetaPost" accesskey="p" rel="prev">MetaPost: Generating PostScript</a>, Up: <a href="#Top" accesskey="u" rel="up">Web2c</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="BibTeX_003a-Bibliographies"></span><h2 class="chapter">8 BibTeX: Bibliographies</h2> @@ -3440,18 +3436,17 @@ Next: <a href="#WEB" accesskey="n" rel="next">WEB</a>, Previous: <a href="#MetaP <p>BibTeX automates much of the job of typesetting bibliographies, and makes bibliography entries reusable in many different contexts. </p> -<table class="menu" border="0" cellspacing="0"> -<tr><td align="left" valign="top">• <a href="#bibtex-invocation" accesskey="1">bibtex invocation</a></td><td> </td><td align="left" valign="top"> -</td></tr> -<tr><td align="left" valign="top">• <a href="#Basic-BibTeX-style-files" accesskey="2">Basic BibTeX style files</a></td><td> </td><td align="left" valign="top">The standard and semi-standard styles. -</td></tr> -</table> +<ul class="section-toc"> +<li><a href="#bibtex-invocation" accesskey="1">BibTeX invocation</a></li> +<li><a href="#Basic-BibTeX-style-files" accesskey="2">Basic BibTeX style files</a></li> +</ul> <hr> -<span id="bibtex-invocation"></span><div class="header"> +<div class="section" id="bibtex-invocation"> +<div class="header"> <p> -Next: <a href="#Basic-BibTeX-style-files" accesskey="n" rel="next">Basic BibTeX style files</a>, Up: <a href="#BibTeX" accesskey="u" rel="up">BibTeX</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-BibTeX-style-files" accesskey="n" rel="next">Basic BibTeX style files</a>, Up: <a href="#BibTeX" accesskey="u" rel="up">BibTeX: Bibliographies</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="BibTeX-invocation"></span><h3 class="section">8.1 BibTeX invocation</h3> @@ -3487,23 +3482,21 @@ of the <samp>.bbl</samp> file. Synopsis: <samp>.aux</samp> file as well, via the <samp>\bibliography</samp> and <samp>\bibliographystyle</samp> (La)TeX macros. BibTeX searches for <samp>.bib</samp> files using the <code>BIBINPUTS</code> and <code>TEXBIB</code> paths, -and for <samp>.bst</samp> files using <code>BSTINPUTS</code> (see <a href="https://tug.org/texinfohtml/kpathsea.html#Supported-file-formats">Supported file +and for <samp>.bst</samp> files using <code>BSTINPUTS</code> (see <a data-manual="kpathsea" href="https://tug.org/texinfohtml/kpathsea.html#Supported-file-formats">Supported file formats</a> in <cite>Kpathsea</cite>). It does no path searching for <samp>.aux</samp> files. </p> <p>The program accepts the following options, as well as the standard ‘<samp>-help</samp>’ and ‘<samp>-version</samp>’ (see <a href="#Common-options">Common options</a>): </p><dl compact="compact"> -<dt>‘<samp>-terse</samp>’</dt> -<dd><span id="index-_002dterse"></span> -<span id="index-terse-output"></span> +<dt id='index-_002dterse'><span>‘<samp>-terse</samp>’<a href='#index-_002dterse' class='copiable-anchor'> ¶</a></span></dt> +<dd><span id="index-terse-output"></span> <span id="index-verbose-BibTeX-output_002c-suppressing"></span> <p>Suppress the program banner and progress reports normally output. </p> </dd> -<dt>‘<samp>-min-crossrefs=<var>n</var></samp>’</dt> -<dd><span id="index-_002dmin_002dcrossrefs_003dn"></span> -<span id="index-cross_002dreferenced-bibliography-items"></span> +<dt id='index-_002dmin_002dcrossrefs_003dn'><span>‘<samp>-min-crossrefs=<var>n</var></samp>’<a href='#index-_002dmin_002dcrossrefs_003dn' class='copiable-anchor'> ¶</a></span></dt> +<dd><span id="index-cross_002dreferenced-bibliography-items"></span> <span id="index-bibliography-items_002c-cross_002dreferenced"></span> <p>If at least <var>n</var> (2 by default) bibliography entries refer to another entry <var>e</var> via their <code>crossref</code> field, include <var>e</var> in the @@ -3523,30 +3516,25 @@ for <var>e</var> to the <tt>.aux</tt>, and nothing will remove it. <p>See also: </p><dl compact="compact"> -<dt><samp>btxdoc.tex</samp></dt> -<dd><span id="index-btxdoc_002etex"></span> -<p>Basic LaTeXable documentation for general BibTeX users. +<dt id='index-btxdoc_002etex'><span><samp>btxdoc.tex</samp><a href='#index-btxdoc_002etex' class='copiable-anchor'> ¶</a></span></dt> +<dd><p>Basic LaTeXable documentation for general BibTeX users. </p> </dd> -<dt><samp>btxhak.tex</samp></dt> -<dd><span id="index-btxhak_002etex"></span> -<span id="index-style-design_002c-for-BibTeX"></span> +<dt id='index-btxhak_002etex'><span><samp>btxhak.tex</samp><a href='#index-btxhak_002etex' class='copiable-anchor'> ¶</a></span></dt> +<dd><span id="index-style-design_002c-for-BibTeX"></span> <p>LaTeXable documentation for style designers. </p> </dd> -<dt><samp>btxdoc.bib</samp></dt> -<dd><span id="index-btxdoc_002ebib"></span> -<p>BibTeX database file for the two above documents. +<dt id='index-btxdoc_002ebib'><span><samp>btxdoc.bib</samp><a href='#index-btxdoc_002ebib' class='copiable-anchor'> ¶</a></span></dt> +<dd><p>BibTeX database file for the two above documents. </p> </dd> -<dt><samp>xampl.bib</samp></dt> -<dd><span id="index-xampl_002ebib"></span> -<p>Example database file with all the standard entry types. +<dt id='index-xampl_002ebib'><span><samp>xampl.bib</samp><a href='#index-xampl_002ebib' class='copiable-anchor'> ¶</a></span></dt> +<dd><p>Example database file with all the standard entry types. </p> </dd> -<dt><samp><a href="ftp://ftp.math.utah.edu/pub/tex/bib/">ftp://ftp.math.utah.edu/pub/tex/bib/</a></samp></dt> -<dd><span id="index-ftp_002emath_002eutah_002eedu"></span> -<span id="index-BibTeX-collection"></span> +<dt id='index-ftp_002emath_002eutah_002eedu'><span><samp><a href="ftp://ftp.math.utah.edu/pub/tex/bib/">ftp://ftp.math.utah.edu/pub/tex/bib/</a></samp><a href='#index-ftp_002emath_002eutah_002eedu' class='copiable-anchor'> ¶</a></span></dt> +<dd><span id="index-BibTeX-collection"></span> <span id="index-TUGboat-bibliography"></span> <span id="index-TeX_002c-bibliographies-for"></span> <p>A very large <samp>.bib</samp> and <samp>.bst</samp> collection, including @@ -3557,9 +3545,11 @@ for TUGboat. <hr> -<span id="Basic-BibTeX-style-files"></span><div class="header"> +</div> +<div class="section" id="Basic-BibTeX-style-files"> +<div class="header"> <p> -Previous: <a href="#bibtex-invocation" accesskey="p" rel="prev">bibtex invocation</a>, Up: <a href="#BibTeX" accesskey="u" rel="up">BibTeX</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="#bibtex-invocation" accesskey="p" rel="prev">BibTeX invocation</a>, Up: <a href="#BibTeX" accesskey="u" rel="up">BibTeX: Bibliographies</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-BibTeX-style-files-1"></span><h3 class="section">8.2 Basic BibTeX style files</h3> @@ -3568,57 +3558,49 @@ Previous: <a href="#bibtex-invocation" accesskey="p" rel="prev">bibtex invocatio <p>Here are descriptions of the four standard and four semi-standard basic BibTeX styles. <samp><var>CTAN:</var>/biblio/bibtex</samp> contains these and -many more (for CTAN info, see <a href="https://tug.org/texinfohtml/kpathsea.html#unixtex_002eftp">unixtex.ftp</a> in <cite>Kpathsea</cite>). +many more (for CTAN info, see <a data-manual="kpathsea" href="https://tug.org/texinfohtml/kpathsea.html#unixtex_002eftp">unixtex.ftp</a> in <cite>Kpathsea</cite>). </p> <dl compact="compact"> -<dt><code>plain</code></dt> -<dd><span id="index-plain_002ebst"></span> -<p>Sorts entries alphabetically, with numeric labels. Generally formatted +<dt id='index-plain_002ebst'><span><code>plain</code><a href='#index-plain_002ebst' class='copiable-anchor'> ¶</a></span></dt> +<dd><p>Sorts entries alphabetically, with numeric labels. Generally formatted according to van Leunen’s <cite>A Handbook for Scholars</cite>. The other style files listed here are based on <code>plain</code>. </p> </dd> -<dt><code>abbrv</code></dt> -<dd><span id="index-abbrv_002ebst"></span> -<p>First names, month names, and journal names are abbreviated. +<dt id='index-abbrv_002ebst'><span><code>abbrv</code><a href='#index-abbrv_002ebst' class='copiable-anchor'> ¶</a></span></dt> +<dd><p>First names, month names, and journal names are abbreviated. </p> </dd> -<dt><code>acm</code></dt> -<dd><span id="index-acm_002ebst"></span> -<p>Names are printed in small caps. +<dt id='index-acm_002ebst'><span><code>acm</code><a href='#index-acm_002ebst' class='copiable-anchor'> ¶</a></span></dt> +<dd><p>Names are printed in small caps. </p> </dd> -<dt><code>alpha</code></dt> -<dd><span id="index-alpha_002ebst"></span> -<p>Alphanumeric labels, e.g., ‘<samp>Knu66</samp>’. +<dt id='index-alpha_002ebst'><span><code>alpha</code><a href='#index-alpha_002ebst' class='copiable-anchor'> ¶</a></span></dt> +<dd><p>Alphanumeric labels, e.g., ‘<samp>Knu66</samp>’. </p> </dd> -<dt><code>apalike</code></dt> -<dd><span id="index-apalike_002ebst"></span> -<p>No labels at all; instead, the year appears in parentheses after the author. +<dt id='index-apalike_002ebst'><span><code>apalike</code><a href='#index-apalike_002ebst' class='copiable-anchor'> ¶</a></span></dt> +<dd><p>No labels at all; instead, the year appears in parentheses after the author. Use this in conjunction with <samp>apalike.tex</samp> (plain TeX) or <samp>apalike.sty</samp> (LaTeX), which also changes the citations in the text to be ‘<samp>(<var>author</var>, <var>year</var>)</samp>’. </p> </dd> -<dt><code>ieeetr</code></dt> -<dd><span id="index-ieeetr_002ebst"></span> -<p>Numeric labels, entries in citation order, <small>IEEE</small> abbreviations, +<dt id='index-ieeetr_002ebst'><span><code>ieeetr</code><a href='#index-ieeetr_002ebst' class='copiable-anchor'> ¶</a></span></dt> +<dd><p>Numeric labels, entries in citation order, <small>IEEE</small> abbreviations, article titles in quotes. </p> </dd> -<dt><code>siam</code></dt> -<dd><span id="index-siam_002ebst"></span> -<p>Numeric labels, alphabetic order, <cite>Math. Reviews</cite> +<dt id='index-siam_002ebst'><span><code>siam</code><a href='#index-siam_002ebst' class='copiable-anchor'> ¶</a></span></dt> +<dd><p>Numeric labels, alphabetic order, <cite>Math. Reviews</cite> abbreviations, names in small caps. </p> </dd> -<dt><code>unsrt</code></dt> -<dd><span id="index-unsrt_002ebst"></span> -<p>Lists entries in citation order, i.e., unsorted. +<dt id='index-unsrt_002ebst'><span><code>unsrt</code><a href='#index-unsrt_002ebst' class='copiable-anchor'> ¶</a></span></dt> +<dd><p>Lists entries in citation order, i.e., unsorted. </p> </dd> -<dt><code>btxbst.doc</code></dt> +<dt><span><code>btxbst.doc</code></span></dt> <dd><p>The template file and documentation for the standard styles. </p> </dd> @@ -3626,9 +3608,12 @@ abbreviations, names in small caps. <hr> -<span id="WEB"></span><div class="header"> +</div> +</div> +<div class="chapter" id="WEB"> +<div class="header"> <p> -Next: <a href="#DVI-utilities" accesskey="n" rel="next">DVI utilities</a>, Previous: <a href="#BibTeX" accesskey="p" rel="prev">BibTeX</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="#DVI-utilities" accesskey="n" rel="next">DVI utilities</a>, Previous: <a href="#BibTeX" accesskey="p" rel="prev">BibTeX: Bibliographies</a>, Up: <a href="#Top" accesskey="u" rel="up">Web2c</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="WEB_003a-Literate-programming"></span><h2 class="chapter">9 WEB: Literate programming</h2> @@ -3662,20 +3647,18 @@ the TeX project at Stanford. which is included in the <a href="ftp://ftp.tug.org/tex/lib.tar.gz">ftp://ftp.tug.org/tex/lib.tar.gz</a> archive (and available in many other places, of course). </p> -<table class="menu" border="0" cellspacing="0"> -<tr><td align="left" valign="top">• <a href="#tangle-invocation" accesskey="1">tangle invocation</a></td><td> </td><td align="left" valign="top"> -</td></tr> -<tr><td align="left" valign="top">• <a href="#weave-invocation" accesskey="2">weave invocation</a></td><td> </td><td align="left" valign="top"> -</td></tr> -<tr><td align="left" valign="top">• <a href="#pooltype-invocation" accesskey="3">pooltype invocation</a></td><td> </td><td align="left" valign="top"> -</td></tr> -</table> +<ul class="section-toc"> +<li><a href="#tangle-invocation" accesskey="1">Tangle: Translate WEB to Pascal</a></li> +<li><a href="#weave-invocation" accesskey="2">Weave: Translate WEB to TeX</a></li> +<li><a href="#pooltype-invocation" accesskey="3">Pooltype: Display WEB pool files</a></li> +</ul> <hr> -<span id="tangle-invocation"></span><div class="header"> +<div class="section" id="tangle-invocation"> +<div class="header"> <p> -Next: <a href="#weave-invocation" accesskey="n" rel="next">weave invocation</a>, Up: <a href="#WEB" accesskey="u" rel="up">WEB</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="#weave-invocation" accesskey="n" rel="next">Weave: Translate WEB to TeX</a>, Up: <a href="#WEB" accesskey="u" rel="up">WEB: Literate 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> <span id="Tangle_003a-Translate-WEB-to-Pascal"></span><h3 class="section">9.1 Tangle: Translate WEB to Pascal</h3> @@ -3684,7 +3667,7 @@ Next: <a href="#weave-invocation" accesskey="n" rel="next">weave invocation</a>, <span id="index-WEB-programs_002c-compiling"></span> <p>Tangle creates a compilable Pascal program from a WEB source file -(see <a href="#WEB">WEB</a>). Synopsis: +(see <a href="#WEB">WEB: Literate programming</a>). Synopsis: </p> <div class="example"> <pre class="example">tangle [<var>option</var>]… <var>webfile</var>[.web] [<var>changefile</var>[.ch]] @@ -3709,39 +3692,35 @@ semicolons when this can be done conveniently. ‘<samp>--help</samp>’ and ‘<samp>--version</samp>’ (see <a href="#Common-options">Common options</a>): </p> <dl compact="compact"> -<dt>‘<samp>-length=<var>number</var></samp>’</dt> -<dd><span id="index-_002dlength_003dnumber"></span> -<span id="index-identifier-length"></span> +<dt id='index-_002dlength_003dnumber'><span>‘<samp>-length=<var>number</var></samp>’<a href='#index-_002dlength_003dnumber' class='copiable-anchor'> ¶</a></span></dt> +<dd><span id="index-identifier-length"></span> <p>The number of characters that are considered significant in an identifier. Whether underline characters are counted depends on the ‘<samp>-underline</samp>’ option. The default value is 32, the original tangle used 7, but this proved too restrictive for use by Web2c. </p> </dd> -<dt>‘<samp>-lowercase</samp>’</dt> -<dt>‘<samp>-mixedcase</samp>’</dt> -<dt>‘<samp>-uppercase</samp>’</dt> -<dd><span id="index-_002dlowercase"></span> -<span id="index-_002dmixedcase"></span> +<dt id='index-_002dlowercase'><span>‘<samp>-lowercase</samp>’<a href='#index-_002dlowercase' class='copiable-anchor'> ¶</a></span></dt> +<dt><span>‘<samp>-mixedcase</samp>’</span></dt> +<dt><span>‘<samp>-uppercase</samp>’</span></dt> +<dd><span id="index-_002dmixedcase"></span> <span id="index-_002duppercase"></span> <span id="index-identifier-case"></span> <p>These options specify the case of identifiers in the output of tangle. If ‘<samp>-uppercase</samp>’ (‘<samp>-lowercase</samp>’) is specified, tangle will -convert all identfiers to uppercase (lowercase). The default is +convert all identifiers to uppercase (lowercase). The default is ‘<samp>-mixedcase</samp>’, which specifies that the case will not be changed. </p> </dd> -<dt>‘<samp>-underline</samp>’</dt> -<dd><span id="index-_002dunderline"></span> -<span id="index-identifiers-with-underlines"></span> +<dt id='index-_002dunderline'><span>‘<samp>-underline</samp>’<a href='#index-_002dunderline' class='copiable-anchor'> ¶</a></span></dt> +<dd><span id="index-identifiers-with-underlines"></span> <p>When this option is given, tangle does not strip underline characters from identifiers. </p> </dd> -<dt>‘<samp>-loose</samp>’</dt> -<dt>‘<samp>-strict</samp>’</dt> -<dd><span id="index-_002dloose"></span> -<span id="index-_002dstrict"></span> +<dt id='index-_002dloose'><span>‘<samp>-loose</samp>’<a href='#index-_002dloose' class='copiable-anchor'> ¶</a></span></dt> +<dt><span>‘<samp>-strict</samp>’</span></dt> +<dd><span id="index-_002dstrict"></span> <span id="index-identifier-collisions"></span> <p>These options specify how strict tangle must be when checking identifiers for equality. The default is ‘<samp>-loose</samp>’, which means @@ -3754,9 +3733,11 @@ whether they collide. </dl> <hr> -<span id="weave-invocation"></span><div class="header"> +</div> +<div class="section" id="weave-invocation"> +<div class="header"> <p> -Next: <a href="#pooltype-invocation" accesskey="n" rel="next">pooltype invocation</a>, Previous: <a href="#tangle-invocation" accesskey="p" rel="prev">tangle invocation</a>, Up: <a href="#WEB" accesskey="u" rel="up">WEB</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="#pooltype-invocation" accesskey="n" rel="next">Pooltype: Display WEB pool files</a>, Previous: <a href="#tangle-invocation" accesskey="p" rel="prev">Tangle: Translate WEB to Pascal</a>, Up: <a href="#WEB" accesskey="u" rel="up">WEB: Literate 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> <span id="Weave_003a-Translate-WEB-to-TeX"></span><h3 class="section">9.2 Weave: Translate WEB to TeX</h3> @@ -3765,7 +3746,7 @@ Next: <a href="#pooltype-invocation" accesskey="n" rel="next">pooltype invocatio <span id="index-WEB-programs_002c-typesetting"></span> <span id="index-prettyprinting-WEB-programs"></span> -<p>Weave creates a TeX document from a WEB source file (see <a href="#WEB">WEB</a>), +<p>Weave creates a TeX document from a WEB source file (see <a href="#WEB">WEB: Literate programming</a>), assuming various macros defined in <samp>webmac.tex</samp>. It takes care of typographic details such as page layout, indentation, and italicizing identifiers. It also automatically gathers and outputs extensive @@ -3784,9 +3765,8 @@ before writing the output; by default, there is no change file. <p>The program accepts the following option, as well as the standard ‘<samp>-verbose</samp>’, ‘<samp>-help</samp>’ and ‘<samp>-version</samp>’ (see <a href="#Common-options">Common options</a>): </p><dl compact="compact"> -<dt>‘<samp>-x</samp>’</dt> -<dd><span id="index-_002dx"></span> -<span id="index-cross_002dreferences_002c-omitting"></span> +<dt id='index-_002dx'><span>‘<samp>-x</samp>’<a href='#index-_002dx' class='copiable-anchor'> ¶</a></span></dt> +<dd><span id="index-cross_002dreferences_002c-omitting"></span> <span id="index-CONTENTS_002etex"></span> <span id="index-webmac_002etex"></span> <p>Omit the cross-reference information: the index, the list of WEB module @@ -3803,9 +3783,11 @@ first change in the change file). </p> <hr> -<span id="pooltype-invocation"></span><div class="header"> +</div> +<div class="section" id="pooltype-invocation"> +<div class="header"> <p> -Previous: <a href="#weave-invocation" accesskey="p" rel="prev">weave invocation</a>, Up: <a href="#WEB" accesskey="u" rel="up">WEB</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="#weave-invocation" accesskey="p" rel="prev">Weave: Translate WEB to TeX</a>, Up: <a href="#WEB" accesskey="u" rel="up">WEB: Literate 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> <span id="Pooltype_003a-Display-WEB-pool-files"></span><h3 class="section">9.3 Pooltype: Display WEB pool files</h3> @@ -3815,7 +3797,7 @@ Previous: <a href="#weave-invocation" accesskey="p" rel="prev">weave invocation< <span id="index-WEB-pool-files_002c-displaying"></span> <p>Pooltype shows the so-called <em>string number</em> of each string in a WEB -pool file (see <a href="#WEB">WEB</a>), as output by Tangle (see <a href="#tangle-invocation">tangle invocation</a>), including the first 256 strings corresponding to the +pool file (see <a href="#WEB">WEB: Literate programming</a>), as output by Tangle (see <a href="#tangle-invocation">Tangle: Translate WEB to Pascal</a>), including the first 256 strings corresponding to the possible input characters. Pooltype primarily serves as an example of WEB conventions to implementors of the TeX system. Synopsis: </p> @@ -3849,9 +3831,12 @@ output. </p> <hr> -<span id="DVI-utilities"></span><div class="header"> +</div> +</div> +<div class="chapter" id="DVI-utilities"> +<div class="header"> <p> -Next: <a href="#Font-utilities" accesskey="n" rel="next">Font utilities</a>, Previous: <a href="#WEB" accesskey="p" rel="prev">WEB</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="#Font-utilities" accesskey="n" rel="next">Font utilities</a>, Previous: <a href="#WEB" accesskey="p" rel="prev">WEB: Literate programming</a>, Up: <a href="#Top" accesskey="u" rel="up">Web2c</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="DVI-utilities-1"></span><h2 class="chapter">10 DVI utilities</h2> @@ -3860,10 +3845,10 @@ Next: <a href="#Font-utilities" accesskey="n" rel="next">Font utilities</a>, Pre <p>TeX outputs a file in <em>DVI</em> (DeVice Independent) format as a compact representation of the original document. DVI files can be translated to meet the requirements of a real physical device, such as -PostScript printers (see <a href="https://tug.org/texinfohtml/dvips.html#Top">Introduction</a> in <cite>Dvips</cite>), PCL +PostScript printers (see <a data-manual="dvips" href="https://tug.org/texinfohtml/dvips.html#Top">Introduction</a> in <cite>Dvips</cite>), PCL printers (see dvilj(1)), and X displays (see xdvi(1)). In fact, DVI translators are available for virtually all common devices: see -<samp><var>CTAN:</var>/dviware</samp> (for CTAN info, see <a href="https://tug.org/texinfohtml/kpathsea.html#unixtex_002eftp">unixtex.ftp</a> in <cite>Kpathsea</cite>). +<samp><var>CTAN:</var>/dviware</samp> (for CTAN info, see <a data-manual="kpathsea" href="https://tug.org/texinfohtml/kpathsea.html#unixtex_002eftp">unixtex.ftp</a> in <cite>Kpathsea</cite>). </p> <span id="index-dvitype_002eweb"></span> <span id="index-DVI-format-definition"></span> @@ -3873,17 +3858,16 @@ source file <samp>web2c/dvitype.web</samp>. <p>The DVI-processing programs in the Web2c distribution are not device drivers; they perform generic utility functions. </p> -<table class="menu" border="0" cellspacing="0"> -<tr><td align="left" valign="top">• <a href="#dvicopy-invocation" accesskey="1">dvicopy invocation</a></td><td> </td><td align="left" valign="top">Expand virtual fonts. -</td></tr> -<tr><td align="left" valign="top">• <a href="#dvitype-invocation" accesskey="2">dvitype invocation</a></td><td> </td><td align="left" valign="top">DVI to human-readable text. -</td></tr> -</table> +<ul class="section-toc"> +<li><a href="#dvicopy-invocation" accesskey="1">DVIcopy: Canonicalize virtual font references</a></li> +<li><a href="#dvitype-invocation" accesskey="2">DVItype: Plain text transliteration of DVI files</a></li> +</ul> <hr> -<span id="dvicopy-invocation"></span><div class="header"> +<div class="section" id="dvicopy-invocation"> +<div class="header"> <p> -Next: <a href="#dvitype-invocation" accesskey="n" rel="next">dvitype invocation</a>, Up: <a href="#DVI-utilities" accesskey="u" rel="up">DVI utilities</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="#dvitype-invocation" accesskey="n" rel="next">DVItype: Plain text transliteration of DVI files</a>, Up: <a href="#DVI-utilities" accesskey="u" rel="up">DVI utilities</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="DVIcopy_003a-Canonicalize-virtual-font-references"></span><h3 class="section">10.1 DVIcopy: Canonicalize virtual font references</h3> @@ -3891,7 +3875,7 @@ Next: <a href="#dvitype-invocation" accesskey="n" rel="next">dvitype invocation< <span id="index-virtual-fonts_002c-expanding"></span> <p>DVIcopy reads a DVI file, expands any references to virtual fonts -(see <a href="https://tug.org/texinfohtml/dvips.html#Virtual-fonts">Virtual fonts</a> in <cite>Dvips</cite>) to base fonts, and writes the +(see <a data-manual="dvips" href="https://tug.org/texinfohtml/dvips.html#Virtual-fonts">Virtual fonts</a> in <cite>Dvips</cite>) to base fonts, and writes the resulting DVI file. Thus you can use virtual fonts even if your DVI processor does not support them, by passing the documents through DVIcopy first. Synopsis: @@ -3906,23 +3890,20 @@ standard output if <var>outdvi</var> is not specified. <p>The program accepts the following options, as well as the standard ‘<samp>-help</samp>’ and ‘<samp>-version</samp>’ (see <a href="#Common-options">Common options</a>): </p><dl compact="compact"> -<dt>‘<samp>-magnification=<var>integer</var></samp>’</dt> -<dd><span id="index-_002dmagnification_003dinteger"></span> -<span id="index-magnification"></span> +<dt id='index-_002dmagnification_003dinteger'><span>‘<samp>-magnification=<var>integer</var></samp>’<a href='#index-_002dmagnification_003dinteger' class='copiable-anchor'> ¶</a></span></dt> +<dd><span id="index-magnification"></span> <span id="index-_005cmag"></span> <p>Override existing magnification in <var>indvi</var> with <var>integer</var>; 1000 specifies no magnification. This is equivalent to setting TeX’s <code>\mag</code> parameter. </p> </dd> -<dt>‘<samp>-max-pages=<var>n</var></samp>’</dt> -<dd><span id="index-_002dmax_002dpages_003dn"></span> -<p>Process <var>n</var> pages; default is one million. +<dt id='index-_002dmax_002dpages_003dn'><span>‘<samp>-max-pages=<var>n</var></samp>’<a href='#index-_002dmax_002dpages_003dn' class='copiable-anchor'> ¶</a></span></dt> +<dd><p>Process <var>n</var> pages; default is one million. </p> </dd> -<dt>‘<samp>-page-start=<var>page-spec</var></samp>’</dt> -<dd><span id="index-_002dpage_002dstart_003dpage_002dspec"></span> -<span id="index-starting-page"></span> +<dt id='index-_002dpage_002dstart_003dpage_002dspec'><span>‘<samp>-page-start=<var>page-spec</var></samp>’<a href='#index-_002dpage_002dstart_003dpage_002dspec' class='copiable-anchor'> ¶</a></span></dt> +<dd><span id="index-starting-page"></span> <span id="index-page_002c-starting"></span> <span id="index-_005ccountn"></span> <p>Start at the first page matching <var>page-spec</var>, which is one or more @@ -3934,9 +3915,11 @@ matches anything. Examples: ‘<samp>3</samp>’, ‘<samp>1.*.-4</ <hr> -<span id="dvitype-invocation"></span><div class="header"> +</div> +<div class="section" id="dvitype-invocation"> +<div class="header"> <p> -Previous: <a href="#dvicopy-invocation" accesskey="p" rel="prev">dvicopy invocation</a>, Up: <a href="#DVI-utilities" accesskey="u" rel="up">DVI utilities</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="#dvicopy-invocation" accesskey="p" rel="prev">DVIcopy: Canonicalize virtual font references</a>, Up: <a href="#DVI-utilities" accesskey="u" rel="up">DVI utilities</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="DVItype_003a-Plain-text-transliteration-of-DVI-files"></span><h3 class="section">10.2 DVItype: Plain text transliteration of DVI files</h3> @@ -3958,7 +3941,7 @@ correct. Synopsis: <p>DVItype does not read any bitmap files, but it does read TFM files for fonts referenced in <var>dvifile</var>. The usual places are searched -(see <a href="https://tug.org/texinfohtml/kpathsea.html#Supported-file-formats">Supported file formats</a> in <cite>Kpathsea</cite>). To see all the +(see <a data-manual="kpathsea" href="https://tug.org/texinfohtml/kpathsea.html#Supported-file-formats">Supported file formats</a> in <cite>Kpathsea</cite>). To see all the relevant paths, set the environment variable <code>KPATHSEA_DEBUG</code> to ‘<samp>-1</samp>’ before running the program. </p> @@ -3967,29 +3950,25 @@ relevant paths, set the environment variable <code>KPATHSEA_DEBUG</code> to <p>The program accepts the following options, as well as the standard ‘<samp>-help</samp>’ and ‘<samp>-version</samp>’ (see <a href="#Common-options">Common options</a>): </p><dl compact="compact"> -<dt>‘<samp>-dpi=<var>real</var></samp>’</dt> -<dd><span id="index-_002ddpi_003dreal"></span> -<p>Do pixel movement calculations at <var>real</var> pixels per inch; default +<dt id='index-_002ddpi_003dreal'><span>‘<samp>-dpi=<var>real</var></samp>’<a href='#index-_002ddpi_003dreal' class='copiable-anchor'> ¶</a></span></dt> +<dd><p>Do pixel movement calculations at <var>real</var> pixels per inch; default 300.0. </p> </dd> -<dt>‘<samp>-magnification=<var>integer</var></samp>’</dt> -<dd><span id="index-_002dmagnification_003dinteger-1"></span> -<span id="index-magnification-1"></span> +<dt id='index-_002dmagnification_003dinteger-1'><span>‘<samp>-magnification=<var>integer</var></samp>’<a href='#index-_002dmagnification_003dinteger-1' class='copiable-anchor'> ¶</a></span></dt> +<dd><span id="index-magnification-1"></span> <span id="index-_005cmag-1"></span> <p>Override existing magnification in <var>indvi</var> with <var>integer</var>; 1000 specifies no magnification. This is equivalent to setting TeX’s <code>\mag</code> parameter. </p> </dd> -<dt>‘<samp>-max-pages=<var>n</var></samp>’</dt> -<dd><span id="index-_002dmax_002dpages_003dn-1"></span> -<p>Process <var>n</var> pages; default is one million. +<dt id='index-_002dmax_002dpages_003dn-1'><span>‘<samp>-max-pages=<var>n</var></samp>’<a href='#index-_002dmax_002dpages_003dn-1' class='copiable-anchor'> ¶</a></span></dt> +<dd><p>Process <var>n</var> pages; default is one million. </p> </dd> -<dt>‘<samp>-output-level=<var>n</var></samp>’</dt> -<dd><span id="index-_002doutput_002dlevel_003dn"></span> -<p>Verbosity level of output, from 0 to 4 (default 4): +<dt id='index-_002doutput_002dlevel_003dn'><span>‘<samp>-output-level=<var>n</var></samp>’<a href='#index-_002doutput_002dlevel_003dn' class='copiable-anchor'> ¶</a></span></dt> +<dd><p>Verbosity level of output, from 0 to 4 (default 4): </p><ul> <li> 0: Global document information only. </li><li> 1: Most DVI commands included, and typeset characters summarized. @@ -4000,9 +3979,8 @@ in the file, reading the DVI postamble first. </li></ul> </dd> -<dt>‘<samp>-page-start=<var>page-spec</var></samp>’</dt> -<dd><span id="index-_002dpage_002dstart_003dpage_002dspec-1"></span> -<span id="index-starting-page-1"></span> +<dt id='index-_002dpage_002dstart_003dpage_002dspec-1'><span>‘<samp>-page-start=<var>page-spec</var></samp>’<a href='#index-_002dpage_002dstart_003dpage_002dspec-1' class='copiable-anchor'> ¶</a></span></dt> +<dd><span id="index-starting-page-1"></span> <span id="index-page_002c-starting-1"></span> <span id="index-_005ccountn-1"></span> <p>Start at the first page matching <var>page-spec</var>, which is one or more @@ -4011,9 +3989,8 @@ in the file, reading the DVI postamble first. matches anything. Examples: ‘<samp>1</samp>’, ‘<samp>5.*.-9</samp>’. </p> </dd> -<dt>‘<samp>-show-opcodes</samp>’</dt> -<dd><span id="index-_002dshow_002dopcodes"></span> -<span id="index-opcodes_002c-showing-DVI"></span> +<dt id='index-_002dshow_002dopcodes'><span>‘<samp>-show-opcodes</samp>’<a href='#index-_002dshow_002dopcodes' class='copiable-anchor'> ¶</a></span></dt> +<dd><span id="index-opcodes_002c-showing-DVI"></span> <span id="index-DVI-opcodes_002c-showing"></span> <span id="index-debugging-DVI-utilities"></span> <p>Show numeric opcode values (in decimal) for DVI commands, in braces @@ -4023,16 +4000,16 @@ use decimal because in the DVI format documentation (in </p></dd> </dl> -<table class="menu" border="0" cellspacing="0"> -<tr><td align="left" valign="top">• <a href="#dvitype-output-example" accesskey="1">dvitype output example</a></td><td> </td><td align="left" valign="top"> -</td></tr> -</table> +<ul class="section-toc"> +<li><a href="#dvitype-output-example" accesskey="1">DVItype output example</a></li> +</ul> <hr> -<span id="dvitype-output-example"></span><div class="header"> +<div class="subsection" id="dvitype-output-example"> +<div class="header"> <p> -Up: <a href="#dvitype-invocation" accesskey="u" rel="up">dvitype invocation</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> +Up: <a href="#dvitype-invocation" accesskey="u" rel="up">DVItype: Plain text transliteration of DVI 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="DVItype-output-example"></span><h4 class="subsection">10.2.1 DVItype output example</h4> @@ -4117,9 +4094,13 @@ STORY]</samp>’ and the ‘<samp>[ 1]</samp>’. <hr> -<span id="Font-utilities"></span><div class="header"> +</div> +</div> +</div> +<div class="chapter" id="Font-utilities"> +<div class="header"> <p> -Next: <a href="#Legalisms" accesskey="n" rel="next">Legalisms</a>, Previous: <a href="#DVI-utilities" accesskey="p" rel="prev">DVI utilities</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="#Legalisms" accesskey="n" rel="next">Legalisms</a>, Previous: <a href="#DVI-utilities" accesskey="p" rel="prev">DVI utilities</a>, Up: <a href="#Top" accesskey="u" rel="up">Web2c</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-utilities-1"></span><h2 class="chapter">11 Font utilities</h2> @@ -4138,41 +4119,32 @@ outputs GF format, but it’s most efficient for device drivers to use PK. mentioned below are in the source files that read them; <samp>pktype.web</samp>, <samp>gftype.web</samp>, <samp>tftopl.web</samp>, etc. </p> -<table class="menu" border="0" cellspacing="0"> -<tr><td align="left" valign="top">• <a href="#Font-file-formats" accesskey="1">Font file formats</a></td><td> </td><td align="left" valign="top">Explanations of GF, PK, TFM, VF, ... -</td></tr> -<tr><td align="left" valign="top">• <a href="#gftopk-invocation" accesskey="2">gftopk invocation</a></td><td> </td><td align="left" valign="top">GF -> PK (compact) -</td></tr> -<tr><td align="left" valign="top">• <a href="#pktogf-invocation" accesskey="3">pktogf invocation</a></td><td> </td><td align="left" valign="top">PK -> GF (expand). -</td></tr> -<tr><td align="left" valign="top">• <a href="#pktype-invocation" accesskey="4">pktype invocation</a></td><td> </td><td align="left" valign="top">PK -> human-readable text. -</td></tr> -<tr><td align="left" valign="top">• <a href="#gftype-invocation" accesskey="5">gftype invocation</a></td><td> </td><td align="left" valign="top">GF -> human-readable text. -</td></tr> -<tr><td align="left" valign="top">• <a href="#tftopl-invocation" accesskey="6">tftopl invocation</a></td><td> </td><td align="left" valign="top">TFM -> PL (for editing TFM). -</td></tr> -<tr><td align="left" valign="top">• <a href="#pltotf-invocation" accesskey="7">pltotf invocation</a></td><td> </td><td align="left" valign="top">PL -> TFM (make editing results usable). -</td></tr> -<tr><td align="left" valign="top">• <a href="#vftovp-invocation" accesskey="8">vftovp invocation</a></td><td> </td><td align="left" valign="top">VF -> VPL (tftopl for virtual fonts). -</td></tr> -<tr><td align="left" valign="top">• <a href="#vptovf-invocation" accesskey="9">vptovf invocation</a></td><td> </td><td align="left" valign="top">VPL -> VF (pltotf for virtual fonts). -</td></tr> -<tr><td align="left" valign="top">• <a href="#Font-utilities-available-elsewhere">Font utilities available elsewhere</a></td><td> </td><td align="left" valign="top">Type 1, BDF, editors, etc. -</td></tr> -</table> +<ul class="section-toc"> +<li><a href="#Font-file-formats" accesskey="1">Font file formats</a></li> +<li><a href="#gftopk-invocation" accesskey="2">GFtoPK: Generic to packed font conversion</a></li> +<li><a href="#pktogf-invocation" accesskey="3">PKtoGF: Packed to generic font conversion</a></li> +<li><a href="#pktype-invocation" accesskey="4">PKtype: Plain text transliteration of packed fonts</a></li> +<li><a href="#gftype-invocation" accesskey="5">GFtype: Plain text transliteration of generic fonts</a></li> +<li><a href="#tftopl-invocation" accesskey="6">TFtoPL: TeX font metric to property list conversion</a></li> +<li><a href="#pltotf-invocation" accesskey="7">PLtoTF: Property list to TeX font metric conversion</a></li> +<li><a href="#vftovp-invocation" accesskey="8">VFtoVP: Virtual font to virtual property lists</a></li> +<li><a href="#vptovf-invocation" accesskey="9">VPtoVF: Virtual property lists to virtual font</a></li> +<li><a href="#Font-utilities-available-elsewhere">Font utilities available elsewhere</a></li> +</ul> <hr> -<span id="Font-file-formats"></span><div class="header"> +<div class="section" id="Font-file-formats"> +<div class="header"> <p> -Next: <a href="#gftopk-invocation" accesskey="n" rel="next">gftopk invocation</a>, Up: <a href="#Font-utilities" accesskey="u" rel="up">Font utilities</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="#gftopk-invocation" accesskey="n" rel="next">GFtoPK: Generic to packed font conversion</a>, Up: <a href="#Font-utilities" accesskey="u" rel="up">Font utilities</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-file-formats-1"></span><h3 class="section">11.1 Font file formats</h3> <span id="index-font-file-formats"></span> <span id="index-file-formats-for-fonts"></span> -<p>(For another perspective on this, see <a href="https://tug.org/texinfohtml/dvips.html#Font-concepts">Font concepts</a> in <cite>Dvips</cite>). +<p>For another perspective on this, see <a data-manual="dvips" href="https://tug.org/texinfohtml/dvips.html#Font-concepts">Font concepts</a> in <cite>Dvips</cite>. </p> <p>Font files come in several varieties, with suffixes like: </p><div class="example"> @@ -4228,7 +4200,7 @@ obsolete. <p>Font files with the ‘<samp>.pl</samp>’ (property list) suffix are the plain text (human-readable) analog of the binary ‘<samp>.tfm</samp>’ files. The TFtoPL and PLtoTF programs convert between the two formats -(see <a href="#tftopl-invocation">tftopl invocation</a> and <a href="#pltotf-invocation">pltotf invocation</a>). +(see <a href="#tftopl-invocation">TFtoPL: TeX font metric to property list conversion</a> and <a href="#pltotf-invocation">PLtoTF: Property list to TeX font metric conversion</a>). </p> <p>Font files with the ‘<samp>.mf</samp>’ suffix are in Metafont source format. These are the files used by Metafont to generate rastered fonts for @@ -4238,10 +4210,10 @@ resolution and type of mapping used by your device. <span id="index-virtual_002dfonts_002eknuth"></span> <span id="index-virtualfonts_002etxt"></span> <p>The suffix ‘<samp>.vf</samp>’ identifies “virtual font” files, for which -‘<samp>.vpl</samp>’ is the human-readable analog. See See <a href="#vftovp-invocation">vftovp invocation</a>, -and <a href="#vptovf-invocation">vptovf invocation</a>. For further discussion of virtual fonts, +‘<samp>.vpl</samp>’ is the human-readable analog. See See <a href="#vftovp-invocation">VFtoVP: Virtual font to virtual property lists</a>, +and <a href="#vptovf-invocation">VPtoVF: Virtual property lists to virtual font</a>. For further discussion of virtual fonts, see <samp><var>CTAN:</var>/doc/virtual-fonts.knuth</samp>, -<samp><var>CTAN:</var>/help/virtualfonts.txt</samp>, and <a href="https://tug.org/texinfohtml/dvips.html#Virtual-fonts">Virtual fonts</a> in <cite>Dvips</cite>. +<samp><var>CTAN:</var>/help/virtualfonts.txt</samp>, and <a data-manual="dvips" href="https://tug.org/texinfohtml/dvips.html#Virtual-fonts">Virtual fonts</a> in <cite>Dvips</cite>. </p> <span id="index-MacKay_002c-Pierre"></span> <span id="index-Tachikawa_002c-Elizabeth"></span> @@ -4250,9 +4222,11 @@ distribution by Pierre MacKay and Elizabeth Tachikawa.) </p> <hr> -<span id="gftopk-invocation"></span><div class="header"> +</div> +<div class="section" id="gftopk-invocation"> +<div class="header"> <p> -Next: <a href="#pktogf-invocation" accesskey="n" rel="next">pktogf invocation</a>, Previous: <a href="#Font-file-formats" accesskey="p" rel="prev">Font file formats</a>, Up: <a href="#Font-utilities" accesskey="u" rel="up">Font utilities</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="#pktogf-invocation" accesskey="n" rel="next">PKtoGF: Packed to generic font conversion</a>, Previous: <a href="#Font-file-formats" accesskey="p" rel="prev">Font file formats</a>, Up: <a href="#Font-utilities" accesskey="u" rel="up">Font utilities</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="GFtoPK_003a-Generic-to-packed-font-conversion"></span><h3 class="section">11.2 GFtoPK: Generic to packed font conversion</h3> @@ -4262,7 +4236,7 @@ Next: <a href="#pktogf-invocation" accesskey="n" rel="next">pktogf invocation</a <span id="index-GF_002c-converting-to-PK"></span> <p>GFtoPK converts a generic font (GF) file output by, for example, -Metafont (see <a href="#mf-invocation">mf invocation</a>) to a packed font (PK) file. PK files +Metafont (see <a href="#mf-invocation"><code>mf</code> invocation</a>) to a packed font (PK) file. PK files are considerably smaller than the corresponding gf files, so they are generally the bitmap font format of choice. Some DVI-processing programs, notably Dvips, only support PK files and not GF files. @@ -4272,7 +4246,7 @@ Synopsis: <pre class="example">gftopk [<var>option</var>]… <var>gfname</var>.<var>dpi</var>[gf] [<var>pkfile</var>] </pre></div> -<p>The font <var>gfname</var> is searched for in the usual places (see <a href="https://tug.org/texinfohtml/kpathsea.html#Glyph-lookup">Glyph +<p>The font <var>gfname</var> is searched for in the usual places (see <a data-manual="kpathsea" href="https://tug.org/texinfohtml/kpathsea.html#Glyph-lookup">Glyph lookup</a> in <cite>Kpathsea</cite>). To see all the relevant paths, set the environment variable <code>KPATHSEA_DEBUG</code> to ‘<samp>-1</samp>’ before running the program. @@ -4290,9 +4264,11 @@ of ‘<samp><var>gfname</var>.<var>dpi</var>pk</samp>’, e.g., ‘< </p> <hr> -<span id="pktogf-invocation"></span><div class="header"> +</div> +<div class="section" id="pktogf-invocation"> +<div class="header"> <p> -Next: <a href="#pktype-invocation" accesskey="n" rel="next">pktype invocation</a>, Previous: <a href="#gftopk-invocation" accesskey="p" rel="prev">gftopk invocation</a>, Up: <a href="#Font-utilities" accesskey="u" rel="up">Font utilities</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="#pktype-invocation" accesskey="n" rel="next">PKtype: Plain text transliteration of packed fonts</a>, Previous: <a href="#gftopk-invocation" accesskey="p" rel="prev">GFtoPK: Generic to packed font conversion</a>, Up: <a href="#Font-utilities" accesskey="u" rel="up">Font utilities</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="PKtoGF_003a-Packed-to-generic-font-conversion"></span><h3 class="section">11.3 PKtoGF: Packed to generic font conversion</h3> @@ -4303,7 +4279,7 @@ Next: <a href="#pktype-invocation" accesskey="n" rel="next">pktype invocation</a <p>PKtoGF converts a packed font (PK) file to a generic font (GF) file. Since PK format is much more compact than GF format, the most likely -reason to do this is to run GFtype (see <a href="#gftype-invocation">gftype invocation</a>) on the +reason to do this is to run GFtype (see <a href="#gftype-invocation">GFtype: Plain text transliteration of generic fonts</a>) on the result, so you can see the bitmap images. Also, a few old utility programs do not support PK format. Synopsis: </p> @@ -4311,7 +4287,7 @@ programs do not support PK format. Synopsis: <pre class="example">pktogf [<var>option</var>]… <var>pkname</var>.<var>dpi</var>[pk] [<var>gffile</var>] </pre></div> -<p>The font <var>pkname</var> is searched for in the usual places (see <a href="https://tug.org/texinfohtml/kpathsea.html#Glyph-lookup">Glyph +<p>The font <var>pkname</var> is searched for in the usual places (see <a data-manual="kpathsea" href="https://tug.org/texinfohtml/kpathsea.html#Glyph-lookup">Glyph lookup</a> in <cite>Kpathsea</cite>). To see all the relevant paths, set the environment variable <code>KPATHSEA_DEBUG</code> to ‘<samp>-1</samp>’ before running the program. @@ -4329,9 +4305,11 @@ of ‘<samp><var>pkname</var>.<var>dpi</var>gf</samp>’, e.g., ‘< </p> <hr> -<span id="pktype-invocation"></span><div class="header"> +</div> +<div class="section" id="pktype-invocation"> +<div class="header"> <p> -Next: <a href="#gftype-invocation" accesskey="n" rel="next">gftype invocation</a>, Previous: <a href="#pktogf-invocation" accesskey="p" rel="prev">pktogf invocation</a>, Up: <a href="#Font-utilities" accesskey="u" rel="up">Font utilities</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="#gftype-invocation" accesskey="n" rel="next">GFtype: Plain text transliteration of generic fonts</a>, Previous: <a href="#pktogf-invocation" accesskey="p" rel="prev">PKtoGF: Packed to generic font conversion</a>, Up: <a href="#Font-utilities" accesskey="u" rel="up">Font utilities</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="PKtype_003a-Plain-text-transliteration-of-packed-fonts"></span><h3 class="section">11.4 PKtype: Plain text transliteration of packed fonts</h3> @@ -4351,7 +4329,7 @@ correct. Synopsis: <pre class="example">pktype <var>pkname</var>.<var>dpi</var>[pk] </pre></div> -<p>The font <var>pkname</var> is searched for in the usual places (see <a href="https://tug.org/texinfohtml/kpathsea.html#Glyph-lookup">Glyph +<p>The font <var>pkname</var> is searched for in the usual places (see <a data-manual="kpathsea" href="https://tug.org/texinfohtml/kpathsea.html#Glyph-lookup">Glyph lookup</a> in <cite>Kpathsea</cite>). To see all the relevant paths, set the environment variable <code>KPATHSEA_DEBUG</code> to ‘<samp>-1</samp>’ before running the program. @@ -4382,58 +4360,50 @@ letter ‘K’ in ‘<samp>cmr10</samp>’, as rendered at 600dp <p>Explanation: </p> <dl compact="compact"> -<dt>‘<samp>955</samp>’</dt> -<dd><span id="index-byte-position"></span> -<p>The byte position in the file where this character starts. +<dt id='index-byte-position'><span>‘<samp>955</samp>’<a href='#index-byte-position' class='copiable-anchor'> ¶</a></span></dt> +<dd><p>The byte position in the file where this character starts. </p> </dd> -<dt>‘<samp>Flag byte</samp>’</dt> -<dt>‘<samp>Dynamic packing variable</samp>’</dt> -<dd><span id="index-flag-byte"></span> -<span id="index-dynamic-packing-variable"></span> +<dt id='index-flag-byte'><span>‘<samp>Flag byte</samp>’<a href='#index-flag-byte' class='copiable-anchor'> ¶</a></span></dt> +<dt><span>‘<samp>Dynamic packing variable</samp>’</span></dt> +<dd><span id="index-dynamic-packing-variable"></span> <p>Related to the packing for this character; see the source code. </p> </dd> -<dt>‘<samp>Character</samp>’</dt> -<dd><span id="index-character-codes_002c-in-PKtype-output"></span> -<p>The character code, in decimal. +<dt id='index-character-codes_002c-in-PKtype-output'><span>‘<samp>Character</samp>’<a href='#index-character-codes_002c-in-PKtype-output' class='copiable-anchor'> ¶</a></span></dt> +<dd><p>The character code, in decimal. </p> </dd> -<dt>‘<samp>Packet length</samp>’</dt> -<dd><span id="index-packet-length"></span> -<p>The total length of this character definition, in bytes. +<dt id='index-packet-length'><span>‘<samp>Packet length</samp>’<a href='#index-packet-length' class='copiable-anchor'> ¶</a></span></dt> +<dd><p>The total length of this character definition, in bytes. </p> </dd> -<dt>‘<samp>TFM width</samp>’</dt> -<dd><span id="index-TFM-width-of-characters"></span> -<span id="index-device_002dindependent-width"></span> +<dt id='index-TFM-width-of-characters'><span>‘<samp>TFM width</samp>’<a href='#index-TFM-width-of-characters' class='copiable-anchor'> ¶</a></span></dt> +<dd><span id="index-device_002dindependent-width"></span> <span id="index-width_002c-device_002dindependent"></span> <p>The device-independent (TFM) width of this character. It is 2^24 times the ratio of the true width to the font’s design size. </p> </dd> -<dt>‘<samp>dx</samp>’</dt> -<dd><span id="index-horizontal-escapement"></span> -<span id="index-escapement_002c-horizontal"></span> +<dt id='index-horizontal-escapement'><span>‘<samp>dx</samp>’<a href='#index-horizontal-escapement' class='copiable-anchor'> ¶</a></span></dt> +<dd><span id="index-escapement_002c-horizontal"></span> <span id="index-scaled-pixels"></span> <span id="index-dx-horizontal-escapement"></span> <p>The device-dependent width, in <em>scaled pixels</em>, i.e., units of horizontal pixels times 2^16. </p> </dd> -<dt>‘<samp>Height</samp>’</dt> -<dt>‘<samp>Width</samp>’</dt> -<dd><span id="index-height_002c-in-pixels"></span> -<span id="index-pixel-height"></span> +<dt id='index-height_002c-in-pixels'><span>‘<samp>Height</samp>’<a href='#index-height_002c-in-pixels' class='copiable-anchor'> ¶</a></span></dt> +<dt><span>‘<samp>Width</samp>’</span></dt> +<dd><span id="index-pixel-height"></span> <span id="index-pixel-width"></span> <span id="index-width_002c-in-pixels"></span> <p>The bitmap height and width, in pixels. </p> </dd> -<dt>‘<samp>X-offset</samp>’</dt> -<dt>‘<samp>Y-offset</samp>’</dt> -<dd><span id="index-x-offset"></span> -<span id="index-y-offset"></span> +<dt id='index-x-offset'><span>‘<samp>X-offset</samp>’<a href='#index-x-offset' class='copiable-anchor'> ¶</a></span></dt> +<dt><span>‘<samp>Y-offset</samp>’</span></dt> +<dd><span id="index-y-offset"></span> <span id="index-origin"></span> <span id="index-reference-pixel"></span> <span id="index-side-bearings"></span> @@ -4448,9 +4418,8 @@ of the left side bearing; the right side bearing is the horizontal escapement minus the bitmap width plus the x-offset. </p> </dd> -<dt>‘<samp>[2]23(16)…</samp>’</dt> -<dd><span id="index-run-length-encoded-bitmaps"></span> -<span id="index-repeated-rows"></span> +<dt id='index-run-length-encoded-bitmaps'><span>‘<samp>[2]23(16)…</samp>’<a href='#index-run-length-encoded-bitmaps' class='copiable-anchor'> ¶</a></span></dt> +<dd><span id="index-repeated-rows"></span> <p>Finally, run lengths of black pixels alternate with parenthesized run lengths of white pixels, and brackets indicate a repeated row. </p></dd> @@ -4458,9 +4427,11 @@ lengths of white pixels, and brackets indicate a repeated row. <hr> -<span id="gftype-invocation"></span><div class="header"> +</div> +<div class="section" id="gftype-invocation"> +<div class="header"> <p> -Next: <a href="#tftopl-invocation" accesskey="n" rel="next">tftopl invocation</a>, Previous: <a href="#pktype-invocation" accesskey="p" rel="prev">pktype invocation</a>, Up: <a href="#Font-utilities" accesskey="u" rel="up">Font utilities</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="#tftopl-invocation" accesskey="n" rel="next">TFtoPL: TeX font metric to property list conversion</a>, Previous: <a href="#pktype-invocation" accesskey="p" rel="prev">PKtype: Plain text transliteration of packed fonts</a>, Up: <a href="#Font-utilities" accesskey="u" rel="up">Font utilities</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="GFtype_003a-Plain-text-transliteration-of-generic-fonts"></span><h3 class="section">11.5 GFtype: Plain text transliteration of generic fonts</h3> @@ -4480,7 +4451,7 @@ it’s correct. Synopsis: <pre class="example">gftype [<var>option</var>]… <var>gfname</var>.<var>dpi</var>[gf] </pre></div> -<p>The font <var>gfname</var> is searched for in the usual places (see <a href="https://tug.org/texinfohtml/kpathsea.html#Glyph-lookup">Glyph +<p>The font <var>gfname</var> is searched for in the usual places (see <a data-manual="kpathsea" href="https://tug.org/texinfohtml/kpathsea.html#Glyph-lookup">Glyph lookup</a> in <cite>Kpathsea</cite>). To see all the relevant paths, set the environment variable <code>KPATHSEA_DEBUG</code> to ‘<samp>-1</samp>’ before running the program. @@ -4493,18 +4464,16 @@ not an extension; no ‘<samp>.</samp>’ precedes it: for instance, <sa <p>The program accepts the following options, as well as the standard ‘<samp>-help</samp>’ and ‘<samp>-version</samp>’ (see <a href="#Common-options">Common options</a>): </p><dl compact="compact"> -<dt>‘<samp>-images</samp>’</dt> -<dd><span id="index-_002dimages"></span> -<p>Show the characters’ bitmaps using asterisks and spaces. +<dt id='index-_002dimages'><span>‘<samp>-images</samp>’<a href='#index-_002dimages' class='copiable-anchor'> ¶</a></span></dt> +<dd><p>Show the characters’ bitmaps using asterisks and spaces. </p> </dd> -<dt>‘<samp>-mnemonics</samp>’</dt> -<dd><span id="index-_002dmnemonics"></span> -<p>Translate all commands in the GF file. +<dt id='index-_002dmnemonics'><span>‘<samp>-mnemonics</samp>’<a href='#index-_002dmnemonics' class='copiable-anchor'> ¶</a></span></dt> +<dd><p>Translate all commands in the GF file. </p></dd> </dl> -<p>As an example of the output, here is the (abrdiged) translation of the +<p>As an example of the output, here is the (abridged) translation of the letter ‘K’ in ‘<samp>cmr10</samp>’, as rendered at 600dpi with the mode ‘<samp>ljfour</samp>’ from <samp>modes.mf</samp> (available from <a href="ftp://ftp.tug.org/tex/modes.mf">ftp://ftp.tug.org/tex/modes.mf</a>), with both ‘<samp>-mnemonics</samp>’ and @@ -4550,43 +4519,37 @@ main definition: <p>Explanation: </p> <dl compact="compact"> -<dt>‘<samp>2033</samp>’</dt> -<dt>‘<samp>2043</samp>’</dt> -<dt>‘<samp>…</samp>’</dt> -<dd><span id="index-byte-position-1"></span> -<p>The byte position in the file where each GF command starts. +<dt id='index-byte-position-1'><span>‘<samp>2033</samp>’<a href='#index-byte-position-1' class='copiable-anchor'> ¶</a></span></dt> +<dt><span>‘<samp>2043</samp>’</span></dt> +<dt><span>‘<samp>…</samp>’</span></dt> +<dd><p>The byte position in the file where each GF command starts. </p> </dd> -<dt>‘<samp>beginning of char 75</samp>’</dt> -<dd><span id="index-character-codes_002c-in-GFtype-output"></span> -<p>The character code, in decimal. +<dt id='index-character-codes_002c-in-GFtype-output'><span>‘<samp>beginning of char 75</samp>’<a href='#index-character-codes_002c-in-GFtype-output' class='copiable-anchor'> ¶</a></span></dt> +<dd><p>The character code, in decimal. </p> </dd> -<dt>‘<samp>3<=m<=60 0<=n<=56</samp>’</dt> -<dd><span id="index-left-side-bearing-1"></span> -<span id="index-right-side-bearing-1"></span> +<dt id='index-left-side-bearing-1'><span>‘<samp>3<=m<=60 0<=n<=56</samp>’<a href='#index-left-side-bearing-1' class='copiable-anchor'> ¶</a></span></dt> +<dd><span id="index-right-side-bearing-1"></span> <span id="index-side-bearings-1"></span> <p>The character’s bitmap lies between 3 and 60 (inclusive) horizontally, -and between 0 and 56 (inclusive) vertically. (<em>m</em> is a column -position and <em>n</em> is a row position.) Thus, 3 is the left side +and between 0 and 56 (inclusive) vertically. (<em class='math'>m</em> is a column +position and <em class='math'>n</em> is a row position.) Thus, 3 is the left side bearing. The right side bearing is the horizontal escapement (given -below) minus the maximum <em>m</em>. +below) minus the maximum <em class='math'>m</em>. </p> </dd> -<dt>‘<samp>(initially n=56) paint (0)24(12)20</samp>’</dt> -<dd><span id="index-run-length-encoded-bitmaps-1"></span> -<p>The first row of pixels: 0 white pixels, 24 black pixels, 12 white +<dt id='index-run-length-encoded-bitmaps-1'><span>‘<samp>(initially n=56) paint (0)24(12)20</samp>’<a href='#index-run-length-encoded-bitmaps-1' class='copiable-anchor'> ¶</a></span></dt> +<dd><p>The first row of pixels: 0 white pixels, 24 black pixels, 12 white pixels, etc. </p> </dd> -<dt>‘<samp>newrow 0 (n=55) paint 24(12)20</samp>’</dt> -<dd><span id="index-newrow-GF-command"></span> -<p>The second row of pixels, with zero leading white pixels on the row. +<dt id='index-newrow-GF-command'><span>‘<samp>newrow 0 (n=55) paint 24(12)20</samp>’<a href='#index-newrow-GF-command' class='copiable-anchor'> ¶</a></span></dt> +<dd><p>The second row of pixels, with zero leading white pixels on the row. </p> </dd> -<dt>‘<samp>eoc</samp>’</dt> -<dd><span id="index-eoc-GF-command"></span> -<p>The end of the main character definition. +<dt id='index-eoc-GF-command'><span>‘<samp>eoc</samp>’<a href='#index-eoc-GF-command' class='copiable-anchor'> ¶</a></span></dt> +<dd><p>The end of the main character definition. </p> </dd> </dl> @@ -4600,9 +4563,8 @@ pixels, etc. <p>Explanation: </p> <dl compact="compact"> -<dt>‘<samp>dx</samp>’</dt> -<dd><span id="index-horizontal-escapement-1"></span> -<span id="index-escapement_002c-horizontal-1"></span> +<dt id='index-horizontal-escapement-1'><span>‘<samp>dx</samp>’<a href='#index-horizontal-escapement-1' class='copiable-anchor'> ¶</a></span></dt> +<dd><span id="index-escapement_002c-horizontal-1"></span> <span id="index-vertical-escapement"></span> <span id="index-escapement_002c-vertical"></span> <span id="index-scaled-pixels-1"></span> @@ -4614,16 +4576,15 @@ rounded. If the vertical escapement is nonzero, it would appear here as a ‘<samp>dy</samp>’ value. </p> </dd> -<dt>‘<samp>width</samp>’</dt> -<dd><span id="index-TFM-width-of-characters-1"></span> -<span id="index-device_002dindependent-width-1"></span> +<dt id='index-TFM-width-of-characters-1'><span>‘<samp>width</samp>’<a href='#index-TFM-width-of-characters-1' class='copiable-anchor'> ¶</a></span></dt> +<dd><span id="index-device_002dindependent-width-1"></span> <span id="index-width_002c-device_002dindependent-1"></span> <p>The device-independent (TFM) width of this character. It is 2^24 times the ratio of the true width to the font’s design size. The ‘<samp>64.57289</samp>’ is the same number converted to pixels. </p> </dd> -<dt>‘<samp>loc</samp>’</dt> +<dt><span>‘<samp>loc</samp>’</span></dt> <dd><p>The byte position in the file where this character starts. </p> </dd> @@ -4631,9 +4592,11 @@ times the ratio of the true width to the font’s design size. The <hr> -<span id="tftopl-invocation"></span><div class="header"> +</div> +<div class="section" id="tftopl-invocation"> +<div class="header"> <p> -Next: <a href="#pltotf-invocation" accesskey="n" rel="next">pltotf invocation</a>, Previous: <a href="#gftype-invocation" accesskey="p" rel="prev">gftype invocation</a>, Up: <a href="#Font-utilities" accesskey="u" rel="up">Font utilities</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="#pltotf-invocation" accesskey="n" rel="next">PLtoTF: Property list to TeX font metric conversion</a>, Previous: <a href="#gftype-invocation" accesskey="p" rel="prev">GFtype: Plain text transliteration of generic fonts</a>, Up: <a href="#Font-utilities" accesskey="u" rel="up">Font utilities</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="TFtoPL_003a-TeX-font-metric-to-property-list-conversion"></span><h3 class="section">11.6 TFtoPL: TeX font metric to property list conversion</h3> @@ -4644,7 +4607,7 @@ Next: <a href="#pltotf-invocation" accesskey="n" rel="next">pltotf invocation</a <span id="index-human_002dreadable-text_002c-converting-TFM-to"></span> <span id="index-plain-text_002c-converting-TFM-to"></span> -<p>TFtoPL translates a TeX font metric (TFM, see <a href="https://tug.org/texinfohtml/dvips.html#Metric-files">Metric +<p>TFtoPL translates a TeX font metric (TFM, see <a data-manual="dvips" href="https://tug.org/texinfohtml/dvips.html#Metric-files">Metric files</a> in <cite>Dvips</cite>) file (as output by Metafont, for example) to <em>property list format</em> (a list of parenthesized items describing the font) that humans can edit or read. This program is mostly used by @@ -4656,7 +4619,7 @@ Synopsis: </pre></div> <p>The font <var>tfmname</var> (extended with ‘<samp>.tfm</samp>’ if necessary) is -searched for in the usual places (see <a href="https://tug.org/texinfohtml/kpathsea.html#Supported-file-formats">Supported file formats</a> in <cite>Kpathsea</cite>). To see all the relevant paths, set the +searched for in the usual places (see <a data-manual="kpathsea" href="https://tug.org/texinfohtml/kpathsea.html#Supported-file-formats">Supported file formats</a> in <cite>Kpathsea</cite>). To see all the relevant paths, set the environment variable <code>KPATHSEA_DEBUG</code> to ‘<samp>-1</samp>’ before running the program. </p> @@ -4668,9 +4631,8 @@ program TFtoPL (see the next section). <p>The program accepts the following option, as well as the standard ‘<samp>-verbose</samp>’, ‘<samp>-help</samp>’ and ‘<samp>-version</samp>’ (see <a href="#Common-options">Common options</a>): </p><dl compact="compact"> -<dt>‘<samp>-charcode-format=<var>type</var></samp>’</dt> -<dd><span id="index-_002dcharcode_002dformat_003dtype"></span> -<p>Output character codes in the PL file according to <var>type</var>: either +<dt id='index-_002dcharcode_002dformat_003dtype'><span>‘<samp>-charcode-format=<var>type</var></samp>’<a href='#index-_002dcharcode_002dformat_003dtype' class='copiable-anchor'> ¶</a></span></dt> +<dd><p>Output character codes in the PL file according to <var>type</var>: either ‘<samp>octal</samp>’ or ‘<samp>ascii</samp>’. Default is ‘<samp>ascii</samp>’ for letters and digits, octal for all other characters. Exception: if the font’s coding scheme starts with ‘<samp>TeX math sy</samp>’ or ‘<samp>TeX math ex</samp>’, all @@ -4790,9 +4752,11 @@ ligatures for this character as a comment. <hr> -<span id="pltotf-invocation"></span><div class="header"> +</div> +<div class="section" id="pltotf-invocation"> +<div class="header"> <p> -Next: <a href="#vftovp-invocation" accesskey="n" rel="next">vftovp invocation</a>, Previous: <a href="#tftopl-invocation" accesskey="p" rel="prev">tftopl invocation</a>, Up: <a href="#Font-utilities" accesskey="u" rel="up">Font utilities</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="#vftovp-invocation" accesskey="n" rel="next">VFtoVP: Virtual font to virtual property lists</a>, Previous: <a href="#tftopl-invocation" accesskey="p" rel="prev">TFtoPL: TeX font metric to property list conversion</a>, Up: <a href="#Font-utilities" accesskey="u" rel="up">Font utilities</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="PLtoTF_003a-Property-list-to-TeX-font-metric-conversion"></span><h3 class="section">11.7 PLtoTF: Property list to TeX font metric conversion</h3> @@ -4802,7 +4766,7 @@ Next: <a href="#vftovp-invocation" accesskey="n" rel="next">vftovp invocation</a <span id="index-machine_002dreadable_002c-converting-property-lists-to"></span> <p>PLtoTF translates a property list file (as output by TFtoPL, for -example) to TeX font metric (TFM, see <a href="https://tug.org/texinfohtml/dvips.html#Metric-files">Metric files</a> in <cite>Dvips</cite>) +example) to TeX font metric (TFM, see <a data-manual="dvips" href="https://tug.org/texinfohtml/dvips.html#Metric-files">Metric files</a> in <cite>Dvips</cite>) format. It’s much easier for both programs and humans to create the (plain text) property list files and let PLtoTF take care of creating the binary TFM equivalent than to output TFM files directly. Synopsis: @@ -4824,9 +4788,11 @@ output by default is undesirable.) </p> <hr> -<span id="vftovp-invocation"></span><div class="header"> +</div> +<div class="section" id="vftovp-invocation"> +<div class="header"> <p> -Next: <a href="#vptovf-invocation" accesskey="n" rel="next">vptovf invocation</a>, Previous: <a href="#pltotf-invocation" accesskey="p" rel="prev">pltotf invocation</a>, Up: <a href="#Font-utilities" accesskey="u" rel="up">Font utilities</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="#vptovf-invocation" accesskey="n" rel="next">VPtoVF: Virtual property lists to virtual font</a>, Previous: <a href="#pltotf-invocation" accesskey="p" rel="prev">PLtoTF: Property list to TeX font metric conversion</a>, Up: <a href="#Font-utilities" accesskey="u" rel="up">Font utilities</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="VFtoVP_003a-Virtual-font-to-virtual-property-lists"></span><h3 class="section">11.8 VFtoVP: Virtual font to virtual property lists</h3> @@ -4837,9 +4803,9 @@ Next: <a href="#vptovf-invocation" accesskey="n" rel="next">vptovf invocation</a <span id="index-human_002dreadable-text_002c-converting-VF-to"></span> <span id="index-plain-text_002c-converting-VF-to"></span> -<p>VFtoVP translates a virtual font metric (VF, see <a href="https://tug.org/texinfohtml/dvips.html#Virtual-fonts">Virtual +<p>VFtoVP translates a virtual font metric (VF, see <a data-manual="dvips" href="https://tug.org/texinfohtml/dvips.html#Virtual-fonts">Virtual fonts</a> in <cite>Dvips</cite>) file and its accompanying TeX font metric (TFM, -see <a href="https://tug.org/texinfohtml/dvips.html#Metric-files">Metric files</a> in <cite>Dvips</cite>) file (as output by VPtoVF, for +see <a data-manual="dvips" href="https://tug.org/texinfohtml/dvips.html#Metric-files">Metric files</a> in <cite>Dvips</cite>) file (as output by VPtoVF, for example) to <em>virtual property list format</em> (a list of parenthesized items describing the virtual font) that humans can edit or read. This program is mostly used by people debugging virtual font utilities. @@ -4851,7 +4817,7 @@ Synopsis: <p>The fonts <var>vfname</var> and <var>tfmname</var> (extended with ‘<samp>.vf</samp>’ and ‘<samp>.tfm</samp>’ if necessary) are searched for in the usual places -(see <a href="https://tug.org/texinfohtml/kpathsea.html#Supported-file-formats">Supported file formats</a> in <cite>Kpathsea</cite>). To see all the +(see <a data-manual="kpathsea" href="https://tug.org/texinfohtml/kpathsea.html#Supported-file-formats">Supported file formats</a> in <cite>Kpathsea</cite>). To see all the relevant paths, set the environment variable <code>KPATHSEA_DEBUG</code> to ‘<samp>-1</samp>’ before running the program. If <var>tfmname</var> is not specified, <var>vfname</var> (without a trailing ‘<samp>.vf</samp>’) is used. @@ -4864,9 +4830,8 @@ companion program VFtoVP (see the next section). <p>The program accepts the following option, as well as the standard ‘<samp>-verbose</samp>’, ‘<samp>-help</samp>’ and ‘<samp>-version</samp>’ (see <a href="#Common-options">Common options</a>): </p><dl compact="compact"> -<dt>‘<samp>-charcode-format=<var>type</var></samp>’</dt> -<dd><span id="index-_002dcharcode_002dformat_003dtype-1"></span> -<p>Output character codes in the PL file according to <var>type</var>: either +<dt id='index-_002dcharcode_002dformat_003dtype-1'><span>‘<samp>-charcode-format=<var>type</var></samp>’<a href='#index-_002dcharcode_002dformat_003dtype-1' class='copiable-anchor'> ¶</a></span></dt> +<dd><p>Output character codes in the PL file according to <var>type</var>: either ‘<samp>octal</samp>’ or ‘<samp>ascii</samp>’. Default is ‘<samp>ascii</samp>’ for letters and digits, octal for all other characters. Exception: if the font’s coding scheme starts with ‘<samp>TeX math sy</samp>’ or ‘<samp>TeX math ex</samp>’, all @@ -4886,9 +4851,11 @@ confusing. <hr> -<span id="vptovf-invocation"></span><div class="header"> +</div> +<div class="section" id="vptovf-invocation"> +<div class="header"> <p> -Next: <a href="#Font-utilities-available-elsewhere" accesskey="n" rel="next">Font utilities available elsewhere</a>, Previous: <a href="#vftovp-invocation" accesskey="p" rel="prev">vftovp invocation</a>, Up: <a href="#Font-utilities" accesskey="u" rel="up">Font utilities</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="#Font-utilities-available-elsewhere" accesskey="n" rel="next">Font utilities available elsewhere</a>, Previous: <a href="#vftovp-invocation" accesskey="p" rel="prev">VFtoVP: Virtual font to virtual property lists</a>, Up: <a href="#Font-utilities" accesskey="u" rel="up">Font utilities</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="VPtoVF_003a-Virtual-property-lists-to-virtual-font"></span><h3 class="section">11.9 VPtoVF: Virtual property lists to virtual font</h3> @@ -4898,8 +4865,8 @@ Next: <a href="#Font-utilities-available-elsewhere" accesskey="n" rel="next">Fon <span id="index-machine_002dreadable_002c-converting-property-lists-to-1"></span> <p>VPtoVF translates a virtual property list file (as output by VFtoVP, for -example) to virtual font (VF, see <a href="https://tug.org/texinfohtml/dvips.html#Virtual-fonts">Virtual fonts</a> in <cite>Dvips</cite>) and -TeX font metric (TFM, see <a href="https://tug.org/texinfohtml/dvips.html#Metric-files">Metric files</a> in <cite>Dvips</cite>) files. +example) to virtual font (VF, see <a data-manual="dvips" href="https://tug.org/texinfohtml/dvips.html#Virtual-fonts">Virtual fonts</a> in <cite>Dvips</cite>) and +TeX font metric (TFM, see <a data-manual="dvips" href="https://tug.org/texinfohtml/dvips.html#Metric-files">Metric files</a> in <cite>Dvips</cite>) files. It’s much easier for both programs and humans to create the (plain text) property list files and let VPtoVF take care of creating the binary VF and TFM equivalents than to output them directly. Synopsis: @@ -4919,9 +4886,11 @@ specified, the VF output is written to the basename of </p> <hr> -<span id="Font-utilities-available-elsewhere"></span><div class="header"> +</div> +<div class="section" id="Font-utilities-available-elsewhere"> +<div class="header"> <p> -Previous: <a href="#vptovf-invocation" accesskey="p" rel="prev">vptovf invocation</a>, Up: <a href="#Font-utilities" accesskey="u" rel="up">Font utilities</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="#vptovf-invocation" accesskey="p" rel="prev">VPtoVF: Virtual property lists to virtual font</a>, Up: <a href="#Font-utilities" accesskey="u" rel="up">Font utilities</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-utilities-available-elsewhere-1"></span><h3 class="section">11.10 Font utilities available elsewhere</h3> @@ -4930,14 +4899,14 @@ Previous: <a href="#vptovf-invocation" accesskey="p" rel="prev">vptovf invocatio <p>The Web2c complement of font utilities merely implements a few basic conversions. Many other more sophisticated font utilities exist; most are in <samp><var>CTAN:</var>/fonts/utilities</samp> (for CTAN info, -see <a href="https://tug.org/texinfohtml/kpathsea.html#unixtex_002eftp">unixtex.ftp</a> in <cite>Kpathsea</cite>). Here are some of the most +see <a data-manual="kpathsea" href="https://tug.org/texinfohtml/kpathsea.html#unixtex_002eftp">unixtex.ftp</a> in <cite>Kpathsea</cite>). Here are some of the most commonly-requested items: </p> <ul> <li> <span id="index-AFM-to-TFM-conversion"></span> <span id="index-afm2tfm"></span> <span id="index-afmtopl"></span> -AFM (Adobe font metric) to TFM conversion: see <a href="https://tug.org/texinfohtml/dvips.html#Invoking-afm2tfm">Invoking afm2tfm</a> in <cite>Dvips</cite>, and <samp><var>CTAN:</var>/fonts/utilities/afmtopl</samp>. +AFM (Adobe font metric) to TFM conversion: see <a data-manual="dvips" href="https://tug.org/texinfohtml/dvips.html#Invoking-afm2tfm">Invoking afm2tfm</a> in <cite>Dvips</cite>, and <samp><var>CTAN:</var>/fonts/utilities/afmtopl</samp>. </li><li> <span id="index-X-bitmap-fonts"></span> <span id="index-BDF-and-GF-conversion"></span> @@ -5003,9 +4972,12 @@ Virtual font creation: <a href="https://ctan.org/pkg/fontinst">https://ctan.org/ <hr> -<span id="Legalisms"></span><div class="header"> +</div> +</div> +<div class="appendix" id="Legalisms"> +<div class="header"> <p> -Next: <a href="#References" accesskey="n" rel="next">References</a>, Previous: <a href="#Font-utilities" accesskey="p" rel="prev">Font utilities</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="#References" accesskey="n" rel="next">References</a>, Previous: <a href="#Font-utilities" accesskey="p" rel="prev">Font utilities</a>, Up: <a href="#Top" accesskey="u" rel="up">Web2c</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="Legalisms-1"></span><h2 class="appendix">Appendix A Legalisms</h2> @@ -5025,13 +4997,13 @@ nature of a development request rather than a legal requirement. </p> <p>MLTeX, pdfTeX, LuaTeX, XeTeX, and all the other derived engines have used various license terms for their additions to the -base code, often the GPL (see <a href="https://www.gnu.org/licenses/#GPL">https://www.gnu.org/licenses/#GPL</a> +base code, often the GPL (see <a href="https://www.gnu.org/licenses/#GPL">https://www.gnu.org/licenses/#GPL</a>) or (for example) the file <samp>web2c/pdftexdir/COPYINGv2</samp>. They also mostly make use of additional libraries with their own (compatible) terms. Please see each program’s sources. </p> <p>The Kpathsea library is covered by the GNU Lesser General Public -License (see <a href="https://tug.org/texinfohtml/kpathsea.html#Introduction">Introduction</a> in <cite>Kpathsea</cite>). Therefore, the +License (see <a data-manual="kpathsea" href="https://tug.org/texinfohtml/kpathsea.html#Introduction">Introduction</a> in <cite>Kpathsea</cite>). Therefore, the <em>binaries</em> resulting from a standard Web2c compilation are also covered by the LGPL; so if you (re)distribute the binaries, you must also (offer to) distribute the complete source that went into those @@ -5039,9 +5011,11 @@ binaries. See <a href="https://gnu.org/licenses/#LGPL">https://gnu.org/licenses <samp>kpathsea/COPYING.LESSERv2</samp>. </p> <hr> -<span id="References"></span><div class="header"> +</div> +<div class="appendix" id="References"> +<div class="header"> <p> -Next: <a href="#Index" accesskey="n" rel="next">Index</a>, Previous: <a href="#Legalisms" accesskey="p" rel="prev">Legalisms</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="#Legalisms" accesskey="p" rel="prev">Legalisms</a>, Up: <a href="#Top" accesskey="u" rel="up">Web2c</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="References-1"></span><h2 class="appendix">Appendix B References</h2> @@ -5049,9 +5023,9 @@ Next: <a href="#Index" accesskey="n" rel="next">Index</a>, Previous: <a href="#L <span id="index-bibliography"></span> <ol> -<li> Kpathsea: See <a href="https://tug.org/texinfohtml/kpathsea.html#Top">Introduction</a> in <cite>Kpathsea</cite>. +<li> Kpathsea: See <a data-manual="kpathsea" href="https://tug.org/texinfohtml/kpathsea.html#Top">Introduction</a> in <cite>Kpathsea</cite>. -</li><li> Dvips and Afm2tfm: See <a href="https://tug.org/texinfohtml/dvips.html#Top">Introduction</a> in <cite>Dvips</cite>. +</li><li> Dvips and Afm2tfm: See <a data-manual="dvips" href="https://tug.org/texinfohtml/dvips.html#Top">Introduction</a> in <cite>Dvips</cite>. </li><li> The TeX Users Group: <a href="https://tug.org">https://tug.org</a>. For an introduction to the TeX system, see <a href="https://tug.org/begin.html">https://tug.org/begin.html</a>. @@ -5169,7 +5143,7 @@ Reprinted with corrections, 1996. </li><li> [Lia83] Franklin Mark Liang. -Word hy-phen-a-tion by com-pu-ter. +Word hy-phen-a-tion by com-put-er. Technical Report STAN-CS-83-977, Stanford University, August 1983. <a href="https://tug.org/docs/liang/liang-thesis.pdf">https://tug.org/docs/liang/liang-thesis.pdf</a>. @@ -5187,9 +5161,11 @@ In Robert A. Morris and Jacques Andre, editors, <cite>Raster Imaging and <hr> -<span id="Index"></span><div class="header"> +</div> +<div class="unnumbered" id="Index"> +<div class="header"> <p> -Previous: <a href="#References" accesskey="p" rel="prev">References</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="#References" accesskey="p" rel="prev">References</a>, Up: <a href="#Top" accesskey="u" rel="up">Web2c</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> @@ -5207,13 +5183,17 @@ Previous: <a href="#References" accesskey="p" rel="prev">References</a>, Up: <a <a class="summary-letter" href="#Index_cp_symbol-7"><b>2</b></a> -<a class="summary-letter" href="#Index_cp_symbol-8"><b>8</b></a> +<a class="summary-letter" href="#Index_cp_symbol-8"><b>3</b></a> -<a class="summary-letter" href="#Index_cp_symbol-9"><b>\</b></a> +<a class="summary-letter" href="#Index_cp_symbol-9"><b>6</b></a> -<a class="summary-letter" href="#Index_cp_symbol-10"><b>^</b></a> +<a class="summary-letter" href="#Index_cp_symbol-10"><b>8</b></a> -<a class="summary-letter" href="#Index_cp_symbol-11"><b>~</b></a> +<a class="summary-letter" href="#Index_cp_symbol-11"><b>\</b></a> + +<a class="summary-letter" href="#Index_cp_symbol-12"><b>^</b></a> + +<a class="summary-letter" href="#Index_cp_symbol-13"><b>~</b></a> <br> <a class="summary-letter" href="#Index_cp_letter-A"><b>A</b></a> @@ -5398,12 +5378,18 @@ Previous: <a href="#References" accesskey="p" rel="prev">References</a>, Up: <a <tr><th id="Index_cp_symbol-7">2</th><td></td><td></td></tr> <tr><td></td><td valign="top"><a href="#index-2602gf"><code>2602gf</code></a>:</td><td> </td><td valign="top"><a href="#mf-invocation">mf invocation</a></td></tr> <tr><td colspan="4"> <hr></td></tr> -<tr><th id="Index_cp_symbol-8">8</th><td></td><td></td></tr> +<tr><th id="Index_cp_symbol-8">3</th><td></td><td></td></tr> +<tr><td></td><td valign="top"><a href="#index-32_002dbit-architecture">32-bit architecture</a>:</td><td> </td><td valign="top"><a href="#Hardware-and-memory-dumps">Hardware and memory dumps</a></td></tr> +<tr><td colspan="4"> <hr></td></tr> +<tr><th id="Index_cp_symbol-9">6</th><td></td><td></td></tr> +<tr><td></td><td valign="top"><a href="#index-64_002dbit-architecture">64-bit architecture</a>:</td><td> </td><td valign="top"><a href="#Hardware-and-memory-dumps">Hardware and memory dumps</a></td></tr> +<tr><td colspan="4"> <hr></td></tr> +<tr><th id="Index_cp_symbol-10">8</th><td></td><td></td></tr> <tr><td></td><td valign="top"><a href="#index-8-bit-clean">8 bit clean</a>:</td><td> </td><td valign="top"><a href="#Common-options">Common options</a></td></tr> <tr><td></td><td valign="top"><a href="#index-8-bit-clean-output_002c-specifying"><code>8 bit clean output, specifying</code></a>:</td><td> </td><td valign="top"><a href="#Common-options">Common options</a></td></tr> <tr><td></td><td valign="top"><a href="#index-8_002dbit-characters">8-bit characters</a>:</td><td> </td><td valign="top"><a href="#TCX-files">TCX files</a></td></tr> <tr><td colspan="4"> <hr></td></tr> -<tr><th id="Index_cp_symbol-9">\</th><td></td><td></td></tr> +<tr><th id="Index_cp_symbol-11">\</th><td></td><td></td></tr> <tr><td></td><td valign="top"><a href="#index-_005cbibliography"><code>\bibliography</code></a>:</td><td> </td><td valign="top"><a href="#bibtex-invocation">bibtex invocation</a></td></tr> <tr><td></td><td valign="top"><a href="#index-_005cbibliographystyle"><code>\bibliographystyle</code></a>:</td><td> </td><td valign="top"><a href="#bibtex-invocation">bibtex invocation</a></td></tr> <tr><td></td><td valign="top"><a href="#index-_005ccharsubdef-and-MLTeX"><code>\charsubdef <span class="roman">and MLTeX</span></code></a>:</td><td> </td><td valign="top"><a href="#g_t_005ccharsubdef">\charsubdef</a></td></tr> @@ -5429,10 +5415,10 @@ Previous: <a href="#References" accesskey="p" rel="prev">References</a>, Up: <a <tr><td></td><td valign="top"><a href="#index-_005ctracinglostchars-and-MLTeX"><code>\tracinglostchars <span class="roman">and MLTeX</span></code></a>:</td><td> </td><td valign="top"><a href="#g_t_005ctracingcharsubdef">\tracingcharsubdef</a></td></tr> <tr><td></td><td valign="top"><a href="#index-_005cwrite18-shell-escape-extension"><code>\write18 <span class="roman">shell escape extension</span></code></a>:</td><td> </td><td valign="top"><a href="#Shell-escapes">Shell escapes</a></td></tr> <tr><td colspan="4"> <hr></td></tr> -<tr><th id="Index_cp_symbol-10">^</th><td></td><td></td></tr> +<tr><th id="Index_cp_symbol-12">^</th><td></td><td></td></tr> <tr><td></td><td valign="top"><a href="#index-_005e_005e-notation_002c-avoiding"><code>^^ <span class="roman">notation, avoiding</span></code></a>:</td><td> </td><td valign="top"><a href="#TCX-files">TCX files</a></td></tr> <tr><td colspan="4"> <hr></td></tr> -<tr><th id="Index_cp_symbol-11">~</th><td></td><td></td></tr> +<tr><th id="Index_cp_symbol-13">~</th><td></td><td></td></tr> <tr><td></td><td valign="top"><a href="#index-_007e-expansion-in-filenames"><code>~ <span class="roman">expansion in filenames</span></code></a>:</td><td> </td><td valign="top"><a href="#g_t_005cinput-filename-caveats">\input filename caveats</a></td></tr> <tr><td colspan="4"> <hr></td></tr> <tr><th id="Index_cp_letter-A">A</th><td></td><td></td></tr> @@ -5551,6 +5537,7 @@ Previous: <a href="#References" accesskey="p" rel="prev">References</a>, Up: <a <tr><td></td><td valign="top"><a href="#index-copyright-notices">copyright notices</a>:</td><td> </td><td valign="top"><a href="#Legalisms">Legalisms</a></td></tr> <tr><td></td><td valign="top"><a href="#index-Cork-encoding-and-ISO-input">Cork encoding and ISO input</a>:</td><td> </td><td valign="top"><a href="#TCX-files">TCX files</a></td></tr> <tr><td></td><td valign="top"><a href="#index-creating-memory-dumps">creating memory dumps</a>:</td><td> </td><td valign="top"><a href="#Creating-memory-dumps">Creating memory dumps</a></td></tr> +<tr><td></td><td valign="top"><a href="#index-cross_002dengine-functionality">cross-engine functionality</a>:</td><td> </td><td valign="top"><a href="#TeX-extensions">TeX extensions</a></td></tr> <tr><td></td><td valign="top"><a href="#index-cross_002dreferenced-bibliography-items">cross-referenced bibliography items</a>:</td><td> </td><td valign="top"><a href="#bibtex-invocation">bibtex invocation</a></td></tr> <tr><td></td><td valign="top"><a href="#index-cross_002dreferences_002c-omitting">cross-references, omitting</a>:</td><td> </td><td valign="top"><a href="#weave-invocation">weave invocation</a></td></tr> <tr><td></td><td valign="top"><a href="#index-current-directory_002c-used-for-output">current directory, used for output</a>:</td><td> </td><td valign="top"><a href="#Output-file-location">Output file location</a></td></tr> @@ -5697,7 +5684,9 @@ Previous: <a href="#References" accesskey="p" rel="prev">References</a>, Up: <a <tr><td></td><td valign="top"><a href="#index-help_002c-online">help, online</a>:</td><td> </td><td valign="top"><a href="#Common-options">Common options</a></td></tr> <tr><td></td><td valign="top"><a href="#index-Herberts_002c-Mathias">Herberts, Mathias</a>:</td><td> </td><td valign="top"><a href="#Online-Metafont-graphics">Online Metafont graphics</a></td></tr> <tr><td></td><td valign="top"><a href="#index-hex-character-codes_002c-in-TCX-files">hex character codes, in TCX files</a>:</td><td> </td><td valign="top"><a href="#TCX-files">TCX files</a></td></tr> +<tr><td></td><td valign="top"><a href="#index-HINT-_0028Hint-Is-Not-TeX_0029">HINT (Hint Is Not TeX)</a>:</td><td> </td><td valign="top"><a href="#TeX-extensions">TeX extensions</a></td></tr> <tr><td></td><td valign="top"><a href="#index-history">history</a>:</td><td> </td><td valign="top"><a href="#Introduction">Introduction</a></td></tr> +<tr><td></td><td valign="top"><a href="#index-hiTeX">hiTeX</a>:</td><td> </td><td valign="top"><a href="#TeX-extensions">TeX extensions</a></td></tr> <tr><td></td><td valign="top"><a href="#index-Hobby_002c-John">Hobby, John</a>:</td><td> </td><td valign="top"><a href="#Introduction">Introduction</a></td></tr> <tr><td></td><td valign="top"><a href="#index-horizontal-escapement">horizontal escapement</a>:</td><td> </td><td valign="top"><a href="#pktype-invocation">pktype invocation</a></td></tr> <tr><td></td><td valign="top"><a href="#index-horizontal-escapement-1">horizontal escapement</a>:</td><td> </td><td valign="top"><a href="#gftype-invocation">gftype invocation</a></td></tr> @@ -5774,6 +5763,7 @@ Previous: <a href="#References" accesskey="p" rel="prev">References</a>, Up: <a <tr><td></td><td valign="top"><a href="#index-LittleEndian-machines">LittleEndian machines</a>:</td><td> </td><td valign="top"><a href="#Hardware-and-memory-dumps">Hardware and memory dumps</a></td></tr> <tr><td></td><td valign="top"><a href="#index-location-of-texmf_002ecnf-in-TeX-Live">location of <samp>texmf.cnf</samp> in TeX Live</a>:</td><td> </td><td valign="top"><a href="#Runtime-options">Runtime options</a></td></tr> <tr><td></td><td valign="top"><a href="#index-log-file_002c-BibTeX">log file, BibTeX</a>:</td><td> </td><td valign="top"><a href="#bibtex-invocation">bibtex invocation</a></td></tr> +<tr><td></td><td valign="top"><a href="#index-long-data-type_002c-size-of"><code>long</code> data type, size of</a>:</td><td> </td><td valign="top"><a href="#Hardware-and-memory-dumps">Hardware and memory dumps</a></td></tr> <tr><td></td><td valign="top"><a href="#index-Lua">Lua</a>:</td><td> </td><td valign="top"><a href="#TeX-extensions">TeX extensions</a></td></tr> <tr><td></td><td valign="top"><a href="#index-LuaTeX">LuaTeX</a>:</td><td> </td><td valign="top"><a href="#TeX-extensions">TeX extensions</a></td></tr> <tr><td colspan="4"> <hr></td></tr> @@ -6049,6 +6039,7 @@ Previous: <a href="#References" accesskey="p" rel="prev">References</a>, Up: <a <tr><td></td><td valign="top"><a href="#index-TERM"><code>TERM</code></a>:</td><td> </td><td valign="top"><a href="#Online-Metafont-graphics">Online Metafont graphics</a></td></tr> <tr><td></td><td valign="top"><a href="#index-terminator-for-filenames">terminator for filenames</a>:</td><td> </td><td valign="top"><a href="#g_t_005cinput-filenames">\input filenames</a></td></tr> <tr><td></td><td valign="top"><a href="#index-terse-output">terse output</a>:</td><td> </td><td valign="top"><a href="#bibtex-invocation">bibtex invocation</a></td></tr> +<tr><td></td><td valign="top"><a href="#index-teTeX-distribution">teTeX distribution</a>:</td><td> </td><td valign="top"><a href="#Introduction">Introduction</a></td></tr> <tr><td></td><td valign="top"><a href="#index-tex"><code>tex</code></a>:</td><td> </td><td valign="top"><a href="#tex-invocation">tex invocation</a></td></tr> <tr><td></td><td valign="top"><a href="#index-TeX_002c-bibliographies-for">TeX, bibliographies for</a>:</td><td> </td><td valign="top"><a href="#bibtex-invocation">bibtex invocation</a></td></tr> <tr><td></td><td valign="top"><a href="#index-TeX_002c-creating-from-Metafont">TeX, creating from Metafont</a>:</td><td> </td><td valign="top"><a href="#mft-invocation">mft invocation</a></td></tr> @@ -6085,6 +6076,7 @@ Previous: <a href="#References" accesskey="p" rel="prev">References</a>, Up: <a <tr><td></td><td valign="top"><a href="#index-three-programs">three programs</a>:</td><td> </td><td valign="top"><a href="#Three-programs">Three programs</a></td></tr> <tr><td></td><td valign="top"><a href="#index-time-and-date_002c-in-memory-dumps">time and date, in memory dumps</a>:</td><td> </td><td valign="top"><a href="#Hardware-and-memory-dumps">Hardware and memory dumps</a></td></tr> <tr><td></td><td valign="top"><a href="#index-title-font">title font</a>:</td><td> </td><td valign="top"><a href="#gftodvi-invocation">gftodvi invocation</a></td></tr> +<tr><td></td><td valign="top"><a href="#index-tl_002dcheck_002dfmtshare"><code>tl-check-fmtshare</code></a>:</td><td> </td><td valign="top"><a href="#Hardware-and-memory-dumps">Hardware and memory dumps</a></td></tr> <tr><td></td><td valign="top"><a href="#index-tokenization_002c-and-_005cinput-filenames">tokenization, and <code>\input</code> filenames</a>:</td><td> </td><td valign="top"><a href="#g_t_005cinput-filename-caveats">\input filename caveats</a></td></tr> <tr><td></td><td valign="top"><a href="#index-toolkits_002c-X">toolkits, X</a>:</td><td> </td><td valign="top"><a href="#Online-Metafont-graphics">Online Metafont graphics</a></td></tr> <tr><td></td><td valign="top"><a href="#index-torture-tests">torture tests</a>:</td><td> </td><td valign="top"><a href="#Triptrap">Triptrap</a></td></tr> @@ -6196,13 +6188,17 @@ Previous: <a href="#References" accesskey="p" rel="prev">References</a>, Up: <a <a class="summary-letter" href="#Index_cp_symbol-7"><b>2</b></a> -<a class="summary-letter" href="#Index_cp_symbol-8"><b>8</b></a> +<a class="summary-letter" href="#Index_cp_symbol-8"><b>3</b></a> + +<a class="summary-letter" href="#Index_cp_symbol-9"><b>6</b></a> -<a class="summary-letter" href="#Index_cp_symbol-9"><b>\</b></a> +<a class="summary-letter" href="#Index_cp_symbol-10"><b>8</b></a> -<a class="summary-letter" href="#Index_cp_symbol-10"><b>^</b></a> +<a class="summary-letter" href="#Index_cp_symbol-11"><b>\</b></a> -<a class="summary-letter" href="#Index_cp_symbol-11"><b>~</b></a> +<a class="summary-letter" href="#Index_cp_symbol-12"><b>^</b></a> + +<a class="summary-letter" href="#Index_cp_symbol-13"><b>~</b></a> <br> <a class="summary-letter" href="#Index_cp_letter-A"><b>A</b></a> @@ -6257,7 +6253,8 @@ Previous: <a href="#References" accesskey="p" rel="prev">References</a>, Up: <a </td></tr></table> -<hr> +</div> +</div> diff --git a/Master/texmf-dist/doc/web2c/web2c.pdf b/Master/texmf-dist/doc/web2c/web2c.pdf Binary files differindex 46af522e90d..96953a8c68a 100644 --- a/Master/texmf-dist/doc/web2c/web2c.pdf +++ b/Master/texmf-dist/doc/web2c/web2c.pdf diff --git a/Master/texmf-dist/scripts/texlive/NEWS b/Master/texmf-dist/scripts/texlive/NEWS index f58841e281a..1b5c70be2f4 100644 --- a/Master/texmf-dist/scripts/texlive/NEWS +++ b/Master/texmf-dist/scripts/texlive/NEWS @@ -1,6 +1,9 @@ (This file public domain. Originally written by Norbert Preining and Karl Berry, 2010.) +<p><b>tlmgr 62273 (released 28feb22, pretest):</b> +<li>update description for armhf-linux; fix typos. + <p><b>tlmgr 61401 (released 8feb22):</b> <li>on darwin, use our own curl cert bundle (now updated), to try to avoid cert expiration problems, since Apple will not fix diff --git a/Master/tlpkg/bin/tl-update-bindir b/Master/tlpkg/bin/tl-update-bindir index 7e8026c0449..e68d64709d6 100755 --- a/Master/tlpkg/bin/tl-update-bindir +++ b/Master/tlpkg/bin/tl-update-bindir @@ -201,7 +201,7 @@ for tlplat in $tlplats; do # "Draft a new release"; # use "svnNNNNN" in "Tag version" field, # "Target:trunk" should already be there, - # brief msg from that commit in "title", + # "rNNNNN and perhaps brief msg from commits in "title", # and anything relevant for "description", or leave it blank; # then "Publish release" (not as pre-release, can't be accessed). # After ~30min max, should have new release tarballs at: diff --git a/Master/tlpkg/doc/releng.txt b/Master/tlpkg/doc/releng.txt index b931087ec00..2f94c555902 100644 --- a/Master/tlpkg/doc/releng.txt +++ b/Master/tlpkg/doc/releng.txt @@ -213,7 +213,7 @@ we won't be installing binaries from a build. on texlive/index.html and tug's home page (at least). Email tex-live@tug.org. - + A. At some point during the pretest: Update gpg expiration, see tlpkg/gpg/tl-key-extension.txt; do not fail to do this, or the key will expire and cause lots of hassle. @@ -221,8 +221,9 @@ A. At some point during the pretest: In Master/tlpkg, update bundled Windows programs as needed: dviout texworks tlgs tlperl tlpsv In tlpkg/installer, update xz lz4 wget if needed (+ Master/source). - Update readme-html.dir/readme.en.html if needed, - run tlpkg/bin/htmltext to create readme-txt.dir/README.EN. + Update readme-html.dir/readme.en.html if needed (hopefully not), + run tlpkg/bin/htmltext to create readme-txt.dir/README.EN + and tell tldoc / all translators to update. B. Specifics for tlperl update: cd $pg @@ -260,12 +261,12 @@ M. As pretest proceeds, update the doc: Update tlbuild.texi text, then W=.../Build/source/Work make -C $W/doc script-links tlbuild-incl.texi readme-files readme-install - cd .../Build/source + #cd .../Build/source Consider updates of core man pages in Build/source/texk/web2c/man. - Remake updmap,fmtutil man pages with help2man: + Remake updmap,fmtutil man pages with help2man (install latest from source): tm=.../Master make -C $W/texk/texlive/tl_support xupdmap.1 xfmtutil.1 - x1=`(unset CDPATH; cd $Master/texmf-dist/doc/man/man1; pwd)` + x1=`(unset CDPATH; cd $tm/texmf-dist/doc/man/man1; pwd)` They must be moved from /tmp into Master by hand: mv /tmp/xupdmap.1 $x1/updmap.1 mv /tmp/xfmtutil.1 $x1/fmtutil.1 @@ -273,6 +274,7 @@ M. As pretest proceeds, update the doc: groff -mandoc -Thtml $x1/updmap.1 >$lw/doc/updmap.html groff -mandoc -Thtml $x1/fmtutil.1 >$lw/doc/fmtutil.html While we're here, let's update the other generated html files: + xx=$tm/texmf-dist/scripts/texlive pod2html --cachedir=/tmp $xx/tlmgr.pl >$lw/doc/tlmgr.html pod2html --cachedir=/tmp $tm/install-tl >$lw/doc/install-tl.html Update copies in the Master tree (also done nightly in tl-update-auto): @@ -280,10 +282,9 @@ M. As pretest proceeds, update the doc: Man pages from Build to Master (after doing a build): tl-update-man # consider removals from output, if any binaries are gone # check /tmp/so.rules against man1/Makefile, update if needed. - cd $x1/.. - make # remakes pdfs + make -C $x1/.. # remakes pdfs # files to add: - svn status . | sed -n 's/^\?//p' + svn status $x1 | sed -n 's/^\?//p' svn add `!!` Texinfo manuals from Build to Master: tl-update-txi |