diff options
Diffstat (limited to 'Master/texmf-dist/doc')
| -rw-r--r-- | Master/texmf-dist/doc/dvipng/dvipng.html | 12 | ||||
| -rw-r--r-- | Master/texmf-dist/doc/dvipng/dvipng.pdf | bin | 220307 -> 220376 bytes | |||
| -rw-r--r-- | Master/texmf-dist/doc/dvips/dvips.html | 111 | ||||
| -rw-r--r-- | Master/texmf-dist/doc/dvips/dvips.pdf | bin | 405527 -> 412092 bytes | |||
| -rw-r--r-- | Master/texmf-dist/doc/info/dvipng.info | 45 | ||||
| -rw-r--r-- | Master/texmf-dist/doc/info/dvips.info | 636 | ||||
| -rw-r--r-- | Master/texmf-dist/doc/info/kpathsea.info | 353 | ||||
| -rw-r--r-- | Master/texmf-dist/doc/info/tlbuild.info | 1580 | ||||
| -rw-r--r-- | Master/texmf-dist/doc/info/web2c.info | 326 | ||||
| -rw-r--r-- | Master/texmf-dist/doc/kpathsea/kpathsea.html | 231 | ||||
| -rw-r--r-- | Master/texmf-dist/doc/kpathsea/kpathsea.pdf | bin | 301846 -> 402446 bytes | |||
| -rw-r--r-- | Master/texmf-dist/doc/texlive/tlbuild/tlbuild.html | 887 | ||||
| -rw-r--r-- | Master/texmf-dist/doc/texlive/tlbuild/tlbuild.pdf | bin | 496534 -> 508822 bytes | |||
| -rw-r--r-- | Master/texmf-dist/doc/web2c/web2c.html | 270 | ||||
| -rw-r--r-- | Master/texmf-dist/doc/web2c/web2c.pdf | bin | 464712 -> 469172 bytes |
15 files changed, 2805 insertions, 1646 deletions
diff --git a/Master/texmf-dist/doc/dvipng/dvipng.html b/Master/texmf-dist/doc/dvipng/dvipng.html index 5125d4c479e..9ca5f52f442 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.6, http://www.gnu.org/software/texinfo/ --> +<!-- 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>A DVI-to-PNG translator</title> @@ -84,7 +84,7 @@ ul.no-bullet {list-style: none} </ul></li> <li><a id="toc-Credits-1" href="#Credits">8 Credits</a></li> <li><a id="toc-Copying-1" href="#Copying">9 Copying</a></li> - <li><a id="toc-Index-1" href="#Index">Index</a></li> + <li><a id="toc-Index-1" href="#Index" rel="index">Index</a></li> </ul> </div> @@ -98,7 +98,7 @@ Next: <a href="#Introduction" accesskey="n" rel="next">Introduction</a>, Up: <a <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.16 +<p>This file documents dvipng version 1.17 </p> <p>Corrections or perhaps rewrites of sections are <em>very welcome</em>. </p> @@ -124,7 +124,7 @@ Independent) file into PNG (Portable Network Graphics). </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">Index</a></td><td> </td><td align="left" valign="top">General index +<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> @@ -472,7 +472,7 @@ Next: <a href="#Option-details" accesskey="n" rel="next">Option details</a>, Up: dvipng with no arguments or with the standard ‘<samp>--help</samp>’ option. </p> <div class="example"> -<pre class="example">This is ./dvipng 1.16 Copyright 2002-2015, 2019 Jan-Ake Larsson +<pre class="example">This is ./dvipng 1.17 Copyright 2002-2015, 2019 Jan-Ake Larsson Usage: ./dvipng [OPTION]... FILENAME[.dvi] Options are chosen to be similar to dvips' options where possible: @@ -1285,7 +1285,7 @@ Georg Schwarz, Jason Farmer, Brian V. Smith, Samuel Hathaway, Thomas R. Shemanske, Stephen Gibson, Christian Ridderström, Ezra Peisach, William H Wheeler, Thomas Klausner, Harald Koenig, Adrian Bunk, Kevin Smith, Jason Riedy, Wolfram Krause, Reinhard Kotucha, Takeshi Abe, -Waldeck Schutzer, and Andy Nguyen. +Waldeck Schutzer, Ahzo, and Andy Nguyen. </p> <hr> diff --git a/Master/texmf-dist/doc/dvipng/dvipng.pdf b/Master/texmf-dist/doc/dvipng/dvipng.pdf Binary files differindex 08d644f0d37..e85e38e0ea4 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 c090e788a65..568dbae14b4 100644 --- a/Master/texmf-dist/doc/dvips/dvips.html +++ b/Master/texmf-dist/doc/dvips/dvips.html @@ -1,9 +1,9 @@ <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd"> <html> -<!-- This manual documents Dvips version 5.999 -(February 2019), a program to translate a DVI file into +<!-- This manual documents Dvips version 2020.1 +(January 2020), a program to translate a DVI file into PostScript. You may freely use, modify and/or distribute this file. --> -<!-- Created by GNU Texinfo 6.6, http://www.gnu.org/software/texinfo/ --> +<!-- 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>Dvips: A DVI-to-PostScript translator</title> @@ -60,7 +60,7 @@ ul.no-bullet {list-style: none} <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">Index</a></li> +<li><a id="stoc-Index-1" href="#toc-Index-1" rel="index">Index</a></li> </ul> </div> @@ -150,7 +150,8 @@ ul.no-bullet {list-style: none} <li><a id="toc-Glyph-files-1" href="#Glyph-files">6.1.2 Glyph files</a></li> <li><a id="toc-Virtual-fonts-1" href="#Virtual-fonts">6.1.3 Virtual fonts</a></li> <li><a id="toc-Encodings-1" href="#Encodings">6.1.4 Encodings</a></li> - <li><a id="toc-How-PostScript-typesets-a-character" href="#PostScript-typesetting">6.1.5 How PostScript typesets a character</a></li> + <li><a id="toc-Bitmap-font-encodings-1" href="#Bitmap-font-encodings">6.1.5 Bitmap font encodings</a></li> + <li><a id="toc-How-PostScript-typesets-a-character" href="#PostScript-typesetting">6.1.6 How PostScript typesets a character</a></li> </ul></li> <li><a id="toc-Making-a-PostScript-font-available" href="#Making-a-font-available">6.2 Making a PostScript font available</a></li> <li><a id="toc-Invoking-Afm2tfm" href="#Invoking-afm2tfm">6.3 Invoking Afm2tfm</a> @@ -181,7 +182,7 @@ ul.no-bullet {list-style: none} <li><a id="toc-Color-specials-1" href="#Color-specials">7.6.2 Color specials</a></li> </ul></li> </ul></li> - <li><a id="toc-Index-1" href="#Index">Index</a></li> + <li><a id="toc-Index-1" href="#Index" rel="index">Index</a></li> </ul> </div> @@ -192,8 +193,8 @@ Next: <a href="#Why-Dvips" accesskey="n" rel="next">Why Dvips</a>, Up: <a href=" </div> <span id="Dvips"></span><h1 class="top">Dvips</h1> -<p>This manual documents Dvips version 5.999 -(February 2019), a program to translate a DVI file into +<p>This manual documents Dvips version 2020.1 +(January 2020), 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"> @@ -211,7 +212,7 @@ PostScript. You may freely use, modify and/or distribute this file. </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" accesskey="8">Index</a></td><td> </td><td align="left" valign="top">General index. +<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> @@ -927,6 +928,14 @@ do color separations or other neat tricks. 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> +<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> @@ -1757,6 +1766,13 @@ There is no provision for continuation lines. <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 +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 @@ -3683,7 +3699,9 @@ i.e., renumbers, the characters of a font. </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="#PostScript-typesetting" accesskey="5">PostScript typesetting</a></td><td> </td><td align="left" valign="top">How PostScript typesets a character. +<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> @@ -3882,7 +3900,7 @@ using a DVI translator that doesn’t understand vf’s itself. <hr> <span id="Encodings"></span><div class="header"> <p> -Next: <a href="#PostScript-typesetting" accesskey="n" rel="next">PostScript typesetting</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> +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> <span id="Encodings-1"></span><h4 class="subsection">6.1.4 Encodings</h4> @@ -3941,11 +3959,69 @@ italics, and <samp>texmsym.enc</samp> for math symbols. </p> <hr> +<span id="Bitmap-font-encodings"></span><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> +</div> +<span id="Bitmap-font-encodings-1"></span><h4 class="subsection">6.1.5 Bitmap font encodings</h4> + +<span id="index-bitmap-font-encodings"></span> +<span id="index-font-encodings_002c-bitmap"></span> +<span id="index-encodings_002c-for-bitmap-fonts"></span> + +<p>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. +</p> +<p>Unlike previous versions, dvips versions 2020 and later add glyph +naming information to Type 3 bitmapped fonts (if they can locate such +information) as an Encoding vector. This provides some support for +search, for copy and paste, and even some limited support for +accessibility. The ‘<samp>bitmapfontenc</samp>’ command line option +(see <a href="#Option-details">Option details</a> and <code>bitmapfontenc</code> configuration option +(see <a href="#Configuration-file-commands">Configuration file commands</a>) enable and disable this +functionality; by default it is set to enabled, without warnings. +</p> +<span id="index-dvips_002dall_002eenc"></span> +<p>To do this, dvips must find encoding information for the bitmapped +fonts. It does this by first searching for a font-specific encoding +file; for instance, for cmr10, it will search for <samp>dvips-cmr10.enc</samp> +in the standard encoding path. If it does not find such a file, it +will search for a <samp>dvips-all.enc</samp> file which contains a base set of +encodings for many fonts. +</p> +<p>The specific syntax of an encoding file is unspecified, except that it +must be a PostScript fragment that leaves exactly one object on the +operand stack. (This is different from the encoding files used to +define encodings for PostScript fonts, described earlier). Normally +that object is just an array of 256 names; in this case, that array is +used as the encoding vector for the font. Alternatively, the object +can be a procedure that, when executed, leaves a legal encoding vector +on the stack. This second option is made available to support future +enhancements that may add additional constructs to the font dictionary +to enhance the interpretation of font characters. +</p> +<p>The <samp>dvips-all.enc</samp> file contains encodings for many fonts, and +it is loaded by dvips at most once. The format is just a sequence of +font names, one per line, each terminated by a colon, followed by the +encoding to use for those files. +</p> +<span id="index-bounding-box_002c-for-bitmap-fonts"></span> +<span id="index-coordinate-system_002c-for-bitmap-fonts"></span> +<p>As part of its operation, to enable heuristics in PostScript and +PDF viewers to properly identify word breaks and column gutters, +dvips also generates a modified font bounding box and a modified +font coordinate system. +</p> + +<hr> <span id="PostScript-typesetting"></span><div class="header"> <p> -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> +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> -<span id="How-PostScript-typesets-a-character"></span><h4 class="subsection">6.1.5 How PostScript typesets a character</h4> +<span id="How-PostScript-typesets-a-character"></span><h4 class="subsection">6.1.6 How PostScript typesets a character</h4> <span id="index-typesetting-in-PostScript"></span> <span id="index-character-lookup-procedure-in-PostScript"></span> @@ -5427,6 +5503,7 @@ Previous: <a href="#Color" accesskey="p" rel="prev">Color</a>, Up: <a href="#Top <tr><td></td><td valign="top"><a href="#index-_002da-1"><code>-a</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-_002dB"><code>-B</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-_002db-num"><code>-b <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-_002dbitmapfontenc-option"><code>-bitmapfontenc <var>option</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-_002dc-num"><code>-c <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-_002dC-num"><code>-C <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-_002dc-ratio"><code>-c <var>ratio</var></code></a>:</td><td> </td><td valign="top"><a href="#Afm2tfm-options">Afm2tfm options</a></td></tr> @@ -5586,7 +5663,10 @@ Previous: <a href="#Color" accesskey="p" rel="prev">Color</a>, Up: <a href="#Top <tr><td></td><td valign="top"><a href="#index-Bhattacharya_002c-Tanmoy">Bhattacharya, Tanmoy</a>:</td><td> </td><td valign="top"><a href="#Hypertext">Hypertext</a></td></tr> <tr><td></td><td valign="top"><a href="#index-big-points">big points</a>:</td><td> </td><td valign="top"><a href="#Bounding-box">Bounding box</a></td></tr> <tr><td></td><td valign="top"><a href="#index-binary-files_002c-not-supported">binary files, not supported</a>:</td><td> </td><td valign="top"><a href="#Including-graphics-fails">Including graphics fails</a></td></tr> +<tr><td></td><td valign="top"><a href="#index-bitmap-font-encoding">bitmap font encoding</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-bitmap-font-encodings">bitmap font encodings</a>:</td><td> </td><td valign="top"><a href="#Bitmap-font-encodings">Bitmap font encodings</a></td></tr> <tr><td></td><td valign="top"><a href="#index-bitmap-fonts">bitmap fonts</a>:</td><td> </td><td valign="top"><a href="#Glyph-files">Glyph files</a></td></tr> +<tr><td></td><td valign="top"><a href="#index-bitmapfontenc-config-command-_0028bitmap-font-encoding_0029"><code>bitmapfontenc <span class="roman">config command (bitmap font encoding)</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-bop-undefined-error"><tt>bop undefined</tt> error</a>:</td><td> </td><td valign="top"><a href="#Printer-errors">Printer errors</a></td></tr> <tr><td></td><td valign="top"><a href="#index-bop_002dhook"><code>bop-hook</code></a>:</td><td> </td><td valign="top"><a href="#Paper-trays">Paper trays</a></td></tr> <tr><td></td><td valign="top"><a href="#index-bop_002dhook-1"><code>bop-hook</code></a>:</td><td> </td><td valign="top"><a href="#EPSF-scaling">EPSF scaling</a></td></tr> @@ -5597,6 +5677,7 @@ Previous: <a href="#Color" accesskey="p" rel="prev">Color</a>, Up: <a href="#Top <tr><td></td><td valign="top"><a href="#index-bounding-box_002c-defined">bounding box, defined</a>:</td><td> </td><td valign="top"><a href="#Bounding-box">Bounding box</a></td></tr> <tr><td></td><td valign="top"><a href="#index-bounding-box_002c-determining">bounding box, determining</a>:</td><td> </td><td valign="top"><a href="#Bounding-box">Bounding box</a></td></tr> <tr><td></td><td valign="top"><a href="#index-bounding-box_002c-finding-tight">bounding box, finding tight</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-bounding-box_002c-for-bitmap-fonts">bounding box, for bitmap fonts</a>:</td><td> </td><td valign="top"><a href="#Bitmap-font-encodings">Bitmap font encodings</a></td></tr> <tr><td></td><td valign="top"><a href="#index-bounding-box_002c-inaccurate">bounding box, inaccurate</a>:</td><td> </td><td valign="top"><a href="#EPSF-clipping">EPSF clipping</a></td></tr> <tr><td></td><td valign="top"><a href="#index-bounding-box_002c-supplying-to-TeX">bounding box, supplying to TeX</a>:</td><td> </td><td valign="top"><a href="#g_t_005cincludegraphics">\includegraphics</a></td></tr> <tr><td></td><td valign="top"><a href="#index-bounding-box_002c-supplying-to-TeX-1">bounding box, supplying to TeX</a>:</td><td> </td><td valign="top"><a href="#EPSF-macros">EPSF macros</a></td></tr> @@ -5648,6 +5729,7 @@ Previous: <a href="#Color" accesskey="p" rel="prev">Color</a>, Up: <a href="#Top <tr><td></td><td valign="top"><a href="#index-configuration_002c-of-Dvips">configuration, of Dvips</a>:</td><td> </td><td valign="top"><a href="#Installation">Installation</a></td></tr> <tr><td></td><td valign="top"><a href="#index-continuation-lines_002c-not-supported">continuation lines, not supported</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-control_002dD">control-D</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-coordinate-system_002c-for-bitmap-fonts">coordinate system, for bitmap fonts</a>:</td><td> </td><td valign="top"><a href="#Bitmap-font-encodings">Bitmap font encodings</a></td></tr> <tr><td></td><td valign="top"><a href="#index-copies_002c-collated">copies, collated</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-copies_002c-duplicated-page-bodies">copies, duplicated page bodies</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-copies_002c-uncollated">copies, uncollated</a>:</td><td> </td><td valign="top"><a href="#Option-details">Option details</a></td></tr> @@ -5684,6 +5766,7 @@ Previous: <a href="#Color" accesskey="p" rel="prev">Color</a>, Up: <a href="#Top <tr><td></td><td valign="top"><a href="#index-DVI-magnification">DVI magnification</a>:</td><td> </td><td valign="top"><a href="#EPSF-scaling">EPSF scaling</a></td></tr> <tr><td></td><td valign="top"><a href="#index-dvihps_002c-hyperdvi-to-PostScript"><code>dvihps<span class="roman">, hyperdvi to PostScript</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-Dvips-configuration-file-options">Dvips configuration file options</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-dvips_002dall_002eenc"><code>dvips-all.enc</code></a>:</td><td> </td><td valign="top"><a href="#Bitmap-font-encodings">Bitmap font encodings</a></td></tr> <tr><td></td><td valign="top"><a href="#index-dvips_002eenc"><code>dvips.enc</code></a>:</td><td> </td><td valign="top"><a href="#Encodings">Encodings</a></td></tr> <tr><td></td><td valign="top"><a href="#index-DVIPSDEBUG"><code>DVIPSDEBUG</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-DVIPSFONTS"><code>DVIPSFONTS</code></a>:</td><td> </td><td valign="top"><a href="#Environment-variables">Environment variables</a></td></tr> @@ -5708,6 +5791,7 @@ Previous: <a href="#Color" accesskey="p" rel="prev">Color</a>, Up: <a href="#Top <tr><td></td><td valign="top"><a href="#index-encoding-vectors_002c-defined">encoding vectors, defined</a>:</td><td> </td><td valign="top"><a href="#Encodings">Encodings</a></td></tr> <tr><td></td><td valign="top"><a href="#index-encoding-vectors_002c-in-Type-1-fonts">encoding vectors, in Type 1 fonts</a>:</td><td> </td><td valign="top"><a href="#PostScript-typesetting">PostScript typesetting</a></td></tr> <tr><td></td><td valign="top"><a href="#index-encodings">encodings</a>:</td><td> </td><td valign="top"><a href="#Encodings">Encodings</a></td></tr> +<tr><td></td><td valign="top"><a href="#index-encodings_002c-for-bitmap-fonts">encodings, for bitmap fonts</a>:</td><td> </td><td valign="top"><a href="#Bitmap-font-encodings">Bitmap font encodings</a></td></tr> <tr><td></td><td valign="top"><a href="#index-end_002dhook"><code>end-hook</code></a>:</td><td> </td><td valign="top"><a href="#PostScript-hooks">PostScript hooks</a></td></tr> <tr><td></td><td valign="top"><a href="#index-environment-variables">environment variables</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-EOF">EOF</a>:</td><td> </td><td valign="top"><a href="#Option-details">Option details</a></td></tr> @@ -5743,6 +5827,7 @@ Previous: <a href="#Color" accesskey="p" rel="prev">Color</a>, Up: <a href="#Top <tr><td></td><td valign="top"><a href="#index-filter_002c-running-as-a">filter, running as a</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-first-page-printed">first 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-font-concepts">font concepts</a>:</td><td> </td><td valign="top"><a href="#Font-concepts">Font concepts</a></td></tr> +<tr><td></td><td valign="top"><a href="#index-font-encodings_002c-bitmap">font encodings, bitmap</a>:</td><td> </td><td valign="top"><a href="#Bitmap-font-encodings">Bitmap font encodings</a></td></tr> <tr><td></td><td valign="top"><a href="#index-font-generation_002c-avoiding">font generation, avoiding</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-fontinst"><code>fontinst</code></a>:</td><td> </td><td valign="top"><a href="#Invoking-afm2tfm">Invoking afm2tfm</a></td></tr> <tr><td></td><td valign="top"><a href="#index-fonts_002c-as-header-files">fonts, as header files</a>:</td><td> </td><td valign="top"><a href="#Including-headers-from-TeX">Including headers from TeX</a></td></tr> diff --git a/Master/texmf-dist/doc/dvips/dvips.pdf b/Master/texmf-dist/doc/dvips/dvips.pdf Binary files differindex 7f9608ceec8..abd3c89a656 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/dvipng.info b/Master/texmf-dist/doc/info/dvipng.info index 9e6f488afc6..142b5b9f9e4 100644 --- a/Master/texmf-dist/doc/info/dvipng.info +++ b/Master/texmf-dist/doc/info/dvipng.info @@ -1,4 +1,4 @@ -This is dvipng.info, produced by makeinfo version 6.6 from dvipng.texi. +This is dvipng.info, produced by makeinfo version 5.1 from dvipng.texi. INFO-DIR-SECTION TeX START-INFO-DIR-ENTRY @@ -15,7 +15,7 @@ dvipng This manual documents dvipng, a program to translate a DVI (DeVice Independent) file into PNG (Portable Network Graphics). - This file documents dvipng version 1.16 + This file documents dvipng version 1.17 Corrections or perhaps rewrites of sections are _very welcome_. @@ -315,7 +315,7 @@ File: dvipng.info, Node: Option summary, Next: Option details, Up: Command-li Here is a handy summary of the options; it is printed out when you run dvipng with no arguments or with the standard '--help' option. - This is ./dvipng 1.16 Copyright 2002-2015, 2019 Jan-Ake Larsson + This is ./dvipng 1.17 Copyright 2002-2015, 2019 Jan-Ake Larsson Usage: ./dvipng [OPTION]... FILENAME[.dvi] Options are chosen to be similar to dvips' options where possible: @@ -358,7 +358,6 @@ dvipng with no arguments or with the standard '--help' option. # = number f = file s = string * = suffix, '0' to turn off c = comma-separated dimension pair (e.g., 3.2in,-32.1cm) - File: dvipng.info, Node: Option details, Prev: Option summary, Up: Command-line options @@ -962,7 +961,7 @@ Bernhard Simon, Bob McElrath, Georg Schwarz, Jason Farmer, Brian V. Smith, Samuel Hathaway, Thomas R. Shemanske, Stephen Gibson, Christian Ridderstro"m, Ezra Peisach, William H Wheeler, Thomas Klausner, Harald Koenig, Adrian Bunk, Kevin Smith, Jason Riedy, Wolfram Krause, Reinhard -Kotucha, Takeshi Abe, Waldeck Schutzer, and Andy Nguyen. +Kotucha, Takeshi Abe, Waldeck Schutzer, Ahzo, and Andy Nguyen. File: dvipng.info, Node: Copying, Next: Index, Prev: Credits, Up: Top @@ -998,8 +997,8 @@ Index * Menu: * -dSAFER: Option details. (line 167) -* absolute page number, and -l: Option details. (line 141) -* absolute page number, and -p: Option details. (line 194) +* absolute page number, and '-l': Option details. (line 141) +* absolute page number, and '-p': Option details. (line 194) * antialiasing levels, number of: Option details. (line 247) * background color (option): Option details. (line 40) * base resolution, setting: Option details. (line 33) @@ -1049,8 +1048,8 @@ Index * page range: Option details. (line 225) * page, first printed: Option details. (line 194) * page, last printed: Option details. (line 141) -* physical page number, and -l: Option details. (line 141) -* physical page number, and -p: Option details. (line 194) +* physical page number, and '-l': Option details. (line 141) +* physical page number, and '-p': Option details. (line 194) * PNG image format: Option details. (line 221) * PostScript inclusion problems: Encapsulated PostScript. (line 21) @@ -1084,19 +1083,19 @@ Node: Advice for non-privileged users9047 Node: Basic usage10058 Node: Command-line options11202 Node: Option summary11625 -Node: Option details13994 -Node: Graphics29168 -Node: Encapsulated PostScript29923 -Node: Bitmapped graphics31273 -Node: Raw PostScript32501 -Node: Color34754 -Node: Color specifications35143 -Node: Color specials36246 -Node: Diagnosing problems37663 -Node: Contact information38147 -Node: Debug options38875 -Node: Credits39864 -Node: Copying41083 -Node: Index41870 +Node: Option details13993 +Node: Graphics29167 +Node: Encapsulated PostScript29922 +Node: Bitmapped graphics31272 +Node: Raw PostScript32500 +Node: Color34753 +Node: Color specifications35142 +Node: Color specials36245 +Node: Diagnosing problems37662 +Node: Contact information38146 +Node: Debug options38874 +Node: Credits39863 +Node: Copying41088 +Node: Index41875 End Tag Table diff --git a/Master/texmf-dist/doc/info/dvips.info b/Master/texmf-dist/doc/info/dvips.info index e4e99c5ec26..9556053fede 100644 --- a/Master/texmf-dist/doc/info/dvips.info +++ b/Master/texmf-dist/doc/info/dvips.info @@ -1,6 +1,6 @@ -This is dvips.info, produced by makeinfo version 6.5 from dvips.texi. +This is dvips.info, produced by makeinfo version 6.7 from dvips.texi. -This manual documents Dvips version 5.999 (February 2019), a program to +This manual documents Dvips version 2020.1 (January 2020), a program to translate a DVI file into PostScript. You may freely use, modify and/or distribute this file. INFO-DIR-SECTION TeX @@ -16,7 +16,7 @@ File: dvips.info, Node: Top, Next: Why Dvips, Up: (dir) Dvips ***** -This manual documents Dvips version 5.999 (February 2019), a program to +This manual documents Dvips version 2020.1 (January 2020), a program to translate a DVI file into PostScript. You may freely use, modify and/or distribute this file. @@ -559,6 +559,11 @@ reversal, use '-r0'. Such options are marked with a trailing '*'. Print only the even pages. This option uses TeX page numbers, not physical page numbers. +'-bitmapfontenc OPTION' + Turns bitmap font encoding to 'off', 'on' (no warnings for missing + bitmap font encodings), or 'strict' (with warnings for missing + bitmap font encodings). + '-c NUM' Generate NUM consecutive copies of every page, i.e., the output is uncollated. This merely sets the builtin PostScript variable @@ -1119,6 +1124,11 @@ There is no provision for continuation lines. 'b #COPIES' Multiple copies. Same as '-b', *note Option details::. +'bitmapfontenc OPTION' + Turns bitmap font encoding to 'off', 'on' (no warnings for missing + bitmap font encodings), or 'strict' (with warnings for missing + bitmap font encodings). + 'c FILENAME' Include FILENAME as an additional configuration file, read immediately. @@ -2495,6 +2505,7 @@ i.e., renumbers, the characters of a font. * Glyph files:: Character shapes. * Virtual fonts:: Constructing one font from others. * Encodings:: Character codes and character names. +* Bitmap font encodings:: Encodings for bitmapped fonts. * PostScript typesetting:: How PostScript typesets a character. @@ -2639,7 +2650,7 @@ when you run 'vptovf'. DVI translator that doesn't understand vf's itself. -File: dvips.info, Node: Encodings, Next: PostScript typesetting, Prev: Virtual fonts, Up: Font concepts +File: dvips.info, Node: Encodings, Next: Bitmap font encodings, Prev: Virtual fonts, Up: Font concepts 6.1.4 Encodings --------------- @@ -2684,9 +2695,58 @@ mathematics fonts: 'texmext.enc' for math extensions, 'texmital.enc' for math italics, and 'texmsym.enc' for math symbols. -File: dvips.info, Node: PostScript typesetting, Prev: Encodings, Up: Font concepts +File: dvips.info, Node: Bitmap font encodings, Next: PostScript typesetting, Prev: Encodings, Up: Font concepts + +6.1.5 Bitmap font encodings +--------------------------- + +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. + + Unlike previous versions, dvips versions 2020 and later add glyph +naming information to Type 3 bitmapped fonts (if they can locate such +information) as an Encoding vector. This provides some support for +search, for copy and paste, and even some limited support for +accessibility. The 'bitmapfontenc' command line option (*note Option +details:: and 'bitmapfontenc' configuration option (*note Configuration +file commands::) enable and disable this functionality; by default it is +set to enabled, without warnings. + + To do this, dvips must find encoding information for the bitmapped +fonts. It does this by first searching for a font-specific encoding +file; for instance, for cmr10, it will search for 'dvips-cmr10.enc' in +the standard encoding path. If it does not find such a file, it will +search for a 'dvips-all.enc' file which contains a base set of encodings +for many fonts. + + The specific syntax of an encoding file is unspecified, except that +it must be a PostScript fragment that leaves exactly one object on the +operand stack. (This is different from the encoding files used to +define encodings for PostScript fonts, described earlier). Normally +that object is just an array of 256 names; in this case, that array is +used as the encoding vector for the font. Alternatively, the object can +be a procedure that, when executed, leaves a legal encoding vector on +the stack. This second option is made available to support future +enhancements that may add additional constructs to the font dictionary +to enhance the interpretation of font characters. + + The 'dvips-all.enc' file contains encodings for many fonts, and it is +loaded by dvips at most once. The format is just a sequence of font +names, one per line, each terminated by a colon, followed by the +encoding to use for those files. + + As part of its operation, to enable heuristics in PostScript and PDF +viewers to properly identify word breaks and column gutters, dvips also +generates a modified font bounding box and a modified font coordinate +system. + + +File: dvips.info, Node: PostScript typesetting, Prev: Bitmap font encodings, Up: Font concepts -6.1.5 How PostScript typesets a character +6.1.6 How PostScript typesets a character ----------------------------------------- The output of Dvips is a program in the PostScript language that @@ -3710,12 +3770,12 @@ Index * Menu: * ! special (literal PS header): Literal headers. (line 6) -* ! starting output filename: Option details. (line 242) +* ! starting output filename: Option details. (line 247) * " 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 207) -* %%Page, removing: Option details. (line 160) +* %%Page, not generating: Option details. (line 212) +* %%Page, removing: Option details. (line 165) * %%Page, required by Ghostview: Ghostscript installation. (line 12) * %%VMusage: Headers and memory usage. @@ -3723,9 +3783,9 @@ Index * %*Font: Fonts in figures. (line 6) * (atend), bounding box specification: Bounding box. (line 28) * +PSMAPFILE: Configuration file commands. - (line 121) + (line 126) * -: Option details. (line 11) -* - as output filename: Option details. (line 242) +* - as output filename: Option details. (line 247) * --help: Option summary. (line 7) * --help <1>: Option details. (line 15) * --version: Option details. (line 18) @@ -3734,72 +3794,73 @@ Index * -a <1>: Afm2tfm options. (line 33) * -B: Option details. (line 37) * -b NUM: Option details. (line 31) -* -c NUM: Option details. (line 41) -* -C NUM: Option details. (line 46) +* -bitmapfontenc OPTION: Option details. (line 41) +* -c NUM: Option details. (line 46) +* -C NUM: Option details. (line 51) * -c RATIO: Afm2tfm options. (line 43) -* -d NUM: Option details. (line 52) -* -D NUM: Option details. (line 58) -* -E: Option details. (line 82) -* -e NUM: Option details. (line 71) +* -d NUM: Option details. (line 57) +* -D NUM: Option details. (line 63) +* -E: Option details. (line 87) +* -e NUM: Option details. (line 76) * -e RATIO: Afm2tfm options. (line 47) -* -f: Option details. (line 98) -* -F: Option details. (line 110) -* -G: Option details. (line 117) -* -h NAME: Option details. (line 122) -* -i: Option details. (line 127) -* -j for partial font downloading: Option details. (line 146) -* -K: Option details. (line 160) -* -k for cropmarks: Option details. (line 152) -* -L: Option details. (line 178) -* -l [=]NUM: Option details. (line 169) -* -m: Option details. (line 182) -* -M: Option details. (line 194) -* -mode: Option details. (line 185) -* -mode MODE: Option details. (line 185) -* -N: Option details. (line 207) -* -n NUM: Option details. (line 204) -* -noomega: Option details. (line 215) -* -noptex: Option details. (line 221) +* -f: Option details. (line 103) +* -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: Option details. (line 190) +* -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) * -O: Afm2tfm options. (line 51) -* -o NAME: Option details. (line 237) -* -O X-OFFSET,Y-OFFSET: Option details. (line 254) -* -P PRINTER: Option details. (line 286) +* -o NAME: Option details. (line 242) +* -O X-OFFSET,Y-OFFSET: Option details. (line 259) +* -P PRINTER: Option details. (line 291) * -p PS-ENC: Changing PostScript encodings. (line 6) * -p PS-ENC <1>: Afm2tfm options. (line 56) -* -p [=]NUM: Option details. (line 272) -* -pp FIRST-LAST: Option details. (line 281) -* -pp RANGE: Option details. (line 281) +* -p [=]NUM: Option details. (line 277) +* -pp FIRST-LAST: Option details. (line 286) +* -pp RANGE: Option details. (line 286) * -PPRINTER, and config file searching: Configuration file searching. (line 27) -* -q: Option details. (line 305) -* -r: Option details. (line 309) -* -R: Option details. (line 312) -* -s: Option details. (line 320) -* -S NUM: Option details. (line 327) +* -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) * -s SLANT: Afm2tfm options. (line 61) * -T ENC-FILE: Changing both encodings. (line 6) -* -T HSIZE,VSIZE: Option details. (line 352) -* -t PAPERTYPE: Option details. (line 332) +* -T HSIZE,VSIZE: Option details. (line 357) +* -t PAPERTYPE: Option details. (line 337) * -T PS-TEX-ENC: Afm2tfm options. (line 71) * -t TEX-ENC: Changing TeX encodings. (line 6) * -t TEX-ENC <1>: Afm2tfm options. (line 66) -* -U: Option details. (line 367) +* -U: Option details. (line 372) * -u: Afm2tfm options. (line 75) -* -u PSMAPFILE: Option details. (line 359) -* -v: Option details. (line 375) -* -V: Option details. (line 378) +* -u PSMAPFILE: Option details. (line 364) +* -v: Option details. (line 380) +* -V: Option details. (line 383) * -v VPL-FILE: Afm2tfm options. (line 81) * -V VPL-FILE: Afm2tfm options. (line 84) -* -x NUM: Option details. (line 387) -* -X NUM: Option details. (line 395) -* -Y NUM: Option details. (line 402) +* -x NUM: Option details. (line 392) +* -X NUM: Option details. (line 400) +* -Y NUM: Option details. (line 407) * -z: Hypertext. (line 6) -* -Z for compressing bitmap fonts: Option details. (line 411) -* -z for recognizing hyperdvi: Option details. (line 405) -* ..-relative filenames: Option details. (line 312) +* -Z for compressing bitmap fonts: Option details. (line 416) +* -z for recognizing hyperdvi: Option details. (line 410) +* ..-relative filenames: Option details. (line 317) * .afm Adobe metric files: Metric files. (line 26) * .dvipsrc, searched for: Configuration file searching. (line 14) @@ -3818,7 +3879,7 @@ Index * .pro prologue files: Header files. (line 12) * .tfm TeX font metric files: Metric files. (line 31) * /#copies: Option details. (line 31) -* /#copies <1>: Option details. (line 41) +* /#copies <1>: Option details. (line 46) * /magscale: EPSF scaling. (line 66) * 612 792 bounding box size: Bounding box. (line 43) * 8r encoding, and extra characters: Changing PostScript encodings. @@ -3851,25 +3912,25 @@ Index * \magnification: EPSF scaling. (line 62) * \rotninety: Literal examples. (line 27) * \textCOLORNAME: Color macro files. (line 45) -* | starting output filename: Option details. (line 242) +* | starting output filename: Option details. (line 247) * a config command (conserve memory): Configuration file commands. (line 21) * A ring, Scandinavian letter: Reencoding with Afm2tfm. (line 32) -* a3 papertype: Option details. (line 332) +* a3 papertype: Option details. (line 337) * a4 paper size: Config file paper sizes. (line 82) -* a4 papertype: Option details. (line 332) +* a4 papertype: Option details. (line 337) * A4size paper size: Config file paper sizes. (line 90) -* absolute filenames, disabling: Option details. (line 312) -* absolute page number, and -l: Option details. (line 169) -* absolute page number, and -p: Option details. (line 272) +* 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) * accent height adjustment, omitting: Afm2tfm options. (line 33) * accents, in wrong position: Reencoding with Afm2tfm. (line 32) * accents, wrong: Afm2tfm options. (line 17) -* accuracy in positioning: Option details. (line 71) +* accuracy in positioning: Option details. (line 76) * afm files: Metric files. (line 26) * afm2tfm: Making a font available. (line 46) @@ -3897,23 +3958,30 @@ Index * big points: Bounding box. (line 11) * binary files, not supported: Including graphics fails. (line 23) +* bitmap font encoding: Option details. (line 41) +* bitmap font encodings: Bitmap font encodings. + (line 6) * bitmap fonts: Glyph files. (line 30) +* bitmapfontenc config command (bitmap font encoding): Configuration file commands. + (line 27) * bop undefined error: Printer errors. (line 6) * 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 267) +* bop-hook, and offset pages: Option details. (line 272) * boundary character: Encoding file format. (line 41) * bounding box, comment for: Bounding box. (line 6) * bounding box, defined: Bounding box. (line 11) * bounding box, determining: Bounding box. (line 37) -* bounding box, finding tight: Option details. (line 82) +* bounding box, finding tight: Option details. (line 87) +* bounding box, for bitmap fonts: Bitmap font encodings. + (line 44) * bounding box, inaccurate: EPSF clipping. (line 6) * bounding box, supplying to TeX: \includegraphics. (line 36) * bounding box, supplying to TeX <1>: EPSF macros. (line 26) * c config command (include another config file): Configuration file commands. - (line 27) + (line 32) * changing PostScript encodings: Changing PostScript encodings. (line 6) * changing TeX encodings: Changing TeX encodings. @@ -3928,7 +3996,7 @@ Index * clipping of EPSF: EPSF clipping. (line 6) * CODINGSCHEME: Reencoding with Afm2tfm. (line 51) -* collated copies: Option details. (line 46) +* collated copies: Option details. (line 51) * color: Color. (line 6) * color configuration: Color device configuration. (line 6) @@ -3948,17 +4016,17 @@ Index (line 13) * comments, in encoding files: Encoding file format. (line 20) -* comments, removing included: Option details. (line 160) +* comments, removing included: Option details. (line 165) * compilation: Installation. (line 6) * compressed PostScript: Dynamic creation of graphics. (line 6) -* compressing bitmap fonts: Option details. (line 411) +* compressing bitmap fonts: Option details. (line 416) * 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 286) +* config.ps: Option details. (line 291) * config.ps installation: config.ps installation. (line 6) * config.ps paper sizes: Config file paper sizes. @@ -3983,38 +4051,40 @@ Index * configuration, of Dvips: Installation. (line 6) * continuation lines, not supported: Configuration file commands. (line 13) -* control-D: Option details. (line 110) -* copies, collated: Option details. (line 46) +* control-D: Option details. (line 115) +* coordinate system, for bitmap fonts: Bitmap font encodings. + (line 44) +* copies, collated: Option details. (line 51) * copies, duplicated page bodies: Option details. (line 31) -* copies, uncollated: Option details. (line 41) +* copies, uncollated: Option details. (line 46) * Crayola crayon box: Color macro files. (line 16) -* crop.pro: Option details. (line 152) -* cropmarks: Option details. (line 152) +* crop.pro: Option details. (line 157) +* cropmarks: Option details. (line 157) * current font, in PostScript: PostScript typesetting. (line 35) * D config command (dpi): Configuration file commands. - (line 31) + (line 36) * dated output: PostScript hooks. (line 16) * datestamp, in output: Configuration file commands. - (line 37) + (line 42) * debugging: Diagnosing problems. (line 6) -* debugging <1>: Option details. (line 52) +* debugging <1>: Option details. (line 57) * debugging options: Debug options. (line 6) * default resolutions: Configuration file commands. - (line 142) + (line 147) * default_texsizes Make variable: Configuration file commands. - (line 158) + (line 163) * Deutsch, Peter: Ghostscript installation. (line 6) * device dependency, and virtual fonts: Configuration file commands. - (line 181) + (line 186) * 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 405) +* distillation, and -z: Option details. (line 410) * distiller, for PDF files: Hypertext. (line 11) * dot accent: Reencoding with Afm2tfm. (line 32) @@ -4030,6 +4100,8 @@ Index * dvihps, hyperdvi to PostScript: Hypertext. (line 21) * Dvips configuration file options: Configuration file commands. (line 6) +* dvips-all.enc: Bitmap font encodings. + (line 21) * dvips.enc: Encodings. (line 35) * DVIPSDEBUG: Environment variables. (line 17) @@ -4038,7 +4110,7 @@ Index * DVIPSHEADERS: Environment variables. (line 31) * DVIPSHEADERS, overrides H: Configuration file commands. - (line 55) + (line 60) * DVIPSMAKEPK: Environment variables. (line 35) * DVIPSRC: Environment variables. @@ -4046,13 +4118,13 @@ Index * DVIPSSIZES: Environment variables. (line 46) * DVIPSSIZES, overrides R: Configuration file commands. - (line 155) + (line 160) * dynamic creation of graphics: Dynamic creation of graphics. (line 6) * e config command (maxdrift): Configuration file commands. - (line 34) + (line 39) * E config command (shell escape): Configuration file commands. - (line 37) + (line 42) * efficiency, and fonts: Making a font available. (line 104) * ehandler.ps: No output. (line 12) @@ -4068,15 +4140,17 @@ Index * encoding vectors, in Type 1 fonts: PostScript typesetting. (line 43) * encodings: Encodings. (line 6) +* encodings, for bitmap fonts: Bitmap font encodings. + (line 6) * end-hook: PostScript hooks. (line 11) * environment variables: Environment variables. (line 6) -* EOF: Option details. (line 110) +* EOF: Option details. (line 115) * eop-hook: PostScript hooks. (line 11) * EPS, and Ghostview: Ghostscript installation. (line 12) * EPSF macros: EPSF macros. (line 6) -* EPSF, generating: Option details. (line 82) +* EPSF, generating: Option details. (line 87) * epsf.sty: EPSF macros. (line 15) * epsf.tex: EPSF macros. (line 13) * Epson printers: Ghostscript installation. @@ -4095,23 +4169,25 @@ Index * extra characters, accessing: Changing PostScript encodings. (line 18) * f config command (filter): Configuration file commands. - (line 45) + (line 50) * F config command (filter): Configuration file commands. - (line 45) + (line 50) * failure, and printer errors: Printer errors. (line 6) * failure, of long documents: Long documents fail. (line 6) * failure, to include graphics: Including graphics fails. (line 6) * failure, to print at all: No output. (line 6) * fallback resolutions: Configuration file commands. - (line 142) + (line 147) * 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 98) -* first page printed: Option details. (line 272) +* filter, running as a: Option details. (line 103) +* first page printed: Option details. (line 277) * font concepts: Font concepts. (line 6) -* font generation, avoiding: Option details. (line 194) +* font encodings, bitmap: Bitmap font encodings. + (line 6) +* font generation, avoiding: Option details. (line 199) * fontinst: Invoking afm2tfm. (line 13) * fonts, as header files: Including headers from TeX. (line 13) @@ -4134,7 +4210,7 @@ Index * fonts, system PostScript: PostScript font installation. (line 11) * G config command (character shifting): Configuration file commands. - (line 48) + (line 53) * gf files: Glyph files. (line 41) * gftopk: Glyph files. (line 41) * Ghostscript installation: Ghostscript installation. @@ -4145,7 +4221,7 @@ Index (line 12) * glyph files: Glyph files. (line 6) * GLYPHFONTS, overrides P: Configuration file commands. - (line 130) + (line 135) * gnuplot: Dynamic creation of graphics. (line 25) * graphics inclusion fails: Including graphics fails. @@ -4153,16 +4229,16 @@ Index * gs installation: Ghostscript installation. (line 6) * gsave/grestore, and literal PS: Literal examples. (line 27) -* gsftopk: Option details. (line 379) +* gsftopk: Option details. (line 384) * h config command (download additional header): Configuration file commands. - (line 52) + (line 57) * H config command (PostScript header path): Configuration file commands. - (line 55) + (line 60) * Hafner, Jim: Color. (line 6) -* header file, downloading: Option details. (line 122) +* header file, downloading: Option details. (line 127) * header files, defined: Header files. (line 6) * header path, defining: Configuration file commands. - (line 55) + (line 60) * header=FILE \special: Including headers from TeX. (line 6) * headers and memory usage: Headers and memory usage. @@ -4179,19 +4255,19 @@ Index * hscale (psfile special option): psfile special. (line 30) * hsize (psfile special option): psfile special. (line 24) * html specials: Hypertext. (line 6) -* html specials, and -z: Option details. (line 405) +* html specials, and -z: Option details. (line 410) * http://www.win.tue.nl/~dickie/idvi: Hypertext. (line 21) * http://xxx.lanl.gov/hypertex: Hypertext. (line 21) * Hungarian umlaut: Reencoding with Afm2tfm. (line 32) -* hyperdvi extensions, enabling: Option details. (line 405) +* hyperdvi extensions, enabling: Option details. (line 410) * 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 59) + (line 64) * idvi Java DVI reader: Hypertext. (line 21) * Illustrator, workaround for: Including graphics fails. (line 10) @@ -4214,30 +4290,30 @@ Index * inverted output: Small or inverted. (line 6) * invoking Dvips: Invoking Dvips. (line 6) * j config command (partial font downloading): Configuration file commands. - (line 63) + (line 68) * Java DVI reader: Hypertext. (line 21) * Jeffrey, Alan: Invoking afm2tfm. (line 13) * K config command (comment removal): Configuration file commands. - (line 67) + (line 72) * kerning, defined: Metric files. (line 15) * KPATHSEA_DEBUG: Environment variables. (line 18) * L config command (last paper size wins): Configuration file commands. - (line 71) + (line 76) * landscape orientation, defined: Paper size and landscape. (line 11) -* landscape papertype: Option details. (line 332) +* landscape papertype: Option details. (line 337) * landscape, as \special: papersize special. (line 16) -* last page printed: Option details. (line 169) +* last page printed: Option details. (line 174) * last-resort font scaling, with DVIPSSIZES: Environment variables. (line 47) * last-resort scaling, with R: Configuration file commands. - (line 142) -* ledger papertype: Option details. (line 332) -* legal papertype: Option details. (line 332) + (line 147) +* ledger papertype: Option details. (line 337) +* legal papertype: Option details. (line 337) * letter paper size: Config file paper sizes. (line 82) -* letter papertype: Option details. (line 332) +* letter papertype: Option details. (line 337) * letterhead tray: Paper trays. (line 10) * letterSize paper size: Config file paper sizes. (line 90) @@ -4254,25 +4330,25 @@ Index * 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 117) -* lpr spooler, MS-DOS emulation: Option details. (line 242) +* low characters, shifting: Option details. (line 122) +* lpr spooler, MS-DOS emulation: Option details. (line 247) * m config command (available memory): Configuration file commands. - (line 75) + (line 80) * M config command (mf mode): Configuration file commands. - (line 102) + (line 107) * 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 387) -* magnification, vertical: Option details. (line 398) +* magnification, overriding DVI: Option details. (line 392) +* magnification, vertical: Option details. (line 403) * mailcap and hypertext: Hypertext specials. (line 53) -* manual feed: Option details. (line 182) -* maxdrift: Option details. (line 71) -* maximum pages printed: Option details. (line 204) -* media: Option details. (line 332) +* manual feed: Option details. (line 187) +* maxdrift: Option details. (line 76) +* maximum pages printed: Option details. (line 209) +* media: Option details. (line 337) * memory available: Configuration file commands. - (line 75) + (line 80) * memory of printer exhausted: Printer errors. (line 14) * memory usage, and headers: Headers and memory usage. (line 6) @@ -4281,43 +4357,43 @@ Index (line 104) * Metafont ligature operations: Encoding file format. (line 54) -* Metafont mode, specifying: Option details. (line 185) +* Metafont mode, specifying: Option details. (line 190) * 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 194) -* MISSFONT_LOG: Option details. (line 197) +* missfont.log: Option details. (line 199) +* MISSFONT_LOG: Option details. (line 202) * Mitsubishi Shinko CHC-S446i printer: No output. (line 14) * mkdvipspapers: Config file paper sizes. (line 79) -* mktexpk, avoiding: Option details. (line 194) +* mktexpk, avoiding: Option details. (line 199) * mktexpk, changing name: Environment variables. (line 36) -* mode name, specifying: Option details. (line 185) -* mtpk: Option details. (line 379) +* mode name, specifying: Option details. (line 190) +* mtpk: Option details. (line 384) * multiple master fonts: psfonts.map. (line 60) -* multiple output files: Option details. (line 127) +* multiple output files: Option details. (line 132) * multiple paper trays: Paper trays. (line 6) * Murphy, Tim: Hypertext specials. (line 20) * N config command (disable EPS): Configuration file commands. - (line 105) + (line 110) * 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 117) +* 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) * o config command (output destination): Configuration file commands. - (line 110) + (line 115) * O config command (page offsets): Configuration file commands. - (line 118) + (line 123) * 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 254) -* Omega extensions: Option details. (line 215) +* offset pages: Option details. (line 259) +* Omega extensions: Option details. (line 220) * option, details of: Option details. (line 6) * options, debugging: Debug options. (line 6) * options, Dvips: Invoking Dvips. (line 6) @@ -4330,20 +4406,20 @@ Index * output file, sectioning of: Headers and memory usage. (line 6) * output file, setting: Configuration file commands. - (line 110) -* output files, multiple: Option details. (line 127) + (line 115) +* output files, multiple: Option details. (line 132) * output, inverted: Small or inverted. (line 6) * output, none: No output. (line 6) -* output, redirecting: Option details. (line 237) +* output, redirecting: Option details. (line 242) * output, too small: Small or inverted. (line 6) * p config command (font aliases): Configuration file commands. - (line 121) + (line 126) * P config command (PK path): Configuration file commands. - (line 130) -* page range: Option details. (line 281) -* page, first printed: Option details. (line 272) -* page, last printed: Option details. (line 169) -* pages, maximum printed: Option details. (line 204) + (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) * PaintType: Special font effects. (line 50) * Pantone colors: Color macro files. (line 16) @@ -4354,16 +4430,16 @@ Index * paper size, general: Paper size and landscape. (line 6) * paper trays: Paper trays. (line 6) -* paper type: Option details. (line 332) +* paper type: Option details. (line 337) * papersize special: papersize special. (line 6) -* papersize special, and no -t: Option details. (line 332) -* papersize special, first vs. last: Option details. (line 178) +* papersize special, and no -t: Option details. (line 337) +* papersize special, first vs. last: Option details. (line 183) * 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 405) +* PDF files, option for: Option details. (line 410) * pdfmark: Hypertext. (line 6) * pfa files: Glyph files. (line 25) * pfb files: Glyph files. (line 25) @@ -4371,28 +4447,28 @@ 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 169) -* physical page number, and -p: Option details. (line 272) +* 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) -* pipes, not readable: Option details. (line 98) +* pipes, not readable: Option details. (line 103) * pk files: Glyph files. (line 35) * PKFONTS, overrides P: Configuration file commands. - (line 130) + (line 135) * plotfile, ps subspecial: ps special. (line 29) * pltotf: Metric files. (line 39) -* popen for output: Option details. (line 242) +* popen for output: Option details. (line 247) * portrait orientation, defined: Paper size and landscape. (line 11) -* positioning accuracy: Option details. (line 71) +* positioning accuracy: Option details. (line 76) * post code after headers: Including headers from TeX. (line 28) * PostScript code, literal: Literal PS. (line 6) * PostScript encoding: Encodings. (line 27) * PostScript encoding, changing: Changing PostScript encodings. (line 6) -* PostScript font alias file: Option details. (line 359) +* PostScript font alias file: Option details. (line 364) * PostScript font alias file <1>: Configuration file commands. - (line 121) + (line 126) * PostScript fonts: PostScript fonts. (line 6) * PostScript fonts, installing: PostScript font installation. (line 6) @@ -4418,13 +4494,13 @@ Index (line 14) * printer errors: Printer errors. (line 6) * printer memory: Configuration file commands. - (line 75) + (line 80) * printer memory exhausted: Printer errors. (line 14) -* printer offset: Option details. (line 254) +* printer offset: Option details. (line 259) * PRINTER, and config file searching: Configuration file searching. (line 36) -* PRINTER, avoided with -f: Option details. (line 98) -* printer, driving directly: Option details. (line 110) +* 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) * prototype printer configuration file: config.ps installation. @@ -4438,18 +4514,18 @@ Index * psfonts.map <2>: psfonts.map. (line 6) * psheaderdir: Header files. (line 12) * psi character missing: Hypertext caveats. (line 54) -* pstopk: Option details. (line 379) -* pTeX extensions: Option details. (line 215) -* pTeX extensions <1>: Option details. (line 221) +* pstopk: Option details. (line 384) +* pTeX extensions: Option details. (line 220) +* pTeX extensions <1>: Option details. (line 226) * q config command (quiet): Configuration file commands. - (line 136) + (line 141) * Q config command (quiet): Configuration file commands. - (line 136) -* quiet operation: Option details. (line 305) + (line 141) +* quiet operation: Option details. (line 310) * R config command (fallback resolution): Configuration file commands. - (line 142) + (line 147) * r config command (page reversal): Configuration file commands. - (line 139) + (line 144) * raw tfm files: Afm2tfm options. (line 17) * reencode/*.enc: Encodings. (line 35) * reencoding: Reencoding with Afm2tfm. @@ -4460,25 +4536,25 @@ Index * remapping: Reencoding with Afm2tfm. (line 6) * resident fonts, different in different printers: Option details. - (line 359) + (line 364) * resident fonts, different in different printers <1>: Configuration file commands. - (line 121) -* resolution: Option details. (line 395) -* resolution <1>: Option details. (line 402) -* resolution, setting: Option details. (line 58) -* reverse pagination: Option details. (line 309) + (line 126) +* resolution: Option details. (line 400) +* resolution <1>: Option details. (line 407) +* resolution, setting: Option details. (line 63) +* reverse pagination: Option details. (line 314) * rhi (psfile special option): psfile special. (line 46) * Rokicki, Tomas: Why Dvips. (line 60) * rotate.tex: ps special. (line 33) * rwi (psfile special option): psfile special. (line 46) * s config command (global save/restore): Configuration file commands. - (line 164) + (line 169) * S config command (pict path): Configuration file commands. - (line 167) + (line 172) * 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 320) +* save/restore, generating global: Option details. (line 325) * scaleunit: psfile special. (line 66) * scaling of figures: EPSF scaling. (line 6) * scaling small caps: Afm2tfm options. (line 43) @@ -4492,15 +4568,15 @@ Index (line 6) * sections of output file, and memory: Headers and memory usage. (line 6) -* sections output, in separate files: Option details. (line 127) -* security: Option details. (line 312) -* shell command execution, disabling: Option details. (line 312) +* sections output, in separate files: Option details. (line 132) +* security: Option details. (line 317) +* shell command execution, disabling: Option details. (line 317) * shell escape, in config file: Configuration file commands. - (line 37) + (line 42) * Shinko CHC-S446i printer: No output. (line 14) * show PostScript operator: PostScript typesetting. (line 23) -* silent operation: Option details. (line 305) +* silent operation: Option details. (line 310) * simplex mode on duplex printers: Including headers from the command line. (line 13) * slanted fonts: Special font effects. @@ -4514,22 +4590,22 @@ Index * spaces, dropped trailing: Hypertext caveats. (line 54) * specials, hypertext: Hypertext specials. (line 6) * splines: Glyph files. (line 17) -* spooler, lacking: Option details. (line 110) -* spooling to lpr on MS-DOS: Option details. (line 242) -* standard I/O: Option details. (line 98) +* spooler, lacking: Option details. (line 115) +* spooling to lpr on MS-DOS: Option details. (line 247) +* standard I/O: Option details. (line 103) * standard input, reading options from: Option details. (line 11) -* standard output, output to: Option details. (line 237) +* standard output, output to: Option details. (line 242) * standard PostScript, required by Ghostview: Ghostscript installation. (line 12) * start-hook: PostScript hooks. (line 11) -* structured comments: Option details. (line 207) +* structured comments: Option details. (line 212) * system in config file: Configuration file commands. - (line 37) + (line 42) * T config command (TFM path): Configuration file commands. - (line 172) + (line 177) * Tektronix Phaser printer, used for color calibration: Color device configuration. (line 18) -* testpage.tex: Option details. (line 261) +* testpage.tex: Option details. (line 266) * TeX encoding, changing: Changing TeX encodings. (line 6) * TeX, including headers in: Including headers from TeX. @@ -4537,13 +4613,13 @@ Index * TEXCONFIG: Environment variables. (line 55) * TEXFONTS, overrides P: Configuration file commands. - (line 130) + (line 135) * TEXFONTS, overrides T: Configuration file commands. - (line 172) + (line 177) * TEXINPUTS, overrides S: Configuration file commands. - (line 167) + (line 172) * texmext.enc: Encodings. (line 35) -* TEXMFOUTPUT: Option details. (line 197) +* TEXMFOUTPUT: Option details. (line 202) * texmital.enc: Encodings. (line 35) * texmsym.enc: Encodings. (line 35) * texmsym.enc <1>: Changing TeX encodings. @@ -4551,32 +4627,32 @@ Index * TEXPICTS: Environment variables. (line 62) * TEXPICTS, overrides S: Configuration file commands. - (line 167) + (line 172) * TEXPKS, overrides P: Configuration file commands. - (line 130) + (line 135) * TEXSIZES, overrides R: Configuration file commands. - (line 155) + (line 160) * text in figures, chopped off: EPSF clipping. (line 6) * tfm files: Metric files. (line 31) * TFMFONTS, overrides T: Configuration file commands. - (line 172) + (line 177) * tftopl: Metric files. (line 39) * Theisen, Tim: Ghostscript installation. (line 12) -* tight bounding box, finding: Option details. (line 82) +* tight bounding box, finding: Option details. (line 87) * too-small output: Small or inverted. (line 6) * trademark character, accessing: Changing PostScript encodings. (line 18) * trailing spaces, dropped: Hypertext caveats. (line 54) -* TranScript: Option details. (line 207) +* TranScript: Option details. (line 212) * 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 177) -* uncollated copies: Option details. (line 41) + (line 182) +* uncollated copies: Option details. (line 46) * uncompressing PostScript: Dynamic creation of graphics. (line 6) * uniform resource locator: Hypertext specials. (line 20) @@ -4591,14 +4667,14 @@ Index * user-definable colors: User-definable colors. (line 6) * userdict, and dictionary files: Header files. (line 21) -* userdict, used for header files: Option details. (line 122) +* userdict, used for header files: Option details. (line 127) * V config command (vf path): Configuration file commands. - (line 181) + (line 186) * 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 181) + (line 186) * virtual fonts: Virtual fonts. (line 6) * virtual fonts, creating: Invoking afm2tfm. (line 13) * VM exhausted: Printer errors. (line 14) @@ -4611,21 +4687,21 @@ Index * 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 186) + (line 191) * warning messages, defining: Configuration file commands. - (line 186) -* warnings, suppressing: Option details. (line 305) + (line 191) +* warnings, suppressing: Option details. (line 310) * whole font downloading: psfonts.map. (line 60) * wide fonts: psfonts.map. (line 19) * X config command (horizontal resolution): Configuration file commands. - (line 193) -* Xerox 4045: Option details. (line 367) + (line 198) +* Xerox 4045: Option details. (line 372) * Y config command (vertical resolution): Configuration file commands. - (line 196) + (line 201) * Z config command (compress fonts): Configuration file commands. - (line 199) + (line 204) * z config command (secure mode): Configuration file commands. - (line 202) + (line 207) @@ -4648,64 +4724,70 @@ Node: Basic usage17535 Node: Command-line options18539 Node: Option summary18987 Node: Option details21236 -Node: Environment variables41008 -Node: Config files43869 -Node: Configuration file searching44539 -Node: Configuration file commands47736 -Node: Paper size and landscape55517 -Node: papersize special57142 -Node: Config file paper sizes58850 -Node: Paper trays63006 -Node: Interaction with PostScript64340 -Node: PostScript figures64993 -Node: Bounding box65719 -Node: \includegraphics69091 -Node: EPSF macros71384 -Node: EPSF scaling73353 -Node: EPSF clipping75923 -Node: psfile special76565 -Node: Dynamic creation of graphics78957 -Node: Fonts in figures80275 -Node: Header files81925 -Node: Including headers from TeX83131 -Node: Including headers from the command line85169 -Node: Headers and memory usage86268 -Node: Literal PS87479 -Node: " special88061 -Node: ps special88802 -Node: Literal headers90300 -Node: PostScript hooks91009 -Node: Literal examples93105 -Node: Hypertext94559 -Node: Hypertext caveats95788 -Node: Hypertext specials100176 -Node: PostScript fonts102810 -Node: Font concepts103927 -Node: Metric files105094 -Node: Glyph files107874 -Node: Virtual fonts110233 -Node: Encodings112059 -Node: PostScript typesetting114462 -Node: Making a font available117547 -Node: Invoking afm2tfm122581 -Node: Changing font encodings123598 -Node: Changing TeX encodings124389 -Node: Changing PostScript encodings125491 -Node: Changing both encodings126835 -Node: Reencoding with Afm2tfm127509 -Node: Encoding file format130612 -Node: Special font effects134816 -Node: Afm2tfm options137076 -Node: psfonts.map140601 -Node: Color145331 -Node: Color macro files146375 -Node: User-definable colors149568 -Node: Color subtleties150844 -Node: Ted Turner152496 -Node: Color device configuration153721 -Node: Color support details156165 -Node: Color specifications156543 -Node: Color specials157947 -Node: Index160076 +Node: Environment variables41202 +Node: Config files44063 +Node: Configuration file searching44733 +Node: Configuration file commands47930 +Node: Paper size and landscape55904 +Node: papersize special57529 +Node: Config file paper sizes59237 +Node: Paper trays63393 +Node: Interaction with PostScript64727 +Node: PostScript figures65380 +Node: Bounding box66106 +Node: \includegraphics69478 +Node: EPSF macros71771 +Node: EPSF scaling73740 +Node: EPSF clipping76310 +Node: psfile special76952 +Node: Dynamic creation of graphics79344 +Node: Fonts in figures80662 +Node: Header files82312 +Node: Including headers from TeX83518 +Node: Including headers from the command line85556 +Node: Headers and memory usage86655 +Node: Literal PS87866 +Node: " special88448 +Node: ps special89189 +Node: Literal headers90687 +Node: PostScript hooks91396 +Node: Literal examples93492 +Node: Hypertext94946 +Node: Hypertext caveats96175 +Node: Hypertext specials100563 +Node: PostScript fonts103197 +Node: Font concepts104314 +Node: Metric files105544 +Node: Glyph files108324 +Node: Virtual fonts110683 +Node: Encodings112509 +Node: Bitmap font encodings114911 +Node: PostScript typesetting117441 +Node: Making a font available120538 +Node: Invoking afm2tfm125572 +Node: Changing font encodings126589 +Node: Changing TeX encodings127380 +Node: Changing PostScript encodings128482 +Node: Changing both encodings129826 +Node: Reencoding with Afm2tfm130500 +Node: Encoding file format133603 +Node: Special font effects137807 +Node: Afm2tfm options140067 +Node: psfonts.map143592 +Node: Color148322 +Node: Color macro files149366 +Node: User-definable colors152559 +Node: Color subtleties153835 +Node: Ted Turner155487 +Node: Color device configuration156712 +Node: Color support details159156 +Node: Color specifications159534 +Node: Color specials160938 +Node: Index163067 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 d5d49858ae5..2744e1176d4 100644 --- a/Master/texmf-dist/doc/info/kpathsea.info +++ b/Master/texmf-dist/doc/info/kpathsea.info @@ -1,9 +1,9 @@ -This is kpathsea.info, produced by makeinfo version 6.6 from +This is kpathsea.info, produced by makeinfo version 6.7 from kpathsea.texi. This file documents the Kpathsea library for path searching. - Copyright (C) 1996-2019 Karl Berry & Olaf Weber. + Copyright (C) 1996-2020 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.1, released in March 2019. +corresponds to version 6.3.2, released in March 2020. * 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.1 of the Kpathsea library, -released in March 2019. +This manual corresponds to version 6.3.2 of the Kpathsea library, +released in March 2020. 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 @@ -80,7 +80,7 @@ this library: Other software that we do not maintain also uses it. Kpathsea is now maintained as part of the TeX Live distribution -(<http://tug.org/texlive>), which includes several more Kpathsea-using +(<https://tug.org/texlive>), which includes several more Kpathsea-using programs. For information on configuration, building, installing, and more, *note (tlbuild)::. @@ -95,7 +95,7 @@ changes you have made, and allow anyone to modify the library source and distribute their modifications. It does not mean you have to distribute the source to your program using the library, although we hope you will. See accompanying files for the text of the GNU licenses, or -<http2://www.gnu.org/licenses>. +<https://gnu.org/licenses>. If you know enough about TeX to be reading this manual, then you (or your institution) should consider joining the TeX Users Group (if you're @@ -201,24 +201,25 @@ File: kpathsea.info, Node: unixtex.ftp, Next: Security, Prev: Introduction, 2 'unixtex.ftp': Obtaining TeX ****************************** -This is <https://tug.org/tex/unixtex.ftp>, last updated 28 November -2017. Email <tex-k@tug.org> with comments or questions. +This is <ftp://tug.org/tex/unixtex.ftp>, a.k.a. +<https://tug.org/unixtex.ftp>, last updated 29 February 2020. Email +<tex-k@tug.org> with comments or questions. The principal free TeX distribution for Unix-like systems is TeX Live, on the web at <http://tug.org/texlive>. The pages there describe -many ways to acquire and.or build TeX, over the Internet or on physical +many ways to acquire and/or build TeX, over the Internet or on physical media, both the sources and precompiled binaries for many systems, either standalone or as part of various operating system distributions. - Web2c, Kpathsea, Dvips, and Dviljk are no longer released as a -separate packages. Their sources are now maintained as part of TeX -Live. + Web2c, Kpathsea, Dvips, and Dviljk, among others, are no longer +released as a separate packages. Their sources are now maintained as +part of TeX Live. The host ftp.cs.stanford.edu is the original source for the files for which Donald Knuth is directly responsible: 'tex.web', 'plain.tex', etc. However, unless you want to undertake the project of building your TeX -installation from scratch, it is more reliable and less work to retrieve -these files as part of a larger package. +system from scratch, it is more reliable and less work to retrieve these +files as part of a larger package. In any case, the Stanford ftp site is not the canonical source for anything except what was created as part of Knuth's original TeX, so do @@ -291,8 +292,8 @@ This section describes the default installation hierarchy of the 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 <http://www.gnu.org/prep/standards>. The TDS document is available -from <http://www.mirror.ctan.org/tds> (*note unixtex.ftp::). +from <https://gnu.org/prep/standards>. The TDS document is available +from <http://mirror.ctan.org/tds> (*note unixtex.ftp::). In short, here is a skeleton of the default directory structure, extracted from the TDS document: @@ -374,6 +375,11 @@ This chapter describes the generic path searching mechanism Kpathsea provides. For information about searching for particular file types (e.g., TeX fonts), see the next chapter. + This section, with minor differences, has been translated into +several other languages (Chinese, Spanish, Russian, Japanese, French, +German, ...) as part of the TeX Live guide; see +<https://tug.org/texlive/doc.html> for links. + * Menu: * Searching overview:: Basic scheme for searching. @@ -467,7 +473,10 @@ File: kpathsea.info, Node: Path sources, Next: Path expansion, Prev: Searchin A search path or other configuration value can come from many sources. In the order in which Kpathsea looks for them: - 1. A user-set environment variable, e.g., 'TEXINPUTS'. Environment + 1. A command-line option such as '--cnf-line', available in + 'kpsewhich' and most TeX engines. *Note Path searching options::. + + A user-set environment variable, e.g., 'TEXINPUTS'. Environment variables with an underscore and the program name appended override; for example, 'TEXINPUTS_latex' overrides 'TEXINPUTS' if the program being run is named 'latex'. @@ -519,11 +528,11 @@ 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, as with most shells, a '%' in the "middle" of a value does not - start a comment. Examples: + is, similar to most shells, a '%' 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". + var = a%b % but the value of var will be "a%b" * Blank lines are ignored. @@ -531,7 +540,7 @@ mentions most features. The format of 'texmf.cnf' files follows: the next line is appended. Whitespace at the beginning of continuation lines is not ignored. - * Each remaining line must look like + * Each remaining line will look like: VARIABLE [. PROGNAME] [=] VALUE @@ -540,20 +549,27 @@ mentions most features. The format of 'texmf.cnf' files follows: * The VARIABLE name may contain any character other than whitespace, '=', or '.', but sticking to 'A-Za-z_' is safest. - * If '.PROGNAME' is present, the definition only applies if the - program that is running is named (i.e., the last component of - 'argv[0]' is) PROGNAME or 'PROGNAME.{exe,bat,cmd,...}'. Most - notably, this allows different flavors of TeX to have different - search paths. - - * VALUE may contain any characters except '%' and '@'. (These - restrictions are only necessary because of the processing done on - 'texmf.cnf' at build time, so you can stick those characters in - after installation if you have to.) The '$VAR.PROG' feature is not - available on the right-hand side; instead, you must use an - additional variable (see below for example). A ';' in VALUE is - translated to ':' if running under Unix; this is useful to write a - single 'texmf.cnf' which can be used under both Unix and Windows. + * If '.PROGNAME' is present (preceding spaces are ignored), the + definition only applies if the program that is running is named + (i.e., the last component of 'argv[0]' is) PROGNAME or + 'PROGNAME.{exe,bat,cmd,...}'. Most notably, this allows different + flavors of TeX to have different search paths. The PROGNAME value + is used literally, without variable or other expansions. + + * Considered as strings, VALUE may contain any character. However, + in practice most 'texmf.cnf' values are related to path expansion, + and since various special characters are used in expansion, such as + braces and commas, they cannot be used in directory names. + + The '$VAR.PROG' feature is not available on the right-hand side; + instead, you must use an additional variable (see below for + example). + + A ';' in VALUE is translated to ':' if running under Unix, in order + to have a single 'texmf.cnf' that can support both Unix and Windows + systems. This translation happens with any value, not just search + paths, but fortunately in practice ';' is not needed in other + values. * All definitions are read before anything is expanded, so you can use variables before they are defined (like Make, unlike most other @@ -569,12 +585,31 @@ Here is a configuration file fragment illustrating most of these points: TEXINPUTS.latex2e = $latex2e_inputs TEXINPUTS.latex = $latex2e_inputs - This format has obvious similarities 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. + 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 +omitted, the intended value is interpreted as a program name. For +example, a line 'var .;/some/path' is taken as an empty value for 'var' +running under the program named ';/some/path'. To diagnose this, +Kpathsea warns if the program name contains a path separator or other +special character. The simplest way to avoid the problem is to use the +'='. + + Exactly when a character will be considered special or act as itself +depends on the context in which it is used. The rules are inherent in +the multiple levels of interpretation of the configuration (parsing, +expansion, search, ...) and so cannot be concisely stated, +unfortunately. There is no general escape mechanism; in particular, '\' +is not an "escape character" in 'texmf.cnf' files. When it comes +choosing directory names for installation, it is safest to avoid them +all. The implementation of all this is in 'kpathsea/cnf.c'. @@ -801,7 +836,7 @@ if the path specification is, say, '$TEXMF/fonts//pk//', then files in a subdirectory '.../pk', even if it is a leaf, are checked. The reason cannot be explained without reference to the implementation, so read 'kpathsea/elt-dirs.c' (search for 'may descend') if you are curious. -And if you can find a way to _solve_ the problem, please let me know. +And if you find a way to solve the problem, please let me know. Subdirectory expansion is implemented in the source file 'kpathsea/elt-dirs.c'. @@ -845,8 +880,8 @@ only to differences in case. This same problematic scenario has always existed on Windows, but for whatever reason, it has become much more common since Apple also went to -a case-insensitive filesystem. Hence the move to change the Kpathsea -behavior now. +a case-insensitive filesystem. Hence the relatively late change to the +Kpathsea behavior. The fallback case-insensitive search is omitted at compile-time on Windows, where (for practical purposes) all file names are @@ -936,7 +971,7 @@ steps: Sorry that it's annoyingly lengthy, but implementing this inside Kpathsea would be a lot of error-prone trouble for something that is only useful for debugging. If your 'find' does not support '-iname', -you can get GNU Find from <https://www.gnu.org/software/findutils>. +you can get GNU Find from <https://gnu.org/software/findutils>. The casefolding search is implemented in the source file 'kpathsea/pathsearch.c'. Two implementation points: @@ -961,7 +996,7 @@ File: kpathsea.info, Node: Filename database, Next: Invoking kpsewhich, Prev: Kpathsea goes to some lengths to minimize disk accesses for searches (*note Subdirectory expansion::). Nevertheless, in practice searching -each possible directory in typical TeX installations takes an +every possible directory in typical TeX installations takes an excessively long time. Therefore, Kpathsea can use an externally-built "filename database" @@ -969,8 +1004,7 @@ file named 'ls-R' that maps files to directories, thus avoiding the need to exhaustively search the disk. A second database file 'aliases' allows you to give additional names -to the files listed in 'ls-R'. This can be helpful to adapt to "8.3" -filename conventions in source files. +to the files listed in 'ls-R'. The 'ls-R' and 'aliases' features are implemented in the source file 'kpathsea/db.c'. @@ -1182,6 +1216,27 @@ filename, and returns the first file found. case-insensitive, it merely means that Kpathsea does not do any casefolding itself. +'--cnf-line=STR' + Parse STR as if it were a line in the 'texmf.cnf' configuration + file (*note Config files::), overriding settings in the actual + configuration files, and also in the environment (*note Path + sources::). This is implemented by making any settings from STR in + the environment, overwriting any value already there. Thus, an + extra colon in a '--cnf-line' value will refer to the value from a + configuration file, not a user-set environment variable. + + Furthermore, any variable set from STR will also be set with the + program name suffix. For example, 'pdftex + --cnf-line=TEXINPUTS=/foo:' will set both 'TEXINPUTS' and + 'TEXINPUTS_pdftex' in the environment (and the value will be '/foo' + followed by the setting from 'texmf.cnf', ignoring any user-set + 'TEXINPUTS'). + + This behavior is desirable because, in practice, many variables in + the distributed 'texmf.cnf' are program-specific, and the intuitive + behavior is for values set on the command line with '--cnf-line' to + override them. + '--dpi=NUM' Set the resolution to NUM; this only affects 'gf' and 'pk' lookups. '-D' is a synonym, for compatibility with Dvips. Default is 600. @@ -1499,8 +1554,8 @@ Kpsewhich provides some features in addition to path lookup as such: Unix-ish system) '.:/home/karl', supposing the latter is the current user's home directory. Note that the ';' in the source value, as commonly used in 'texmf.cnf', has changed to a ':', as - the normal path separator on the current system. (On a Windows-ish - system, the ';' would remain.) + the normal path separator on the current system. On a Windows-ish + system, the ';' would remain. '--var-value=VARIABLE' Outputs the value of VARIABLE (a simple identifier like @@ -1514,7 +1569,8 @@ Kpsewhich provides some features in addition to path lookup as such: default is not changed) '1'. Example to contrast with '--var-brace-value': 'FOO='.;~' kpsewhich - --var-value=FOO' outputs '.;~', i.e., the same as the input value. + --var-value=FOO' outputs '.;~', i.e., the same as the input value, + on all systems. File: kpathsea.info, Node: Standard options, Prev: Auxiliary tasks, Up: Invoking kpsewhich @@ -1596,14 +1652,14 @@ Auxiliary tasks::). 'bltxml' (BibLaTeXML bibliography files for Biber, - <http://ctan.org/pkg/biber>) 'BLTXMLINPUTS' suffix '.bltxml'. + <https://ctan.org/pkg/biber>) 'BLTXMLINPUTS' suffix '.bltxml'. 'bst' (BibTeX style, *note Basic BibTeX style files: (web2c)Basic BibTeX style files.) 'BSTINPUTS'; suffix '.bst'. 'clua' - (dynamic libraries for Lua, <http://ctan.org/pkg/luatex>) + (dynamic libraries for Lua, <https://ctan.org/pkg/luatex>) 'CLUAINPUTS' suffixes '.dll' and '.so'. 'cmap' @@ -1735,7 +1791,7 @@ Auxiliary tasks::). 'ris' (RIS bibliography files, primarily for Biber, - <http://ctan.org/pkg/biber>) 'RISINPUTS' suffix '.ris'. + <https://ctan.org/pkg/biber>) 'RISINPUTS' suffix '.ris'. 'subfont definition files' (subfont definition files) 'SFDFONTS' suffix '.sfd'. @@ -2468,7 +2524,7 @@ library.) different systems. You will almost certainly want to use Autoconf and probably Automake for configuring and building your software if you use Kpathsea; I strongly recommend using Autoconf and Automake regardless. -They are available from <http://www.gnu.org/software>. +They are available from <https://gnu.org/software>. File: kpathsea.info, Node: Program-specific files, Next: Programming with config files, Prev: Calling sequence, Up: Programming @@ -2608,7 +2664,7 @@ investigation, your report should include the following: * If the bug involved is an actual crash (i.e., core dump), it is easy and useful to include a stack trace from a debugger (I - recommend the GNU debugger GDB (<http://www.gnu.org/software/gdb>). + recommend the GNU debugger GDB (<https://gnu.org/software/gdb>). If the cause is apparent (a 'NULL' value being dereferenced, for example), please send the details along. If the program involved is TeX or Metafont, and the crash is happening at apparently-sound @@ -2627,7 +2683,7 @@ File: kpathsea.info, Node: Mailing lists, Next: Debugging, Prev: Bug checklis Web2c and Kpathsea in general are discussed on the mailing list <tex-k@tug.org>. You can subscribe and peruse the archives on the web -<http://lists.tug.org/tex-k>. +<https://lists.tug.org/tex-k>. You do not need to join to submit a report, nor will it affect whether you get a response. Be aware that large data files are @@ -2636,7 +2692,7 @@ join the list. If you are looking for general TeX help, such as how to install a full TeX system or how to use LaTeX, please see -<http://tug.org/begin.html>. +<https://tug.org/begin.html>. File: kpathsea.info, Node: Debugging, Next: Logging, Prev: Mailing lists, Up: Reporting bugs @@ -2923,7 +2979,7 @@ configuration file: the wrong device, most likely 'mktexpk''s built-in guess for the mode is wrong, and you should override it as above. - See <http://ctan.org/pkg/modes> for a list of resolutions and mode + See <https://ctan.org/pkg/modes> for a list of resolutions and mode names for most devices (additional submissions are welcome). If Metafont runs but generates fonts at a resolution of 2602dpi (and @@ -2988,40 +3044,43 @@ Index (line 12) * --casefold-search: Path searching options. (line 19) +* --cnf-line: Path searching options. + (line 28) +* --cnf-line, source for path: Path sources. (line 9) * --color=tty: ls-R. (line 25) * --debug=NUM: Auxiliary tasks. (line 9) * --dpi=NUM: Path searching options. - (line 28) + (line 49) * --engine=NAME: Path searching options. - (line 32) + (line 53) * --expand-braces=STRING: Auxiliary tasks. (line 12) * --expand-path=STRING: Auxiliary tasks. (line 16) * --expand-var=STRING: Auxiliary tasks. (line 34) * --format=NAME: Path searching options. - (line 48) + (line 69) * --help: Standard options. (line 8) * --help-formats: Auxiliary tasks. (line 42) * --interactive: Path searching options. - (line 130) + (line 151) * --mktex=FILETYPE: Path searching options. - (line 135) + (line 156) * --mode=STRING: Path searching options. - (line 141) + (line 162) * --must-exist: Path searching options. - (line 146) + (line 167) * --no-casefold-search: Path searching options. (line 19) * --no-mktex=FILETYPE: Path searching options. - (line 135) + (line 156) * --path=STRING: Path searching options. - (line 151) + (line 172) * --progname=NAME: Path searching options. - (line 159) + (line 180) * --safe-in-name=NAME: Auxiliary tasks. (line 48) * --safe-out-name=NAME: Auxiliary tasks. (line 48) * --show-path=NAME: Auxiliary tasks. (line 54) * --subdir=STRING: Path searching options. - (line 164) + (line 185) * --var-brace-value=VARIABLE: Auxiliary tasks. (line 60) * --var-value=VARIABLE: Auxiliary tasks. (line 74) * --version: Standard options. (line 11) @@ -3035,7 +3094,7 @@ Index * -1 debugging value: Debugging. (line 23) * -A option to ls: ls-R. (line 39) * -D NUM: Path searching options. - (line 28) + (line 49) * -iname, find predicate: Casefolding examples. (line 78) * -L option to ls: ls-R. (line 44) @@ -3115,6 +3174,7 @@ Index (line 195) * .pro: Supported file formats. (line 169) +* .PROGNAME qualifier in texmf.cnf: Config files. (line 50) * .rhosts, writable by TeX: Security. (line 10) * .ris: Supported file formats. (line 173) @@ -3152,6 +3212,8 @@ Index * 8.3 filenames, using: mktex configuration. (line 68) * : 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) * \, line continuation in texmf.cnf: Config files. (line 37) * \openin: Searching overview. (line 31) * \special, suppressing warnings about: Suppressing warnings. @@ -3228,7 +3290,7 @@ Index (line 46) * cmr10, as fallback font: Fallback font. (line 15) * cmr10.vf: Searching overview. (line 31) -* cnf.c: Config files. (line 86) +* cnf.c: Config files. (line 112) * cnf.h: Programming with config files. (line 27) * comments, in fontmap files: Fontmap. (line 27) @@ -3236,7 +3298,7 @@ Index * comments, making: Introduction. (line 29) * common features in glyph lookup: Basic glyph lookup. (line 6) * common problems: Common problems. (line 6) -* compilation value, source for path: Path sources. (line 20) +* compilation value, source for path: Path sources. (line 23) * compiler bugs: TeX or Metafont failing. (line 6) * compiler bugs, finding: TeX or Metafont failing. @@ -3256,8 +3318,8 @@ Index (line 57) * config.status: Bug checklist. (line 27) * configuration bugs: Bug checklist. (line 27) -* configuration file, source for path: Path sources. (line 17) -* configuration files as shell scripts.: Config files. (line 79) +* 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) * context diff: Bug checklist. (line 52) @@ -3314,8 +3376,8 @@ Index * ENCFONTS: Supported file formats. (line 61) * engine name: Path searching options. - (line 32) -* environment variable, source for path: Path sources. (line 9) + (line 53) +* environment variable, source for path: Path sources. (line 12) * environment variables for TeX: Supported file formats. (line 6) * environment variables in paths: Variable expansion. (line 6) @@ -3387,7 +3449,7 @@ Index (line 239) * fopen, redefined: Debugging. (line 54) * format of external database: Database format. (line 6) -* ftp.cs.stanford.edu: unixtex.ftp. (line 19) +* ftp.cs.stanford.edu: unixtex.ftp. (line 20) * ftp.tug.org: unixtex.ftp. (line 6) * fundamental purpose of Kpathsea: Introduction. (line 6) * gdb, recommended: Bug checklist. (line 58) @@ -3422,14 +3484,14 @@ Index (line 84) * input lines, reading: Calling sequence. (line 110) * interactive query: Path searching options. - (line 130) + (line 151) * interface, not frozen: Introduction. (line 29) * introduction: Introduction. (line 6) * kdebug:: Debugging. (line 105) * kdefault.c: Default expansion. (line 48) * Knuth, Donald E.: History. (line 6) -* Knuth, Donald E., archive of programs by: unixtex.ftp. (line 19) -* Kpathsea config file, source for path: Path sources. (line 17) +* Knuth, Donald E., archive of programs by: unixtex.ftp. (line 20) +* Kpathsea config file, source for path: Path sources. (line 20) * kpathsea.h: Programming overview. (line 26) * kpathsea_cnf_get: Programming with config files. @@ -3645,10 +3707,10 @@ Index * reporting bugs: Reporting bugs. (line 6) * resident.c: Calling sequence. (line 47) * resolution, setting: Path searching options. - (line 28) + (line 49) * resolutions, last-resort: Fallback font. (line 6) * retrieving TeX: unixtex.ftp. (line 6) -* right-hand side of variable assignments: Config files. (line 56) +* right-hand side of variable assignments: Config files. (line 57) * RISINPUTS: Supported file formats. (line 173) * Rokicki, Tom: History. (line 12) @@ -3672,7 +3734,7 @@ Index * setgid scripts: Security. (line 40) * SFDFONTS: Supported file formats. (line 177) -* shell scripts as configuration files: Config files. (line 79) +* 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) @@ -3745,7 +3807,7 @@ Index (line 26) * tex-k@tug.org: Mailing lists. (line 6) * tex-k@tug.org (bug address): Reporting bugs. (line 6) -* tex.web: unixtex.ftp. (line 19) +* tex.web: unixtex.ftp. (line 20) * TEXBIB: Supported file formats. (line 30) * TEXBIB <1>: Supported file formats. @@ -3780,7 +3842,7 @@ Index * texmf.cnf missing, warning about: Config files. (line 18) * texmf.cnf, and variable expansion: Variable expansion. (line 6) * texmf.cnf, definition for: Config files. (line 6) -* texmf.cnf, source for path: Path sources. (line 17) +* texmf.cnf, source for path: Path sources. (line 20) * TEXMFCNF: Config files. (line 6) * TEXMFCNF <1>: Supported file formats. (line 49) @@ -3824,6 +3886,8 @@ Index * tolerance for glyph lookup: Basic glyph lookup. (line 15) * trailing / in home directory: Tilde expansion. (line 19) * trailing colons: Default expansion. (line 6) +* translations, of path searching description: Path searching. + (line 10) * TRFONTS: Supported file formats. (line 203) * trick for detecting leaf directories: Subdirectory expansion. @@ -3893,60 +3957,65 @@ Index Tag Table: Node: Top1480 Node: Introduction2260 -Node: History4330 -Node: unixtex.ftp8926 -Node: Security10351 -Node: TeX directory structure12855 -Node: Path searching16903 -Node: Searching overview17630 -Node: Path sources21449 -Node: Config files22540 -Node: Path expansion26467 -Node: Default expansion27420 -Node: Variable expansion29490 -Node: Tilde expansion30891 -Node: Brace expansion31871 -Node: KPSE_DOT expansion32810 -Node: Subdirectory expansion33323 -Node: Casefolding search35677 -Node: Casefolding rationale36446 -Node: Casefolding examples37785 -Node: Filename database42835 -Node: ls-R43893 -Node: Filename aliases47569 -Node: Database format48747 -Node: Invoking kpsewhich49760 -Node: Path searching options50715 -Node: Specially-recognized files59234 -Node: Auxiliary tasks60589 -Node: Standard options64295 -Node: TeX support64651 -Node: Supported file formats66005 -Node: File lookup73670 -Node: Glyph lookup75419 -Node: Basic glyph lookup76543 -Node: Fontmap77423 -Node: Fallback font79952 -Node: Suppressing warnings80864 -Node: mktex scripts81991 -Node: mktex configuration83206 -Node: mktex script names89009 -Node: mktex script arguments90395 -Node: Programming91274 -Node: Programming overview91847 -Node: Calling sequence94708 -Node: Program-specific files101240 -Node: Programming with config files102263 -Node: Reporting bugs103850 -Node: Bug checklist104528 -Node: Mailing lists108000 -Node: Debugging108675 -Node: Logging113752 -Node: Common problems115619 -Node: Unable to find files116096 -Node: Slow path searching118506 -Node: Unable to generate fonts119881 -Node: TeX or Metafont failing122352 -Node: Index123554 +Node: History4327 +Node: unixtex.ftp8923 +Node: Security10393 +Node: TeX directory structure12897 +Node: Path searching16938 +Node: Searching overview17896 +Node: Path sources21715 +Node: Config files22941 +Node: Path expansion28204 +Node: Default expansion29157 +Node: Variable expansion31227 +Node: Tilde expansion32628 +Node: Brace expansion33608 +Node: KPSE_DOT expansion34547 +Node: Subdirectory expansion35060 +Node: Casefolding search37408 +Node: Casefolding rationale38177 +Node: Casefolding examples39523 +Node: Filename database44569 +Node: ls-R45551 +Node: Filename aliases49227 +Node: Database format50405 +Node: Invoking kpsewhich51418 +Node: Path searching options52373 +Node: Specially-recognized files61971 +Node: Auxiliary tasks63326 +Node: Standard options67051 +Node: TeX support67407 +Node: Supported file formats68761 +Node: File lookup76429 +Node: Glyph lookup78178 +Node: Basic glyph lookup79302 +Node: Fontmap80182 +Node: Fallback font82711 +Node: Suppressing warnings83623 +Node: mktex scripts84750 +Node: mktex configuration85965 +Node: mktex script names91768 +Node: mktex script arguments93154 +Node: Programming94033 +Node: Programming overview94606 +Node: Calling sequence97467 +Node: Program-specific files103996 +Node: Programming with config files105019 +Node: Reporting bugs106606 +Node: Bug checklist107284 +Node: Mailing lists110753 +Node: Debugging111430 +Node: Logging116507 +Node: Common problems118374 +Node: Unable to find files118851 +Node: Slow path searching121261 +Node: Unable to generate fonts122636 +Node: TeX or Metafont failing125108 +Node: Index126310 End Tag Table + + +Local Variables: +coding: utf-8 +End: diff --git a/Master/texmf-dist/doc/info/tlbuild.info b/Master/texmf-dist/doc/info/tlbuild.info index 9ce25d8b336..6c34b8095d4 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.6 from +This is tlbuild.info, produced by makeinfo version 6.7 from tlbuild.texi. This file documents the TeX Live build system and more. -Copyright (C) 2016-2019 Karl Berry. +Copyright (C) 2016-2020 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 (2019) +Building TeX Live (2020) ************************ For an overview of this manual, *note Introduction::. @@ -59,8 +59,7 @@ File: tlbuild.info, Node: Introduction, Next: Overview of build system, Prev: 1 Introduction ************** -This manual (dated February 2019) corresponds to the TeX Live 2019 -release. +This manual (dated March 2020) corresponds to the TeX Live 2020 release. This manual is aimed at system installers and programmers, and focuses on how to configure, build, and develop the TeX Live (TL) @@ -169,19 +168,18 @@ Automake/Autoconf output in general) work with any reasonable 'make'. A C++11 compiler is similarly required because of the third-party libraries ICU and Poppler; the program 'dvisvgm' also requires C++11. -It is possible to build everything else with older compilers; -<https://tug.org/texlive/custom-bin.html> links to a build script for -doing this. +It is possible to build everything else with older compilers, but you +have to remove the C++11-dependent sources. *Note Build one package::. - However, a few programs in the tree have additional requirements: + A few programs in the tree have additional requirements: 'web2c' requires 'perl' for some tests run by 'make check'. 'xdvik' 'xpdfopen' - require X11 headers and libraries, often in "development" packages - that are not installed by default. + require X11 headers and libraries, typically in "development" + packages that are not installed by default. 'xetex' requires 'fontconfig' (again both headers and library), or, for @@ -189,8 +187,8 @@ doing this. 'xindy' requires GNU 'clisp', 'libsigsegv', and 'libiconv'; additionally, - to build the rules and/or documentation: 'perl', 'latex', and - 'pdflatex' + to build the rules and/or documentation: 'perl', 'latex', + 'pdflatex'. Lacking the required tools, building these programs must avoided, e.g., 'configure --without-x --disable-xetex --disable-xindy' @@ -329,16 +327,9 @@ library modules are configured but none are made. However, the invoked to build an individual program or library, first building any required libraries. - This "build-on-demand" procedure is used, e.g., in the upstream -LuaTeX repository to build LuaTeX, from a subset of the complete -TeX Live source tree. As another example, when building the original -e-TeX has been disabled (as it is by default), one can run 'make etex' -(or 'make etex.exe') in 'texk/web2c/' to build e-TeX (although there is -no comparably simple way to _install_ e-TeX). - - If you want to work on a single program within the TL sources, this -is the recommended way to do it. Here is an example from start to -finish for working on 'dvipdfm-x'. + Here is an example from start to finish for working on 'dvipdfm-x'. +(Unfortunately, this does not suffice for building one, or a subset, of +the TeX engines; see the next section.) mkdir mydir && cd mydir # new working directory @@ -387,10 +378,19 @@ 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. - Even with '--disable-all-pkgs', dependencies will be checked. For -instance, if a (non-MacOSX) system does not have 'fontconfig', XeTeX -cannot be built (*note Prerequisites::) and 'configure' will terminate. -To proceed without such dependencies, specify '--enable-missing' also. + 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': + + rm -rf libs/icu libs/poppler libs/graphite2 texk/dvisvgm + + Also, even with '--disable-all-pkgs', dependencies are (currently) +checked. For instance, if a (non-MacOSX) 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.) By default, the 'gcc' compilers will be used if present; otherwise, individual packages may use something different. You can explicitly @@ -417,8 +417,9 @@ explicitly specify what to make. For example, to build only LuaTeX: This works because the 'make' automatically runs 'configure' as necessary for the dependencies and target. Furthermore, the source tree -can be cut down to just what is needed for the given engine (as the -separate pdfTeX and LuaTeX source repositories do). +can be cut down to just what is needed for the given engine (the +separate pdfTeX and LuaTeX source repositories do this, if you want to +peruse examples). We hope to improve the situation in the future. Patches are welcome. @@ -745,11 +746,11 @@ many extra hassles, so don't do that, tempting as it may be. autoconf (GNU Autoconf) 2.69 automake (GNU automake) 1.16.1 - bison (GNU Bison) 3.3.1 + bison (GNU Bison) 3.5.2 flex 2.6.0 ltmain.sh (GNU libtool) 2.4.6 m4 (GNU M4) 1.4.18 - makeinfo (GNU texinfo) 6.6 + makeinfo (GNU texinfo) 6.7 These versions should be used to update the generated files (e.g., 'configure' or 'Makefile.in') in all or parts of the TL tree after their @@ -771,7 +772,6 @@ runs of 'bison', 'flex', or 'makeinfo' with 'touch' of the generated ('.c', '.h', or '.info') files. With '--enable-maintainer-mode' it may also be necessary to 'touch' first 'aclocal.m4', then 'configure' and 'config.h.in' (or 'c-auto.in'), and finally all 'Makefile.in' files. -Perhaps 'make -t' will help. File: tlbuild.info, Node: Top-level directories, Next: Autoconf macros, Prev: Build system tools, Up: Layout and infrastructure @@ -2086,6 +2086,7 @@ pushed is tested on Travis-CI. * Transfer from Subversion to Github:: * Automatic update of the Git mirror:: * CI testing on Travis-CI:: +* Releases on Github:: File: tlbuild.info, Node: Transfer from Subversion to Github, Next: Automatic update of the Git mirror, Up: Continuous integration @@ -2146,7 +2147,7 @@ from the Subversion repository and updates the 'master' branch with them, and the second pushes changes (if any) to Github. -File: tlbuild.info, Node: CI testing on Travis-CI, Prev: Automatic update of the Git mirror, Up: Continuous integration +File: tlbuild.info, Node: CI testing on Travis-CI, Next: Releases on Github, Prev: Automatic update of the Git mirror, Up: Continuous integration 9.3 CI testing on Travis-CI =========================== @@ -2162,6 +2163,23 @@ Travis-CI. automatically checkout the last pushed commit and try building it. +File: tlbuild.info, Node: Releases on Github, Prev: CI testing on Travis-CI, Up: Continuous integration + +9.4 Releases on Github +====================== + +Given a git checkout of 'texlive-source': + + git pull + git tag build-svnNNNN + git push --tags + +and the result will appear at +<https://github.com/TeX-Live/texlive-source/releases>. Releases can +also be made manually from that web page (see 'tl-update-bindir' for +hints). + + File: tlbuild.info, Node: install-tl, Next: tlmgr, Prev: Continuous integration, Up: Top Appendix A install-tl @@ -2206,9 +2224,9 @@ A.3 DESCRIPTION This installer creates a runnable TeX Live installation from various media, including over the network, from local hard disk, a DVD, etc. -The installer works across all platforms supported by TeX Live. For -information on initially downloading the TeX Live, see -<http://tug.org/texlive/acquire.html>. +The installer works on all platforms supported by TeX Live. For +information on initially downloading TeX Live, see +<https://tug.org/texlive/acquire.html>. The basic idea of TeX Live installation is for you to choose one of the top-level _schemes_, each of which is defined as a different set of @@ -2229,15 +2247,15 @@ File: tlbuild.info, Node: install-tl REFERENCES, Next: install-tl OPTIONS, Pr A.4 REFERENCES ============== -Post-installation configuration, package updates, and much more, are -handled through *tlmgr*(1), the TeX Live Manager -(<http://tug.org/texlive/tlmgr.html>). +Post-installation configuration, package updates, and more, are handled +through *tlmgr*(1), the TeX Live Manager +(<https://tug.org/texlive/tlmgr.html>). The most up-to-date version of this installer documentation is on the -Internet at <http://tug.org/texlive/doc/install-tl.html>. +Internet at <https://tug.org/texlive/doc/install-tl.html>. For the full documentation of TeX Live, see -<http://tug.org/texlive/doc>. +<https://tug.org/texlive/doc>. File: tlbuild.info, Node: install-tl OPTIONS, Next: install-tl PROFILES, Prev: install-tl REFERENCES, Up: install-tl @@ -2251,7 +2269,7 @@ by either a space or '='. *-gui* [[=]_module_] - If no _module_ is given, starts the 'perltk' (see below) GUI + If no _module_ is given, starts the Tcl/Tk (see below) GUI installer. If _module_ is given loads the given installer module. Currently @@ -2262,32 +2280,49 @@ by either a space or '='. The text mode user interface (default on Unix systems). Same as the '-no-gui' option. + 'tcl' + + The Tcl/Tk user interface (default on Macs and Windows). It + starts with a small number of configuration options, roughly + equivalent to what the wizard option below offers, but a + button 'Advanced' takes you to a screen with roughly the same + options as the 'perltk' interface. + 'wizard' - The wizard mode user interface (default on Windows), asking - only minimal questions before installing all of TeX Live. + The wizard mode user interface, asking only minimal questions + before installing all of TeX Live. + + 'expert' + + A generic name for, currently, 'perltk'; it may select a + different GUI in the future. 'perltk' The expert GUI installer, providing access to more options. - Can also be invoked on Windows by running - 'install-tl-advanced.bat'. - The 'perltk' and 'wizard' modules, and thus also when calling with - bare '-gui' (with no _module_), require the Perl/Tk module - (<http://tug.org/texlive/distro.html#perltk>); if Perl/Tk is not - available, installation continues in text mode. + The 'perltk' and 'wizard' modules require the Perl/Tk module + (<https://tug.org/texlive/distro.html#perltk>). if Perl/Tk is not + available, installation continues in text mode, except on Windows, + where all gui options except 'text' are diverted to the default + 'tcl' GUI. + + The 'tcl' GUI requires Tcl/Tk. This is standard on Macs and is + often already installed on GNU/Linux. For Windows, TeX Live + provides a Tcl/Tk runtime. *-no-gui* - Use the text mode installer (default except on Windows). + Use the text mode installer (default except on Windows and Macs). *-lang* _llcode_ By default, the GUI tries to deduce your language from the - environment (on Windows via the registry, on Unix via - 'LC_MESSAGES'). If that fails you can select a different language - by giving this option with a language code (based on ISO 639-1). + environment. The Tcl GUI uses the language detection built into + Tcl/Tk; the Perl/Tk GUIs use the 'LC_MESSAGES' environment + variable. If that fails you can select a different language by + giving this option with a language code (based on ISO 639-1). Currently supported (but not necessarily completely translated) are: English (en, default), Czech (cs), German (de), French (fr), Italian (it), Japanese (ja), Dutch (nl), Polish (pl), Brazilian @@ -2298,51 +2333,28 @@ by either a space or '='. *-repository* _url|path_ Specify the package repository to be used as the source of the - installation, either a local directory via '/path/to/directory' or - a 'file:/' url, or a network location via a 'http://', 'https://', - or 'ftp://' url. (No other protocols are supported, and 'https://' - may not work on all platforms.) - - The default is to pick a mirror automatically, using - <http://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 <http://ctan.org> for more - about CTAN and its mirrors. + installation. In short, this can be a directory name or a url + using http(s), ftp, or scp. The documentation for 'tlmgr' has the + details (<https://tug.org/texlive/doc/tlmgr.html#OPTIONS>). - If the repository is on the network, trailing '/' characters and/or - trailing '/tlpkg' and '/archive' components are ignored. For - example, you could choose a particular CTAN mirror with something - like this: - - -repository http://ctan.example.org/its/ctan/dir/systems/texlive/tlnet - - Of course a real hostname and its particular top-level CTAN - directory have to be specified. The list of CTAN mirrors is - available at <http://ctan.org/mirrors>. - - If the repository is local, the installation type (compressed or - live) is automatically determined, by checking for the presence of - a 'archive' directory relative to the root. Compressed is - preferred if both are available, since it is faster. Here's an - example of using a local directory: - - -repository /local/TL/repository + For installation, the default is to pick a mirror automatically, + using <http://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.) After installation is complete, you can use that installation as the repository for another installation. If you chose to install less than the full scheme containing all packages, the list of available schemes will be adjusted accordingly. - For backward compatibility and convenience, '--location' and - '--repo' are accepted as aliases for this option. - *-select-repository* - This option allows manual selection of a mirror from the current - list of active CTAN mirrors. This option is supported in all - installer modes (text, wizard, perltk), and will also offer to - install from local media if available, or from a repository - specified on the command line (see above). It's useful when the + This option allows you to choose a particular mirror from the + current list of active CTAN mirrors. This option is supported in + the 'text', 'wizard' and 'perltk' installer modes, and will also + offer to install from local media if available, or from a + repository specified on the command line. It's useful when the (default) automatic redirection does not choose a good host for you. @@ -2366,12 +2378,12 @@ by either a space or '='. binary sets, manually rename 'custom' before doing each. For more information on custom binaries, see - <http://tug.org/texlive/custom-bin.html>. For general information - on building TeX Live, see <http://tug.org/texlive/build.html>. + <https://tug.org/texlive/custom-bin.html>. For general information + on building TeX Live, see <https://tug.org/texlive/build.html>. *-debug-translation* - In GUI mode, this switch makes 'tlmgr' report any missing, or more + In the Perl/Tk GUI modes, this option reports any missing, or more likely untranslated, messages to standard error. Helpful for translators to see what remains to be done. @@ -2384,8 +2396,8 @@ by either a space or '='. *-help*, *-help*, *-?* - Display this help and exit. (This help is on the web at - <http://tug.org/texlive/doc/install-tl.html>). Sometimes the + Display this help and exit. (This help is also on the web at + <https://tug.org/texlive/doc/install-tl.html>). Sometimes the 'perldoc' and/or 'PAGER' programs on the system have problems, possibly resulting in control characters being literally output. This can't always be detected, but you can set the 'NOPERLDOC' @@ -2406,7 +2418,8 @@ by either a space or '='. Similar to *-profile* (see *note PROFILES: install-tl PROFILES. below), but only initializes the installation configuration from - _profile_file_ and then starts the interactive session. + _profile_file_ and then starts a normal interactive session. + Environment variables are not ignored. *-logfile* _file_ @@ -2422,15 +2435,10 @@ by either a space or '='. For the text mode installer only: do not clear the screen when entering a new menu (for debugging purposes). -*-non-admin* - - For Windows only: configure for the current user, not for all - users. +*-no-persistent-downloads* *-persistent-downloads* -*-no-persistent-downloads* - For network installs, activating this option makes the installer try to set up a persistent connection using the 'Net::LWP' Perl module. This opens only one connection between your computer and @@ -2449,7 +2457,12 @@ by either a space or '='. verified against a cryptographic signature. This option disables such verification. The full description is in the Crytographic Verification section of the 'tlmgr' documentation, e.g., - <http://tug.org/texlive/doc/tlmgr.html#CRYPTOGRAPHIC-VERIFICATION> + <https://tug.org/texlive/doc/tlmgr.html#CRYPTOGRAPHIC-VERIFICATION> + +*-non-admin* + + For Windows only: configure for the current user, not for all + users. *-portable* @@ -2465,8 +2478,9 @@ by either a space or '='. *-profile* _profile_file_ Load _profile_file_ and do the installation with no user - interaction, that is, a batch (unattended) install. See *note - PROFILES: install-tl PROFILES. below. + interaction, that is, a batch (unattended) install. Environment + variables are ignored. See *note PROFILES: install-tl PROFILES. + below. *-q* @@ -2489,8 +2503,8 @@ by either a space or '='. *-version*, *-version* - Output version information and exit. If '-v' has also been given - the revisions of the used modules are reported, too. + Output version information and exit. If '-v' is also given, the + versions of the TeX Live modules used are also reported. File: tlbuild.info, Node: install-tl PROFILES, Next: install-tl ENVIRONMENT VARIABLES, Prev: install-tl OPTIONS, Up: install-tl @@ -2502,11 +2516,18 @@ A _profile_ file contains all the values needed to perform an installation. After a normal installation has finished, a profile for that exact installation is written to the file 'tlpkg/texlive.profile'. In addition, from the text menu one can select 'P' to save the current -setup as a profile at any time. Such a profile file can be given as the -argument to '-profile', for example to redo the exact same installation -on a different system. Alternatively, you can use a custom profile, -most easily created by starting from a generated one and changing -values, or an empty file, which will take all the defaults. +setup as a profile at any time. + + Such a profile file can be given as the argument to '-profile', for +example to redo the exact same installation on a different system. +Alternatively, you can use a custom profile, most easily created by +starting from a generated one and changing values, or an empty file, +which will take all the defaults. + + As mentioned above, the installer only supports selection by scheme +and collections, not individual packages, so packages cannot be +specified in profile files either. Use 'tlmgr' to work at the package +level. Within a profile file, each line consists of @@ -2585,9 +2606,9 @@ value that could cause problems later. *tlpdb options* (prefix 'tlpdbopt_') - The definitive list is given in 'tlpkg/TeXLive/TLConfig.pm', in -'%TeXLive::TLConfig::TLPDBOptions', together with explanations. All -items given there _except_ for 'tlpdbopt_location' can be specified. + The definitive list is given in 'tlpkg/TeXLive/TLConfig.pm', in the +hash '%TeXLive::TLConfig::TLPDBOptions', together with explanations. +All items given there _except_ for 'tlpdbopt_location' can be specified. Here is the current list: tlpdbopt_autobackup @@ -2607,11 +2628,11 @@ Here is the current list: *platform options* (prefix 'binary_') For each supported platform in TeX Live (directories under 'bin/'), -the variable 'binary_'_PLATFORM_ can be set. For example: +the variable 'binary_'_PLATFORM_ can be set with value 1. For example: - binary_x86_64-linux + binary_x86_64-linux 1 - If no 'binary_' variable is specified, the default is whatever the + If no 'binary_' settings are made, the default is whatever the current machine is running. In releases before 2017, many profile variables had different names @@ -2620,7 +2641,7 @@ and transformed to the names given above. When a profile is written, the names above are always used. For more details on all of the above options, consult the TeX Live -installation manual, linked from <http://tug.org/texlive/doc>. +installation manual, linked from <https://tug.org/texlive/doc>. File: tlbuild.info, Node: install-tl ENVIRONMENT VARIABLES, Next: install-tl AUTHORS AND COPYRIGHT, Prev: install-tl PROFILES, Up: install-tl @@ -2628,10 +2649,20 @@ File: tlbuild.info, Node: install-tl ENVIRONMENT VARIABLES, Next: install-tl A A.7 ENVIRONMENT VARIABLES ========================= -For ease in scripting and debugging, 'install-tl' will look for the +For ease in scripting and debugging, 'install-tl' looks for the following environment variables. They are not of interest for normal user installations. +'TEXLIVE_DOWNLOADER' + +'TL_DOWNLOAD_PROGRAM' + +'TL_DOWNLOAD_ARGS' + + These override the normal choice of a download program; see the + 'tlmgr' documentation, e.g., + <https://tug.org/texlive/doc/tlmgr.html#ENVIRONMENT-VARIABLES>. + 'TEXLIVE_INSTALL_ENV_NOCHECK' Omit the check for environment variables containing the string @@ -2643,10 +2674,15 @@ user installations. Omit creating the ConTeXt cache. This is useful for redistributors. +'TEXLIVE_INSTALL_NO_IMPORT' + + Omit check for installing on top of a previous installation and + then asking about importing previous settings. + 'TEXLIVE_INSTALL_NO_WELCOME' Omit printing the welcome message after successful installation, - e.g., for testing. + e.g., when testing. 'TEXLIVE_INSTALL_PREFIX' @@ -2682,10 +2718,10 @@ A.8 AUTHORS AND COPYRIGHT ========================= This script and its documentation were written for the TeX Live -distribution (<http://tug.org/texlive>) and both are licensed under the +distribution (<https://tug.org/texlive>) and both are licensed under the GNU General Public License Version 2 or later. - $Id: install-tl 46908 2018-03-10 00:46:28Z preining $ + $Id: install-tl 54143 2020-03-06 23:51:18Z karl $ File: tlbuild.info, Node: tlmgr, Next: Index, Prev: install-tl, Up: Top @@ -2707,6 +2743,7 @@ Appendix B tlmgr * tlmgr MULTIPLE REPOSITORIES:: * tlmgr GUI FOR TLMGR:: * tlmgr MACHINE-READABLE OUTPUT:: +* tlmgr ENVIRONMENT VARIABLES:: * tlmgr AUTHORS AND COPYRIGHT:: @@ -2733,11 +2770,11 @@ B.3 DESCRIPTION *tlmgr* manages an existing TeX Live installation, both packages and configuration options. For information on initially downloading and -installing TeX Live, see <http://tug.org/texlive/acquire.html>. +installing TeX Live, see <https://tug.org/texlive/acquire.html>. The most up-to-date version of this documentation (updated nightly from the development sources) is available at -<http://tug.org/texlive/tlmgr.html>, along with procedures for updating +<https://tug.org/texlive/tlmgr.html>, along with procedures for updating 'tlmgr' itself and information about test versions. TeX Live is organized into a few top-level _schemes_, each of which @@ -2747,7 +2784,7 @@ files. Schemes typically contain a mix of collections and packages, but each package is included in exactly one collection, no more and no less. A TeX Live installation can be customized and managed at any level. - See <http://tug.org/texlive/doc> for all the TeX Live documentation + See <https://tug.org/texlive/doc> for all the TeX Live documentation available. @@ -2766,10 +2803,13 @@ with 'tlmgr': 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 continuing updates. The two commands are equivalent; 'ctan' is - just an alias for the given url. Caveat: 'mirror.ctan.org' - resolves to many different hosts, and they are not perfectly - synchronized; we recommend updating only daily (at most), and not - more often. + just an alias for the given url. + + Caveat: 'mirror.ctan.org' resolves to many different hosts, and + they are not perfectly synchronized; we recommend updating only + daily (at most), and not more often. You can choose a particular + mirror if problems; the list of all CTAN mirrors with the status of + each is at <https://ctan.org/mirrors/mirmon>. 'tlmgr update --list' @@ -2804,31 +2844,106 @@ name and its value. *-repository* _url|path_ - Specifies the package repository from which packages should be - installed or updated, overriding the default package repository - found in the installation's TeX Live Package Database (a.k.a. the - TLPDB, defined entirely in the file 'tlpkg/texlive.tlpdb'). The - documentation for 'install-tl' has more details about this - (<http://tug.org/texlive/doc/install-tl.html>). + Specify the package repository from which packages should be + installed or updated, either a local directory or network location, + as below. This overridesthe default package repository found in + the installation's TeX Live Package Database (a.k.a. the TLPDB, + which is given entirely in the file 'tlpkg/texlive.tlpdb'). + + This '--repository' option changes the location only for the + current run; to make a permanent change, use 'option repository' + (see the *note option: tlmgr option. action). - '--repository' changes the repository location only for the current - run; to make a permanent change, use 'option repository' (see the - *note option: tlmgr option. action). + As an example, you can choose a particular CTAN mirror with + something like this: + + -repository http://ctan.example.org/its/ctan/dir/systems/texlive/tlnet + + Of course a real hostname and its particular top-level CTAN + directory have to be specified. The list of CTAN mirrors is + available at <https://ctan.org/mirrors/mirmon>. + + Here's an example of using a local directory: + + -repository /local/TL/repository For backward compatibility and convenience, '--location' and '--repo' are accepted as aliases for this option. + Locations can be specified as any of the following: + + '/some/local/dir' + + 'file:/some/local/dir' + + Equivalent ways of specifying a local directory. + + 'ctan' + + 'http://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 + entire download. The bare 'ctan' is merely an alias for the + full url. (See <https://ctan.org> for more about CTAN and its + mirrors.) + + 'http://server/path/to/tlnet' + + Standard HTTP. If the (default) LWP method is used, persistent + connections are supported. TL can also use 'curl' or 'wget' + to do the downloads, or an arbitrary user-specified program, + as described in the 'tlmgr' documentation + (<https://tug.org/texlive/doc/tlmgr.html#ENVIRONMENT-VARIABLES>). + + 'https://server/path/to/tlnet' + + Again, if the (default) LWP method is used, this supports + persistent connections. Unfortunately, some versions of + 'wget' and 'curl' do not support https, and even when 'wget' + supports https, certificates may be rejected even when the + certificate is fine, due to a lack of local certificate roots. + The simplest workaround for this problem is to use http or + ftp. + + 'ftp://server/path/to/tlnet' + + If the (default) LWP method is used, persistent connections + are supported. + + 'user@machine:/path/to/tlnet' + + 'scp://user@machine/path/to/tlnet' + + 'ssh://user@machine/path/to/tlnet' + + These forms are equivalent; they all use 'scp' to transfer + files. Using 'ssh-agent' is recommended. (Info: + <https://en.wikipedia.org/wiki/OpenSSH>, + <https://en.wikipedia.org/wiki/Ssh-agent>.) + + If the repository is on the network, trailing '/' characters and/or + trailing '/tlpkg' and/or '/archive' components are ignored. + *-gui* [_action_] - 'tlmgr' has a graphical interface as well as the command line - interface. You can give this option, '--gui', together with an - action to be brought directly into the respective screen of the - GUI. For example, running + Two notable GUI front-ends for 'tlmgr', 'tlshell' and 'tlcockpit', + are started up as separate programs; see their own documentation. + + 'tlmgr' itself has a graphical interface as well as the command + line interface. You can give the option to invoke it, '--gui', + together with an action to be brought directly into the respective + screen of the GUI. For example, running tlmgr --gui update starts you directly at the update screen. If no action is given, - the GUI will be started at the main screen. + the GUI will be started at the main screen. See *note GUI FOR + TLMGR: tlmgr GUI FOR TLMGR. + + However, the native GUI requires Perl/TK, which is no longer + included in TeX Live's Perl distribution for Windows. You may find + 'tlshell' or 'tlcockpit' easier to work with. *-gui-lang* _llcode_ @@ -2838,10 +2953,12 @@ name and its value. by giving this option with a language code (based on ISO 639-1). Currently supported (but not necessarily completely translated) are: English (en, default), Czech (cs), German (de), French (fr), - Italian (it), Japanese (ja), Dutch (nl), Polish (pl), Brazilian - Portuguese (pt_BR), Russian (ru), Slovak (sk), Slovenian (sl), - Serbian (sr), Ukrainian (uk), Vietnamese (vi), simplified Chinese - (zh_CN), and traditional Chinese (zh_TW). + Italian (it), Japanese (ja), Dutch (nl), Polish (pl), + Brazilian Portuguese (pt_BR), Russian (ru), Slovak (sk), + Slovenian (sl), Serbian (sr), Ukrainian (uk), Vietnamese (vi), + simplified Chinese (zh_CN), and traditional Chinese (zh_TW). + + tlshell shares its message catalog with tlmgr. *-debug-translation* @@ -2936,7 +3053,7 @@ B.6 ACTIONS * tlmgr version:: * tlmgr backup:: * tlmgr candidates _pkg_:: -* tlmgr check [_option_...] [files|depends|executes|runfiles|all]:: +* tlmgr check [_option_...] [depends|executes|files|runfiles|texmfdbs|all]:: * tlmgr conf:: * tlmgr dump-tlpdb [_option_...] [--json]:: * tlmgr generate:: @@ -2970,7 +3087,7 @@ B.6.1 help ---------- Display this help information and exit (same as '--help', and on the web -at <http://tug.org/texlive/doc/tlmgr.html>). Sometimes the 'perldoc' +at <https://tug.org/texlive/doc/tlmgr.html>). Sometimes the 'perldoc' and/or 'PAGER' programs on the system have problems, resulting in control characters being literally output. This can't always be detected, but you can set the 'NOPERLDOC' environment variable and @@ -3002,7 +3119,10 @@ B.6.3 backup backups are saved to the value of the '--backupdir' option, if that is an existing and writable directory. If '--backupdir' is not given, the 'backupdir' option setting in the TLPDB is used, if - present. If both are missing, no backups are made. + present. If both are missing, no backups are made. (The installer + sets 'backupdir' to '.../tlpkg/backups', under the TL root + installation directory, so it is usually defined; see the *note + option: tlmgr option. description for more information.) If the '--clean' option is specified, backups are pruned (removed) instead of saved. The optional integer value _N_ may be specified @@ -3040,7 +3160,7 @@ B.6.3 backup to be performed are written to the terminal. -File: tlbuild.info, Node: tlmgr candidates _pkg_, Next: tlmgr check [_option_...] [files|depends|executes|runfiles|all], Prev: tlmgr backup, Up: tlmgr ACTIONS +File: tlbuild.info, Node: tlmgr candidates _pkg_, Next: tlmgr check [_option_...] [depends|executes|files|runfiles|texmfdbs|all], Prev: tlmgr backup, Up: tlmgr ACTIONS B.6.4 candidates _pkg_ ---------------------- @@ -3049,17 +3169,14 @@ Shows the available candidate repositories for package _pkg_. See *note MULTIPLE REPOSITORIES: tlmgr MULTIPLE REPOSITORIES. below. -File: tlbuild.info, Node: tlmgr check [_option_...] [files|depends|executes|runfiles|all], Next: tlmgr conf, Prev: tlmgr candidates _pkg_, Up: tlmgr ACTIONS +File: tlbuild.info, Node: tlmgr check [_option_...] [depends|executes|files|runfiles|texmfdbs|all], Next: tlmgr conf, Prev: tlmgr candidates _pkg_, Up: tlmgr ACTIONS -B.6.5 check [_option_...] [files|depends|executes|runfiles|all] ---------------------------------------------------------------- +B.6.5 check [_option_...] [depends|executes|files|runfiles|texmfdbs|all] +------------------------------------------------------------------------ -Executes one (or all) check(s) on the consistency of the installation. - -*files* - - Checks that all files listed in the local TLPDB ('texlive.tlpdb') - are actually present, and lists those missing. +Execute one (or all) check(s) of the consistency of the installation. +If no problems are found, there will be no output. (To get a view of +what is being done, run 'tlmgr -v check'.) *depends* @@ -3075,27 +3192,46 @@ Executes one (or all) check(s) on the consistency of the installation. Check that the files referred to by 'execute' directives in the TeX Live Database are present. +*files* + + Checks that all files listed in the local TLPDB ('texlive.tlpdb') + are actually present, and lists those missing. + *runfiles* List those filenames that are occurring more than one time in the - runfiles sections. + runfiles sections, except for known duplicates. + +*texmfdbs* + + Checks related to the 'ls-R' files. If you have defined new trees, + or changed the 'TEXMF' or 'TEXMFDBS' variables, it can't hurt to + run this. It checks that: + + - all items in 'TEXMFDBS' have the '!!' prefix. + + - all items in 'TEXMFBDS' have an 'ls-R' file (if they exist at all). + + - all items in 'TEXMF' with '!!' are listed in 'TEXMFDBS'. + + - all items in 'TEXMF' with an 'ls-R' file are listed in 'TEXMFDBS'. Options: *-use-svn* Use the output of 'svn status' instead of listing the files; for - checking the TL development repository. + checking the TL development repository. (This is run nightly.) -File: tlbuild.info, Node: tlmgr conf, Next: tlmgr dump-tlpdb [_option_...] [--json], Prev: tlmgr check [_option_...] [files|depends|executes|runfiles|all], Up: tlmgr ACTIONS +File: tlbuild.info, Node: tlmgr conf, Next: tlmgr dump-tlpdb [_option_...] [--json], Prev: tlmgr check [_option_...] [depends|executes|files|runfiles|texmfdbs|all], Up: tlmgr ACTIONS B.6.6 conf ---------- *conf [texmf|tlmgr|updmap [-conffile _file_] [-delete] [_key_ [_value_]]]* -*conf auxtrees [-conffile _file_] [show|add|delete] [_value_]* +*conf auxtrees [-conffile _file_] [show|add|remove] [_value_]* With only 'conf', show general configuration information for TeX Live, including active configuration files, path settings, and @@ -3130,15 +3266,16 @@ B.6.6 conf show' shows the list of additional trees, 'auxtrees add' _tree_ adds a tree to the list, and 'auxtrees remove' _tree_ removes a tree from the list (if present). The trees should not contain an - 'ls-R' file (or files might not be found if the 'ls-R' becomes + 'ls-R' file (or files will not be found if the 'ls-R' becomes stale). This works by manipulating the Kpathsea variable - 'TEXMFAUXTREES', in 'ROOT/texmf.cnf'. Example: + 'TEXMFAUXTREES', in (by default) 'ROOT/texmf.cnf'. Example: tlmgr conf auxtrees add /quick/test/tree tlmgr conf auxtrees remove /quick/test/tree In all cases the configuration file can be explicitly specified via - the option '--conffile' _file_, if desired. + the option '--conffile' _file_, e.g., if you don't want to change + the system-wide configuration. Warning: The general facility for changing configuration values is here, but tinkering with settings in this way is strongly @@ -3205,7 +3342,7 @@ Live installer and 'tlmgr' routinely call 'generate' for all of these files. For managing your own fonts, please read the 'updmap --help' -information and/or <http://tug.org/fonts/fontinstall.html>. +information and/or <https://tug.org/fonts/fontinstall.html>. For managing your own formats, please read the 'fmtutil --help' information. @@ -3356,6 +3493,13 @@ B.6.10 info used; only locally installed packages, collections, or schemes are listed. + *-only-remote* + + Only list packages from the remote repository. Useful when + checking what is available in a remote repository using 'tlmgr + --repo ... --only-remote info'. Note that '--only-installed' + and '--only-remote' cannot both be specified. + *-data 'item1,item2,...'* If the option '--data' is given, its argument must be a comma @@ -3393,8 +3537,8 @@ B.6.12 install [_option_...] _pkg_... ------------------------------------- Install each _pkg_ given on the command line, if it is not already -installed. (It does not touch existing packages; see the 'update' -action for how to get the latest version of a package.) +installed. It does not touch existing packages; see the 'update' action +for how to get the latest version of a package. By default this also installs all packages on which the given _pkg_s are dependent. Options: @@ -3454,6 +3598,10 @@ are dependent. Options: tlmgr install --reinstall --with-doc --with-src fontspec + This action does not automatically add new symlinks in system +directories; you need to run 'tlmgr path add' (*note path: tlmgr path.) +yourself if you are using this feature and want new symlinks added. + File: tlbuild.info, Node: tlmgr key, Next: tlmgr list, Prev: tlmgr install [_option_...] _pkg_..., Up: tlmgr ACTIONS @@ -3475,7 +3623,7 @@ B.6.13 key The 'add' argument requires another argument, either a filename or '-' for stdin, from which the key is added. The key is added to the local keyring 'GNUPGHOME/repository-keys.gpg', which is - normally) 'tlpkg/gpg/repository-keys.gpg'. + normally 'tlpkg/gpg/repository-keys.gpg'. The 'remove' argument requires a key id and removes the requested id from the local keyring. @@ -3496,7 +3644,7 @@ B.6.15 option *option [-json] [show]* -*option [-json] showall* +*option [-json] showall|help* *option _key_ [_value_]* @@ -3505,7 +3653,8 @@ saved in the TLPDB with a short description and the 'key' used for changing it in parentheses. The second form, 'showall', is similar, but also shows options which -can be defined but are not currently set to any value. +can be defined but are not currently set to any value ('help' is a +synonym). Both 'show...' forms take an option '--json', which dumps the option information in JSON format. In this case, both forms dump the same @@ -3519,7 +3668,7 @@ for _key_ is displayed. If _value_ is present, _key_ is set to _value_. definitive list): repository (default package repository), - formats (create formats at installation time), + formats (generate formats at installation or update time), postcode (run postinst code blobs) docfiles (install documentation files), srcfiles (install source files), @@ -3545,7 +3694,7 @@ possible values for 'repository'. (For backward compatibility, If 'formats' is set (this is the default), then formats are regenerated when either the engine or the format files have changed. Disable this only when you know how and want to regenerate formats -yourself. +yourself whenever needed (which is often, in practice). The 'postcode' option controls execution of per-package postinstallation action code. It is set by default, and again disabling @@ -3562,7 +3711,8 @@ downloaded at all. the actions 'update', 'backup' and 'restore'. These three actions need a directory in which to read or write the backups. If '--backupdir' is not specified on the command line, the 'backupdir' option value is used -(if set). +(if set). The TL installer sets 'backupdir' to '.../tlpkg/backups', +under the TL root installation directory. The 'autobackup' option (de)activates automatic generation of backups. Its value is an integer. If the 'autobackup' value is '-1', @@ -3600,7 +3750,7 @@ B.6.16 paper *paper [a4|letter]* -*[xdvi|pdftex|dvips|dvipdfmx|context|psutils] paper [_papersize_|-list]* +*<[xdvi|pdftex|dvips|dvipdfmx|context|psutils] paper [_papersize_|-list]*> *paper -json* @@ -3642,11 +3792,13 @@ B.6.17 path *path [-w32mode=user|admin] remove* - On Unix, merely adds or removes symlinks for binaries, man pages, - and info pages in the system directories specified by the - respective options (see the *note option: tlmgr option. description - above). Does not change any initialization files, either system or - personal. + On Unix, adds or removes symlinks for executables, man pages, and + info pages in the system directories specified by the respective + options (see the *note option: tlmgr option. description above). + Does not change any initialization files, either system or + personal. Furthermore, any executables added or removed by future + updates are not taken care of automatically; this command must be + rerun as needed. On Windows, the registry part where the binary directory is added or removed is determined in the following way: @@ -3725,8 +3877,8 @@ B.6.19 platform 'platform set auto' switches TeX Live to auto detection mode for platform. - Platform detection is needed to select the proper 'xz', 'xzdec' and - 'wget' binaries that are shipped with TeX Live. + Platform detection is needed to select the proper 'xz' and 'wget' + binaries that are shipped with TeX Live. 'arch' is a synonym for 'platform'. @@ -3847,6 +3999,11 @@ 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. + File: tlbuild.info, Node: tlmgr repository, Next: tlmgr restore, Prev: tlmgr remove [_option_...] _pkg_..., Up: tlmgr ACTIONS @@ -3855,7 +4012,7 @@ B.6.24 repository *repository list* -*repository list _path|tag_* +*repository list _path|url|tag_* *repository add _path_ [_tag_]* @@ -3863,22 +4020,44 @@ B.6.24 repository *repository set _path_[#_tag_] [_path_[#_tag_] ...]* +*repository status* + This action manages the list of repositories. See *note (MULTIPLE_REPOSITORIES):: below for detailed explanations. - The first form ('list') lists all configured repositories and the - respective tags if set. If a path, url, or tag is given after the - 'list' keyword, it is interpreted as source from where to - initialize a TeX Live Database and lists the contained packages. - This can also be an up-to-now not used repository, both locally and - remote. If one pass in addition '--with-platforms', for each - package the available platforms (if any) are listed, too. + The first form, 'repository list', lists all configured + repositories and the respective tags if set. If a path, url, or + tag is given after the 'list' keyword, it is interpreted as the + source from which to initialize a TL database and lists the + contained packages. This can also be an otherwise-unused + repository, either local or remote. If the option + '--with-platforms' is specified in addition, for each package the + available platforms (if any) are also listed. + + The form 'repository add' adds a repository (optionally attaching a + tag) to the list of repositories, while 'repository remove' removes + a repository, either by full path/url, or by tag. + + The form 'repository set' sets the list of available repositories + to the items given on the command line, overwriting previous + settings. + + The form 'repository status' reports the verification status of the + loaded repositories with the format of one repository per line with + fields separated by a single space: + + The tag (which can be the same as the url); + + = the url; + + = iff machine-readable output is specified, the verification + code (a number); - The third form ('add') adds a repository (optionally attaching a - tag) to the list of repositories. The forth form ('remove') - removes a repository, either by full path/url, or by tag. The last - form ('set') sets the list of repositories to the items given on - the command line, not keeping previous settings + = a textual description of the verification status, as the + last field extending to the end of line. + + That is, in normal (not machine-readable) output, the third field + (numeric verification status) is not present. In all cases, one of the repositories must be tagged as 'main'; otherwise, all operations will fail! @@ -4069,10 +4248,9 @@ must be specified. Options: *-all* - Update all installed packages except for 'tlmgr' itself. Thus, if - updates to 'tlmgr' itself are present, this will simply give an - error, unless also the option '--force' or '--self' is given. (See - below.) + Update all installed packages except for 'tlmgr' itself. If + updates to 'tlmgr' itself are present, this gives an error, unless + also the option '--force' or '--self' is given. (See below.) In addition to updating the installed packages, during the update of a collection the local installation is (by default) synchronized @@ -4090,7 +4268,8 @@ must be specified. Options: server that is also installed locally, it will be added to the local installation. This is called "auto-install" and is announced as such when using the option '--list'. This auto-installation can - be suppressed using the option '--no-auto-install'. + be suppressed using the option '--no-auto-install' (also not + recommended). An exception to the collection dependency checks (including the auto-installation of packages just mentioned) are those that have @@ -4099,6 +4278,14 @@ must be specified. Options: reinstall any such forcibly removed packages use '--reinstall-forcibly-removed'. + To reiterate: automatic removals and additions are entirely + determined by comparison of collections. Thus, if you manually + install an individual package 'foo' which is later removed from the + server, 'tlmgr' will not notice and will not remove it locally. + (It has to be this way, without major rearchitecture work, because + the tlpdb does not record the repository from which packages come + from.) + If you want to exclude some packages from the current update run (e.g., due to a slow link), see the '--exclude' option below. @@ -4162,12 +4349,13 @@ must be specified. Options: *-no-auto-remove* [_pkg_...] - By default, 'tlmgr' tries to remove packages which have disappeared - on the server, as described above under '--all'. This option - prevents such removals, either for all packages (with '--all'), or - for just the given _pkg_ names. This can lead to an inconsistent - TeX installation, since packages are not infrequently renamed or - replaced by their authors. Therefore this is not recommend. + By default, 'tlmgr' tries to remove packages in an existing + collection which have disappeared on the server, as described above + under '--all'. This option prevents such removals, either for all + packages (with '--all'), or for just the given _pkg_ names. This + can lead to an inconsistent TeX installation, since packages are + not infrequently renamed or replaced by their authors. Therefore + this is not recommended. *-no-auto-install* [_pkg_...] @@ -4188,6 +4376,9 @@ must be specified. Options: tlmgr update --all tlmgr remove --force foobar + Again, since packages are sometimes renamed or replaced, using this + option is not recommended. + *-reinstall-forcibly-removed* Under normal circumstances 'tlmgr' will not install packages that @@ -4207,8 +4398,8 @@ must be specified. Options: *-backupdir* _directory_ These two options control the creation of backups of packages - _before_ updating; that is, backup of packages as currently - installed. If neither options is given, no backup will made. If + _before_ updating; that is, backing up packages as currently + installed. If neither option is given, no backup will made. If '--backupdir' is given and specifies a writable directory then a backup will be made in that location. If only '--backup' is given, then a backup will be made to the directory previously set via the @@ -4258,14 +4449,18 @@ fallback information, but if you don't like them accumulating (e.g., 'mirror.ctan.org' resolves to many different hosts, each resulting in a possibly different hash), it's harmless to delete them. + This action does not automatically add or remove new symlinks in +system directories; you need to run 'tlmgr' *note path: tlmgr path. +yourself if you are using this feature and want new symlinks added. + File: tlbuild.info, Node: tlmgr CONFIGURATION FILE FOR TLMGR, Next: tlmgr CRYPTOGRAPHIC VERIFICATION, Prev: tlmgr ACTIONS, Up: tlmgr B.7 CONFIGURATION FILE FOR TLMGR ================================ -There are two configuration files for 'tlmgr': One is system-wide in -'TEXMFSYSCONFIG/tlmgr/config', and the other is user-specific in +'tlmgr' reads two configuration files: one is system-wide, in +'TEXMFSYSCONFIG/tlmgr/config', and the other is user-specific, in 'TEXMFCONFIG/tlmgr/config'. The user-specific one is the default for the 'conf tlmgr' action. (Run 'kpsewhich -var-value=TEXMFSYSCONFIG' or '... TEXMFCONFIG ...' to see the actual directory names.) @@ -4315,8 +4510,8 @@ 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 (<http://openssl.org>), the 'sha512sum' program (from GNU -Coreutils, <http://www.gnu.org/software/coreutils>), or finally the +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 @@ -4358,9 +4553,10 @@ above) to succeed, and a working GnuPG ('gpg') program (see below for search method). Then, unless cryptographic verification has been disabled, a signature file ('texlive.tlpdb.*.asc') of the checksum file is downloaded and the signature verified. The signature is created by -the TeX Live Distribution GPG key 0x06BAB6BC, which in turn is signed by -Karl Berry's key 0x30D155AD and Norbert Preining's key 0x6CACA448. All -of these keys are obtainable from the standard key servers. +the TeX Live Distribution GPG key 0x0D5E5D9106BAB6BC, which in turn is +signed by Karl Berry's key 0x0716748A30D155AD and Norbert Preining's key +0x6CACA448860CDC13. All of these keys are obtainable from the standard +key servers. Additional trusted keys can be added using the 'key' action. @@ -4551,50 +4747,48 @@ only one enabled (as is the case by default): List of repositories (with tags if set): /var/www/norbert/tlnet - Ok. Let's add the 'tlcontrib' repository (this is a real repository, -hosted at <http://tlcontrib.metatex.org>, maintained by Taco Hoekwater -et al.), with the tag 'tlcontrib': + Ok. Let's add the 'tlcontrib' repository (this is a real repository +hosted at <http://contrib.texlive.info>) with the tag 'tlcontrib': - $ tlmgr repository add http://tlcontrib.metatex.org/2012 tlcontrib + $ tlmgr repository add http://contrib.texlive.info/current tlcontrib Check the repository list again: $ tlmgr repository list List of repositories (with tags if set): - http://tlcontrib.metatex.org/2012 (tlcontrib) + http://contrib.texlive.info/current (tlcontrib) /var/www/norbert/tlnet (main) - Now we specify a pinning entry to get the package 'context' from + Now we specify a pinning entry to get the package 'classico' from 'tlcontrib': - $ tlmgr pinning add tlcontrib context + $ tlmgr pinning add tlcontrib classico - Check that we can find 'context': + Check that we can find 'classico': - $ tlmgr show context - tlmgr: package repositories: + $ tlmgr show classico + package: classico ... - package: context - repository: tlcontrib/26867 + shortdesc: URW Classico fonts ... - - install 'context': + - install 'classico': - $ tlmgr install context + $ tlmgr install classico tlmgr: package repositories: ... - [1/1, ??:??/??:??] install: context @tlcontrib [ + [1/1, ??:??/??:??] install: classico @tlcontrib [737k] - In the output here you can see that the 'context' package has been + In the output here you can see that the 'classico' package has been installed from the 'tlcontrib' repository ('@tlcontrib'). Finally, 'tlmgr pinning' also supports removing certain or all packages from a given repository: - $ tlmgr pinning remove tlcontrib context # remove just context + $ tlmgr pinning remove tlcontrib classico # remove just classico $ tlmgr pinning remove tlcontrib --all # take nothing from tlcontrib - A summary of the 'tlmgr pinning' actions is given above. + A summary of 'tlmgr pinning' actions is given above. File: tlbuild.info, Node: tlmgr GUI FOR TLMGR, Next: tlmgr MACHINE-READABLE OUTPUT, Prev: tlmgr MULTIPLE REPOSITORIES, Up: tlmgr @@ -4603,16 +4797,22 @@ B.11 GUI FOR TLMGR ================== The graphical user interface for 'tlmgr' requires Perl/Tk -<http://search.cpan.org/search?query=perl%2Ftk>. For Windows the -necessary modules are shipped within TeX Live, for all other (i.e., -Unix-based) systems Perl/Tk (as well as Perl of course) has to be -installed outside of TL. <http://tug.org/texlive/distro.html#perltk> has -a list of invocations for some distros. - - The GUI is started with the invocation 'tlmgr gui'; assuming Tk is -loadable, the graphical user interface will be shown. The main window -contains a menu bar, the main display, and a status area where messages -normally shown on the console are displayed. +<https://search.cpan.org/search?query=perl%2Ftk>. For Unix-based +systems Perl/Tk (as well as Perl of course) has to be installed outside +of TL. <https://tug.org/texlive/distro.html#perltk> has a list of +invocations for some distros. For Windows the necessary modules are no +longer shipped within TeX Live, so you'll have to have an external Perl +available that includes them. + + We are talking here about the GUI built into tlmgr itself, not about +the other tlmgr GUIs, which are: tlshell (Tcl/Tk-based), tlcockpit +(Java-based) and, only on Macs, TeX Live Utility. These are invoked as +separate programs. + + The GUI mode of tlmgr is started with the invocation 'tlmgr gui'; +assuming Tk is loadable, the graphical user interface will be shown. +The main window contains a menu bar, the main display, and a status area +where messages normally shown on the console are displayed. Within the main display there are three main parts: the 'Display configuration' area, the list of packages, and the action buttons. @@ -4818,7 +5018,7 @@ The following entries can be found in the menu bar: 'Help menu' Provides access to the TeX Live manual (also on the web at - <http://tug.org/texlive/doc.html>) and the usual "About" box. + <https://tug.org/texlive/doc.html>) and the usual "About" box. File: tlbuild.info, Node: tlmgr GUI options, Prev: tlmgr Menu bar, Up: tlmgr GUI FOR TLMGR @@ -4853,11 +5053,11 @@ control the display: Pass the arbitrary X resource string _xresource_. A few other obscure options are recognized but not mentioned here. -See the Perl/Tk documentation (<http://search.cpan.org/perldoc?Tk>) for +See the Perl/Tk documentation (<https://search.cpan.org/perldoc?Tk>) for the complete list, and any X documentation for general information. -File: tlbuild.info, Node: tlmgr MACHINE-READABLE OUTPUT, Next: tlmgr AUTHORS AND COPYRIGHT, Prev: tlmgr GUI FOR TLMGR, Up: tlmgr +File: tlbuild.info, Node: tlmgr MACHINE-READABLE OUTPUT, Next: tlmgr ENVIRONMENT VARIABLES, Prev: tlmgr GUI FOR TLMGR, Up: tlmgr B.12 MACHINE-READABLE OUTPUT ============================ @@ -5012,16 +5212,101 @@ shown. changes would be helpful, do not hesitate to write the mailing list. -File: tlbuild.info, Node: tlmgr AUTHORS AND COPYRIGHT, Prev: tlmgr MACHINE-READABLE OUTPUT, Up: tlmgr +File: tlbuild.info, Node: tlmgr ENVIRONMENT VARIABLES, Next: tlmgr AUTHORS AND COPYRIGHT, Prev: tlmgr MACHINE-READABLE OUTPUT, Up: tlmgr -B.13 AUTHORS AND COPYRIGHT +B.13 ENVIRONMENT VARIABLES +========================== + +'tlmgr' uses many of the standard TeX environment variables, as reported +by, e.g., 'tlmgr conf' (*note conf: tlmgr conf.). + + In addition, for ease in scripting and debugging, 'tlmgr' looks for +the following environment variables. These are not of interest for +normal user installations. + +'TEXLIVE_COMPRESSOR' + + This variable allows selecting a different compressor program for + backups and intermediate rollback containers. The order of + selection is: + + 1. If the environment variable 'TEXLIVE_COMPRESSOR' is defined, + use it; abort if it doesn't work. Possible values: 'lz4', + 'gzip', 'xz'. The necessary options are added internally. + + 2. If lz4 is available (either from the system or TL) and + working, use that. + + 3. If gzip is available (from the system) and working, use that. + + 4. If xz is available (either from the system or TL) and working, + use that. + + lz4 and gzip are faster in creating tlmgr's local backups, hence + they are preferred. The unconditional use of xz for the tlnet + containers is unaffected, to minimize download sizes. + +'TEXLIVE_DOWNLOADER' + +'TL_DOWNLOAD_PROGRAM' + +'TL_DOWNLOAD_ARGS' + + These options allow selecting different download programs then the + ones automatically selected by the installer. The order of + selection is: + + 1. If the environment variable 'TEXLIVE_DOWNLOADER' is defined, + use it; abort if the specified program doesn't work. Possible + values: 'lwp', 'curl', 'wget'. The necessary options are + added internally. + + 2. If the environment variable 'TL_DOWNLOAD_PROGRAM' is defined + (can be any value), use it together with 'TL_DOWNLOAD_ARGS'; + abort if it doesn't work. + + 3. If LWP is available and working, use that (by far the most + efficient method, as it supports persistent downloads). + + 4. If curl is available (from the system) and working, use that. + + 5. If wget is available (either from the system or TL) and + working, use that. + + TL provides 'wget' binaries for platforms where necessary, so some + download method should always be available. + +'TEXLIVE_PREFER_OWN' + + By default, compression and download programs provided by the + system, i.e., found along 'PATH' are preferred over those shipped + with TeX Live. + + This can create problems with systems that are too old, and so can + be overridden by setting the environment variable + 'TEXLIVE_PREFER_OWN' to 1. In this case, executables shipped with + TL will be preferred. + + Extra compression/download programs not provided by TL, such as + gzip, lwp, and curl, are still checked for on the system and used + if available, per the above. 'TEXLIVE_PREFER_OWN' only applies + when the program being checked for is shipped with TL, namely the + lz4 and xz compressors and wget downloader. + + Exception: on Windows, the 'tar.exe' shipped with TL is always + used, regardless of any setting. + + +File: tlbuild.info, Node: tlmgr AUTHORS AND COPYRIGHT, Prev: tlmgr ENVIRONMENT VARIABLES, Up: tlmgr + +B.14 AUTHORS AND COPYRIGHT ========================== This script and its documentation were written for the TeX Live -distribution (<http://tug.org/texlive>) and both are licensed under the +distribution (<https://tug.org/texlive>) and both are licensed under the GNU General Public License Version 2 or later. - $Id: tlmgr.pl 47303 2018-04-05 17:52:22Z karl $ + $Id: tlmgr.pl 54118 2020-03-05 22:27:22Z karl $ File: tlbuild.info, Node: Index, Prev: tlmgr, Up: Top @@ -5157,7 +5442,7 @@ Index * ANSI C: Declarations and definitions. (line 6) * ApplicationServices Mac framework, required by xetex: Prerequisites. - (line 32) + (line 31) * asymptote: Linked scripts. (line 23) * asymptote <1>: asymptote. (line 6) * Autoconf: Overview of build system. @@ -5188,6 +5473,7 @@ 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, ANSI, required: Declarations and definitions. (line 6) @@ -5198,7 +5484,7 @@ Index * callexe.c: Macros for Windows. (line 32) * CC: Variables for configure. (line 10) -* CC=C-COMPILER: Build one package. (line 76) +* CC=C-COMPILER: Build one package. (line 78) * CC_BUILD: Cross problems. (line 13) * chktex: Declarations and definitions. (line 18) @@ -5208,8 +5494,8 @@ Index (line 17) * CLISP <1>: Configure options for utils/xindy. (line 14) -* clisp, required by xindy: Prerequisites. (line 36) -* Cocoa Mac framework, required by xetex: Prerequisites. (line 32) +* clisp, required by xindy: Prerequisites. (line 35) +* Cocoa Mac framework, required by xetex: Prerequisites. (line 31) * coding conventions: Coding conventions. (line 6) * compilers, C and C++11: Prerequisites. (line 6) * config.guess, config.sub, ...: Top-level directories. @@ -5255,7 +5541,7 @@ Index * ctangle: Cross problems. (line 26) * CXX: Variables for configure. (line 11) -* CXX=C++-COMPILER: Build one package. (line 76) +* CXX=C++-COMPILER: Build one package. (line 78) * declarations and definitions, in source code: Declarations and definitions. (line 6) * declarations before statements, avoiding: Declarations and definitions. @@ -5287,7 +5573,7 @@ Index * 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 32) +* fontconfig library, required by xetex: Prerequisites. (line 31) * FreeType: Prerequisites. (line 11) * freetype cross compiling: Cross problems. (line 13) * freetype library: freetype library. (line 6) @@ -5296,7 +5582,7 @@ Index (line 24) * FT2_CONFIG: Variables for configure. (line 21) -* gcc, default compilers: Build one package. (line 76) +* gcc, default compilers: Build one package. (line 78) * general setup macros: General setup macros. (line 6) * generic library module, adding: Adding a new generic library module. (line 6) @@ -5416,7 +5702,7 @@ Index * library modules: Library modules. (line 6) * library-specific configure options: Library-specific configure options. (line 6) -* libsigsegv, required by xindy: Prerequisites. (line 36) +* libsigsegv, required by xindy: Prerequisites. (line 35) * libstc++, statically linking: Macros for compilers. (line 29) * Libtool: Overview of build system. (line 6) @@ -5455,7 +5741,7 @@ Index * motif: Configure options for texk/xdvik. (line 9) * native cross compilation: Cross compilation. (line 10) -* OBJCXX=OBJC-COMPILER: Build one package. (line 76) +* OBJCXX=OBJC-COMPILER: Build one package. (line 78) * one engine, building: Build one engine. (line 6) * one package, building: Build one package. (line 6) * OpenGL, required for Asymptote: asymptote. (line 6) @@ -5470,7 +5756,7 @@ Index (line 41) * PERL: Variables for configure. (line 39) -* perl, required by web2c, etc.: Prerequisites. (line 24) +* perl, required by web2c, etc.: Prerequisites. (line 23) * PKG_CONFIG: Variables for configure. (line 23) * plain.tex, not in source tree: Installing. (line 8) @@ -5500,7 +5786,7 @@ Index * setup macros, general: General setup macros. (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 60) +* size of source tree: Build one package. (line 53) * source code declarations: Declarations and definitions. (line 6) * source directory building, not supported: Building. (line 17) @@ -5562,7 +5848,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 28) +* X11 development, required by X clients: Prerequisites. (line 27) * X11 headers, and const: Const. (line 21) * xasy: asymptote. (line 6) * xaw: Configure options for texk/xdvik. @@ -5591,369 +5877,405 @@ Index Tag Table: Node: Top1208 Node: Introduction2118 -Node: Overview of build system3946 -Node: Prerequisites5997 -Node: Building8616 -Node: Build iteration10002 -Node: Build problems11043 -Node: Build in parallel11497 -Node: Build distribution12101 -Node: Build one package12749 -Node: Build one engine16384 -Node: Cross compilation17399 -Node: Cross configuring18679 -Node: Cross problems20356 -Node: Installing22018 -Node: Installation directories23038 -Node: Linked scripts24856 -Node: Distro builds26347 -Node: Layout and infrastructure28723 -Node: Build system tools29554 -Node: Top-level directories31800 -Node: Autoconf macros34036 -Node: General setup macros34798 -Node: Macros for programs35673 -Node: Macros for compilers36474 -Node: Macros for libraries37882 -Node: Macros for library and header flags38308 -Node: Macros for Windows40219 -Node: Library modules41806 -Node: png library42295 -Node: zlib library44643 -Node: freetype library45158 -Node: kpathsea library45854 -Node: Program modules47233 -Node: t1utils package47661 -Node: xindy package48206 -Node: xdvik package49320 -Node: asymptote50379 -Node: Extending TeX Live50875 -Node: Adding a new program module51658 -Node: Adding a new generic library module54997 -Node: Adding a new TeX-specific library module57226 -Node: Configure options57924 -Node: Global configure options59305 -Node: --disable-native-texlive-build59847 -Node: --prefix --bindir ...60809 -Node: --disable-largefile61349 -Node: --disable-missing62050 -Node: --enable-compiler-warnings=LEVEL62451 -Node: --enable-cxx-runtime-hack63107 -Node: --enable-maintainer-mode63527 -Node: --enable-multiplatform64056 -Node: --enable-shared64629 -Node: --enable-silent-rules65000 -Node: --without-ln-s65452 -Node: --without-x65799 -Node: Program-specific configure options65987 -Node: --enable-PROG --disable-PROG66630 -Node: --disable-all-pkgs66903 -Node: Configure options for texk/web2c67686 -Node: Configure options for texk/bibtex-x70224 -Node: Configure options for texk/dvipdfm-x70767 -Node: Configure options for texk/dvisvgm71543 -Node: Configure options for texk/texlive72424 -Node: Configure options for texk/xdvik72845 -Node: Configure options for utils/xindy73466 -Node: Library-specific configure options74356 -Node: Configure options for kpathsea75358 -Node: Configure options for system poppler76107 -Node: Variables for configure76871 -Node: Coding conventions78297 -Node: Declarations and definitions79012 -Node: Const81186 -Node: Continuous integration83050 -Node: Transfer from Subversion to Github83691 -Node: Automatic update of the Git mirror85853 -Node: CI testing on Travis-CI86435 -Node: install-tl87117 -Node: install-tl NAME87486 -Node: install-tl SYNOPSIS87644 -Node: install-tl DESCRIPTION87902 -Node: install-tl REFERENCES88969 -Node: install-tl OPTIONS89495 -Ref: install-tl *-gui* [[=]_module_]89836 -Ref: install-tl text90046 -Ref: install-tl wizard90169 -Ref: install-tl perltk90323 -Ref: install-tl *-no-gui*90754 -Ref: install-tl *-lang* _llcode_90835 -Ref: install-tl *-repository* _url|path_91522 -Ref: install-tl *-select-repository*93402 -Ref: install-tl *-all-options*93838 -Ref: install-tl *-custom-bin* _path_94093 -Ref: install-tl *-debug-translation*94925 -Ref: install-tl *-force-platform* _platform_95144 -Ref: install-tl *-help*, *--help*, *-?*95388 -Ref: install-tl *-in-place*95795 -Ref: install-tl *-init-from-profile* _profile_file_96340 -Ref: install-tl *-logfile* _file_96560 -Ref: install-tl *-no-cls*96911 -Ref: install-tl *-non-admin*97045 -Ref: install-tl *-persistent-downloads*97150 -Ref: install-tl *-no-persistent-downloads*97178 -Ref: install-tl *-no-verify-downloads*97796 -Ref: install-tl *-portable*98157 -Ref: install-tl *-print-platform*98296 -Ref: install-tl *-profile* _profile_file_98494 -Ref: install-tl *-q*98674 -Ref: install-tl *-scheme* _scheme_98736 -Ref: install-tl *-v*99210 -Ref: install-tl *-version*, *--version*99365 -Node: install-tl PROFILES99496 -Ref: install-tl instopt_adjustpath (default 0 on Unix, 1 on Windows)102146 -Ref: install-tl instopt_adjustrepo (default 1)102222 -Ref: install-tl instopt_letter (default 0)102359 -Ref: install-tl instopt_portable (default 0)102450 -Ref: install-tl instopt_write18_restricted (default 1)102546 -Node: install-tl ENVIRONMENT VARIABLES103865 -Ref: install-tl TEXLIVE_INSTALL_ENV_NOCHECK104256 -Ref: install-tl TEXLIVE_INSTALL_NO_CONTEXT_CACHE104458 -Ref: install-tl TEXLIVE_INSTALL_NO_WELCOME104568 -Ref: install-tl TEXLIVE_INSTALL_PREFIX104689 -Ref: install-tl TEXLIVE_INSTALL_TEXDIR104715 -Ref: install-tl TEXLIVE_INSTALL_TEXMFCONFIG104746 -Ref: install-tl TEXLIVE_INSTALL_TEXMFVAR104774 -Ref: install-tl TEXLIVE_INSTALL_TEXMFHOME104803 -Ref: install-tl TEXLIVE_INSTALL_TEXMFLOCAL104833 -Ref: install-tl TEXLIVE_INSTALL_TEXMFSYSCONFIG104867 -Ref: install-tl TEXLIVE_INSTALL_TEXMFSYSVAR104898 -Ref: install-tl NOPERLDOC105269 -Node: install-tl AUTHORS AND COPYRIGHT105333 -Node: tlmgr105749 -Node: tlmgr NAME106202 -Node: tlmgr SYNOPSIS106334 -Node: tlmgr DESCRIPTION106524 -Node: tlmgr EXAMPLES107620 -Ref: tlmgr tlmgr option repository ctan107871 -Ref: tlmgr tlmgr option repository http://mirror.ctan.org/systems/texlive/tlnet107943 -Ref: tlmgr tlmgr update --list108395 -Ref: tlmgr tlmgr update --all108488 -Ref: tlmgr tlmgr info _what_108645 -Node: tlmgr OPTIONS108907 -Ref: tlmgr *--repository* _url|path_109427 -Ref: tlmgr *--gui* [_action_]110152 -Ref: tlmgr *--gui-lang* _llcode_110559 -Ref: tlmgr *--debug-translation*111242 -Ref: tlmgr *--machine-readable*111445 -Ref: tlmgr *--no-execute-actions*111713 -Ref: tlmgr *--package-logfile* _file_111906 -Ref: tlmgr *--pause*112160 -Ref: tlmgr *--persistent-downloads*112315 -Ref: tlmgr *--no-persistent-downloads*112343 -Ref: tlmgr *--pin-file*112837 -Ref: tlmgr *--usermode*113055 -Ref: tlmgr *--usertree* _dir_113175 -Ref: tlmgr *--verify-repo=[none|main|all]*113301 -Node: tlmgr ACTIONS114200 -Node: tlmgr help115052 -Node: tlmgr version115528 -Node: tlmgr backup115791 -Ref: tlmgr *backup [_option_...] --all*115962 -Ref: tlmgr *backup [_option_...] _pkg_...*115995 -Ref: tlmgr *--backupdir* _directory_116850 -Ref: tlmgr *--all*117067 -Ref: tlmgr *--clean*[=_N_]117319 -Ref: tlmgr *--dry-run*117646 -Node: tlmgr candidates _pkg_117776 -Node: tlmgr check [_option_...] [files|depends|executes|runfiles|all]118122 -Ref: tlmgr *files*118495 -Ref: tlmgr *depends*118630 -Ref: tlmgr *executes*118972 -Ref: tlmgr *runfiles*119090 -Ref: tlmgr *--use-svn*119211 -Node: tlmgr conf119328 -Ref: tlmgr *conf [texmf|tlmgr|updmap [--conffile _file_] [--delete] [_key_ [_value_]]]*119607 -Ref: tlmgr *conf auxtrees [--conffile _file_] [show|add|delete] [_value_]*119671 -Node: tlmgr dump-tlpdb [_option_...] [--json]122016 -Ref: tlmgr *--local*122449 -Ref: tlmgr *--remote*122488 -Ref: tlmgr *--json*122526 -Node: tlmgr generate123097 -Ref: tlmgr *generate [_option_...] language*123293 -Ref: tlmgr *generate [_option_...] language.dat*123332 -Ref: tlmgr *generate [_option_...] language.def*123371 -Ref: tlmgr *generate [_option_...] language.dat.lua*123414 -Ref: tlmgr *--dest* _output_file_125740 -Ref: tlmgr *--localcfg* _local_conf_file_126316 -Ref: tlmgr *--rebuild-sys*126439 -Node: tlmgr gui127254 -Node: tlmgr info127432 -Ref: tlmgr *info [_option_...] _pkg_...*127594 -Ref: tlmgr *info [_option_...] collections*127628 -Ref: tlmgr *info [_option_...] schemes*127658 -Ref: tlmgr *--list*129188 -Ref: tlmgr *--only-installed*129502 -Ref: tlmgr *--data item1,item2,...*129701 -Ref: tlmgr *--json* 1130282 -Node: tlmgr init-usertree130665 -Node: tlmgr install [_option_...] _pkg_...131046 -Ref: tlmgr *--dry-run* 1131556 -Ref: tlmgr *--file*131673 -Ref: tlmgr *--force*131895 -Ref: tlmgr *--no-depends*132115 -Ref: tlmgr *--no-depends-at-all*132274 -Ref: tlmgr *--reinstall*132674 -Ref: tlmgr *--with-doc*133052 -Ref: tlmgr *--with-src*133065 -Node: tlmgr key133587 -Ref: tlmgr *key list*133745 -Ref: tlmgr *key add _file_*133763 -Ref: tlmgr *key remove _keyid_*133785 -Node: tlmgr list134380 -Node: tlmgr option134542 -Ref: tlmgr *option [--json] [show]*134697 -Ref: tlmgr *option [--json] showall*134723 -Ref: tlmgr *option _key_ [_value_]*134749 -Node: tlmgr paper139146 -Ref: tlmgr *paper [a4|letter]*139295 -Ref: tlmgr *[xdvi|pdftex|dvips|dvipdfmx|context|psutils] paper [_papersize_|--list]*139369 -Ref: tlmgr *paper --json*139384 -Node: tlmgr path140599 -Ref: tlmgr *path [--w32mode=user|admin] add*140760 -Ref: tlmgr *path [--w32mode=user|admin] remove*140797 -Node: tlmgr pinning142137 -Ref: tlmgr pinning show142378 -Ref: tlmgr pinning add _repo_ _pkgglob_...142451 -Ref: tlmgr pinning remove _repo_ _pkgglob_...142570 -Ref: tlmgr pinning remove _repo_ --all142723 -Node: tlmgr platform142777 -Ref: tlmgr *platform list|add|remove _platform_...*142963 -Ref: tlmgr *platform set _platform_*142990 -Ref: tlmgr *platform set auto*143011 -Ref: tlmgr *--dry-run* 2143897 -Node: tlmgr postaction144016 -Ref: tlmgr *postaction [_option_...] install [shortcut|fileassoc|script] [_pkg_...]*144246 -Ref: tlmgr *postaction [_option_...] remove [shortcut|fileassoc|script] [_pkg_...]*144320 -Ref: tlmgr *--w32mode=[user|admin]*144635 -Ref: tlmgr *--fileassocmode=[1|2]*145051 -Ref: tlmgr *--all* 1145336 -Node: tlmgr print-platform145391 -Node: tlmgr print-platform-info145722 -Node: tlmgr remove [_option_...] _pkg_...146022 -Ref: tlmgr *--all* 2146506 -Ref: tlmgr *--backup*146616 -Ref: tlmgr *--backupdir* _directory_ 1146642 -Ref: tlmgr *--no-depends* 1147047 -Ref: tlmgr *--no-depends-at-all* 1147109 -Ref: tlmgr *--force* 1147212 -Ref: tlmgr *--dry-run* 3147685 -Node: tlmgr repository147792 -Ref: tlmgr *repository list*147980 -Ref: tlmgr *repository list _path|tag_*148010 -Ref: tlmgr *repository add _path_ [_tag_]*148043 -Ref: tlmgr *repository remove _path|tag_*148075 -Ref: tlmgr *repository set _path_[#_tag_] [_path_[#_tag_] ...]*148129 -Node: tlmgr restore149182 -Ref: tlmgr *restore [_option_...] _pkg_ [_rev_]*149361 -Ref: tlmgr *restore [_option_...] --all*149391 -Ref: tlmgr *--all* 3150091 -Ref: tlmgr *--backupdir* _directory_ 2150305 -Ref: tlmgr *--dry-run* 4150486 -Ref: tlmgr *--force* 2150618 -Ref: tlmgr *--json* 2150664 -Node: tlmgr search150991 -Ref: tlmgr *search [_option_...] _what_*151155 -Ref: tlmgr *search [_option_...] --file _what_*151192 -Ref: tlmgr *search [_option_...] --all _what_*151228 -Ref: tlmgr *--file* 1151448 -Ref: tlmgr *--all* 4151510 -Ref: tlmgr *--global*151599 -Ref: tlmgr *--word*151726 -Node: tlmgr shell152041 -Ref: tlmgr protocol152776 -Ref: tlmgr help 1152840 -Ref: tlmgr version 1152893 -Ref: tlmgr quit, end, bye, byebye, EOF152961 -Ref: tlmgr restart152982 -Ref: tlmgr load [local|remote]153105 -Ref: tlmgr save153175 -Ref: tlmgr get [_var_] =item set [_var_ [_val_]]153298 -Node: tlmgr show153899 -Node: tlmgr uninstall154066 -Node: tlmgr update [_option_...] [_pkg_...]154296 -Ref: tlmgr *--all* 5154667 -Ref: tlmgr *--self*156408 -Ref: tlmgr *--dry-run* 5157172 -Ref: tlmgr *--list* [_pkg_]157349 -Ref: tlmgr *--exclude* _pkg_158038 -Ref: tlmgr *--no-auto-remove* [_pkg_...]158838 -Ref: tlmgr *--no-auto-install* [_pkg_...]159289 -Ref: tlmgr *--reinstall-forcibly-removed*159945 -Ref: tlmgr *--backup* 1160480 -Ref: tlmgr *--backupdir* _directory_ 3160506 -Ref: tlmgr *--no-depends* 2161672 -Ref: tlmgr *--no-depends-at-all* 2161875 -Ref: tlmgr *--force* 3161978 -Node: tlmgr CONFIGURATION FILE FOR TLMGR162793 -Ref: tlmgr auto-remove, value 0 or 1 (default 1), same as command-line option.163806 -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.163943 -Ref: tlmgr gui-lang _llcode_, with a language code value as with the command-line option.164025 -Ref: tlmgr no-checksums, value 0 or 1 (default 0, see below).164079 -Ref: tlmgr persistent-downloads, value 0 or 1 (default 1), same as command-line option.164159 -Ref: tlmgr require-verification, value 0 or 1 (default 0), same as command-line option.164239 -Ref: tlmgr update-exclude, value: comma-separated list of packages (no space allowed). Same as the command line option --exclude for the action update.164387 -Ref: tlmgr verify-downloads, value 0 or 1 (default 1), same as command-line option.164463 -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).164732 -Node: tlmgr CRYPTOGRAPHIC VERIFICATION165818 -Node: tlmgr Configuration of GnuPG invocation167967 -Node: tlmgr USER MODE168605 -Node: tlmgr User mode install171451 -Node: tlmgr User mode backup, restore, remove, update172595 -Node: tlmgr User mode generate, option, paper173037 -Node: tlmgr MULTIPLE REPOSITORIES173413 -Node: tlmgr Pinning175142 -Node: tlmgr GUI FOR TLMGR177117 -Node: tlmgr Main display178457 -Node: tlmgr Display configuration area178709 -Ref: tlmgr Status179070 -Ref: tlmgr Category179234 -Ref: tlmgr Match179420 -Ref: tlmgr Selection179601 -Ref: tlmgr Display configuration buttons179805 -Node: tlmgr Package list area179988 -Ref: tlmgr a checkbox180572 -Ref: tlmgr package name180708 -Ref: tlmgr local revision (and version)180807 -Ref: tlmgr remote revision (and version)181182 -Ref: tlmgr short description181479 -Node: tlmgr Main display action buttons181524 -Ref: tlmgr Update all installed181790 -Ref: tlmgr Update182162 -Ref: tlmgr Install182212 -Ref: tlmgr Remove182398 -Ref: tlmgr Backup182576 -Node: tlmgr Menu bar182733 -Ref: tlmgr tlmgr menu182956 -Ref: tlmgr Options menu183264 -Ref: tlmgr Actions menu184347 -Ref: tlmgr Help menu184775 -Node: tlmgr GUI options184908 -Ref: tlmgr -background _color_185154 -Ref: tlmgr -font " _fontname_ _fontsize_ "185219 -Ref: tlmgr -foreground _color_185377 -Ref: tlmgr -geometry _geomspec_185429 -Ref: tlmgr -xrm _xresource_185621 -Node: tlmgr MACHINE-READABLE OUTPUT185889 -Node: tlmgr Machine-readable update and install output186699 -Ref: tlmgr location-url _location_187975 -Ref: tlmgr total-bytes _count_188191 -Ref: tlmgr _pkgname_188601 -Ref: tlmgr _status_188811 -Ref: tlmgr d188889 -Ref: tlmgr f188949 -Ref: tlmgr u189128 -Ref: tlmgr r189174 -Ref: tlmgr a189297 -Ref: tlmgr i189475 -Ref: tlmgr I189594 -Ref: tlmgr _localrev_189696 -Ref: tlmgr _serverrev_189803 -Ref: tlmgr _size_189915 -Ref: tlmgr _runtime_190084 -Ref: tlmgr _esttot_190154 -Node: tlmgr Machine-readable option output190187 -Node: tlmgr AUTHORS AND COPYRIGHT190699 -Node: Index191098 +Node: Overview of build system3943 +Node: Prerequisites5994 +Node: Building8603 +Node: Build iteration9989 +Node: Build problems11030 +Node: Build in parallel11484 +Node: Build distribution12088 +Node: Build one package12736 +Node: Build one engine16415 +Node: Cross compilation17464 +Node: Cross configuring18744 +Node: Cross problems20421 +Node: Installing22083 +Node: Installation directories23103 +Node: Linked scripts24921 +Node: Distro builds26412 +Node: Layout and infrastructure28788 +Node: Build system tools29619 +Node: Top-level directories31836 +Node: Autoconf macros34072 +Node: General setup macros34834 +Node: Macros for programs35709 +Node: Macros for compilers36510 +Node: Macros for libraries37918 +Node: Macros for library and header flags38344 +Node: Macros for Windows40255 +Node: Library modules41842 +Node: png library42331 +Node: zlib library44679 +Node: freetype library45194 +Node: kpathsea library45890 +Node: Program modules47269 +Node: t1utils package47697 +Node: xindy package48242 +Node: xdvik package49356 +Node: asymptote50415 +Node: Extending TeX Live50911 +Node: Adding a new program module51694 +Node: Adding a new generic library module55033 +Node: Adding a new TeX-specific library module57262 +Node: Configure options57960 +Node: Global configure options59341 +Node: --disable-native-texlive-build59883 +Node: --prefix --bindir ...60845 +Node: --disable-largefile61385 +Node: --disable-missing62086 +Node: --enable-compiler-warnings=LEVEL62487 +Node: --enable-cxx-runtime-hack63143 +Node: --enable-maintainer-mode63563 +Node: --enable-multiplatform64092 +Node: --enable-shared64665 +Node: --enable-silent-rules65036 +Node: --without-ln-s65488 +Node: --without-x65835 +Node: Program-specific configure options66023 +Node: --enable-PROG --disable-PROG66666 +Node: --disable-all-pkgs66939 +Node: Configure options for texk/web2c67722 +Node: Configure options for texk/bibtex-x70260 +Node: Configure options for texk/dvipdfm-x70803 +Node: Configure options for texk/dvisvgm71579 +Node: Configure options for texk/texlive72460 +Node: Configure options for texk/xdvik72881 +Node: Configure options for utils/xindy73502 +Node: Library-specific configure options74392 +Node: Configure options for kpathsea75394 +Node: Configure options for system poppler76143 +Node: Variables for configure76907 +Node: Coding conventions78333 +Node: Declarations and definitions79048 +Node: Const81222 +Node: Continuous integration83086 +Node: Transfer from Subversion to Github83750 +Node: Automatic update of the Git mirror85912 +Node: CI testing on Travis-CI86494 +Node: Releases on Github87203 +Node: install-tl87643 +Node: install-tl NAME88012 +Node: install-tl SYNOPSIS88170 +Node: install-tl DESCRIPTION88428 +Node: install-tl REFERENCES89488 +Node: install-tl OPTIONS90012 +Ref: install-tl *-gui* [[=]_module_]90353 +Ref: install-tl text90561 +Ref: install-tl tcl90681 +Ref: install-tl wizard91023 +Ref: install-tl expert91156 +Ref: install-tl perltk91278 +Ref: install-tl *-no-gui*91824 +Ref: install-tl *-lang* _llcode_91914 +Ref: install-tl *-repository* _url|path_92670 +Ref: install-tl *-select-repository*93558 +Ref: install-tl *-all-options*93994 +Ref: install-tl *-custom-bin* _path_94249 +Ref: install-tl *-debug-translation*95083 +Ref: install-tl *-force-platform* _platform_95302 +Ref: install-tl *-help*, *--help*, *-?*95546 +Ref: install-tl *-in-place*95959 +Ref: install-tl *-init-from-profile* _profile_file_96504 +Ref: install-tl *-logfile* _file_96773 +Ref: install-tl *-no-cls*97124 +Ref: install-tl *-no-persistent-downloads*97272 +Ref: install-tl *-persistent-downloads*97297 +Ref: install-tl *-no-verify-downloads*97915 +Ref: install-tl *-non-admin*98278 +Ref: install-tl *-portable*98371 +Ref: install-tl *-print-platform*98510 +Ref: install-tl *-profile* _profile_file_98708 +Ref: install-tl *-q*98929 +Ref: install-tl *-scheme* _scheme_98991 +Ref: install-tl *-v*99465 +Ref: install-tl *-version*, *--version*99620 +Node: install-tl PROFILES99754 +Ref: install-tl instopt_adjustpath (default 0 on Unix, 1 on Windows)102620 +Ref: install-tl instopt_adjustrepo (default 1)102696 +Ref: install-tl instopt_letter (default 0)102833 +Ref: install-tl instopt_portable (default 0)102924 +Ref: install-tl instopt_write18_restricted (default 1)103020 +Node: install-tl ENVIRONMENT VARIABLES104359 +Ref: install-tl TEXLIVE_DOWNLOADER104737 +Ref: install-tl TL_DOWNLOAD_PROGRAM104760 +Ref: install-tl TL_DOWNLOAD_ARGS104780 +Ref: install-tl TEXLIVE_INSTALL_ENV_NOCHECK104984 +Ref: install-tl TEXLIVE_INSTALL_NO_CONTEXT_CACHE105186 +Ref: install-tl TEXLIVE_INSTALL_NO_IMPORT105295 +Ref: install-tl TEXLIVE_INSTALL_NO_WELCOME105447 +Ref: install-tl TEXLIVE_INSTALL_PREFIX105569 +Ref: install-tl TEXLIVE_INSTALL_TEXDIR105595 +Ref: install-tl TEXLIVE_INSTALL_TEXMFCONFIG105626 +Ref: install-tl TEXLIVE_INSTALL_TEXMFVAR105654 +Ref: install-tl TEXLIVE_INSTALL_TEXMFHOME105683 +Ref: install-tl TEXLIVE_INSTALL_TEXMFLOCAL105713 +Ref: install-tl TEXLIVE_INSTALL_TEXMFSYSCONFIG105747 +Ref: install-tl TEXLIVE_INSTALL_TEXMFSYSVAR105778 +Ref: install-tl NOPERLDOC106149 +Node: install-tl AUTHORS AND COPYRIGHT106213 +Node: tlmgr106626 +Node: tlmgr NAME107111 +Node: tlmgr SYNOPSIS107243 +Node: tlmgr DESCRIPTION107433 +Node: tlmgr EXAMPLES108532 +Ref: tlmgr tlmgr option repository ctan108783 +Ref: tlmgr tlmgr option repository http://mirror.ctan.org/systems/texlive/tlnet108855 +Ref: tlmgr tlmgr update --list109460 +Ref: tlmgr tlmgr update --all109553 +Ref: tlmgr tlmgr info _what_109710 +Node: tlmgr OPTIONS109972 +Ref: tlmgr *--repository* _url|path_110492 +Ref: tlmgr /some/local/dir111678 +Ref: tlmgr file:/some/local/dir111707 +Ref: tlmgr ctan111780 +Ref: tlmgr http://mirror.ctan.org/systems/texlive/tlnet111833 +Ref: tlmgr http://server/path/to/tlnet112174 +Ref: tlmgr https://server/path/to/tlnet112555 +Ref: tlmgr ftp://server/path/to/tlnet113023 +Ref: tlmgr user@machine:/path/to/tlnet113155 +Ref: tlmgr scp://user@machine/path/to/tlnet113196 +Ref: tlmgr ssh://user@machine/path/to/tlnet113237 +Ref: tlmgr *--gui* [_action_]113630 +Ref: tlmgr *--gui-lang* _llcode_114443 +Ref: tlmgr *--debug-translation*115179 +Ref: tlmgr *--machine-readable*115382 +Ref: tlmgr *--no-execute-actions*115650 +Ref: tlmgr *--package-logfile* _file_115843 +Ref: tlmgr *--pause*116097 +Ref: tlmgr *--persistent-downloads*116252 +Ref: tlmgr *--no-persistent-downloads*116280 +Ref: tlmgr *--pin-file*116774 +Ref: tlmgr *--usermode*116992 +Ref: tlmgr *--usertree* _dir_117112 +Ref: tlmgr *--verify-repo=[none|main|all]*117238 +Node: tlmgr ACTIONS118137 +Node: tlmgr help118998 +Node: tlmgr version119475 +Node: tlmgr backup119738 +Ref: tlmgr *backup [_option_...] --all*119909 +Ref: tlmgr *backup [_option_...] _pkg_...*119942 +Ref: tlmgr *--backupdir* _directory_121008 +Ref: tlmgr *--all*121225 +Ref: tlmgr *--clean*[=_N_]121477 +Ref: tlmgr *--dry-run*121804 +Node: tlmgr candidates _pkg_121934 +Node: tlmgr check [_option_...] [depends|executes|files|runfiles|texmfdbs|all]122289 +Ref: tlmgr *depends*122803 +Ref: tlmgr *executes*123145 +Ref: tlmgr *files*123260 +Ref: tlmgr *runfiles*123396 +Ref: tlmgr *texmfdbs*123533 +Ref: tlmgr - all items in TEXMFDBS have the !! prefix.123763 +Ref: tlmgr - all items in TEXMFBDS have an ls-R file (if they exist at all).123839 +Ref: tlmgr - all items in TEXMF with !! are listed in TEXMFDBS.123904 +Ref: tlmgr - all items in TEXMF with an ls-R file are listed in TEXMFDBS.123979 +Ref: tlmgr *--use-svn*124004 +Node: tlmgr conf124145 +Ref: tlmgr *conf [texmf|tlmgr|updmap [--conffile _file_] [--delete] [_key_ [_value_]]]*124433 +Ref: tlmgr *conf auxtrees [--conffile _file_] [show|add|remove] [_value_]*124497 +Node: tlmgr dump-tlpdb [_option_...] [--json]126912 +Ref: tlmgr *--local*127345 +Ref: tlmgr *--remote*127384 +Ref: tlmgr *--json*127422 +Node: tlmgr generate127993 +Ref: tlmgr *generate [_option_...] language*128189 +Ref: tlmgr *generate [_option_...] language.dat*128228 +Ref: tlmgr *generate [_option_...] language.def*128267 +Ref: tlmgr *generate [_option_...] language.dat.lua*128310 +Ref: tlmgr *--dest* _output_file_130637 +Ref: tlmgr *--localcfg* _local_conf_file_131213 +Ref: tlmgr *--rebuild-sys*131336 +Node: tlmgr gui132151 +Node: tlmgr info132329 +Ref: tlmgr *info [_option_...] _pkg_...*132491 +Ref: tlmgr *info [_option_...] collections*132525 +Ref: tlmgr *info [_option_...] schemes*132555 +Ref: tlmgr *--list*134085 +Ref: tlmgr *--only-installed*134399 +Ref: tlmgr *--only-remote*134587 +Ref: tlmgr *--data item1,item2,...*134891 +Ref: tlmgr *--json* 1135472 +Node: tlmgr init-usertree135855 +Node: tlmgr install [_option_...] _pkg_...136236 +Ref: tlmgr *--dry-run* 1136744 +Ref: tlmgr *--file*136861 +Ref: tlmgr *--force*137083 +Ref: tlmgr *--no-depends*137303 +Ref: tlmgr *--no-depends-at-all*137462 +Ref: tlmgr *--reinstall*137862 +Ref: tlmgr *--with-doc*138240 +Ref: tlmgr *--with-src*138253 +Node: tlmgr key138981 +Ref: tlmgr *key list*139139 +Ref: tlmgr *key add _file_*139157 +Ref: tlmgr *key remove _keyid_*139179 +Node: tlmgr list139773 +Node: tlmgr option139935 +Ref: tlmgr *option [--json] [show]*140090 +Ref: tlmgr *option [--json] showall|help*140121 +Ref: tlmgr *option _key_ [_value_]*140147 +Node: tlmgr paper144725 +Ref: tlmgr *paper [a4|letter]*144874 +Ref: tlmgr *<[xdvi|pdftex|dvips|dvipdfmx|context|psutils] paper [_papersize_|--list]*>144950 +Ref: tlmgr *paper --json*144965 +Node: tlmgr path146180 +Ref: tlmgr *path [--w32mode=user|admin] add*146341 +Ref: tlmgr *path [--w32mode=user|admin] remove*146378 +Node: tlmgr pinning147863 +Ref: tlmgr pinning show148104 +Ref: tlmgr pinning add _repo_ _pkgglob_...148177 +Ref: tlmgr pinning remove _repo_ _pkgglob_...148296 +Ref: tlmgr pinning remove _repo_ --all148449 +Node: tlmgr platform148503 +Ref: tlmgr *platform list|add|remove _platform_...*148689 +Ref: tlmgr *platform set _platform_*148716 +Ref: tlmgr *platform set auto*148737 +Ref: tlmgr *--dry-run* 2149614 +Node: tlmgr postaction149733 +Ref: tlmgr *postaction [_option_...] install [shortcut|fileassoc|script] [_pkg_...]*149963 +Ref: tlmgr *postaction [_option_...] remove [shortcut|fileassoc|script] [_pkg_...]*150037 +Ref: tlmgr *--w32mode=[user|admin]*150352 +Ref: tlmgr *--fileassocmode=[1|2]*150768 +Ref: tlmgr *--all* 1151053 +Node: tlmgr print-platform151108 +Node: tlmgr print-platform-info151439 +Node: tlmgr remove [_option_...] _pkg_...151739 +Ref: tlmgr *--all* 2152223 +Ref: tlmgr *--backup*152333 +Ref: tlmgr *--backupdir* _directory_ 1152359 +Ref: tlmgr *--no-depends* 1152764 +Ref: tlmgr *--no-depends-at-all* 1152826 +Ref: tlmgr *--force* 1152929 +Ref: tlmgr *--dry-run* 3153402 +Node: tlmgr repository153738 +Ref: tlmgr *repository list*153926 +Ref: tlmgr *repository list _path|url|tag_*153960 +Ref: tlmgr *repository add _path_ [_tag_]*153993 +Ref: tlmgr *repository remove _path|tag_*154025 +Ref: tlmgr *repository set _path_[#_tag_] [_path_[#_tag_] ...]*154079 +Ref: tlmgr *repository status*154100 +Ref: tlmgr The tag (which can be the same as the url);155327 +Node: tlmgr restore155805 +Ref: tlmgr *restore [_option_...] _pkg_ [_rev_]*155984 +Ref: tlmgr *restore [_option_...] --all*156014 +Ref: tlmgr *--all* 3156714 +Ref: tlmgr *--backupdir* _directory_ 2156928 +Ref: tlmgr *--dry-run* 4157109 +Ref: tlmgr *--force* 2157241 +Ref: tlmgr *--json* 2157287 +Node: tlmgr search157614 +Ref: tlmgr *search [_option_...] _what_*157778 +Ref: tlmgr *search [_option_...] --file _what_*157815 +Ref: tlmgr *search [_option_...] --all _what_*157851 +Ref: tlmgr *--file* 1158071 +Ref: tlmgr *--all* 4158133 +Ref: tlmgr *--global*158222 +Ref: tlmgr *--word*158349 +Node: tlmgr shell158664 +Ref: tlmgr protocol159399 +Ref: tlmgr help 1159463 +Ref: tlmgr version 1159516 +Ref: tlmgr quit, end, bye, byebye, EOF159584 +Ref: tlmgr restart159605 +Ref: tlmgr load [local|remote]159728 +Ref: tlmgr save159798 +Ref: tlmgr get [_var_] =item set [_var_ [_val_]]159921 +Node: tlmgr show160522 +Node: tlmgr uninstall160689 +Node: tlmgr update [_option_...] [_pkg_...]160919 +Ref: tlmgr *--all* 5161290 +Ref: tlmgr *--self*163469 +Ref: tlmgr *--dry-run* 5164233 +Ref: tlmgr *--list* [_pkg_]164410 +Ref: tlmgr *--exclude* _pkg_165099 +Ref: tlmgr *--no-auto-remove* [_pkg_...]165899 +Ref: tlmgr *--no-auto-install* [_pkg_...]166383 +Ref: tlmgr *--reinstall-forcibly-removed*167145 +Ref: tlmgr *--backup* 1167680 +Ref: tlmgr *--backupdir* _directory_ 3167706 +Ref: tlmgr *--no-depends* 2168872 +Ref: tlmgr *--no-depends-at-all* 2169075 +Ref: tlmgr *--force* 3169178 +Node: tlmgr CONFIGURATION FILE FOR TLMGR170198 +Ref: tlmgr auto-remove, value 0 or 1 (default 1), same as command-line option.171205 +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.171342 +Ref: tlmgr gui-lang _llcode_, with a language code value as with the command-line option.171424 +Ref: tlmgr no-checksums, value 0 or 1 (default 0, see below).171478 +Ref: tlmgr persistent-downloads, value 0 or 1 (default 1), same as command-line option.171558 +Ref: tlmgr require-verification, value 0 or 1 (default 0), same as command-line option.171638 +Ref: tlmgr update-exclude, value: comma-separated list of packages (no space allowed). Same as the command line option --exclude for the action update.171786 +Ref: tlmgr verify-downloads, value 0 or 1 (default 1), same as command-line option.171862 +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).172131 +Node: tlmgr CRYPTOGRAPHIC VERIFICATION173219 +Node: tlmgr Configuration of GnuPG invocation175392 +Node: tlmgr USER MODE176030 +Node: tlmgr User mode install178876 +Node: tlmgr User mode backup, restore, remove, update180020 +Node: tlmgr User mode generate, option, paper180462 +Node: tlmgr MULTIPLE REPOSITORIES180838 +Node: tlmgr Pinning182567 +Node: tlmgr GUI FOR TLMGR184490 +Node: tlmgr Main display186139 +Node: tlmgr Display configuration area186391 +Ref: tlmgr Status186752 +Ref: tlmgr Category186916 +Ref: tlmgr Match187102 +Ref: tlmgr Selection187283 +Ref: tlmgr Display configuration buttons187487 +Node: tlmgr Package list area187670 +Ref: tlmgr a checkbox188254 +Ref: tlmgr package name188390 +Ref: tlmgr local revision (and version)188489 +Ref: tlmgr remote revision (and version)188864 +Ref: tlmgr short description189161 +Node: tlmgr Main display action buttons189206 +Ref: tlmgr Update all installed189472 +Ref: tlmgr Update189844 +Ref: tlmgr Install189894 +Ref: tlmgr Remove190080 +Ref: tlmgr Backup190258 +Node: tlmgr Menu bar190415 +Ref: tlmgr tlmgr menu190638 +Ref: tlmgr Options menu190946 +Ref: tlmgr Actions menu192029 +Ref: tlmgr Help menu192457 +Node: tlmgr GUI options192591 +Ref: tlmgr -background _color_192837 +Ref: tlmgr -font " _fontname_ _fontsize_ "192902 +Ref: tlmgr -foreground _color_193060 +Ref: tlmgr -geometry _geomspec_193112 +Ref: tlmgr -xrm _xresource_193304 +Node: tlmgr MACHINE-READABLE OUTPUT193573 +Node: tlmgr Machine-readable update and install output194383 +Ref: tlmgr location-url _location_195659 +Ref: tlmgr total-bytes _count_195875 +Ref: tlmgr _pkgname_196285 +Ref: tlmgr _status_196495 +Ref: tlmgr d196573 +Ref: tlmgr f196633 +Ref: tlmgr u196812 +Ref: tlmgr r196858 +Ref: tlmgr a196981 +Ref: tlmgr i197159 +Ref: tlmgr I197278 +Ref: tlmgr _localrev_197380 +Ref: tlmgr _serverrev_197487 +Ref: tlmgr _size_197599 +Ref: tlmgr _runtime_197768 +Ref: tlmgr _esttot_197838 +Node: tlmgr Machine-readable option output197871 +Node: tlmgr ENVIRONMENT VARIABLES198383 +Ref: tlmgr TEXLIVE_COMPRESSOR198894 +Ref: tlmgr TEXLIVE_DOWNLOADER199742 +Ref: tlmgr TL_DOWNLOAD_PROGRAM199765 +Ref: tlmgr TL_DOWNLOAD_ARGS199785 +Ref: tlmgr TEXLIVE_PREFER_OWN200811 +Node: tlmgr AUTHORS AND COPYRIGHT201635 +Node: Index202033 End Tag Table + + +Local Variables: +coding: utf-8 +End: diff --git a/Master/texmf-dist/doc/info/web2c.info b/Master/texmf-dist/doc/info/web2c.info index 9403f7e81a1..19bf29f3409 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.5 from web2c.texi. +This is web2c.info, produced by makeinfo version 6.7 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 Karl Berry & Olaf Weber. +2005, 2007, 2008, 2009, 2010-2020 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 2019, released in February 2019. +corresponds to Web2c version 2020, released in March 2020. * Menu: @@ -82,8 +82,8 @@ File: web2c.info, Node: Introduction, Next: Installation, Prev: Top, Up: Top 1 Introduction ************** -This manual corresponds to version 2019 of Web2c, released in February -2019. +This manual corresponds to version 2020 of Web2c, released in March +2020. "Web2c" is the name of a TeX implementation, originally for Unix, but now also running under DOS, Amiga, and other operating systems. By "TeX @@ -634,7 +634,7 @@ Runtime options::. * Initial and virgin:: Making memory dumps vs. production runs. * Memory dumps:: .fmt/.base files for fast startup. * Editor invocation:: The 'e' response at errors. -* \input filenames:: ~ and $ expansion in TeX/MF/MP. +* \input filenames:: Filename delimiters and Kpathsea expansion. File: web2c.info, Node: Initial and virgin, Next: Memory dumps, Up: Three programs @@ -835,8 +835,35 @@ and MetaPost, the statement terminator ';' also works. (LaTeX and other macro packages provide other interfaces to '\input' that allow different notation; here we are concerned only with the primitive operation.) - As of Web2c version 7.5.3, double-quote characters can be used to -include spaces or other special cases. In typical use, the '"' + 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. + + In all cases, space tokens are ignored after the filename is read. + + Also, double quote ('"') characters are ignored within the filename; +there is no way to read files whose names contain a '"'. + + However, for maximal portability of your document across systems, use +only the characters 'a'-'z', '0'-'9', and '.'. Do not use anything but +simple filenames, since directory separators vary among systems; +instead, add the necessary directories to the appropriate search path. + +* Menu: + +* Quotes: \input quoted filename. \input "some name" +* Braces: \input braced filename. \input {some name} +* Caveats: \input filename caveats. Tokenization, nulls, Kpathsea expansion. + + +File: web2c.info, Node: \input quoted filename, Next: \input braced filename, Up: \input filenames + +3.5.4.1 '\input' quoted filename: '\input "some name"' +...................................................... + +As of Web2c version 7.5.3 (2004), double-quote characters can be used to +include spaces or other special characters. In typical use, the '"' characters surround the entire filename: \input "filename with spaces" @@ -844,46 +871,69 @@ characters surround the entire filename: can enclose any characters, as in: \input filename" "with" "spaces - One more point. In LaTeX, the quotes are needed inside the braces, -thus + One more point. In LaTeX, the quotes are needed inside the braces of +its '\input' macro, thus: \input{a b} % fails \input{"a b"} % ok - This quoting mechanism comes into play _after_ TeX has tokenized and -expanded the input. So, multiple spaces and tabs may be seen as a -single space, active characters such as '~' are expanded first, and so -on. (See below.) + There is no way to quote the quote character. + + +File: web2c.info, Node: \input braced filename, Next: \input filename caveats, Prev: \input quoted filename, Up: \input filenames + +3.5.4.2 '\input' braced filename: '\input{some name}' +..................................................... + +As of Web2c 2020, '\input' filenames in TeX engines (this does not apply +in Metafont and MetaPost) can also be specified within a TeX group, +typically curly braces. For example: + \input{filename with spaces} + + As always with TeX, the brace characters are not hardwired; what +counts is the category code: the first token after the '\input' must be +of catcode 1 (begin group), and it is matched with the next character of +catcode 2 (end group). + + Within the group-delimited filename, braces are treated as normal +characters. + + As with all forms of filenames, following spaces are ignored (after +the end group), and double quote ('"') characters are ignored within the +filename. + + +File: web2c.info, Node: \input filename caveats, Prev: \input braced filename, Up: \input filenames + +3.5.4.3 '\input' filename caveats +................................. + +The quoting mechanisms just described come into play _after_ TeX has +tokenized and expanded the input. So, multiple spaces and tabs will +generally be seen as a single space, active characters such as '~' are +expanded first (generally causing an error), and so on. More examples +below. On the other hand, various C library routines and Unix itself use the null byte (character code zero, ASCII NUL) to terminate strings. So filenames in Web2c cannot contain nulls, even though TeX itself does not -treat NUL specially. In addition, some older Unix variants do not allow -eight-bit characters (codes 128-255) in filenames. - - For maximal portability of your document across systems, use only the -characters 'a'-'z', '0'-'9', and '.', and restrict your filenames to at -most eight characters (not including the extension), and at most a -three-character extension. Do not use anything but simple filenames, -since directory separators vary among systems; instead, add the -necessary directories to the appropriate search path. +treat NUL specially. Finally, the present Web2c implementation does '~' and '$' expansion -on NAME, unlike Knuth's original implementation and older versions of -Web2c. Thus: +on NAME, unlike Knuth's original implementation. Thus: \input ~jsmith/$foo.bar will dereference the environment variable or Kpathsea config file -value 'foo' and read that file extended with '.bar' in user 'jsmith''s -home directory. You can also use braces, as in '${foo}bar', if you want -to follow the variable name with a letter, numeral, or '_'. +value 'foo' and read that file, extended with '.bar', in user 'jsmith''s +home directory. You can also use braces in the variable expansion, as +in '${foo}bar', if you want to follow the variable name with a letter, +numeral, or '_'. (So another way to get a program to read a filename containing whitespace is to define an environment variable and dereference it.) - In all the common TeX formats (plain TeX, LaTeX, AMSTeX), the -characters '~' and '$' have special category codes, so to actually use -these in a document you have to change their catcodes or use '\string'. -(The result is unportable anyway, see the suggestions above.) The place -where they are most likely to be useful is when typing interactively. + In all the common TeX formats (plain TeX, LaTeX, ConTeXt, AMSTeX, +...), the characters '~' and '$' have special category codes, so to +actually use these in a document you have to change their catcodes or +use '\string'. File: web2c.info, Node: TeX, Next: Metafont, Prev: Commonalities, Up: Top @@ -1485,9 +1535,10 @@ Otherwise it is not. In any case, a message is written to the log file. The 'shell_escape_commands' value is a comma-separated list of words. Whitespace is significant, and typically should not be present. The -default definition looks like this, but with more commands included: +default definition in 'texmf.cnf' looks like this, but with more +commands included: - shell_escape_commands = bibtex,dvips,epstopdf,...,tex + shell_escape_commands = bibtex,kpsewhich,repstopdf,... pdfTeX and luaTeX support reading (via '\input' and '\openin') and writing (via '\openout') from pipes if the first character is '|'. The @@ -3424,9 +3475,11 @@ Index * Menu: +* " character, ignored in filenames: \input filenames. (line 22) * #define options: Compile-time options. (line 6) -* $ expansion in filenames: \input filenames. (line 47) +* $ expansion in filenames: \input filename caveats. + (line 17) * %& magic number: Determining the memory dump to use. (line 19) * - starting a filename: Option conventions. (line 19) @@ -3570,21 +3623,29 @@ Index * \font and dynamic generation: tex invocation. (line 41) * \fontdimen: tftopl invocation. (line 99) * \immediate\write18: Shell escapes. (line 6) +* \input braced (grouped) filename: \input braced filename. + (line 6) +* \input filename caveats: \input filename caveats. + (line 6) * \input filenames: \input filenames. (line 6) -* \input, and pipes: Shell escapes. (line 63) +* \input quoted filename: \input quoted filename. + (line 6) +* \input, and pipes: Shell escapes. (line 64) * \mag: dvicopy invocation. (line 20) * \mag <1>: dvitype invocation. (line 28) -* \openin, and pipes: Shell escapes. (line 63) +* \openin, and pipes: Shell escapes. (line 64) * \openout and security: tex invocation. (line 48) -* \openout, and pipes: Shell escapes. (line 63) +* \openout, and pipes: Shell escapes. (line 64) * \output routine, and \write: Shell escapes. (line 28) -* \pdfshellescape: Shell escapes. (line 63) -* \string: \input filenames. (line 59) +* \pdfshellescape: Shell escapes. (line 64) +* \string, and \input filenames: \input filename caveats. + (line 29) * \tracingcharsubdef and MLTeX: \tracingcharsubdef. (line 6) * \tracinglostchars and MLTeX: \tracingcharsubdef. (line 11) * \write18 shell escape extension: Shell escapes. (line 6) * ^^ notation, avoiding: TCX files. (line 87) -* ~ expansion in filenames: \input filenames. (line 47) +* ~ expansion in filenames: \input filename caveats. + (line 17) * abbrv.bst: Basic BibTeX style files. (line 16) * accented character: TCX files. (line 6) @@ -3647,6 +3708,8 @@ Index * binaries, linking: Common options. (line 77) * blank lines, in TCX files: TCX files. (line 66) * boxes, memory for: Runtime options. (line 20) +* braced filename for \input: \input braced filename. + (line 6) * breakpoints, memory for: Runtime options. (line 20) * Breitenlohner, Peter: Introduction. (line 9) * BSTINPUTS, search path for bst files: bibtex invocation. (line 18) @@ -3659,6 +3722,8 @@ Index * byte swapping: Hardware and memory dumps. (line 13) * 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 Tangle: tangle invocation. (line 11) * change files, and Weave: weave invocation. (line 14) @@ -3736,6 +3801,8 @@ Index * DISPLAY: Online Metafont graphics. (line 76) * dot files, written by TeX programs: tex invocation. (line 48) +* double quote character, ignored in filenames: \input filenames. + (line 22) * downloading of fonts for MetaPost labels: mpost invocation. (line 70) * DrawingServant: Online Metafont graphics. (line 35) @@ -3768,7 +3835,8 @@ Index * editing of bitmap fonts: Font utilities available elsewhere. (line 23) * editor invoked at error: Editor invocation. (line 6) -* eight-bit characters in filenames: \input filenames. (line 34) +* eight-bit characters in filenames: \input filename caveats. + (line 12) * empty.tcx: TCX files. (line 48) * endian dependencies: Hardware and memory dumps. (line 6) @@ -3784,6 +3852,8 @@ Index * executables, shared initial and virgin: Initial and virgin. (line 6) * exit status, of shell escape: Shell escapes. (line 34) * expanded plain format: Formats. (line 54) +* expansion, and \input filenames: \input filename caveats. + (line 6) * extensions to TeX: TeX extensions. (line 6) * extra_mem_bot: Runtime options. (line 19) * FACE property: tftopl invocation. (line 95) @@ -3858,6 +3928,8 @@ Index * glue, memory for: Runtime options. (line 20) * glyph substitutions: MLTeX. (line 6) * gray font: gftodvi invocation. (line 29) +* group-delimited filename for \input: \input braced filename. + (line 6) * Gruff, Billy Goat: Triptrap. (line 6) * gsftopk: Font utilities available elsewhere. (line 35) @@ -3983,7 +4055,8 @@ Index * memory dumps, creating: Creating memory dumps. (line 6) * mems Make target: Additional targets. (line 34) -* meta characters in filenames: \input filenames. (line 34) +* meta characters in filenames: \input filename caveats. + (line 12) * Metafont: Metafont. (line 6) * Metafont geometry: Online Metafont graphics. (line 69) @@ -4043,6 +4116,8 @@ Index * mptrap.readme: Triptrap. (line 6) * MPX files, converting from DVI files: dvitomp invocation. (line 6) * Multi-lingual TeX: MLTeX. (line 6) +* multiple spaces, and \input filenames: \input filename caveats. + (line 6) * N tilde: \charsubdef. (line 36) * new graphics support for Metafont: Online Metafont graphics. (line 79) @@ -4054,7 +4129,8 @@ Index (line 65) * NO_X11WIN: Online Metafont graphics. (line 56) -* NUL, not allowed in filenames: \input filenames. (line 34) +* NUL, not allowed in filenames: \input filename caveats. + (line 12) * octal character codes, in TCX files: TCX files. (line 77) * offset for overflow labels: gftodvi invocation. (line 59) * online Metafont graphics: Online Metafont graphics. @@ -4088,7 +4164,7 @@ Index * pfaedit: Font utilities available elsewhere. (line 30) * PiCTeX, increasing memory for: Runtime options. (line 20) -* pipes, reading and writing: Shell escapes. (line 63) +* pipes, reading and writing: Shell escapes. (line 64) * pixel height: pktype invocation. (line 62) * pixel width: pktype invocation. (line 62) * PK bitmaps from PostScript: Font utilities available elsewhere. @@ -4119,7 +4195,7 @@ Index * Poole, Simon: Online Metafont graphics. (line 50) * pooltype: pooltype invocation. (line 6) -* portable filenames: \input filenames. (line 40) +* portable filenames: \input filenames. (line 25) * PostScript fonts, and Troff: mpost invocation. (line 65) * PostScript meets Metafont: MetaPost. (line 6) * PostScript output: mpost invocation. (line 35) @@ -4155,6 +4231,8 @@ Index * 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 60) * readonly directory, running TeX in: Output file location. @@ -4234,6 +4312,8 @@ Index * system C library function: Shell escapes. (line 6) * system command: Shell escapes. (line 6) * T1 encoding and ISO input: TCX files. (line 48) +* tabs, and \input filenames: \input filename caveats. + (line 6) * Tachikawa, Elizabeth: Font file formats. (line 62) * tangle: tangle invocation. (line 6) * targets, additional Make: Additional targets. (line 6) @@ -4285,6 +4365,8 @@ Index * time and date, in memory dumps: Hardware and memory dumps. (line 30) * title font: gftodvi invocation. (line 33) +* tokenization, and \input filenames: \input filename caveats. + (line 6) * toolkits, X: Online Metafont graphics. (line 59) * torture tests: Triptrap. (line 6) @@ -4341,7 +4423,7 @@ Index * vptovf: vptovf invocation. (line 6) * weave: weave invocation. (line 6) * WEB: WEB. (line 6) -* web environments, and security: Shell escapes. (line 70) +* web environments, and security: Shell escapes. (line 71) * WEB pool files, displaying: pooltype invocation. (line 6) * WEB programs, compiling: tangle invocation. (line 6) * WEB programs, typesetting: weave invocation. (line 6) @@ -4389,75 +4471,83 @@ Index Tag Table: -Node: Top2754 -Node: Introduction3752 -Node: Installation6913 -Node: configure options9015 -Node: Compile-time options11037 -Node: Additional targets12139 -Node: Triptrap13416 -Node: Runtime options14943 -Node: Commonalities16701 -Node: Option conventions17302 -Node: Common options18525 -Node: Path searching22905 -Node: Output file location23877 -Node: Three programs25202 -Node: Initial and virgin25956 -Node: Memory dumps26885 -Node: Creating memory dumps27341 -Node: Determining the memory dump to use28552 -Node: Hardware and memory dumps30133 -Node: Editor invocation32583 -Node: \input filenames33450 -Node: TeX36443 -Node: tex invocation37594 -Node: Initial TeX44497 -Node: Formats45861 -Node: Languages and hyphenation48787 -Node: MLTeX49217 -Node: \charsubdef50705 -Node: \tracingcharsubdef53028 -Node: TCX files53603 -Node: patgen invocation59043 -Node: Shell escapes59749 -Node: IPC and TeX63313 -Node: TeX extensions63883 -Node: Metafont65014 -Node: mf invocation66302 -Node: Initial Metafont70139 -Node: Modes71769 -Node: Online Metafont graphics74019 -Node: gftodvi invocation77444 -Node: mft invocation80264 -Node: MetaPost84262 -Node: mpost invocation85024 -Node: Initial MetaPost90200 -Node: dvitomp invocation91122 -Node: BibTeX91787 -Node: bibtex invocation92148 -Node: Basic BibTeX style files94622 -Node: WEB95952 -Node: tangle invocation97161 -Node: weave invocation99284 -Node: pooltype invocation100691 -Node: DVI utilities101821 -Node: dvicopy invocation102753 -Node: dvitype invocation104036 -Node: dvitype output example106365 -Node: Font utilities109416 -Node: Font file formats110596 -Node: gftopk invocation113865 -Node: pktogf invocation115056 -Node: pktype invocation116222 -Node: gftype invocation119045 -Node: tftopl invocation123548 -Node: pltotf invocation128141 -Node: vftovp invocation129192 -Node: vptovf invocation131427 -Node: Font utilities available elsewhere132454 -Node: Legalisms134834 -Node: References136988 -Node: Index141555 +Node: Top2765 +Node: Introduction3760 +Node: Installation6918 +Node: configure options9020 +Node: Compile-time options11042 +Node: Additional targets12144 +Node: Triptrap13421 +Node: Runtime options14948 +Node: Commonalities16706 +Node: Option conventions17307 +Node: Common options18530 +Node: Path searching22910 +Node: Output file location23882 +Node: Three programs25207 +Node: Initial and virgin25973 +Node: Memory dumps26902 +Node: Creating memory dumps27358 +Node: Determining the memory dump to use28569 +Node: Hardware and memory dumps30150 +Node: Editor invocation32600 +Node: \input filenames33467 +Node: \input quoted filename35012 +Node: \input braced filename35793 +Node: \input filename caveats36727 +Node: TeX38245 +Node: tex invocation39396 +Node: Initial TeX46299 +Node: Formats47663 +Node: Languages and hyphenation50589 +Node: MLTeX51019 +Node: \charsubdef52507 +Node: \tracingcharsubdef54830 +Node: TCX files55405 +Node: patgen invocation60845 +Node: Shell escapes61551 +Node: IPC and TeX65131 +Node: TeX extensions65701 +Node: Metafont66832 +Node: mf invocation68120 +Node: Initial Metafont71957 +Node: Modes73587 +Node: Online Metafont graphics75837 +Node: gftodvi invocation79262 +Node: mft invocation82082 +Node: MetaPost86080 +Node: mpost invocation86842 +Node: Initial MetaPost92018 +Node: dvitomp invocation92940 +Node: BibTeX93605 +Node: bibtex invocation93966 +Node: Basic BibTeX style files96440 +Node: WEB97770 +Node: tangle invocation98979 +Node: weave invocation101102 +Node: pooltype invocation102509 +Node: DVI utilities103639 +Node: dvicopy invocation104571 +Node: dvitype invocation105854 +Node: dvitype output example108183 +Node: Font utilities111234 +Node: Font file formats112414 +Node: gftopk invocation115683 +Node: pktogf invocation116874 +Node: pktype invocation118040 +Node: gftype invocation120863 +Node: tftopl invocation125366 +Node: pltotf invocation129959 +Node: vftovp invocation131010 +Node: vptovf invocation133245 +Node: Font utilities available elsewhere134272 +Node: Legalisms136652 +Node: References138806 +Node: Index143373 End Tag Table + + +Local Variables: +coding: utf-8 +End: diff --git a/Master/texmf-dist/doc/kpathsea/kpathsea.html b/Master/texmf-dist/doc/kpathsea/kpathsea.html index cac5c2a91f2..701b7141afb 100644 --- a/Master/texmf-dist/doc/kpathsea/kpathsea.html +++ b/Master/texmf-dist/doc/kpathsea/kpathsea.html @@ -2,7 +2,7 @@ <html> <!-- This file documents the Kpathsea library for path searching. -Copyright (C) 1996-2019 Karl Berry & Olaf Weber. +Copyright (C) 1996-2020 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,7 +18,7 @@ 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.6, http://www.gnu.org/software/texinfo/ --> +<!-- 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> @@ -152,7 +152,7 @@ ul.no-bullet {list-style: none} <li><a id="toc-TeX-or-Metafont-failing-1" href="#TeX-or-Metafont-failing">8.5.4 TeX or Metafont failing</a></li> </ul></li> </ul></li> - <li><a id="toc-Index-1" href="#Index">Index</a></li> + <li><a id="toc-Index-1" href="#Index" rel="index">Index</a></li> </ul> </div> @@ -165,8 +165,8 @@ Next: <a href="#Introduction" accesskey="n" rel="next">Introduction</a>, Up: <a <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.1, released in -March 2019. +corresponds to version 6.3.2, released in +March 2020. </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. @@ -193,7 +193,7 @@ March 2019. </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" accesskey="9">Index</a></td><td> </td><td align="left" valign="top">General index. +<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> @@ -208,8 +208,8 @@ Next: <a href="#unixtex_002eftp" accesskey="n" rel="next">unixtex.ftp</a>, Previ <span id="index-introduction"></span> <span id="index-fundamental-purpose-of-Kpathsea"></span> -<p>This manual corresponds to version 6.3.1 of the Kpathsea -library, released in March 2019. +<p>This manual corresponds to version 6.3.2 of the Kpathsea +library, released in March 2020. </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 @@ -230,7 +230,7 @@ this library: <p>Other software that we do not maintain also uses it. </p> <p>Kpathsea is now maintained as part of the TeX Live distribution -(<a href="http://tug.org/texlive">http://tug.org/texlive</a>), which includes several more +(<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>. </p> @@ -251,7 +251,7 @@ along with any changes you have made, and allow anyone to modify the library source and distribute their modifications. It does not mean you have to distribute the source to your program using the library, although we hope you will. See accompanying files for the text of the -GNU licenses, or <a href="http2://www.gnu.org/licenses">http2://www.gnu.org/licenses</a>. +GNU licenses, or <a href="https://gnu.org/licenses">https://gnu.org/licenses</a>. </p> <span id="index-TeX-Users-Group"></span> <p>If you know enough about TeX to be reading this manual, then you (or @@ -391,19 +391,20 @@ Next: <a href="#Security" accesskey="n" rel="next">Security</a>, Previous: <a hr <span id="index-www_002etug_002eorg"></span> <span id="index-ftp_002etug_002eorg"></span> <p>This -is <a href="https://tug.org/tex/unixtex.ftp">https://tug.org/tex/unixtex.ftp</a>, last updated 28 November -2017. Email <a href="mailto:tex-k@tug.org">tex-k@tug.org</a> with comments or questions. +is <a href="ftp://tug.org/tex/unixtex.ftp">ftp://tug.org/tex/unixtex.ftp</a>, a.k.a. +<a href="https://tug.org/unixtex.ftp">https://tug.org/unixtex.ftp</a>, last updated 29 February 2020. +Email <a href="mailto:tex-k@tug.org">tex-k@tug.org</a> with comments or questions. </p> <p>The principal free TeX distribution for Unix-like systems is TeX Live, on the web at <a href="http://tug.org/texlive">http://tug.org/texlive</a>. The pages there -describe many ways to acquire and.or build TeX, over the Internet +describe many ways to acquire and/or build TeX, over the Internet or on physical media, both the sources and precompiled binaries for many systems, either standalone or as part of various operating system distributions. </p> -<p>Web2c, Kpathsea, Dvips, and Dviljk are no longer released as a -separate packages. Their sources are now maintained as part of TeX -Live. +<p>Web2c, Kpathsea, Dvips, and Dviljk, among others, are no longer +released as a separate packages. Their sources are now maintained as +part of TeX Live. </p> <span id="index-ftp_002ecs_002estanford_002eedu"></span> <span id="index-tex_002eweb"></span> @@ -411,7 +412,7 @@ Live. <p>The host <tt>ftp.cs.stanford.edu</tt> is the original source for the files for which Donald Knuth is directly responsible: <samp>tex.web</samp>, <samp>plain.tex</samp>, etc. However, unless you want to undertake the -project of building your TeX installation from scratch, it is more +project of building your TeX system from scratch, it is more reliable and less work to retrieve these files as part of a larger package. </p> @@ -512,8 +513,8 @@ Next: <a href="#Path-searching" accesskey="n" rel="next">Path searching</a>, Pre 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="http://www.gnu.org/prep/standards">http://www.gnu.org/prep/standards</a>. The TDS -document is available from <a href="http://www.mirror.ctan.org/tds">http://www.mirror.ctan.org/tds</a> +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>). </p> <p>In short, here is a skeleton of the default directory structure, @@ -604,6 +605,12 @@ Next: <a href="#TeX-support" accesskey="n" rel="next">TeX support</a>, Previous: provides. For information about searching for particular file types (e.g., TeX fonts), see the next chapter. </p> +<span id="index-translations_002c-of-path-searching-description"></span> +<p>This section, with minor differences, has been translated into several +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> @@ -740,12 +747,16 @@ Next: <a href="#Path-expansion" accesskey="n" rel="next">Path expansion</a>, Pre In the order in which Kpathsea looks for them: </p> <ol> -<li> <span id="index-environment-variable_002c-source-for-path"></span> -A user-set environment variable, e.g., <code>TEXINPUTS</code>. +<li> <span id="index-_002d_002dcnf_002dline_002c-source-for-path"></span> +A command-line option such as <code>--cnf-line</code>, available in +<samp>kpsewhich</samp> and most TeX engines. See <a href="#Path-searching-options">Path searching options</a>. + +<span id="index-environment-variable_002c-source-for-path"></span> +<p>A user-set environment variable, e.g., <code>TEXINPUTS</code>. Environment variables with an underscore and the program name appended override; for example, <code>TEXINPUTS_latex</code> overrides <code>TEXINPUTS</code> if the program being run is named ‘<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>). @@ -812,12 +823,12 @@ mentions most features. The format of <samp>texmf.cnf</samp> files follows: <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, -as with most shells, a ‘<samp>%</samp>’ in the “middle” of a value does not +similar to most shells, a ‘<samp>%</samp>’ in the “middle” of a value does not start a comment. Examples: <div class="example"> <pre class="example">% this is a comment -var = a%b % but the value of var will be "a%b". +var = a%b % but the value of var will be "a%b" </pre></div> </li><li> <span id="index-blank-lines_002c-in-texmf_002ecnf"></span> @@ -831,7 +842,7 @@ A ‘<samp>\</samp>’ at the end of a line acts as a continuation chara the next line is appended. Whitespace at the beginning of continuation lines is not ignored. -</li><li> Each remaining line must look like +</li><li> Each remaining line will look like: <div class="example"> <pre class="example"><var>variable</var> <span class="roman">[</span>. <var>progname</var><span class="roman">]</span> <span class="roman">[</span>=<span class="roman">]</span> <var>value</var> @@ -843,23 +854,32 @@ lines is not ignored. The <var>variable</var> name may contain any character other than whitespace, ‘<samp>=</samp>’, or ‘<samp>.</samp>’, but sticking to ‘<samp>A-Za-z_</samp>’ is safest. -</li><li> If ‘<samp>.<var>progname</var></samp>’ is present, the definition only -applies if the program that is running is named (i.e., the last -component of <code>argv[0]</code> is) <var>progname</var> or -<samp><var>progname</var>.{exe,bat,cmd,...}</samp>. Most notably, this allows -different flavors of TeX to have different search paths. +</li><li> <span id="index-_002eprogname-qualifier-in-texmf_002ecnf"></span> +If ‘<samp>.<var>progname</var></samp>’ is present (preceding spaces are +ignored), the definition only applies if the program that is running +is named (i.e., the last component of <code>argv[0]</code> is) +<var>progname</var> or <samp><var>progname</var>.{exe,bat,cmd,...}</samp>. Most +notably, this allows different flavors of TeX to have different +search paths. The <var>progname</var> value is used literally, without +variable or other expansions. </li><li> <span id="index-right_002dhand-side-of-variable-assignments"></span> -<var>value</var> may contain any characters except ‘<samp>%</samp>’ and ‘<samp>@</samp>’. -(These restrictions are only necessary because of the processing done -on <samp>texmf.cnf</samp> at build time, so you can stick those characters -in after installation if you have to.) The -‘<samp>$<var>var</var>.<var>prog</var></samp>’ feature is not available on the +Considered as strings, <var>value</var> may contain any character. +However, in practice most <samp>texmf.cnf</samp> values are related to path +expansion, and since various special characters are used in expansion, +such as braces and commas, they cannot be used in directory names. + +<p>The ‘<samp>$<var>var</var>.<var>prog</var></samp>’ feature is not available on the right-hand side; instead, you must use an additional variable (see -below for example). A ‘<samp>;</samp>’ in <var>value</var> is translated to -‘<samp>:</samp>’ if running under Unix; this is useful to write a single -<samp>texmf.cnf</samp> which can be used under both Unix and Windows. - +below for example). +</p> +<span id="index-_003b-translated-to-_003a-in-texmf_002ecnf"></span> +<p>A ‘<samp>;</samp>’ in <var>value</var> is translated to ‘<samp>:</samp>’ if running under +Unix, in order to have a single <samp>texmf.cnf</samp> that can support both +Unix and Windows systems. This translation happens with any value, not +just search paths, but fortunately in practice ‘<samp>;</samp>’ is not needed +in other values. +</p> </li><li> All definitions are read before anything is expanded, so you can use variables before they are defined (like Make, unlike most other programs). @@ -880,13 +900,33 @@ TEXINPUTS.latex = $latex2e_inputs <span id="index-shell-scripts-as-configuration-files"></span> <span id="index-configuration-files-as-shell-scripts_002e"></span> -<p>This format has obvious similarities 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>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 +an unexpected consequence: if the value begins with a literal ‘<samp>.</samp>’ +and the ‘<samp>=</samp>’ is omitted, the intended value is interpreted as a +program name. For example, a line <code>var .;/some/path</code> is taken as +an empty value for <code>var</code> running under the program named +‘<samp>;/some/path</samp>’. To diagnose this, Kpathsea warns if the program +name contains a path separator or other special character. The +simplest way to avoid the problem is to use the <code>=</code>. +</p> +<p>Exactly when a character will be considered special or act as itself +depends on the context in which it is used. The rules are inherent in +the multiple levels of interpretation of the configuration (parsing, +expansion, search, …) and so cannot be concisely stated, +unfortunately. There is no general escape mechanism; in particular, +‘<samp>\</samp>’ is not an “escape character” in <samp>texmf.cnf</samp> files. +When it comes choosing directory names for installation, it is safest to +avoid them all. </p> <span id="index-cnf_002ec"></span> <p>The implementation of all this is in <samp>kpathsea/cnf.c</samp>. @@ -1207,11 +1247,11 @@ one of those 501 entries. Therein lies slowness. <p>Unfortunately, in some cases files in leaf directories are <code>stat</code>’d: if the path specification is, say, ‘<samp>$TEXMF/fonts//pk//</samp>’, then files in a subdirectory -‘<samp>…/pk</samp>’, even if it is a leaf, are checked. The reason cannot -be explained without reference to the implementation, so read +‘<samp>…/pk</samp>’, even if it is a leaf, are checked. The reason +cannot be explained without reference to the implementation, so read <samp>kpathsea/elt-dirs.c</samp> (search for ‘<samp>may descend</samp>’) if you are -curious. And if you can find a way to <em>solve</em> the problem, please -let me know. +curious. And if you find a way to solve the problem, please let me +know. </p> <span id="index-elt_002ddirs_002ec-1"></span> <p>Subdirectory expansion is implemented in the source file @@ -1274,8 +1314,8 @@ case. </p> <p>This same problematic scenario has always existed on Windows, but for whatever reason, it has become much more common since Apple also went -to a case-insensitive filesystem. Hence the move to change the -Kpathsea behavior now. +to a case-insensitive filesystem. Hence the relatively late change +to the Kpathsea behavior. </p> <span id="index-Windows-and-casefolding"></span> <p>The fallback case-insensitive search is omitted at compile-time on @@ -1382,7 +1422,7 @@ find `cat /tmp/texdirlist` -iname somefile.tex -print </tmp/texdirlist Kpathsea would be a lot of error-prone trouble for something that is only useful for debugging. If your <code>find</code> does not support <code>-iname</code>, you can get GNU Find from -<a href="https://www.gnu.org/software/findutils">https://www.gnu.org/software/findutils</a>. +<a href="https://gnu.org/software/findutils">https://gnu.org/software/findutils</a>. </p> <p>The casefolding search is implemented in the source file <samp>kpathsea/pathsearch.c</samp>. Two implementation points: @@ -1416,7 +1456,7 @@ Next: <a href="#Invoking-kpsewhich" accesskey="n" rel="next">Invoking kpsewhich< <p>Kpathsea goes to some lengths to minimize disk accesses for searches (see <a href="#Subdirectory-expansion">Subdirectory expansion</a>). Nevertheless, in practice searching -each possible directory in typical TeX installations takes an +every possible directory in typical TeX installations takes an excessively long time. </p> <p>Therefore, Kpathsea can use an externally-built <em>filename @@ -1424,8 +1464,7 @@ database</em> file named <samp>ls-R</samp> that maps files to directories, thus avoiding the need to exhaustively search the disk. </p> <p>A second database file <samp>aliases</samp> allows you to give additional -names to the files listed in <samp>ls-R</samp>. This can be helpful to adapt -to “8.3” filename conventions in source files. +names to the files listed in <samp>ls-R</samp>. </p> <p>The <samp>ls-R</samp> and <samp>aliases</samp> features are implemented in the source file <samp>kpathsea/db.c</samp>. @@ -1709,6 +1748,28 @@ 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> +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 +extra colon in a ‘<samp>--cnf-line</samp>’ value will refer to the value from +a configuration file, not a user-set environment variable. +</p> +<p>Furthermore, any variable set from <var>str</var> will also be set with the +program name suffix. For example, <code>pdftex +--cnf-line=TEXINPUTS=/foo:</code> will set both <code>TEXINPUTS</code> and +<code>TEXINPUTS_pdftex</code> in the environment (and the value will be +<samp>/foo</samp> followed by the setting from <samp>texmf.cnf</samp>, ignoring +any user-set <code>TEXINPUTS</code>). +</p> +<p>This behavior is desirable because, in practice, many variables in the +distributed <samp>texmf.cnf</samp> are program-specific, and the intuitive +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> @@ -2119,8 +2180,8 @@ current system in the expansion. a Unix-ish system) ‘<samp>.:/home/karl</samp>’, supposing the latter is the current user’s home directory. Note that the ‘<samp>;</samp>’ in the source value, as commonly used in <samp>texmf.cnf</samp>, has changed to a -‘<samp>:</samp>’, as the normal path separator on the current system. (On a -Windows-ish system, the ‘<samp>;</samp>’ would remain.) +‘<samp>:</samp>’, as the normal path separator on the current system. On a +Windows-ish system, the ‘<samp>;</samp>’ would remain. </p> </dd> <dt>‘<samp>--var-value=<var>variable</var></samp>’</dt> @@ -2136,7 +2197,7 @@ default is not changed) ‘<samp>1</samp>’. </p> <p>Example to contrast with ‘<samp>--var-brace-value</samp>’: ‘<samp>FOO='.;~' kpsewhich --var-value=FOO</samp>’ outputs ‘<samp>.;~</samp>’, i.e., the same as the -input value. +input value, on all systems. </p> </dd> </dl> @@ -2263,7 +2324,7 @@ suffix ‘<samp>.bib</samp>’. <dt>‘<samp>bltxml</samp>’</dt> <dd><span id="index-_002ebltxml"></span> <span id="index-BLTXMLINPUTS"></span> -<p>(BibLaTeXML bibliography files for Biber, <a href="http://ctan.org/pkg/biber">http://ctan.org/pkg/biber</a>) +<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> @@ -2281,7 +2342,7 @@ suffix ‘<samp>.bst</samp>’. <dd><span id="index-_002edll"></span> <span id="index-_002eso"></span> <span id="index-CLUAINPUTS"></span> -<p>(dynamic libraries for Lua, <a href="http://ctan.org/pkg/luatex">http://ctan.org/pkg/luatex</a>) +<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> @@ -2572,7 +2633,7 @@ additional suffix ‘<samp>.pro</samp>’. <dt>‘<samp>ris</samp>’</dt> <dd><span id="index-_002eris"></span> <span id="index-RISINPUTS"></span> -<p>(RIS bibliography files, primarily for Biber, <a href="http://ctan.org/pkg/biber">http://ctan.org/pkg/biber</a>) +<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> @@ -3676,7 +3737,7 @@ separate library.) different systems. You will almost certainly want to use Autoconf and probably Automake for configuring and building your software if you use Kpathsea; I strongly recommend using Autoconf and Automake regardless. -They are available from <a href="http://www.gnu.org/software">http://www.gnu.org/software</a>. +They are available from <a href="https://gnu.org/software">https://gnu.org/software</a>. </p> <hr> @@ -3864,7 +3925,7 @@ me to understand. Please also include a <samp>ChangeLog</samp> entry. <span id="index-gdb_002c-recommended"></span> If the bug involved is an actual crash (i.e., core dump), it is easy and useful to include a stack trace from a debugger (I recommend the -GNU debugger GDB (<a href="http://www.gnu.org/software/gdb">http://www.gnu.org/software/gdb</a>). If the +GNU debugger GDB (<a href="https://gnu.org/software/gdb">https://gnu.org/software/gdb</a>). If the cause is apparent (a <code>NULL</code> value being dereferenced, for example), please send the details along. If the program involved is TeX or Metafont, and the crash is happening at apparently-sound @@ -3891,7 +3952,7 @@ Next: <a href="#Debugging" accesskey="n" rel="next">Debugging</a>, Previous: <a <span id="index-tex_002dk_0040tug_002eorg"></span> <p>Web2c and Kpathsea in general are discussed on the mailing list <a href="mailto:tex-k@tug.org">tex-k@tug.org</a>. You can subscribe and peruse the archives on -the web <a href="http://lists.tug.org/tex-k">http://lists.tug.org/tex-k</a>. +the web <a href="https://lists.tug.org/tex-k">https://lists.tug.org/tex-k</a>. </p> <p>You do not need to join to submit a report, nor will it affect whether you get a response. Be aware that large data files are sometimes @@ -3900,7 +3961,7 @@ the list. </p> <p>If you are looking for general TeX help, such as how to install a full TeX system or how to use LaTeX, please see -<a href="http://tug.org/begin.html">http://tug.org/begin.html</a>. +<a href="https://tug.org/begin.html">https://tug.org/begin.html</a>. </p> <hr> @@ -4290,7 +4351,7 @@ M lqmed the wrong device, most likely <code>mktexpk</code>’s built-in guess for the mode is wrong, and you should override it as above. </p> -<p>See <a href="http://ctan.org/pkg/modes">http://ctan.org/pkg/modes</a> for a list of resolutions and mode +<p>See <a href="https://ctan.org/pkg/modes">https://ctan.org/pkg/modes</a> for a list of resolutions and mode names for most devices (additional submissions are welcome). </p> <span id="index-_002e2602gf"></span> @@ -4380,11 +4441,15 @@ Previous: <a href="#Reporting-bugs" accesskey="p" rel="prev">Reporting bugs</a>, <a class="summary-letter" href="#Index_cp_symbol-8"><b>:</b></a> -<a class="summary-letter" href="#Index_cp_symbol-9"><b>\</b></a> +<a class="summary-letter" href="#Index_cp_symbol-9"><b>;</b></a> + +<a class="summary-letter" href="#Index_cp_symbol-10"><b>=</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> @@ -4450,6 +4515,8 @@ Previous: <a href="#Reporting-bugs" accesskey="p" rel="prev">Reporting bugs</a>, <tr><th id="Index_cp_symbol-3">-</th><td></td><td></td></tr> <tr><td></td><td valign="top"><a href="#index-_002d_002dall"><code>--all</code></a>:</td><td> </td><td valign="top"><a href="#Path-searching-options">Path searching options</a></td></tr> <tr><td></td><td valign="top"><a href="#index-_002d_002dcasefold_002dsearch"><code>--casefold-search</code></a>:</td><td> </td><td valign="top"><a href="#Path-searching-options">Path searching options</a></td></tr> +<tr><td></td><td valign="top"><a href="#index-_002d_002dcnf_002dline"><code>--cnf-line</code></a>:</td><td> </td><td valign="top"><a href="#Path-searching-options">Path searching options</a></td></tr> +<tr><td></td><td valign="top"><a href="#index-_002d_002dcnf_002dline_002c-source-for-path"><code>‘<samp>--cnf-line</samp>’, source for path</code></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-_002d_002dcolor_003dtty"><code>--color=tty</code></a>:</td><td> </td><td valign="top"><a href="#ls_002dR">ls-R</a></td></tr> <tr><td></td><td valign="top"><a href="#index-_002d_002ddebug_003dnum"><code>--debug=<var>num</var></code></a>:</td><td> </td><td valign="top"><a href="#Auxiliary-tasks">Auxiliary tasks</a></td></tr> <tr><td></td><td valign="top"><a href="#index-_002d_002ddpi_003dnum"><code>--dpi=<var>num</var></code></a>:</td><td> </td><td valign="top"><a href="#Path-searching-options">Path searching options</a></td></tr> @@ -4528,6 +4595,7 @@ Previous: <a href="#Reporting-bugs" accesskey="p" rel="prev">Reporting bugs</a>, <tr><td></td><td valign="top"><a href="#index-_002epool-1"><code>.pool</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-_002epool-2"><code>.pool</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-_002epro"><code>.pro</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-_002eprogname-qualifier-in-texmf_002ecnf"><code>.<var>progname</var> <span class="roman">qualifier in <samp>texmf.cnf</samp></span></code></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-_002erhosts_002c-writable-by-TeX"><code>.rhosts<span class="roman">, writable by TeX</span></code></a>:</td><td> </td><td valign="top"><a href="#Security">Security</a></td></tr> <tr><td></td><td valign="top"><a href="#index-_002eris"><code>.ris</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-_002esfd"><code>.sfd</code></a>:</td><td> </td><td valign="top"><a href="#Supported-file-formats">Supported file formats</a></td></tr> @@ -4560,15 +4628,21 @@ Previous: <a href="#Reporting-bugs" accesskey="p" rel="prev">Reporting bugs</a>, <tr><td></td><td valign="top"><a href="#index-_003a-may-not-be-_003a"><code>: <span class="roman">may not be :</span></code></a>:</td><td> </td><td valign="top"><a href="#Searching-overview">Searching overview</a></td></tr> <tr><td></td><td valign="top"><a href="#index-_003a_003a-expansion"><code>:: <span class="roman">expansion</span></code></a>:</td><td> </td><td valign="top"><a href="#Default-expansion">Default expansion</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-9">;</th><td></td><td></td></tr> +<tr><td></td><td valign="top"><a href="#index-_003b-translated-to-_003a-in-texmf_002ecnf"><code>; <span class="roman">translated to ‘<samp>:</samp>’ in <samp>texmf.cnf</samp></span></code></a>:</td><td> </td><td valign="top"><a href="#Config-files">Config files</a></td></tr> +<tr><td colspan="4"> <hr></td></tr> +<tr><th id="Index_cp_symbol-10">=</th><td></td><td></td></tr> +<tr><td></td><td valign="top"><a href="#index-_003d-omitted-in-texmf_002ecnf-and-misparsing"><code>= <span class="roman">omitted in <samp>texmf.cnf</samp> and misparsing</span></code></a>:</td><td> </td><td valign="top"><a href="#Config-files">Config 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><td></td><td valign="top"><a href="#index-_005c_002c-line-continuation-in-texmf_002ecnf"><code>\<span class="roman">, line continuation in <samp>texmf.cnf</samp></span></code></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-_005copenin"><code>\openin</code></a>:</td><td> </td><td valign="top"><a href="#Searching-overview">Searching overview</a></td></tr> <tr><td></td><td valign="top"><a href="#index-_005cspecial_002c-suppressing-warnings-about"><code>\special<span class="roman">, suppressing warnings about</span></code></a>:</td><td> </td><td valign="top"><a href="#Suppressing-warnings">Suppressing warnings</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-_007b-expansion"><code>{ <span class="roman">expansion</span></code></a>:</td><td> </td><td valign="top"><a href="#Brace-expansion">Brace expansion</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"><code>~ <span class="roman">expansion</span></code></a>:</td><td> </td><td valign="top"><a href="#Tilde-expansion">Tilde expansion</a></td></tr> <tr><td colspan="4"> <hr></td></tr> <tr><th id="Index_cp_letter-A">A</th><td></td><td></td></tr> @@ -5101,6 +5175,7 @@ Previous: <a href="#Reporting-bugs" accesskey="p" rel="prev">Reporting bugs</a>, <tr><td></td><td valign="top"><a href="#index-tolerance-for-glyph-lookup">tolerance for glyph lookup</a>:</td><td> </td><td valign="top"><a href="#Basic-glyph-lookup">Basic glyph lookup</a></td></tr> <tr><td></td><td valign="top"><a href="#index-trailing-_002f-in-home-directory">trailing ‘<samp>/</samp>’ in home directory</a>:</td><td> </td><td valign="top"><a href="#Tilde-expansion">Tilde expansion</a></td></tr> <tr><td></td><td valign="top"><a href="#index-trailing-colons">trailing colons</a>:</td><td> </td><td valign="top"><a href="#Default-expansion">Default expansion</a></td></tr> +<tr><td></td><td valign="top"><a href="#index-translations_002c-of-path-searching-description">translations, of path searching description</a>:</td><td> </td><td valign="top"><a href="#Path-searching">Path searching</a></td></tr> <tr><td></td><td valign="top"><a href="#index-TRFONTS"><code>TRFONTS</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-trick-for-detecting-leaf-directories">trick for detecting leaf directories</a>:</td><td> </td><td valign="top"><a href="#Subdirectory-expansion">Subdirectory expansion</a></td></tr> <tr><td></td><td valign="top"><a href="#index-trojan-horse-attack">trojan horse attack</a>:</td><td> </td><td valign="top"><a href="#Security">Security</a></td></tr> @@ -5176,11 +5251,15 @@ Previous: <a href="#Reporting-bugs" accesskey="p" rel="prev">Reporting bugs</a>, <a class="summary-letter" href="#Index_cp_symbol-8"><b>:</b></a> -<a class="summary-letter" href="#Index_cp_symbol-9"><b>\</b></a> +<a class="summary-letter" href="#Index_cp_symbol-9"><b>;</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-10"><b>{</b></a> +<a class="summary-letter" href="#Index_cp_symbol-12"><b>{</b></a> -<a class="summary-letter" href="#Index_cp_symbol-11"><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> diff --git a/Master/texmf-dist/doc/kpathsea/kpathsea.pdf b/Master/texmf-dist/doc/kpathsea/kpathsea.pdf Binary files differindex cd2acf69f1b..0cb23b250f5 100644 --- a/Master/texmf-dist/doc/kpathsea/kpathsea.pdf +++ b/Master/texmf-dist/doc/kpathsea/kpathsea.pdf diff --git a/Master/texmf-dist/doc/texlive/tlbuild/tlbuild.html b/Master/texmf-dist/doc/texlive/tlbuild/tlbuild.html index 5cdc2124c48..2747b2b718c 100644 --- a/Master/texmf-dist/doc/texlive/tlbuild/tlbuild.html +++ b/Master/texmf-dist/doc/texlive/tlbuild/tlbuild.html @@ -2,7 +2,7 @@ <html> <!-- This file documents the TeX Live build system and more. -Copyright (C) 2016-2019 Karl Berry. +Copyright (C) 2016-2020 Karl Berry. Copyright (C) 2013-2015 Karl Berry & Peter Breitenlohner. @@ -20,13 +20,13 @@ 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.6, http://www.gnu.org/software/texinfo/ --> +<!-- 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 (2019)</title> +<title>Building TeX Live (2020)</title> -<meta name="description" content="Building TeX Live (2019)"> -<meta name="keywords" content="Building TeX Live (2019)"> +<meta name="description" content="Building TeX Live (2020)"> +<meta name="keywords" content="Building TeX Live (2020)"> <meta name="resource-type" content="document"> <meta name="distribution" content="global"> <meta name="Generator" content="makeinfo"> @@ -57,7 +57,7 @@ ul.no-bullet {list-style: none} </head> <body lang="en"> -<h1 class="settitle" align="center">Building TeX Live (2019)</h1> +<h1 class="settitle" align="center">Building TeX Live (2020)</h1> @@ -83,7 +83,7 @@ ul.no-bullet {list-style: none} <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">Index</a></li> +<li><a id="stoc-Index-1" href="#toc-Index-1" rel="index">Index</a></li> </ul> </div> @@ -196,6 +196,7 @@ ul.no-bullet {list-style: none} <li><a id="toc-Transfer-from-Subversion-to-Github-1" href="#Transfer-from-Subversion-to-Github">9.1 Transfer from Subversion to Github</a></li> <li><a id="toc-Automatic-update-of-the-Git-mirror-1" href="#Automatic-update-of-the-Git-mirror">9.2 Automatic update of the Git mirror</a></li> <li><a id="toc-CI-testing-on-Travis_002dCI-1" href="#CI-testing-on-Travis_002dCI">9.3 CI testing on Travis-CI</a></li> + <li><a id="toc-Releases-on-Github-1" href="#Releases-on-Github">9.4 Releases on Github</a></li> </ul></li> <li><a id="toc-install_002dtl-1" href="#install_002dtl">Appendix A install-tl</a> <ul class="no-bullet"> @@ -221,7 +222,7 @@ ul.no-bullet {list-style: none} <li><a id="toc-version" href="#tlmgr-version">B.6.2 version</a></li> <li><a id="toc-backup" href="#tlmgr-backup">B.6.3 backup</a></li> <li><a id="toc-candidates-pkg" href="#tlmgr-candidates-pkg">B.6.4 candidates <em>pkg</em></a></li> - <li><a id="toc-check-_005boption_002e_002e_002e_005d-_005bfiles_007cdepends_007cexecutes_007crunfiles_007call_005d" href="#tlmgr-check-_005boption_002e_002e_002e_005d-_005bfiles_007cdepends_007cexecutes_007crunfiles_007call_005d">B.6.5 check [<em>option</em>...] [files|depends|executes|runfiles|all]</a></li> + <li><a id="toc-check-_005boption_002e_002e_002e_005d-_005bdepends_007cexecutes_007cfiles_007crunfiles_007ctexmfdbs_007call_005d" href="#tlmgr-check-_005boption_002e_002e_002e_005d-_005bdepends_007cexecutes_007cfiles_007crunfiles_007ctexmfdbs_007call_005d">B.6.5 check [<em>option</em>...] [depends|executes|files|runfiles|texmfdbs|all]</a></li> <li><a id="toc-conf" href="#tlmgr-conf">B.6.6 conf</a></li> <li><a id="toc-dump_002dtlpdb-_005boption_002e_002e_002e_005d-_005b_002d_002djson_005d" href="#tlmgr-dump_002dtlpdb-_005boption_002e_002e_002e_005d-_005b_002d_002djson_005d">B.6.7 dump-tlpdb [<em>option</em>...] [–json]</a></li> <li><a id="toc-generate" href="#tlmgr-generate">B.6.8 generate</a></li> @@ -279,9 +280,10 @@ ul.no-bullet {list-style: none} <li><a id="toc-Machine_002dreadable-update-and-install-output" href="#tlmgr-Machine_002dreadable-update-and-install-output">B.12.1 Machine-readable <code>update</code> and <code>install</code> output</a></li> <li><a id="toc-Machine_002dreadable-option-output" href="#tlmgr-Machine_002dreadable-option-output">B.12.2 Machine-readable <code>option</code> output</a></li> </ul></li> - <li><a id="toc-AUTHORS-AND-COPYRIGHT-1" href="#tlmgr-AUTHORS-AND-COPYRIGHT">B.13 AUTHORS AND COPYRIGHT</a></li> + <li><a id="toc-ENVIRONMENT-VARIABLES-1" href="#tlmgr-ENVIRONMENT-VARIABLES">B.13 ENVIRONMENT VARIABLES</a></li> + <li><a id="toc-AUTHORS-AND-COPYRIGHT-1" href="#tlmgr-AUTHORS-AND-COPYRIGHT">B.14 AUTHORS AND COPYRIGHT</a></li> </ul></li> - <li><a id="toc-Index-1" href="#Index">Index</a></li> + <li><a id="toc-Index-1" href="#Index" rel="index">Index</a></li> </ul> </div> @@ -290,7 +292,7 @@ ul.no-bullet {list-style: none} <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-_00282019_0029"></span><h1 class="top">Building TeX Live (2019)</h1> +<span id="Building-TeX-Live-_00282020_0029"></span><h1 class="top">Building TeX Live (2020)</h1> <p>For an overview of this manual, see <a href="#Introduction">Introduction</a>. </p> @@ -317,7 +319,7 @@ Next: <a href="#Introduction" accesskey="n" rel="next">Introduction</a>, Up: <a </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">Index</a></td><td> </td><td align="left" valign="top">General index. +<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> @@ -331,8 +333,8 @@ Next: <a href="#Overview-of-build-system" accesskey="n" rel="next">Overview of b <span id="index-introduction"></span> -<p>This manual (dated February 2019) corresponds to the TeX Live -2019 release. +<p>This manual (dated March 2020) corresponds to the TeX Live +2020 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 @@ -473,11 +475,10 @@ Automake/Autoconf output in general) work with any reasonable <span id="index-C_002b_002b11_002c-required"></span> <p>A C++11 compiler is similarly required because of the third-party libraries ICU and Poppler; the program <code>dvisvgm</code> also requires -C++11. It is possible to build everything else with older compilers; -<a href="https://tug.org/texlive/custom-bin.html">https://tug.org/texlive/custom-bin.html</a> links to a build script -for doing this. +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> -<p>However, a few programs in the tree have additional requirements: +<p>A few programs in the tree have additional requirements: </p> <dl compact="compact"> <dt><samp>web2c</samp></dt> @@ -488,7 +489,7 @@ for doing this. <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, often in “development” packages +<p>require X11 headers and libraries, typically in “development” packages that are not installed by default. </p> </dd> @@ -506,7 +507,7 @@ frameworks. <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>, and <code>pdflatex</code> +<code>latex</code>, <code>pdflatex</code>. </p> </dd> </dl> @@ -708,17 +709,9 @@ However, the <samp>Makefile</samp>s still contain all build rules and dependencies and can be invoked to build an individual program or library, first building any required libraries. </p> -<p>This “build-on-demand” procedure is used, e.g., in the upstream -LuaTeX repository to build LuaTeX, from a subset of the complete -TeX Live source tree. As another example, when building the original -e-TeX has been disabled (as it is by default), one can run -<code>make etex</code> (or <code>make etex.exe</code>) in <samp>texk/web2c/</samp> to -build e-TeX (although there is no comparably simple way to -<em>install</em> e-TeX). -</p> -<p>If you want to work on a single program within the TL sources, this is -the recommended way to do it. Here is an example from start to -finish for working on <code>dvipdfm-x</code>. +<p>Here is an example from start to finish for working on +<code>dvipdfm-x</code>. (Unfortunately, this does not suffice for building +one, or a subset, of the TeX engines; see the next section.) </p> <div class="example"> <pre class="example">mkdir mydir && cd mydir # new working directory @@ -760,7 +753,6 @@ 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="index-size-of-source-tree"></span> <p>Finally, the above retrieves the entire TL source tree (several hundred megabytes). It is natural to ask if this is really necessary. @@ -774,12 +766,23 @@ 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="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> +<div class="example"> +<pre class="example">rm -rf libs/icu libs/poppler libs/graphite2 texk/dvisvgm +</pre></div> + <span id="index-_002d_002denable_002dmissing-to-ignore-dependencies"></span> -<p>Even with <code>--disable-all-pkgs</code>, dependencies will be checked. -For instance, if a (non-MacOSX) system does not have -<code>fontconfig</code>, XeTeX cannot be built (see <a href="#Prerequisites">Prerequisites</a>) -and <code>configure</code> will terminate. To proceed without such -dependencies, specify <code>--enable-missing</code> also. +<p>Also, even with <code>--disable-all-pkgs</code>, dependencies are (currently) +checked. For instance, if a (non-MacOSX) 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.) </p> <span id="index-CC_003dc_002dcompiler"></span> <span id="index-CXX_003dc_002b_002b_002dcompiler"></span> @@ -818,8 +821,9 @@ make luatex # specify target <p>This works because the <code>make</code> automatically runs <code>configure</code> as necessary for the dependencies and target. Furthermore, the source -tree can be cut down to just what is needed for the given engine (as -the separate pdfTeX and LuaTeX source repositories do). +tree can be cut down to just what is needed for the given engine +(the separate pdfTeX and LuaTeX source repositories do this, if +you want to peruse examples). </p> <p>We hope to improve the situation in the future. Patches are welcome. </p> @@ -1275,11 +1279,11 @@ may be. <div class="display"> <pre class="display">autoconf (GNU Autoconf) 2.69 automake (GNU automake) 1.16.1 -bison (GNU Bison) 3.3.1 +bison (GNU Bison) 3.5.2 flex 2.6.0 ltmain.sh (GNU libtool) 2.4.6 m4 (GNU M4) 1.4.18 -makeinfo (GNU texinfo) 6.6 +makeinfo (GNU texinfo) 6.7 </pre></div> <span id="index-reautoconf"></span> @@ -1303,7 +1307,6 @@ bugs). For this to be reflected by their timestamps in your checkout, be sure to set <samp>use-commit-times=yes</samp> in <samp>~/.subversion/config</samp> or the equivalent. </p> - <span id="index-touching-files-to-avoid-rerunning"></span> <span id="index-make-_002dt"></span> <p>If timestamps are wrong, you may also be able to avoid unnecessary @@ -1312,7 +1315,7 @@ runs of <code>bison</code>, <code>flex</code>, or <code>makeinfo</code> with files. With <code>--enable-maintainer-mode</code> it may also be necessary to <code>touch</code> first <samp>aclocal.m4</samp>, then <samp>configure</samp> and <samp>config.h.in</samp> (or <samp>c-auto.in</samp>), and finally all -<samp>Makefile.in</samp> files. Perhaps <code>make -t</code> will help. +<samp>Makefile.in</samp> files. </p> <hr> @@ -2548,7 +2551,7 @@ enabled. This is useful when one wants to work on only a single program, which is specified with an additional <code>--enable</code> option, e.g., <code>--enable-dvipdfm-x</code>. It’s still simplest to check out and configure the whole source tree, but at least only the program you are -interested in, and its dependencies, are built. See <a href="#Build-one-package">Build one package</a>. +interested in, and its dependencies, are built. See <a href="#Build-one-package">Build one package</a>. </p> <p>Without this option, all modules are built except those that are explicitly disabled or specify <code>disable</code> in their @@ -3175,6 +3178,8 @@ commit pushed is tested on Travis-CI. </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> @@ -3251,7 +3256,7 @@ any) to Github. <hr> <span id="CI-testing-on-Travis_002dCI"></span><div class="header"> <p> -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> +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> <span id="CI-testing-on-Travis_002dCI-1"></span><h3 class="section">9.3 CI testing on Travis-CI</h3> @@ -3268,6 +3273,26 @@ Travis-CI. automatically checkout the last pushed commit and try building it. </p> <hr> +<span id="Releases-on-Github"></span><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> +<span id="Releases-on-Github-1"></span><h3 class="section">9.4 Releases on Github</h3> + +<p>Given a git checkout of <code>texlive-source</code>: +</p> +<div class="example"> +<pre class="example">git pull +git tag build-svnNNNN +git push --tags +</pre></div> + +<p>and the result will appear at +<a href="https://github.com/TeX-Live/texlive-source/releases">https://github.com/TeX-Live/texlive-source/releases</a>. +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"> <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> @@ -3323,10 +3348,10 @@ Next: <a href="#install_002dtl-REFERENCES" accesskey="n" rel="next">install-tl R <span id="DESCRIPTION"></span><h3 class="appendixsec">A.3 DESCRIPTION</h3> <p>This installer creates a runnable TeX Live installation from various -media, including over the network, from local hard disk, a DVD, etc. -The installer works across all platforms supported by TeX Live. For -information on initially downloading the TeX Live, see -<a href="http://tug.org/texlive/acquire.html">http://tug.org/texlive/acquire.html</a>. +media, including over the network, from local hard disk, a DVD, etc. The +installer works on all platforms supported by TeX Live. For information +on initially downloading TeX Live, see +<a href="https://tug.org/texlive/acquire.html">https://tug.org/texlive/acquire.html</a>. </p> <p>The basic idea of TeX Live installation is for you to choose one of the top-level <em>schemes</em>, each of which is defined as a different set of @@ -3348,15 +3373,15 @@ Next: <a href="#install_002dtl-OPTIONS" accesskey="n" rel="next">install-tl OPTI </div> <span id="REFERENCES"></span><h3 class="appendixsec">A.4 REFERENCES</h3> -<p>Post-installation configuration, package updates, and much more, are +<p>Post-installation configuration, package updates, and more, are handled through <strong>tlmgr</strong>(1), the TeX Live Manager -(<a href="http://tug.org/texlive/tlmgr.html">http://tug.org/texlive/tlmgr.html</a>). +(<a href="https://tug.org/texlive/tlmgr.html">https://tug.org/texlive/tlmgr.html</a>). </p> <p>The most up-to-date version of this installer documentation is on the -Internet at <a href="http://tug.org/texlive/doc/install-tl.html">http://tug.org/texlive/doc/install-tl.html</a>. +Internet at <a href="https://tug.org/texlive/doc/install-tl.html">https://tug.org/texlive/doc/install-tl.html</a>. </p> <p>For the full documentation of TeX Live, see -<a href="http://tug.org/texlive/doc">http://tug.org/texlive/doc</a>. +<a href="https://tug.org/texlive/doc">https://tug.org/texlive/doc</a>. </p> <hr> <span id="install_002dtl-OPTIONS"></span><div class="header"> @@ -3372,7 +3397,7 @@ option by either a space or <code>=</code>. <dl compact="compact"> <dt><strong>-gui</strong> [[=]<em>module</em>]</dt> <dd><span id="install_002dtl-_002dgui-_005b_005b_003d_005dmodule_005d"></span> -<p>If no <em>module</em> is given, starts the <code>perltk</code> (see below) GUI installer. +<p>If no <em>module</em> is given, starts the Tcl/Tk (see below) GUI installer. </p> <p>If <em>module</em> is given loads the given installer module. Currently the following modules are supported: @@ -3384,93 +3409,92 @@ following modules are supported: <code>-no-gui</code> option. </p> </dd> +<dt><code>tcl</code></dt> +<dd><span id="install_002dtl-tcl"></span> +<p>The Tcl/Tk user interface (default on Macs and Windows). It starts +with a small number of configuration options, roughly equivalent +to what the wizard option below offers, but a button <code>Advanced</code> +takes you to a screen with roughly the same options as the <code>perltk</code> +interface. +</p> +</dd> <dt><code>wizard</code></dt> <dd><span id="install_002dtl-wizard"></span> -<p>The wizard mode user interface (default on Windows), asking only minimal -questions before installing all of TeX Live. +<p>The wizard mode user interface, asking only minimal questions before +installing all of TeX Live. +</p> +</dd> +<dt><code>expert</code></dt> +<dd><span id="install_002dtl-expert"></span> +<p>A generic name for, currently, <code>perltk</code>; it may select a different GUI +in the future. </p> </dd> <dt><code>perltk</code></dt> <dd><span id="install_002dtl-perltk"></span> -<p>The expert GUI installer, providing access to more options. -Can also be invoked on Windows by running <code>install-tl-advanced.bat</code>. +<p>The expert GUI installer, providing access to more options. </p> </dd> </dl> -<p>The <code>perltk</code> and <code>wizard</code> modules, and thus also when calling with -bare <code>-gui</code> (with no <em>module</em>), require the Perl/Tk module -(<a href="http://tug.org/texlive/distro.html#perltk">http://tug.org/texlive/distro.html#perltk</a>); if Perl/Tk is not -available, installation continues in text mode. +<p>The <code>perltk</code> and <code>wizard</code> modules require the Perl/Tk module +(<a href="https://tug.org/texlive/distro.html#perltk">https://tug.org/texlive/distro.html#perltk</a>). if Perl/Tk is not +available, installation continues in text mode, except on Windows, +where all gui options except <code>text</code> are diverted to the default +<code>tcl</code> GUI. +</p> +<p>The <code>tcl</code> GUI requires Tcl/Tk. This is standard on Macs and is often +already installed on GNU/Linux. For Windows, TeX Live provides a Tcl/Tk +runtime. </p> </dd> <dt><strong>-no-gui</strong></dt> <dd><span id="install_002dtl-_002dno_002dgui"></span> -<p>Use the text mode installer (default except on Windows). +<p>Use the text mode installer (default except on Windows and Macs). </p> </dd> <dt><strong>-lang</strong> <em>llcode</em></dt> <dd><span id="install_002dtl-_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 -you can select a different language by giving this option with a -language code (based on ISO 639-1). Currently supported (but not -necessarily completely translated) are: English (en, default), Czech -(cs), German (de), French (fr), Italian (it), Japanese (ja), Dutch (nl), -Polish (pl), Brazilian Portuguese (pt_BR), Russian (ru), Slovak (sk), -Slovenian (sl), Serbian (sr), Ukrainian (uk), Vietnamese (vi), -simplified Chinese (zh_CN), and traditional Chinese (zh_TW). +<p>By default, the GUI tries to deduce your language from the +environment. The Tcl GUI uses the language detection built into +Tcl/Tk; the Perl/Tk GUIs use the <code>LC_MESSAGES</code> environment +variable. If that fails you can select a different language by +giving this option with a language code (based on ISO 639-1). +Currently supported (but not necessarily completely translated) are: +English (en, default), Czech (cs), German (de), French (fr), Italian +(it), Japanese (ja), Dutch (nl), Polish (pl), Brazilian Portuguese +(pt_BR), Russian (ru), Slovak (sk), Slovenian (sl), Serbian (sr), +Ukrainian (uk), Vietnamese (vi), simplified Chinese (zh_CN), and +traditional Chinese (zh_TW). </p> </dd> <dt><strong>-repository</strong> <em>url|path</em></dt> <dd><span id="install_002dtl-_002drepository-url_007cpath"></span> <p>Specify the package repository to be used as the source of the -installation, either a local directory via <code>/path/to/directory</code> or a -<code>file:/</code> url, or a network location via a <code>http://</code>, <code>https://</code>, or -<code>ftp://</code> url. (No other protocols are supported, and <code>https://</code> may -not work on all platforms.) +installation. In short, this can be a directory name or a url using +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>The default is to pick a mirror automatically, using +<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 -used for the entire download. You can use the special argument <code>ctan</code> -as an abbreviation for this. See <a href="http://ctan.org">http://ctan.org</a> for more about CTAN -and its mirrors. -</p> -<p>If the repository is on the network, trailing <code>/</code> characters and/or -trailing <code>/tlpkg</code> and <code>/archive</code> components are ignored. For example, -you could choose a particular CTAN mirror with something like this: +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.) </p> -<pre class="verbatim"> -repository http://ctan.example.org/its/ctan/dir/systems/texlive/tlnet -</pre> -<p>Of course a real hostname and its particular top-level CTAN directory -have to be specified. The list of CTAN mirrors is available at -<a href="http://ctan.org/mirrors">http://ctan.org/mirrors</a>. -</p> -<p>If the repository is local, the installation type (compressed or live) is -automatically determined, by checking for the presence of a -<code>archive</code> directory relative to the root. Compressed is -preferred if both are available, since it is faster. Here’s an example -of using a local directory: -</p> -<pre class="verbatim"> -repository /local/TL/repository -</pre> <p>After installation is complete, you can use that installation as the repository for another installation. If you chose to install less than the full scheme containing all packages, the list of available schemes will be adjusted accordingly. </p> -<p>For backward compatibility and convenience, <code>--location</code> and <code>--repo</code> -are accepted as aliases for this option. -</p> </dd> <dt><strong>-select-repository</strong></dt> <dd><span id="install_002dtl-_002dselect_002drepository"></span> -<p>This option allows manual selection of a mirror from the current list of -active CTAN mirrors. This option is supported in all installer modes -(text, wizard, perltk), and will also offer to install from local media -if available, or from a repository specified on the command line (see -above). It’s useful when the (default) automatic redirection does not -choose a good host for you. +<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>, +<code>wizard</code> and <code>perltk</code> installer modes, and will also offer to install +from local media if available, or from a repository specified on the +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> @@ -3494,14 +3518,14 @@ actions. To install multiple custom binary sets, manually rename <code>custom</code> before doing each. </p> <p>For more information on custom binaries, see -<a href="http://tug.org/texlive/custom-bin.html">http://tug.org/texlive/custom-bin.html</a>. For general information on -building TeX Live, see <a href="http://tug.org/texlive/build.html">http://tug.org/texlive/build.html</a>. +<a href="https://tug.org/texlive/custom-bin.html">https://tug.org/texlive/custom-bin.html</a>. For general information on +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> <dd><span id="install_002dtl-_002ddebug_002dtranslation"></span> -<p>In GUI mode, this switch makes <code>tlmgr</code> report any missing, or more -likely untranslated, messages to standard error. Helpful for +<p>In the Perl/Tk GUI modes, this option reports any missing, or more +likely untranslated, messages to standard error. Helpful for translators to see what remains to be done. </p> </dd> @@ -3514,12 +3538,12 @@ runnable, or installation will fail. <code>-force-arch</code> is a synonym. </dd> <dt><strong>-help</strong>, <strong>–help</strong>, <strong>-?</strong></dt> <dd><span id="install_002dtl-_002dhelp_002c-_002d_002dhelp_002c-_002d_003f"></span> -<p>Display this help and exit. (This help is on the web at -<a href="http://tug.org/texlive/doc/install-tl.html">http://tug.org/texlive/doc/install-tl.html</a>). Sometimes the -<code>perldoc</code> and/or <code>PAGER</code> programs on the system have problems, -possibly resulting in control characters being literally output. This -can’t always be detected, but you can set the <code>NOPERLDOC</code> environment -variable and <code>perldoc</code> will not be used. +<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> +and/or <code>PAGER</code> programs on the system have problems, possibly resulting +in control characters being literally output. This can’t always be +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> @@ -3535,9 +3559,9 @@ installer interfaces. USE AT YOUR OWN RISK. </dd> <dt><strong>-init-from-profile</strong> <em>profile_file</em></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 the -interactive session. +<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> @@ -3557,16 +3581,11 @@ release. a new menu (for debugging purposes). </p> </dd> -<dt><strong>-non-admin</strong></dt> -<dd><span id="install_002dtl-_002dnon_002dadmin"></span> -<p>For Windows only: configure for the current user, not for all users. -</p> +<dt><strong>-no-persistent-downloads</strong></dt> +<dd><span id="install_002dtl-_002dno_002dpersistent_002ddownloads"></span> </dd> <dt><strong>-persistent-downloads</strong></dt> <dd><span id="install_002dtl-_002dpersistent_002ddownloads"></span> -</dd> -<dt><strong>-no-persistent-downloads</strong></dt> -<dd><span id="install_002dtl-_002dno_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 opens only one connection between your computer and the server per @@ -3584,7 +3603,12 @@ LWP and persistent connections, use <code>-no-persistent-downloads</code>. verified against a cryptographic signature. This option disables such verification. The full description is in the Crytographic Verification section of the <code>tlmgr</code> documentation, e.g., -<a href="http://tug.org/texlive/doc/tlmgr.html#CRYPTOGRAPHIC-VERIFICATION">http://tug.org/texlive/doc/tlmgr.html#CRYPTOGRAPHIC-VERIFICATION</a> +<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> +<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> @@ -3603,7 +3627,8 @@ within the perltk and text installers. <dt><strong>-profile</strong> <em>profile_file</em></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. See <a href="#install_002dtl-PROFILES">PROFILES</a> below. +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> @@ -3630,8 +3655,8 @@ menu list. </dd> <dt><strong>-version</strong>, <strong>–version</strong></dt> <dd><span id="install_002dtl-_002dversion_002c-_002d_002dversion"></span> -<p>Output version information and exit. If <code>-v</code> has also been given the -revisions of the used modules are reported, too. +<p>Output version information and exit. If <code>-v</code> is also given, the +versions of the TeX Live modules used are also reported. </p> </dd> </dl> @@ -3647,11 +3672,17 @@ Next: <a href="#install_002dtl-ENVIRONMENT-VARIABLES" accesskey="n" rel="next">i installation. After a normal installation has finished, a profile for that exact installation is written to the file <code>tlpkg/texlive.profile</code>. In addition, from the text menu one can select <code>P</code> to save the current -setup as a profile at any time. Such a profile file can be given as the -argument to <code>-profile</code>, for example to redo the exact same installation -on a different system. Alternatively, you can use a custom profile, -most easily created by starting from a generated one and changing -values, or an empty file, which will take all the defaults. +setup as a profile at any time. +</p> +<p>Such a profile file can be given as the argument to <code>-profile</code>, for +example to redo the exact same installation on a different system. +Alternatively, you can use a custom profile, most easily created by +starting from a generated one and changing values, or an empty file, +which will take all the defaults. +</p> +<p>As mentioned above, the installer only supports selection by scheme and +collections, not individual packages, so packages cannot be specified in +profile files either. Use <code>tlmgr</code> to work at the package level. </p> <p>Within a profile file, each line consists of </p> @@ -3738,7 +3769,7 @@ see <code>-repository</code> above. <p><strong>tlpdb options</strong> (prefix <code>tlpdbopt_</code>) </p> -<p>The definitive list is given in <code>tlpkg/TeXLive/TLConfig.pm</code>, in +<p>The definitive list is given in <code>tlpkg/TeXLive/TLConfig.pm</code>, in the hash <code>%TeXLive::TLConfig::TLPDBOptions</code>, together with explanations. All items given there <em>except</em> for <code>tlpdbopt_location</code> can be specified. Here is the current list: @@ -3760,11 +3791,11 @@ Here is the current list: <p><strong>platform options</strong> (prefix <code>binary_</code>) </p> <p>For each supported platform in TeX Live (directories under <code>bin/</code>), the -variable <code>binary_</code><em>PLATFORM</em> can be set. For example: +variable <code>binary_</code><em>PLATFORM</em> can be set with value 1. For example: </p> -<pre class="verbatim"> binary_x86_64-linux +<pre class="verbatim"> binary_x86_64-linux 1 </pre> -<p>If no <code>binary_</code> variable is specified, the default is whatever the +<p>If no <code>binary_</code> settings are made, the default is whatever the current machine is running. </p> <p>In releases before 2017, many profile variables had different @@ -3773,7 +3804,7 @@ accepted and transformed to the names given above. When a profile is written, the names above are always used. </p> <p>For more details on all of the above options, consult the TeX Live -installation manual, linked from <a href="http://tug.org/texlive/doc">http://tug.org/texlive/doc</a>. +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"> @@ -3782,11 +3813,24 @@ Next: <a href="#install_002dtl-AUTHORS-AND-COPYRIGHT" accesskey="n" rel="next">i </div> <span id="ENVIRONMENT-VARIABLES"></span><h3 class="appendixsec">A.7 ENVIRONMENT VARIABLES</h3> -<p>For ease in scripting and debugging, <code>install-tl</code> will look for the -following environment variables. They are not of interest for normal +<p>For ease in scripting and debugging, <code>install-tl</code> looks for the +following environment variables. They are not of interest for normal user installations. </p> <dl compact="compact"> +<dt><code>TEXLIVE_DOWNLOADER</code></dt> +<dd><span id="install_002dtl-TEXLIVE_005fDOWNLOADER"></span> +</dd> +<dt><code>TL_DOWNLOAD_PROGRAM</code></dt> +<dd><span id="install_002dtl-TL_005fDOWNLOAD_005fPROGRAM"></span> +</dd> +<dt><code>TL_DOWNLOAD_ARGS</code></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> <dd><span id="install_002dtl-TEXLIVE_005fINSTALL_005fENV_005fNOCHECK"></span> <p>Omit the check for environment variables containing the string <code>tex</code>. @@ -3799,10 +3843,16 @@ variables. <p>Omit creating the ConTeXt cache. This is useful for redistributors. </p> </dd> +<dt><code>TEXLIVE_INSTALL_NO_IMPORT</code></dt> +<dd><span id="install_002dtl-TEXLIVE_005fINSTALL_005fNO_005fIMPORT"></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> <dd><span id="install_002dtl-TEXLIVE_005fINSTALL_005fNO_005fWELCOME"></span> <p>Omit printing the welcome message after successful installation, e.g., -for testing. +when testing. </p> </dd> <dt><code>TEXLIVE_INSTALL_PREFIX</code></dt> @@ -3850,10 +3900,10 @@ Previous: <a href="#install_002dtl-ENVIRONMENT-VARIABLES" accesskey="p" rel="pre <span id="AUTHORS-AND-COPYRIGHT"></span><h3 class="appendixsec">A.8 AUTHORS AND COPYRIGHT</h3> <p>This script and its documentation were written for the TeX Live -distribution (<a href="http://tug.org/texlive">http://tug.org/texlive</a>) and both are licensed under the +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 46908 2018-03-10 00:46:28Z preining $ +<p>$Id: install-tl 54143 2020-03-06 23:51:18Z karl $ </p> <hr> <span id="tlmgr"></span><div class="header"> @@ -3887,6 +3937,8 @@ Next: <a href="#Index" accesskey="n" rel="next">Index</a>, Previous: <a href="#i </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> @@ -3918,11 +3970,11 @@ Next: <a href="#tlmgr-EXAMPLES" accesskey="n" rel="next">tlmgr EXAMPLES</a>, Pre <p><strong>tlmgr</strong> manages an existing TeX Live installation, both packages and configuration options. For information on initially downloading and -installing TeX Live, see <a href="http://tug.org/texlive/acquire.html">http://tug.org/texlive/acquire.html</a>. +installing TeX Live, see <a href="https://tug.org/texlive/acquire.html">https://tug.org/texlive/acquire.html</a>. </p> <p>The most up-to-date version of this documentation (updated nightly from the development sources) is available at -<a href="http://tug.org/texlive/tlmgr.html">http://tug.org/texlive/tlmgr.html</a>, along with procedures for updating +<a href="https://tug.org/texlive/tlmgr.html">https://tug.org/texlive/tlmgr.html</a>, along with procedures for updating <code>tlmgr</code> itself and information about test versions. </p> <p>TeX Live is organized into a few top-level <em>schemes</em>, each of which is @@ -3932,7 +3984,7 @@ files. Schemes typically contain a mix of collections and packages, but each package is included in exactly one collection, no more and no less. A TeX Live installation can be customized and managed at any level. </p> -<p>See <a href="http://tug.org/texlive/doc">http://tug.org/texlive/doc</a> for all the TeX Live documentation +<p>See <a href="https://tug.org/texlive/doc">https://tug.org/texlive/doc</a> for all the TeX Live documentation available. </p> <hr> @@ -3954,9 +4006,13 @@ with <code>tlmgr</code>: <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 -the given url. Caveat: <code>mirror.ctan.org</code> resolves to many different -hosts, and they are not perfectly synchronized; we recommend updating -only daily (at most), and not more often. +the given url. +</p> +<p>Caveat: <code>mirror.ctan.org</code> resolves to many different hosts, and they +are not perfectly synchronized; we recommend updating only daily (at +most), and not more often. You can choose a particular mirror if +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> @@ -3998,32 +4054,117 @@ between an option name and its value. <dl compact="compact"> <dt><strong>–repository</strong> <em>url|path</em></dt> <dd><span id="tlmgr-_002d_002drepository-url_007cpath"></span> -<p>Specifies the package repository from which packages should be installed -or updated, overriding the default package repository found in the -installation’s TeX Live Package Database (a.k.a. the TLPDB, defined -entirely in the file <code>tlpkg/texlive.tlpdb</code>). The documentation for -<code>install-tl</code> has more details about this -(<a href="http://tug.org/texlive/doc/install-tl.html">http://tug.org/texlive/doc/install-tl.html</a>). -</p> -<p><code>--repository</code> changes the repository location only for the current +<p>Specify the package repository from which packages should be installed +or updated, either a local directory or network location, as below. This +overridesthe default package repository found in the installation’s TeX +Live Package Database (a.k.a. the TLPDB, which is given entirely in the +file <code>tlpkg/texlive.tlpdb</code>). +</p> +<p>This <code>--repository</code> option changes the location only for the current run; to make a permanent change, use <code>option repository</code> (see the <a href="#tlmgr-option">option</a> action). </p> +<p>As an example, you can choose a particular CTAN mirror with something +like this: +</p> +<pre class="verbatim"> -repository http://ctan.example.org/its/ctan/dir/systems/texlive/tlnet +</pre> +<p>Of course a real hostname and its particular top-level CTAN directory +have to be specified. The list of CTAN mirrors is available at +<a href="https://ctan.org/mirrors/mirmon">https://ctan.org/mirrors/mirmon</a>. +</p> +<p>Here’s an example of using a local directory: +</p> +<pre class="verbatim"> -repository /local/TL/repository +</pre> <p>For backward compatibility and convenience, <code>--location</code> and <code>--repo</code> are accepted as aliases for this option. </p> +<p>Locations can be specified as any of the following: +</p> +<dl compact="compact"> +<dt><code>/some/local/dir</code></dt> +<dd><span id="tlmgr-_002fsome_002flocal_002fdir"></span> +</dd> +<dt><code>file:/some/local/dir</code></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> +<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> +<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> +<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 +downloads, or an arbitrary user-specified program, as described in the +<code>tlmgr</code> documentation +(<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> +<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 +support https, and even when <code>wget</code> supports https, certificates may be +rejected even when the certificate is fine, due to a lack of local +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> +<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> +<dd><span id="tlmgr-user_0040machine_003a_002fpath_002fto_002ftlnet"></span> +</dd> +<dt><code>scp://user@machine/path/to/tlnet</code></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> +<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: +<a href="https://en.wikipedia.org/wiki/OpenSSH">https://en.wikipedia.org/wiki/OpenSSH</a>, +<a href="https://en.wikipedia.org/wiki/Ssh-agent">https://en.wikipedia.org/wiki/Ssh-agent</a>.) +</p> +</dd> +</dl> + +<p>If the repository is on the network, trailing <code>/</code> characters and/or +trailing <code>/tlpkg</code> and/or <code>/archive</code> components are ignored. +</p> </dd> <dt><strong>–gui</strong> [<em>action</em>]</dt> <dd><span id="tlmgr-_002d_002dgui-_005baction_005d"></span> -<p><code>tlmgr</code> has a graphical interface as well as the command line -interface. You can give this option, <code>--gui</code>, together with an action -to be brought directly into the respective screen of the GUI. For -example, running +<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. +</p> +<p><code>tlmgr</code> itself has a graphical interface as well as the command line +interface. You can give the option to invoke it, <code>--gui</code>, together with +an action to be brought directly into the respective screen of the GUI. +For example, running </p> <pre class="verbatim"> tlmgr --gui update </pre> <p>starts you directly at the update screen. If no action is given, the -GUI will be started at the main screen. +GUI will be started at the main screen. See <a href="#tlmgr-GUI-FOR-TLMGR">GUI FOR TLMGR</a>. +</p> +<p>However, the native GUI requires Perl/TK, which is no longer included in +TeX Live’s Perl distribution for Windows. You may find <code>tlshell</code> or +<code>tlcockpit</code> easier to work with. </p> </dd> <dt><strong>–gui-lang</strong> <em>llcode</em></dt> @@ -4031,12 +4172,12 @@ GUI will be started at the main screen. <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 you can select a different language by giving this option with a -language code (based on ISO 639-1). Currently supported (but not -necessarily completely translated) are: English (en, default), Czech -(cs), German (de), French (fr), Italian (it), Japanese (ja), Dutch (nl), -Polish (pl), Brazilian Portuguese (pt_BR), Russian (ru), Slovak (sk), -Slovenian (sl), Serbian (sr), Ukrainian (uk), Vietnamese (vi), -simplified Chinese (zh_CN), and traditional Chinese (zh_TW). +language code (based on ISO 639-1). Currently supported (but not +necessarily completely translated) are: English (en, default)<!-- /@w -->, +Czech (cs)<!-- /@w -->, German (de)<!-- /@w -->, French (fr)<!-- /@w -->, Italian (it)<!-- /@w -->, +Japanese (ja)<!-- /@w -->, Dutch (nl)<!-- /@w -->, Polish (pl)<!-- /@w -->, Brazilian Portuguese <span class="nolinebreak">(pt_BR)</span><!-- /@w -->, Russian (ru)<!-- /@w -->, Slovak (sk)<!-- /@w -->, Slovenian (sl)<!-- /@w -->, Serbian (sr)<!-- /@w -->, Ukrainian (uk)<!-- /@w -->, Vietnamese (vi)<!-- /@w -->, simplified Chinese <span class="nolinebreak">(zh_CN)</span><!-- /@w -->, and traditional Chinese <span class="nolinebreak">(zh_TW)</span><!-- /@w -->. +</p> +<p>tlshell shares its message catalog with tlmgr. </p> </dd> <dt><strong>–debug-translation</strong></dt> @@ -4143,7 +4284,7 @@ Next: <a href="#tlmgr-CONFIGURATION-FILE-FOR-TLMGR" accesskey="n" rel="next">tlm </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-_005bfiles_007cdepends_007cexecutes_007crunfiles_007call_005d" accesskey="5">tlmgr check [<em>option</em>...] [files|depends|executes|runfiles|all]</a></td><td> </td><td align="left" valign="top"> +<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> @@ -4205,7 +4346,7 @@ Next: <a href="#tlmgr-version" accesskey="n" rel="next">tlmgr version</a>, Up: < <span id="help"></span><h4 class="appendixsubsec">B.6.1 help</h4> <p>Display this help information and exit (same as <code>--help</code>, and on the -web at <a href="http://tug.org/texlive/doc/tlmgr.html">http://tug.org/texlive/doc/tlmgr.html</a>). Sometimes the +web at <a href="https://tug.org/texlive/doc/tlmgr.html">https://tug.org/texlive/doc/tlmgr.html</a>). Sometimes the <code>perldoc</code> and/or <code>PAGER</code> programs on the system have problems, resulting in control characters being literally output. This can’t always be detected, but you can set the <code>NOPERLDOC</code> environment @@ -4237,10 +4378,12 @@ Next: <a href="#tlmgr-candidates-pkg" accesskey="n" rel="next">tlmgr candidates <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 -saved to the value of the <code>--backupdir</code> option, if that is an existing and -writable directory. If <code>--backupdir</code> is not given, the <code>backupdir</code> -option setting in the TLPDB is used, if present. If both are missing, -no backups are made. +saved to the value of the <code>--backupdir</code> option, if that is an existing +and writable directory. If <code>--backupdir</code> is not given, the <code>backupdir</code> +option setting in the TLPDB is used, if present. If both are missing, no +backups are made. (The installer sets <code>backupdir</code> to +<code>.../tlpkg/backups</code>, under the TL root installation directory, so it is +usually defined; see the <a href="#tlmgr-option">option</a> description for more information.) </p> <p>If the <code>--clean</code> option is specified, backups are pruned (removed) instead of saved. The optional integer value <em>N</em> may be specified to @@ -4288,7 +4431,7 @@ performed are written to the terminal. <hr> <span id="tlmgr-candidates-pkg"></span><div class="header"> <p> -Next: <a href="#tlmgr-check-_005boption_002e_002e_002e_005d-_005bfiles_007cdepends_007cexecutes_007crunfiles_007call_005d" accesskey="n" rel="next">tlmgr check [<em>option</em>...] [files|depends|executes|runfiles|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">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> </div> <span id="candidates-pkg"></span><h4 class="appendixsubsec">B.6.4 candidates <em>pkg</em></h4> @@ -4296,21 +4439,17 @@ Next: <a href="#tlmgr-check-_005boption_002e_002e_002e_005d-_005bfiles_007cdepen See <a href="#tlmgr-MULTIPLE-REPOSITORIES">MULTIPLE REPOSITORIES</a> below. </p> <hr> -<span id="tlmgr-check-_005boption_002e_002e_002e_005d-_005bfiles_007cdepends_007cexecutes_007crunfiles_007call_005d"></span><div class="header"> +<span id="tlmgr-check-_005boption_002e_002e_002e_005d-_005bdepends_007cexecutes_007cfiles_007crunfiles_007ctexmfdbs_007call_005d"></span><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> </div> -<span id="check-_005boption_002e_002e_002e_005d-_005bfiles_007cdepends_007cexecutes_007crunfiles_007call_005d"></span><h4 class="appendixsubsec">B.6.5 check [<em>option</em>...] [files|depends|executes|runfiles|all]</h4> +<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> -<p>Executes one (or all) check(s) on the consistency of the installation. +<p>Execute one (or all) check(s) of the consistency of the installation. +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>files</strong></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>depends</strong></dt> <dd><span id="tlmgr-depends"></span> <p>Lists those packages which occur as dependencies in an installed collection, @@ -4327,12 +4466,40 @@ instead since former versions for <code>tlmgr</code> called it that way. Live Database are present. </p> </dd> +<dt><strong>files</strong></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> <dd><span id="tlmgr-runfiles"></span> <p>List those filenames that are occurring more than one time in the -runfiles sections. +runfiles sections, except for known duplicates. </p> </dd> +<dt><strong>texmfdbs</strong></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> +<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> +<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> +<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> +<dd><span id="tlmgr-_002d-all-items-in-TEXMF-with-an-ls_002dR-file-are-listed-in-TEXMFDBS_002e"></span> +</dd> +</dl> + +</dd> </dl> <p>Options: @@ -4341,7 +4508,7 @@ runfiles sections. <dt><strong>–use-svn</strong></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. +checking the TL development repository. (This is run nightly.) </p> </dd> </dl> @@ -4349,7 +4516,7 @@ checking the TL development repository. <hr> <span id="tlmgr-conf"></span><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-_005bfiles_007cdepends_007cexecutes_007crunfiles_007call_005d" accesskey="p" rel="prev">tlmgr check [<em>option</em>...] [files|depends|executes|runfiles|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">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> </div> <span id="conf"></span><h4 class="appendixsubsec">B.6.6 conf</h4> @@ -4357,8 +4524,8 @@ Next: <a href="#tlmgr-dump_002dtlpdb-_005boption_002e_002e_002e_005d-_005b_002d_ <dt><strong>conf [texmf|tlmgr|updmap [–conffile <em>file</em>] [–delete] [<em>key</em> [<em>value</em>]]]</strong></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|delete] [<em>value</em>]</strong></dt> -<dd><span id="tlmgr-conf-auxtrees-_005b_002d_002dconffile-file_005d-_005bshow_007cadd_007cdelete_005d-_005bvalue_005d"></span> +<dt><strong>conf auxtrees [–conffile <em>file</em>] [show|add|remove] [<em>value</em>]</strong></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 like running <code>texconfig conf</code>, but works on all supported platforms. @@ -4391,15 +4558,16 @@ additional texmf trees, completely under user control. <code>auxtrees show</cod shows the list of additional trees, <code>auxtrees add</code> <em>tree</em> adds a tree to the list, and <code>auxtrees remove</code> <em>tree</em> removes a tree from the list (if present). The trees should not contain an <code>ls-R</code> file (or files -might not be found if the <code>ls-R</code> becomes stale). This works by -manipulating the Kpathsea variable <code>TEXMFAUXTREES</code>, in +will not be found if the <code>ls-R</code> becomes stale). This works by +manipulating the Kpathsea variable <code>TEXMFAUXTREES</code>, in (by default) <code>ROOT/texmf.cnf</code>. Example: </p> <pre class="verbatim"> tlmgr conf auxtrees add /quick/test/tree tlmgr conf auxtrees remove /quick/test/tree </pre> <p>In all cases the configuration file can be explicitly specified via the -option <code>--conffile</code> <em>file</em>, if desired. +option <code>--conffile</code> <em>file</em>, e.g., if you don’t want to change the +system-wide configuration. </p> <p>Warning: The general facility for changing configuration values is here, but tinkering with settings in this way is strongly discouraged. Again, @@ -4483,7 +4651,7 @@ The TeX Live installer and <code>tlmgr</code> routinely call <code>generate</cod all of these files. </p> <p>For managing your own fonts, please read the <code>updmap --help</code> -information and/or <a href="http://tug.org/fonts/fontinstall.html">http://tug.org/fonts/fontinstall.html</a>. +information and/or <a href="https://tug.org/fonts/fontinstall.html">https://tug.org/fonts/fontinstall.html</a>. </p> <p>For managing your own formats, please read the <code>fmtutil --help</code> information. @@ -4649,6 +4817,14 @@ dependencies in a similar way. locally installed packages, collections, or schemes are listed. </p> </dd> +<dt><strong>–only-remote</strong></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 +<code>tlmgr --repo ... --only-remote info</code>. Note that +<code>--only-installed</code> and <code>--only-remote</code> cannot both be specified. +</p> +</dd> <dt><strong>–data <code>item1,item2,...</code></strong></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 @@ -4693,8 +4869,8 @@ Next: <a href="#tlmgr-key" accesskey="n" rel="next">tlmgr key</a>, Previous: <a <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> <p>Install each <em>pkg</em> given on the command line, if it is not already -installed. (It does not touch existing packages; see the <code>update</code> -action for how to get the latest version of a package.) +installed. It does not touch existing packages; see the <code>update</code> +action for how to get the latest version of a package. </p> <p>By default this also installs all packages on which the given <em>pkg</em>s are dependent. Options: @@ -4763,6 +4939,10 @@ after all. You can get them by using these options in conjunction with </dd> </dl> +<p>This action does not automatically add new symlinks in system +directories; you need to run <code>tlmgr path add</code> (<a href="#tlmgr-path">path</a>) yourself if +you are using this feature and want new symlinks added. +</p> <hr> <span id="tlmgr-key"></span><div class="header"> <p> @@ -4787,7 +4967,7 @@ the TeX Live databases. </p> <p>The <code>add</code> argument requires another argument, either a filename or <code>-</code> for stdin, from which the key is added. The key is added to the -local keyring <code>GNUPGHOME/repository-keys.gpg</code>, which is normally) +local keyring <code>GNUPGHOME/repository-keys.gpg</code>, which is normally <code>tlpkg/gpg/repository-keys.gpg</code>. </p> <p>The <code>remove</code> argument requires a key id and removes the requested id @@ -4816,8 +4996,8 @@ Next: <a href="#tlmgr-paper" accesskey="n" rel="next">tlmgr paper</a>, Previous: <dt><strong>option [–json] [show]</strong></dt> <dd><span id="tlmgr-option-_005b_002d_002djson_005d-_005bshow_005d"></span> </dd> -<dt><strong>option [–json] showall</strong></dt> -<dd><span id="tlmgr-option-_005b_002d_002djson_005d-showall"></span> +<dt><strong>option [–json] showall|help</strong></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> <dd><span id="tlmgr-option-key-_005bvalue_005d"></span> @@ -4829,7 +5009,8 @@ saved in the TLPDB with a short description and the <code>key</code> used for changing it in parentheses. </p> <p>The second form, <code>showall</code>, is similar, but also shows options which -can be defined but are not currently set to any value. +can be defined but are not currently set to any value (<code>help</code> is a +synonym). </p> <p>Both <code>show...</code> forms take an option <code>--json</code>, which dumps the option information in JSON format. In this case, both forms dump the same @@ -4844,7 +5025,7 @@ for <em>key</em> is displayed. If <em>value</em> is present, <em>key</em> is se the definitive list): </p> <pre class="verbatim"> repository (default package repository), - formats (create formats at installation time), + formats (generate formats at installation or update time), postcode (run postinst code blobs) docfiles (install documentation files), srcfiles (install source files), @@ -4869,7 +5050,8 @@ be used as a synonym for <code>repository</code>.) </p> <p>If <code>formats</code> is set (this is the default), then formats are regenerated when either the engine or the format files have changed. Disable this -only when you know how and want to regenerate formats yourself. +only when you know how and want to regenerate formats yourself whenever +needed (which is often, in practice). </p> <p>The <code>postcode</code> option controls execution of per-package postinstallation action code. It is set by default, and again disabling @@ -4883,10 +5065,11 @@ testing installations, etc. When disabled, the respective files are not downloaded at all. </p> <p>The options <code>autobackup</code> and <code>backupdir</code> determine the defaults for -the actions <code>update</code>, <code>backup</code> and <code>restore</code>. These three actions -need a directory in which to read or write the backups. If +the actions <code>update</code>, <code>backup</code> and <code>restore</code>. These three actions +need a directory in which to read or write the backups. If <code>--backupdir</code> is not specified on the command line, the <code>backupdir</code> -option value is used (if set). +option value is used (if set). The TL installer sets <code>backupdir</code> to +<code>.../tlpkg/backups</code>, under the TL root installation directory. </p> <p>The <code>autobackup</code> option (de)activates automatic generation of backups. Its value is an integer. If the <code>autobackup</code> value is <code>-1</code>, no @@ -4927,8 +5110,8 @@ Next: <a href="#tlmgr-path" accesskey="n" rel="next">tlmgr path</a>, Previous: < <dt><strong>paper [a4|letter]</strong></dt> <dd><span id="tlmgr-paper-_005ba4_007cletter_005d"></span> </dd> -<dt><strong>[xdvi|pdftex|dvips|dvipdfmx|context|psutils] paper [<em>papersize</em>|–list]<!-- /@w --></strong></dt> -<dd><span id="tlmgr-_005bxdvi_007cpdftex_007cdvips_007cdvipdfmx_007ccontext_007cpsutils_005d-paper-_005bpapersize_007c_002d_002dlist_005d"></span> +<dt><strong><[xdvi|pdftex|dvips|dvipdfmx|context|psutils] paper [<em>papersize</em>|–list]</strong>></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> <dd><span id="tlmgr-paper-_002d_002djson"></span> @@ -4976,10 +5159,12 @@ Next: <a href="#tlmgr-pinning" accesskey="n" rel="next">tlmgr pinning</a>, Previ </dd> <dt><strong>path [–w32mode=user|admin] remove</strong></dt> <dd><span id="tlmgr-path-_005b_002d_002dw32mode_003duser_007cadmin_005d-remove"></span> -<p>On Unix, merely adds or removes symlinks for binaries, man pages, and -info pages in the system directories specified by the respective options -(see the <a href="#tlmgr-option">option</a> description above). Does not change any -initialization files, either system or personal. +<p>On Unix, adds or removes symlinks for executables, man pages, and info +pages in the system directories specified by the respective options (see +the <a href="#tlmgr-option">option</a> description above). Does not change any initialization +files, either system or personal. Furthermore, any executables added or +removed by future updates are not taken care of automatically; this +command must be rerun as needed. </p> <p>On Windows, the registry part where the binary directory is added or removed is determined in the following way: @@ -5070,7 +5255,7 @@ platform instead of auto detection. </p> <p><code>platform set auto</code> switches TeX Live to auto detection mode for platform. </p> -<p>Platform detection is needed to select the proper <code>xz</code>, <code>xzdec</code> and +<p>Platform detection is needed to select the proper <code>xz</code> and <code>wget</code> binaries that are shipped with TeX Live. </p> <p><code>arch</code> is a synonym for <code>platform</code>. @@ -5219,6 +5404,10 @@ 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> <hr> <span id="tlmgr-repository"></span><div class="header"> <p> @@ -5230,8 +5419,8 @@ Next: <a href="#tlmgr-restore" accesskey="n" rel="next">tlmgr restore</a>, Previ <dt><strong>repository list</strong></dt> <dd><span id="tlmgr-repository-list"></span> </dd> -<dt><strong>repository list <em>path|tag</em></strong></dt> -<dd><span id="tlmgr-repository-list-path_007ctag"></span> +<dt><strong>repository list <em>path|url|tag</em></strong></dt> +<dd><span id="tlmgr-repository-list-path_007curl_007ctag"></span> </dd> <dt><strong>repository add <em>path</em> [<em>tag</em>]</strong></dt> <dd><span id="tlmgr-repository-add-path-_005btag_005d"></span> @@ -5241,21 +5430,46 @@ Next: <a href="#tlmgr-restore" accesskey="n" rel="next">tlmgr restore</a>, Previ </dd> <dt><strong>repository set <em>path</em>[#<em>tag</em>] [<em>path</em>[#<em>tag</em>] ...]</strong></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> +<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> -<p>The first form (<code>list</code>) lists all configured repositories and the -respective tags if set. If a path, url, or tag is given after the -<code>list</code> keyword, it is interpreted as source from where to -initialize a TeX Live Database and lists the contained packages. -This can also be an up-to-now not used repository, both locally -and remote. If one pass in addition <code>--with-platforms</code>, for each -package the available platforms (if any) are listed, too. +<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 +the <code>list</code> keyword, it is interpreted as the source from which to +initialize a TL database and lists the contained packages. This can also +be an otherwise-unused repository, either local or remote. If the option +<code>--with-platforms</code> is specified in addition, for each package the +available platforms (if any) are also listed. +</p> +<p>The form <code>repository add</code> adds a repository (optionally attaching a +tag) to the list of repositories, while <code>repository remove</code> removes a +repository, either by full path/url, or by tag. </p> -<p>The third form (<code>add</code>) adds a repository -(optionally attaching a tag) to the list of repositories. The forth -form (<code>remove</code>) removes a repository, either by full path/url, or by -tag. The last form (<code>set</code>) sets the list of repositories to the items -given on the command line, not keeping previous settings +<p>The form <code>repository set</code> sets the list of available repositories to +the items given on the command line, overwriting previous settings. +</p> +<p>The form <code>repository status</code> reports the verification status of the +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> +<dd><span id="tlmgr-The-tag-_0028which-can-be-the-same-as-the-url_0029_003b"></span> +<p>= the url; +</p> +<p>= iff machine-readable output is specified, the verification code (a +number); +</p> +<p>= a textual description of the verification status, as the last field +extending to the end of line. +</p> +</dd> +</dl> + +<p>That is, in normal (not machine-readable) output, the third field +(numeric verification status) is not present. </p> <p>In all cases, one of the repositories must be tagged as <code>main</code>; otherwise, all operations will fail! @@ -5488,9 +5702,9 @@ must be specified. Options: <dl compact="compact"> <dt><strong>–all</strong></dt> <dd><span id="tlmgr-_002d_002dall-5"></span> -<p>Update all installed packages except for <code>tlmgr</code> itself. Thus, if -updates to <code>tlmgr</code> itself are present, this will simply give an error, -unless also the option <code>--force</code> or <code>--self</code> is given. (See below.) +<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 +<code>--force</code> or <code>--self</code> is given. (See below.) </p> <p>In addition to updating the installed packages, during the update of a collection the local installation is (by default) synchronized to the @@ -5507,7 +5721,7 @@ remove the package in the local installation. This is called that is also installed locally, it will be added to the local installation. This is called “auto-install” and is announced as such when using the option <code>--list</code>. This auto-installation can be -suppressed using the option <code>--no-auto-install</code>. +suppressed using the option <code>--no-auto-install</code> (also not recommended). </p> <p>An exception to the collection dependency checks (including the auto-installation of packages just mentioned) are those that have been @@ -5515,6 +5729,13 @@ auto-installation of packages just mentioned) are those that have been on them. (See the <code>remove</code> action documentation.) To reinstall any such forcibly removed packages use <code>--reinstall-forcibly-removed</code>. </p> +<p>To reiterate: automatic removals and additions are entirely determined +by comparison of collections. Thus, if you manually install an +individual package <code>foo</code> which is later removed from the server, +<code>tlmgr</code> will not notice and will not remove it locally. (It has to be +this way, without major rearchitecture work, because the tlpdb does not +record the repository from which packages come from.) +</p> <p>If you want to exclude some packages from the current update run (e.g., due to a slow link), see the <code>--exclude</code> option below. </p> @@ -5583,12 +5804,12 @@ the key <code>update-exclude</code>. </dd> <dt><strong>–no-auto-remove</strong> [<em>pkg</em>...]</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 which have disappeared on -the server, as described above under <code>--all</code>. This option prevents -such removals, either for all packages (with <code>--all</code>), or for just the -given <em>pkg</em> names. This can lead to an inconsistent TeX installation, -since packages are not infrequently renamed or replaced by their -authors. Therefore this is not recommend. +<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>. +This option prevents such removals, either for all packages (with +<code>--all</code>), or for just the given <em>pkg</em> names. This can lead to an +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> @@ -5610,6 +5831,9 @@ server, then <pre class="verbatim"> tlmgr update --all tlmgr remove --force foobar </pre> +<p>Again, since packages are sometimes renamed or replaced, using this +option is not recommended. +</p> </dd> <dt><strong>–reinstall-forcibly-removed</strong></dt> <dd><span id="tlmgr-_002d_002dreinstall_002dforcibly_002dremoved"></span> @@ -5631,8 +5855,8 @@ installation with the server’s idea of what is available: <dt><strong>–backupdir</strong> <em>directory</em></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, backup of packages as currently installed. If -neither options is given, no backup will made. If <code>--backupdir</code> is +updating; that is, backing up packages as currently installed. If +neither option is given, no backup will made. If <code>--backupdir</code> is given and specifies a writable directory then a backup will be made in that location. If only <code>--backup</code> is given, then a backup will be made to the directory previously set via the <a href="#tlmgr-option">option</a> action (see @@ -5684,6 +5908,10 @@ fallback information, but if you don’t like them accumulating (e.g., <code>mirror.ctan.org</code> resolves to many different hosts, each resulting in a possibly different hash), it’s harmless to delete them. </p> +<p>This action does not automatically add or remove new symlinks in system +directories; you need to run <code>tlmgr</code> <a href="#tlmgr-path">path</a> yourself if you are using +this feature and want new symlinks added. +</p> <hr> <span id="tlmgr-CONFIGURATION-FILE-FOR-TLMGR"></span><div class="header"> <p> @@ -5691,8 +5919,8 @@ Next: <a href="#tlmgr-CRYPTOGRAPHIC-VERIFICATION" accesskey="n" rel="next">tlmgr </div> <span id="CONFIGURATION-FILE-FOR-TLMGR"></span><h3 class="appendixsec">B.7 CONFIGURATION FILE FOR TLMGR</h3> -<p>There are two configuration files for <code>tlmgr</code>: One is system-wide in -<code>TEXMFSYSCONFIG/tlmgr/config</code>, and the other is user-specific in +<p><code>tlmgr</code> reads two configuration files: one is system-wide, in +<code>TEXMFSYSCONFIG/tlmgr/config</code>, and the other is user-specific, in <code>TEXMFCONFIG/tlmgr/config</code>. The user-specific one is the default for the <code>conf tlmgr</code> action. (Run <code>kpsewhich -var-value=TEXMFSYSCONFIG</code> or <code>... TEXMFCONFIG ...</code> to see the actual @@ -5758,8 +5986,8 @@ 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="http://openssl.org">http://openssl.org</a>), the <code>sha512sum</code> program (from GNU -Coreutils, <a href="http://www.gnu.org/software/coreutils">http://www.gnu.org/software/coreutils</a>), or finally the +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 @@ -5802,8 +6030,9 @@ above) to succeed, and a working GnuPG (<code>gpg</code>) program (see below for search method). Then, unless cryptographic verification has been disabled, a signature file (<code>texlive.tlpdb.*.asc</code>) of the checksum file is downloaded and the signature verified. The signature is created by -the TeX Live Distribution GPG key 0x06BAB6BC, which in turn is signed by -Karl Berry’s key 0x30D155AD and Norbert Preining’s key 0x6CACA448. All +the TeX Live Distribution GPG key 0x0D5E5D9106BAB6BC, which in turn is +signed by Karl Berry’s key 0x0716748A30D155AD and +Norbert Preining’s key 0x6CACA448860CDC13. All of these keys are obtainable from the standard key servers. </p> <p>Additional trusted keys can be added using the <code>key</code> action. @@ -6008,49 +6237,47 @@ only one enabled (as is the case by default): /var/www/norbert/tlnet </pre> <p>Ok. Let’s add the <code>tlcontrib</code> repository (this is a real -repository, hosted at <a href="http://tlcontrib.metatex.org">http://tlcontrib.metatex.org</a>, maintained by -Taco Hoekwater et al.), with the tag <code>tlcontrib</code>: +repository hosted at <a href="http://contrib.texlive.info">http://contrib.texlive.info</a>) with the tag <code>tlcontrib</code>: </p> -<pre class="verbatim"> $ tlmgr repository add http://tlcontrib.metatex.org/2012 tlcontrib +<pre class="verbatim"> $ tlmgr repository add http://contrib.texlive.info/current tlcontrib </pre> <p>Check the repository list again: </p> <pre class="verbatim"> $ tlmgr repository list List of repositories (with tags if set): - http://tlcontrib.metatex.org/2012 (tlcontrib) + http://contrib.texlive.info/current (tlcontrib) /var/www/norbert/tlnet (main) </pre> -<p>Now we specify a pinning entry to get the package <code>context</code> from +<p>Now we specify a pinning entry to get the package <code>classico</code> from <code>tlcontrib</code>: </p> -<pre class="verbatim"> $ tlmgr pinning add tlcontrib context +<pre class="verbatim"> $ tlmgr pinning add tlcontrib classico </pre> -<p>Check that we can find <code>context</code>: +<p>Check that we can find <code>classico</code>: </p> -<pre class="verbatim"> $ tlmgr show context - tlmgr: package repositories: +<pre class="verbatim"> $ tlmgr show classico + package: classico ... - package: context - repository: tlcontrib/26867 + shortdesc: URW Classico fonts ... </pre> -<p>- install <code>context</code>: +<p>- install <code>classico</code>: </p> -<pre class="verbatim"> $ tlmgr install context +<pre class="verbatim"> $ tlmgr install classico tlmgr: package repositories: ... - [1/1, ??:??/??:??] install: context @tlcontrib [ + [1/1, ??:??/??:??] install: classico @tlcontrib [737k] </pre> -<p>In the output here you can see that the <code>context</code> package has been +<p>In the output here you can see that the <code>classico</code> package has been installed from the <code>tlcontrib</code> repository (<code>@tlcontrib</code>). </p> <p>Finally, <code>tlmgr pinning</code> also supports removing certain or all packages from a given repository: </p> -<pre class="verbatim"> $ tlmgr pinning remove tlcontrib context # remove just context +<pre class="verbatim"> $ tlmgr pinning remove tlcontrib classico # remove just classico $ tlmgr pinning remove tlcontrib --all # take nothing from tlcontrib </pre> -<p>A summary of the <code>tlmgr pinning</code> actions is given above. +<p>A summary of <code>tlmgr pinning</code> actions is given above. </p> <hr> <span id="tlmgr-GUI-FOR-TLMGR"></span><div class="header"> @@ -6060,16 +6287,22 @@ Next: <a href="#tlmgr-MACHINE_002dREADABLE-OUTPUT" accesskey="n" rel="next">tlmg <span id="GUI-FOR-TLMGR"></span><h3 class="appendixsec">B.11 GUI FOR TLMGR</h3> <p>The graphical user interface for <code>tlmgr</code> requires Perl/Tk -<a href="http://search.cpan.org/search?query=perl%2Ftk">http://search.cpan.org/search?query=perl%2Ftk</a>. For Windows the -necessary modules are shipped within TeX Live, for all other (i.e., -Unix-based) systems Perl/Tk (as well as Perl of course) has to be -installed outside of TL. <a href="http://tug.org/texlive/distro.html#perltk">http://tug.org/texlive/distro.html#perltk</a> -has a list of invocations for some distros. -</p> -<p>The GUI is started with the invocation <code>tlmgr gui</code>; assuming Tk is -loadable, the graphical user interface will be shown. The main window -contains a menu bar, the main display, and a status area where messages -normally shown on the console are displayed. +<a href="https://search.cpan.org/search?query=perl%2Ftk">https://search.cpan.org/search?query=perl%2Ftk</a>. For Unix-based +systems Perl/Tk (as well as Perl of course) has to be installed +outside of TL. <a href="https://tug.org/texlive/distro.html#perltk">https://tug.org/texlive/distro.html#perltk</a> has a +list of invocations for some distros. For Windows the necessary +modules are no longer shipped within TeX Live, so you’ll have to have an +external Perl available that includes them. +</p> +<p>We are talking here about the GUI built into tlmgr itself, not about the +other tlmgr GUIs, which are: tlshell (Tcl/Tk-based), tlcockpit +(Java-based) and, only on Macs, TeX Live Utility. These are invoked as +separate programs. +</p> +<p>The GUI mode of tlmgr is started with the invocation <code>tlmgr gui</code>; +assuming Tk is loadable, the graphical user interface will be shown. +The main window contains a menu bar, the main display, and a status +area where messages normally shown on the console are displayed. </p> <p>Within the main display there are three main parts: the <code>Display configuration</code> area, the list of packages, and the action buttons. @@ -6306,7 +6539,7 @@ on Windows). <dt><code>Help menu</code></dt> <dd><span id="tlmgr-Help-menu"></span> <p>Provides access to the TeX Live manual (also on the web at -<a href="http://tug.org/texlive/doc.html">http://tug.org/texlive/doc.html</a>) and the usual “About” box. +<a href="https://tug.org/texlive/doc.html">https://tug.org/texlive/doc.html</a>) and the usual “About” box. </p> </dd> </dl> @@ -6353,13 +6586,13 @@ of the display. </dl> <p>A few other obscure options are recognized but not mentioned here. See -the Perl/Tk documentation (<a href="http://search.cpan.org/perldoc?Tk">http://search.cpan.org/perldoc?Tk</a>) for the +the Perl/Tk documentation (<a href="https://search.cpan.org/perldoc?Tk">https://search.cpan.org/perldoc?Tk</a>) for the complete list, and any X documentation for general information. </p> <hr> <span id="tlmgr-MACHINE_002dREADABLE-OUTPUT"></span><div class="header"> <p> -Next: <a href="#tlmgr-AUTHORS-AND-COPYRIGHT" accesskey="n" rel="next">tlmgr AUTHORS AND COPYRIGHT</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">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> </div> <span id="MACHINE_002dREADABLE-OUTPUT"></span><h3 class="appendixsec">B.12 MACHINE-READABLE OUTPUT</h3> @@ -6538,17 +6771,110 @@ 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"> +<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> +</div> +<span id="ENVIRONMENT-VARIABLES-1"></span><h3 class="appendixsec">B.13 ENVIRONMENT VARIABLES</h3> + +<p><code>tlmgr</code> uses many of the standard TeX environment variables, as +reported by, e.g., <code>tlmgr conf</code> (<a href="#tlmgr-conf">conf</a>). +</p> +<p>In addition, for ease in scripting and debugging, <code>tlmgr</code> looks for the +following environment variables. These are not of interest for normal +user installations. +</p> +<dl compact="compact"> +<dt><code>TEXLIVE_COMPRESSOR</code></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: +</p> +<ol> +<li> If the environment variable <code>TEXLIVE_COMPRESSOR</code> is +defined, use it; abort if it doesn’t work. Possible values: +<code>lz4</code>, <code>gzip</code>, <code>xz</code>. The necessary options are added internally. + +</li><li> If lz4 is available (either from the system or TL) and working, use that. + +</li><li> If gzip is available (from the system) and working, use that. + +</li><li> If xz is available (either from the system or TL) and working, use that. + +</li></ol> + +<p>lz4 and gzip are faster in creating tlmgr’s local backups, hence they +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> +<dd><span id="tlmgr-TEXLIVE_005fDOWNLOADER"></span> +</dd> +<dt><code>TL_DOWNLOAD_PROGRAM</code></dt> +<dd><span id="tlmgr-TL_005fDOWNLOAD_005fPROGRAM"></span> +</dd> +<dt><code>TL_DOWNLOAD_ARGS</code></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: +</p> +<ol> +<li> If the environment variable <code>TEXLIVE_DOWNLOADER</code> is defined, use it; +abort if the specified program doesn’t work. Possible values: <code>lwp</code>, +<code>curl</code>, <code>wget</code>. The necessary options are added internally. + +</li><li> If the environment variable <code>TL_DOWNLOAD_PROGRAM</code> is +defined (can be any value), use it together with +<code>TL_DOWNLOAD_ARGS</code>; abort if it doesn’t work. + +</li><li> If LWP is available and working, use that (by far the most +efficient method, as it supports persistent downloads). + +</li><li> If curl is available (from the system) and working, use that. + +</li><li> If wget is available (either from the system or TL) and working, use that. + +</li></ol> + +<p>TL provides <code>wget</code> binaries for platforms where necessary, so some +download method should always be available. +</p> +</dd> +<dt><code>TEXLIVE_PREFER_OWN</code></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 +Live. +</p> +<p>This can create problems with systems that are too old, and so can be +overridden by setting the environment variable <code>TEXLIVE_PREFER_OWN</code> to +1. In this case, executables shipped with TL will be preferred. +</p> +<p>Extra compression/download programs not provided by TL, such as gzip, +lwp, and curl, are still checked for on the system and used if +available, per the above. <code>TEXLIVE_PREFER_OWN</code> only applies when the +program being checked for is shipped with TL, namely the lz4 and +xz compressors and wget downloader. +</p> +<p>Exception: on Windows, the <code>tar.exe</code> shipped with TL is always used, +regardless of any setting. +</p> +</dd> +</dl> + +<hr> <span id="tlmgr-AUTHORS-AND-COPYRIGHT"></span><div class="header"> <p> -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> +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> </div> -<span id="AUTHORS-AND-COPYRIGHT-1"></span><h3 class="appendixsec">B.13 AUTHORS AND COPYRIGHT</h3> +<span id="AUTHORS-AND-COPYRIGHT-1"></span><h3 class="appendixsec">B.14 AUTHORS AND COPYRIGHT</h3> <p>This script and its documentation were written for the TeX Live -distribution (<a href="http://tug.org/texlive">http://tug.org/texlive</a>) and both are licensed under the +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 47303 2018-04-05 17:52:22Z karl $ +<p>$Id: tlmgr.pl 54118 2020-03-05 22:27:22Z karl $ </p> <hr> @@ -6712,6 +7038,7 @@ Previous: <a href="#tlmgr" accesskey="p" rel="prev">tlmgr</a>, Up: <a href="#Top <tr><td></td><td valign="top"><a href="#index-building-in-parallel">building in parallel</a>:</td><td> </td><td valign="top"><a href="#Build-in-parallel">Build in parallel</a></td></tr> <tr><td colspan="4"> <hr></td></tr> <tr><th id="Index_cp_letter-C">C</th><td></td><td></td></tr> +<tr><td></td><td valign="top"><a href="#index-C_002b_002b11_002c-removing-dependent-sources">C++11, removing dependent sources</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-C_002b_002b11_002c-required">C++11, required</a>:</td><td> </td><td valign="top"><a href="#Prerequisites">Prerequisites</a></td></tr> <tr><td></td><td valign="top"><a href="#index-C_002c-ANSI_002c-required">C, ANSI, required</a>:</td><td> </td><td valign="top"><a href="#Declarations-and-definitions">Declarations and definitions</a></td></tr> <tr><td></td><td valign="top"><a href="#index-C99_002c-avoided">C99, avoided</a>:</td><td> </td><td valign="top"><a href="#Declarations-and-definitions">Declarations and definitions</a></td></tr> diff --git a/Master/texmf-dist/doc/texlive/tlbuild/tlbuild.pdf b/Master/texmf-dist/doc/texlive/tlbuild/tlbuild.pdf Binary files differindex 52c01dc18b4..7d4bd8bad61 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/web2c/web2c.html b/Master/texmf-dist/doc/web2c/web2c.html index 7d2c557a111..4ef7146223a 100644 --- a/Master/texmf-dist/doc/web2c/web2c.html +++ b/Master/texmf-dist/doc/web2c/web2c.html @@ -4,7 +4,7 @@ an implementation of Donald Knuth's TeX system. Copyright (C) 1996, 1997, 1998, 1999, 2000, 2001, 2002, 2003, -2004, 2005, 2007, 2008, 2009 Karl Berry & Olaf Weber. +2004, 2005, 2007, 2008, 2009, 2010-2020 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,7 +19,7 @@ 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.6, http://www.gnu.org/software/texinfo/ --> +<!-- 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> @@ -97,7 +97,12 @@ ul.no-bullet {list-style: none} <li><a id="toc-Hardware-and-memory-dumps-1" href="#Hardware-and-memory-dumps">3.5.2.3 Hardware and memory dumps</a></li> </ul></li> <li><a id="toc-Editor-invocation-1" href="#Editor-invocation">3.5.3 Editor invocation</a></li> - <li><a id="toc-_005cinput-filenames-1" href="#g_t_005cinput-filenames">3.5.4 <code>\input</code> filenames</a></li> + <li><a id="toc-_005cinput-filenames-1" href="#g_t_005cinput-filenames">3.5.4 <code>\input</code> filenames</a> + <ul class="no-bullet"> + <li><a id="toc-_005cinput-quoted-filename_003a-_005cinput-_0022some-name_0022" href="#g_t_005cinput-quoted-filename">3.5.4.1 <code>\input</code> quoted filename: <code>\input "some name"</code></a></li> + <li><a id="toc-_005cinput-braced-filename_003a-_005cinput_007bsome-name_007d" href="#g_t_005cinput-braced-filename">3.5.4.2 <code>\input</code> braced filename: <code>\input{some name}</code></a></li> + <li><a id="toc-_005cinput-filename-caveats-1" href="#g_t_005cinput-filename-caveats">3.5.4.3 <code>\input</code> filename caveats</a></li> + </ul></li> </ul></li> </ul></li> <li><a id="toc-TeX_003a-Typesetting" href="#TeX">4 TeX: Typesetting</a> @@ -168,7 +173,7 @@ ul.no-bullet {list-style: none} </ul></li> <li><a id="toc-Legalisms-1" href="#Legalisms">Appendix A Legalisms</a></li> <li><a id="toc-References-1" href="#References">Appendix B References</a></li> - <li><a id="toc-Index-1" href="#Index">Index</a></li> + <li><a id="toc-Index-1" href="#Index" rel="index">Index</a></li> </ul> </div> @@ -181,8 +186,8 @@ Next: <a href="#Introduction" accesskey="n" rel="next">Introduction</a>, Up: <a <p>This document describes how to install and use the programs in the Web2c implementation of the TeX system, especially for Unix systems. It -corresponds to Web2c version 2019, released in -February 2019. +corresponds to Web2c version 2020, released in +March 2020. </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. @@ -209,7 +214,7 @@ February 2019. </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">Index</a></td><td> </td><td align="left" valign="top">General index. +<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> @@ -223,8 +228,8 @@ Next: <a href="#Installation" accesskey="n" rel="next">Installation</a>, Previou <span id="index-introduction"></span> -<p>This manual corresponds to version 2019 of Web2c, released in -February 2019. +<p>This manual corresponds to version 2020 of Web2c, released in +March 2020. </p> <span id="index-Knuth_002c-Donald-E_002e"></span> <span id="index-TeX_002c-Web2c-implementation-of"></span> @@ -1038,7 +1043,7 @@ control some array sizes and other features are described in </td></tr> <tr><td align="left" valign="top">• <a href="#Editor-invocation" accesskey="3">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="4">\input filenames</a></td><td> </td><td align="left" valign="top">~ and $ expansion in TeX/MF/MP. +<tr><td align="left" valign="top">• <a href="#g_t_005cinput-filenames" accesskey="4">\input filenames</a></td><td> </td><td align="left" valign="top">Filename delimiters and Kpathsea expansion. </td></tr> </table> @@ -1345,9 +1350,49 @@ Metafont and MetaPost, the statement terminator ‘<samp>;</samp>’ als <code>\input</code> that allow different notation; here we are concerned only with the primitive operation.) </p> -<p>As of Web2c version 7.5.3, double-quote characters can be used to -include spaces or other special cases. In typical use, the ‘<samp>"</samp>’ -characters surround the entire filename: +<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 +containing spaces or other special characters, as described in the +sections below. +</p> +<p>In all cases, space tokens are ignored after the filename is read. +</p> +<span id="index-_0022-character_002c-ignored-in-filenames"></span> +<span id="index-double-quote-character_002c-ignored-in-filenames"></span> +<p>Also, double quote (<code>"</code>) characters are ignored within the +filename; there is no way to read files whose names contain a <code>"</code>. +</p> +<span id="index-portable-filenames"></span> +<p>However, for maximal portability of your document across systems, use +only the characters ‘<samp>a</samp>’–‘<samp>z</samp>’, ‘<samp>0</samp>’–‘<samp>9</samp>’, and +‘<samp>.</samp>’. Do not use anything but simple filenames, since 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> + + +<hr> +<span id="g_t_005cinput-quoted-filename"></span><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> +</div> +<span id="g_t_005cinput-quoted-filename_003a-_005cinput-_0022some-name_0022"></span><h4 class="subsubsection">3.5.4.1 <code>\input</code> quoted filename: <code>\input "some name"</code></h4> + +<span id="index-_005cinput-quoted-filename"></span> +<span id="index-quoted-filename-for-_005cinput"></span> + +<p>As of Web2c version 7.5.3 (2004), double-quote characters can be used +to include spaces or other special characters. In typical use, the +‘<samp>"</samp>’ characters surround the entire filename: </p><div class="example"> <pre class="example">\input "filename with spaces" </pre></div> @@ -1358,16 +1403,65 @@ can enclose any characters, as in: <pre class="example">\input filename" "with" "spaces </pre></div> -<p>One more point. In LaTeX, the quotes are needed inside the braces, thus +<p>One more point. In LaTeX, the quotes are needed inside the braces +of its <code>\input</code> macro, thus: </p><div class="example"> <pre class="example">\input{a b} % fails \input{"a b"} % ok </pre></div> -<p>This quoting mechanism comes into play <em>after</em> TeX has -tokenized and expanded the input. So, multiple spaces and tabs may be -seen as a single space, active characters such as ‘<samp>~</samp>’ are -expanded first, and so on. (See below.) +<p>There is no way to quote the quote character. +</p> + +<hr> +<span id="g_t_005cinput-braced-filename"></span><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> +</div> +<span id="g_t_005cinput-braced-filename_003a-_005cinput_007bsome-name_007d"></span><h4 class="subsubsection">3.5.4.2 <code>\input</code> braced filename: <code>\input{some name}</code></h4> + +<span id="index-_005cinput-braced-_0028grouped_0029-filename"></span> +<span id="index-braced-filename-for-_005cinput"></span> +<span id="index-group_002ddelimited-filename-for-_005cinput"></span> + +<p>As of Web2c 2020, <code>\input</code> filenames in TeX engines (this does +not apply in Metafont and MetaPost) can also be specified within a +TeX group, typically curly braces. For example: +</p><div class="example"> +<pre class="example">\input{filename with spaces} +</pre></div> + +<p>As always with TeX, the brace characters are not hardwired; what +counts is the category code: the first token after the <code>\input</code> +must be of catcode 1 (begin group), and it is matched with the +next character of catcode 2 (end group). +</p> +<p>Within the group-delimited filename, braces are treated as normal +characters. +</p> +<p>As with all forms of filenames, following spaces are ignored (after +the end group), and double quote (<code>"</code>) characters are ignored +within the filename. +</p> + +<hr> +<span id="g_t_005cinput-filename-caveats"></span><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> +</div> +<span id="g_t_005cinput-filename-caveats-1"></span><h4 class="subsubsection">3.5.4.3 <code>\input</code> filename caveats</h4> + +<span id="index-_005cinput-filename-caveats"></span> +<span id="index-caveats-for-_005cinput-filenames"></span> +<span id="index-tokenization_002c-and-_005cinput-filenames"></span> +<span id="index-expansion_002c-and-_005cinput-filenames"></span> +<span id="index-multiple-spaces_002c-and-_005cinput-filenames"></span> +<span id="index-tabs_002c-and-_005cinput-filenames"></span> +<p>The quoting mechanisms just described come into play <em>after</em> +TeX has tokenized and expanded the input. So, multiple spaces and +tabs will generally be seen as a single space, active characters such +as ‘<samp>~</samp>’ are expanded first (generally causing an error), and so +on. More examples below. </p> <span id="index-NUL_002c-not-allowed-in-filenames"></span> <span id="index-eight_002dbit-characters-in-filenames"></span> @@ -1376,42 +1470,29 @@ expanded first, and so on. (See below.) byte (character code zero, ASCII NUL) to terminate strings. So filenames in Web2c cannot contain nulls, even though TeX itself does not treat NUL specially. -In addition, some older Unix variants do not allow eight-bit characters -(codes 128–255) in filenames. -</p> -<span id="index-portable-filenames"></span> -<p>For maximal portability of your document across systems, use only the -characters ‘<samp>a</samp>’–‘<samp>z</samp>’, ‘<samp>0</samp>’–‘<samp>9</samp>’, and ‘<samp>.</samp>’, and -restrict your filenames to at most eight characters (not including the -extension), and at most a three-character extension. Do not use -anything but simple filenames, since directory separators vary among -systems; instead, add the necessary directories to the appropriate -search path. </p> <span id="index-_007e-expansion-in-filenames"></span> <span id="index-_0024-expansion-in-filenames"></span> <p>Finally, the present Web2c implementation does ‘<samp>~</samp>’ and ‘<samp>$</samp>’ -expansion on <var>name</var>, unlike Knuth’s original implementation and -older versions of Web2c. Thus: +expansion on <var>name</var>, unlike Knuth’s original implementation. +Thus: </p><div class="example"> <pre class="example">\input ~jsmith/$foo.bar </pre></div> -<p>will dereference the environment variable or Kpathsea config file value -‘<samp>foo</samp>’ and read that file extended with ‘<samp>.bar</samp>’ in user -‘<samp>jsmith</samp>’’s home directory. You can also use braces, as in -‘<samp>${foo}bar</samp>’, if you want to follow the variable name with a letter, -numeral, or ‘<samp>_</samp>’. +<p>will dereference the environment variable or Kpathsea config file +value ‘<samp>foo</samp>’ and read that file, extended with ‘<samp>.bar</samp>’, in +user ‘<samp>jsmith</samp>’’s home directory. You can also use braces in the +variable expansion, as in ‘<samp>${foo}bar</samp>’, if you want to follow +the variable name with a letter, numeral, or ‘<samp>_</samp>’. </p> <p>(So another way to get a program to read a filename containing whitespace is to define an environment variable and dereference it.) </p> -<span id="index-_005cstring"></span> -<p>In all the common TeX formats (plain TeX, LaTeX, AMSTeX), -the characters ‘<samp>~</samp>’ and ‘<samp>$</samp>’ have special category codes, so to -actually use these in a document you have to change their catcodes or -use <code>\string</code>. (The result is unportable anyway, see the -suggestions above.) The place where they are most likely to be useful -is when typing interactively. +<span id="index-_005cstring_002c-and-_005cinput-filenames"></span> +<p>In all the common TeX formats (plain TeX, LaTeX, ConTeXt, +AMSTeX, …), the characters ‘<samp>~</samp>’ and ‘<samp>$</samp>’ have special +category codes, so to actually use these in a document you have to +change their catcodes or use <code>\string</code>. </p> <hr> @@ -2239,11 +2320,11 @@ the log file. </p> <p>The <code>shell_escape_commands</code> value is a comma-separated list of words. Whitespace is significant, and typically should not be -present. The default definition looks like this, but with more -commands included: +present. The default definition in <samp>texmf.cnf</samp> looks like this, +but with more commands included: </p> <div class="example"> -<pre class="example">shell_escape_commands = bibtex,dvips,epstopdf,...,tex +<pre class="example">shell_escape_commands = bibtex,kpsewhich,repstopdf,... </pre></div> <span id="index-pipes_002c-reading-and-writing"></span> @@ -5074,25 +5155,27 @@ Previous: <a href="#References" accesskey="p" rel="prev">References</a>, Up: <a </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> -<a class="summary-letter" href="#Index_cp_symbol-2"><b>$</b></a> +<a class="summary-letter" href="#Index_cp_symbol-3"><b>$</b></a> -<a class="summary-letter" href="#Index_cp_symbol-3"><b>%</b></a> +<a class="summary-letter" href="#Index_cp_symbol-4"><b>%</b></a> -<a class="summary-letter" href="#Index_cp_symbol-4"><b>-</b></a> +<a class="summary-letter" href="#Index_cp_symbol-5"><b>-</b></a> -<a class="summary-letter" href="#Index_cp_symbol-5"><b>.</b></a> +<a class="summary-letter" href="#Index_cp_symbol-6"><b>.</b></a> -<a class="summary-letter" href="#Index_cp_symbol-6"><b>2</b></a> +<a class="summary-letter" href="#Index_cp_symbol-7"><b>2</b></a> -<a class="summary-letter" href="#Index_cp_symbol-7"><b>8</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>\</b></a> +<a class="summary-letter" href="#Index_cp_symbol-9"><b>\</b></a> -<a class="summary-letter" href="#Index_cp_symbol-9"><b>^</b></a> +<a class="summary-letter" href="#Index_cp_symbol-10"><b>^</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> <br> <a class="summary-letter" href="#Index_cp_letter-A"><b>A</b></a> @@ -5127,6 +5210,8 @@ Previous: <a href="#References" accesskey="p" rel="prev">References</a>, Up: <a <a class="summary-letter" href="#Index_cp_letter-P"><b>P</b></a> +<a class="summary-letter" href="#Index_cp_letter-Q"><b>Q</b></a> + <a class="summary-letter" href="#Index_cp_letter-R"><b>R</b></a> <a class="summary-letter" href="#Index_cp_letter-S"><b>S</b></a> @@ -5147,16 +5232,19 @@ Previous: <a href="#References" accesskey="p" rel="prev">References</a>, Up: <a <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-_0022-character_002c-ignored-in-filenames"><code>"</code> character, ignored in filenames</a>:</td><td> </td><td valign="top"><a href="#g_t_005cinput-filenames">\input filenames</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-_0023define-options">‘<samp>#define</samp>’ options</a>:</td><td> </td><td valign="top"><a href="#Compile_002dtime-options">Compile-time options</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-_0024-expansion-in-filenames"><code>$ <span class="roman">expansion in filenames</span></code></a>:</td><td> </td><td valign="top"><a href="#g_t_005cinput-filenames">\input filenames</a></td></tr> +<tr><th id="Index_cp_symbol-3">$</th><td></td><td></td></tr> +<tr><td></td><td valign="top"><a href="#index-_0024-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_symbol-3">%</th><td></td><td></td></tr> +<tr><th id="Index_cp_symbol-4">%</th><td></td><td></td></tr> <tr><td></td><td valign="top"><a href="#index-_0025_0026-magic-number"><code>%& <span class="roman">magic number</span></code></a>:</td><td> </td><td valign="top"><a href="#Determining-the-memory-dump-to-use">Determining the memory dump to use</a></td></tr> <tr><td colspan="4"> <hr></td></tr> -<tr><th id="Index_cp_symbol-4">-</th><td></td><td></td></tr> +<tr><th id="Index_cp_symbol-5">-</th><td></td><td></td></tr> <tr><td></td><td valign="top"><a href="#index-_002d-starting-a-filename"><code>- <span class="roman">starting a filename</span></code></a>:</td><td> </td><td valign="top"><a href="#Option-conventions">Option conventions</a></td></tr> <tr><td></td><td valign="top"><a href="#index-_002d-starts-option-names"><code>- <span class="roman">starts option names</span></code></a>:</td><td> </td><td valign="top"><a href="#Option-conventions">Option conventions</a></td></tr> <tr><td></td><td valign="top"><a href="#index-_002d_002d-starts-option-names"><code>-- <span class="roman">starts option names</span></code></a>:</td><td> </td><td valign="top"><a href="#Option-conventions">Option conventions</a></td></tr> @@ -5246,7 +5334,7 @@ Previous: <a href="#References" accesskey="p" rel="prev">References</a>, Up: <a <tr><td></td><td valign="top"><a href="#index-_002duppercase"><code>-uppercase</code></a>:</td><td> </td><td valign="top"><a href="#tangle-invocation">tangle invocation</a></td></tr> <tr><td></td><td valign="top"><a href="#index-_002dx"><code>-x</code></a>:</td><td> </td><td valign="top"><a href="#weave-invocation">weave invocation</a></td></tr> <tr><td colspan="4"> <hr></td></tr> -<tr><th id="Index_cp_symbol-5">.</th><td></td><td></td></tr> +<tr><th id="Index_cp_symbol-6">.</th><td></td><td></td></tr> <tr><td></td><td valign="top"><a href="#index-_002e_002c-used-for-output"><code>.<span class="roman">, used for output</span></code></a>:</td><td> </td><td valign="top"><a href="#Output-file-location">Output file location</a></td></tr> <tr><td></td><td valign="top"><a href="#index-_002e2602gf"><code>.2602gf</code></a>:</td><td> </td><td valign="top"><a href="#mf-invocation">mf invocation</a></td></tr> <tr><td></td><td valign="top"><a href="#index-_002eaux-cross_002dreference-files"><code>.aux <span class="roman">cross-reference files</span></code></a>:</td><td> </td><td valign="top"><a href="#bibtex-invocation">bibtex invocation</a></td></tr> @@ -5268,15 +5356,15 @@ Previous: <a href="#References" accesskey="p" rel="prev">References</a>, Up: <a <tr><td></td><td valign="top"><a href="#index-_002eXdefaults"><code>.Xdefaults</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-_002eXresources"><code>.Xresources</code></a>:</td><td> </td><td valign="top"><a href="#Online-Metafont-graphics">Online Metafont graphics</a></td></tr> <tr><td colspan="4"> <hr></td></tr> -<tr><th id="Index_cp_symbol-6">2</th><td></td><td></td></tr> +<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-7">8</th><td></td><td></td></tr> +<tr><th id="Index_cp_symbol-8">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-8">\</th><td></td><td></td></tr> +<tr><th id="Index_cp_symbol-9">\</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> @@ -5285,7 +5373,10 @@ Previous: <a href="#References" accesskey="p" rel="prev">References</a>, Up: <a <tr><td></td><td valign="top"><a href="#index-_005cfont-and-dynamic-generation"><code>\font <span class="roman">and dynamic generation</span></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-_005cfontdimen"><code>\fontdimen</code></a>:</td><td> </td><td valign="top"><a href="#tftopl-invocation">tftopl invocation</a></td></tr> <tr><td></td><td valign="top"><a href="#index-_005cimmediate_005cwrite18"><code>\immediate\write18</code></a>:</td><td> </td><td valign="top"><a href="#Shell-escapes">Shell escapes</a></td></tr> +<tr><td></td><td valign="top"><a href="#index-_005cinput-braced-_0028grouped_0029-filename"><code>\input</code> braced (grouped) filename</a>:</td><td> </td><td valign="top"><a href="#g_t_005cinput-braced-filename">\input braced filename</a></td></tr> +<tr><td></td><td valign="top"><a href="#index-_005cinput-filename-caveats"><code>\input</code> filename caveats</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-_005cinput-filenames"><code>\input <span class="roman">filenames</span></code></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-_005cinput-quoted-filename"><code>\input</code> quoted filename</a>:</td><td> </td><td valign="top"><a href="#g_t_005cinput-quoted-filename">\input quoted filename</a></td></tr> <tr><td></td><td valign="top"><a href="#index-_005cinput_002c-and-pipes"><code>\input<span class="roman">, and pipes</span></code></a>:</td><td> </td><td valign="top"><a href="#Shell-escapes">Shell escapes</a></td></tr> <tr><td></td><td valign="top"><a href="#index-_005cmag"><code>\mag</code></a>:</td><td> </td><td valign="top"><a href="#dvicopy-invocation">dvicopy invocation</a></td></tr> <tr><td></td><td valign="top"><a href="#index-_005cmag-1"><code>\mag</code></a>:</td><td> </td><td valign="top"><a href="#dvitype-invocation">dvitype invocation</a></td></tr> @@ -5294,16 +5385,16 @@ Previous: <a href="#References" accesskey="p" rel="prev">References</a>, Up: <a <tr><td></td><td valign="top"><a href="#index-_005copenout_002c-and-pipes"><code>\openout<span class="roman">, and pipes</span></code></a>:</td><td> </td><td valign="top"><a href="#Shell-escapes">Shell escapes</a></td></tr> <tr><td></td><td valign="top"><a href="#index-_005coutput-routine_002c-and-_005cwrite"><code>\output <span class="roman">routine, and <code>\write</code></span></code></a>:</td><td> </td><td valign="top"><a href="#Shell-escapes">Shell escapes</a></td></tr> <tr><td></td><td valign="top"><a href="#index-_005cpdfshellescape"><code>\pdfshellescape</code></a>:</td><td> </td><td valign="top"><a href="#Shell-escapes">Shell escapes</a></td></tr> -<tr><td></td><td valign="top"><a href="#index-_005cstring"><code>\string</code></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-_005cstring_002c-and-_005cinput-filenames"><code>\string<span class="roman">, and <code>\input filenames</code></span></code></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-_005ctracingcharsubdef-and-MLTeX"><code>\tracingcharsubdef <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-_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-9">^</th><td></td><td></td></tr> +<tr><th id="Index_cp_symbol-10">^</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-10">~</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-filenames">\input filenames</a></td></tr> +<tr><th id="Index_cp_symbol-11">~</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> <tr><td></td><td valign="top"><a href="#index-abbrv_002ebst"><code>abbrv.bst</code></a>:</td><td> </td><td valign="top"><a href="#Basic-BibTeX-style-files">Basic BibTeX style files</a></td></tr> @@ -5354,6 +5445,7 @@ Previous: <a href="#References" accesskey="p" rel="prev">References</a>, Up: <a <tr><td></td><td valign="top"><a href="#index-binaries_002c-linking">binaries, linking</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-blank-lines_002c-in-TCX-files">blank lines, 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-boxes_002c-memory-for">boxes, memory for</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-braced-filename-for-_005cinput">braced filename for <code>\input</code></a>:</td><td> </td><td valign="top"><a href="#g_t_005cinput-braced-filename">\input braced filename</a></td></tr> <tr><td></td><td valign="top"><a href="#index-breakpoints_002c-memory-for">breakpoints, memory for</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-Breitenlohner_002c-Peter">Breitenlohner, Peter</a>:</td><td> </td><td valign="top"><a href="#Introduction">Introduction</a></td></tr> <tr><td></td><td valign="top"><a href="#index-BSTINPUTS_002c-search-path-for-bst-files"><code>BSTINPUTS<span class="roman">, search path for bst files</span></code></a>:</td><td> </td><td valign="top"><a href="#bibtex-invocation">bibtex invocation</a></td></tr> @@ -5367,6 +5459,7 @@ Previous: <a href="#References" accesskey="p" rel="prev">References</a>, Up: <a <tr><td colspan="4"> <hr></td></tr> <tr><th id="Index_cp_letter-C">C</th><td></td><td></td></tr> <tr><td></td><td valign="top"><a href="#index-c_002dsources-Makefile-target"><code>c-sources <span class="roman">Makefile target</span></code></a>:</td><td> </td><td valign="top"><a href="#Additional-targets">Additional targets</a></td></tr> +<tr><td></td><td valign="top"><a href="#index-caveats-for-_005cinput-filenames">caveats for <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-change-files_002c-and-MFT">change files, and MFT</a>:</td><td> </td><td valign="top"><a href="#mft-invocation">mft invocation</a></td></tr> <tr><td></td><td valign="top"><a href="#index-change-files_002c-and-Tangle">change files, and Tangle</a>:</td><td> </td><td valign="top"><a href="#tangle-invocation">tangle invocation</a></td></tr> <tr><td></td><td valign="top"><a href="#index-change-files_002c-and-Weave">change files, and Weave</a>:</td><td> </td><td valign="top"><a href="#weave-invocation">weave invocation</a></td></tr> @@ -5438,6 +5531,7 @@ Previous: <a href="#References" accesskey="p" rel="prev">References</a>, Up: <a <tr><td></td><td valign="top"><a href="#index-directory-structure">directory structure</a>:</td><td> </td><td valign="top"><a href="#Installation">Installation</a></td></tr> <tr><td></td><td valign="top"><a href="#index-DISPLAY"><code>DISPLAY</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-dot-files_002c-written-by-TeX-programs">dot files, written by TeX programs</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-double-quote-character_002c-ignored-in-filenames">double quote character, ignored in 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-downloading-of-fonts-for-MetaPost-labels">downloading of fonts for MetaPost labels</a>:</td><td> </td><td valign="top"><a href="#mpost-invocation">mpost invocation</a></td></tr> <tr><td></td><td valign="top"><a href="#index-DrawingServant"><code>DrawingServant</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-dump-file">dump file</a>:</td><td> </td><td valign="top"><a href="#Common-options">Common options</a></td></tr> @@ -5469,7 +5563,7 @@ Previous: <a href="#References" accesskey="p" rel="prev">References</a>, Up: <a <tr><td></td><td valign="top"><a href="#index-EC-fonts-1">EC fonts</a>:</td><td> </td><td valign="top"><a href="#mf-invocation">mf invocation</a></td></tr> <tr><td></td><td valign="top"><a href="#index-editing-of-bitmap-fonts">editing of bitmap fonts</a>:</td><td> </td><td valign="top"><a href="#Font-utilities-available-elsewhere">Font utilities available elsewhere</a></td></tr> <tr><td></td><td valign="top"><a href="#index-editor-invoked-at-error">editor invoked at error</a>:</td><td> </td><td valign="top"><a href="#Editor-invocation">Editor invocation</a></td></tr> -<tr><td></td><td valign="top"><a href="#index-eight_002dbit-characters-in-filenames">eight-bit characters in 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-eight_002dbit-characters-in-filenames">eight-bit characters in 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-empty_002etcx"><code>empty.tcx</code></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-endian-dependencies">endian dependencies</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-eoc-GF-command"><code>eoc <span class="roman">GF command</span></code></a>:</td><td> </td><td valign="top"><a href="#gftype-invocation">gftype invocation</a></td></tr> @@ -5483,6 +5577,7 @@ Previous: <a href="#References" accesskey="p" rel="prev">References</a>, Up: <a <tr><td></td><td valign="top"><a href="#index-executables_002c-shared-initial-and-virgin">executables, shared initial and virgin</a>:</td><td> </td><td valign="top"><a href="#Initial-and-virgin">Initial and virgin</a></td></tr> <tr><td></td><td valign="top"><a href="#index-exit-status_002c-of-shell-escape">exit status, of shell escape</a>:</td><td> </td><td valign="top"><a href="#Shell-escapes">Shell escapes</a></td></tr> <tr><td></td><td valign="top"><a href="#index-expanded-plain-format">expanded plain format</a>:</td><td> </td><td valign="top"><a href="#Formats">Formats</a></td></tr> +<tr><td></td><td valign="top"><a href="#index-expansion_002c-and-_005cinput-filenames">expansion, 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-extensions-to-TeX">extensions to 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-extra_005fmem_005fbot"><code>extra_mem_bot</code></a>:</td><td> </td><td valign="top"><a href="#Runtime-options">Runtime options</a></td></tr> <tr><td colspan="4"> <hr></td></tr> @@ -5547,6 +5642,7 @@ Previous: <a href="#References" accesskey="p" rel="prev">References</a>, Up: <a <tr><td></td><td valign="top"><a href="#index-glue_002c-memory-for">glue, memory for</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-glyph-substitutions">glyph substitutions</a>:</td><td> </td><td valign="top"><a href="#MLTeX">MLTeX</a></td></tr> <tr><td></td><td valign="top"><a href="#index-gray-font">gray 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-group_002ddelimited-filename-for-_005cinput">group-delimited filename for <code>\input</code></a>:</td><td> </td><td valign="top"><a href="#g_t_005cinput-braced-filename">\input braced filename</a></td></tr> <tr><td></td><td valign="top"><a href="#index-Gruff_002c-Billy-Goat">Gruff, Billy Goat</a>:</td><td> </td><td valign="top"><a href="#Triptrap">Triptrap</a></td></tr> <tr><td></td><td valign="top"><a href="#index-gsftopk"><code>gsftopk</code></a>:</td><td> </td><td valign="top"><a href="#Font-utilities-available-elsewhere">Font utilities available elsewhere</a></td></tr> <tr><td colspan="4"> <hr></td></tr> @@ -5662,7 +5758,7 @@ Previous: <a href="#References" accesskey="p" rel="prev">References</a>, Up: <a <tr><td></td><td valign="top"><a href="#index-memory-dumps_002c-contain-date-and-time">memory dumps, contain date and time</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-memory-dumps_002c-creating">memory dumps, creating</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-mems-Make-target"><code>mems <span class="roman">Make target</span></code></a>:</td><td> </td><td valign="top"><a href="#Additional-targets">Additional targets</a></td></tr> -<tr><td></td><td valign="top"><a href="#index-meta-characters-in-filenames">meta characters in 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-meta-characters-in-filenames">meta characters in 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-Metafont">Metafont</a>:</td><td> </td><td valign="top"><a href="#Metafont">Metafont</a></td></tr> <tr><td></td><td valign="top"><a href="#index-Metafont-geometry">Metafont geometry</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-Metafont-graphics">Metafont graphics</a>:</td><td> </td><td valign="top"><a href="#Online-Metafont-graphics">Online Metafont graphics</a></td></tr> @@ -5715,6 +5811,7 @@ Previous: <a href="#References" accesskey="p" rel="prev">References</a>, Up: <a <tr><td></td><td valign="top"><a href="#index-mptrap_002ereadme"><code>mptrap.readme</code></a>:</td><td> </td><td valign="top"><a href="#Triptrap">Triptrap</a></td></tr> <tr><td></td><td valign="top"><a href="#index-MPX-files_002c-converting-from-DVI-files">MPX files, converting from DVI files</a>:</td><td> </td><td valign="top"><a href="#dvitomp-invocation">dvitomp invocation</a></td></tr> <tr><td></td><td valign="top"><a href="#index-Multi_002dlingual-TeX">Multi-lingual TeX</a>:</td><td> </td><td valign="top"><a href="#MLTeX">MLTeX</a></td></tr> +<tr><td></td><td valign="top"><a href="#index-multiple-spaces_002c-and-_005cinput-filenames">multiple spaces, 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 colspan="4"> <hr></td></tr> <tr><th id="Index_cp_letter-N">N</th><td></td><td></td></tr> <tr><td></td><td valign="top"><a href="#index-N-tilde">N tilde</a>:</td><td> </td><td valign="top"><a href="#g_t_005ccharsubdef">\charsubdef</a></td></tr> @@ -5724,7 +5821,7 @@ Previous: <a href="#References" accesskey="p" rel="prev">References</a>, Up: <a <tr><td></td><td valign="top"><a href="#index-non_002dUnix-system_002c-compiling-on">non-Unix system, compiling on</a>:</td><td> </td><td valign="top"><a href="#Additional-targets">Additional targets</a></td></tr> <tr><td></td><td valign="top"><a href="#index-non_002dwindows_002dcapable-Metafont">non-windows-capable Metafont</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-NO_005fX11WIN"><code>NO_X11WIN</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-NUL_002c-not-allowed-in-filenames">NUL, not allowed in 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-NUL_002c-not-allowed-in-filenames">NUL, not allowed in filenames</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-O">O</th><td></td><td></td></tr> <tr><td></td><td valign="top"><a href="#index-octal-character-codes_002c-in-TCX-files">octal character codes, in TCX files</a>:</td><td> </td><td valign="top"><a href="#TCX-files">TCX files</a></td></tr> @@ -5815,6 +5912,9 @@ Previous: <a href="#References" accesskey="p" rel="prev">References</a>, Up: <a <tr><td></td><td valign="top"><a href="#index-PXL-files_002c-explained">PXL files, explained</a>:</td><td> </td><td valign="top"><a href="#Font-file-formats">Font file formats</a></td></tr> <tr><td></td><td valign="top"><a href="#index-pxtoch"><code>pxtoch</code></a>:</td><td> </td><td valign="top"><a href="#Font-utilities-available-elsewhere">Font utilities available elsewhere</a></td></tr> <tr><td colspan="4"> <hr></td></tr> +<tr><th id="Index_cp_letter-Q">Q</th><td></td><td></td></tr> +<tr><td></td><td valign="top"><a href="#index-quoted-filename-for-_005cinput">quoted filename for <code>\input</code></a>:</td><td> </td><td valign="top"><a href="#g_t_005cinput-quoted-filename">\input quoted filename</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-Raichle_002c-Bernd">Raichle, Bernd</a>:</td><td> </td><td valign="top"><a href="#MLTeX">MLTeX</a></td></tr> <tr><td></td><td valign="top"><a href="#index-reading_002c-additional">reading, additional</a>:</td><td> </td><td valign="top"><a href="#Introduction">Introduction</a></td></tr> @@ -5886,6 +5986,7 @@ Previous: <a href="#References" accesskey="p" rel="prev">References</a>, Up: <a <tr><td colspan="4"> <hr></td></tr> <tr><th id="Index_cp_letter-T">T</th><td></td><td></td></tr> <tr><td></td><td valign="top"><a href="#index-T1-encoding-and-ISO-input">T1 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-tabs_002c-and-_005cinput-filenames">tabs, 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-Tachikawa_002c-Elizabeth">Tachikawa, Elizabeth</a>:</td><td> </td><td valign="top"><a href="#Font-file-formats">Font file formats</a></td></tr> <tr><td></td><td valign="top"><a href="#index-tangle"><code>tangle</code></a>:</td><td> </td><td valign="top"><a href="#tangle-invocation">tangle invocation</a></td></tr> <tr><td></td><td valign="top"><a href="#index-targets_002c-additional-Make">targets, additional Make</a>:</td><td> </td><td valign="top"><a href="#Additional-targets">Additional targets</a></td></tr> @@ -5929,6 +6030,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-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> <tr><td></td><td valign="top"><a href="#index-translation-file-for-TeX_002c-specifying">translation file for TeX, specifying</a>:</td><td> </td><td valign="top"><a href="#Common-options">Common options</a></td></tr> @@ -6022,25 +6124,27 @@ Previous: <a href="#References" accesskey="p" rel="prev">References</a>, Up: <a <tr><td></td><td valign="top"><a href="#index-y-offset">y offset</a>:</td><td> </td><td valign="top"><a href="#pktype-invocation">pktype invocation</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> +<a class="summary-letter" href="#Index_cp_symbol-2"><b>#</b></a> -<a class="summary-letter" href="#Index_cp_symbol-3"><b>%</b></a> +<a class="summary-letter" href="#Index_cp_symbol-3"><b>$</b></a> -<a class="summary-letter" href="#Index_cp_symbol-4"><b>-</b></a> +<a class="summary-letter" href="#Index_cp_symbol-4"><b>%</b></a> -<a class="summary-letter" href="#Index_cp_symbol-5"><b>.</b></a> +<a class="summary-letter" href="#Index_cp_symbol-5"><b>-</b></a> -<a class="summary-letter" href="#Index_cp_symbol-6"><b>2</b></a> +<a class="summary-letter" href="#Index_cp_symbol-6"><b>.</b></a> -<a class="summary-letter" href="#Index_cp_symbol-7"><b>8</b></a> +<a class="summary-letter" href="#Index_cp_symbol-7"><b>2</b></a> -<a class="summary-letter" href="#Index_cp_symbol-8"><b>\</b></a> +<a class="summary-letter" href="#Index_cp_symbol-8"><b>8</b></a> -<a class="summary-letter" href="#Index_cp_symbol-9"><b>^</b></a> +<a class="summary-letter" href="#Index_cp_symbol-9"><b>\</b></a> -<a class="summary-letter" href="#Index_cp_symbol-10"><b>~</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> <br> <a class="summary-letter" href="#Index_cp_letter-A"><b>A</b></a> @@ -6075,6 +6179,8 @@ Previous: <a href="#References" accesskey="p" rel="prev">References</a>, Up: <a <a class="summary-letter" href="#Index_cp_letter-P"><b>P</b></a> +<a class="summary-letter" href="#Index_cp_letter-Q"><b>Q</b></a> + <a class="summary-letter" href="#Index_cp_letter-R"><b>R</b></a> <a class="summary-letter" href="#Index_cp_letter-S"><b>S</b></a> diff --git a/Master/texmf-dist/doc/web2c/web2c.pdf b/Master/texmf-dist/doc/web2c/web2c.pdf Binary files differindex 68065edac44..ce5fc40e67b 100644 --- a/Master/texmf-dist/doc/web2c/web2c.pdf +++ b/Master/texmf-dist/doc/web2c/web2c.pdf |